Référentiels

La page Référentiels vous permet d’effectuer diverses tâches administratives sur vos référentiels, tels que leur création, suppression et modification, ainsi que l’import et l’export de modèles, objets, référentiels et paquets de migration.

Qu’est-ce qu’un référentiel ?

Les référentiels sont une forme particulière d'archivage des informations dans les bases de données. Chaque référentiel est un espace distinct et délimité dans la base de données, dans lequel sont par exemple stockés des modèles et des objets qui sont liés. Les référentiels sont toujours liés à des librairies dans la même base de données, dans lesquelles les types de contenu disponibles sont définis. Une librairie peut avoir plusieurs référentiels indépendants les uns des autres.

Lors de la création de l’accès de l'utilisateur, chaque utilisateur ADOIT se voit attribuer (au moins) un référentiel. Il s'agit de son environnement de travail dans la base de données, dans lequel des modèles sont créés et stockés, des objets sont créés et réutilisés, des analyses sont effectuées, etc. Au démarrage d'ADOIT, le référentiel correspondant est automatiquement initialisé et mis à la disposition de l’utilisateur.

Créer un nouveau référentiel

Pour attribuer un nouveau référentiel à une librairie :

1. Allez sur la page des Référentiels, puis cliquez sur Créer.

2. Dans la case Entrer le nom du référentiel, tapez un nom pour le référentiel, puis cliquez sur Créer.

Le référentiel est créé dans la base de données et assigné à la librairie.

Info

Un utilisateur (administrateur) qui crée un nouveau référentiel obtient automatiquement des droits d’accès à ce nouveau référentiel.

Verrouiller ou déverrouiller le référentiel

De temps à autre, des tâches de maintenance doivent être effectuées sur un référentiel, par exemple la suppression de modèles obsolètes ou la réalisation d’une sauvegarde. Dans ce cas, il est recommandé de verrouiller le référentiel avant de commencer la maintenance et de le déverrouiller une fois celle-ci terminée. Un référentiel verrouillé ne peut être utilisé par aucun utilisateur – la connexion à ce référentiel n’est plus possible. Un statut incohérent de la base de données pendant la maintenance peut donc être évité.

Pour verrouiller ou déverrouiller un référentiel :

• Allez sur la page des Référentiels.

• Dans la liste, cherchez le référentiel souhaité.

• Cliquez sur Verrouiller le référentiel ou Déverrouiller le référentiel. Lorsque vous êtes invité à continuer, cliquez sur Oui.

Remarque

Un référentiel ne peut être verrouillé que lorsqu’aucun autre utilisateur ne travaille actuellement avec ce référentiel. Sinon, un message d’erreur apparaît.

Renommer le référentiel

Pour renommer un référentiel existant :

1. Allez sur la page des Référentiels.

2. Dans la liste, cherchez le référentiel souhaité.

3. À droite du référentiel, cliquez sur Plus, puis sur Renommer le référentiel.

4. Tapez le nouveau nom du référentiel, puis cliquez sur Renommer.

Supprimer le référentiel

Pour supprimer un référentiel qui n’est plus utilisé :

1. Allez sur la page des Référentiels.

2. Dans la liste, cherchez le référentiel souhaité.

3. À droite du référentiel, cliquez sur Plus, puis sur Supprimer le référentiel. Lorsque vous êtes invité à continuer, cliquez sur Oui. Le référentiel et son contenu entier sont supprimés de la base de données.

Remarque

Un référentiel ne peut être supprimé que lorsqu’aucun autre utilisateur ne travaille actuellement avec ce référentiel.

Attention

Soyez prudent lors de la suppression de référentiels, car leur contenu complet (modèles, objets, autres informations) ne peut pas être restauré.

Copier l’identifiant du référentiel

Pour copier l’identifiant d’un référentiel dans le presse-papiers :

1. Allez sur la page des Référentiels.

2. Dans la liste, cherchez le référentiel souhaité.

3. À droite du référentiel, cliquez sur Plus, puis sur Copier l’identifiant dans le presse-papiers.

