Utilisation du référentiel PowerAMC 15.2

Transcription

1 Utilisation du référentiel PowerAMC 15.2 Windows

2 ID DU DOCUMENT : DC DERNIERE REVISION : Février 2010 Copyright 2010 Sybase, Inc. Tous droits réservés. Cette publication concerne le logiciel Sybase et toutes les versions ultérieures qui ne feraient pas l objet d une réédition de la documentation ou de la publication de notes de mise à jour. Les informations contenues dans ce document pourront faire l objet de modifications sans préavis. Le logiciel décrit est fourni sous contrat de licence et il ne peut être utilisé ou copié que conformément aux termes de ce contrat. Pour commander des ouvrages supplémentaires ou acquérir des droits de reproduction, si vous habitez aux Etats-Unis ou au Canada, appelez notre Service Clients au (800) , télécopie (617) Les clients ne résidant pas aux Etats-Unis ou au Canada et qui disposent d un contrat de licence pour les U.S.A. peuvent joindre notre Service Clients par télécopie. Ceux qui ne bénéficient pas de cette licence doivent s adresser à leur revendeur Sybase ou au distributeur le plus proche. Les mises à jour du logiciel ne sont fournies qu à des dates d édition périodiques. Tout ou partie de cette publication ne peut être reproduit, transmis ou traduit, sous quelque forme ou par quelque moyen que ce soit (électronique, mécanique, manuel, optique ou autre) sans l accord écrit préalable de Sybase, Inc. Les marques déposées Sybase peuvent être consultées sur la page Sybase trademarks ( id= ). Sybase et les marques mentionnées sont des marques de Sybase, Inc. indique le dépôt aux Etats-Unis d'amérique. Java et toutes les marques basées sur Java sont des marques ou des marques déposées de Sun Microsystems, Inc. aux Etats- Unis et dans d'autres pays. Unicode et le logo Unicode sont des marques déposées d Unicode, Inc. Tous les autres noms d'entité et de produit utilisés peuvent être des marques ou des marques déposées de leur propriétaire respectif. Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS for the DOD and as set forth in FAR (a)-(d) for civilian agencies. Sybase, Inc., One Sybase Drive, Dublin, CA 94568

3 Table des matières Chapitre 1 : Introduction au référentiel...1 Configuration de PowerAMC pour l'accès au référentiel...3 Configuration de PowerAMC pour un accès direct...4 Configuration de PowerAMC pour un accès via le proxy...8 Connexion à un référentiel...9 Connexion automatique au référentiel par défaut...10 Changement de votre mot de passe pour le référentiel...11 Fermeture d'une connexion au référentiel...11 Chapitre 2 : Gestion des documents dans le référentiel...13 Vérification de l'état d'un document...13 Ajout de documents dans le référentiel...15 Ajout d'un projet dans le référentiel...15 Ajout d'un seul document ou fichier dans le référentiel...15 Ajout de plusieurs documents ou fichiers dans le référentiel...16 Consolidation de changements dans les documents stockés dans le référentiel...16 Consolidation des changements pour un projet...16 Consolidation des changements pour un seul modèle ou fichier dans le référentiel...16 Consolidation des changements pour plusieurs modèles ou fichiers dans le référentiel...17 Utilisation de la fenêtre Consolidation d'un projet...17 Utilisation du référentiel iii

4 Table des matières Utilisation de la fenêtre Consolidation d'un document...18 Paramètres de consolidation...20 Utilisation de la fenêtre Consolidation de plusieurs documents...23 Utilisation de la fenêtre Options de consolidation...24 Utilisation de la fenêtre Consolidation d'un modèle...26 Modes de consolidation...27 Mode Nouveau...27 Modes Mise à jour/branche...28 Mode Intégrer...29 Consolidation de packages...30 Consolidation de documents issus d'applications externes...30 Annulation d'une consolidation...31 Extraction de documents du référentiel...31 Extraction d'un projet non présent dans votre espace de travail local...31 Mise à jour d'un projet présent dans votre espace de travail local...31 Extraction d'un modèle ou fichier non présent dans votre espace de travail local...32 Mise à jour d'un modèle ou fichier non présent dans votre espace de travail local...32 Utilisation de la fenêtre Extraction d'un projet...33 Utilisation de la fenêtre Extraction d'un document...34 Paramètres d'extraction...35 Utilisation de la fenêtre Extraction de plusieurs documents...37 Utilisation de la fenêtre Extraction d'un modèle...39 Extraction de packages...40 Parcourir le référentiel...41 Propriétés de la racine du référentiel...41 Dossiers du référentiel...42 Création d'un dossier...42 iv PowerAMC

5 Table des matières Changement du nom d'un dossier...43 Déplacement d'un dossier...43 Suppression d'un dossier...44 Propriétés des documents et objets du référentiel...44 Recherche d'objet dans les modèles PowerAMC...46 Paramètres de recherche d'objet...48 Comparaison de modèles dans le référentiel...49 Analyse d'impact...50 Extraction des dépendances depuis le référentiel...51 Mise à jour des dépendances d'un modèle depuis le référentiel...51 Exécution de requêtes SQL dans le référentiel...52 Options du référentiel...53 Versions de documents...55 Gel de versions de document...55 Gel d'une version de document depuis l'explorateur d'objets du Référentie...56 Dégel d'une version de document...56 Suppression de versions de document...57 Verrous de document...57 Verrouillage de documents...58 Verrouillage d'une version de document à partir de l'explorateur d'objets du Référentiel :...58 Gestion des verrous de document dans la boîte de dialogue Liste des verrous...59 Déverrouillage de documents...60 Branches de référentiel...61 Création d'une branche...63 Changement de branche...64 Consolidation d'un document dans une branche...65 Gestion des membres d'une branche...65 Suppression d'une branche...66 Configurations de référentiel Création d'une configuration...68 Utilisation du référentiel v

6 Table des matières Gestion des membres d'une configuration...69 Extraction d'une configuration...70 Extraction d'une configuration de projet...70 Partage de ressources dans le référentiel...71 Préparation au partage des ressources dans le référentiel...71 Création de chemins nommés pour localiser les ressources partagées...71 Sélection et préparation des ressources à partager...73 Consolidation des ressources à partager dans le référentiel...73 Rendre les ressources partagées disponibles dans la boîte de dialogue Nouveau modèle...74 Création d'un profil utilisateur afin d'activer le partage des ressources...75 Communication des politiques de partage des ressources à vos utilisateurs...77 Utilisation de ressources partagées...77 Edition de ressources partagées...77 Comparaison de fichiers de ressources partagés...78 Chapitre 3 : Parcourir le référentiel via le Web...79 Connexion à l'explorateur Web du référentiel PowerAMC...79 Explorateur de l'explorateur Web du référentiel PowerAMC...80 Propriétés de document et d'objet de référentiel...81 Ajout d'une permission à un utilisateur ou à groupe sur un élément de référentiel...81 Abonnement aux notifications de modification...82 Comparaison de versions de modèle et d'objet...83 vi PowerAMC

7 Table des matières Recherche à l'aide de l'explorateur Web du référentiel PowerAMC...83 Utilisateurs et groupes de l'explorateur Web du référentiel PowerAMC...88 Création d'un utilisateur de référentiel...88 Création d'un groupe de référentiel...89 Octroi de droits aux utilisateurs et aux groupes...89 Ajout d'un membre dans un groupe à partir de la feuille de propriétés du membre...90 Ajout d'un membre dans un groupe à partir de la feuille de propriétés du groupe...91 Désactivation d'un utilisateur...92 Suppression d'un groupe...92 Branches de l'explorateur Web du référentiel PowerAMC...93 Création d'une branche...93 Changement de branche...94 Suppression d'une branche...94 Paramètres de l'explorateur Web du référentiel PowerAMC...94 Paramètres client de l'explorateur Web du référentiel PowerAMC...95 Paramètres serveur de l'explorateur Web du référentiel PowerAMC...96 Paramètres d'état du serveur de l'explorateur Web du référentiel PowerAMC Dépannage de l'explorateur Web du référentiel PowerAMC Encodage Unicode avec Sybase SQL Anywhere v Augmentation de la mémoire de Tomcat Chapitre 4 : Administration du référentiel Création, mise à jour et suppression de la base de données du référentiel Utilisation du référentiel vii

8 Table des matières Mise à jour du référentiel Suppression des tables du référentiel Dépannage du référentiel installé sur ASE Dépannage du référentiel installé sur DB Contrôle de l'accès au référentiel à l'aide de LDAP Préconfiguration des permissions utilisateur LDAP Contrôle des droits des utilisateurs et des groupes de référentiel Création d'un utilisateur de référentiel Création d'un groupe Spécification des droits pour un utilisateur Spécification des droits pour un groupe Insertion d'un utilisateur dans un groupe Ajout d'utilisateurs et de groupes dans un groupe Insertion d'un groupe dans un autre groupe Désactivation ou suppression des utilisateurs de référentiel Suppression d'un groupe Contrôle des permission des éléments du référentiel Définition de permissions d'accès sur un élément de référentiel Notions de base relatives aux permissions octroyées et effectives Copie des permissions sur les enfants Copie de permissions d'un parent sur ses enfants Exemples de permissions Protection temporaire de l'accès aux documents dans le référentiel Audit des activités du référentiel Consultation de la liste des activités Index viii PowerAMC

9 Chapitre 1 Introduction au référentiel Le référentiel de PowerAMC est un outil permettant de stocker des documents en conservant la trace de leurs différentes versions. Dans le référentiel, un document peut être un modèle, un rapport multimodèle ou tout autre type de fichier. Remarque : Avant que vous ne puissiez accéder au référentiel, un administrateur doit l'installer et le configurer et vous fournir un nom d'utilisateur et un mot de passe. Pour plus d'informations sur l'installation du référentiel, voir le Guide d'installation. Le référentiel est installé sous la forme d'une base de données sur un serveur par un administrateur, les utilisateurs de PowerAMC y accèdent à partir de leur poste client soit directement via une connexion ODBC ou un autre type de connexion, soit en passant par le proxy du référentiel. Les différents utilisateurs interagissent avec le référentiel de diverses manières : Utilisation du référentiel 1

10 La tâche "Mise à jour du document" dans le diagramme ci-avant est l'interaction la plus courante avec le référentiel, et elle peut être décomposée comme suit : 2 PowerAMC

11 Chapitre 1 : Introduction au référentiel Configuration de PowerAMC pour l'accès au référentiel Vous pouvez accéder au référentiel directement, via le proxy du référentiel ou par l'intermédiaire d'un explorateur Web (en utilisant l'explorateur Web du référentiel PowerAMC). Votre administrateur vous indiquera quelles sont les méthodes disponibles dans votre cas. Dans le diagramme suivant : Poste de travail 1 - ne dispose que d'un explorateur Web, et ne peut donc se connecter au référentiel que via l'explorateur Web du référentiel PowerAMC. Poste de travail 2 - dispose de PowerAMC mais pas d'un client de base de données, et doit donc se connecter via le serveur de proxy de référentiel sur l'explorateur Web du référentiel PowerAMC. Poste de travail 3 - dispose de PowerAMC et d'un client de base de données, et peut donc se connecter au référentiel directement ou via le serveur de proxy de référentiel sur l'explorateur Web du référentiel PowerAMC. Utilisation du référentiel 3

12 Ces types de connexion sont décrits plus avant dans les sections suivantes : Connexion Web [si l'explorateur Web du référentiel PowerAMC est installé] voir Chapitre 3, Parcourir le référentiel via le Web à la page 79 Connexion directe voir Configuration de PowerAMC pour un accès direct à la page 4 Connexion par un proxy [si le proxy du référentiel est installé] - voir Configuration de PowerAMC pour un accès via le proxy à la page 8 Remarque : Avant que vous ne puissiez accéder au référentiel, un administrateur doit l'installer et le configurer et vous fournir un nom d'utilisateur et un mot de passe. Pour plus d'informations sur l'installation du référentiel, voir le Guide d'installation. Configuration de PowerAMC pour un accès direct Vous pouvez créer une définition directe de référentiel lorsque vous vous connectez directement au référentiel sans passer par le proxy du référentiel. Si vous utilisez le proxy, voir Configuration de PowerAMC pour un accès via le proxy à la page 8. Avertissement! Pour pouvoir créer une définition de référentiel directe, vous devez disposer d'un ID utilisateur et d'un mot de passe pour le référentiel ET d'un ID utilisateur et d'un mot de 4 PowerAMC

13 Chapitre 1 : Introduction au référentiel passe pour la base de données dans laquelle le référentiel est stocké. Vous pouvez être amené à installer un client de base de données ou un pilote afin de vous connecter à la base de données de référentiel. Votre administrateur de référentiel est en mesure de vous fournir ces informations. 1. Sélectionnez Référentiel > Définitions de référentiel pour afficher la boîte de dialogue Liste des définitions de référentiel. 2. Cliquez sur l'outil Ajouter une ligne et saisissez un nom dans la colonne Nom de référentiel afin d'identifier la définition pour une utilisation ultérieure. 3. Saisissez votre nom d'utilisateur dans la colonne Utilisateur de référentiel. Si vous êtes administrateur et créez la première définition de référentiel qui sera utilisée pour initialiser le référentiel (voir Chapitre 4, Administration du référentiel à la page 103), vous devez utiliser le nom de référentiel ADMIN. 4. Appuyez sur F4 ou cliquez sur le bouton Points de suspension dans la colonne Nom de source de données afin d'afficher une boîte de dialogue Sélection d'une source de données : Utilisation du référentiel 5

14 5. Sélectionnez l'une des options suivantes, selon la façon dont vous souhaitez vous connecter à votre base de données : Source de données ODBC machine Source de données ODBC fichier Profil de connexion (pour les connexion native, JDBC, ADO.NET, OLE DB ou DirectConnect) Vous pouvez utiliser les outils à droite de la zone de source de données afin de sélectionner un nouveau fichier ou répertoire de profil de connexion, et les boutons Modifier et Configurer pour changer votre connexion de source de données existante. Pour plus d'informations sur la création, la configuration et l'utilisation de profils de connexion, voir "Connexion à une base de données" dans le chapitre 1, Premiers pas avec PowerAMC du Guide des fonctionnalités générales. 6. Sélectionnez une source de données et cliquez sur OK pour revenir à la boîte de dialogue Liste des définitions de référentiel, dans laquelle la source s'affiche dans la colonne Nom de source de données. 7. Cliquez sur Appliquer pour appliquer vos modifications, puis sur l'outil Propriétés pour afficher la boîte de dialogue Définition de référentiel directe : 6 PowerAMC

15 Chapitre 1 : Introduction au référentiel Cette boîte de dialogue a deux zones de groupe : Référentiel spécifie le nom de la définition de référentiel, ainsi que le nom et le mot de passe de connexion que vous utilisez pour vous y connecter. Base de données spécifie le nom de la source de données qui héberge la base de données du référentiel, ainsi que le nom d'utilisateur et le mot de passe que vous allez utiliser pour vous y connecter. Les noms d'utilisateur et les mots de passe sont sensibles à la casse des caractères et facultatifs. Si vous n'en spécifiez aucun ici, vous n'aurez pas à les saisir chaque fois que vous vous connecterez au référentiel. La boîte de mot de passe affiche systématiquement des astérisques, qu'un mot de passe ait été saisi ou non. Dans le cas de bases de données à jeu de caractères unicode non-oracle ou à jeu de caractères multi-octets, vous devez également spécifier le nombre d'octets utilisés par caractère dans la base de données : 1-octet - [défaut] Pour SBCS (Single-Byte Character Set) 2-octets - Pour DBCS (Double-Byte Character Set) 3-octets - Pour Unicode ou MBCS (Multi-Byte Character Set) Remarque : Vous pouvez tester la définition en cliquant sur le bouton Tester. Un message va indiquer si votre connexion a abouti ou a échoué. 8. Cliquez sur OK pour revenir à la liste des définitions de référentiel. Remarque : Pour plus d'informations sur la création d'une source de données pour Adaptive Server Anywhere, voir le Guide d'installation. Utilisation du référentiel 7

16 Configuration de PowerAMC pour un accès via le proxy Vous créez une définition de référentiel utilisant un proxy lorsque vous vous connectez au référentiel via le proxy de référentiel. Si vous utilisez une connexion directe, voir Configuration de PowerAMC pour un accès direct à la page 4. Avertissement! Pour pouvoir créer une définition de référentiel directe, vous devez disposer d'un ID utilisateur et d'un mot de passe pour le référentiel, et savoir sur quel serveur le proxy est installé. Votre administrateur de référentiel est en mesure de vous fournir ces informations. 1. Sélectionnez Référentiel > Définitions de référentiel pour afficher la boîte de dialogue Liste des définitions de référentiel. 2. Cliquez sur l'outil Ajouter une ligne et saisissez un nom dans la colonne Nom de référentiel afin d'identifier la définition pour une utilisation ultérieure. 3. Saisissez votre nom d'utilisateur dans la colonne Utilisateur de référentiel, puis sélectionnez Proxy dans la colonne Type de connexion (vous pouvez avoir à agrandir cette fenêtre pour mieux afficher cette colonne). 4. Cliquez sur Appliquer pour appliquer vos modifications, puis cliquez sur l'outil Propriétés pour afficher la fenêtre Définition de référentiel proxy : Cette boîte de dialogue a deux zones de groupe : Référentiel spécifie le nom de la définition de référentiel, ainsi que le nom et le mot de passe de connexion que vous utilisez pour vous y connecter. 8 PowerAMC

17 Chapitre 1 : Introduction au référentiel Proxy spécifie le nom du serveur sur lequel le proxy de référentiel est installé, le numéro de port et le nom de l'instance de référentiel à laquelle vous allez vous connecter. Le nom d'utilisateur et le mot de passe prennent en compte la casse et sont facultatifs. Si vous ne les spécifiez pas dans cette boîte de dialogue, vous devrez les saisir chaque fois que vous vous connecterez au référentiel. Les zones de mot de passe affichent systématiquement des astérisques, même si aucun mot de passe n'a été saisi. Remarque : Vous pouvez tester la définition en cliquant sur le bouton Tester. Un message va indiquer si votre connexion a abouti ou a échoué. 5. Cliquez sur OK pour revenir à la liste des définitions de référentiel. Connexion à un référentiel Une fois que le référentiel a été configuré par un administrateur et que vous avez créé une définition de référentiel, vous pouvez vous connecter au référentiel. Pour plus d'informations sur la configuration du référentiel, voir le Guide d'installation. Pour plus d'informations sur la création d'une définition de référentiel, voir Configuration de PowerAMC pour l'accès au référentiel à la page Sélectionnez Référentiel > Connecter pour afficher la boîte de dialogue Connexion. 2. Sélectionnez le nom d'un référentiel dans la liste Nom du référentiel. Les paramètres de connexion correspondant à la définition de référentiel s'affichent dans les différentes zones de la boîte de dialogue. 3. Cliquez sur OK pour vous connecter. Utilisation du référentiel 9

18 Le noeud à la racine de l'arborescence du référentiel affiche le nom du référentiel, le nom de connexion de l'utilisateur et la branche courante. Pour plus d'informations sur les branches, voir Branches de référentiel à la page 61. Connexion automatique au référentiel par défaut Vous pouvez spécifier que vous souhaitez établir automatiquement une connexion au référentiel chaque fois que démarrez une session PowerAMC. Le référentiel par défaut est le dernier référentiel avec lequel vous avez établi une connexion. Pour plus d'informations sur les options générales, voir "Définition des options générales de PowerAMC" dans le chapitre Modèles du Guide des fonctionnalités générales. 1. Sélectionnez Outils > Options générales pour afficher la boîte de dialogue Options générales, puis cliquez sur la catégorie Référentiel. 2. Cochez la case Connexion automatique dans la zone de groupe Connexion, puis cliquez sur OK. 10 PowerAMC

19 Chapitre 1 : Introduction au référentiel Changement de votre mot de passe pour le référentiel Vous pouvez modifier le mot de passe que vous utilisez pour vous connecter au référentiel. 1. Sélectionnez Référentiel > Changer de mot de passe pour afficher la boîte de dialogue Changement de mot de passe. 2. Saisissez un nouveau mot de passe dans la zone Nouveau mot de passe, puis saisissez à nouveau ce mot de passe dans la zone Confirmer le mot de passe. 3. Cliquez sur OK. Remarque : Un administrateur peut également changer le mot de passe d'un utilisateur à partir de la feuille de propriétés de cet utilisateur. Pour ce faire, sélectionnez Référentiel > Administration > Utilisateurs, puis double-cliquez sur le nom d'un utilisateur dans la liste pour afficher sa feuille de propriétés et modifier son mot de passe. Fermeture d'une connexion au référentiel Vous pouvez fermer une connexion au référentiel si vous devez changer de référentiel ou si vous souhaitez travailler en mode local. 1. Sélectionnez Référentiel > Déconnecter pour afficher la boîte de dialogue Déconnexion. Utilisation du référentiel 11

20 2. Cliquez sur Oui pour procéder à la déconnexion. 12 PowerAMC

21 Chapitre 2 Gestion des documents dans le référentiel Le référentiel peut effectuer diverses opérations sur les documents (projets modèles, fichiers) qu'il stocke. La plupart des utilisateurs du référentiel ont principalement besoin d'effectuer les opérations suivantes : ajouter des documents dans le référentiel (voir Ajout de documents dans le référentiel à la page 15) consolider les changements effectués sur ces documents (voir Consolidation de changements dans les documents stockés dans le référentiel à la page 16) extraire des documents (voir Extraction de documents du référentiel à la page 31) parcourir, effectuer des recherches et comparer des documents (voir Parcourir le référentiel à la page 41) geler et dégeler des documents (voir Versions de documents à la page 55) verrouiller et déverrouiller des documents (voir Verrous de document à la page 57) créer des branches dans l'arborescences des versions du référentiel (voir Branches de référentiel à la page 61) créer des configurations, des collections de versions de document liées voir Configurations de référentiel à la page 67) Remarque : Vous devez disposez au moins d'une permission Ecriture pour ajouter ou consolider des documents dans le référentiel, et disposer d'au moins une permission Lecture pour en extraire un. Pour plus d'informations sur les permissions, voir Contrôle des permission des éléments du référentiel à la page 118. Vérification de l'état d'un document PowerAMC surveille l'état des versions locales de vos documents par rapport aux versions stockées dans le référentiel. Une petite icône s'affiche avant le nom du document dans le volet Local de l'explorateur d'objets et, si vous sélectionnez le document, sont état s'affiche dans la barre d'outils. Remarque : Vous pouvez activer et désactiver l'affichage des icônes d'états en utilisant l'option générale "Afficher les icônes d'état dans l'espace de travail" (voir Options du référentiel à la page 53). Dans l'exemple suivant : Utilisation du référentiel 13

22 le document "Exemple DFD" a été modifié par vous et par d'autres utilisateurs, Le document "Gestion de projet (MPD)" est à jour, le document "Architecture d'entreprise Acme" a été modifié et verrouillé par vous et changé par un autre utilisateur. Le tableau suivant répertorie les états possibles pour un document : Icône Description A jour (rond vert) Votre version locale est identique à celle du référentiel. Modifié par vous (point coche rouge) Votre version locale a subi des modifications qui n'ont pas été enregistrées dans le référentiel. Modifié par un autre (point d'exclamation jaune) La version du référentiel inclut des modifications qui ne sont pas répercutées dans votre version locale. Mis à jour et verrouillé par vous (rond vert et verrou vert). Pour plus d'informations sur les verrous, voir Verrouillage de documents à la page 57. A jour mais verrouillé par un autre (rond vert et verrou rouge). Modifié par vous et modifié par un autre (coche rouge et point d'exclamation jaune). Modifié et verrouillé par vous (coche rouge et verrou vert). Modifié par vous mais verrouillé par un autre (coche rouge et verrou rouge). Modifié par un autre mais verrouillé par vous (point d'exclamation jaune and verrou vert). Modifié et verrouillé par un autre (point d'exclamation jaune and verrou rouge). 14 PowerAMC

23 Chapitre 2 : Gestion des documents dans le référentiel Icône Description Modifié et verrouillé par vous et verrouillé par un autre (coche rouge, point d'exclamation jaune et verrou vert). Modifié par vous mais verrouillé et modifié par un autre (coche rouge, point d'exclamation jaune et verrou rouge). Ajout de documents dans le référentiel Pour ajouter un projet, un modèle ou des fichiers dans le référentiel, vous devez avoir la permission Lecture ou Totale sur le dossier cible ou sur la racine de l'explorateur. Ajout d'un projet dans le référentiel Vous pouvez ajouter un projet dans le référentiel en utilisant la fenêtre Consolidation d'un projet. Lorsque vous consolidez un projet pour la première fois, tous les modèles et fichiers associés qui se trouvent dans le répertoire du projet doivent être consolidés dans le référentiel. 1. Pointez sur un projet dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider pour afficher la fenêtre Consolidation d'un projet. Le mode Nouveau est automatiquement sélectionné (voir Utilisation de la fenêtre Consolidation d'un projet à la page 17). 2. Sélectionnez les paramètres appropriés (voir Paramètres de consolidation à la page 20), puis cliquez sur OK pour ajouter le projet et ses modèles et fichiers associés dans le référentiel. Ajout d'un seul document ou fichier dans le référentiel Pour ajouter un seul modèle ou fichier dans le référentiel, vous utilisez la fenêtre Consolidation d'un document. 1. Pointez sur le modèle ou fichier dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider pour afficher la fenêtre Consolidation d'un document. Le mode Nouveau est sélectionné par défaut (voir Utilisation de la fenêtre Consolidation d'un document à la page 18). 2. Sélectionnez les paramètres appropriés (voir Paramètres de consolidation à la page 20), puis cliquez sur OK pour ajouter le document ou le fichier dans le référentiel. Utilisation du référentiel 15

24 Ajout de plusieurs documents ou fichiers dans le référentiel Pour ajouter un plusieurs documents ou fichiers à la fois dans le référentiel, vous utilisez la fenêtre Consolidation de plusieurs documents. 1. Pointez sur la racine de l'espace de travail ou sur un dossier contenant plusieurs modèles et fichiers (ou bien sélectionnez plusieurs documents ou en utilisant la touche Ctrl dans l'onglet Local de l'explorateur d'objets), cliquez le bouton droit de la souris, puis sélectionnez Consolider dans le menu contextuel pour afficher la fenêtre Consolidation de plusieurs documents. Vous pouvez ajouter ou supprimer des modèles et fichiers dans la liste en utilisant les outils fournis (voir Utilisation de la fenêtre Consolidation de plusieurs documents à la page 23). 2. Cliquez sur OK pour ajouter les modèles et fichiers dans le référentiel. Consolidation de changements dans les documents stockés dans le référentiel Pour consolider des changements apportés aux projets, modèles ou fichiers stockés dans le référentiel, vous devez disposer de la permission Ecriture ou Totale sur le document approprié ou (dans le cas d'un modèle) sur l'un de ses packages. Pour plus d'informations sur les packages, voir Consolidation de packages à la page 30. Consolidation des changements pour un projet Pour consolider les changements d'un projet, vous utilisez la fenêtre Consolidation d'un projet. 1. Pointez sur le projet dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider pour afficher la fenêtre Consolidation d'un projet. Le mode Mise à jour est sélectionné par défaut (voir Utilisation de la fenêtre Consolidation d'un projet à la page 17). 2. Sélectionnez les paramètres appropriés (voir Paramètres de consolidation à la page 20), puis cliquez sur OK pour consolider vos modifications avec la version du projet conservée dans le référentiel. Consolidation des changements pour un seul modèle ou fichier dans le référentiel Pour consolider les changements d'un seul modèle ou fichier dans le référentiel, vous utilisez la fenêtre Consolidation d'un document. 1. Pointez sur le modèle ou fichier dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider pour afficher la fenêtre 16 PowerAMC

25 Chapitre 2 : Gestion des documents dans le référentiel Consolidation d'un document. Le mode Mise à jour est sélectionné par défaut (voir Utilisation de la fenêtre Consolidation d'un document à la page 18). 2. Sélectionnez les paramètres appropriés (voir Paramètres de consolidation à la page 20), puis cliquez sur OK pour consolider vos changements avec la version du modèle ou fichier conservée dans le référentiel. Consolidation des changements pour plusieurs modèles ou fichiers dans le référentiel Pour consolider les changements de plusieurs modèles ou fichiers à la fois dans le référentiel, vous utilisez la fenêtre Consolidation de plusieurs documents. 1. Pointez sur la racine de l'espace de travail ou sur un dossier contenant plusieurs modèles et fichiers (ou bien sélectionnez plusieurs modèles et fichiers en utilisant la touche Ctrl dans l'onglet Local de l'explorateur d'objets), cliquez le bouton droit de la souris, puis sélectionnez Consolider dans le menu contextuel pour afficher la fenêtre Consolidation de plusieurs documents. Vous pouvez ajouter ou supprimer des modèles et fichiers dans la liste en utilisant les outils fournis (voir Utilisation de la fenêtre Consolidation de plusieurs documents à la page 23). 2. Cliquez sur OK pour consolider vos changements avec les versions des modèles et fichiers conservées dans le référentiel. Remarque : Si vous changez de SGBD ou de langage cible d'un modèle qui se trouve dans le référentiel (sauf si vous changez de cible sans changer de famille, comme c'est le cas en passant de ASIQ 12.6 à 12.7), vous ne serez plus en mesure de consolider les changements ultérieurs. Utilisation de la fenêtre Consolidation d'un projet La fenêtre Consolidation d'un projet permet de spécifier le projet ainsi que ses modèles et fichiers associés à consolider, et de définir des paramètres de consolidation. Pour plus d'informations sur les paramètres de consolidation, voir Paramètres de consolidation à la page 20. Utilisation du référentiel 17

26 Pour afficher la fenêtre Consolidation d'un projet, pointez sur le projet dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider. La fenêtre est préremplie avec les documents du projet, qui sont situés dans le répertoire du projet dans votre système de fichiers. Ces documents sont tous sélectionnés et doivent être consolidés lorsque vous consolidez un projet pour la première fois. Lorsque par la suite vous consolidez des changements dans votre projet, seuls les documents modifiés sont sélectionnés par défaut. Utilisation de la fenêtre Consolidation d'un document La fenêtre Consolidation d'un document permet de spécifier le modèle ou fichier à consolider et de définir les paramètres de consolidation Pour plus d'informations sur les paramètres de consolidation, voir Paramètres de consolidation à la page PowerAMC

27 Chapitre 2 : Gestion des documents dans le référentiel Pour afficher cette fenêtre, vous pouvez procéder de l'une des façons suivantes : Pointez sur un modèle ou sur un fichier dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider. La fenêtre est préremplie par les détails relatifs au document. Sélectionnez un modèle ou un fichier dans la fenêtre Consolidation de plusieurs documents (voir Utilisation de la fenêtre Consolidation de plusieurs documents à la page 23), puis cliquez sur l'outil Réglages. La fenêtre est préremplie par les détails relatifs au document. Cliquez sur l'outil Ajouter un document dans la fenêtre Consolidation de plusieurs documents (voir Utilisation de la fenêtre Consolidation de plusieurs documents à la page 23). Les champs de la zone de groupe Document local sont vides, permettant de spécifier un document ou fichier à consolider. Sélectionnez un fichier de ressources local, puis cliquez sur l'outil Consolider dans la boîte de dialogue Liste des type de ressource. La fenêtre est préremplie par les détails relatifs au document (voir Consolidation des ressources à partager dans le référentiel à la page 73). Utilisation du référentiel 19

28 Paramètres de consolidation Les paramètres des fenêtres Consolidation d'un document et Consolidation d'un projet permettent de spécifier des détails des documents en cours de consolidation. Document local La zone de groupe Document local contient les paramètres suivants : Paramètre Espace de travail ou fichier Nom Description [modèles et fichiers uniquement] Sélectionnez une des options pour spécifier et afficher le nom de document en fonction de son nom dans l'espace de travail ou de son nom et chemin d'accès de fichier. Spécifie le nom du document à consolider. [modèles et fichiers uniquement] Selon que vous avez sélectionné Espace de travail ou fichier, il s'agira d'un : Nom de modèle - cliquez sur l'outil Propriétés à droite de la zone pour afficher sa feuille de propriétés. Nom d'un fichier et d'un chemin d'accès - cliquez sur l'outil Parcourir situé à droite de la zone pour afficher une boîte de dialogue de sélection de fichier. Version Extraire après consolidation Extraire les dépendances [pas pour les projets en lecture seule] Spécifie la version courante du modèle ou du fichier dans le référentiel, si elle est connue. [modèles et ressources uniquement] Spécifie que la version locale sera mise à jour afin de prendre en considération les changements effectués sur la version contenue dans le référentiel après la consolidation. Cette fonctionnalité permet de travailler avec la version la plus récente d'un modèle (contenu ou non dans un projet) que plusieurs utilisateurs peuvent éditer simultanément. Voir Utilisation de la fenêtre Consolidation d'un modèle à la page 26. [modèles uniquement] Extrait les éventuels modèles (contenus dans un projet ou non) dont le modèle courant dépend (via des liens de génération ou des raccourcis) après la consolidation. Document dans le référentiel La zone de groupe Document dans le référentiel contient les paramètres suivants : 20 PowerAMC

29 Chapitre 2 : Gestion des documents dans le référentiel Paramètre Description Mode Spécifie la forme de consolidation. Vous pouvez choisir : Nouveau - Crée la première version d'un nouveau document dans la branche courante, ou la première version d'un document dans un autre dossier de la branche courante (voir Mode Nouveau à la page 27). Mise à jour Met à jour une version existante dans la branche courante ou crée une nouvelle version dans la branche courante si le document avait été extrait depuis une branche de base de la branche courante (voir Modes Mise à jour/branche à la page 28). Branche Crée la première version du document dans la branche courante (voir Modes Mise à jour/branche à la page 28). Intégrer Intègre des modifications dans d'autres branches de l'arborescence de versions, ou consolide un document sous un autre nom (voir Mode Intégrer à la page 29). Dossier/Projet [disponible uniquement en mode Nouveau] Spécifie le noeud racine ou un sous-dossier dans lequel le document sera consolidé dans le référentiel. Cliquez sur l'outil Propriétés à droite de cette zone pour afficher la feuille de propriétés du dossier. Si vous ne définissez pas de dossier cible, le document est consolidé à la racine du référentiel, vous devez veiller à lui octroyer des permissions d'accès individuelles Nom Version Commentaire Geler avant la consolidation Geler après la consolidation [pas pour les projets disponible en mode Intégrer] Spécifie le nom du document de référentiel avec lequel consolider dans le référentiel. Cliquez sur l'outil Propriétés pour afficher la feuille de propriétés du document. [pas pour les projets disponible en mode Intégrer] Spécifie la version du document de référentiel avec laquelle effectuer la consolidation. Permet de spécifier un commentaire pour aider les futurs utilisateurs à identifier le but d'une consolidation. Gèle les version précédentes de tout objet modifié dans le référentiel, et crée une nouvelle version pour accepter les changements à consolider. Gèle toutes les versions d'objet modifié après la consolidation afin de s'assurer qu'ils ne peuvent plus être modifiés. Tout changement ultérieur des objets donnera lieu à la création de nouvelles versions. Utilisation du référentiel 21

30 Paramètre Créer une version de référence Déverrouiller après la consolidation Enregistrer les diagrammes pour l'explorateur Web Description Crée une nouvelle version de tous les objets dans tout le modèle, qu'ils aient été modifiés ou non. Cette fonctionnalité peut être utilisée pour créer un point de départ pour une nouvelle étape de développement. Cette option est réservée aux utilisateurs dotés d'une permission Totale sur le document sélectionné. Une version de référence facilite également les requêtes SQL qui peuvent se lancer sans tenir compte des multiples versions d'objets. L'option Créer une version de référence ne fait pas appel à l'interface de fusion étant donné qu'une nouvelle version est systématiquement créée pour chaque objet du modèle. Cette option peut vous permettre d'éviter certains problèmes de consolidation liés à des objets mal gérés dans le référentiel. Elle a toutefois tendance à consommer beaucoup d'espace dans la base de données, car le serveur va créer d'importants journaux d'annulation et utiliser beaucoup de verrous, et vous pouvez souhaiter configurer votre serveur pour autoriser ces importantes transactions. [documents verrouillés uniquement] Déverrouille la version de document après la consolidation. Si cette case n'est pas sélectionnée, la version créée ou mise à jour est verrouillée tandis que la version antécédente est déverrouillée. [pas pour les ressources] Préparer des instantanés des diagrammes de modèle qui peuvent être affichés dans l'explorateur Web du référentiel PowerAMC (voir Chapitre 3, Parcourir le référentiel via le Web à la page 79). Documents du projet La zone de groupe Documents du projet répertorie les modèles et fichiers associés au projet, et permet de les sélectionner pour consolidation avec le projet. Notez que seuls les documents de projet qui sont se trouvent dans le projet sont répertoriés ici. Les documents stockés hors du projet et uniquement attachés à ce dernier ne sont pas répertoriés et doivent être consolidés séparément. 22 PowerAMC

31 Chapitre 2 : Gestion des documents dans le référentiel Utilisation de la fenêtre Consolidation de plusieurs documents La fenêtre Consolidation de plusieurs documents permet d'ajouter plusieurs modèles et fichiers au référentiel et/ou de consolider des changements dans plusieurs modèles et fichiers de référentiel. Pour afficher cette fenêtre, vous pouvez procéder de l'une des façons suivantes : Pointez sur la racine de l'espace de travail, ou sur un dossier contenant plusieurs modèles et fichiers dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider. Sélectionnez Référentiel > Consolider. Appuyez sur Ctrl+Alt+C Les outils suivants sont disponibles dans cette fenêtre : Outil Description Réglages Affiche la fenêtre Consolidation d'un document (voir Utilisation de la fenêtre Consolidation d'un document à la page 18) pour le document sélectionné afin de vous permettre de spécifier la façon dont vous souhaitez le consolider. Ajouter un document - Affiche la fenêtre Consolidation d'un document (voir Utilisation de la fenêtre Consolidation d'un document à la page 18) pour vous permettre de sélectionner un document à ajouter à la liste de consolidation. Ajouter les documents modifiés dans l'espace de travail - ajoute dans la liste de consolidation tous les documents modifiés dans l'espace de travail durant la session courante. Ajouter tous les documents de l'espace de travail - ajoute dans la liste de consolidation tous les documents dans l'espace de travail (y compris les documents fermés). Utilisation du référentiel 23

32 Outil Description Ajouter les version de document liées ajoute dans la liste de consolidation tous les documents associés au document sélectionné par le biais de raccourcis ou de liens de génération. Cet outil permet d'enregistrer l'environnement global d'un document. Lorsque vous consolidez des modèles PowerAMC liés par des raccourcis, les modèles référencés sont consolidés avant ceux contenant les raccourcis. Supprimer Supprime le document sélectionné de la liste de consolidation. Options de consolidation Affiche la fenêtre Options de consolidation pour vous permettre de spécifier le mode de mise à jour pour les changements (voir Utilisation de la fenêtre Options de consolidation à la page 24). Déplacer vers le haut Déplace le document sélectionné vers le haut de la liste. Déplacer vers le base - Déplace le document sélectionné vers le bas de la liste. Utilisation de la fenêtre Options de consolidation La fenêtre Options de consolidation permet de spécifier comment les différence entre votre copie locale d'un document et la version du référentiel sont résolues lors de la consolidation. Vous pouvez afficher cette fenêtre de l'une des façons suivantes : Cliquez sur l'outil Options de consolidation dans la fenêtre Consolidation d'un projet. Les options spécifiées vont s'appliquer à tous les modèles et fichiers que vous consolidez. Cliquez sur le bouton Options en bas de la fenêtre Consolidation d'un document. Notez que ce bouton n'est disponible que si vous ne consolidez qu'un seul document. Cliquez sur le bouton Options de consolidation dans la fenêtre Consolidation de plusieurs documents. Les options spécifiées s'appliquent à tous les documents en cours de consolidation. Vous pouvez choisir l'un des modes de consolidation suivants dans cette fenêtre : 24 PowerAMC

33 Chapitre 2 : Gestion des documents dans le référentiel Mode Interactif Par lot Description [défaut] Affiche la fenêtre Consolidation d'un modèle (voir Utilisation de la fenêtre Consolidation d'un modèle à la page 26) avant la consolidation, pour vous permettre de comparer la version en local du modèle et la version contenue dans le référentiel, et de passer en revue afin de les approuver ou de rejeter les différences pour la consolidation. Automatise la consolidation des documents. Si vous sélectionnez ce mode, vous devez spécifiez l'un des sous-modes suivants pour la résolution des conflits : Utiliser mes modifications les modifications effectuées en local prévalent sur celles (réalisées par d'autres utilisateurs) existant dans la version du référentiel. Conserver les modifications du référentiel les modifications incluses dans la version du modèle contenue dans le référentiel prévalent sur celles effectuées localement. Résoudre manuellement si un conflit est détecté, la fenêtre Consolidation d'un modèle (voir Utilisation de la fenêtre Consolidation d'un document à la page 26) s'affiche pour votre permettre de résoudre les conflits. Vous pouvez définir ce mode comme mode par défaut. Pour ce faire, sélectionnez Outils > Options générales, cliquez sur Référentiel dans le volet de gauche, puis cochez la case Mettre à jour par lot. Utilisation du référentiel 25

