Guide de l'utilisateur de Service Registry 3 2005Q4

Publication et gestion des objets de Registry

L'option de menu Créer un nouvel objet de registre permet de créer des objets et de les publier dans Registry.

Publication d'objets

La publication d'objets dans Registry est un processus en trois étapes :

Créez l'objet.
Ajoutez des détails et d'autres objets, en les enregistrant dans la mémoire mais sans les publier dans Registry.
Publiez l'objet dans Registry.

Vous pouvez publier des objets dans Registry si vous avez créé un compte utilisateur et si vous êtes connecté à ce compte. Pour créer un compte utilisateur, suivez les instructions de Création d'un compte utilisateur.

Pour créer et publier un nouvel objet de registre

Étapes

Dans la zone de menus, cliquez sur Créer un nouvel objet de registre.

Dans la zone Objets de registre, sélectionnez dans la liste déroulante un type d'objet et cliquez sur Ajouter.

Un formulaire Détails apparaît pour l'objet dans la zone Détails.

Saisissez un nom et éventuellement une description dans les champs du formulaire Détails. Complétez les autres champs du formulaire.

Remarque –
Lorsque vous créez un objet AdhocQuery et tapez la chaîne de requête, utilisez des paires d'apostrophes simples pour entourer les éléments que vous placez généralement entre apostrophes simples. Ces éléments sont en principe les substituants et littéraux qui figurent dans les sous-requêtes. Par exemple, utilisez le modèle suivant pour spécifier un substituant de paramètre dans une sous-requête :
```
(SELECT id FROM ClassificationNode WHERE path LIKE ''$objectTypePath'')
```
Pour spécifier à la fois un littéral et un substituant de paramètre, procédez comme suit :
```
... AND (ro.id = s.parent AND s.name_ = 
''urn:oasis:names:tc:ebxml-regrep:profile:ws:wsdl:nameSpacesUsed''
  AND s.value LIKE ''$nameSpacePattern'')
```

(Facultatif) Remplacez l'identificateur unique et l'identificateur unique logique par les identificateurs de votre choix.

Chaque identificateur doit être un URN et doit être unique dans Registry.

(Facultatif) Cliquez sur Enregistrer pour enregistrer l'objet dans la mémoire.

(Facultatif) Utilisez les onglets du formulaire Détails pour ajouter et enregistrer les objets composés.

Cliquez sur Appliquer pour publier l'objet dans Registry.

Un message indiquant si l'application a été effectuée apparaît.

Étapes suivantes

Avant ou après la publication d'un objet, vous avez la possibilité de l'éditer et de lui ajouter des objets composés. Le Tableau 1–4 répertorie les objets que vous pouvez ajouter. Les sections suivantes expliquent comment ajouter ces objets.

Ajout d'une classification à un objet

Pour créer une classification, vous devez utiliser un schéma de classification interne. Ce schéma contient un ensemble de concepts dont les valeurs sont connues dans Registry.

Pour ajouter une classification

Pour ajouter une classification à un objet, recherchez le schéma de classification approprié, puis choisissez un concept dans ce schéma.

Étapes

Dans la zone Détails correspondant à l'objet, cliquez sur le bouton Classifications.

