Utilisation du référentiel PowerAMC 15.3

Utilisation du référentiel PowerAMC 15.3 Windows

ID DU DOCUMENT : DC31023-01-1530-01 DERNIERE REVISION : Novembre 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) 685-8225, télécopie (617) 229-9845. 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 (http://www.sybase.com/detail? id=1011207). 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 52.227-7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies. Sybase, Inc., One Sybase Drive, Dublin, CA 94568

Table des matières Chapitre 1 : Introduction au référentiel...1 Configuration de PowerAMC pour l'accès au référentiel...2 Configuration de PowerAMC pour un accès direct...3 Configuration de PowerAMC pour un accès via le proxy...5 Connexion à un référentiel...6 Connexion automatique au référentiel par défaut...7 Changement de votre mot de passe pour le référentiel...7 Fermeture d'une connexion au référentiel...8 Options générales du référentiel...9 Chapitre 2 : Gestion des documents dans le référentiel...11 Consolidation de documents dans le référentiel...11 Consolidation d'un projet...12 Consolidation d'un document...13 Consolidation de plusieurs documents...14 Paramètres de consolidation...16 Résolution des conflits lors de la consolidation...18 Consolidation de packages...20 Consolidation de documents issus d'applications externes...21 Annulation d'une consolidation...21 Extraction de documents du référentiel...21 Extraction d'un projet...22 Extraction d'un document...22 Extraction de plusieurs documents...23 Utilisation du référentiel iii

Table des matières Paramètres d'extraction...25 Résolution des conflits lors de l'extraction...26 Extraction de packages...27 Vérification de l'état d'un document...28 Parcourir le référentiel...30 Propriétés de la racine du référentiel...30 Dossiers du référentiel...31 Propriétés des documents et objets du référentiel...32 Recherche d'objets de modèle PowerAMC...34 Paramètres de recherche d'objet...35 Comparaison de modèles dans le référentiel...36 Analyse d'impact...38 Extraction des dépendances depuis le référentiel...39 Mise à jour des dépendances d'un modèle depuis le référentiel...39 Exécution de requêtes SQL dans le référentiel...40 Gel de versions de document...41 Dégel d'une version de document...42 Suppression de versions de document...43 Verrouillage de versions de document...43 Déverrouillage de documents...44 Gestion des verrous de document dans la boîte de dialogue Liste des verrous...45 Regroupement de versions de document dans une configuration...46 Création d'une configuration à partir d'un projet ou d'un dossier...48 Extraction d'une configuration...49 Création d'arborescences de versions...49 Consolidation d'un document dans une branche particulière...52 Consolidation d'un document à l'aide des modes Mise à jour, Branche et intégrer...53 Gestion des membres d'une branche...55 iv PowerAMC

Table des matières Suppression d'une branche...56 Partage de ressources dans le référentiel...56 Préparation au partage des ressources dans le référentiel...56 Création de chemins nommés pour localiser les ressources partagées...57 Sélection et préparation des ressources à partager...58 Consolidation des ressources à partager dans le référentiel...59 Rendre les ressources partagées disponibles dans la boîte de dialogue Nouveau modèle...59 Création d'un profil utilisateur afin d'activer le partage des ressources...60 Communication des politiques de partage des ressources à vos utilisateurs...62 Utilisation de ressources partagées...63 Edition de ressources partagées...63 Comparaison de fichiers de ressources partagés...63 Chapitre 3 : Parcourir le référentiel via le Web...65 Connexion à l'explorateur Web du référentiel PowerAMC...65 Explorateur de l'explorateur Web du référentiel PowerAMC...66 Propriétés de document et d'objet de référentiel...67 Ajout d'une permission à un utilisateur ou à groupe sur un élément de référentiel...67 Abonnement aux notifications de modification...68 Comparaison de versions de modèle et d'objet...69 Recherche dans l'explorateur Web du référentiel PowerAMC...69 Utilisation du référentiel v

Table des matières Utilisateurs et groupes de l'explorateur Web du référentiel PowerAMC... 73 Création d'un utilisateur de référentiel...73 Création d'un groupe de référentiel...74 Octroi de droits aux utilisateurs et aux groupes...74 Ajout d'un membre dans un groupe à partir de la feuille de propriétés du membre...75 Ajout d'un membre dans un groupe à partir de la feuille de propriétés du groupe...76 Désactivation d'un utilisateur...77 Suppression d'un groupe...77 Branches de l'explorateur Web du référentiel PowerAMC...78 Création d'une branche...78 Changement de branche...79 Suppression d'une branche...79 Paramètres de l'explorateur Web du référentiel PowerAMC...79 Paramètres client de l'explorateur Web du référentiel PowerAMC...79 Création d'un nouveau thème de couleurs...81 Paramètres serveur de l'explorateur Web du référentiel PowerAMC...82 Activation de SSL...87 Paramètres d'état du serveur de l'explorateur Web du référentiel PowerAMC...88 Dépannage de l'explorateur Web du référentiel PowerAMC...89 Encodage Unicode avec Sybase SQL Anywhere v10...89 Augmentation de la mémoire de Tomcat...89 Chapitre 4 : Administration du référentiel...91 Création, mise à jour et suppression de la base de données du référentiel...91 vi PowerAMC

Table des matières Mise à jour du référentiel...91 Suppression des tables du référentiel...92 Dépannage du référentiel installé sur ASE...93 Dépannage du référentiel installé sur DB2...93 Contrôle de l'accès au référentiel à l'aide de LDAP...94 Préconfiguration des permissions utilisateur LDAP...98 Contrôle des droits des utilisateurs et des groupes de référentiel...98 Création d'un utilisateur de référentiel...99 Création d'un groupe...101 Spécification des droits pour un utilisateur...101 Spécification des droits pour un groupe...103 Insertion d'un utilisateur dans un groupe...104 Ajout d'utilisateurs et de groupes dans un groupe...105 Insertion d'un groupe dans un autre groupe...105 Désactivation ou suppression des utilisateurs de référentiel...106 Suppression d'un groupe...106 Contrôle des permission des éléments du référentiel...107 Définition de permissions d'accès sur un élément de référentiel...108 Notions de base relatives aux permissions octroyées et effectives...109 Copie des permissions sur les enfants...110 Copie de permissions d'un parent sur ses enfants...111 Exemples de permissions...111 Protection temporaire de l'accès aux documents dans le référentiel...113 Audit des activités du référentiel... 114 Consultation de la liste des activités...114 Index...117 Utilisation du référentiel vii

Table des matières viii PowerAMC

Chapitre 1 Introduction au référentiel Le référentiel de PowerAMC est un outil permettant de stocker et de partager des modèles et d'autres fichiers utilisés dans votre processus de modélisation tout en conservant la trace de leurs différentes versions. Il permet d'assurer une protection robuste et paramétrable, est entièrement accessible depuis PowerAMC et peut également être consulté et en partie administré par le biais d'un Explorateur Web. 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. La majorité des utilisateurs du référentiel peuvent effectuer les opérations suivantes : Parcourir le référentiel et y effectuer des recherches (voir Parcourir le référentiel via le Web à la page 30 et Chapitre 3, Parcourir le référentiel via le Web à la page 65) Ajouter et mettre à jour des documents dan le référentiel (voir Consolidation de documents dans le référentiel à la page 11) Extraire des documents du référentiel pour les consulter ou les éditer (voir Extraction de documents du référentiel à la page 21), et peuvent aussi : Créer des versions pour garder un historique du processus de développement (voir Gel de versions de document à la page 41) Verrouiller des versions de document afin de les protéger temporairement de toute modification par d'autres utilisateurs (voir Verrouillage de versions de document à la page 43) Les utilisateurs plus avancés peuvent avoir des droits supplémentaires permettant de : Créer de versions de document afin de marquer ces étapes particulières dans le processus de développement (voir Regroupement de versions de document dans une configuration à la page 46) Créer des branches dans l'arborescence du référentiel (voir Création d'arborescences de versions à la page 49) Les administrateurs peuvent être responsables des tâches suivantes : Installer le référentiel et contrôler son accès (voir Création, mise à jour et suppression de la base de données du référentiel à la page 91 et Contrôle de l'accès au référentiel à l'aide de LDAP à la page 94) Ajouter des fichiers de ressources et gérer leur partage (voir Partage de ressources dans le référentiel à la page 56) Utilisation du référentiel 1