34 Utilisation de la fenêtre Consolidation d'un modèle Lorsque vous consolidez des modèles PowerAMC, la fenêtre Consolider le modèle permet de passer en revue les différences entre les version en local et dans le référentiel et de les appliquer ou rejeter le cas échéant. Dans la fenêtre Consolider le modèle, la version locale du modèle s'affiche sur la gauche, et la version du référentiel sur la droite. Vous pouvez sélectionner ou rejeter toutes les différences pour la consolidation. Dans la boîte de dialogue de fusion, vous pouvez utiliser un filtre pour n'afficher que les conflits, les divergences qui se produisent lorsqu'un même objet a été modifié à la fois dans le modèle local et dans le référentiel, comme dans les cas suivants : Conflit Dans le modèle du référentiel Dans le modèle local Création Objet supprimé. Objet modifié. Suppression Objet modifié. Objet supprimé. 26 PowerAMC

35 Chapitre 2 : Gestion des documents dans le référentiel Conflit Dans le modèle du référentiel Dans le modèle local Attributs différents Propriétés de l'objet modifiées (Nom, Code, changement d'ordre dans une liste, ajout d'un objet...). Propriétés de l'objet modifiées (Nom, Code, changement d'ordre dans une liste, ajout d'un objet...). Lorsque vous consolidez un modèle local dans le référentiel, un message s'affiche dans la fenêtre Résultat afin d'expliquer le conflit et de décrire la résolution proposée. Un message final vous permet de confirmer les résolutions proposées par PowerAMC, vous pouvez les accepter ou refuser la fusion. Pour plus d'informations sur la fusion des modèles, voir "Fusion de modèles", dans le chapitre Comparaison et fusion de modèles du Guide des fonctionnalités générales. Modes de consolidation Lorsque vous consolidez un document, vous devez choisir un mode de consolidation, qui vous aide à sélectionner les paramètres de consolidation appropriés. Les modes suivants sont disponibles: Nouveau - voir Mode Nouveau à la page 27. Mise à jour/branche - [mode par défaut] voir Modes Mise à jour/branche à la page 28. Intégrer - voir Mode Intégrer à la page 29. Chaque consolidation est traitée comme une seule transaction. Si vous consolidez de grands modèles en mode Nouveau, le serveur va créer d'importants journaux d'annulation et utiliser beaucoup de verrous. Vous pouvez configurer votre serveur pour autoriser ces importantes transactions. Les autres modes utilisent en général des transactions de taille moins importante. Mode Nouveau Le mode Nouveau est toujours disponible dans la boîte de dialogue de consolidation. Ce mode doit être utilisé dans les cas suivants : La version du document que vous souhaitez consolider n'existe ni dans le référentiel, ni dans la branche courante (voir Branches de référentiel à la page 61) ainsi que dans ses branches de base. Si le document existe ailleurs dans le référentiel, un message s'affiche pour vous informer que la nouvelle version va partager l'arborescence de versions du document existant. La version de document que vous souhaitez consolider existe dans la branche courante, mais vous souhaitez la consolider dans un autre dossier. Utilisation du référentiel 27

36 Modes Mise à jour/branche Le mode Mise à jour et le mode Branche sont mutuellement exclusifs. L'un d'entre eux est toujours le mode par défaut, selon que le document que vous consolidez existe ou non dans la branche à laquelle vous êtes connecté. Mode Mise à jour Mode Branche Le document existe dans la branche courante : il a déjà été consolidé. La version extraite du document provient de la branche courante ou d'une de ses branches de base. Le document existe dans la branche courante. La version extraite du document provient de la branche de base de la branche courante. Pour plus d'informations sur les branches, voir Branches de référentiel à la page 61. Lorsque vous sélectionnez le mode Mise à jour ou Branche, vous ne pouvez pas modifier le contenu des zones Projet, Dossier, Nom et Version dans les fenêtres Consolidation d'un projet et Consolidation d'un document. L'exemple suivant montre plusieurs situations impliquant la consolidation dans les modes Mise à jour et Branche : Cas Branche où le document a été extrait Branche courante Mode de consolidation 1 Branche 1 Branche 1 Vous consolidez en mode Mise à jour pour mettre à jour V1. 28 PowerAMC

37 Chapitre 2 : Gestion des documents dans le référentiel Cas Branche où le document a été extrait Branche courante Mode de consolidation 2 Branche 1 Branche 2 Vous consolidez en mode Branche pour créer la version dans la branche courante. 3 Branche 2 Branche 3 Vous consolidez en mode Branche pour créer la version de document dans la branche courante. 4 Branche 3 Branche 3 Vous consolidez en mode Mise à jour car la version de document existe déjà dans la branche courante, et vous gelez alors la version précédente. 5 Branche 2 Branche 3 Vous consolidez en mode Mise à jour car la version de document existe déjà dans la branche courante (V ), et gelez la version précédente. Remarque : Identificateur unique de document (GUID) Le référentiel utilise le numéro GUID (Global Unique ID, ID unique global) des document pour les identifier lorsque vous les extrayez et les consolidez. Si vous utilisez la commande Enregistrer sous pour faire une copie du document, le GUID du document est modifié et le nouveau document ne peut pas être consolidé en mode Mise à jour. Toutefois, si vous copiez ou déplacez le fichier dans l'explorateur Windows, le GUID n'est pas modifié. Mode Intégrer Le mode Intégrer est toujours disponible dans la fenêtre de consolidation. Ce mode doit être utilisé dans les situations suivantes : Lorsque vous souhaitez intégrer une version de document dans un autre document - Vous devez définir le projet ou (modèles et fichiers uniquement) le dossier, le nom et le numéro de version du document. Lorsque souhaitez intégrer une version dans une autre version du même document à laquelle vous n'avez pas accès via les modes Mise à jour ou Branche - Vous devez sélectionner une version parmi celles existant dans la branche racine de la branche courante. Par exemple, un ingénieur de maintenance travaille sur une correction de bug dans la branche Maintenance et souhaite intégrer ses corrections dans la branche Edition utilisée pour développer les prochaines versions du produit : Utilisation du référentiel 29

38 Consolidation de packages Lorsque vous consolidez un modèle dans le référentiel, vous consolidez également les packages qu'il contient. Alors que le plus souvent vous devez disposer des permissions Ecriture ou Totale pour consolider un document, vous pouvez consolider un modèle pour lequel vous ne disposez que de la permission Lecture s'il contient au moins un package pour lequel vous disposez de la permission Ecriture ou Totale. Toutefois, notez que les modifications faites dans des packages pour lesquels lequel vous n'avez pas de permission Ecriture ou Totale peuvent être perdues lors de la consolidation. Pour plus d'informations sur l'extraction des packages, voir Extraction de packages à la page 40. Consolidation de documents issus d'applications externes Le lien entre un document local et un document dans le référentiel est enregistré dans l'espace de travail courant. Ce lien permet de mettre à jour le document dans le référentiel, qu'il s'agisse d'un modèle ou d'un fichier issu d'une application externe. Pour pouvoir mettre à jour un document issu d'une application externe qui n'appartient pas à l'espace de travail courant, vous devez d'abord l'extraire du référentiel, cocher la case Ajouter à 30 PowerAMC

39 Chapitre 2 : Gestion des documents dans le référentiel l'espace de travail et enregistrer l'espace de travail. Ceci vous permettra de mettre à jour le document lors de la prochaine consolidation. Annulation d'une consolidation Si vous souhaitez annuler une consolidation, vous pouvez uniquement supprimer la version de document créée au moyen de la consolidation. Une consolidation ne créant pas systématiquement une nouvelle version de document (voir Versions de documents à la page 55), une telle suppression n'est pas toujours possible. Extraction de documents du référentiel Pour pouvoir extraire un projet, un modèle ou un fichier du référentiel, vous devez disposer d'une permission Lecture, Ecriture ou Totale sur le document ou (dans le cas d'un modèle), sur l'un de ses packages. Les documents pour lesquels nous ne disposez que d'une permission Liste ou pour lesquels vous ne disposez d'aucune permission ne peuvent pas être extraits. Vous pouvez être amené à extraire un document du référentiel soit pour l'ajouter à votre espace de travail local, soit pour mettre à jour votre version locale avec les changements effectués par d'autres utilisateurs. Extraction d'un projet non présent dans votre espace de travail local Vous pouvez mettre un jour un projet non présent dans votre espace de travail local à partir de l'onglet Référentiel de l'explorateur d'objets. 1. Sélectionnez l'onglet Référentiel de l'explorateur d'objets afin d'afficher le contenu du référentiel. 2. Pointez sur projet, cliquez le bouton droit de la souris, puis sélectionnez Extraire pour afficher la fenêtre Extraction d'un projet (voir Utilisation de la fenêtre Extraction d'un projet à la page 33). 3. Sélectionnez les paramètres appropriés (voir Paramètres d'extraction à la page 35), puis cliquez sur OK pour extraire le projet et (le cas échéant) ses modèles et fichiers associés. Mise à jour d'un projet présent dans votre espace de travail local Vous pouvez mettre un jour un projet présent dans votre espace de travail local à partir de l'onglet Local de l'explorateur d'objets. 1. Dans l'onglet Local de l'explorateur d'objets, pointez sur le projet à mettre à jour, cliquez le bouton droit de la souris, puis sélectionnez Mettre à jour à partir du référentiel afin d'afficher la fenêtre Extraction d'un projet (voir Utilisation de la fenêtre Extraction d'un projet à la page 33). 2. Sélectionnez les paramètres appropriés (voir Paramètres d'extraction à la page 35), puis cliquez sur OK pour extraire le projet et (le cas échéant) ses modèles et fichiers associés. Utilisation du référentiel 31

40 Si vous avez sélectionné l'option Fusionner le document, la fenêtre Extraction d'un modèle s'affiche et permet de passer en revue les différences entre la version locale et celle du référentiel afin de les appliquer ou de les rejeter. Extraction d'un modèle ou fichier non présent dans votre espace de travail local Vous pouvez extraire un modèle ou fichier qui n'est pas présent dans votre espace de travail local en utilisant l'onglet Référentiel de l'explorateur d'objets. 1. Sélectionnez l'onglet Référentiel de l'explorateur d'objets pour afficher le contenu du référentiel. 2. Pointez sur un modèle ou fichier, cliquez le bouton droit de la souris, puis sélectionnez Extraire dans le menu contextuel pour afficher la fenêtre Extraction d'un document (voir Utilisation de la fenêtre Extraction d'un document à la page 34). 3. Sélectionnez les paramètres appropriés (voir Paramètres d'extraction à la page 35) puis cliquez sur OK pour extraire le document. Si vous avez sélectionnez l'option Ouvrir le document, le document est ajouté à votre espace de travail et est ouvert. Mise à jour d'un modèle ou fichier non présent dans votre espace de travail local Vous pouvez mettre à jour un modèle ou fichier qui n'est pas présent dans votre espace de travail local en utilisant l'onglet Local de l'explorateur d'objets. 1. Sur l'onglet Local de l'explorateur d'objets, pointez sur le modèle ou fichier à mettre à jour, cliquez le bouton droit de la souris, puis sélectionnez Mettre à jour depuis le référentiel dans le menu contextuel pour afficher la fenêtre Extraction d'un document (voir Utilisation de la fenêtre Extraction d'un document à la page 34). 2. Sélectionnez les paramètres appropriés (voir Paramètres d'extraction à la page 35) puis cliquez sur OK pour extraire le document. Si vous avez sélectionné l'option Fusionner le document, la fenêtre Extraction d'un modèle s'affiche et permet de passer en revue les différences entre la version locale et celle du référentiel afin de les appliquer ou de les rejeter. Remarque : Vous pouvez sélectionner plusieurs fichiers ou modèles à extraire dans l'onglet Local ou dans l'onglet Référentiel de l'explorateur d'objets, auquel cas la fenêtre Extraction de plusieurs documents s'affiche. (voir Utilisation de la fenêtre Extraction de plusieurs documents à la page 37). 32 PowerAMC

41 Chapitre 2 : Gestion des documents dans le référentiel Utilisation de la fenêtre Extraction d'un projet La fenêtre Extraction d'un projet permet de spécifier le projet et tous ses modèles et fichiers associés à extraire, et de définir des paramètres d'extraction. Pour plus d'informations sur les paramètres d'extraction, voir Paramètres d'extraction à la page 35. La fenêtre est préremplie avec les documents de projet, et ceux qui ne sont pas à jour sont sélectionnés par défaut. Vous pouvez afficher cette fenêtre de l'une des façons suivantes : Pointez sur projet dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Extraire. La fenêtre est préremplie avec les détails du projet. Pointez sur l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Mettre à jour depuis le référentiel. La fenêtre est préremplie avec les détails du projet. Utilisation du référentiel 33

42 Utilisation de la fenêtre Extraction d'un document La fenêtre Extraction d'un document permet de spécifier le modèle ou fichier à extraire et de définir les paramètres d'extraction. Vous pouvez afficher cette fenêtre de l'unes des façons suivantes : Pointez sur un modèle ou fichier dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Extraire. La fenêtre est préremplie par les détails relatifs au document. Pointez sur un modèle ou un fichier dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Mettre à jour à partir du référentiel. La fenêtre est préremplie avec les détails relatifs au document, et certains des paramètres ne sont pas disponibles. Sélectionnez un modèle ou fichier dans la fenêtre Extraction de plusieurs documents (voir Utilisation de la fenêtre Extraction de plusieurs documents à la page 37) puis cliquez sur l'outil Réglages. La fenêtre est préremplie par les détails relatifs au document. Cliquez sur l'outil Ajouter un document dans la fenêtre Extraction de plusieurs documents (voir Utilisation de la fenêtre Extraction de plusieurs documents à la page 37). Les champs sont vides, et vous permettent de spécifier le modèle ou fichier à extraire. Sélectionnez un fichier de ressources, puis cliquez sur l'outil Mettre à jour à partir du référentiel dans la boîte de dialogue Liste des type de ressource. La fenêtre est préremplie avec les détails relatifs au document, et de nombreux paramètres ne sont pas disponibles. 34 PowerAMC

43 Chapitre 2 : Gestion des documents dans le référentiel Paramètres d'extraction Les paramètres d'extraction suivants sont disponibles dans les fenêtres Extraction d'un document et Extraction d'un projet pour vous permettre de spécifier des détails relatifs à l'extraction : Document de référentiel La zone de groupe dans le référentiel contient les paramètres suivants : Paramètre Description Nom Version Configuration Packages Extraire les dépendances Verrouiller avant extraction Nom du document dans le référentiel. [pas pour les projets] Spécifie la version du document à extraire. [projets uniquement] Spécifie la configuration contenant les modèles et fichiers de projet à extraire ou (si aucune configuration n'est encore spécifiée) les dernières version de modèles et de fichiers enregistrées dans le référentiel. Pour créer une configuration de projet, pointez sur le noeud du projet dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris et sélectionnez Créer une configuration. Voir Création d'une configuration à la page 68. [Modèles uniquement] Cliquez sur le bouton pour afficher une boîte de dialogue de sélection de packages dans laquelle vous pouvez sélectionner les packages si vous ne souhaitez pas sélectionner la totalité du modèle. [projets et modèles uniquement] Spécifie que les raccourcis externes et les dépendances de lien de génération sont extraits. Si vous ne sélectionnez pas cette option, les informations situées sur l'onglet Dépendances des objets du modèle risquent d'être incomplètes. Pour plus d'informations sur l'extraction des dépendances, voir Analyse d'impact à la page 50. Permet de verrouiller la version sélectionnée du document avant de l'extraire, afin d'empêcher les autres utilisateurs de modifier ce document. Cette case à cocher n'est proposée qu'aux utilisateurs habilités à verrouiller ce document. Extraire dans un fichier/local Cette zone de groupe contient les paramètres suivants : Utilisation du référentiel 35