Un message de confirmation s’affiche. Fermez le message pour terminer le processus.

Afficher l’utilisation du référentiel

Pour voir qui utilise ou verrouille actuellement un référentiel :

• Allez sur la page des Référentiels.

• Dans la liste, cherchez le référentiel souhaité.

• À droite du référentiel, cliquez sur Plus, puis sur Utilisation.

Un aperçu de l’utilisation du référentiel apparaît.

Utilisation du référentiel

Les informations suivantes sont présentées :

• Edité actuellement par: Contient une liste de tous les utilisateurs actuellement connectés au référentiel sélectionné.

• Bloqué actuellement par: Si le référentiel a été verrouillé par un utilisateur, le nom de l’utilisateur est affiché ici.

Importer des modèles ou des objets

Pour importer des modèles ou des objets :

1. Cliquez sur Référentiels > Plus d’options, puis sur Importer des modèles ou des objets.

2. Sélectionnez soit Modèles, soit Objets, selon ce que vous souhaitez importer.

3. Cliquez sur Parcourir et sélectionnez le fichier que vous souhaitez importer. Vous pouvez également faire glisser un fichier de votre ordinateur vers la zone Faites glisser et déposez des fichiers ici pour les télécharger.

4. Attendez que le téléchargement soit terminé. Si le fichier importé est chiffré, saisissez le mot de passe et cliquez sur OK. Cliquez sur Suivant.

5. Sélectionnez les éléments que vous souhaitez importer, puis sélectionnez le groupe cible pour l’import. Vous devez également spécifier les options suivantes :

   • Sélectionnez Inclure les groupes et modèles sous-jacents ou Inclure les groupes d’objets et les objets sous-jacents pour inclure toute la hiérarchie sous un groupe sélectionné dans le fichier importé, pas seulement le niveau sélectionné.

   • Sélectionnez Fusionner les groupes déplacés lorsque vous importez une sauvegarde, certains groupes ont été déplacés ailleurs entre-temps. Les groupes et tous les artefacts contenus seront fusionnés au nouvel emplacement (artefacts selon la stratégie de conflit choisie). Lorsque cette option est désactivée, les groupes importés sont créés à l’ancien emplacement. Les artefacts contenus seront fusionnés au nouvel emplacement s’ils existent dans les deux groupes, ou créés à l’ancien emplacement s’ils n’existent que dans les groupes importés.

   Ensuite, cliquez sur Suivant.

6. Dans la liste Stratégie en cas de conflit, si un modèle ou un objet du fichier existe déjà dans le référentiel choisissez le comportement à adopter si un modèle ou un objet existe déjà :

   • Ajouter (Des nouvelles données sont ajoutées. Les données existantes seront écrasées, si nécessaire) : insère le modèle ou l’objet importé, combinant les informations des deux sources.

   • Insérer (Comme ci-dessus ; y compris la résolution des conflits de circuit de validation si un élément existe déjà) : Comme ci-dessus, mais ADOIT vérifie en plus si le contenu du fichier importé compromet l’intégrité d’un circuit de validation (sélection par défaut).

   • Écraser (Le modèle/objet du fichier importé remplace celui de la base de données) : Écrase le modèle ou l’objet dans la base de données.

   • Ignorer (Le modèle/objet dans la base de données reste intact) : Ignore les données dans le fichier importé, préservant le modèle ou l’objet d’origine.

   Remarque

   Insérer (Comme ci-dessus ; y compris la résolution de conflits de circuit de validation si un élément existe déjà) n’est disponible que si un circuit de validation est activé et doit toujours être utilisé à la place de Insérer (de nouvelles données seront ajoutées. Option: Les données existantes seront écrasées, si nécessaire). Utilisez Insérer (De nouvelles données seront ajoutées. Les données existantes seront écrasées, si nécessaire) uniquement si un employé de BOC le demande.