Gérer les droits et les permissions dans le référentiel (voir Contrôle des droits des utilisateurs et des groupes de référentiel à la page 98 et Contrôle des permission des éléments du référentiel à la page 107 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 à l'aide d'un explorateur Web (via 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, les postes de travail se connectent à la base de données de référentiel de différentes façons : 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 65 Connexion directe voir Configuration de PowerAMC pour un accès direct à la page 3 2 PowerAMC

Chapitre 1 : Introduction au référentiel 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 5 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 Pour créer une définition de référentiel avec un accès direct, 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 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. Si votre administrateur a installé le proxy de référentiel, reportez-vous à la section Configuration de PowerAMC pour un accès via le proxy à la page 5. 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 91), 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 : 5. Sélectionnez l'une des options suivantes : Source de données ODBC machine Utilisation du référentiel 3

Source de données ODBC fichier Profil de connexion (pour les connexion native, JDBC, ADO.NET, OLE DB ou DirectConnect ) Utilisez 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 : 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. Ces valeurs prennent en compte la casse des caractères et sont facultatives, mais 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. La zone de mot passe affiche systématiquement des astérisques, même si aucun mot de passe n'a été saisi. 4 PowerAMC

Chapitre 1 : Introduction au référentiel 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) 8. Testez la définition en cliquant sur le bouton Tester. Une boîte de message vous indique si votre tentative de connexion aboutit ou échoue. 9. 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. Configuration de PowerAMC pour un accès via le proxy Pour créer une définition de référentiel utilisant un proxy, 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. Si vous utilisez une connexion directe, voir Configuration de PowerAMC pour un accès direct à la page 3. 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 : Utilisation du référentiel 5

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. 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. Ces valeurs prennent en compte la casse des caractères et sont facultatives, mais 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. La zone de mot passe affiche systématiquement des astérisques, même si aucun mot de passe n'a été saisi. 5. Testez la définition en cliquant sur le bouton Tester. Une boîte de message vous indique si votre tentative de connexion aboutit ou échoue. 6. Cliquez sur OK pour revenir à la liste des définitions de référentiel. Connexion à un référentiel Avant de pouvoir vous connecter à un référentiel, ce dernier doit être créé sur un serveur (par votre administrateur), et vous devez avoir créé une définition de référentiel. 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 2. 1. Sélectionnez Référentiel > Connecter pour afficher la boîte de dialogue Connexion. 2. Sélectionnez le nom d'un référentiel afin d'afficher ses paramètres de connexion. 6 PowerAMC