44 Paramètre Extraire dans un fichier Chemin Fusionner le document Lecture uniquement Ouvrir le document Ajouter à l'espace de travail Description [pas pour les projets] Spécifie que le document sera extrait vers un fichier sur votre machine locale. Cette option ne peut être désélectionnée que pour les modèles PowerAMC, qui peuvent être chargés en mémoire et ajoutés à votre espace de travail sans donner lieu à la création d'un fichier. Spécifie le chemin d'accès du fichier ou (pour les projets uniquement) du dossier vers lequel le document sera extrait. Cliquez sur l'outil Sélectionner un fichier à droite de cette zone pour recherche un emplacement particulier. Ouvre la fenêtre Extraction d'un modèle (voir Utilisation de la fenêtre Extraction d'un modèle à la page 39) avant l'extraction, pour vous permettre de comparer les version locale et référentiel du modèle, et de passer en revue les différences afin de les approuver ou de les rejeter pour l'extraction. Si vous extrayez plusieurs documents, ceux-ci remplacent automatiquement les versions de document existantes, et ne sont pas fusionnées avec elles. Cette option n'est disponible que si vous avez spécifiez un chemin vers un fichier existant sur votre machine. Définit l'attribut de lecture seule sur le fichier ou dossier à l'issue de l'extraction. [pas pour les projets] Ouvre le document après l'extraction, soit dans l'espace de travail PowerAMC courant, soit dans une application externe. [modèles et fichiers uniquement] Ajoute le document extrait dans l'espace de travail courant. Documents du projet La zone de groupe Documents du projet répertorie les modèles et fichiers associés au projet, et permet de les sélectionner pour extraction avec le projet. Notez que seuls les documents de projet qui sont se trouvent dans le projet sont répertoriés ici. Les documents stockés hors du projet et uniquement attachés à ce dernier ne sont pas répertoriés et doivent être extraits séparément. 36 PowerAMC