7. Optionnel : Sélectionnez Importer depuis une autre librairie afin que ADOIT vérifie si le contenu du fichier importé provient de la même version de la librairie existante. Activez cette option si vous n’êtes pas sûr. Si vous sélectionnez cette option, vous devez également spécifier l’option suivante :

   • Sélectionnez Importer le mapping du métamodèle depuis le fichier si les éléments du métamodèle dans le fichier importé (modèle, objet, relation et types de point de terminaison ainsi que leurs propriétés) ne correspondent pas parfaitement aux éléments de métamodèle de la librairie utilisée. Cela vous permet d’importer un fichier de correspondance de métamodèle avec l’attribution d’éléments importés aux éléments de la librairie que vous avez reçus de votre consultant ADOIT.

8. Cliquez sur Importer. Les données sont importées.

Une fois l’import terminée, un message de confirmation s’affiche. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l’import. Fermez le message pour terminer le processus.

Importer le référentiel

Cette procédure vous permet d’importer un référentiel complet et les informations qu’il contient dans la base de données d'ADOIT.

Pour importer un référentiel :

1. Cliquez sur Référentiels > Plus d’options, puis sur Importer le référentiel.

2. Cliquez sur Parcourir et sélectionnez le fichier du référentiel que vous souhaitez importer. Vous pouvez également faire glisser un fichier de votre ordinateur vers la zone Faites glisser et déposez des fichiers ici pour les télécharger.

3. Attendez que le téléchargement soit terminé. Ensuite, cliquez sur Suivant.

4. Sélectionnez l’une des options suivantes :

   • Importer en tant que nouveau référentiel dans la librairie « <nom de la librairie> » pour importer le fichier en tant que nouveau référentiel.

   • Insérer dans le référentiel actif « <nom du référentiel >" pour importer les données dans votre référentiel actif. Si vous sélectionnez cette option, vous devez également spécifier les options suivantes :

     • Sélectionnez Résoudre des conflits de circuit de validation si un élément existe déjà afin que ADOIT vérifie si le contenu du fichier importé compromet l’intégrité d’un circuit de validation. Disponible uniquement si un circuit de validation est activé. Cochez cette case uniquement si un employé de BOC le demande.

     • Sélectionnez Fusionner les groupes déplacés lorsque vous importez une sauvegarde, certains groupes ont été déplacés ailleurs entre-temps. Les groupes et tous les artefacts contenus seront fusionnés au nouvel emplacement. Lorsque cette option est désactivée, les groupes importés sont créés à l’ancien emplacement. Les artefacts contenus seront fusionnés au nouvel emplacement s’ils existent dans les deux groupes, ou créés à l’ancien emplacement s’ils n’existent que dans les groupes importés.

5. Optionnel : Sélectionnez Importer le mapping du métamodèle depuis le fichier si les éléments du métamodèle dans le fichier importé (types de modèle, d’objet, de relation et de point de terminaison ainsi que leurs propriétés) ne correspondent pas parfaitement aux éléments du métamodèle dans la librairie utilisée. Cela vous permet d’importer un fichier de correspondance de métamodèle avec l’attribution d’éléments importés aux éléments de la librairie que vous avez reçus de votre consultant ADOIT.

6. Cliquez sur Importer. Lorsque vous êtes invité à continuer, cliquez sur Oui. Si le fichier importé est chiffré, saisissez le mot de passe et cliquez sur OK. Les données sont importées.

Une fois l’import terminée, un message de confirmation s’affiche. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l’import. Fermez le message pour terminer le processus.

Importer le paquet de migration

Cette procédure permet d’importer un paquet de migration qui a été enregistré dans un fichier AXR externe vers la base de données d'ADOIT.

Pour importer un paquet de migration :

1. Cliquez sur Référentiels > Plus d’options, puis sur Importer le paquet de migration.

2. Cliquez sur Parcourir et sélectionnez le fichier que vous souhaitez importer. Vous pouvez également faire glisser un fichier de votre ordinateur vers la zone Faites glisser et déposez des fichiers ici pour les télécharger.

3. Attendez que le téléchargement soit terminé. Ensuite, cliquez sur Suivant.