Le tableau Classifications (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Saisissez un nom et éventuellement une description pour la classification.

Cliquez sur le bouton Sélectionner le schéma de classification ou le concept.

La fenêtre de sélection de schéma de classification/concept s'ouvre.

Développez le nœud ClassificationSchemes. Développez ensuite les nœuds de concept pour atteindre le nœud feuille que vous souhaitez utiliser.

Cliquez sur OK pour fermer la fenêtre de sélection de schéma de classification/concept.

Le schéma de classification et le concept apparaissent dans la fenêtre Panneau Détails.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'un identificateur externe à un objet

Pour créer un identificateur externe, vous utilisez un schéma de classification externe. Ce type de schéma comporte des valeurs qui ne sont pas connues de Registry, car le schéma de classification ne contient pas de concepts.

Pour ajouter un identificateur externe

Pour ajouter un identificateur externe à un objet, recherchez le schéma de classification approprié, puis indiquez une valeur.

Étapes

Dans la zone Détails correspondant à l'objet, cliquez sur l'onglet Identificateurs externes.

Le tableau Identificateurs externes (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Saisissez un nom et éventuellement une description pour l'identificateur externe.

Cliquez sur le bouton Sélectionnez le schéma de classification.

La fenêtre de sélection de schéma de classification/concept s'ouvre.

Développez le nœud ClassificationSchemes, puis sélectionnez un schéma de classification ne contenant aucun concept.

Cliquez sur OK pour fermer la fenêtre de sélection de schéma de classification/concept.

Le schéma de classification apparaît dans la fenêtre Panneau Détails.

Entrez une valeur dans le champ Valeur.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'un lien externe à un objet

Un lien externe permet d'associer un URI à un objet de Registry.

Pour ajouter un lien externe

Étapes

Dans la zone Détails correspondant à l'objet, cliquez sur l'onglet Liens externes.

Le tableau Liens externes (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Entrez un nom pour le lien externe.

Entrez l'URL du lien externe dans le champ URI externe.

(Facultatif) Cliquez sur le bouton Sélectionner le concept pour le type d'objet si vous voulez indiquer le type de contenu vers lequel pointe l'URL.

Développez le nœud ClassificationSchemes. Localisez le type de contenu en développant les nœuds ObjectType, RegistryObject et ExtrinsicObject. Sélectionnez le concept, puis cliquez sur OK. Si vous ne trouvez pas de type approprié, cliquez sur Annuler. Vous avez la possibilité de créer un nouveau concept pour les objets ExtrinsicObject.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'informations personnalisées à un objet à l'aide d'emplacements

Un emplacement contient des informations supplémentaires qui ne seraient sinon pas stockées dans Registry. Ces emplacements permettent d'ajouter des attributs arbitraires aux objets.

Pour ajouter un emplacement

Étapes

Dans la zone Détails correspondant à l'objet, cliquez sur l'onglet Emplacements.

Le tableau Emplacements (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Entrez le nom de l'emplacement.

(Facultatif) Entrez une valeur dans le champ Type d'emplacement. Ce champ permet d'indiquer un type de données pour l'emplacement ou de fournir une méthode de groupement des emplacements.

Entrez une valeur dans le champ Valeurs.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'une adresse postale à une organisation ou un utilisateur

Une organisation ou un utilisateur peut disposer de plusieurs adresses postales.

Pour ajouter une adresse postale

Étapes

Dans la zone Détails correspondant à l'organisation ou à l'utilisateur, cliquez sur l'onglet Adresses postales.

Le tableau Adresses postales (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Complétez les champs. Tous les champs sont facultatifs.
- Numéro de rue
- Rue
- Ville
- Etat ou province
- Pays
- Code postal

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'un numéro de téléphone à une organisation ou un utilisateur

Une organisation ou un utilisateur peut disposer de plusieurs numéros de téléphone.

Pour ajouter un numéro de téléphone

Étapes

Dans la zone Détails correspondant à l'organisation ou à l'utilisateur, cliquez sur l'onglet Numéros de téléphone.

Le tableau Numéros de téléphone (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Sélectionnez une valeur dans la boîte combinée Type.

Les valeurs suivantes sont proposées :
- Beeper
- Télécopie
- Téléphone personnel
- Téléphone mobile
- Téléphone professionnel

Complétez les champs. Tous les champs sont facultatifs.
- Code du pays
- Code régional
- Numéro de téléphone
- Extension

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'une adresse e-mail à une organisation ou un utilisateur

Une organisation ou un utilisateur peut disposer de plusieurs adresses e-mail.

Pour ajouter une adresse e-mail

Étapes

Dans la zone Détails correspondant à l'organisation ou à l'utilisateur, cliquez sur l'onglet Adresses e-mail.

Le tableau Adresses e-mail (qui peut être vide) apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Sélectionnez une valeur dans la boîte combinée Type : Adresse e-mail privée ou Adresse e-mail professionnelle.

Entrez une adresse dans le champ Adresse e-mail.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'un utilisateur à une organisation

Une organisation peut comporter plusieurs utilisateurs. Un utilisateur est le contact principal. Il s'agit en principe de l'utilisateur qui a créé l'organisation. Vous pouvez créer et ajouter d'autres utilisateurs.

Ajout d'un utilisateur

Étapes

Dans la zone Détails de l'organisation, cliquez sur l'onglet Utilisateurs.

Le tableau Utilisateur apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Dans le champ Nom, tapez le nom de famille de l'utilisateur à gauche de la virgule. Vous pouvez éventuellement ajouter le prénom et le deuxième prénom à droite de la virgule.

(Facultatif) Entrez la description de l'utilisateur dans le champ Description.

Dans les champs Prénom, Deuxième prénom et Nom, entrez les prénoms et le nom de l'utilisateur. Tous les champs sont facultatifs.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'une organisation enfant à une organisation

Une organisation peut comporter plusieurs organisations enfants. Pour ajouter une organisation enfant à une organisation, procédez comme suit :

Pour ajouter une organisation enfant

Étapes

Dans la zone Détails de l'organisation, cliquez sur l'onglet Organisations enfants.

Le tableau ChildOrganizations apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Dans le champ Nom, entrez le nom de la nouvelle organisation.

(Facultatif) Tapez une description dans le champ Description.

(Facultatif) Entrez les valeurs dans les champs d'adresse.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'une liaison de service à un service

Un service comporte en principe une ou plusieurs liaisons de service.

Pour ajouter une liaison de service

Étapes

Dans la zone Détails correspondant au service, cliquez sur l'onglet Liaisons du service.

La tableau Liaisons du service apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Dans le champ Nom, entrez le nom de la nouvelle liaison de service.

(Facultatif) Entrez la description de la liaison de service dans le champ Description.

Dans le champ URL d'accès, entrez l'URL de la liaison de service.

(Facultatif) Dans le champ Liaison cible, entrez l'identificateur unique d'une autre liaison de service à laquelle la liaison de service fait référence.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'un lien de spécification à une liaison de service

Une liaison de service peut comporter un objet SpecificationLink.

Pour ajouter un lien de spécification

Étapes

Dans la zone Détails correspondant à la liaison de service, cliquez sur l'onglet Liens de spécifications.

Le tableau Liens de spécifications apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Dans le champ Nom, entrez le nom du lien de spécification.

(Facultatif) Entrez une description du lien dans le champ Description.

Dans le champ Description de la syntaxe, tapez la description de la syntaxe d'utilisation des paramètres, si le lien de spécifications en comporte.

Dans le champ Paramètres de la syntaxe, tapez les paramètres d'utilisation, si le lien de spécifications en comporte.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'un concept enfant à un schéma de classification ou un concept

Un schéma de classification comporte en principe plusieurs concepts enfants (qui, à leur tour, peuvent comporter d'autres concepts enfants).

Pour ajouter un concept enfant

Étapes

Dans la zone Détails du schéma de classification, cliquez sur l'onglet ChildConcepts.

Le tableau ChildConcepts apparaît.

Cliquez sur Ajouter .

La fenêtre Panneau Détails s'ouvre.

Dans le champ Nom, entrez un nom pour le concept.

(Facultatif) Entrez la description du concept dans le champ Description.

Dans le champ Valeur, entrez une valeur pour le concept.

Cliquez sur Ajouter pour enregistrer le nouvel objet et fermer la fenêtre Panneau Détails.

Cliquez sur Appliquer dans la zone Détails correspondant à l'objet.

Ajout d'objet à un package Registry

Un objet RegistryPackage est un objet contenant d'autres objets de Registry. En général, on utilise un objet RegistryPackage pour grouper des objets ayant un lien logique. Les types de ces objets peuvent être différents, ainsi que leurs propriétaires.

Pour ajouter des objets à un package Registry, vous devez indiquer leurs identificateurs uniques. Si vous essayez de saisir les identificateurs uniques, il est vraisemblable que vous commettrez des erreurs. Les étapes suivantes vous expliquent comment ajouter des objets en copiant et collant leurs identificateurs.

Pour ajouter des objets à un package Registry

Étapes

Créez un objet RegistryPackage comme décrit dans la section Pour créer et publier un nouvel objet de registre. Indiquez un nom, et éventuellement une description, mais ne lui ajoutez pas encore d'objets RegistryObject.

Une fois que vous avez cliqué sur Appliquer pour enregistrer l'objet RegistryPackage, conservez-le comme décrit dans la section Pour utiliser la fonctionnalité PIN.

Utilisez Web Console pour rechercher les objets à ajouter au package Registry. Conservez chaque objet à mesure que vous le trouvez.

Cliquez sur le lien Détails d'un objet que vous souhaitez ajouter au package Registry.

Dans le panneau Détails de l'objet, copiez l'identificateur unique à l'aide du clavier (Ctrl+C ou touche de copie).

Dans la zone Résultats de la recherche, cliquez sur le lien Détails de l'objet RegistryPackage.

Dans la zone Détails correspondant à l'objet, cliquez sur l'onglet Objets de registre.

Cliquez sur Ajouter au package.

Dans le champ Identificateur unique, servez-vous du clavier pour coller l'identificateur copié (Ctrl+V ou la touche de collage).

Cliquez sur Ajouter .

L'objet apparaît dans la zone Objets de registre.

Cliquez sur Appliquer dans la zone Détails pour enregistrer le package Registry.

Répétez les étapes 4 à 11 pour ajouter chaque objet au package Registry.

Changement d'état des objets

Outre la publication, la modification et la suppression d'objets, vous pouvez effectuer les actions suivantes sur les objets si vous êtes le propriétaire ou si vous êtes autorisé à le faire :

Approbation
Désapprobation
Annulation de la désapprobation

Ces fonctions s'avèrent utiles dans un environnement de production si vous souhaitez établir une stratégie de contrôle de version des objets de Registry. Par exemple, vous pouvez approuver la version d'un objet pour une utilisation générale et désapprouver une version obsolète avant de la supprimer. Si vous changez d'avis après avoir désapprouvé un objet, vous pouvez annuler la désapprobation.

Toutes ces actions s'effectuent dans la zone Résultats de la recherche.

Pour approuver un objet, sélectionnez-le et cliquez sur le bouton Approuver. Un message confirmant l'approbation apparaît. L'événement est ajouté au journal d'audit.
Pour désapprouver un objet, sélectionnez-le et cliquez sur le bouton Désapprouver. Un message confirmant la désapprobation apparaît. L'événement est ajouté au journal d'audit.
Pour annuler la désapprobation d'un objet, sélectionnez-le et cliquez sur le bouton Annuler la désapprobation. Un message confirmant l'annulation de la désapprobation apparaît. L'événement est ajouté au journal d'audit.

Suppression d'objets

Pour supprimer de Registry un objet dont vous êtes le propriétaire, sélectionnez-le dans la zone Résultats de la recherche et cliquez sur le bouton Supprimer.

Remarque –

Ne supprimez pas les objets AuditableEvent correspondant aux objets dont vous êtres propriétaire. En d'autres termes, ne supprimez pas les objets AuditableEvent qui apparaissent dans la zone Résultats de la recherche suite à une recherche FindAllMyObjects. Si vous supprimez un objet AuditableEvent, le journal d'audit correspondant à l'objet auquel il appartient sera corrompu.

S'il s'agit d'un objet extrinsèque, vous avez deux possibilités :

Sélectionnez Supprimer l'objet et l'élément référentiel (par défaut) dans le menu Option de suppression pour supprimer à la fois l'objet ExtrinsicObject de Registry et l'élément référentiel auquel il se rapporte.
Sélectionnez Supprimer l'élément référentiel uniquement pour supprimer l'élément référentiel et laisser l'objet ExtrinsicObject dans Registry. Vous pouvez alors ajouter un autre élément référentiel.

Le menu Option de suppression n'a de sens que pour les objets extrinsèques.

Création d'une relation entre objets

Les objets peuvent présenter deux types de relation : les références et les associations. Les deux sortes de relation sont unidirectionnelles. Cela signifie que chacune comporte un objet source et un objet cible.

Registry prend en charge des références, appelées ObjectRefs, entre certains types d'objet. Par exemple, si vous créez un service et une liaison de service ServiceBinding, vous pouvez créer une référence ServiceBinding depuis le service vers la liaison de service ServiceBinding. Toutefois, vous ne pouvez pas créer de référence de l'objet ServiceBinding vers l'objet Service. Un objet Reference n'est pas un objet de Registry.

Une association est un objet de Registry. Vous pouvez créer une association de n'importe quel objet de Registry vers un autre objet. Registry prend en charge un schéma de classification AssociationType qui contient un nombre prédéfini de types d'association : OffersService, RelatedTo, HasMember, etc. Vous pouvez aussi créer de nouveaux types d'association. Si vous possédez les deux objets inclus dans l'association, l'association est dite interne. Si vous ne possédez pas les deux objets, l'association est dite externe. Si vous créez une organisation et que vous lui ajoutez un service, une association de type OffersService est automatiquement créée de l'organisation vers le service.

Si aucune référence valide n'existe pour les objets source et cible, vous ne pouvez pas créer de référence.

Utilisez le bouton Lier de la zone Objets de registre pour lier deux objets. Ce bouton devient actif lorsque vous sélectionnez deux objets dans le tableau des résultats de la recherche.

Si les objets ne sont pas tous deux visibles dans le tableau des résultats, cochez la case Code PIN pour conserver un objet dans le tableau pendant que vous recherchez l'autre. Pour plus de détails, reportez-vous à la section Pour utiliser la fonctionnalité PIN.

Pour créer une référence

Étapes

Dans la zone Objets de registre, sélectionnez deux objets et cliquez sur Lier.

Dans la zone Créer la relation, sélectionnez l'objet source s'il ne l'est pas encore.

L'autre objet devient l'objet cible.

Si une référence valide existe pour les objets source et cible, l'option Référence est sélectionnée par défaut, et l'attribut de référence valide apparaît. Si aucune référence valide n'existe pour les objets source et cible, le bouton radio Référence est grisé.

Cliquez sur Enregistrer pour enregistrer la référence.

Pour créer une association

Étapes

Dans la zone Objets de registre, sélectionnez deux objets et cliquez sur Lier.

Dans la zone Créer la relation, sélectionnez l'objet source s'il ne l'est pas encore.

L'autre objet devient l'objet cible.

Sélectionnez le bouton radio Association, s'il ne l'est pas encore.

Saisissez un nom et éventuellement une description pour l'association dans la zone Détails.

Les ID d'objets source et cible sont déjà inscrits.

Sélectionnez un type dans le menu Type d'association.

Cliquez sur Appliquer pour enregistrer l'association.