45 Chapitre 2 : Gestion des documents dans le référentiel Utilisation de la fenêtre Extraction de plusieurs documents La fenêtre Extraction de plusieurs modèles ou fichiers permet d'extraire simultanément plusieurs documents du référentiel. Vous pouvez afficher cette fenêtre de l'unes des façons suivantes : Pointez sur la racine de l'espace de travail ou sur un dossier contenant plusieurs modèles ou fichiers (ou bien sélectionnez plusieurs modèles ou fichiers en utilisant la touche Ctrl dans l'onglet Local de l'explorateur d'objets), cliquez le bouton droit de la souris, puis sélectionnez Extraire. Pointez sur la racine de l'espace de travail ou sur un dossier contenant plusieurs modèles ou fichiers (ou bien sélectionnez plusieurs modèles ou fichiers en utilisant la touche Ctrl dans l'onglet Local de l'explorateur d'objets), cliquez le bouton droit de la souris, puis sélectionnez Mettre à jour depuis le référentiel. Sélectionnez Référentiel > Extraire. Appuyez sur Ctrl+Alt+E Les outils suivants sont disponibles dans cette fenêtre : Outil Description Réglages Affiche la fenêtre Extraction d'un document (voir Utilisation de la fenêtre Extraction d'un document à la page 34) pour le document sélectionné afin de vous permettre de spécifier les paramètres d'extraction. Ajouter une version de document - Affiche la fenêtre Extraction d'un document (voir Utilisation de la fenêtre Extraction d'un document à la page 34) pour vous permettre de sélectionner un document à ajouter à la liste d'extraction. Utilisation du référentiel 37

46 Outil Description Ajouter les versions de documents liées Ajoute dans la liste d'extraction tous les documents liés au document sélectionné par le biais de raccourcis ou de liens de génération. Cet outil permet d'extraire l'environnement global d'un modèle. Ajouter les versions de documents d'une configuration Affiche une fenêtre de sélection permettant de spécifier une configuration à ajouter à la liste d'extraction. Une configuration est un jeu de documents défini dans le référentiel sous un libellé. Lorsque vous sélectionnez une configuration, vous ajoutez dans la liste d'extraction toutes les versions de document incluses dans cette configuration. Supprimer Supprime le document sélectionné de la liste de d'extractions. Déplacer vers le haut Déplace le document sélectionné vers le haut de la liste. Déplacer vers le bas - Déplace le document sélectionné vers le bas de la liste. 38 PowerAMC

47 Chapitre 2 : Gestion des documents dans le référentiel Utilisation de la fenêtre Extraction d'un modèle Lorsque vous extrayez des modèles PowerAMC, la fenêtre Extraire le modèle permet de passer en revue les différences entre les version en local et dans le référentiel et de les appliquer ou rejeter le cas échéant. Vous affichez cette fenêtre si vous extrayez un modèle PowerAMC dans un fichier existant sur votre ordinateur et que vous avez sélectionné Fusionner le document dans la fenêtre Extraction d'un document ou Extraction d'un projet. Dans la fenêtre Extraire le modèle, la version référentiel du modèle est affichée sur la gauche, et la version locale sur la droite. Vous pouvez sélectionner ou rejeter chacune des différences pour la consolidation. Lorsque vous sélectionnez la fonctionnalité de fusion des documents et en fonction de l'état de la case Ouvrir le document, PowerAMC effectue les actions suivantes : Modèle local Case Ouvrir le document Impact de la fusion de documents Ouvert Sélectionnée Fusion des modèles, et enregistrement du modèle local. Utilisation du référentiel 39

48 Modèle local Case Ouvrir le document Impact de la fusion de documents Ouvert Désélectionnée Fusion des modèles et enregistrement et fermeture du modèle local. Fermé Sélectionnée Ouverture du modèle local, fusion des modèles, et enregistrement du modèle local. Fermé Désélectionnée Ouverture du modèle local, fusion des modèles, et enregistrement et fermeture du modèle local. Pour plus d'informations sur la fonctionnalité de fusion, voir "Fusion de modèles" dans le chapitre Comparaison et fusion de modèles du Guide des fonctionnalités générales. Extraction de packages Par défaut, lorsque vous extrayez un modèle PowerAMC, tous ses packages sur lesquels vous disposez de permissions Lecture, Ecriture et Totale sont extraits avec le modèle. Les packages pour lesquels vous ne disposez que de la permission Liste ou ceux pour lesquels vous ne disposez d'aucune permission ne peuvent pas être extraits. Si vous préférez ne pas extraire un modèle complet, vous pouvez sélectionner un ou plusieurs packages à partir de la boîte de dialogue Sélection de packages, qui affiche les packages sur lesquels vous disposez de permissions Lecture, Ecriture et Totale. Si vous sélectionnez un package parent, PowerAMC étend automatiquement la sélection aux sous-packages. Si vous désélectionnez certains sous-packages dans l'arborescence des packages, la sélection des packages parent est grisée pour signaler cette sélection incomplète. Si vous sélectionnez un sous-package, PowerAMC étendu automatiquement la sélection à ses packages parent afin de préserver le contexte du sous-package. Action Sélection Impact Sélectionner Modélisation Package 1, 2 et 3 sont automatiquement sélectionnés. Désélectionner Package 1 Package 2 et 3 sont automatiquement désélectionnés. Sélectionner Package 3 Modélisation, Package 1 et 2 sont automatiquement sélectionnés. 40 PowerAMC

49 Chapitre 2 : Gestion des documents dans le référentiel Action Sélection Impact Désélectionner Package 3 Les cases à cocher de Modélisation, Package 1 et 2 sont grisées. Remarque : Lorsque vous extrayez un package contenant des raccourcis, la sélection de packages est étendue pour inclure les packages cibles référencés par les raccourcis et ce, même si vous ne disposez pas de la permission Lecture sur ces packages. Parcourir le référentiel Le référentiel de PowerAMC peut contenir les types de noeud suivants. Noeud Description Racine Dossier Projet Documents Package Catégorie d'objet Diagramme Objet [lorsque la connexion est établie] Le noeud racine affiche le nom du référentiel, le nom de connexion de l'utilisateur et la branche courante. Utilisé pour organiser les documents dans le référentiel. Conteneur pour les modèles et autres fichiers. Modèles, rapports multimodèle, fichiers de ressources (voir Partage des ressources dans le référentiel à la page 71), et fichiers d'application externes tels que fichiers MS Office, ou fichiers graphiques. Packages dans les modèles. Catégories d'objets dans les modèles (si la case Afficher les objets est sélectionnée dans les Options générales). Diagrammes dans les modèles (si la case Afficher les objets est sélectionnée dans les Options générales). Objets dans les modèles (si la case Afficher les objets est sélectionnée dans les Options générales). Propriétés de la racine du référentiel Pointez sur la racine de l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Propriétés pour afficher la feuille de propriétés de la racine. L'onglet Connexion contient les propriétés suivantes : Propriété Description Nom du référentiel Spécifie le nom du référentiel auquel vous êtes connecté. Utilisation du référentiel 41

50 Propriété Nom de connexion Branche courante Description Spécifie le nom d'utilisateur sous lequel vous êtes connecté. Spécifiez la branche que vous visualisez. Les onglets suivants sont également disponibles : LDAP - répertorie les paramètres de configuration LDAP permettant aux utilisateurs LDAP distants d'accéder au référentiel, voir Contrôle de l'accès au référentiel à l'aide de LDAP à la page 106. Permissions répertorie les utilisateurs et les groupes disposant de permissions sur l'intégralité du référentiel. Pour plus d'informations sur les permissions, voir Contrôle des permission des éléments du référentiel à la page 118. Info. version spécifie quand le référentiel a été créé et quand il a été modifié pour la dernière fois, voir Propriétés des documents et objets du référentiel à la page 81. Dossiers du référentiel Vous pouvez utiliser des dossiers pour organiser le contenu du référentiel. Par exemple, vous pouvez créer différents dossiers pour chaque sujet ou chaque équipe travaillant sur un projet. Les dossiers peuvent s'avérer très utiles pour organiser les permissions, car tout document consolidé dans un dossier hérite des permissions définies sur ce dernier. Vous devez disposer d'une permission Ecriture sur l'emplacement dans lequel vous souhaitez créer le dossier. Remarque : Un projet se comporte comme un dossier. Vous pouvez renommer un projet, le supprimer, le geler ou l'utilisation accorder des permissions d'accès, etc. tout comme vous le faites pour un dossier de référentiel. Pour plus d'informations sur la création d'un projet, voir le chapitre Projets et matrices de cadre d'architecture dans le Guide des fonctionnalités générales. Création d'un dossier Vous pouvez créer un dossier dans l'onglet Référentiel de l'explorateur d'objets. 1. Dans l'onglet Référentiel de l'explorateur d'objets, pointez sur le noeud racine, sur un projet ou sur un dossier dans lequel vous souhaitez créer un dossier, cliquez le bouton droit de la souris, puis sélectionnez Nouveau > Dossier. La feuille de propriétés pour le nouveau dossier s'affiche : 42 PowerAMC

51 Chapitre 2 : Gestion des documents dans le référentiel 2. Saisissez un nom pour le dossier. Le nom doit être unique à ce niveau dans le référentiel. 3. Cliquez sur l'onglet Permissions, puis ajoutez des permissions pour tous les utilisateurs et groupes appropriés. Tous les documents consolidés dans ce dossier vont hériter de ces permissions. Pour plus d'informations sur les permissions, voir Contrôle des permission des éléments du référentiel à la page Cliquez sur OK pour compléter la création du dossier. Changement du nom d'un dossier Vous pouvez facilement renommer un dossier dans le référentiel. Lorsque vous renommez un dossier, vous devez garder à l'esprit que PowerAMC contrôle l'unicité du nom pour les dossiers parents directement liés au noeud racine. 1. Sélectionnez un noeud de dossier dans l'explorateur d'objets, puis appuyez sur la touche f2. 2. Saisissez un nouveau nom, puis cliquez hors de la zone d'édition. Déplacement d'un dossier Vous pouvez déplacer les dossiers et les documents dans le référentiel. Lorsque vous déplacez un document, vous le déplacez avec toute son arborescence de versions. Vous ne pouvez pas déplacer une version particulière d'un document, de même que vous ne pouvez pas déplacer un objet d'un modèle à l'autre. Notez que vous ne pouvez pas déplacer un projet sous un autre projet. Pour déplacer un dossier ou un modèle, vous devez avoir la permission Ecriture sur le dossier cible et la permission Totale sur le dossier ou le document déplacé. Utilisation du référentiel 43

52 Suppression d'un dossier Vous ne pouvez supprimer que les dossiers vides. Avant de pouvoir supprimer un dossier, vous devez supprimer son contenu. 1. Pointez sur un dossier dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Supprimer dans le menu contextuel. Une boîte de confirmation s'affiche. 2. Cliquez sur OK pour confirmer la suppression. Propriétés des documents et objets du référentiel Vous pouvez double-cliquer sur un dossier, document ou un modèle dans le référentiel pour afficher sa feuille de propriétés. Onglet Général L'onglet Général affiche des informations en lecture seule concernant l'objet. Propriétés Nom Code Commentaire Type Emplacement Description Nom de l'élément. Il doit s'agir d'un nom clair et explicite, qui permette à des utilisateurs non spécialistes de savoir à quoi sert l'élément. [non disponible pour les dossiers] Nom technique de l'élément. Ce nom est utilisé pour la génération de code ou de scripts. Il peut avoir une forme abrégée et il est préférable qu'il ne contienne pas d'espace. [non disponible pour les dossiers] Informations supplémentaires au sujet de l'objet. [non disponible pour les dossiers] Type d'objet : Modèle ou package PowerAMC, autres types de documents et d'objets. [dossiers, documents et modèle] Chemin complet du dossier ou du document. [packages de modèle] Hiérarchie de packages dans le modèle. Etat [non disponible pour les dossiers] Indique l'état du document : Modifiable ou gelé Verrouillé et auteur du verrou Onglet Info. version L'onglet Info. version affiche des informations relatives à l'origine de l'objet. 44 PowerAMC

53 Chapitre 2 : Gestion des documents dans le référentiel Propriété Création Dernière modification Généré depuis (Objet d'origine) Numéro (Version) Branche (Version) Commentaire Description Affiche le nom complet de l'utilisateur qui a créé l'élément dans le référentiel, ainsi que la date de cette création. Affiche le nom complet de l'utilisateur qui a modifié en dernier l'élément, ainsi que la date de cette modification. [objets de modèle uniquement] Cette zone ne s'affiche que si l'objet courant a été généré à partir d'un autre objet, et affiche le nom de l'objet d'origine. Cliquez sur l'outil Propriétés à droite de cette zone pour afficher la feuille de propriétés de l'objet d'origine. [non disponible pour les dossiers] Numéro de la version [non disponible pour les dossiers] Nom de la branche à laquelle la version appartient. [non disponible pour les dossiers] Commentaire sur la version. Onglet Versions Affiche une arborescence constituée de différentes branches contenant des versions du document. Vous pouvez développer les noeuds d'une branche pour afficher les versions du document. Les outils suivants ne sont disponibles que dans la page Version d'un document : Outil Description Propriétés - Affiche la feuille de propriétés du document. Extraire - Extrait la version sélectionnée. Voir Extraction de documents du référentiel à la page 31. Comparer - Compare deux versions. Voir Comparaison de modèles dans le référentiel à la page 49. Geler - Gèle la version sélectionnée. Voir Versions de documents à la page 55. Dégeler - Dégèle la version sélectionnée. Voir Versions de documents à la page 55. Verrouiller - Verrouille la version sélectionnée. Voir Verrous de document à la page 57. Déverrouiller - Déverrouille la version sélectionnée verrouillée. Voir Verrous de document à la page 57. Supprimer - Supprime la version sélectionnée. Utilisation du référentiel 45

54 Remarque : Lorsque vous consolidez un document, la date locale est convertie au format GMT (Greenwich Mean Time). Elle est à nouveau convertie à l'heure locale lorsque vous faites une extraction du document. Cette fonction permet de comparer des versions de document stockées dans le référentiel lorsque différentes équipes travaillent dans des fuseaux horaires différents. Autres onglets Les autres onglets sont les suivants : Notes [modèles, packages et objets de modèle uniquement] - contient deux sousonglets : Description - fournissent des informations détaillées sur l'objet. Annotation - contient vos propres notes concernant la mise en oeuvre. Attributs [modèles, packages et objets de modèle uniquement] - affiche des propriétés supplémentaires pour ces éléments. Collections [modèles, packages et objets de modèle uniquement] - affiche une liste de collections de sous-objets, dans laquelle ces derniers sont pris en charge par l'élément. Par exemple, dans un MCD consolidé, l'onglet Collections de la feuille de propriétés d'une entité peut afficher les règles de gestion attachées à cette entité. Permissions [modèles, packages, dossiers et autres documents uniquement] répertorie les utilisateurs et groupes disposant de permissions sur le document. Pour plus d'informations sur les permissions, voir Contrôle des permission des éléments du référentiel à la page 118. Recherche d'objet dans les modèles PowerAMC Vous pouvez chercher des objets de modèle PowerAMC dans le référentiel. La fonctionnalité de recherche ne s'applique pas aux documents issus d'applications externes. Il n'est pas nécessaire de disposer de droits particuliers pour chercher des objets dans les modèles PowerAMC, la permission Liste suffit pour cette opération. Différents utilisateurs peuvent utiliser la fonctionnalité de recherche pour des besoins différents : Un membre d'une équipe peut rechercher des objets dans le référentiel en vue de les réutiliser. Lorsqu'il trouve ces objets, il peut directement extraire le modèle pour copier les objets cible et en faire des raccourcis dans d'autres modèles. Un administrateur peut rechercher des objets différents mais ayant le même nom afin d'extraire leurs modèles pour les normaliser, ou employer le filtre Utilisateur et date pour vérifier qui a fait des changements sur des objets recherchés et à quel moment. 1. Appuyez sur Ctrl+Alt+F, sélectionnez Référentiel > Rechercher un objet, ou bien pointez sur le noeud racine, un dossier ou un modèle dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, et sélectionner Rechercher un objet. 46 PowerAMC

55 Chapitre 2 : Gestion des documents dans le référentiel La boîte de dialogue Recherche d'objets s'affiche à l'onglet Nom et emplacement. 2. Définissez les paramètres appropriés sur les différents onglets de la boîte de dialogue, puis cliquez sur le bouton Rechercher. Les messages du processus de recherche sont affichés dans la fenêtre Résultats située dans la partie inférieure de la fenêtre PowerAMC. Remarque : Une fois que vous avez lancé la recherche d'objets, vous pouvez la stopper à tout moment en cliquant sur le bouton Arrêter dans la boîte de dialogue Recherche d'objets. La boîte de dialogue Recherche d'objets reste ouverte jusqu'à la fin du processus, puis se ferme et la fenêtre Liste de résultats affiche le résultat de la recherche. Si vous pointez sur un objet dans la fenêtre Liste de résultats et cliquez le bouton droit de la souris, vous pouvez sélectionner : Utilisation du référentiel 47

56 Propriétés : pour afficher la feuille de propriétés de l'objet trouvé. Extraire le modèle : pour extraire le modèle contenant l'objet trouvé. Paramètres de recherche d'objet Les quatre onglets de la fenêtre Recherche d'objets permettent de spécifier de nombreux paramètres pour votre recherche. Nom et emplacement limite à la recherche en fonction des facteurs suivants : emplacement dans le référentiel, numéro de version de l'objet, type de modèle, type d'objet, et si les raccourcis peuvent être inclus, le nom ou le code de l'objet (les caractères génériques peuvent être utilisés). Dates locales limite la recherche en fonction de la date de création ou de modification ou de l'utilisateur sur la machine locale. Dates du référentiel limite la recherche en fonction de la date de création ou de modification (consolidation) ou de l'utilisateur dans le référentiel. Avancée limite la recherche en fonction d'un attribut de l'objet. Les attributs disponibles sur cet onglet changent en fonction de l'objet sélectionné sur l'onglet Nom et emplacement, et selon que les raccourcis sont ou non inclus. Cochez la case dans la colonne U (Utilisé) pour rechercher sur l'attribut correspondant, et spécifiez une chaîne dans la colonne expression pour faire porter la recherche sur cette chaîne. Caractères spéciaux Les caractères spéciaux suivants permettent d'utiliser des expressions régulières de base pour la recherche portant sur le nom ou le code d'un objet ou sur des valeurs d'attributs d'objet : * - représente d'aucun à n'importe nombre de caractères,? représente exactement un caractère, \* - * représente un caractère normal, \? -? représente un caractère normal, \\ - \ représente un caractère normal, true/false - Valeur booléenne (True représente une case cochée dans l'interface. Exemples : P* renvoie "Personnel" et "Paris" *ISTE renvoie "Liste" et "Spécialiste" *96 renvoie "01/11/96" et "26/08/96"????ER renvoie "Writer" et "Seller" mais pas "inner" COLN? renvoie "COLN1" et "COLN2" *_emp_??? renvoie "div_emp_fon" et "div_emp_idn" 48 PowerAMC

57 Chapitre 2 : Gestion des documents dans le référentiel Pour plus d'informations sur la fenêtre Recherche d'objets de PowerAMC, voir "Recherche d'objets" dans le chapitre Objets du Guide des fonctionnalités générales. Comparaison de modèles dans le référentiel Vous pouvez comparer des modèles PowerAMC afin d'obtenir une liste détaillée de leurs différences. Vous pouvez comparer : Deux modèles différents dans le référentiel. Deux version différentes du même modèle dans le référentiel. Un modèle sur votre machine locale et un autre modèle dans le référence. Avertissement! Vous devez sélectionner des modèles du même type, MPD, MOO, etc. Vous ne pouvez pas comparer des modèles de type différent. 1. Appuyez sur Ctrl+Alt+M, sélectionnez Référentiel > Comparer, ou bien pointez sur un modèle dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, et sélectionnez Comparer. La boîte de dialogue Sélection des modèles à comparer s'affiche : 2. Pour Modèle 1 et Modèle 2, sélectionnez : Un emplacement pour spécifier si le modèle à comparer est situé dans votre espace de travail local ou dans le référentiel. Le nom du modèle à comparer cliquez sur l'outil Propriétés à droite de la liste pour afficher la feuille de propriétés du modèle sélectionné. Sélectionnez le même modèle dans les deux listes si vous voulez comparer les différentes versions. La version du modèle sur laquelle faire porter la comparaison la version la plus récente est sélectionnée par défaut. Utilisation du référentiel 49

58 3. Cliquez sur OK pour ouvrir la fenêtre Comparaison de modèles : Pour plus d'informations sur la fenêtre Comparaison de modèles, voir "Comparaison de modèles", dans le chapitre Comparaison et fusion de modèles du Guide des fonctionnalités générales. Analyse d'impact Lorsque vous créez un raccourci externe ou lorsque vous attachez une règle de gestion à un objet, un lien de dépendance est automatiquement créé entre les modèles ou les objets. Les dépendances permettent de vérifier l'utilisation qui est faite d'un objet ou d'un modèle. On distingue deux types de dépendances : Interne, lorsque les liens sont à l'intérieur d'un modèle. Ces dépendances sont enregistrées dans le modèle et s'affichent dans l'onglet Dépendances de la feuille de propriétés d'un objet. Externe, lorsque les liens sont entre modèles. Ces dépendances sont créées lors d'une génération intermodèle ou de la création de raccourcis externes, elles ne s'affichent dans l'onglet Dépendances que si le modèle lié est ouvert dans l'espace de travail. Si le modèle lié n'est pas disponible, vous pouvez utiliser le référentiel pour récupérer les informations concernant ces dépendances externes. 50 PowerAMC

59 Chapitre 2 : Gestion des documents dans le référentiel Comprendre l'analyse d'impact Le référentiel calcule et enregistre les informations concernant les dépendances externes dans les modèles consolidés. Vous pouvez extraire ces informations et les afficher dans l'onglet Dépendances d'une feuille de propriétés d'objet, même lorsque les modèles liés ne sont pas disponibles. Ce type d'information peut servir à analyser les impacts qu'auraient les modifications faites dans un modèle ou sur un objet de la façon suivante : Lien de génération : vous pouvez vérifier si un modèle a été généré, ainsi que le nom du ou des modèles qui ont été générés à partir du modèle courant (colonne Généré comme dans l'onglet Dépendances). Lien de raccourci externe : vous pouvez vérifier si les objets dans le modèle sélectionné ont des raccourcis dans des modèles externes. Extraction des dépendances depuis le référentiel Il n'y a différentes façons d'extraire les informations concernant les dépendances externes d'un modèle que si le modèle lié est également consolidé dans le référentiel. Cochez la case Extraire les dépendances dans la boîte de dialogue d'extraction au moment ou vous faites l'extraction du document. Cochez la case Extraire les dépendances dans l'onglet Référentiel de la boîte de dialogue des options générales de façon à extraire les dépendances externes systématiquement. Cochez la case Extraire les dépendances dans la boîte de dialogue de consolidation si vous faites une extraction du modèle après la consolidation. Mise à jour des dépendances d'un modèle depuis le référentiel Cette fonctionnalité n'est disponible que pour les modèles consolidés dans le référentiel. Les dépendances externes obtenues grâce au référentiel reflètent l'état d'un modèle tel qu'il est stocké dans le référentiel. Il est possible qu'elles ne soient pas à jour si le modèle local a été modifié, ou s'il n'a pas encore été consolidé. Cliquez à l'aide du bouton droit de la souris sur le noeud d'un modèle dans l'onglet Local de l'explorateur d'objets et sélectionnez la commande Mettre à jour les dépendances depuis le référentiel. Le modèle "Avant projet" contient une entité Client. Vous créez un raccourci externe de cette entité dans le modèle "Conception". Dans le modèle "Conception", vous créez une entité Ventes et une association entre le raccourci de Client et Ventes. Vous consolidez les deux MCD en veillant à cocher la case Extraire les dépendances dans la boîte de dialogue de consolidation. Lorsque vous affichez l'onglet Dépendances dans la feuille de propriétés de l'entité Client du modèle cible, les informations suivantes s'affichent pour indiquer que l'entité a un raccourci qui lui-même est utilisé dans une relation dans un autre modèle : Utilisation du référentiel 51

60 Exécution de requêtes SQL dans le référentiel Vous pouvez exécuter des requêtes SQL SELECT standard sur le référentiel via la fenêtre Exécution d'une requête. Si vous souhaitez exécuter d'autres types de requêtes, veuillez utilisez l'éditeur de requêtes de votre SGBD. Remarque : Vous ne pouvez pas exécuter des requêtes SQL lorsque vous utilisez le proxy de référentiel. 1. Sélectionnez Référentiel > Exécuter SQL pour afficher la boîte de dialogue Exécution d'une requête. Remarque : La boîte de dialogue Connexion s'affiche si vous n'êtes pas encore connecté au référentiel. Spécifiez les paramètres de connexion, puis cliquez sur OK pour vous connecter. 52 PowerAMC

61 Chapitre 2 : Gestion des documents dans le référentiel 2. Saisissez une ou plusieurs requêtes SQL dans la zone de saisie en utilisant la syntaxe correspondance à votre SGBD, puis cliquez sur le bouton Exécuter. Les résultats de votre requête s'affichent dans le volet Résultats. 3. Cliquez sur Fermer pour quitter la boîte de dialogue Exécution d'une requête. Options du référentiel Pour définir les options du référentiel, sélectionnez Outils > Options générales pour afficher la fenêtre Options générales, puis sélectionnez la catégorie Référentiel. Connexion Les options suivantes sont disponibles dans la zone de groupe Connexion : Option Connexion automatique Description Etablit automatiquement la connexion avec le dernier référentiel lorsque vous lancez PowerAMC. Explorateur Les options suivantes sont disponibles dans la zone de groupe Explorateur : Option Actualisation auto Description Met à jour l'affichage de l'onglet Référentiel de l'explorateur d'objets automatiquement. La fréquence de mise à jour est définie dans le champ Actualiser toutes les... Utilisation du référentiel 53

62 Option Afficher Afficher les objets Montrer le numéro de version Afficher les icônes d'état dans l'espace de travail Description Spécifie si le nom ou le code des éléments est affiché dans l'onglet Référentiel de l'explorateur d'objets. Spécifie que les diagrammes et objets PowerAMC peuvent être affichés dans l'onglet Référentiel de l'explorateur d'objets. Spécifie que le numéro de version des documents et objets est affiché dans l'onglet Référentiel de l'explorateur d'objets. Spécifie que l'état des versions locales des documents (par opposition à celles stockées dans le référentiel) s'affiche dans l'onglet Référentiel de l'explorateur d'objets. Extraction Les options suivantes sont disponibles dans la zone de groupe Extraction : Option Description Fusionner le document Ajouter à l'espace de travail Extraire les dépendances Mettre à jour les ressources automatiquement Spécifie que la case Fusionner le document est cochée par défaut dans la fenêtre d'extraction. Spécifie que la case Ajouter à l'espace de travail est cochée par défaut dans la fenêtre d'extraction. Spécifie que la case Extraire les dépendances est cochée par défaut dans la fenêtre d'extraction. Permet l'extraction et la mise à jour automatique des fichiers de ressources partagés (voir Partage de ressources dans le référentiel à la page 71). Consolidation Les options suivantes sont disponibles dans la zone de groupe Consolidation : Option Description Mise à jour par lot Geler à l'issue de la consolidation Enregistrer les diagrammes préparés Spécifie que la case Mise à jour par lot est cochée par défaut dans la fenêtre de consolidation. Spécifie que la case Geler à l'issue de la consolidation est cochée par défaut dans la fenêtre de consolidation. Spécifie que la case Enregistrer les diagrammes préparés est sélectionnée par défaut dans la fenêtre de consolidation. 54 PowerAMC

63 Chapitre 2 : Gestion des documents dans le référentiel Versions de documents Une version est un instantané d'un document ou d'un modèle à un moment donné. Les versions sont créées afin de conserver une trace des modifications apportées durant le cycle de vie d'un document ou d'un objet, et s'affichent sous une arborescence dans l'onglet Versions des feuilles de propriétés d'objet de référentiel. Les détails de la version courante sont affichés dans l'onglet Info. version. Par défaut, et à la différence de nombreux autres systèmes de référentiel, le référentiel PowerAMC ne crée pas une nouvelle version d'un document chaque fois que le consolidez. Pour créer une nouvelle version d'un document, vous devez spécifier que vous voulez la geler. Vous pouvez geler des documents lors de la consolidation ou de l'extraction, ou bien le faire à l'intérieur du référentiel. Tous les documents et objets de modèle peuvent faire l'objet de version, à l'exception des dossiers, projets, utilisateurs et groupes de référentiel. Les versions autres que la première version ou la version de référence sont stockées sous forme de différences par rapport à la version précédente. Par conséquent, la version de référence d'un modèle stocké dans le référentiel occupe un espace deux fois supérieur à celui nécessaire lorsqu'il est enregistré sous forme de fichier XML. Remarque : Vous ne pouvez pas contrôler de façon individuelle le gel et la création de versions d'objets de modèle PowerAMC. Chaque objet modifié a sa propre version gelée et son numéro de version est incrémenté à chaque fois que vous gelez la version de son modèle parent. Gel de versions de document Il y a différentes façons de geler un document (et les objets qu'il contient) dans la branche courante. Pointez sur un dossier, un document, ou un noeud racine, cliquez le bouton droit de la souris, puis sélectionnez la commande Geler. Cette commande n'est disponible que si vous disposez des droits Geler des versions ainsi que de la permission d'écriture sur les documents. Utilisez l'outil Geler d'une feuille de propriétés de : document (onglet Versions) branche (onglet Membres multisélection possible) configuration (onglet Membres multisélection possible) Avant ou après la consolidation en utilisant l'option appropriée dans la boîte de dialogue Consolidation d'un document ou Consolidation d'un projet (voir Consolidation de changements dans les documents stockés dans le référentiel à la page 16) Vous devez disposer de la permission Ecriture ou Totale pour geler une version de document. Utilisation du référentiel 55

64 Remarque : Utilisation de l'option Geler à l'issue de la consolidation dans les options du référentiel Cette option spécifie que l'option Geler à l'issue de la consolidation de la boîte de dialogue Consolidation d'un document est sélectionnée par défaut. Gel d'une version de document depuis l'explorateur d'objets du Référentie Pour geler une version de document depuis l'explorateur d'objets du Référentiel : 1. Pointez un noeud de document dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris puis sélectionnez Geler pour afficher la boîte de dialogue Gel d'une version : 2. Saisissez un commentaire dans la zone Commentaire. 3. Cliquez sur OK pour geler la version. Les modifications ultérieures du document seront effectuées sur une nouvelle version. Dégel d'une version de document Il y a différentes façons de dégeler la version la plus récente d'un document dans la branche courante.: Pointez sur un document gelé (ou bien sur un dossier ou le noeud racine), cliquez le bouton droit de la souris, puis sélectionnez la commande Dégeler. Utilisez l'outil Dégeler d'une feuille de propriétés de : document (onglet Versions), branche (onglet Membres multisélection possible), configuration (onglet Membres multisélection possible). Vous devez disposer de la permission Ecriture ou Totale pour dégeler une version de document. 56 PowerAMC

65 Chapitre 2 : Gestion des documents dans le référentiel Suppression de versions de document Il y a différentes façons de supprimer la dernière version d'un document dans la branche courante. Pointez sur un document gelé, cliquez le bouton droit de la souris, puis sélectionnez Supprimer la version. Utilisez l'outil Supprimer d'une feuille de propriétés de : document (onglet Versions), branche (onglet Membres multisélection possible), configuration (onglet Membres multisélection possible). Avertissement! La suppression d'une version est irréversible. Vous devez disposer de la permission Totale pour supprimer une version de document. Vous ne pouvez supprimer que la dernière version dans une branche du référentiel. Lorsque vous supprimez une version, vous supprimez tous les objets que celle-ci contient. Remarque : Lorsque vous supprimez une version, il est possible que vous supprimiez les objets cible de raccourcis existant dans d'autres modèles. Ces objets cibles sont cependant susceptibles d'exister dans les versions suivant la version supprimée. Les liens de raccourcis sont reconstruits après extraction dans l'espace de travail local, ceci n'a donc pas d'impact sur le référentiel. Suppression de toutes les versions d'un document Pour supprimer toutes les versions d'un document dans toutes les branches du référentiel, pointez sur ce document, cliquez le bouton droit de la souris, puis sélectionnez Supprimer le document. Cette action ne peut pas être annulée. Verrous de document Un verrou est une protection temporaire que vous définissez sur une version de document que vous extrayez, ce afin d'empêcher que d'autres utilisateurs le mettent à jour avant que vous ne le consolidiez. Seul vous ou un utilisateur disposant de la permission Totale sur le document peut consolider le document. Si un autre utilisateur tente de le consolider, un message s'affiche pour le prévenir que la version est verrouillée. Le plus souvent, vous libérez le verrou lorsque vous consolidez le document. Vous pouvez également verrouiller des documents dans le référentiel sans les extraire. Les documents verrouillés s'affichent avec une icône de verrou dans l'onglet Référentiel de l'explorateur d'objets : Utilisation du référentiel 57

66 Icône Description Icône bleue si l'utilisateur connecté est à l'origine du verrou. Icône rouge si l'utilisateur connecté n'a pas posé le verrou. Verrouillage de documents Il y a différentes façons de verrouiller un document dans la branche courante. Pointez sur un document, un dossier ou le noeud racine, cliquez le bouton droit de la souris, puis sélectionnez la commande Verrouiller. Cette commande n'est disponible que si vous disposez du droit Verrouillage des versions ainsi que des permissions appropriées sur les documents. Utilisez l'outil Verrouiller sur une feuille de propriétés de : document (onglet Versions), branche (onglet Membres multisélection possible), configuration (onglet Membres multisélection possible). Utilisez la boîte de dialogue Liste des verrous (voir Gestion des verrous de document dans la boîte de dialogue Liste des verrous à la page 59). Avant ou après l'extraction en utilisation l'option appropriée dans la boîte de dialogue Extraction d'un document ou Extraction d'un projet (voir Consolidation de changements dans les documents stockés dans le référentiel à la page 31). Vous devrez avoir la permission Verrouiller afin de geler une version d'un document. Verrouillage d'une version de document à partir de l'explorateur d'objets du Référentiel : Pour verrouiller une version de document à partir de l'explorateur d'objets du Référentiel : 1. Pointez sur le noeud d'un document dans l'explorateur d'objets du référentiel, cliquez le bouton droit de la souris, puis sélectionnez Verrouiller pour afficher la boîte de dialogue Verrouillage d'un document. 2. Saisissez un commentaire dans la zone Commentaire. 58 PowerAMC

67 Chapitre 2 : Gestion des documents dans le référentiel 3. Cliquez sur OK pour verrouiller la version. Les autres utilisateurs ne seront pas en mesure de consolider des modifications dans la version, sauf si vous la déverrouillez. Gestion des verrous de document dans la boîte de dialogue Liste des verrous Vous pouvez passer en revue les documents qui sont verrouillés, et verrouiller des documents supplémentaires en sélectionnant Référentiel > Verrous pour afficher la boîte de dialogue de Liste des verrous. Les outils suivants sont disponibles dans la boîte de dialogue de Liste des verrous : Utilisation du référentiel 59

68 Outil Description Réglages Affiche la fenêtre Verrouillage d'un document pour le document sélectionné, qui montre les détails du verrou. Ajouter un verrou Affiche la fenêtre Verrouillage d'un document. Sélectionnez un document à verrouiller dans la liste Nom et spécifiez un commentaire, puis cliquez sur OK pour verrouiller le document et revenir à la boîte de dialogue Liste des verrous. Ajouter les version de document liées - [modèle uniquement] Verrouille les modèles PowerAMC que le modèle sélectionné référence via des raccourcis externes. Les modèles liés sont automatiquement ajoutés dans la boîte de dialogue Liste des verrous. Ajouter les versions de documents d'une configuration Affiche la boîte de dialogue Sélection d'une configuration, qui permet de sélectionner une configuration à verrouiller. Les versions de document contenues dans la configuration sont verrouillées et ajoutées dans la boîte de dialogue Liste des verrous. Supprimer Déverrouille le document sélectionné, et le supprime de la liste. Notez que cet outil ne supprime pas la version de document. Remarque : Vous pouvez verrouiller toutes les versions de documents dans la branche courante en pointant le noeud racine de l'explorateur d'objets et cliquant le bouton droit de la souris, puis en sélectionnant Verrouiller dans le menu contextuel. Cette commande n'est accessible que si vous avez le droit Verrouillage des versions et les permissions appropriées sur les documents. Déverrouillage de documents Il y a différentes façons de déverrouiller un document verrouillé. Pointez sur un document verrouillé (ou un dossier, ou le dossier racine), cliquez le bouton droit de la souris, puis sélectionnez la commande Déverrouiller. Utilisez l'outil Supprimer dans la boîte de dialogue Liste des verrous (voir Gestion des verrous de document dans la boîte de dialogue Liste des verrous à la page 59): Utilisez l'outil Dégeler dans une feuille de propriétés de : document (onglet Versions), branche (onglet Membres multisélection possible), configuration (onglet Membres multisélection possible). Après la consolidation en utilisation l'option appropriée dans la boîte de dialogue Consolidation d'un document ou Consolidation d'un projet (voir Consolidation de changements dans les documents stockés dans le référentiel à la page 16). Vous devez avoir verrouiller vous-même le document ou disposer de la permission Totale pour pouvoir déverrouiller ce document. 60 PowerAMC

69 Chapitre 2 : Gestion des documents dans le référentiel Branches de référentiel Une branche est une vue de l'arborescence des versions, qui montre toutes les versions de document présentées dans sa branche parent au moment de la création de la nouvelle branche. La branche à partir de laquelle la branche est créée est appelée branche de base. Par défaut, le référentiel contient une seule branche nommée <Défaut>. Le nombre de niveaux de branches n'est pas limité. Chaque fois que vous vous connectez au référentiel, vous avez une branche courante, et l'explorateur du référentiel n'affiche que les versions de document qui existent dans cette branche AINSI que celle de sa branche de base. Les branches sont utilisées pour permettre les mises à jours parallèles d'un document, et peuvent être utilisées afin d'organiser et de rendre accessibles plusieurs versions d'un même document. Dans l'exemple suivant, trois documents sont utilisés par une équipe de développement : Spécifications.doc - pour spécifier l'architecture du logiciel. Modèle.MPD - pour concevoir le logiciel. Implémentation.MOO - pour élaborer la politique de mise en oeuvre du logiciel. Le projet inclut trois branches utilisées pour effectuer des tâches différentes : La branche MAJEURE est utilisée pour travailler sur les versions majeures du logiciel : en spécifiant des nouveaux besoins, en concevant et en mettant en oeuvre des fonctionnalités importantes. La branche MINEURE est utilisée pour travailler sur une version mineure et corriger des bogues et ajouter des petites fonctionnalités. La branche EBF (Emergency Bug Fix) est créée après une version mineure afin de permettre aux ingénieurs de corriger des bogues sur une version du logiciel qui a été publiée. Utilisation du référentiel 61

70 Selon le type d'édition sur lequel il travaille, chaque ingénieur va choisir une branche différente pour se connecter au référentiel, et il aura accès à différentes versions des documents : Branche MAJEURE MINEURE (basée sur MAJEURE) EBF (basée du MINEU- RE) Documents versions Spécifications.doc V5 Modèle.MPD V5 Implémentation.OOM V4 Spécifications.doc V3.1.2 Modèle.MPD V2.1.4 Implémentation.OOM V2.1.4 Spécifications.doc V3.1.2 Modèle.MPD V2.1.4 Implémentation.OOM V PowerAMC

71 Chapitre 2 : Gestion des documents dans le référentiel Création d'une branche Lorsque vous vous connectez au référentiel pour la première fois, la branche <Défaut> est créée automatiquement. Cette branche est le tronc de l'arborescence de versions. Toutes les branches que vous créez par la suite auront cette branche <Défaut> comme branche de base ou comme ancêtre plus ou moins direct. Si vous disposez du droit Gestion des branches, vous pouvez créer des branches. Ce sont le plus souvent les chefs de projet qui disposent de ce droit. 1. Sélectionnez Référentiel > Branches pour afficher la boîte de dialogue Liste des branches. 2. Cliquez sur l'outil Ajouter une ligne pour créer une nouvelle branche, puis cliquez sur l'outil Propriétés pour afficher la feuille de propriétés de cette branche. Utilisation du référentiel 63

72 3. Saisissez les noms, code et commentaire appropriés pour décrire la branche. 4. Sélectionnez une branche de base dans la liste. Si vous sélectionnez <Aucune>, la nouvelle branche n'aura pas de branche de base, et sera créée vide. 5. Cliquez sur OK pour revenir à la boîte de dialogue Liste des branches. Changement de branche Une fois que vous vous connectez au référentiel, vous êtes connecté à une branche particulière. Si vous n'avez pas encore créé de branche, vous êtes connecté à la branche <Défaut>. Votre branche courante s'affiche sur le noeud racine dans l'onglet Référentiel de l'explorateur d'objets comme suit référentiel::nomutilisateur::branche Vous pouvez changer de branche pour accéder à d'autres versions de document. 1. Sélectionnez Référentiel > Changer de branche pour afficher la boîte de dialogue Sélection d'une branche. 64 PowerAMC

73 Chapitre 2 : Gestion des documents dans le référentiel 2. Sélectionnez une branche dans la liste, puis cliquez sur OK pour revenir à l'onglet Référentiel de l'explorateur d'objets, qui affiche maintenant la nouvelle branche. Consolidation d'un document dans une branche Lorsque vous consolidez un document, ce dernier est systématiquement consolidé dans la branche à laquelle vous êtes connecté. Si vous souhaitez consolider votre document dans une autre branche, vous devez changer de branche avant de commencer à consolider. Pour plus d'informations sur le changement de branche, voir Changement de branche à la page 64. Une fois la consolidation terminée, vous pouvez vous assurer que votre version de document a été ajoutée à la branche appropriée en ouvrant la feuille de propriétés de la branche, puis en cliquant sur l'onglet Membres de cette feuille de propriétés (voir Gestion des membres d'une branche à la page 65). Pour plus d'informations sur la consolidation de documents dans des branches, y compris en ce qui concerne les différents modes disponibles, voir Modes de consolidation à la page 27. Gestion des membres d'une branche Lorsque vous créez une nouvelle branche, celle-ci ne possède pas encore de membres de version, mais elle a accès à toutes les versions de document de sa branche de base ainsi que celles de toutes ses branches ancêtres. Vous pouvez ajouter des versions à une branche en les consolidant. Chaque version de document est affichée en tant que membre de la branche sur l'onglet Membres de la feuille de propriétés de cette branche. Si vous consolidez le même document plusieurs fois dans une même branche, chaque version devient membre de la branche. Utilisation du référentiel 65

74 Les outils suivantes sont disponibles sur l'onglet Membres : Outil Description Propriétés - Affiche la feuille de propriétés du document de référentiel sélectionné. Extraire - Extrait la version de document sélectionnée. Voir Extraction de documents du référentiel à la page 31. Geler - Gèle la version de document sélectionnée. Voir Versions de documents à la page 55. Dégeler - Dégèle la version de document sélectionnée. Voir Versions de documents à la page 56. Verrouiller - Verrouille la version sélectionnée. Voir Verrous de document à la page 58. Déverrouiller - Déverrouille la version de document sélectionnée verrouillée. Voir Verrous de document à la page 60. Supprimer - Supprime la version de document sélectionnée. Suppression d'une branche Si vous disposez du droit Gestion des branches, vous pouvez supprimer des branches. Vous ne pouvez toutefois pas supprimer la branche courante, ni une branche qui contient des membres. Avertissement! Vous ne pouvez pas annuler la suppression d'une branche. 66 PowerAMC

75 Chapitre 2 : Gestion des documents dans le référentiel 1. Sélectionnez Référentiel > Branches pour afficher la boîte de dialogue Liste des branches. 2. Sélectionnez une branche dans la liste, puis cliquez sur l'outil Supprimer. 3. Cliquez sur OK pour confirmer la suppression. Configurations de référentiel Une configuration est un ensemble de versions de document qui sont regroupées afin d'être récupérées plus facilement. Les configurations peuvent s'avérer très utiles pour regrouper des versions de modèle qui sont liés par des dépendances (par exemple, pas le biais de liens de génération ou de dépendances) ou des documents qui représentent un point particulier dans votre développement, comme une édition majeure d'un logiciel. Vous pouvez extraire très simplement tous les documents inclus dans la configuration. Dans l'exemple suivant, les versions utilisées pour une édition mineure sont encerclées, et appartiennent à la même configuration appelée Edition Mineure : Utilisation du référentiel 67

76 Création d'une configuration Si vous disposez du droit Gestion des configurations, vous pouvez créer des configurations. 1. Sélectionnez Référentiel > Configurations pour afficher la boîte de dialogue Liste des configurations (ou bien pointez sur le noeud d'un dossier ou d'un projet, cliquez le bouton droit de la souris et sélectionnez Créer une configuration). 2. [liste des configurations uniquement] Cliquez sur l'outil Ajouter une ligne, puis cliquez sur l'outil Propriétés pour afficher la feuille de propriétés de la nouvelle configuration. 3. Saisissez un nom, un code et un commentaire appropriés afin de décrire la configuration. 4. Cliquez sur l'onglet Membres pour ajouter des versions de document à la configuration (voir Gestion des membres d'une configuration à la page 69). 5. Cliquez sur OK dans chacune des boîtes de dialogue. 68 PowerAMC

77 Chapitre 2 : Gestion des documents dans le référentiel Gestion des membres d'une configuration Vous ajoutez et gérez les versions de document appartenant à une configuration en utilisant l'onglet Membres de sa feuille de propriétés. Vous pouvez ajouter des versions dans une configuration en utilisant les méthodes suivantes : Ajoutez une version de document individuelle Ajoutez les versions de document d'une autre configuration Ajoutez les versions de document liées à un membre existant de la à la configuration Les outils suivants sont disponibles dans l'onglet Membres : Outil Description Propriétés - Affiche la feuille de propriétés du document de référentiel. Ajouter une version de document Affiche la boîte de dialogue Ajout d'un document dans une configuration, qui permet de spécifier la version d'un document à ajouter à la configuration. Ajouter les version de document liées [modèles uniquement] Ajoute les éventuels modèles PowerAMC que le modèle sélectionné référence via des raccourcis externes. Les modèles liés sont automatiquement ajoutés à la configuration. Ajouter les versions de documents d'une configuration Affiche la boîte de dialogue Sélection d'une configuration, qui permet de sélectionner une configuration, dont les membres seront ajoutés à la configuration courante. Utilisation du référentiel 69

78 Outil Description Extraire - Extrait la version de document de référentiel sélectionnée. Voir Extraction de documents du référentiel à la page 31 Geler - Gèle Extrait la version de document de référentiel sélectionnée. Voir Gel de versions de document à la page 55 Dégeler - Dégèle Extrait la version de document de référentiel sélectionnée. Voir Dégel d'une version de document à la page 56. Verrouiller - Verrouille Extrait la version de document de référentiel sélectionnée. Voir Verrouillage de documents à la page 58 Déverrouiller - Déverrouille Extrait la version de document de référentiel sélectionnée. Voir Extraction de documents du référentiel à la page 60. Supprimer - Supprime la version de document sélectionnée de la configuration. Extraction d'une configuration Vous pouvez extraire simultanément toutes les versions de document contenues dans une configuration. 1. Sélectionnez Référentiel > Extraire pour afficher la boîte de dialogue Extraction de plusieurs documents (voir Utilisation de la fenêtre Extraction de plusieurs documents à la page 37). 2. Cliquez sur l'outil Ajouter les versions de documents d'une configuration, sélectionnez la configuration à extraire, puis cliquez sur OK. Les versions de documents déclarées dans la configuration sélectionnée sont ajoutées à la liste de documents à extraire. 3. Cliquez sur OK pour lancer l'extraction. Remarque : Lorsque vous extrayez une configuration contenant des fichiers de ressources, ces fichiers peuvent écraser les modifications dans vos fichiers de ressources locaux. Si vous souhaitez préserver vos modifications, modifiez le chemin vers lequel la configuration sera extraite. Extraction d'une configuration de projet Lorsque vous extrayez un projet, vous pouvez choisir d'extraire les version de tous les documents du projet contenues dans une configuration de projet en une seule fois. Vous devez créer la configuration à partir du menu contextuel du projet (voir Création d'une configuration à la page 68). 1. Affichez la fenêtre Extraction d'un projet. 2. Sélectionnez les paramètres appropriés (voir Paramètres d'extraction à la page 35) y compris la configuration à extraire, puis cliquez sur OK pour extraire les version de 70 PowerAMC

79 Chapitre 2 : Gestion des documents dans le référentiel document de la configuration, et les ajouter dans votre espace de travail. Si vous avez sélectionné l'option Fusionner le document, la fenêtre Extraire le modèle s'affiche pour vous permettre de passer en revue toutes les différences entre les version locales et les versions du référentiel et de choisir de les appliquer ou de les rejeter. Partage de ressources dans le référentiel Vous pouvez stocker des fichiers de ressources PowerAMC (SGBD, langages cibles et définitions étendues de modèle) dans le référentiel et automatiser leur déploiement dans votre équipe. Le partage des fichiers de ressources permet de vous assurer que tous les membres de votre équipe travaillent avec le même SGBD ou la même autre cible avec les extensions appropriées. Les fichiers de ressources ne sont pas partagés par défaut, mais une fois que vous avez choisi les fichiers de ressources que vous souhaitez partager, que vous les avez consolidés dans le référentiel et mis en place des politiques pour le partage, votre équipe recevra automatiquement les mises à jour dans leurs ressources chaque fois qu'il ouvriront un modèle. Vous avez également la possibilité d'utiliser des templates afin d'imposer l'utilisation de ressources partagées lorsque les membres de l'équipe créent des modèles. Les mises à jour automatique des ressources partagées peuvent être désactivées pour un membre particulier de l'équipe, notamment dans le cas où il travaille à l'élaboration d'extensions pour un SGBD, un langage cible ou une définition étendue de modèle. Préparation au partage des ressources dans le référentiel Aucun fichier de ressources n'est partagé par défaut. Le gestionnaire des ressources doit décider des ressources à partager (le plus souvent les SGBD, langages et définitions étendues de modèle avec lesquels l'équipe travaille ou ceux qui ont été modifiés pour votre développement), et configure sa machine comme template pour l'environnement qui sera déployé sur toutes les machines client. Création de chemins nommés pour localiser les ressources partagées Les modèles qui se réfèrent à des ressources partagées doivent savoir où les trouver. Le gestionnaire des ressources doit créer des chemins nommés afin de pointer vers un dossier standard situé hors de votre installation PowerAMC (et de préférence, il doit s'agir d'un dossier disponible et accessible en écriture sur toutes les machines client) dans lequel toutes les ressources partagées seront déployées. Les chemins nommés que vous créez seront déployés chez les utilisateurs par le biais d'un profil utilisateur et permettront à tous les utilisateurs de pointer vers la ressource appropriée. 1. Sélectionnez Outils > Options générales, puis sélectionnez la catégorie Chemins nommés afin d'afficher la liste des chemins nommés. Utilisation du référentiel 71