4. Sélectionnez l’une des options suivantes :

   • Importer en tant que nouveau référentiel dans la librairie « <nom de la librairie> » pour importer le fichier en tant que nouveau référentiel.

   • Insérer dans le référentiel actif « <nom du référentiel >" pour importer les données dans votre référentiel actif. Si vous sélectionnez cette option, vous devez également spécifier les options suivantes :

     • Sélectionnez Résoudre des conflits de circuit de validation si un élément existe déjà afin que ADOIT vérifie si le contenu du fichier importé compromet l’intégrité d’un circuit de validation. Disponible uniquement si un circuit de validation est activé. Cochez cette case uniquement si un employé de BOC le demande.

     • Sélectionnez Fusionner les groupes déplacés lorsque vous importez une sauvegarde, certains groupes ont été déplacés ailleurs entre-temps. Les groupes et tous les artefacts contenus seront fusionnés au nouvel emplacement. Lorsque cette option est désactivée, les groupes importés sont créés à l’ancien emplacement. Les artefacts contenus seront fusionnés au nouvel emplacement s’ils existent dans les deux groupes, ou créés à l’ancien emplacement s’ils n’existent que dans les groupes importés.

5. Optionnel : Sélectionnez Importer le mapping du métamodèle depuis le fichier si les éléments du métamodèle dans le fichier importé (types de modèle, d’objet, de relation et de point de terminaison ainsi que leurs propriétés) ne correspondent pas parfaitement aux éléments du métamodèle dans la librairie utilisée. Cela vous permet d’importer un fichier de correspondance de métamodèle avec l’attribution d’éléments importés aux éléments de la librairie que vous avez reçus de votre consultant ADOIT.

6. Cliquez sur Importer. Lorsque vous êtes invité à continuer, cliquez sur Oui. Si le fichier importé est chiffré, saisissez le mot de passe et cliquez sur OK. Les données sont importées.

Une fois l’import terminée, un message de confirmation s’affiche. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l’import. Fermez le message pour terminer le processus.

Importer un paquet de migration avec plusieurs référentiels

Pour importer un paquet de migration avec plusieurs référentiels :

1. Cliquez sur Référentiels > Plus d’options, puis cliquez sur Importer un paquet de migration avec plusieurs référentiels.

2. Cliquez sur Parcourir et sélectionnez le fichier que vous souhaitez importer. Vous pouvez également faire glisser un fichier de votre ordinateur vers la zone Faites glisser et déposez des fichiers ici pour les télécharger.

3. Attendez que le téléchargement soit terminé. Si le fichier importé est chiffré, saisissez le mot de passe et cliquez sur OK. Cliquez sur Suivant.

4. Sélectionnez les référentiels que vous souhaitez importer : Ensuite, cliquez sur Suivant.

5. Optionnel : Sélectionnez Importer le mapping du métamodèle depuis le fichier si les éléments du métamodèle dans le fichier importé (types de modèle, d’objet, de relation et de point de terminaison ainsi que leurs propriétés) ne correspondent pas parfaitement aux éléments du métamodèle dans la librairie utilisée. Cela vous permet d’importer un fichier de correspondance de métamodèle avec l’attribution d’éléments importés aux éléments de la librairie que vous avez reçus de votre consultant ADOIT.

6. Cliquez sur Importer. Lorsque vous êtes invité à continuer, cliquez sur Oui. Les données sont importées.

Une fois l’import terminée, un message de confirmation s’affiche. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l’import. Fermez le message pour terminer le processus.

Exporter des modèles ou des objets

Pour exporter des modèles ou des objets :

1. Cliquez sur Référentiels > Plus d’options, puis sur Exporter des modèles ou des objets.

2. Sélectionnez soit Modèles soit Objets, selon ce que vous souhaitez exporter. Cliquez sur Suivant.

3. Sélectionnez les éléments que vous souhaitez exporter. Ensuite, cliquez sur Suivant.

4. Dans la liste Filtre, sélectionnez si vous souhaitez exporter uniquement des modèles ou des objets, uniquement des groupes, ou les deux.

5. Optionnel : Sélectionnez Inclure les groupes de modèles et les modèles sous-jacents ou Inclure les groupes d’objets et les objets sous-jacents   pour inclure toute la hiérarchie sous un groupe sélectionné dans le fichier exporté, pas seulement le niveau sélectionné.