Chapitre 1 : Introduction au référentiel 3. Cliquez sur OK pour établir la connexion. Le contenu du référentiel est affiché dans l'onglet Référentiel de l'explorateur d'objets. Le noeud racine affiche le nom du référentiel, le nom de connexion et la branche courante (voir Création d'arborescences de versions à la page 49. Connexion automatique au référentiel par défaut Vous pouvez spécifier que vous souhaitez vous connecter automatiquement à un référentiel chaque fois que vous ouvrez PowerAMC. A l'ouverture, PowerAMC va tenter de se connecter au dernier référentiel auquel vous vous êtes connecté. 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. Pour plus d'informations sur les autres options de cet onglet, voir Options générales du référentiel à la page 9. Changement de votre mot de passe pour le référentiel Vous pouvez changer à tout moment 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 votre ancien et votre nouveau mot de passe et confirmez votre nouveau mot de passe. Utilisation du référentiel 7

3. Cliquez sur OK pour faire prendre en compte le changement. Remarque : Un administrateur peut changer le mot de passe pour le compte d'un utilisateur. Pour ce faire, il lui suffit de sélectionner Référentiel > Administration > Utilisateurs et de double-cliquer sur un utilisateur dans liste afin d'afficher sa feuille de propriétés et de 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. 2. Cliquez sur Oui pour fermer la connexion. 8 PowerAMC