80 2. Saisissez un nom (par exemple, _SGBD_PARTAGES) et un chemin par défaut (par exemple C:\Acme SA\Ressources\SGBD) pour chaque dossier de ressources partagées que vous avez créé. Vous devez créer un chemin nommé pour chaque type de ressource que vous avec l'intention de partager. Les ressources pouvant être incluses sont les suivantes : SGBD et langages objet, de processus métiers et XML Définitions étendues de modèle Jeux de catégories de modèle - pour imposer l'utilisation de ressources partagées au moment de la création d'un modèle (voir Rendre les ressources partagées disponibles dans la boîte de dialogue Nouveau modèle à la page 74) Templates de modèle - pour être référencé par vos jeux de catégories de modèle Profils utilisateur - pour configurer chacun de ces éléments 3. Cliquez sur OK pour fermer la boîte de dialogue. Dans l'exemple suivant, le gestionnaire des ressources de Acme a créé des chemins nommés pour les SGBD, les langages objets et les définitions étendues de modèle : 72 PowerAMC

81 Chapitre 2 : Gestion des documents dans le référentiel Pour plus d'informations sur les chemins nommés, voir "Définition de chemins nommés" dans le chapitre Personnalisation de votre environnement de modélisation du Guide des fonctionnalités générales. Sélection et préparation des ressources à partager Le gestionnaire de ressource sélectionne les fichiers de ressources à partager et les place dans les dossiers pour lesquels il a créé des chemins nommés en préparation de leur consolidation dans le référentiel. Le gestionnaire de ressources et responsable de la collecte et de l'organisation des ressources à partager. Il peut les obtenir d'autres utilisateurs ou les copier depuis sa propre installation (voir "Utilisation des fichiers de ressources PowerAMC" dans le chapitre Fichiers de ressources et métamodèle public PowerAMC du manuel Personnalisation et extension de PowerAMC). 1. Copiez tous les fichiers de ressources à partager dans les dossiers pour lesquels vous avez créé des chemin nommés. 2. Pour chaque type de ressource que vous souhaitez partager, sélectionnez Outils > Ressources > Liste des type de ressource afin d'afficher la liste de ressources appropriée. 3. Cliquez sur l'outil Chemin, puis sélectionnez le dossier dans lequel vous avez placé les fichiers de ressources de ce type afin de les ajouter à la liste. Consolidation des ressources à partager dans le référentiel Le gestionnaires des ressources doit consolider dans le référentiel les fichiers de ressources sélectionnés afin de les rendre disponibles pour l'équipe en tant que ressources partagées. 1. Connectez-vous au référentiel puis créez un dossier dans lequel stocker vos ressources partagées (voir Création d'un dossier à la page 42). Vous devez vous assurer que tous vos utilisateurs disposent d'au moins une permission Lecture sur ce dossier et sur tous les documents qu'il contient. 2. Affichez la liste de ressources appropriées en sélectionnant (Outils > Ressources > Type de ressource), sélectionnez la ressource que vous souhaitez partager, puis cliquez sur l'outil Consolider afin d'afficher la fenêtre Consolidation d'un document. 3. Dans la liste Dossier, sélectionnez le dossier de vos ressources partagées, puis cliquez sur OK pour consolider la ressource et revenir à la liste. Une fois que tous les fichiers de ressources de ce type que vous souhaitez partager sont consolidés, fermez la liste et continuez avec une autre liste de fichiers de ressources. Dans l'exemple suivant, le gestionnaire de ressources Acme a consolidé ses SGBD partagés, ses langages objets et ses définitions étendues de modèle dans le dossier Ressources Acme : Utilisation du référentiel 73

82 Rendre les ressources partagées disponibles dans la boîte de dialogue Nouveau modèle Une fois que vous avez défini vos chemins nommés, regroupé vos ressource dans les dossiers externes et fait en sorte que vos listes de ressources pointent vers ces ressources, vous pouvez créer des catégories de création de modèle afin d'imposer l'utilisation des ressources partagée pour la création des modèles. Les jeux de catégories de modèle contiennent des catégories qui à leur tour contiennent des templates pour la création de modèles et pointent vers des ressources cible prédéfinies. Une fois que vous avez défini un jeu de catégories, vous pouvez faire en sorte de le faire apparaître dans la boîte de dialogue Nouveau modèle en le sélectionnant dans la boîte de dialogue Options générales. Les jeux de catégories de modèles étant eux-même des fichiers de ressources PowerAMC, et vous devrez les déployer vers vos utilisateurs, vous allez devoir les stocker, avec vos autres ressources à partager, et spécifier un chemin nommé pour pointer vers eux. 1. Si ce n'est pas déjà fait, créez un chemin nommé pour pointer vers le dossier dans lequel vous allez stocker les jeux de catégories de modèle afin de les consolider dans le référentiel. 2. Sélectionnez Outils > Ressources > Jeux de catégorie de modèle afin d'afficher la boîte de dialogue Liste des jeux de catégories de modèle, cliquez sur l'outil Chemin, et sélectionnez ce dossier. 3. Cliquez sur l'outil Nouveau afin de créer un nouveau jeu de catégories, spécifiez un nom et cliquez sur OK. Créez les catégories dont vous avez besoin, et autant de templates de diagramme que nécessaire afin de pointer vers chacune des ressources partagées. Remarque : Pour obtenir des informations détaillées sur les jeux de catégories de modèle, voir "Guidage de la création de modèles à l'aide de catégories et de templates" dans le 74 PowerAMC

83 Chapitre 2 : Gestion des documents dans le référentiel chapitre Personnalisation de votre environnement de modélisation du Guide des fonctionnalités générales. 4. Une fois que vous avez créé votre jeu de catégories, sélectionnez Outils > Options générales, puis cliquez sur la catégorie Création d'un modèle dans le volet de gauche. 5. Assurez-vous que la case Activer les catégories est bien cochée, puis sélectionnez votre jeu de catégories dans la zone Jeu de catégories par défaut. Remarque : Votre jeu de catégories n'apparaîtra dans cette liste que s'il a été correctement défini et si le chemin de la liste est défini de façon à pointer vers votre répertoire de ressources partagées. 6. [facultatif] Décochez les cases Activer les types de modèle et Activer les fichiers de template de modèle afin de cacher ces options dans la boîte de dialogue Nouveau modèle. 7. Cliquez sur OK pour enregistrer vos changements, puis sélectionnez Fichier > Nouveau modèle afin d'afficher la boîte de dialogue Nouveau modèle et y voir votre jeu de catégories. 8. Une fois que vous êtes satisfait de votre jeu de catégories, consolidez-le dans le dossier de ressources partagées dans votre référentiel (voir Consolidation des ressources à partager dans le référentiel à la page 73). Création d'un profil utilisateur afin d'activer le partage des ressources Le gestionnaire des ressources crée un profil utilisateur afin de déployer les paramètres requis pour partager les ressources au sein de son équipe. Les nouveaux utilisateurs pourront sélectionner ce profil utilisateur lorsqu'ils installeront PowerAMC. Les utilisateurs existants devront extraire ce profil utilisateur du référentiel, puis l'appliquer. Les profils utilisateur étant eux-même des fichiers de ressources PowerAMC, et vous devrez les déployer vers vos utilisateurs, vous allez devoir les stocker, avec vos autres ressources à partager, et spécifier un chemin nommé pour pointer vers eux. Avant de créer un profil utilisateur, vous devez vous assurer que tous les paramètres appropriés sont correctement définis sur votre machine, et que vous avez créé une hiérarchie de répertoires telle que la suivante (et des chemins nommés équivalents), qui contient toutes les ressources que vous souhaitez partager : C:\Ressources partagées \Définitions étendues de modèle \Jeux de catégories de modèle \Langages objet \Profils utilisateur \SGBD 1. Sélectionnez Outils > Ressources > Profils utilisateur pour afficher la boîte de dialogue Liste des profils utilisateur. Utilisation du référentiel 75

84 2. Cliquez sur l'outil Nouveau pour afficher la boîte de dialogue Nouveau profil utilisateur, saisissez un nom pour votre profil, puis sélectionnez <Registre> dans la liste Copier depuis afin de copier vos valeurs par défaut PowerAMC depuis le Registre Windows. 3. Spécifiez un nom et un emplacement pour créer le profil, puis cliquez sur Enregistrer. Le profil utilisateur est créé et ouvert pour consultation dans l'editeur de ressources. 4. Supprimez tous les éléments, à l'exception des éléments suivants : L'option générale RepAutoUpdate (dans ModelOptions/tool) - qui automatise la mise à jour des ressources à partir du référentiel Les options ModelCreation (dans ModelOptions/tool) - qui contrôlent l'utilisation des catégories et des templates dans la boîte de dialogue Nouveau modèle. Les chemins nommés (dans Paths/Named) - pour chaque dossier de ressources partagées que vous avez créé. La définition de référentiel (dans Repository/Nom référentiel) - le référentiel dans lequel les ressources partagées sont stockées. Dans l'exemple suivant, le profil utilisateur Ressources partagées ACME contient des valeurs pour les options Auto-Update et ModelCreation, des chemins nommés de ressources et des informations de connexion au référentiel via le proxy de référentiel : 5. Cliquez sur OK pour fermer l'éditeur. 76 PowerAMC

85 Chapitre 2 : Gestion des documents dans le référentiel 6. Consolidez le profil utilisateur dans le dossier de ressources partagées de votre référentiel (voir Consolidation des ressources à partager dans le référentiel à la page 73). Pour plus d'informations sur les profils utilisateur, voir "Profils utilisateur" dans le chapitre Personnalisation de votre environnement de modélisation du Guide des fonctionnalités générales. Communication des politiques de partage des ressources à vos utilisateurs Une fois que le gestionnaire des ressources à configuré l'environnement nécessaire au partage des ressources, il doit communiquer les politiques de partage des ressources à son équipe. Pour permettre à votre équipe de commencer à utiliser des ressources partagées, vous devez les fournir en les accompagnant des informations suivantes : Nom et mot de passe de connexion au référentiel - afin de leur permettre de se connecter au référentiel dans lequel vous avez stocké les ressources partagées, le profil utilisateur et les templates et catégories de modèle à utiliser pour la création de modèle. Profil utilisateur - afin de personnaliser la configuration de leur environnement PowerAMC pour le partages de ressources. Les utilisateurs existants vont extraire le profil utilisateur dans le dossier Profils utilisateur, puis l'appliquer. Les nouveaux utilisateurs de PowerAMC vont sélectionner le profil utilisateur approprié lors de l'installation de PowerAMC. Vous pouvez également déployer le profil utilisateur dans de nouvelles installations lors d'une installation silencieuse (voir Installation de PowerAMC en mode silencieux dans la manuel Guide d'installation). Templates et catégories de modèle - pour extraire les ressources partagées et imposer leur utilisateur lors de la création de nouveaux modèles. Utilisation de ressources partagées Pour la plupart des utilisateurs, une fois que leur environnement PowerAMC est correctement configuré, l'utilisation de fichiers de ressources partagés est complètement automatique et invisible. Toutefois, le gestionnaire de ressources et certains utilisateurs avancés qui éditent les fichiers de ressources peuvent pouvoir souhaiter désactiver la mise à jour automatique des ressources. Pour désactiver la mise à jour automatique des fichiers de ressources, sélectionnez Outils > Options générales, cliquez sur la catégorie Référentiel, puis désélectionnez l'option Mettre à jour les ressources automatiquement. Edition de ressources partagées Les utilisateurs avancés dotés des droits appropriés peuvent consolider des changements sur les ressources partagées en utilisant la fenêtre Consolidation d'un document standard. Ces changements seront mis à la disposition des membres de l'équipe lorsqu'ils ouvriront un modèle attaché à la ressource partagée. 1. Sélectionnez Outils > Ressources > Type de ressource pour afficher la liste de ressources appropriée. Utilisation du référentiel 77

