4.8 Importation, validation et déploiement des définitions de la couche d'abstraction de l'annuaire

L'importation, la validation et le déploiement des définitions de la couche d'abstraction de l'annuaire sont des actions qui s'effectuent dans la vue Provisioning du module Designer.

4.8.1 À propos de l'importation

La fonction d'importation permet d'importer un ensemble de définitions existantes. L'importation s'utilise lorsque :

Vous voulez commencer un nouveau projet basé sur un projet déployé.
Vous voulez partager des définitions avec d'autres développeurs travaillant sur le même projet. Par exemple, un autre développeur ajoute un attribut à l'entité utilisateur ou ajoute une nouvelle liste globale. Si le développeur déploie la nouvelle définition dans le coffre-fort d'identité, vous pouvez l'importer et vous assurer que vous travaillez tous les deux avec des définitions identiques.

Pour importer des définitions existantes :

Ouvrez la Vue Provisioning.
Déterminez si vous voulez importer :
- Un ensemble complet de définitions
- Un ensemble d'un type de définitions, par exemple, toutes les entités ou toutes les relations hiérarchiques.
- Un objet spécifique (par exemple, l'entité Utilisateur)
Pour importer :
- Un objet spécifique, sélectionnez-le dans la liste, cliquez avec le bouton droit, puis sélectionnez Importer un objet.
- Un ensemble complet de définitions, sélectionnez le noeud de la couche d'abstraction de l'annuaire, cliquez avec le bouton droit, puis sélectionnez Importer tout ou Importer un objet.
Cliquez sur l'icône Parcours d'une arborescence eDirectory, accédez au noeud DirectoryModel, sélectionnez le ou les objets à importer, puis cliquez sur OK.
- Si les objets correspondent, vous êtes notifié de l'absence de différences et l'importation ne se poursuit pas.
- Si les objets ne correspondent pas, vous pouvez confirmer les objets à importer. Vérifiez les éléments sélectionnés pour l'importation, apportez les modifications nécessaires, puis cliquez sur OK.

Définition des préférences d'importation

Les préférences d'importation permettent de spécifier comment vous voulez que le module Designer résolve les conflits entre les données du coffre-fort d'identité et vos fichiers locaux de la couche d'abstraction de l'annuaire. Ces conflits peuvent se produire du fait que plusieurs utilisateurs et outils différents ont accès aux définitions de la couche d'abstraction de l'annuaire du coffre-fort d'identité. Les définitions peuvent être modifiées par d'autres administrateurs ou développeurs en utilisant des outils d'iManager ou leur propre projet local basé sur le module Designer. Lorsque des conflits se produisent entre les définitions de votre système de fichiers local et le coffre-fort d'identité, ces préférences permettent de spécifier comment ils doivent être gérés.

Pour définir les préférences d'importation :

Choisissez Fenêtre > Préférences.
Ouvrez le noeud Provisioning de l'arborescence, puis cliquez sur Importer.

Choisissez les préférences :

Préférence	Description
L'objet externe modifié remplace l'objet local modifié	Le fichier local et les définitions du coffre-fort d'identité contiennent des modifications. Les modifications locales n'ont pas encore été déployées. Sélectionnez cette option si vous voulez que l'objet du coffre-fort d'identité remplace les modifications que vous avez apportées au fichier local.
La copie locale non modifiée est remplacée par l'objet recréé de façon externe	L'objet du coffre-fort d'identité a été supprimé, puis recréé. L'ensemble des fichiers locaux inclut la définition originale sans modification. Sélectionnez cette option si vous voulez que l'importation remplace la copie locale.
L'objet externe remplace l'objet local modifié	Le fichier local contient des modifications non déployées vers le coffre-fort d'identité. Sélectionnez cette option si vous voulez que les fichiers locaux soient remplacés à l'importation.
L'objet externe remplace l'objet local supprimé	Vous avez supprimé une définition localement, mais sans déployer les modifications. Cela signifie que l'objet existe toujours dans le coffre-fort d'identité. Sélectionnez cette option si vous voulez que les objets du coffre-fort d'identité soient copiés dans le système de fichiers local. Si vous choisissez cette option, vous perdez toutes les modifications non déployées.

4.8.2 À propos de la validation

Vous pouvez valider les définitions de données de la couche d'abstraction de l'annuaire sur le système de fichiers locaux avant de tenter de les déployer. La validation :

Vérifie que le XML est bien formé et respecte le schéma qui définit les éléments nécessaires aux entités, attributs, listes, relations, etc.
Vérifie chaque entité pour s'assurer que les références à d'autres entités et listes globales sont valides.

Par exemple, lors de la validation d'une entité et de ses attributs, le validateur vérifie que toutes les références aux autres entités via les champs Édition de l'entité, Recherche DN et Détail de l'entité font référence à des entités qui existent.

Vérifie que pour chaque entité un attribut au moins a été défini.
Vérifie que chaque liste locale et globale contient au moins un élément.

Vous pouvez valider des définitions de façon sélective dans la vue Provisioning. Pour valider :

Tous les éléments d'un noeud, sélectionnez-le, cliquez avec le bouton droit, puis sélectionnez Valider.
Un objet unique d'un noeud, sélectionnez l'objet, cliquez avec le bouton droit, puis sélectionnez Valider.

Vous pouvez valider toutes les définitions en cliquant sur le bouton Valider la couche d'abstraction de la barre d'outils de la couche d'abstraction de l'annuaire.

REMARQUE:La validation ne vérifie pas l'existence des objets dans le coffre-fort d'identité.

4.8.3 À propos du déploiement

Vous devez déployer vos définitions vers un coffre-fort d'identité avant d'afficher les modifications qui en résultent dans l'application utilisateur Identity Manager.

Pour déployer un ensemble de définitions vers un coffre-fort d'identité :

Enregistrez toutes les modifications que vous avez effectuées avec l'éditeur de couche d'abstraction de l'annuaire.

Si vous n'enregistrez pas vos modifications avant de tenter d'effectuer le déploiement, l'éditeur affiche une boîte de dialogue qui montre les définitions qui ne sont pas enregistrées. Elle vous invite à enregistrer les modifications les plus récentes. Si vous ne les enregistrez pas, l'objet est néanmoins déployé sur le serveur mais le déploiement n'inclut pas les modifications non enregistrées. Le choix de ne pas enregistrer les modifications n'annule pas le déploiement.
Ouvrez la Vue Provisioning.
Choisissez si vous voulez déployer tous les objets définis en utilisant l'éditeur de couche d'abstraction de l'annuaire ou un sous-ensemble.
- Pour tout déployer :
  Sélectionnez le noeud root, cliquez avec le bouton droit, puis sélectionnez Déployer tout.
- Pour déployer une entité, des relations, une liste ou des paramètres de configuration spécifiques :
  Sélectionnez-les, cliquez avec le bouton droit, puis sélectionnez Déployer l'objet.
Il se peut que les références du coffre-fort d'identité soient demandées. L'éditeur effectue une validation et affiche les messages de validation dans une boîte de dialogue. Répondez aux messages de validation en sélectionnant/désélectionnant les éléments à déployer. Après avoir effectué vos sélections de déploiement et les avoir soumises, vous êtes averti de son succès ou de son échec.

Définition des préférences de déploiement

Les préférences de déploiement permettent de spécifier comment vous voulez que le module Designer résolve les conflits entre les données du coffre-fort d'identité et vos fichiers locaux de la couche d'abstraction de l'annuaire. Des conflits peuvent se produire du fait que d'autres utilisateurs ont déployé des modifications vers le coffre-fort d'identité et que ces modifications n'apparaissent pas dans les définitions de votre système de fichiers local. Pour vous assurer que les conflits sont gérés selon vos souhaits, vous pouvez définir des préférences précisant le mode de résolution des conflits.

Pour définir les préférences de déploiement :

Choisissez Fenêtre > Préférences.
Ouvrez le noeud Provisioning de l'arborescence, puis cliquez sur Déployer.

Spécifiez les préférences générales de déploiement :

Préférence	Description
Définissez la suppression du coffre-fort d'identité par défaut pour toutes les boîtes de dialogue “Confirmer la suppression”	Si vous tentez de supprimer un objet de la vue Provisioning ou de l'éditeur de couche d'abstraction de l'annuaire, vous êtes invité à confirmer la suppression dans une boîte de dialogue qui ressemble à celle illustrée ci-dessous : Cette préférence détermine si la case de la boîte de dialogue de confirmation de suppression libellée Supprimer l'objet du coffre-fort d'identité lors du déploiement est sélectionnée par défaut. La sélection de cette préférence signifie que le paramètre par défaut consiste à toujours supprimer l'objet du coffre-fort d'identité. L'objet local est toujours supprimé.
Autoriser le déploiement d'objets avec des erreurs de validation	Sélectionné : sélectionnez cette option si vous voulez déployer des objets qui échouent à la validation. Lors du déploiement, le module Designer valide les définitions déployées en respectant les règles de validation définies à la Section 4.8, Importation, validation et déploiement des définitions de la couche d'abstraction de l'annuaire. Désélectionné : pour empêcher le déploiement des définitions qui échouent à la validation.
Autoriser le déploiement d'objets non modifiés qui remplacent une nouvelle version modifiée de façon externe	Sélectionné : si vos fichiers locaux n'ont pas été modifiés, mais si les objets du coffre-fort d'identité l'ont été. Voulez-vous que les fichiers locaux remplacent ceux du coffre-fort d'identité ? Si oui, sélectionnez cette préférence. Désélectionné : si vous voulez conserver les versions plus récentes du coffre-fort d'identité. Lorsque cette option est sélectionnée, vous pouvez définir ce comportement par défaut en sélectionnant également la préférence de résolution des conflits La copie locale non modifiée remplace la nouvelle version modifiée de façon externe.

Préférence

Description

Définissez la suppression du coffre-fort d'identité par défaut pour toutes les boîtes de dialogue “Confirmer la suppression”

Si vous tentez de supprimer un objet de la vue Provisioning ou de l'éditeur de couche d'abstraction de l'annuaire, vous êtes invité à confirmer la suppression dans une boîte de dialogue qui ressemble à celle illustrée ci-dessous :

Cette préférence détermine si la case de la boîte de dialogue de confirmation de suppression libellée Supprimer l'objet du coffre-fort d'identité lors du déploiement est sélectionnée par défaut. La sélection de cette préférence signifie que le paramètre par défaut consiste à toujours supprimer l'objet du coffre-fort d'identité.

L'objet local est toujours supprimé.

Autoriser le déploiement d'objets avec des erreurs de validation

Sélectionné : sélectionnez cette option si vous voulez déployer des objets qui échouent à la validation. Lors du déploiement, le module Designer valide les définitions déployées en respectant les règles de validation définies à la Section 4.8, Importation, validation et déploiement des définitions de la couche d'abstraction de l'annuaire.

Désélectionné : pour empêcher le déploiement des définitions qui échouent à la validation.

Autoriser le déploiement d'objets non modifiés qui remplacent une nouvelle version modifiée de façon externe

Sélectionné : si vos fichiers locaux n'ont pas été modifiés, mais si les objets du coffre-fort d'identité l'ont été. Voulez-vous que les fichiers locaux remplacent ceux du coffre-fort d'identité ? Si oui, sélectionnez cette préférence.

Désélectionné : si vous voulez conserver les versions plus récentes du coffre-fort d'identité.

Lorsque cette option est sélectionnée, vous pouvez définir ce comportement par défaut en sélectionnant également la préférence de résolution des conflits La copie locale non modifiée remplace la nouvelle version modifiée de façon externe.

Spécifiez les préférences de résolution des conflits :

Préférence	Description
La modification locale remplace l'objet créé de façon externe	Sélectionné : si vous voulez que l'objet que vous déployez remplace celui qui se trouve dans le coffre-fort d'identité. Désélectionné : le déploiement ne se produit pas lorsque ce conflit survient.
La copie locale non modifiée recrée l'objet supprimé de façon externe	Sélectionné : si vous voulez que l'objet local que vous déployez crée un objet qui a déjà été supprimé du coffre-fort d'identité. Désélectionné : le déploiement ne se produit pas lorsque ce conflit survient.
La modification locale remplace l'objet modifié de façon externe	Sélectionné : si vous voulez que la définition locale soit toujours déployée, même si le coffre-fort d'identité a été modifié par un autre utilisateur. Désélectionné : le déploiement ne se produit pas lorsque ce conflit survient.
La copie locale remplace l'objet supprimé et recréé	Sélectionné : si vous voulez que l'objet local soit toujours déployé, même si l'objet du coffre-fort d'identité a été supprimé, ou supprimé et recréé. Désélectionné : le déploiement ne se produit pas lorsque ce conflit survient.
La copie locale non modifiée remplace la nouvelle version modifiée de façon externe	Cette préférence ne peut être définie que lorsque la préférence générale de déploiement Autoriser le déploiement d'objets non modifiés qui remplacent une nouvelle version modifiée de façon externe est sélectionnée. Sélectionné : si vos fichiers locaux n'ont pas été modifiés mais si les objets du coffre-fort d'identité ont changé et si vous voulez que les fichiers locaux remplacent toujours ceux du coffre-fort d'identité par défaut. Désélectionné : si vous voulez conserver les versions plus récentes du coffre-fort d'identité.