Chapitre 1 : Introduction au référentiel Options générales 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 Description Connexion automatique Nbre par défaut d'octets par car. Etablit automatiquement la connexion avec le dernier référentiel lorsque vous lancez PowerAMC. Spécifie le nombre par défaut d'octets par caractère utilisé dans la base de données du référentiel. Cette valeur est utilisée pour initialiser le paramètres Octets par caract. dans la boîte de dialogue Définition de référentiel directe (voir Configuration de PowerAMC pour un accès direct à la page 3). Explorateur Les options suivantes sont disponibles dans la zone de groupe Explorateur : Option Description Actualisation auto Afficher Afficher le contenu des modèles Afficher les numéros de version Afficher les icônes d'état dans l'onglet Local de l'explorateur d'objets Met à jour l'affichage de l'onglet Référentiel de l'explorateur d'objets à la fréquence définie dans la zone Actualiser toutes les. Spécifie si le nom ou le code des éléments est affiché dans l'onglet Référentiel de l'explorateur d'objets. Active l'affichage des diagrammes et objets de modèle dans l'onglet Référentiel de l'explorateur d'objets. Active l'affichage du numéro de version des éléments dans l'onglet Référentiel de l'explorateur d'objets. Active l'affichage des icônes d'état (qui identifient les éléments verrouillés et permettent de savoir si des modifications ont été effectuées en local ou dans le référentiel depuis l'extraction) dans l'onglet Local de l'explorateur d'objets (voir Vérification de l'état d'un document à la page 28). Extraction Les options suivantes sont disponibles dans la zone de groupe Extraction : Utilisation du référentiel 9

Option Fusionner le document Ajouter à l'espace de travail Extraire les dépendances Mettre à jour les ressources automatiquement Description 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 56). 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 pour l'explorateur Web 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 pour l'explorateur Web est cochée par défaut dans la fenêtre de consolidation. 10 PowerAMC