6. Si vous exportez des modèles, vous devez spécifier les options suivantes :

   • Optionnel : Sélectionnez Inclure tous les modèles sous-jacents (récursif) pour inclure tous les modèles sous-jacents référencés parmi les modèles sélectionnés (sans restriction de profondeur de référence). Les modèles sous-jacents sont reliés aux modèles sélectionnés via une classe de relation dont le paramètre sous-référence est activé.

     Remarque

     La case à cocher Inclure tous les modèles sous-jacents (récursif) n’est pas disponible si la librairie ne contient aucune classe de relation dont le paramètre sous-référence est activé.

   • Optionnel : Sélectionnez Inclure les modèles référencés pour inclure tous les modèles référencés parmi les modèles sélectionnés dans le fichier exporté.

7. Optionnel : Sélectionnez Inclure les objets référencés pour inclure tous les objets référencés à partir des modèles ou objets sélectionnés dans le fichier exporté.

8. Optionnel : Sélectionnez Protéger le fichier exporté par un mot de passe pour chiffrer le fichier.

9. Cliquez sur Exporter. Les données sont exportées.

Lorsque l’export est terminé, un message de réussite apparaît. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l'export. Fermez le message pour terminer le processus.

Exporter le référentiel

Pour des raisons de sauvegarde, un référentiel complet et les informations qu’il contient peuvent être exportés sous forme de fichier au format AXR.

Remarque

Lors de l’export d’un référentiel, tous les modèles, objets et leurs relations sont également exportés. De ce fait, c’est la variante privilégiée de l’échange de données entre des instances ADOIT car l’intégrité de toutes les relations est garantie.

Pour exporter le référentiel actif :

1. Cliquez sur Référentiels > Plus d’options, puis sur Exporter un référentiel.

2. Optionnel : Sélectionnez Protéger le fichier exporté par un mot de passe pour chiffrer le fichier.

3. Cliquez sur Exporter. Les données sont exportées.

Lorsque l’export est terminé, un message de réussite apparaît. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l'export. Fermez le message pour terminer le processus.

Exporter le paquet de migration

Un paquet de migration contient le référentiel (incluant tous les modèles et objets et leurs relations), les utilisateurs, les rôles système et les droits d’accès des utilisateurs définis.

Les référentiels, utilisateurs, rôles système et droits d'accès des utilisateurs peuvent également être exportés individuellement. Cependant, lors de la migration de toutes les données d'ADOIT vers une nouvelle version, l’export d’un paquet de migration est la variante préférée car elle évite les erreurs, garantit l’intégrité de toutes les relations et accélère le processus.

Pour exporter un paquet de migration :

1. Cliquez sur Référentiels > Plus d’options, puis sur Exporter le paquet de migration.

2. Optionnel : Sélectionnez Protéger le fichier exporté par un mot de passe pour chiffrer le fichier.

3. Cliquez sur Exporter. Les données sont exportées.

Lorsque l’export est terminé, un message de réussite apparaît. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l'export. Fermez le message pour terminer le processus.

Exporter un paquet de migration avec plusieurs référentiels

Si votre organisation travaille avec plusieurs référentiels, vous pouvez les exporter en une seule fois, ce qui évite les erreurs et réduit la complexité lors de la migration de toutes les données d'ADOIT vers une nouvelle version.

Pour exporter un paquet de migration avec plusieurs référentiels :

1. Cliquez sur Référentiels > Plus d’options, puis sur Exporter un paquet de migration avec plusieurs référentiels.

2. Sélectionnez les référentiels que vous souhaitez exporter. Ensuite, cliquez sur Suivant.

3. Optionnel : Sélectionnez Protéger le fichier exporté par un mot de passe pour chiffrer le fichier.

4. Cliquez sur Exporter. Les données sont exportées.

Lorsque l’export est terminé, un message de réussite apparaît. Vous pouvez télécharger un fichier Protocol avec des informations détaillées sur l'export. Fermez le message pour terminer le processus.