86 2. Sélectionnez une ressource, puis cliquez sur l'outil Consolider pour afficher la fenêtre Consolidation d'un document. Le mode Mise à jour est sélectionné par défaut (voir Utilisation de la fenêtre Consolidation d'un document à la page 18). 3. Sélectionnez les paramètres appropriés (voir Paramètres de consolidation à la page 20), puis cliquez sur OK pour consolider vos changements avec la version de la ressource contenue dans le référentiel. Pour consolider plusieurs fichiers de ressources simultanément, utilisez la fenêtre Consolidation de plusieurs documents (voir Utilisation de la fenêtre Consolidation de plusieurs documents à la page 23). Comparaison de fichiers de ressources partagés Tout utilisateur disposant d'au moins un droit Lecture sur un ou plusieurs fichiers de ressources peut procéder à une comparaison sur ces fichiers afin d'obtenir une liste détaillée de leurs différences. Dans la boîte de dialogue Liste des type de ressource, sélectionnez une ressource, puis cliquez sur l'outil Comparer avec la version du référentiel afin de comparer : Deux différentes ressources dans le référentiel Deux version différentes de la même ressource dans le référentiel Une ressources située sur votre machine locale et une autre ressource contenue dans le référentiel Remarque : Vous devez sélectionner des ressources du même type : SGBD, langage objet, XEM, etc. Vous ne pouvez pas faire porter la comparaison sur des ressources de type différent. Pour plus d'informations sur la comparaison dans le référentiel, voir Comparaison de modèles dans le référentiel à la page PowerAMC

87 Chapitre 3 Parcourir le référentiel via le Web L'Explorateur Web du référentiel PowerAMC permet d'afficher le contenu de votre référentiel PowerAMC dans un simple navigateur Web. Vous pouvez partager vos modèles avec un large public, y compris des personnes qui ne sont pas des utilisateurs de PowerAMC. Remarque : Un administrateur doit installer et configurer le serveur de l'explorateur Web du référentiel PowerAMC avant que vous ne puissiez accéder au référentiel via le Web. Pour plus de détails sur l'installation, voir "Installation de l'explorateur Web du référentiel PowerAMC" dans le chapitre Installation du référentiel du manuelguide d'installation. Connexion à l'explorateur Web du référentiel PowerAMC Pour pouvoir vous connecter à l'explorateur Web du référentiel PowerAMC, vous devez disposer d'un compte d'utilisateur du référentiel et obtenir l'adresse du site auprès de votre administrateur. Votre administrateur doivent également vous conseiller sur le profil de connexion que vous devez utiliser pour vous connecter à votre référentiel. 1. Dans votre navigateur Web, affichez l'adresse de site Web fournie par votre administrateur (par exemple, : 2. Sélectionnez le profil de connexion recommandé par votre administrateur et saisissez votre nom d'utilisateur et votre mot de passe de référentiel. Utilisation du référentiel 79

88 Vous pouvez cliquer sur le lien Afficher les informations de profil afin d'afficher les détails du profil sélectionné ou sur le lien Options avancées pour saisir manuellement le nom d'hôte et le numéro de port au lieu d'utiliser un profil. 3. Cliquez sur Connexion pour afficher la page d'accueil de l'explorateur Web du référentiel PowerAMC. Chaque page de l'explorateur Web du référentiel PowerAMC inclut les liens suivants dans l'angle supérieur droit de l'écran : Aide pour accéder au document d'aide. Langue pour changer la langue de l'interface. Préférences pour passer en revue vos paramètres de connexion et changer votre mot de passe Réactualiser pour réactualiser l'affichage. Fermeture de session - pour fermer la session courante. Explorateur de l'explorateur Web du référentiel PowerAMC La page Explorateur du référentiel est la page principale de l'explorateur Web du référentiel PowerAMC, et contient une arborescence qui affiche le contenu du référentiel et, du côté droit, les propriétés de l'élément sélectionné. L'explorateur peut contenir les types de noeuds suivants : Racine - affiche la branche courante. Dossier - utilisé pour subdiviser et organiser les documents dans le référentiel. Projet conteneur pour des modèles et d'autres documents. 80 PowerAMC

89 Chapitre 3 : Parcourir le référentiel via le Web Document projets, modèles, rapports multimodèle, et fichiers d'application externe, tels que des fichiers MS Office, ou bien des fichiers graphiques. Package packages de modèle. Catégorie d'objet catégories d'objet de modèle. Diagramme - diagrammes de modèle. Vous pouvez cliquer sur les symboles d'objet dans les diagrammes pour sélectionner l'objet correspondant. Objet objets de modèle. Propriétés de document et d'objet de référentiel Vous pouvez cliquer sur n'importe quel document ou objet de modèle dans le référentiel afin d'afficher sa feuille de propriétés. Les onglets suivants sont disponibles : Général - affiche des informations de base, en lecture seule, à propos de l'objet. Attributs - [modèles, packages et objets de modèle uniquement] affiche les propriétés de l'objet. Relations - [objets uniquement] affiche les listes des autres objets auxquels l'objet courant est relié. Versions - affiche les différentes versions du document stocké dans le référentiel, avec des informations sur la version courante du document, sa date de création et sa date de dernière modification. Permissions - [modèles, packages et autres documents uniquement] répertorie les utilisateurs et les groupes dotés de permissions sur le document. Pour plus d'informations, voir Ajout d'une permission à un utilisateur ou à groupe sur un élément de référentiel à la page 81. Comparaison - [modèles et objets uniquement] permet de comparer différentes versions de modèles et d'objets. Pour plus d'informations, voir Comparaison de versions de modèle et d'objet à la page 83. Abonnements - [projets, dossiers et modèles uniquement] permet de s'abonner aux notifications par courriel des modifications apportées à l'objet. Pour plus d'informations, voir Abonnement aux notifications de modification à la page 82. Ajout d'une permission à un utilisateur ou à groupe sur un élément de référentiel Vous pouvez modifier les permissions d'accès sur un élément à partir de l'explorateur Web du référentiel PowerAMC. 1. Cliquez sur l'objet dans l'explorateur du référentiel pour afficher sa feuille de propriétés, puis cliquez sur l'onglet Permissions. 2. Cliquez sur l'outil Ajouter pour afficher une boîte de dialogue de sélection qui répertorie tous les utilisateurs et groupes disponibles. Utilisation du référentiel 81

90 3. Sélectionnez un ou plusieurs utilisateurs ou groupes, sélectionnez les permissions appropriées dans la liste déroulante de la colonne Permission accordées. Les permissions suivantes sont disponibles : Liste - L'utilisateur ou le groupe a des permissions minimales permettant d'afficher l'élément dans l'explorateur, d'afficher des feuilles de propriétés en lecture seule et de rechercher des modèles. Lecture - L'utilisateur ou le groupe a toutes les permissions Liste, et peut également comparer des documents, il peut également extraire le document (ou le contenu d'un dossier) du référentiel. Ecriture - L'utilisateur ou le groupe a toutes les permissions Lecture, et peut également consolider, geler et verrouiller les versions de document. Totale - L'utilisateur ou le groupe a toutes les permissions Ecriture, et peut également gérer les permissions accordées aux utilisateurs ou groupes et supprimer des verrous posés sur des documents. Notez que les utilisateurs qui ne disposent pas des permissions sur un document ou sur un dossier ne peuvent même pas voir ces éléments dans l'explorateur. 4. [facultatif pour les projets, dossiers et modèles] Cochez la case Répercuter en cascade les changements de permission sur le contenu des dossiers afin de propager ces changements aux enfants du noeud. 5. Cliquez sur le bouton Enregistrer pour enregistrer vos modifications et revenir à l'onglet Permissions. La colonne Permission accordées montre les permissions accordées de façon explicite aux groupes et utilisateurs, et la colonne Permissions effectives affiche leurs permissions réelles, la permission la plus étendue accordée soit de façon explicite, soit par le biais de l'appartenance à un groupe. Abonnement aux notifications de modification Vous pouvez vous abonner afin d'être averti des changements apportés à n'importe quel projet, document, modèle, document d'application externe ou dossier pour lequel vous disposez au moins de la permission Lecture. 1. Sélectionnez le projet, modèle ou dossier pour lequel vous souhaitez vous abonner dans l'explorateur du référentiel, puis cliquez sur l'onglet Abonnements. 2. Cochez la case Courriel en regard de votre nom dans la colonne Mode de notification, puis cliquez sur Enregistrer. Remarque : Si vous disposez du droit Gestion des utilisateurs, cliquez sur le bouton Nouveau sur l'onglet Abonnements afin d'afficher une liste d'utilisateurs et de groupes, sélectionnez ceux que vous souhaitez abonner aux notifications, puis cliquez sur Enregistrer. 82 PowerAMC

91 Chapitre 3 : Parcourir le référentiel via le Web Comparaison de versions de modèle et d'objet Vous pouvez comparer deux version d'un modèle ou d'un objet PowerAMC dans l'explorateur Web du référentiel PowerAMC pour obtenir une liste détaillées des différences entre ces versions. 1. Cliquez sur l'objet dans l'explorateur du référentiel pour afficher sa feuille de propriétés, puis cliquez sur l'onglet Comparer. 2. Sélectionnez les branches et numéros de version des deux versions du modèle ou de l'objet que vous souhaitez comparer. 3. [facultatif] Cliquez sur le bouton Développer tout pour développer tous les noeuds. 4. [facultatif] Cliquez sur les éventuels noeuds enfant pour afficher les modifications de leurs propriétés. Recherche à l'aide de l'explorateur Web du référentiel PowerAMC Vous pouvez rechercher des objets de modèle PowerAMC dans l'explorateur Web du référentiel PowerAMC en cliquant sur l'onglet Recherche. Vous devez disposer au moins de la permission Lecture pour trouver des objets. Notez que vous ne pouvez pas faire porter la recherche sur des documents d'applications externes. 1. Cliquez sur l'onglet Recherche pour affiche l'écran de recherche : Utilisation du référentiel 83

92 2. Sélectionnez une recherche enregistrée dans la liste, puis cliquez sur le bouton Exécuter, ou bien cliquez sur le bouton Nouvelle recherche pour créer une nouvelle recherche : 3. [facultatif] Sélectionnez une branche, un modèle (en cliquant sur son nom dans l'explorateur) ainsi qu'une version de modèle en haut de l'écran afin de limiter la portée de votre recherche. Par défaut, la rechercher porte sur tout le référentiel. Remarque : Une recherche qui porte sur la totalité du référentiel peut s'avérer très longue. Vous devez limiter la portée de votre recherche chaque fois que possible. Dans cet exemple, je choisis de chercher dans la version 3 du MPD GESTION DE SOCIETE : 4. [facultatif] Sélectionnez un type de modèle pour la recherche. Par défaut, la recherche porte sur tous les types de modèle. 84 PowerAMC

93 Chapitre 3 : Parcourir le référentiel via le Web 5. [facultatif] Sélectionnez un type d'objet à chercher. Par défaut, la recherche porte sur tous les types d'objet. Dans cet exemple, je choisis Table: 6. Sélectionnez une propriété, un opérateur et une valeur pour la recherche. En fonction de la propriété que vous sélectionnez, le choix d'opérateur peut être limité et/ou des valeurs peuvent être suggérées. Notez que la prise en compte de la casse dans vos recherches dépend de vos SGBD. Les caractères spéciaux suivants permettent d'utiliser des expressions régulières de base pour la recherche portant sur le nom ou le code d'un objet ou sur des valeurs d'attributs d'objet : * - représente d'aucun à n'importe nombre de caractères Par exemple : P* renvoie "Poste de travail" et "Paris"? représente exactement un caractère Par exemple :????ER renvoie "Writer" et "Seller" mais pas "inner" \ - échappe *,? ou \ true/false - Valeur booléenne (True représente une case cochée dans l'interface) 7. Cliquez sur le bouton Ajouter pour ajouter la clause de recherche complète à la table Condition. Dans cet exemple, je choisis de chercher les tables qui sont sélectionnées pour la génération : 8. [facultatif] Créez des clauses de recherche supplémentaires et ajoutez-les à la table Condition, en choisissant l'une des conjonctions suivantes : Utilisation du référentiel 85

94 Et le résultat doit satisfaire toutes les clauses. Ou le résultat doit satisfaire une des clauses. Dans cet exemple, j'affine ma recherche en ne recherchant que les tables dont le nombre d'enregistrements estimé est supérieur à 1000 : 9. [facultatif] Cliquez sur l'onglet Autres et spécifiez des clauses de recherches supplémentaires basées sur les nom d'utilisateur et la dates de création et de modification. 10. [facultatif] Cochez la case Inclure les raccourcis pour inclure les raccourcis vers les objets dans les résultats de vos recherches. 11. Cliquez sur le bouton Rechercher pour lancer votre recherche. Vos résultats de recherche s'affichent. Cliquez sur un objet dans la liste pour afficher ses propriétés disponibles. Dans mon exemple, ma recherche a renvoyé quatre tables répondant aux critères spécifiés : 86 PowerAMC

95 Chapitre 3 : Parcourir le référentiel via le Web 12. [facultatif] Après avoir effectué une recherche, vous pouvez : Sélectionner le format pdf ou xls et cliquer sur le bouton Rapport afin de générer une version Excel ou PDF de vos résultats. Sélectionner un attribut, saisir une valeur dans la zone de recherche en haut de l'écran et cliquer sur le bouton Rechercher afin de rechercher dans vos résultats. Cliquer sur le bouton Retour et : Modifier votre chaîne de recherche. Saisir un nom et une description pour enregistrer votre recherche, puis cliquer sur le bouton Enregistrer afin de rendre votre recherche réutilisable dans la page Rechercher. Dans mon exemple, j'ai enregistré ma recherche sous le nom Grosses tables générées: Utilisation du référentiel 87

96 Utilisateurs et groupes de l'explorateur Web du référentiel PowerAMC Les utilisateurs de référentiel dotés de droit Gestion des utilisateurs peuvent afficher, créer, modifier et désactiver des utilisateurs et des groupes, mais aussi manipuler leur appartenance à des groupes via l'explorateur Web du référentiel PowerAMC. Création d'un utilisateur de référentiel Vous pouvez créer des utilisateurs à partir de l'écran Utilisateurs et groupes. 1. Cliquez sur l'onglet Utilisateurs et groupes puis cliquez sur Utilisateurs dans la partie gauche de l'écran pour afficher la liste des utilisateurs. 2. Cliquez sur le bouton Nouveau, choisissez de créer un utilisateur local ou distant, puis saisissez un nom de connexion. Remarque : Les utilisateurs et groupes distants sont ceux dont l'authentification est déléguée à un serveur LDAP. Notez que bien que les utilisateurs et groupes puissent être ajoutés aux groupes locaux, les utilisateurs et groupes locaux ne peuvent pas être ajoutés aux groupes distants. 3. [utilisateurs locaux uniquement] Saisissez un nom complet, un mot de passe, une adresse de courriel et une description pour l'utilisateur. Une adresse de courriel est requise si l'utilisateur doit recevoir des notifications de modification. 4. [facultatif] Cliquez sur l'onglet Groupes parent et ajoutez l'utilisateur dans les groupes appropriés (voir Ajout d'un membre dans un groupe à partir de la feuille de propriétés du membre à la page 90) 5. [facultatif] Cliquez sur l'onglet Droits et affectez à l'utilisateur les droits appropriés (voir Octroi de droits aux utilisateurs et aux groupes à la page 89) 6. Cliquez sur le bouton Enregistrer pour créer l'utilisateur et revenir à la liste des utilisateurs. 88 PowerAMC

97 Chapitre 3 : Parcourir le référentiel via le Web Remarque : Lorsque vous créez un utilisateur, veillez à lui octroyer des droits d'accès aux documents du référentiel, soit en l'insérant dans un groupe, soit directement. Un utilisateur qui se connecte au référentiel sans avoir de permissions ne voit aucun document dans l'explorateur. Création d'un groupe de référentiel Vous pouvez créer des groupes à partir de l'écran Utilisateurs et groupes. 1. Cliquez sur l'onglet Utilisateurs et groupes puis cliquez sur Groupes dans la partie gauche de l'écran pour afficher la liste des groupes. 2. Cliquez sur le bouton Nouveau, choisissez de créer un groupe local ou distant, puis saisissez un groupe et un nom complet. 3. [facultatif] Saisissez une adresse de courriel et/ou une description pour le groupe. 4. [facultatif] Cliquez sur l'onglet Membres et ajoutez les membres appropriés au groupe (voir Ajout d'un membre dans un groupe à partir de la feuille de propriétés du groupe à la page 91) 5. [facultatif] Cliquez sur l'onglet Droits et affectez au groupe les droits appropriés (voir Octroi de droits aux utilisateurs et aux groupes à la page 89) 6. Cliquez sur le bouton Enregistrer pour créer le groupe et revenir à la liste des groupes. Remarque : Vous devez accorder des droits d'accès à un nouveau groupe afin que les membres de ce groupe puissent hériter de ces permissions. Un utilisateur qui se connecte au référentiel sans avoir de permissions ne voit aucun document dans l'explorateur. Octroi de droits aux utilisateurs et aux groupes Chaque utilisateur et groupe de référentiel dispose d'un jeu de droits qui gouvernent ses interactions avec le référentiel. Un nouvel utilisateur ne dispose par défaut que du droit Connecter, et un nouveau groupe ne dispose d'aucun droit. Vous pouvez affecter des droits aux utilisateurs et groupes dans l'onglet Droits de leur feuille de propriétés respective. Les droits des utilisateurs et des groupes peuvent être associés aux permissions sur les documents pour définir les actions qu'un utilisateur ou un groupe peut effectivement effectuer sur un document. Certains droits sont automatiquement associés à certaines permissions pour des raisons de cohérence : Les droits de verrouillage et de gel de versions de documents sont associés à la permission Ecriture. Un utilisateur avec les droits de gel ou de verrouillage des versions doit avoir la permission Ecriture sur le document du référentiel. Un utilisateur ayant la permission Totale sur un document peut déverrouiller ou dégeler une version verrouillée ou gelée par un autre utilisateur. Utilisation du référentiel 89

98 1. Cliquez sur l'onglet Utilisateurs et groupes, sélectionnez Utilisateurs ou Groupes dans la partie gauche de l'écran, puis cliquez sur l'entrée appropriée dans la liste pour afficher la feuille de propriétés correspondante. 2. Cliquez sur l'onglet Droits et cochez les cases correspondant aux droits que vous souhaitez affecter. Les droits suivants sont disponibles : Verrouiller permet de verrouiller des versions de document. Geler permet de geler des versions de document. Gérer le référentiel - permet de mettre à niveau un référentiel et de supprimer la base de données du référentiel. Connecter - permet de se connecter au référentiel. Gérer les utilisateurs - permet de créer, de modifier et de supprimer des utilisateurs et groupes de référentiel, d'accorder des droits aux utilisateurs et groupes, et d'ajouter des utilisateurs ou des groupes dans un groupe. Gérer les configurations permet de créer, de modifier et de supprimer des configurations. Gérer les branches - permet de créer, de modifier et de supprimer des branches. Gérer tous les objets - permet de créer, de consolider, d'extraire, de déverrouiller, de dégeler et de définir des permissions et supprimer des versions de document. 3. Cliquez sur le bouton Enregistrer pour enregistrer vos modifications et revenir à la liste des utilisateurs ou des groupes. Ajout d'un membre dans un groupe à partir de la feuille de propriétés du membre Vous pouvez ajouter un utilisateur ou un groupe dans un groupe à partir de la feuille de propriétés du futur membre de groupe. Lorsque le membre est ajouté dans le groupe, il bénéficie de l'ensemble des droits associés à ce groupe. 1. Cliquez sur l'onglet Utilisateurs et groupes, cliquez sur Utilisateurs ou Groupes dans la partie gauche de l'écran, puis cliquez sur l'entrée appropriée dans la liste pour afficher la feuille de propriétés correspondante. 2. Cliquez sur l'onglet Groupes pour afficher la liste des groupes disponibles ainsi que la liste des groupes auxquels l'utilisateur ou le groupe appartient : 90 PowerAMC

99 Chapitre 3 : Parcourir le référentiel via le Web 3. Sélectionnez un ou plusieurs groupes dans la liste Groupes disponibles, puis cliquez sur la flèche vers la droite afin de les rassembler et les transférer dans la liste Groupes parent. 4. Cliquez sur le bouton Enregistrer pour enregistrer vos modifications et revenir à la liste des utilisateurs ou des groupes. Ajout d'un membre dans un groupe à partir de la feuille de propriétés du groupe Vous pouvez ajouter un utilisateur ou un groupe à un groupe à partir de la feuille de propriétés du groupe qui reçoit ce nouveau membre. Lorsqu'un membre est ajouté au groupe, il bénéficie de tous les droits associés au groupe. 1. Cliquez sur l'onglet Utilisateurs et groupes, cliquez sur Utilisateurs ou Groupes dans la partie gauche de l'écran, puis cliquez sur l'entrée appropriée dans la liste pour afficher la feuille de propriétés correspondante. 2. Cliquez sur l'onglet Membres pour afficher la liste des membres disponibles ainsi que la liste des membres enfant : Utilisation du référentiel 91

100 3. Sélectionnez un ou plusieurs membres dans la liste Membres disponibles, puis cliquez sur la flèche vers la droite pour les ajouter et les transférer dans la liste Membres enfant. 4. Cliquez sur le bouton Enregistrer pour enregistrer vos modifications et revenir à la liste des groupes. Désactivation d'un utilisateur L'administrateur de référentiel, ou un utilisateur disposant du droit Gestion des utilisateurs peut désactiver un utilisateur, en annulant ainsi ses droits et des permissions dans le référentiel. Un utilisateur ne peut pas se désactiver lui-même. 1. Cliquez sur l'onglet Utilisateurs et groupes, et sélectionnez Utilisateurs dans la partie gauche de l'écran pour afficher la liste des utilisateurs. 2. Sélectionnez un utilisateur dans la liste, cliquez sur le bouton Désactiver, puis confirmez la suppression en cliquant sur OK. L'utilisateur reste dans la Liste des utilisateurs, mais ses droits et permissions sont annulés. Cochez la case Afficher le membres désactivés au-dessus de la liste pour voir les utilisateurs qui ne sont plus actifs. Vous ne pouvez pas ajouter de nouvel utilisateur avec le même nom d'utilisateur qu'un membre désactivé. Suppression d'un groupe L'administrateur de référentiel ou un utilisateur disposant du droit Gérer les utilisateurs peut supprimer des groupes du référentiel. La suppression d'un groupe ne provoque pas la suppression de ses membres (utilisateurs ou groupes). La suppression d'un groupe produit les résultats suivants : L'utilisateur qui appartient à ce groupe perd les droits définis pour le groupe Toutes les permissions définies sur les documents du référentiel et qui ont été accordées pour le groupe sont annulées 92 PowerAMC

101 Chapitre 3 : Parcourir le référentiel via le Web Le groupe est retiré des groupes auxquels il appartenait Le groupe n'apparaît plus dans la liste des groupes 1. Cliquez sur l'onglet Utilisateurs et groupes, puis sélectionnez Groupes dans la partie gauche de l'écran pour afficher la liste des groupes. 2. Sélectionnez un groupe dans la liste, cliquez sur le bouton Supprimer, puis confirmez la suppression en cliquant sur OK. Le groupe disparaît de la liste. Branches de l'explorateur Web du référentiel PowerAMC Une branche permet de scinder l'arborescence de version afin de prendre en charge les développements en parallèle sur des documents. Vous pouvez facilement passer d'une branche à l'autre dans l'explorateur Web du référentiel PowerAMC, afficher l'arborescence des branches, mais aussi créer de nouvelles branches. Création d'une branche Si vous disposez du droit Gestion des branches, vous pouvez créer des branches sur l'écran Branches. 1. Cliquez sur l'onglet Branches pour afficher la liste des branches. 2. Cliquez sur le bouton Nouveau, sélectionnez la branche existante sous laquelle vous souhaitez créer une branche dans la liste Branche parent, puis saisissez un nom et un code de branche. 3. Cliquez sur le bouton Enregistrer pour enregistrer vos modifications et revenir à la liste des branches. Utilisation du référentiel 93

102 Changement de branche L'explorateur n'affiche qu'une seule branche à la fois. Vous pouvez facilement changer la branche à afficher en la sélectionnant dans la liste Branches dans la partie supérieure gauche de l'écran de l'explorateur. Suppression d'une branche Si vous disposez du droit Gestion des branches, vous pouvez supprimer des branches. Vous ne pouvez toutefois pas supprimer la branche courante, ni une branche qui contient des membres. Avertissement! Vous ne pouvez pas annuler la suppression d'une branche. 1. Cliquez sur l'onglet Branches pour afficher la liste des branches. 2. Sélectionnez une branche dans la liste, cliquez sur le bouton Supprimer, puis confirmez la suppression en cliquant sur le bouton OK. La branche disparaît de la liste. Paramètres de l'explorateur Web du référentiel PowerAMC L'onglet Paramètres répertorie différents paramètres que vous pouvez afficher ou définir afin de contrôler votre client et l'explorateur Web du référentiel PowerAMC. 94 PowerAMC

103 Chapitre 3 : Parcourir le référentiel via le Web Paramètres client de l'explorateur Web du référentiel PowerAMC L'Explorateur Web du référentiel PowerAMC fournit des paramètres client que vous pouvez modifier sur la page Paramètres. Consignation Les paramètres de consignation suivants sont disponibles: Paramètre Nom du fichier journal Niveau de consignation Découper par Description Spécifie le nom donné au fichier journal. Spécifie le niveau d'importance minimal des messages à consigner dans le fichier journal. Spécifie de quelle façon le fichier journal doit être découpé. Vous pouvez choisir : Date/heure le fichier est découpé après une durée prédéfinie. Spécifiez la durée et le format du nom du fichier journal dans le champ Période de découpage. Taille de fichier le fichier est découpé lorsqu'il atteint une certaine taille. Spécifiez la taille maximum dans le champ ci-dessous. Tronquer le fichier journal après le démarrage du serveur Spécifie qu'un nouveau fichier journal doit être créé à chaque redémarrage du serveur. Pour afficher votre fichier journal directement dans l'explorateur, sélectionnez le niveau de messages que vous souhaitez afficher et, le cas échéant, un mot clé sur lequel effectuer la recherche, puis cliquez sur le bouton Rechercher. Cliquez sur le bouton Visualiser pour afficher le fichier dans une fenêtre distincte. Connexion SSL Les paramètres de connexion SSL suivants sont disponibles : Paramètre Nom de fichier Keystore Description Spécifie le nom du fichier keystore, une base de données utilisée par le fournisseur de sécurité afin de stocker les certificats de clé publiques et privées, utilisé par le socket de connexion de sécurité. Un fichier client.keystore par défaut est fourni pour l'environnement de test. Utilisation du référentiel 95

104 Paramètre Chemin de fichier KeyStore Mot de passe TrustStore Description Spécifie le chemin d'accès du fichier keystore. La valeur par défaut est CMR_HO- ME/keystore. Spécifie le mot de passe TrustStore, utilisé pour accéder au fichier keystore. La valeur par défaut pour le fichier d'environnement de test est "changeit". Nous vous recommandons de changer le mot de passe TrustStore et de régénérer les certificats et fichiers keystore. Paramètres serveur de l'explorateur Web du référentiel PowerAMC L'Explorateur Web du référentiel PowerAMC fournit des paramètres serveur que vous pouvez modifier sur la page Paramètres. Base de données Les paramètres de base de données suivants sont disponibles : Paramètre Description Type de base de données Pilote Hôte Port Nom de base de données Nom d'utilisateur Mot de passe Niveau d'isolation Taille de pool initiale Spécifie le type de SGBD qui héberge le référentiel. Spécifie le pilote utilisé pour se connecter à la base de données de référentiel. [requis] Spécifie le nom de la machine hôte pour la base de données du référentiel. [requis] Spécifie le numéro de port de la machine hôte par le biais de laquelle la base de données de référentiel est disponible. Spécifie le nom de la base de données de référentiel. Spécifie le nom d'utilisateur de base de données que le référentiel utilise pour accéder au SGBD. Spécifie le mot de passe de base de données que le référentiel utilise pour accéder au SGBD. Spécifie le niveau d'isolation utiliser pour isoler les transactions dans un environnement multiutilisateur. Par défaut, le niveau 1 est utilisé pour les bases de données ASA et le niveau 2 pour ASE. Reportez-vous à la documentation de votre SGBD pour plus d'informations sur le comportement de chaque niveau dans votre environnement. Spécifie le nombre initial de connexions dans le pool de connexions. La valeur par défaut est PowerAMC

105 Chapitre 3 : Parcourir le référentiel via le Web Paramètre Inactivité mini Inactivité maxi Attente maxi (msec) Activité maxi Jeu de caractères Description Spécifie la durée minimum d'inactivité de connexion. Spécifie la durée maximum d'inactivité de connexion. Spécifie le temps d'attente maximum de connexion. Spécifie le nombre maximum de connexions simultanées admis pour la base de données. [ASE uniquement] Spécifie le jeu de caractères utilisé par la base de données. Général Les paramètres généraux suivants sont disponibles : Paramètre Nom Commentaire Délai d'expiration de la session Nombre maxi d'utilisateurs Taille du cache d'objet (Mo) Description Spécifie le nom du référentiel. Spécifie un commentaire descriptif relatif au référentiel. Spécifie la durée pendant laquelle une session de l'explorateur peut rester inactive avant qu'une déconnexion automatique soit effectuée. Spécifie le nombre maximum d'utilisateurs qui peuvent se connecter à l'explorateur Web du référentiel PowerAMC simultanément. Spécifie la quantité de mémoire affectée à la mise en cache des objets. La valeur par défaut est de 128 Mo. Si vous augmentez cette valeur, vous améliorez les performances. LDAP Les paramètres LDAP suivants sont disponibles : Paramètre URL du fournisseur Protocole de sécurité Description [requis] Spécifie l'url du fournisseur LDAP au format ldap://hôteserveurldap:port, ou sous la forme d'une adresse IP. [facultatif] Spécifie le protocole à utiliser lorsque vous vous connectez au serveur LDAP. Si vous utilisez SSL (qui est le seul protocole pris en charge pour l'instant), vous devez définir ce paramètre avec la valeur ssl. Nous vous recommandons de commencer par configurer votre accès LDAP sans SSL, puis de mettre en oeuvre le protocole uniquement lorsque vous vous êtes assuré du bon fonctionnement de votre accès. Utilisation du référentiel 97

106 Paramètre Base de recherche par défaut Liaison anonyme Serveur de confiance Type de serveur Description [requis] Spécifie la base de recherche LDAP par défaut à utiliser pour l'authentification, les rôles, l'attribution et l'auto-inscription. [facultatif] Spécifie que le serveur prend en charge l'accès anonyme à l'arborescence LDAP. Si ce paramètre n'est pas sélectionné, vous devez spécifier une identité et un mot de passe de liaison. Notez que Active Directory ne prend pas en charge d'emblée les liaisons anonymes. [requis] Spécifie que le serveur LDAP est un serveur de confiance. Spécifie le type de serveur LDAP. Le fait de sélectionner un type de serveur définit des valeurs par défaut silencieuses pour l'authentification et les filtres de rôle. Chaque configuration LDAP étant différente et ces valeurs par défaut pouvant se révéler pas adaptées à votre installation, nous vous recommandons de sélectionner none. Les types suivants sont disponibles: none - [recommandé]] sunone5 - pour SunOne 5.x OU iplanet 5.x msad2k - pour Microsoft Active Directory, Windows 2000 nsds4 - pour Netscape Directory Server 4.x openldap - pour OpenLDAP Directory Server 2.x Identité de liaison Mot de passe de liaison Filtre [requis sauf si Liaison anonyme est sélectionné] Spécifie le compte LDAP qui dispose des permissions nécessaires pour interroger le service Active Directory. Si l'identité de liaison est le même DN même que celui utilisé pour la base de recherche d'authentification, alors l'identité de liaison peut être tout simplement l'id utilisateur pour la recherche. Dans le cas contraire, vous avez besoin d'un nom et d'un mot de passe de connexion, ainsi que d'un DN (Distinguished Name (DN) pour ce compte. [requis sauf si Liaison anonyme est sélectionné] Spécifie le mot de passe avec lequel effectuer la liaison lorsque vous construisez la connexion LDAP initiale. [requis] Spécifie la requête LDAP qui recherche les informations utilisateur. Pour déterminer le filtre LDAP à utiliser, vous devez connaître les propriétés des utilisateurs définis dans Active Directory. La propriété qui a été utilisée comme nom d'ouverture de session peut être name, samaccountname ou une autre propriété. Dans cet exemple, nous utilisons samaccountname comme nom d'ouverture de session (que PowerAMC intercepte au moyen de la variable {uid} : (&(samaccountname={uid})(objectclass=user)) 98 PowerAMC

107 Chapitre 3 : Parcourir le référentiel via le Web Paramètre Portée Description [requis] Spécifie la portée de la recherche d'authentification. Vous pouvez choisir l'une des valeurs suivantes : onelevel [valeur par défaut] - la recherche est limité au seul niveau spécifié dans la base de recherche subtree - la recherche commence au niveau de la base de recherche, mais se poursuit ensuite dans les sous-noeuds. Méthode [requis] Spécifie la méthode à utiliser pour les requêtes d'authentification. Vous pouvez choisir l'une des valeurs suivantes : simple - authentification de mot de passe en texte clair DIGEST-MD5 - authentification de mot de passe chiffré Format Digest MD5 Base de recherche Filtre Portée [requis] Spécifie le format d'authentification DIGEST-MD5 d'identité de liaison. La valeur par défaut est DN [facultatif] Si la base de recherche par défaut spécifiée dans la zone de groupe Général n'inclut pas l'emplacement de la liste d'utilisateurs dans votre Active Directory, vous devez le spécifier ici Spécifie le filtre de recherche de rôle qui, combiné à la base de recherche et à la portée, renvoie une liste complète de rôles au sein du serveur LDAP. Il existe plusieurs valeurs par défaut en fonction du type de serveur choisi. Si le type de serveur n'est pas choisi ou si cette propriété n'est pas initialisée, aucun rôle ne sera disponible. Spécifie la portée de la recherche du rôle. Vous pouvez choisir l'une des valeurs suivantes : onelevel [valeur par défaut] subtree Renvoi Spécifie le traitement des renvois. Vous pouvez choisir l'une des valeurs suivantes : ignore [valeur par défaut] follow throw Attribut de nom Spécifie l'attribut pour les rôles extraits qui est le nom commun du rôle. Si cette valeur est "dn", elle est interprétée spécialement comme le dn entier du rôle comme le nom de rôle. La valeur par défaut est "cn", le nom commun (common name). Utilisation du référentiel 99

108 Paramètre Base de recherche Description Spécifie la base de recherche du rôle. Consignation Pour plus d'informations sur les paramètres de consignation, voir Configuration client à la page 95. Notification Les paramètres de notification des changements suivants sont disponibles : Paramètre Description Hôte SMTP Port SMTP Adresse courriel de l'émetteur Le serveur requiert une connexion sécurisée Le serveur requiert une authentification Connexion à l'aide de SPA (Secure Password Authentication) Nom d'utilisateur Mot de passe Modèle de courriel Spécifie le nom d'hôte du serveur SMTP utilisé pour envoyer les courriels. Spécifie le numéro de port du serveur SMTP utilisé pour envoyer les courriels. Spécifie l'adresse de courriel à partir de laquelle sont envoyés les messages de notification de modification. Spécifie que le serveur de courriels SMTP requiert une connexion sécurisée. Spécifie que le serveur de SMTP requiert une authentification. Spécifie que SPA doit être utilisé pour l'authentification. Spécifie un nom d'utilisateur pour SPA. Spécifie un mot de passe pour SPA. Spécifie le contenu des courriels de notification. Choisissez un élément dans la liste pour spécifier son contenu dans la zone située au-dessous. 100 PowerAMC

109 Chapitre 3 : Parcourir le référentiel via le Web Paramètres d'état du serveur de l'explorateur Web du référentiel PowerAMC L'Explorateur Web du référentiel PowerAMC fournit un certains nombres de paramètres relatifs à l'état du serveur que vous pouvez modifier sur la page Etat du serveur. Paramètre Description Information sur le serveur Informations relatives à la notification des modifications Affiche le nom de l'hôte, le port, la version ainsi que l'état du serveur, avec le nombre d'utilisateurs connectés. Cliquez sur le bouton Redémarrer pour redémarrer le service Explorateur Web du référentiel PowerAMC. Affiche le nom d'hôte SMTP, le port et l'état du service de notification. Cliquez sur le bouton Suspendre pour suspendre le service de notification. Cliquez sur le bouton Reprendre pour redémarrer le service de notification. Lorsque vous redémarrez ce service, vous avez la possibilité de cocher la case Inclure les notifications suspendues lors de la reprise afin d'envoyer toutes les notifications qui auraient dû être envoyées lors de la période de suspension. Dépannage de l'explorateur Web du référentiel PowerAMC Ces sections contiennent des informations qui vous aident à résoudre les problèmes rencontrés lors de l'utilisation de l'explorateur Web du référentiel PowerAMC. Encodage Unicode avec Sybase SQL Anywhere v10 Si vous utilisez une base de données SQL Anywhere v10 pour stocker vos informations de référentiel au format Unicode, vous pouvez créer la base de données avec l'option -z définie à une valeur appropriée. Par exemple, pour créer une base de données afin de stocker correctement des caractères japonais, vous devez utiliser l'option suivante : -z 932JPN -zn UTF8BIN Pour obtenir la liste des -z pour tous les langages pris en charge, consultez la page suivante : Augmentation de la mémoire de Tomcat Par défaut, 256 Mo de mémoire sont alloués à Tomcat. Si vous devez travailler avec de gros modèles (au moins 20 Mo) ou si vous prévoyez d'avoir un grand nombre d'utilisateurs simultanés, vous pouvez être amené à faire passer cette mémoire 512 Mo ou à 1 Go. Reportezvous à votre documentation Tomcat pour connaître la marche à suivre. Utilisation du référentiel 101

110 102 PowerAMC

111 Chapitre 4 Administration du référentiel L'administrateur de référentiel est responsable de la configuration du référentiel et du contrôle de l'accès aux documents stockés dans ce dernier. Les accès peuvent être contrôlés de l'une des façons suivantes : Droits des utilisateurs et des groupes fournit des niveaux d'accès globaux, qui permettent à l'utilisateur de visualiser le référentiel et d'avoir un niveau de contrôle par défaut sur différentes sortes d'objets dans ce dernier. Vous pouvez également standardiser la fourniture des droits aux utilisateurs en créant des groupes. Voir Contrôle des droits des utilisateurs et des groupes de référentiel à la page 110 Permissions sur les documents et les dossiers fournit accès aux documents individuels, ou au contenu des dossiers. Voir Contrôle des permission des éléments du référentiel à la page 118 Création, mise à jour et suppression de la base de données du référentiel L'administrateur du référentiel est responsable de la création d'une base de données de référentiel, et est donc amené à la mettre à jour, ou à la supprimer. Pour plus d'informations sur la création d'un référentiel, voir le chapitre Installation du référentiel dans le manuel Guide d'installation. Mise à jour du référentiel Lorsque vous mettez à jour PowerAMC, tous les modules installés sur votre machine sont mis à jour, référentiel inclus. Il n'est pas possible de mettre à jour le référentiel via une connexion de référentiel utilisant un proxy, vous devez utiliser une connexion ODBC directe. Avertissement! Faites toujours une copie de sauvegarde de la base de données de votre référentiel avant de faire une mise à jour. La première fois que vous vous connectez au référentiel après une mise à jour, vous êtes invité à mettre à jour la base de données. La base de données est mise à jour en fonction des modules présents sur votre machine. Par exemple, si vous avez le Modèle Conceptuel de Données installé sur votre machine, seule la partie MCD de la base de données sera mise à jour ainsi que les modules internes partagés par les modèles. Si vous n'avez pas le Modèle Orienté Objet installé, la partie MOO de la base ne sera pas mise à jour. Le prochain utilisateur de la base de données qui utilise le MOO mettra à jour la base de données au moment de la connexion. Tous les clients utilisant la même base de données du référentiel doivent être mis à jour simultanément afin de pouvoir se connecter à la même base de données. Utilisation du référentiel 103

112 Si vous avez créé votre base de données de référentiel à l'aide de Microsoft SQL Server ou de Sybase ASE avant PowerAMC version 15.0, nous vous recommandons de cocher la case Reconstruire les index clustered dans la boîte de dialogue Script de mise à jour du référentiel lorsque vous mettez à jour votre référentiel. En regénérant les index cluster, vous améliorez les performances du référentiel, en particulier dans le domaine de l'extraction des documents. Si vous ne sélectionnez pas cette option au moment de la mise à jour, ou si vous utilisez une connexion directe Microsoft SQL Server ou Sybase ASE, vous pouvez sélectionner Référentiel > Administration > Reconstruire les index clustered à tout moment afin de relancer la reconstruction. Echec de mise à jour du référentiel En cas d'échec de mise à jour lié à un problème de réseau, de permission, ou un manque d'espace disque, vous devez restaurer la version de sauvegarde de la base de données du référentiel et essayer à nouveau une mise à jour une fois les problèmes résolus. Si la mise à jour échoue en raison des données de la base, il est conseillé de faire appel au support technique. Suppression des tables du référentiel La commande de Suppression des tables du référentiel provoque la suppression de toutes les tables du référentiel et de leur contenu dans la base de données et met fin à la connexion avec la base de données. Avertissement! La suppression des tables du référentiel ne peut être annulée. Si vous n'avez pas effectué de sauvegarde de vos modèles et des autres types de contenu, ils seront perdus. Il n'est pas possible de supprimer des tables de référentiel via une connexion de référentiel utilisant un proxy. Vous devez utiliser une connexion ODBC directe. 1. Sélectionnez Référentiel > Administration > Supprimer les tables du référentiel. Vous êtes alors invité à confirmer que vous souhaitez continuer. Cliquez sur Oui pour afficher la fenêtre Script de suppression des tables du référentiel. Cette fenêtre s'affiche à des fins de consultation uniquement. Vous pouvez passer en revue le script, mais pas l'éditer. Si vous souhaitez modifier le script, vous devez le copier dans un interpréteur de script, après avoir sélectionné le séparateur approprié pour votre interpréteur dans la liste. 2. Cliquez sur Exécuter pour lancer l'exécution. 104 PowerAMC

113 Chapitre 4 : Administration du référentiel Dépannage du référentiel installé sur ASE Cette section répertorie des problèmes connus qui peuvent être rencontrés lorsque vous installez le référentiel sur le SGBD Sybase Adaptive Server Enterprise. Paramètres ASE fréquemment requis Les paramètres ASE suivants doivent être fréquemment configurés à des valeurs supérieures à leur valeur par défaut afin d'optimiser la consolidation des modèles : number of open objects number of open indexes number of locks max memory procedure cache size Must declare variable '@dr_t_a0'. SQLSTATE = ZZZZZ Si vous voyez l'erreur ci-dessus et êtes connecté à un serveur ASE via ODBC, affichez l'administrateur de source de données ODBC, sélectionnez votre source de données, puis sélectionnez l'option Enable Dynamic Prepare sur l'onglet Connection. Truncated data on extraction Si vos données sont tronquées à l'extraction depuis le référentiel et que vous êtes connecté à un serveur ASE via ODBC, affichez l'administrateur de source de données ODBC, sélectionnez votre source de données, puis saisissez la valeur dans la zone Text size sur l'onglet Advanced. Si des caractères tels que les points de suspension sont tronqués, vous devez vous assurer que le jeu de caractères de votre pilote et celui de la base de données sont tous les deux définis à utf8. Dépannage du référentiel installé sur DB2 Cette section répertorie des problèmes connus pouvant être rencontrés lors de l'installation du référentiel sur un SGBD IBM DB2. Exception lors d'une recherche Si vous voyez des exceptions lorsque vous effectuez des recherches à l'aide de l'explorateur Web du référentiel PowerAMC, vous pouvez être amené à doubler la taille du paramètre applheapsz, qui contrôle la taille de pile d'application. Utilisation du référentiel 105

114 Contrôle de l'accès au référentiel à l'aide de LDAP Un administrateur de référentiel peut déléguer l'authentification des utilisateurs de référentiel à un serveur LDAP en sélectionnant Référentiel > Administration > Paramètres LDAP et en saisissant les paramètres appropriés pour son environnement. Une fois que le référentiel a été configuré pour permettre l'accès à des utilisateurs authentifiés par LDAP, ces utilisateurs peuvent se connecter au référentiel sans intervention supplémentaire de la part de l'administrateur du référentiel. La première fois qu'un utilisateur LDAP se connecte au référentiel, un compte est automatiquement créé pour lui dans les groupes Utilisateurs externes et Public. L'intégration LDAP du Référentiel PowerAMC assure uniquement l'authentification. L'autorisation reste gérée par le biais du jeu de permissions inclus dans l'environnement du Référentiel PowerAMC. Au départ, les membres du groupe Externe ont uniquement le droit Connecter, et les membres du groupe Public ont accès en lecture à tout le contenu du référentiel. L'administrateur va accorder d'autres droits et des permissions en fonction des besoins. Vous allez probablement souhaiter conserver un contrôle précis que les permission d'écriture sur les documents de référentiel. Pour tout mettre en place avant que vos utilisateurs ne se connectent au référentiel, vous pouvez créer manuellement des comptes pour eux et leur affecter des permissions avant qu'ils ne se connectent (voir Préconfiguration des permissions utilisateur LDAP à la page 109). Remarque : Avant de configurer le Référentiel PowerAMC pour l'authentification Active Directory, vous devez contacter votre administrateur Active Directory qui va vous fournir les informations nécessaires pour terminer le processus, et peut vous donner accès à un outil tel que l'utilitaire LDAP Browser. Pour saisir les paramètres de configuration LDAP, sélectionnez Référentiel > Administration > Paramètres LDAP (ou bien pointez sur le noeud racine, cliquez le bouton droit de la souris, puis sélectionnez Propriétés afin d'afficher la feuille de propriétés du référentiel, puis cliquez sur l'onglet LDAP). Paramètres généraux LDAP Plusieurs des paramètres de la zone de groupe Paramètres généraux sont requis : Paramètre Description URL du fournisseur [requis] Spécifie l'url du fournisseur LDAP au format ldap://hôteserveurldap:port, ou sous la forme d'une adresse IP. 106 PowerAMC

115 Chapitre 4 : Administration du référentiel Paramètre Protocole de sécurité Base de recherche par défaut Serveur de confiance Type de serveur Description [facultatif] Spécifie le protocole à utiliser lorsque vous vous connectez au serveur LDAP. Si vous utilisez SSL (qui est le seul protocole pris en charge pour l'instant), vous devez définir ce paramètre avec la valeur ssl. Nous vous recommandons de commencer par configurer votre accès LDAP sans SSL, puis de mettre en oeuvre le protocole uniquement lorsque vous vous êtes assuré du bon fonctionnement de votre accès. [requis] Spécifie la base de recherche LDAP par défaut à utiliser pour l'authentification, les rôles, l'attribution et l'auto-inscription. [requis] Spécifie que le serveur LDAP est un serveur de confiance. Spécifie le type de serveur LDAP. Le fait de sélectionner un type de serveur définit des valeurs par défaut silencieuses pour l'authentification et les filtres de rôle. Chaque configuration LDAP étant différente et ces valeurs par défaut pouvant se révéler pas adaptées à votre installation, nous vous recommandons de sélectionner none. Les types suivants sont disponibles: none - [recommandé]] sunone5 - pour SunOne 5.x OU iplanet 5.x msad2k - pour Microsoft Active Directory, Windows 2000 nsds4 - pour Netscape Directory Server 4.x openldap - pour OpenLDAP Directory Server 2.x Liaison anonyme Identité de liaison Mot de passe de liaison [facultatif] Spécifie que le serveur prend en charge l'accès anonyme à l'arborescence LDAP. Si ce paramètre n'est pas sélectionné, vous devez spécifier une identité et un mot de passe de liaison. Notez que Active Directory ne prend pas en charge d'emblée les liaisons anonymes. [requis sauf si Liaison anonyme est sélectionné] Spécifie le compte LDAP qui dispose des permissions nécessaires pour interroger le service Active Directory. Si l'identité de liaison est le même DN même que celui utilisé pour la base de recherche d'authentification, alors l'identité de liaison peut être tout simplement l'id utilisateur pour la recherche. Dans le cas contraire, vous avez besoin d'un nom et d'un mot de passe de connexion, ainsi que d'un DN (Distinguished Name (DN) pour ce compte. [requis sauf si Liaison anonyme est sélectionné] Spécifie le mot de passe avec lequel effectuer la liaison lorsque vous construisez la connexion LDAP initiale. Paramètres d'authentification La plupart des paramètres de la zone de groupe Authentification sont obligatoires : Utilisation du référentiel 107

116 Paramètre Filtre Portée Description [requis] Spécifie la requête LDAP qui recherche les informations utilisateur. Pour déterminer le filtre LDAP à utiliser, vous devez connaître les propriétés des utilisateurs définis dans Active Directory. La propriété qui a été utilisée comme nom d'ouverture de session peut être name, samaccountname ou une autre propriété. Dans cet exemple, nous utilisons samaccountname comme nom d'ouverture de session (que PowerAMC intercepte au moyen de la variable {uid} : (&(samaccountname={uid})(objectclass=user)) [requis] Spécifie la portée de la recherche d'authentification. Vous pouvez choisir l'une des valeurs suivantes : onelevel [valeur par défaut] - la recherche est limité au seul niveau spécifié dans la base de recherche subtree - la recherche commence au niveau de la base de recherche, mais se poursuit ensuite dans les sous-noeuds. Méthode [requis] Spécifie la méthode à utiliser pour les requêtes d'authentification. Vous pouvez choisir l'une des valeurs suivantes : simple - authentification de mot de passe en texte clair DIGEST-MD5 - authentification de mot de passe chiffré Format Digest MD5 Base de recherche [requis] Spécifie le format d'authentification DIGEST-MD5 d'identité de liaison. La valeur par défaut est DN [facultatif] Si la base de recherche par défaut spécifiée dans la zone de groupe Général n'inclut pas l'emplacement de la liste d'utilisateurs dans votre Active Directory, vous devez le spécifier ici Paramètres de rôle PowerAMC ne prend pas en charge les authentifications basées sur le rôle, de sorte que les valeurs que vous entrez dans la zone de groupe Rôle ne seront pas prises en compte : Paramètre Filtre Description Spécifie le filtre de recherche de rôle qui, combiné à la base de recherche et à la portée, renvoie une liste complète de rôles au sein du serveur LDAP. Il existe plusieurs valeurs par défaut en fonction du type de serveur choisi. Si le type de serveur n'est pas choisi ou si cette propriété n'est pas initialisée, aucun rôle ne sera disponible. 108 PowerAMC

117 Chapitre 4 : Administration du référentiel Paramètre Portée Description Spécifie la portée de la recherche du rôle. Vous pouvez choisir l'une des valeurs suivantes : onelevel [valeur par défaut] subtree Renvoi Spécifie le traitement des renvois. Vous pouvez choisir l'une des valeurs suivantes : ignore [valeur par défaut] follow throw Attribut de nom Base de recherche Spécifie l'attribut pour les rôles extraits qui est le nom commun du rôle. Si cette valeur est "dn", elle est interprétée spécialement comme le dn entier du rôle comme le nom de rôle. La valeur par défaut est "cn", le nom commun (common name). Spécifie la base de recherche du rôle. Préconfiguration des permissions utilisateur LDAP Vous pouvez créer manuellement des comptes pour les utilisateurs autorisés par LDAP et leur affecter des permissions, de sorte que tout soit en place pour eux lorsqu'ils se connectent pour la première fois. Si des utilisateurs authentifiés par LDAP sont déjà connectés au référentiel, ils se verront automatiquement créer des comptes que vous pouvez affecter directement à des groupes (voir Insertion d'un utilisateur dans un groupe à la page 115). 1. Sélectionnez Référentiel > Administration > Utilisateurs pour afficher la boîte de dialogue Liste des utilisateurs. 2. Cliquez sur l'outil Ajouter une ligne, puis spécifiez le nom approprié pour l'utilisateur dans la colonne Nom complet. 3. Saisissez l'identité de connexion LDAP de l'utilisateur dans la zone Nom de connexion, puis cochez la case dans la colonne X pour spécifier qu'il s'agit d'un utilisateur validé de façon externe. 4. Cliquez sur l'outil Propriétés pour afficher la feuille de propriétés de l'utilisateur, puis cliquez sur l'onglet Groupes pour ajouter cet utilisateur dans le ou les groupes appropriés (voir Insertion d'un utilisateur dans un groupe à la page 115). Utilisation du référentiel 109

118 Contrôle des droits des utilisateurs et des groupes de référentiel Le référentiel est conçu pour être utilisé par différents membres d'une équipe. Une équipe comporte généralement un administrateur du référentiel qui a en charge la gestion des comptes utilisateur. L'administrateur du référentiel est responsable des domaines suivants : Création et gestion des utilisateurs et groupes d'utilisateurs habilités à exploiter le référentiel Gestion des droits des différents utilisateurs et groupes dans le référentiel Remarque : Le référentiel a des groupes et des utilisateurs différents de ceux du SGBD. Les groupes sont utilisés pour affecter simultanément des droits communs à plusieurs utilisateurs du référentiel. Vous pouvez créer une hiérarchie de groupes en insérant des sousgroupes au sein d'autres groupes. Lorsque vous installez le référentiel PowerAMC, les groupes suivants sont créés par défaut : Administrateurs, [ADMN] - doté de droits d'administration du référentiel. Tous les utilisateurs [PUBLIC] - doté des droits Connecter. Tous les utilisateurs font partie de ce groupe. Utilisateurs externes [EXTERNAL] - doté des droits Connecter. Les utilisateurs LDAP distants sont automatiquement ajoutés à ce groupe lorsqu'ils se connectent pour la première fois. Création d'un utilisateur de référentiel L'administrateur du référentiel est responsable de la création de comptes utilisateur afin de permettre à ces utilisateurs de se connecter au référentiel et d'accéder au contenu dont ils ont besoin. 1. Sélectionnez Référentiel > Administration > Utilisateurs pour afficher la boîte de dialogue Liste des utilisateurs. 110 PowerAMC

119 Chapitre 4 : Administration du référentiel 2. Cliquez sur l'outil Ajouter une ligne, puis saisissez un nom dans la colonne Nom complet. 3. Cliquez sur l'outil Propriétés pour afficher la feuille de propriétés de l'utilisateur : 4. Saisissez le nom de connexion ainsi que les autres propriétés. Le mot de passe est à blanc par défaut et il n'est pas nécessaire de le définir à ce stade, toutefois la zone affiche 8 astérisques. 5. Cliquez sur OK. Les propriétés d'un utilisateur du référentiel sont les suivantes : Utilisation du référentiel 111

120 Propriété Nom complet Nom de connexion Commentaire Mot de passe / Confirmation Externe Désactivé Description Spécifie le nom complet de l'utilisateur. Spécifie le nom utilisé pour la connexion au référentiel. Spécifie les informations supplémentaires relatives à l'utilisateur. Spécifie l'adresse de messagerie électronique de l'utilisateur. Spécifie le mot de passe de l'utilisateur. Spécifie que l'authentification de l'utilisateur est gérée par un serveur LDAP (voir Contrôle de l'accès au référentiel à l'aide de LDAP à la page 106). Si vous cochez cette case, les champs Nom complet, et Mot de passe sont désactivés. Spécifie que l'acteur n'est plus actif dans le référentiel. Il reste présent dans la Liste des utilisateurs et peut être réactivé à tout moment. Tant qu'il est désactivé, un utilisateur ne peut plus se connecter au référentiel. Remarque : Lorsque vous créez un utilisateur, assurez-vous de lui octroyer des droits d'accès sur les documents du référentiel soit en l'insérant dans un groupe (voir Insertion d'un utilisateur dans un groupe à la page 115), soit directement (voir Définition des droits d'un utilisateur à la page 113). Si un utilisateur se connecte au référentiel sans disposer de droits d'accès, il ne pourra voir aucun document dans le volet Référentiel de 'Explorateur d'objets. Création d'un groupe L'administrateur du référentiel est responsable de la création des différents groupes d'utilisateurs dans le référentiel. 1. Sélectionnez Référentiel > Administration > Groupes pour afficher la boîte de dialogue Liste des groupes. 2. Cliquez sur l'outil Ajouter une ligne, puis saisissez un nom dans la colonne Nom. 3. Cliquez sur l'outil Propriétés pour afficher la feuille de propriétés du nouveau groupe. 4. Renseignez les propriétés appropriées, puis cliquez sur OK. Les propriétés d'un groupe du référentiel PowerAMC sont les suivantes : Propriété Nom Description Nom de l'élément. Il doit s'agir d'un nom clair et explicite, qui permette à des utilisateurs non spécialistes de savoir à quoi sert l'élément. 112 PowerAMC

121 Chapitre 4 : Administration du référentiel Propriété Code Commentaire Description Nom technique de l'élément. Ce nom est utilisé pour la génération de code ou de scripts. Il peut avoir une forme abrégée et il est préférable qu'il ne contienne pas d'espace. Informations supplémentaires relatives au groupe. Remarque : Vous devez accorder des droits d'accès au nouveau groupe afin que les utilisateurs qui en sont membre héritent de ces permissions (voir Spécification des droits pour un groupe à la page 114). Si un utilisateur se connecte au référentiel sans droit d'accès, il ne peut voir aucun document dans l'explorateur d'objets. Spécification des droits pour un utilisateur Un nouvel utilisateur ne dispose d'aucun droit attribué par défaut et n'appartient qu'au seul groupe PUBLIC, qui est dépourvu de droit. Pour que l'utilisateur puisse effectuer des opérations, l'administrateur doit lui octroyer des droits. Les mêmes types de droits peuvent être octroyés à des utilisateurs et à des groupes. Les droits d'un utilisateur peuvent être combinés afin de créer différents types de profil d'utilisateur. Le tableau suivant montre les projets classiques dans un projet. Notez la différence entre l'administrateur des données qui gère les données dans le référentiel et l'administrateur du référentiel qui gère à la fois le référentiel et ses utilisateurs. Profil utilisateur Droits utilisateur requis Administrateur de la base de données Administrateur de données Chef d'équipe Concepteur Connexion, Gestion du référentiel, Gestion des utilisateurs. Connexion, Gestion de tous les documents. Connexion, Gel des versions, Verrouillage des versions, Gestion des branches, Gestion des configurations. Connexion, Gel des versions, Verrouillage des versions. Les droits utilisateur peuvent être combinés aux permissions définies sur les documents afin de définir de façon plus fine les actions qu'un utilisateur peut effectivement entreprendre sur un document. Certains droits utilisateur sont automatiquement associés à certaines permissions pour des raisons de cohérence : Les droits de verrouillage et de gel de versions de documents sont associés à la permission Ecriture. Un utilisateur avec les droits de gel ou de verrouillage des versions doit avoir la permission Ecriture sur le document du référentiel. Utilisation du référentiel 113

122 Un utilisateur ayant la permission Totale sur un document peut déverrouiller ou dégeler une version verrouillée ou gelée par un autre utilisateur. Pour plus d'informations sur les permissions de document, reportez-vous à la section Contrôle des permission des éléments du référentiel à la page Sélectionnez Référentiel > Administration > Utilisateurs pour afficher la boîte de dialogue Liste des utilisateurs, sélectionnez l'utilisateur approprié dans la liste, puis cliquez sur l'outil Propriétés. 2. Cliquez sur l'onglet Droits et cochez la case correspondant à chaque droit que vous souhaitez octroyer. Les droits suivants sont disponibles : Connexion - L'utilisateur peut se connecter au référentiel. Gel des versions - L'utilisateur peut geler des versions de documents. Voir Versions de documents à la page 55. Verrouillage des versions - L'utilisateur peut geler des versions de documents. Voir Verrous de document à la page 57. Gestion des branches - L'utilisateur peut créer, modifier et supprimer des branches. Voir Branches de référentiel à la page 61. Gestion des configurations - L'utilisateur peut créer, modifier et supprimer des configurations. Voir Configurations de référentiel à la page 67. Gestion de tous les documents - L'utilisateur peut créer, consolider, extraire, déverrouiller, libérer et supprimer des versions de document dans le référentiel, mais aussi définir des permissions. Gestion des utilisateurs - L'utilisateur peut créer, modifier et supprimer des utilisateurs et des groupes, à leur octroyer ou révoquer des droits, ainsi qu'ajouter des utilisateurs ou des groupes dans d'autres groupes. Gestion du référentiel - L'utilisateur peut créer et à mettre à niveau un référentiel ainsi qu'à supprimer la base de données du référentiel. Remarque : Les utilisateurs dotés du droit Gestion de tous les documents (en règle générale, les administrateurs des données), se voient implicitement octroyer la permission Totale sur tous les documents du référentiel. De tels utilisateurs peuvent consolider, extraire, geler, verrouiller et même supprimer des documents pour lesquels ils ne se sont vus accorder de façon explicite une simple permission Lecture. 3. Cliquez sur OK pour enregistrer vos modifications et fermer la feuille de propriétés. Spécification des droits pour un groupe Lorsque vous créez un groupe, vous devez définir les droits de ce groupe, afin qu'il puisse utiliser le référentiel. Vous pouvez attribuer à un groupe les mêmes droits que vous accordez à un utilisateur. Remarque : Les droits qu'un utilisateur ou un groupe reçoit lorsqu'il devient membre d'un groupe sont ajoutés à ses droits existants. Par exemple, un utilisateur avec le droit Gestion 114 PowerAMC

123 Chapitre 4 : Administration du référentiel des branches ne perd pas ce droit lorsqu'il devient membre d'un groupe qui ne dispose que des droits Gel des versions et Verrouillage des versions. 1. Sélectionnez Référentiel > Administration > Groupes pour afficher la boîte de dialogue Liste des groupes. 2. Sélectionnez un groupe, puis cliquez sur l'outil Propriétés pour afficher sa feuille de propriétés. 3. Cliquez sur l'onglet Droits pour afficher la liste des droits dont dispose le groupe. 4. Cochez la case correspondant à chaque droit que vous souhaitez octroyer (pour plus d'informations sur les différents droits, voir Spécification des droits pour un utilisateur à la page 113). 5. Cliquez sur OK pour fermer la feuille de propriétés. Insertion d'un utilisateur dans un groupe Vous pouvez définir des groupes d'utilisateurs afin de leur octroyer plus facilement des droits et des permissions. Chaque nouvel utilisateur créé est inséré par défaut dans le groupe PUBLIC. Pour plus d'informations sur la création d'un groupe, voir Création d'un groupe à la page Sélectionnez Référentiel > Administration > Utilisateurs pour afficher la boîte de dialogue Liste des utilisateurs, sélectionnez l'utilisateur approprié dans la liste, puis cliquez sur l'outil Propriétés. Utilisation du référentiel 115

124 2. Cliquez sur l'onglet Groupes pour afficher la liste des groupes auquel l'utilisateur appartient. 3. [facultatif] Cliquez sur l'outil Montrer tous les groupes parent pour afficher les groupes parent du groupe sélectionné dans la liste. 4. Cliquez sur l'outil Ajouter des groupes pour afficher une boîte de dialogue qui répertorie tous les groupes disponibles. 5. Cochez la case d'un ou de plusieurs groupes dans la liste, puis cliquez sur OK pour leur ajouter l'utilisateur. Les groupes sont ajoutés dans l'onglet Groupes de la feuille de propriétés de l'utilisateur. Ajout d'utilisateurs et de groupes dans un groupe Vous pouvez ajouter et des utilisateurs et des groupes comme membres d'un groupe sur l'onglet Membres de la feuille de propriétés du groupe. Pour plus d'informations sur l'insertion d'un utilisateur dans un groupe à partir de la feuille de propriétés du groupe, reportez-vous à la section Insertion d'un utilisateur dans un groupe à la page Sélectionnez Référentiel > Administration > Groupes pour afficher la boîte de dialogue Liste des groupes, sélectionnez un groupe dans la liste et cliquez sur l'outil Propriétés. 2. Cliquez sur l'onglet Membres pour afficher la liste des utilisateurs et des groupes qui appartiennent au groupe. 3. [facultatif] Cliquez sur l'outil l'outil Montrer tous les groupes parent pour afficher les groupes parent du groupe sélectionné dans la liste. 4. Cliquez sur l'outil Ajouter pour afficher une boîte de dialogue de sélection, qui répertorie sur des onglets les utilisateurs et groupes disponibles. 5. Cochez les cases correspondant à un ou plusieurs groupes ou utilisateurs, puis cliquez sur OK pour les ajouter au groupe. Les utilisateurs et groupes sont ajoutés au groupe et affichés dans la liste des membres du groupe sur l'onglet Membres de la feuille de propriétés du groupe. 6. Cliquez sur OK pour fermer la feuille de propriétés du groupe. Insertion d'un groupe dans un autre groupe Vous pouvez insérer un groupe dans un autre groupe. Par exemple, dans une équipe de développement, vous avez créé plusieurs groupes (Développeurs, Assurance Qualité, Documentation). Vous pouvez ensuite insérer ces groupes dans un groupe plus vaste nommé R&D et pour lequel vous pouvez définir des droits spéciaux. 1. Dans la feuille de propriétés d'un groupe, cliquez sur l'onglet Groupes parent. 2. [facultatif] Cliquez sur l'outil Montrer tous les groupes parent pour afficher les groupes parent du groupe sélectionné dans la liste. 116 PowerAMC

125 Chapitre 4 : Administration du référentiel 3. Cliquez sur l'outil Ajouter des objets pour afficher une boîte de dialogue de sélection qui répertorie tous les groupes disponibles. 4. Cochez la case d'un ou de plusieurs groupes disponibles, puis cliquez sur OK pour leur ajouter le groupe. Désactivation ou suppression des utilisateurs de référentiel L'administrateur du référentiel ou un utilisateur disposant du droit Gestion des utilisateurs peut désactiver ou supprimer des utilisateurs. Avertissement! Un utilisateur ne peut pas se supprimer ou de désactiver lui-même et ce, même s'il dispose du droit Gestion des utilisateurs. La suppression d'un utilisateur ne peut pas être annulée. 1. Sélectionnez Référentiel > Administration > Utilisateurs pour afficher la boîte de dialogue Liste des utilisateurs. 2. [pour désactiver l'utilisateur] Sélectionnez l'utilisateur dans la liste, puis cochez la case [D]ésactiver. L'utilisateur reste dans la liste et peut être réactivé à tout moment. Tant qu'il est désactivé, l'utilisateur ne peut pas se connecter au référentiel. 3. [pour supprimer l'utilisateur] Sélectionnez l'utilisateur dans la liste, puis cliquez sur l'outil Supprimer. Si l'utilisateur a créé ou modifié des documents, il est désactivé. Dans le cas contraire il est supprimé de la liste des utilisateurs et complètement retiré du référentiel. Suppression d'un groupe Lorsque vous supprimez un groupe dans le référentiel, vous ne supprimez pas ses membres (utilisateurs ou groupes) de ce groupe. La suppression d'un groupe produit les résultats suivants : L'utilisateur qui appartient à ce groupe perd les droits définis pour le groupe Toutes les permissions définies sur les documents du référentiel et qui ont été accordées pour le groupe sont annulées Le groupe est retiré des groupes auxquels il appartenait Le groupe n'apparaît plus dans la liste des groupes 1. Sélectionnez Référentiel > Administration > Groupes pour afficher la boîte de dialogue Liste des groupes. 2. Sélectionnez un groupe dans la liste, puis cliquez sur l'outil Supprimer. Le groupe disparaît de la liste. 3. Cliquez sur OK. Utilisation du référentiel 117

126 Contrôle des permission des éléments du référentiel Les permissions sont des droits d'accès accordés aux utilisateurs ou groupes sur le référentiel, les dossiers, les documents et les packages de modèle. Selon le type de travail qu'ils effectuent, les utilisateurs peuvent avoir besoin de permissions d'accès différentes sur les différents documents contenus dans le référentiel. Les permissions doivent être combinées avec les droits accordés aux utilisateurs et groupes (voir Contrôle des droits des utilisateurs et des groupes de référentiel à la page 110). Vous pouvez octroyer des permissions à un utilisateur ou à un groupe sur les éléments suivants : La racine du référentiel les permissions s'appliquent à tout le contenu référentiel. Les dossiers les permissions s'appliquent à tout le contenu du dossier. Documents - modèles PowerAMC et fichiers d'applications externes. Packages de modèle dans des modèles PowerAMC. Remarque : Vous ne pouvez pas octroyer de permissions aux objets et aux diagrammes de modèles PowerAMC. Lorsque vous créez un dossier dans le référentiel, celui-ci a des permissions d'accès par défaut : L'utilisateur qui crée le dossier dans le référentiel a la permission Totale. Cette permission peut être retirée par l'administrateur. Les autres utilisateurs et groupes n'ont pas de permission d'accès à l'exception des permissions octroyées aux dossiers auxquels ils appartiennent. S'ils n'ont aucune permission, ils ne peuvent pas voir le dossier dans l'onglet Référentiel de l'explorateur d'objets Lorsque vous définissez une permission d'accès sur un dossier, la restriction s'applique à tous les documents qu'il contient. Vous pouvez modifier ultérieurement les permissions des membres du dossier. Cette règle s'applique également lorsque vous définissez une permission d'accès sur le noeud racine, sur un dossier, sur un document ou un package. Permissions pour consolidation Lorsque vous souhaitez consolider des documents dans le référentiel, vous devez disposer des permissions suivantes : 118 PowerAMC

127 Chapitre 4 : Administration du référentiel Type de consolidation Première consolidation : vous souhaitez créer le document dans le référentiel. Mise à jour : vous souhaitez mettre à jour un document déjà existant dans le référentiel. Permission nécessaire Ecriture sur l'emplacement cible (dossier ou racine). Lecture sur l'emplacement cible et Ecriture sur le document (y compris, dans le cas des modèles PowerAMC, sur tous les documents impactés). Définition de permissions d'accès sur un élément de référentiel Pour définir des permissions d'accès sur un élément de référentiel : 1. Pointez sur l'élément dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Permissions dans le menu contextuel pour afficher la feuille de propriétés de l'élément à l'onglet Permissions. 2. Cliquez sur l'outil Ajouter pour afficher une boîte de sélection qui répertorie tous les utilisateurs et groupes disponibles. 3. Sélectionnez un ou plusieurs groupes, puis cliquez sur OK pour les ajouter dans la liste des permissions de l'élément. 4. Pour chaque utilisateur ou groupe, sélectionnez les permissions d'accès dans la liste déroulante de la colonne Permission octroyée. Les permissions suivantes sont disponibles : Liste - L'utilisateur ou le groupe dispose de permissions minimum permettant de visualiser l'élément dans l'explorateur d'objets; d'afficher des feuille de propriétés en mode de lecture seule et de rechercher des modèles. Lecture - L'utilisateur ou le groupe dispose de toutes les permissions Liste, et peut également comparer les documents, et extraire le document (ou le contenu du dossier) du référentiel. Ecriture - L'utilisateur ou le groupe dispose de toutes les permissions Lecture, et peut également consolider, geler et verrouiller des versions de document. Totale - L'utilisateur ou le groupe dispose de toutes les permissions Ecriture, et peut gérer les permissions accordées aux utilisateurs ou groupes et ôter les verrous des documents. Notez que les utilisateurs ne disposant d'aucune permission sur un document ou dossier ne peut même pas voir ce dernier dans l'explorateur d'objets. Utilisation du référentiel 119

128 5. Cliquez sur OK pour enregistrer vos modifications. Notions de base relatives aux permissions octroyées et effectives Vous pouvez octroyer une permission d'accès à un groupe ou à un utilisateur. Lorsque vous octroyez une permission à un groupe, les utilisateurs appartenant à ce groupe héritent des permissions de ce groupe. Dans la feuille de propriétés d'un document, la liste des permissions affiche deux colonnes : La colonne Permission octroyée est utilisée pour définir les permissions des groupes et des utilisateurs. Vous utilisez la liste de permissions La colonne Permission effective affiche les permissions effectives des groupes et des utilisateurs. Le contenu de cette colonne n'est pas modifiable Par défaut, les membres d'un groupe ne s'affichent pas dans la liste des permissions, il s'agit du mode d'affichage non-hérité. Vous pouvez cependant afficher ces utilisateurs en cliquant sur l'outil Afficher tous les utilisateurs autorisés, il s'agit du mode hérité. Le comportement de la liste des permissions varie en fonction du mode d'affichage sélectionné. Mode non hérité Il s'agit du mode d'affichage par défaut, il montre les permissions réellement octroyées aux utilisateurs ou aux groupes. Les membres des groupes ne sont pas affichés La permission <Aucune> n'est pas utilisée 120 PowerAMC

129 Chapitre 4 : Administration du référentiel La permission octroyée à un utilisateur ou à un groupe est toujours identique à la permission effective La suppression d'un groupe ou d'un utilisateur est immédiatement appliquée Mode hérité Les membres des groupes sont affichés La colonne Permission octroyée affiche <Aucune> pour ces utilisateurs jusqu'à ce que vous définissiez une permission à l'aide de la liste de permissions La colonne Permission effective affiche la véritable permission du groupe ou de l'utilisateur, il s'agit de la permission la plus étendue sélectionnée (entre la permission du groupe ou celle de l'utilisateur), comme illustré dans le tableau suivant : Permission du groupe Permission d'un utilisateur (du groupe) Liste Ecriture Ecriture Totale Lecture Totale Permission effective de l'utilisateur Lorsque vous supprimez un groupe dans la liste et avant de cliquer sur le bouton Appliquer, le groupe et ses membres restent visibles dans la liste, la colonne Permission octroyée affiche <Aucune>. Lorsque vous cliquez sur Appliquer, le groupe et ses membres disparaissent de la liste des permissions Copie des permissions sur les enfants Les permissions d'accès s'appliquent automatiquement aux nouveaux sous-dossiers ou documents qui sont ajoutés dans un dossier parent. Les permissions d'accès sont ensuite dissociées : lorsque vous modifiez les permissions du père, les enfants conservent leurs permissions originales. De même, vous pouvez modifier les permissions d'un enfant sans que cela affecte les permissions de son père. Si vous souhaitez rétablir les permissions d'un parent sur ses membres enfant, vous devez utiliser l'outil Copier les permissions sur tous les enfants depuis l'onglet Permissions des feuilles de propriétés suivantes : Feuille de propriétés Impact Racine Dossier Modèle PowerAMC Package PowerAMC Copie les permissions sur tous les dossiers, les documents, les modèles et les packages du référentiel. Copie les permissions sur tous les membres du dossier. Copie les permissions sur tous les packages du modèle. Copie les permissions sur tous les sous-packages. Utilisation du référentiel 121

130 Copie de permissions d'un parent sur ses enfants Pour copier des permissions d'un parent sur ses enfants : 1. Pointez sur un noeud de dossier dans l'arborescence du référentiel, puis cliquez le bouton droit de la souris. 2. Sélectionnez Permissions dans le menu contextuel. La feuille de propriétés du dossier s'affiche à l'onglet Permissions. 3. Sélectionnez l'outil Copier les permissions sur tous les enfants. 4. Cliquez sur Appliquer. Les permissions sont appliquées à tous les membres enfant, et l'outil Copier les permissions sur tous les enfants retrouve son état par défaut (désactivé) dans la barre d'outils de la liste des permissions. Exemples de permissions Ces exemples illustrent l'utilisation des permissions d'accès dans le référentiel. Exemple 1 : Dossiers et documents Le dossier Y2K comprend deux sous-dossiers : Données et Specs. Le sous-dossier Données comprend deux modèles : PremierProject (MPD) et Classes (MOO). Le sous-dossier Specs comprend PlanGénéral.doc. Le tableau suivant répertorie les permissions octroyées aux groupes et utilisateurs travaillant sur le projet : Dossier Chef de projet Chef dévpt. Développeur Chef conception Concepteur Y2K Totale Lecture Lecture Lecture Lecture Données Totale Ecriture Lecture Lecture Lecture Documents dans Données Totale Lecture Ecriture Lecture Lecture 122 PowerAMC

131 Chapitre 4 : Administration du référentiel Dossier Chef de projet Chef dévpt. Développeur Chef conception Concepteur Specs Totale Lecture Lecture Ecriture Lecture Documents dans Specs Totale Lecture Lecture Lecture Ecriture Le tableau suivant répertorie les droits octroyés aux groupes et utilisateurs : Groupes ou utilisateurs Administrateur du référentiel et des données Chef de projet Chef de développement Développeur Chef de conception Concepteur Droit Connexion, Gestion de tous les documents, Gestion de tous les utilisateurs, Gestion du référentiel. Connexion, Gel des versions, Verrouillage des versions, Gestion des branches, Gestion des configurations. Connexion, Gel des versions, Verrouillage des versions. Connexion, Gel des versions, Verrouillage des versions. Connexion, Gel des versions, Verrouillage des versions. Connexion, Gel des versions, Verrouillage des versions. Remarque : Les utilisateurs disposant du droit Gestion de tous les documents (en règle générale, les administrateurs des données), se voient implicitement octroyer la permission Totale sur tous les documents du référentiel. De tels utilisateurs peuvent consolider, geler, verrouiller et même supprimer des documents pour lesquels ils se sont vus octroyer explicitement uniquement une permission Lecture. Exemple 2 : Packages Le modèle PREMIER_PROJET est divisé en deux packages parent: ANALYSE et IMPLEMENTATION, qui correspondent aux différentes tâches que le groupe de développeur doit accomplir. Chaque package parent est divisé en deux packages, chacun de ces packages est sous la responsabilité d'un développeur du projet. Utilisation du référentiel 123

132 Les permissions suivantes sont octroyées aux développeurs sur les packages du modèle : Package Chef d'équipe Dev.1 Dev.2 Dev.3 Dev.4 Analyse Totale Lecture Lecture Lecture Lecture SYS_GLOBAL Totale Ecriture Lecture Lecture Lecture PAR_DEPT Totale Lecture Ecriture Lecture Lecture IMPLEMENTA- TION Totale Lecture Lecture Lecture Lecture DEPARTEMENT Totale Lecture Lecture Ecriture Lecture GENERAL Totale Lecture Lecture Lecture Ecriture Protection temporaire de l'accès aux documents dans le référentiel Lorsque vous consolidez, gelez, verrouillez ou supprimez un document dans le référentiel, une protection temporaire est appliquée à toutes les version du document afin de garantir que la mise à jour soit correctement effectuée, et un message d'erreur s'affiche si d'autres utilisateurs tentent une mise à jour. Par exemple, vous ne pouvez pas verrouiller une version qu'un autre membre de l'équipe est en train de consolider, ou geler une version qu'un autre membre de l'équipe est en train de verrouiller. Cette protection temporaire est annulée une fois que l'action est terminée. Si votre connexion au référentiel est interrompue lors d'une mise à jour d'un document, la protection temporaire peut rester appliquée au document dans le référentiel, et la prochaine fois que vous tentez de mettre à jour le document, un message s'affiche pour vous informer que ce document est déjà en accès exclusif. Dans ce cas, vous pouvez choisir de passer outre cette protection ou d'annuler l'action. Si le document a été protégé et bloqué depuis votre poste de travail PowerAMC vérifie le nom de la machine et non pas le nom de l'utilisateur connecté. 124 PowerAMC

133 Chapitre 4 : Administration du référentiel PowerAMC Deux sessions sont lancées sur le poste de travail : par exemple, vous consolidez un document dans une session et vous souhaitez verrouiller une version de ce même document depuis l'autre session de PowerAMC. Une seule session s'est interrompue accidentellement alors que vous faisiez une consolidation du document. Vous devez Vous ne devez pas passer outre la protection mais attendre que la consolidation s'achève. Vous pouvez passer outre la protection pour continuer l'opération. Si le document a été protégé et bloqué depuis une machine du réseau Vous devez demander à l'administrateur des données de le débloquer. L'administrateur des données doit s'assurer qu'aucun autre utilisateur ne met à jour le document puis effectuer une action sur ce document (par exemple poser un verrou) afin que la boîte de message s'affiche pour lui permettre de passer outre la protection afin de libérer le document. Avertissement! Passer outre une protection temporaire lorsque vous n'êtes pas habilité à effectuer une tel tâche peut endommager gravement le document. Audit des activités du référentiel Les utilisateurs ayant le droit Gestion de tous les documents peuvent réaliser un audit de l'utilisation du référentiel via la boîte de dialogue Liste des activités. Les activités sont des actions qui modifient le document dans le référentiel, telles que la consolidation, le gel et la suppression. La liste permet de surveiller les opérations effectuées sur les documents de référentiel, analyser des schémas de comportement des utilisateurs et faire ressortir des séquences d'activité. Consultation de la liste des activités Pour consulter la liste des activités : Appuyez sur Ctrl+Alt+V ou sélectionnez Référentiel > Activités pour afficher la boîte de dialogue Liste des activités. Utilisation du référentiel 125

134 Remarque : Sélectionnez un élément dans la liste, puis cliquez sur l'outil Propriétés pour afficher la feuille de propriétés de l'objet affecté. Si nécessaire, vous pouvez utiliser l'onglet Versions de la feuille de propriétés pour extraire ou verrouiller la version de document. La liste des activités affiche toutes les opérations qui ont eu pour résultat la modification de documents stockés dans le référentiel. Cette liste n'affiche pas les changements concernant les objets à l'intérieur des modèles. Vous pouvez personnaliser l'affichage de la liste des activités à l'aide de l'outil Personnaliser les colonnes et filtrer dans la barre d'outils de la liste. Les informations suivantes peuvent être utiles si vous souhaitez consulter les activités dans le référentiel : Information Type d'activité Nom Code Emplacement Version Commentaire Description Type d'action réalisée sur un document (consolidation, gel ou suppression). Attention, les actions comme la pose d'un verrou ne figurent pas dans la liste des activités étant donné qu'elles ne modifient pas le document. Nom de l'élément. Il doit s'agir d'un nom clair et explicite, qui permette à des utilisateurs non spécialistes de savoir à quoi sert l'élément. Nom technique de l'élément. Ce nom est utilisé pour la génération de code ou de scripts. Il peut avoir une forme abrégée et il est préférable qu'il ne contienne pas d'espace. Dossier dans lequel le document est stocké. Numéro de version du document. Commentaire de l'activité. 126 PowerAMC

135 Chapitre 4 : Administration du référentiel Information Date Utilisateur Description Date à laquelle l'opération a été réalisée. Nom de connexion de l'utilisateur qui a réalisé l'opération. Utilisation du référentiel 127

136 128 PowerAMC

137 Index Index A abonnement 82 accès permission 118 protection temporaire 124 accès web 3 activité (référentiel) audit 125 consulter 125 gestion de tous les documents 125 liste 125 ouvrir la liste 125 Adaptive Server Enterprise dépannage 105 ADMIN 4, 8, 110 afficher données 52 les groupes parent 116 analyse d'impact 50 annuler une consolidation 31 application externe 30 audit des activités dans le référentiel 125 B base de données mettre à jour 103 supprimer le référentiel 104 taille 55 branche aucune 61 base 63 changer 64 consolider 13, 28 courante 61 créer 63 de base 61 gérer 61 gérer les membres 65 par défaut 61 supprimer 66 supprimer une version 57 branche courante 61 branche de base 61 C changer branche 64 mot de passe 11 chemin 33 chemin nommé créer pour une ressource 71 client/serveur (environnement) 1 comparer modèles 49 ressources 78 configuration créer 68 extraire un projet 70 extraire une version 70 gérer 67 gérer les versions 69 supprimer une version 57 conflit de consolidation 26 connecter automatiquement 10 référentiel 52 connexion directe 3, 4 connexion proxy 3 connexion via un proxy 8, 103 consolider 16 ajouter un document 15 annuler 31 branche 27, 28 branche courante 13 conflit 26 conflit de fusion 26 Conserver les modifications du référentiel 24 document 15, 18, 23 document d'application externe 30 droit Gestion de tous les documents 13 fichier 15 fichier de projet 15 geler la version courante 31 geler une version 13 intégrer 27, 29 mettre à jour 13, mise à jour des dépendances 51 mise à jour interactive 24 Utilisation du référentiel 129

138 Index mise à jour par lôt 24 mode 27 modèle 15 modèle de projet 15 modèle PowerAMC 26 nouveau 27 options de mise à jour 24 organisation de travail 13 package 30 paramètres 20 permission 13 permission Ecriture 13 plusieurs fichiers 16 plusieurs modèles 16 projet 17 protection temporaire 124 Résoudre manuellement 24 ressource 73, 77 transactions importantes 27 Utiliser mes modifications 24 verrouiller 31 verrous en mode Nouveau 27 copie de sauvegarde 103 copier les permissions 121 D DB2 dépannage 105 déconnecter 11 déconnecter le référentiel 104 dégeler version 56 dépendance externe 50 génération inter-modèles 50 interne 50 mise à jour depuis le référentiel 50, 51 raccourci externe 50 déverrouiller consolider 60 extraire 60 diagramme 41 document 41 application externe 30 consolider 15 consolider plusieurs documents 23 copier les permissions 121 état 13 extraire 31, 34 extraire plusieurs documents 37 GUID 28 mettre à jour 31 propriétés 44 protection temporaire 124 supprimer 57 verrou 58, 59 version 55 document de référentiel 35 Document du référentiel 20 document local 35 Document local 20 documents de projet 35 Documents du projet 20 dossier 41 copier les permissions 121 créer 42 déplacer 43 noeud 42 renommer 43 supprimer 44 droit geler des versions 55 groupe 114 droits utilisateur 113 E exécuter SQL 52 explorateur catégorie 41 diagramme 41 document 41 dossier 41, 42 noeud 41 objet 41 projet 41 racine 41 référentiel 41 Explorateur d'objets rechercher des objets 46 Explorateur Web 79 Explorateur Web du référentiel PowerAMC 3, 79 abonnements 82 branches 93 changer de branche PowerAMC

139 Index comparer des modèles 83 créer un groupe 89 créer un utilisateur 88 créer une branche 93 droits 89 groupes 88, 90, 91 ouverture de session 79 paramètres 94 paramètres client 95 paramètres de serveur 96 propriétés d'un document 81 propriétés de document 80 supprimer un groupe 92 supprimer un utilisateur 92 supprimer une branche 94 utilisateurs 88, 90, 91 Extraction d'un document 34 extraire chemin 33 configuration 33 dépendances 33 document 31, 34 fichier 32 fusionner 33, 39 lecture uniquement 33 mise à jour des dépendances 51 modèle 32 nom 33 options 33 package 40 paramètres 35 permissions 40 plusieurs documents 37 projet 31, 33 recherche des objets 46 référentiel 33 verrouiller 33 version à partir d'une configuration de projet 70 version d'une configuration 70 F fermer la connexion au référentiel 11 fusionner 33 conflit 26 extraire un modèle 39 option générale 39 G geler annuler une consolidation 31 protection temporaire 124 toutes les versions de document 55 version 13, 55 gérer branches 61 verrous 57 gestion de tous les documents 125 groupe créer 112 droit 114 droit additif 114 insérer dans un groupe 116 insérer un utilisateur 116 membre du groupe 116 permissions 112 référentiel 110 utilisateur 115 utilisateur membre 116 GUID 28 J journal d'activités du référentiel 125 L LDAP contrôle de l'accès au référentiel 106, 109 Liste de résultats onglet Recherche 46 M membre d'un branche 65 mettre à jour 103 dépendances depuis le référentiel 51 document 31 fichier 32 modèle 26, 32 projet 31 version 13 mise à jour options 24 mise à jour (mode) Utilisation du référentiel 131

140 Index consolidation 28 mise à jour interactive 24 mise à jour par lôt 24 mode branche 27, 28 intégrer 27, 29 mise à jour 27, 28 nouveau 27 modèle consolider 26 copier les permissions 121 extraire avec fusion 39 extraire un package 40 rechercher des objets 46 modèles comparer 49 mot de passe changer pour un référentiel 11 utilisateur 110 N notification de modification 82 nouveau (mode de consolidation) 27 O objet 41 propriétés 46 option connexion 53 connexion automatique 10 consolidation 24, 53 extraction 53 fusionner des modèles 39 l'explorateur d'objets 53 mise à jour 24 P package 33 consolider 30 extraire 40 permissions 30 raccourcis 40 permission afficher tous les utilisateurs autorisés 120 consolider 13 copier sur les sous-dossiers 121 document 118, 121 dossier 118 écriture 118, 120 groupe 112 hériter 120 lecture 118, 120 liste 118, 120 modèle 121 package 30, 40, 121 pas d'accès 118 référentiel 118 utilisateur 110, 120 profil utilisateur créer pour les ressources 75 projet 41 protection temporaire 124 document 124 passer outre 124 R raccourcis dans les packages 40 racine 41 copier les permissions 121 explorateur 41 geler tous les documents 55 verrouiller toutes les versions 59 recherche des objets afficher des propriétés 46 extraire 46 Liste de résultats 46 rechercher des objets modèle 46 référentiel accès web 3 activité 125 Adaptive Server Enterprise 105 admin 110 ADMIN 4, 8 changer de mot de passe 11 cohérence des données 1 connecter 9 connexion automatique 10 connexion directe 3, 4 connexion proxy 3 connexion via un proxy 8 consolider un document PowerAMC

141 Index copie de sauvegarde de la base de données 103 créer un utilisateur 110 DB2 105 déconnecter 11 définition 4, 8 désactiver un utilisateur 117 dossier 42 droits utilisateur 113 échec de la mise à jour 103 explorateur 41 Explorateur Web du référentiel PowerAMC 79 extraire document 31 groupe 110, 112 intégrité des données 1 liste des activités 125 mettre à jour 103 mettre à jour des dépendances 51 mettre à jour un document 31 mise à jour de la base 103 mise à jour des dépendances 50 options générales 10 paramètres LDAP 106, 109 partage des données 1 partager les ressources 71 permissions d'accès 118 protection temporaire 124 proxy 1 recherche des objets 46 régénération des index clustered 103 rôle 1 script de suppression 104 supprimer les tables 104 supprimer un utilisateur 117 taille de base de données 55 tester la définition 4, 8 travail en équipe 1 utilisateur 110 régénérer les index clustered 103 renommer un dossier 43 repository extraire 33 requête exécuter 52 SELECT 52 ressource activer le partage 74, 75 comparer 77, 78 S consolider 73, 77 consolider des changements 77 créer un chemin nommé 71 créer un profil utilisateur 75 créer un template 74 mettre à jour automatiquement 71 partager 73 partager via le référentiel 71 permettre le partage 71, 73 politiques de partage 77 préparer le partage 71 SELECT (requête) 52 SQL 52 supprimer branche 66 document 57 dossier vide 44 protection temporaire 124 utilisateur 117 version 57 T taille base de données 55 template créer pour une ressource 74 U utilisateur ajouter dans un groupe 115 désactiver 117 droits 113 groupe 115 insérer dans un groupe 116 montrer tous les groupes parent 115 mot de passe 110 permissions 110 référentiel 110, 117 V verrou 33 ajouter modèles liés 59 Utilisation du référentiel 133

142 Index ajouter une configuration 59 annuler une consolidation 31 document 58 documents multiples 59 protection temporaire 124 version 57 verrouiller toutes les versions 59 verrous sur le serveur en cours de consolidation 27 version configuration 69 dégeler 56 droit d'utilisateur 55 extraire à partir d'une configuration de projet 70 extraire depuis une configuration 70 geler 55 gérer 55 mise à jour 55 supprimer 57 verrouiller PowerAMC