Chapitre 2 Gestion des documents dans le référentiel En fonction des droits et des permissions dont ils disposent, les utilisateurs du référentiel peuvent consolider et extraire un projet, un modèle et des documents et peuvent être en mesure de créer des configurations et des branches, mais aussi d'effectuer d'autres opérations sur le contenu du référentiel. Remarque : Vous devez disposer au moins de la permission Lecture pour extraire un document, et au moins de la permission Ecriture pour consolider un document (voir Contrôle des permission des éléments du référentiel à la page 107). Consolidation de documents dans le référentiel Vous consolidez des documents dans le référentiel afin de les partager avec d'autres. Vous devez disposer au moins de la permission Ecriture sur un document (ou sur l'un de ses packages) pour être en mesure de le consolider. 1. Sélectionnez les documents à consolider dans l'onglet Local de l'explorateur d'objet, puis cliquez le bouton droit de la souris et sélectionnez Consolider pour afficher la : Fenêtre Consolidation d'un projet - si vous avez sélectionné un projet (voir Consolidation d'un projet à la page 12). Fenêtre Consolidation d'un document - si vous avez sélectionné un seul modèle ou fichier (voir Consolidation d'un document à la page 13). Fenêtre Consolidation de plusieurs documents - si vous avez sélectionné plusieurs fichiers, la racine de l'espace de travail ou un dossier contenant plusieurs fichiers (voir Consolidation de plusieurs documents à la page 14). 2. Sélectionnez les paramètres appropriés (voir Paramètres de consolidation à la page 16), puis cliquez sur OK afin de consolider le document. 3. Si vous consolidez un document qui est déjà stocké dans le référentiel, la boîte de dialogue Fusion des modifications dans un document de référentiel (voir Résolution des conflits lors de la consolidation à la page 18) peut s'afficher pour vous permettre de passer en revue les différences entre votre document local et la version contenue dans le référentiel. Lorsque vous êtes satisfait, cliquez sur OK pour finaliser la consolidation. Remarque : Si vous changez de cible (SGBD, langages OO, etc) pour une cible n'appartenant pas à la même famille (contrairement à ce qui se passe quand vous passez de AS IQ 12.6 à 12.7), vous ne pouvez plus mettre à jour le document de référentiel et devez enregistrer le modèle à un nouvel emplacement dans le référentiel. Utilisation du référentiel 11

Consolidation d'un projet La boîte de dialogue Consolidation d'un projet vous aider à consolider un projet PowerAMC avec les modèles et autres documents qu'il contient. Pour afficher cette boîte de dialogue, pointez sur un projet dans l'onglet Local de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Consolider. La boîte de dialogue contient tous les documents de projet modifiés. La première fois que vous consolidez un projet, vous devez consolider tous ses documents ; par la suite, seuls les documents modifiés sont répertoriés et peuvent être désélectionnés si vous le souhaitez. Pour plus d'informations sur les paramètres disponibles dans cette boîte de dialogue, voir Paramètres de consolidation à la page 16. 12 PowerAMC

Chapitre 2 : Gestion des documents dans le référentiel Consolidation d'un document La boîte de dialogue Consolidation d'un document vous aide à effectuer les opération nécessaires à la consolidation d'un modèle PowerAMC ou d'un autre type de document. Pour afficher cette boîte de dialogue, vous pouvez procéder de l'une des façons suivantes : Pointez sur un modèle ou fichier dans l'onglet Local de l'explorateur d'objets, puis sélectionnez Consolider. Sélectionnez un modèle ou un fichier dans la boîte de dialogue Consolidation de plusieurs documents (voir Consolidation de plusieurs documents à la page 14), puis cliquez sur l'outil Réglages. Cliquez sur l'outil Ajouter un document dans la fenêtre Consolidation de plusieurs documents (voir Consolidation de plusieurs documents à la page 14). Vous devez spécifier le modèle ou le fichier à consolider dans la zone de groupe Document local. Sélectionnez un fichier de ressources, puis cliquez sur l'outil Consolider dans la liste des fichiers de ressources (voir Consolidation des ressources à partager dans le référentiel à la page 59). En fonction du contexte, cette fenêtre peut prendre diverses formes : Simplifiée - Lorsque vous consolidez un document pour la première fois (sélectionnez le dossier dans lequel consolider, saisissez un commentaire, puis cliquez sur OK) : Simplifiée - Lorsque vous consolidez des mises à jour dans un document figurant déjà dans le référentiel (choisissez si vous souhaitez ou non passer en revue les changements (voir Résolution des conflits lors de la consolidation à la page 18), saisissez un commentaire, puis cliquez sur OK) : Utilisation du référentiel 13

Avancée - Lorsque vous cliquez sur le bouton Avancée sur l'une ou l'autre des boîtes de dialogue simplifiées : Pour plus d'informations sur les paramètres disponibles dans cette boîte de dialogue, voir Paramètres de consolidation à la page 16. Consolidation de plusieurs documents La boîte de dialogue Consolidation de plusieurs documents est utilisée lors vous sélectionnez plusieurs documents pour la consolidation. Pour afficher cette boîte de dialogue, 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 documents (ou bien sélectionnez manuellement plusieurs documents) dans l'onglet Local de l'explorateur d'objets, puis sélectionnez Consolider. Sélectionnez Référentiel > Consolider (ou appuyez sur pressing Ctrl+Alt+C). 14 PowerAMC

Chapitre 2 : Gestion des documents dans le référentiel Les outils suivants sont disponibles pour gérer les documents dans la liste : Outil Description Réglages Affiche la fenêtre Consolidation d'un document afin de vous permettre de spécifier les paramètres de consolidation pour le document sélectionné (voir Consolidation d'un document à la page 13). Ajouter un document - Affiche la fenêtre Consolidation d'un document afin de vous permettre de spécifier un document à ajouter à la liste (voir Consolidation d'un document à la page 13). 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 contenus dans l'espace de travail (y compris les documents fermés). 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. 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 Résolution des conflits lors de la consolidation à la page 18). Déplacer vers le haut Déplace le document sélectionné vers le haut de la liste. Utilisation du référentiel 15

