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