Outil Description Déplacer vers le base - Déplace le document sélectionné vers le bas de la liste. 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 [pas pour les projets] 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. 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 pour afficher sa feuille de propriétés. Nom d'un fichier et d'un chemin d'accès - cliquez sur l'outil Parcourir 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] Met à jour la version locale après la consolidation en extrayant la version du référentiel afin de faire en sorte que vous disposiez de la version la plus à jour sur laquelle plusieurs utilisateurs peuvent être en train de travailler simultanément. [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 : 16 PowerAMC

Chapitre 2 : Gestion des documents dans le référentiel Paramètre Description Mode Spécifie la forme de consolidation. Vous pouvez choisir : Nouveau - [toujours disponible] Si le document ne se trouve pas encore dans le référentiel, ou pas encore dans la branche courante (voir Création d'arborescences de versions à la page 49), ou si vous souhaitez le consolider à un nouvel emplacement dans la branche courante. Mise à jour/branche Ces modes sont mutuellement exclusifs et l'un d'entre eux est toujours sélectionné par défaut si le document existe déjà dans la branche courante ou dans une de ses branches de base. Les champs Projet, Dossier, Nom et Version sont en lecture seule : Mise à jour - Met à jour le document dans la branche courante ou crée une nouvelle version dans la branche courante si le document a été extrait à partir d'une branche de base de la branche courante. Branche - Crée la première version du document dans la branche courante. Intégrer [toujours disponible] Si vous souhaitez fusionner le document dans une autre version dans une branche parallèle ou dans un document différent. Remarque : Chaque consolidation est traité comme une transaction. Si vous consolidez dans de grands modèles en utilisant le mode Nouveau, le serveur va créer des journaux d'annulation volumineux, et utilise un grand nombre de verrous ; vous pouvez être amené à configurer votre serveur afin de permettre de telles transactions importantes. Les autres modes font appel à des transaction plus petites. Pour obtenir des exemples d'utilisation des modes de consolidation, voir Consolidation d'un document à l'aide des modes Mise à jour, Branche et intégrer à la page 53) Dossier/Projet [en lecture seule, sauf en mode Nouveau] Spécifie l'emplacement auquel le document sera consolidé. Cliquez sur l'outil Propriétés pour afficher la feuille de propriétés du dossier. Si vous ne spécifiez pas de dossier cible, le document est consolidé à la racine de l'explorateur d'objets. Vous devez octroyer des permissions d'accès individuelles à ce document. Nom Version [pas pour les projets en lecture seule, sauf en mode Intégrer] Spécifie le nom du document auquel les modifications doivent être appliquées. Cliquez sur l'outil Propriétés pour afficher la feuille de propriétés du document. [pas pour les projets en lecture seule, sauf en mode Intégrer] Spécifie la version du document à laquelle appliquer vos modifications. Utilisation du référentiel 17

Paramètre Commentaire Geler avant la consolidation Geler après la consolidation Créer une version de référence Déverrouiller après la consolidation Enregistrer les diagrammes pour l'explorateur Web Description Spécifie un commentaire pour décrire l'objet de la consolidation. Gèle les versions précédentes de tous les objets modifiés dans le référentiel, et crée une nouvelle version pour accepter les modifications à consolider (voir Gel de versions de document à la page 41). Gèle les versions de tous les objets modifiés après la consolidation pour faire en sorte que plus aucune modification ne puisse leur être apportée. Si vous modifiez par la suite les objets, vous créez de nouvelles versions (voir Gel de versions de document à la page 41). Crée une version entièrement nouvelle du modèle, au lieu de créer des versions des objets qui ont été modifiés. Ce option n'est disponible que si vous disposez d'une permission Totale sur le document. La boîte de dialogue Fusion de modifications dans le référentiel n'est pas affichée. Les versions de référence peuvent être plus rapides à consolider et extraire, mais elles requièrent beaucoup plus d'espace disque que les versions standard. Le serveur va créer des journaux d'annulation volumineux, et utilise un grand nombre de verrous, ce qui peut vous obliger à le configurer afin qu'il permette de telles transactions importantes. Il peut arriver que le référentiel ne soit pas en mesure de traiter une version standard, auquel cas vous devez tenter de créer une version de référence. Celle-ci peut alors être utilisée comme point de départ pour une nouvelle étape de développement. [documents verrouillés uniquement] Déverrouille la version de document après la consolidation (voir Verrouillage de versions de document à la page 43). [pas pour les ressources] Prépare 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 65). 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 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. Résolution des conflits lors de la consolidation La boîte de dialogue Fusionner les modifications dans le document du référentiel permet de passer en revue et d'approuver (ou rejeter) toutes les modifications que vous consolidez dans le 18 PowerAMC

Chapitre 2 : Gestion des documents dans le référentiel référentiel. Pour filtrer l'arborescence et n'afficher que les modifications, cliquez sur l'outil Modifier le filtre puis sélectionnez Afficher tous les changements. Par défaut, toutes vos modifications sont sélectionnées pour application. La fenêtre est divisée en trois parties : Le Volet de comparaison d'objet situé dans la partie supérieure de la fenêtre affiche par anticipation le résultat de la fusion sur le modèle cible. Cliquez sur le bouton Afficher le modèle source dans l'angle supérieur gauche du volet pour scinder le volet entre les modèles source et cible. Le volet de comparaison des propriétés situé dans la partie centrale de la fenêtre affiche les propriétés des noeuds sélectionnés dans l'arborescence de modèle, listant le nom des propriétés et ses valeurs pour les modèle De et Vers. Le volet de commentaires de consolidation permet d'éditer le commentaire qui sera associé à cette consolidation. Pour plus d'informations sur l'utilisation de cette boîte de dialogue, voir le chapitre 7, Comparaison et fusion de modèles du Guide des fonctionnalités générales. Vous pouvez demander à PowerAMC de gérer lui-même tout ou partie des conflits (et donc supprimer l'affichage de la boîte de dialogue de fusion en décochant la case Examiner les modifications dans la fenêtre Consolidation d'un document simplifiée ou dans la boîte de Utilisation du référentiel 19

dialogue Options de consolidation, que vous pouvez afficher en procédant de l'une des façons suivantes : Cliquez sur le bouton Options en bas de la boîte de dialogue Consolidation d'un document avancée. Cliquez sur l'outil Options de consolidation dans la boîte de dialogue Consolidation d'un projet ou Consolidation de plusieurs documents. Les options spécifiées seront appliquées à tous les modèles et les fichiers consolidées. Les modes suivants sont disponibles : Interactif - [valeur par défaut] Affiche systématiquement la boîte de dialogue Fusion des modifications dans le document du référentiel pour vous permettre de passer en revue et d'approuver ou de rejeter chaque modification avant la consolidation Par lot - Automatise la fusion des modifications et traite les conflits (lorsque le même objet est modifié par vous et par un autre utilisateur) en utilisant l'une des règles suivantes : Utiliser mes modifications - applique vos modifications et écrase celles effectuées dans la version du référentiel (même si elles s'appliquent à d'autres attributs). Conserver les modifications du référentiel conserve les modifications du référentiel et rejette les vôtres (même si elles s'appliquent à d'autres attributs). Résoudre manuellement affiche la boîte de dialogue Fusion des modifications dans le document du référentiel pour vous permettre de passer en revue et de résoudre les conflits. 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. 20 PowerAMC

Chapitre 2 : Gestion des documents dans le référentiel Pour plus d'informations sur l'extraction des packages, voir Extraction de packages à la page 27. 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 à 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 41), une telle suppression n'est pas toujours possible. Extraction de documents du référentiel Vous extrayez des documents du référentiel afin de travailler sur ces documents dans votre espace de travail local. Vous devez disposer au moins de la permission Lecture sur un document (ou sur l'un de ses packages) pour être en mesure de l'extraire 1. Pour extraire un document qui ne se trouve pas déjà dans votre espace de travail, sélectionnez l'onglet Référentiel de l'explorateur d'objets. Si vous mettez à jour un fichier existant, sélectionnez l'onglet Local. 2. Sélectionnez les documents à extraire, cliquez le bouton droit de la souris, puis sélectionnez Extraire pour afficher la : Fenêtre Extraction d'un projet - si vous avez sélectionné un projet (voir Extraction d'un projet à la page 22). Fenêtre Extraction d'un document - si vous avez sélectionné un seul modèle ou fichier (voir Extraction d'un document à la page 22). Fenêtre Extraction de plusieurs documents - si vous avez sélectionné plusieurs fichiers, la racine de l'espace de travail ou un dossier contenant plusieurs fichiers (voir Extraction de plusieurs documents à la page 23). 3. Sélectionnez les paramètres appropriés (voir Paramètres d'extraction à la page 25), puis cliquez sur OK afin d'extraire le document. 4. Si vous extrayez un document déjà présent dans votre espace de travail (et si vous avez sélectionné l'option Fusionner le document), la fenêtre Extraction d'un document (voir Résolution des conflits lors de l'extraction à la page 26) s'affiche pour vous permettre de Utilisation du référentiel 21

visualiser les différences entre la version du référentiel et votre version locale. Lorsque vous êtes satisfait, cliquez sur OK pour terminer l'extraction. Extraction d'un projet La boîte de dialogue Extraction d'un project vous aide à extraire un projet de modélisation PowerAMC avec tous les modèles et autres documents qu'il contient. Vous pouvez afficher cette boîte de dialogue de l'une des façons suivantes : Pointez sur un projet dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris, puis sélectionnez Extraire. Pointez sur un projet 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. Pour plus d'informations sur les paramètres disponibles dans cette boîte de dialogue, voir Paramètres d'extraction à la page 25. Extraction d'un document La boîte de dialogue Extraction d'un document vous aide à extraire un modèle PowerAMC ou un autre type de document. Vous pouvez afficher cette boîte de dialogue de l'une des façons suivantes : 22 PowerAMC

Chapitre 2 : Gestion des documents dans le référentiel Pointez sur un modèle ou sur un fichier dans l'onglet Référentiel de l'explorateur d'objets, cliquez le bouton droit de la souris et sélectionnez Extraire. 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 et sélectionnez Mettre à jour à partir du référentiel. Sélectionnez un modèle ou un fichier dans la fenêtre Extraction de plusieurs documents (voir Extraction de plusieurs documents à la page 23) et cliquez sur l'outil Réglages. Cliquez sur l'outil Ajouter un document dans la fenêtre Extraction de plusieurs documents (voir Extraction de plusieurs documents à la page 23). Vous devez spécifier le modèle ou fichier à extraire dans la zone de groupe Document local. Sélectionnez un fichier de ressources, puis cliquez sur l'outil Mettre à jour à partir du référentiel dans une liste de fichiers de ressources. Pour plus d'informations sur les paramètres disponibles dans cette boîte de dialogue, voir Paramètres d'extraction à la page 25. Extraction de plusieurs documents La boîte de dialogue Extraction de plusieurs documents permet de sélectionner plusieurs documents à extraire simultanément. Vous pouvez afficher cette boîte de dialogue de l'une des façons suivantes : Pointez sur la racine de l'espace de travail ou sur un dossier contenant plusieurs documents (ou bien sélectionnez manuellement plusieurs documents) dans l'onglet Référentiel 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 documents (ou bien sélectionnez manuellement plusieurs documents) 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. Utilisation du référentiel 23

Sélectionnez Référentiel > Extraire (ou 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 afin de vous permettre de spécifier les paramètres d'extraction pour le document sélectionné (voir Extraction d'un document à la page 22). Ajouter une version de document - Affiche la fenêtre Extraction d'un document pour vous permettre de sélectionner un document à ajouter à la liste d'extraction (voir Extraction d'un document à la page 22). 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. 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 (voir Regroupement de versions de document dans une configuration à la page 46). 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. 24 PowerAMC

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 Regroupement de versions de document dans une configuration à la page 46. [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 38. 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 25