test

Guide de l'utilisateur de Service Registry 3.1

Publication d'objets

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

  1. Créez l'objet.

  2. Ajoutez des détails et d'autres objets, en les enregistrant dans la mémoire mais sans les publier dans Registry.

  3. Publiez l'objet dans Registry.

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

La première tâche ci-dessous décrit les étapes à suivre pour créer un nouvel objet. Les sections suivantes décrivent les étapes supplémentaires nécessaires pour publier des types d'objet particuliers.

Vous pouvez créer et publier l'un des objets répertoriés dans le Tableau 2–2, à l'exception des objets suivants :

Cette section décrit les tâches suivantes :

ProcedureCréation et publication d'un nouvel objet de registre

  1. Dans l'onglet Tâches de la zone de menu à gauche, cliquez sur Créer un nouvel objet de registre.

  2. Dans la zone Objets de registre, sélectionnez un type d'objet dans la boîte combinée, puis cliquez sur Ajouter.

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

  3. Saisissez un nom dans le champ Nom.

  4. (Facultatif) Saisissez une description dans le champ Description.

  5. (Facultatif) Saisissez un commentaire dans le champ Commentaire de version.

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

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

  7. Saisissez les données dans les champs spécifiques au type d'objet.

  8. Cliquez sur Enregistrer pour enregistrer l'objet dans la mémoire.

    Remarque –

    Assurez-vous d'avoir enregistré les modifications apportées dans l'une des zones de l'onglet pour l'objet avant de passer à un autre onglet. Tout travail non enregistré sera perdu.

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

  10. 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 2–4 répertorie les objets que vous pouvez ajouter. Les sections suivantes expliquent comment ajouter ces objets.

ProcedureCréation et publication d'un objet AdhocQuery

Un objet Requête Adhoc (AdhocQuery) représente une requête ad hoc exprimée dans une syntaxe de requête. Les objets Requête Adhoc (AdhocQuery) sont utilisés pour la découverte d'objets de registre. Les objets Requête Adhoc (AdhocQuery) ont la même finalité que le concept des procédures enregistrées dans les bases de données relationnelles. Par exemple, les requêtes prédéfinies dans le panneau Recherche sont toutes des objets Requête Adhoc (AdhocQuery).

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Requête Adhoc (AdhocQuery).

  2. (Facultatif) Sélectionnez un type de requête dans la boîte combinée Type de requête.

    Le paramètre par défaut est Requête SQL. Les requêtes de filtre XQuery et ebXML sont d'autres types de requête pris en charge.

  3. Saisissez le texte de la requête dans le champ Chaîne de requête.

    Pour une requête SQL, utilisez des paires de guillemets simples pour délimiter les éléments normalement entourés de guillemets 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'')

  4. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

ProcedureCréation et publication d'un objet Nœud de Classification (ClassificationNode)

Un objet Nœud de Classification (ClassificationNode) représente un élément taxonomique ayant une relation structurelle avec d'autres éléments dans un schéma de classification interne. Vous pouvez créer un objet Nœud de Classification (ClassificationNode), puis l'ajouter à un schéma de classification. Toutefois, il peut être plus simple d'utiliser l'onglet Concepts du panneau Détails de l'objet Schéma de classification (ClassificationScheme) pour créer des concepts.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Nœud de Classification (ClassificationNode).

  2. Attribuez une valeur à l'objet Nœud de Classification (ClassificationNode) dans le champ Valeur.

    Les champs Schéma de classification, ID parent et Chemin sont grisés.

  3. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

ProcedureCréation et publication d'un objet Schéma de classification (ClassificationScheme)

Un objet Schéma de classification (ClassificationScheme) représente une taxonomie servant à classer des objets. Dans un objet Schéma de classification (ClassificationScheme) interne, tous les éléments taxonomiques sont définis dans Registry en tant qu'instances de Concept. Dans un objet Schéma de classification (ClassificationScheme) externe, les valeurs ne sont pas définies dans Registry en tant qu'instances de Concept, mais référencées par leurs représentations de Chaîne.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Schéma de classification (ClassificationScheme).

    La case Schéma de classification externe est cochée pour indiquer que le schéma ne contient aucun concept. Si vous ajoutez des concepts au schéma de classification, la case est désélectionnée.

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

    • Unique. Indique que chaque nœud de la taxonomie est associé à un seul code.

    • Chemin incorporé. Cette valeur indique que le code unique affecté à chaque nœud de la taxonomie encode également son chemin.

    • Non-Unique. Dans certains cas, les nœuds ne sont pas uniques, par conséquent, il faut utiliser le chemin d'accès complet (de l'objet Schéma de classification (ClassificationScheme) jusqu'au nœud souhaité) pour identifier le nœud.

    Le paramètre par défaut est Unique.

  3. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

ProcedureCréation et publication d'un objet Lien Externe (ExternalLink)

Un objet Lien Externe (ExternalLink) fournit un URI pour le contenu résidant à l'extérieur de Registry.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Lien Externe (ExternalLink).

    Le champ Type d'objet contient la valeur Lien Externe (ExternalLink).

  2. (Facultatif) Cliquez sur le bouton Sélectionner le concept pour le type d'objet afin de sélectionner un type d'objet pour les données référencées par l'URI.

    Dans la fenêtre Sélection du nœud de classification de l'objet extrinsèque, développez les nœuds jusqu'à accéder au concept approprié dans le type Objet Extrinsèque (ExtrinsicObject). Une fois que vous avez cliqué sur OK, la fenêtre Type d'objet contient le type sélectionné.

  3. Saisissez l'URI du lien externe dans le champ URI externe.

  4. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

    Remarque –

    Si un message d'erreur s'affiche lorsque vous essayez d'enregistrer un objet Lien Externe (ExternalLink), cela signifie qu'une tâche administrative doit être effectuée. Pour plus de détails, reportez-vous à Impossible de créer des objets ExternalLink ou ServiceBinding.

ProcedureCréation et publication d'un objet Objet Extrinsèque (ExtrinsicObject)

Un objet Objet Extrinsèque (ExtrinsicObject) fournit des métadonnées décrivant le contenu dont le type n'est pas intrinsèquement connu du registre et qui doit, par conséquent, être décrit au moyen d'attributs supplémentaires, tels que le type MIME.

Utilisez un objet Objet Extrinsèque (ExtrinsicObject) pour publier des fichiers de différents types. Il s'agit, plus fréquemment, d'artefacts Web Services, tels que des fichiers WSDL.

Le profil ebXML Registry pour Web Services est une norme OASIS définissant le profil ebXML du Registre pour la publication, la gestion, la gouvernance, la découverte et la réutilisation d'artefacts Web Services. Par défaut, Service Registry implémente ce profil. Dans la pratique, cela signifie que lorsque vous publiez un fichier WSDL dans Registry en tant qu'objet Objet Extrinsèque (ExtrinsicObject), Registry crée certaines métadonnées standard pour le document, créant de fait le service Web défini par le document. Cette fonction s'appelle catalogage WSDL.

Pour publier un ou plusieurs fichiers WSDL interdépendants ou dépendants d'autres fichiers (tels que des fichiers XSD), créez un fichier zippé contenant tous les fichiers.

Un administrateur peut, s'il le souhaite, désactiver la fonction de catalogage WSDL. Pour plus de détails, reportez-vous à la section Disabling the WSDL Cataloger du Service Registry 3.1 Administration Guide.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Objet Extrinsèque (ExtrinsicObject) ou l'un de ses sous-types.

    Par exemple, pour publier un ou plusieurs fichiers WSDL, sélectionnez WSDL.

  2. (Facultatif) Saisissez le type MIME de l'objet dans le champ Type MIME. Le type doit figurer dans http://www.iana.org/assignments/media-types.

    Si vous téléchargez un fichier WSDL autonome (un fichier texte contenant XML), définissez le type MIME sur text/xml.

    Si vous téléchargez un fichier zippé contenant plusieurs fichiers WSDL (et éventuellement des fichiers XSD), définissez le type MIME sur application/zip.

  3. (Facultatif) Cochez la case Est opaque si le contenu de l'objet ne peut pas être lu par le registre (par exemple, s'il est chiffré).

  4. Cliquez sur le bouton Sélectionner le contenu pour le type d'objet si vous souhaitez sélectionner un type d'objet plus spécifique que Objet Extrinsèque (ExtrinsicObject).

    Dans la fenêtre Sélection du nœud de classification de l'objet extrinsèque, développez les nœuds jusqu'à accéder au concept approprié dans le type Objet Extrinsèque (ExtrinsicObject). Une fois que vous avez cliqué sur OK, la fenêtre Type d'objet contient le type sélectionné.

  5. Cliquez sur le bouton Choisir le fichier de l'élément référentiel pour Objet Extrinsèque (ExtrinsicObject).

    1. Dans la fenêtre Téléchargement de fichier, saisissez le chemin de fichier dans la zone de texte ou cliquez sur Parcourir.

    2. Si vous avez cliqué sur Parcourir, accédez au fichier à l'aide de la fenêtre de sélection, puis cliquez sur Ouvrir.

    3. Dans la fenêtre Téléchargement de fichier, cliquez sur Télécharger le fichier.

    4. Cliquez sur OK .

    Les éléments supplémentaires suivants s'affichent dans le panneau Détails :

    • Champ Version du contenu (grisé)

    • Champ Commentaire de la version du contenu, qui peut être renseigné

    • Bouton Supprimer l'élément référentiel

    • Lien Voir le contenu de l'élément référentiel

  6. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

Étapes suivantes

Après avoir créé un objet Objet Extrinsèque (ExtrinsicObject) faisant référence à un fichier WSDL, vous pouvez le rechercher à l'aide de la fonction Requête de découverte WSDL. De plus, si vous utilisez la fonction Requête de base pour rechercher des objets Objet Extrinsèque (ExtrinsicObject) de type WSDL, des objets Service et des objets Liaison de Service (ServiceBinding), vous constaterez que Registry a créé tous les objets spécifiés par les éléments du fichier WSDL :

ProcedureCréation et publication d'un objet Fédération

Un objetFédération représente un groupe de registres apparentés. Ses seuls attributs sont les attributs Objet du Registre (RegistryObject) de base. Vous devez disposer de droits d'administrateur pour créer un objet Fédération.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Fédération.

  2. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

  3. Ajoutez des registres affiliés à la fédération en suivant les étapes contenues dans la rubrique Création d'une relation entre objets. Procédez comme suit :

    1. Recherchez la fédération, cochez la case Sélection correspondante, puis cliquez sur Signet.

    2. Recherchez le registre, cochez la case Sélection correspondante, puis cliquez sur Lier.

    3. Dans la zone Créer une relation, sélectionnez la fédération en tant qu'objet source. Le registre devient l'objet cible.

    4. Définissez le type d'association sur HasFederationMember.

ProcedureCréation et publication d'un objet Organisation

Un objet Organisation fournit des informations sur une organisation. Cette dernière peut être une organisation parente et comporter une ou plusieurs organisations enfants. Cet objet inclut toujours un objet Utilisateur (User) en tant que contact primaire, et peut offrir des services en créant des associations entre l'organisation et un ou plusieurs objets Service.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Organization.

  2. (Facultatif) Saisissez des valeurs dans les champs PostalAddresses.

  3. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

    Pour plus de détails, reportez-vous aux sections suivantes sur l'ajout d'objets composés à un objet Organisation :

  4. Pour ajouter un objet Service à un objet Organisation, suivez les étapes contenues dans la section Création d'une relation entre objets. Procédez comme suit :

    1. Recherchez l'organisation, cochez la case Sélection correspondante, puis cliquez sur Signet.

    2. Recherchez le service, cochez la case Sélection correspondante, puis cliquez sur Lier.

    3. Dans la zone Créer une relation, sélectionnez l'organisation en tant qu'objet source. Le service devient l'objet cible.

    4. Définissez Type d'association (AssociationType) sur OffersService.

ProcedureCréation et publication d'un objet Personne (Person) ou Utilisateur (User)

Un objet Personne (Person) ou Utilisateur (User) fournit des informations sur les personnes et les utilisateurs inscrits dans Registry. Les deux types d'objets possèdent des attributs identiques. Un objet Utilisateur (User) est associé à un objet Organisation en tant que contact primaire. Les objets Utilisateur (User) sont également utilisés dans des objets Événement pouvant faire l'objet d'un audit (AuditableEvent) pour identifier le demandeur qui a envoyé la requête ayant généré l'objet Événement pouvant faire l'objet d'un audit (AuditableEvent).

Il est préférable de créer des objets Utilisateur (User) via l'Assistant Inscription utilisateur. Dans Web Console, créez des objets Personne (Person) chaque fois que vous souhaitez créer des métadonnées sur des personnes qui n'envisagent pas elles-mêmes d'accéder à Registry.

Si vous souhaitez créer plusieurs adresses postales, adresses e-mail ou numéros de téléphone pour la personne, créez un objet Utilisateur (User). Web Console vous permet d'ajouter des adresses postales, des adresses e-mail et des numéros de téléphone en tant qu'objets composés pour un objet Utilisateur (User), mais pas pour un objet Personne (Person).

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Personne ou Utilisateur.

  2. Saisissez des valeurs dans les champs de noms de la personne.

    Spécifiez au moins une valeur pour l'un de ces champs.

    Laissez le champ Nom vide. Web Console ignore toute valeur saisie dans ce champ pour un objet Personne (Person) ou Utilisateur (User).

  3. Pour ajouter des objets composés, reportez-vous aux sections suivantes :

  4. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

ProcedureCréation et publication d'un objet Registre

Un objet Registre représente un registre. Ses seuls attributs sont les attributs Objet du Registre (RegistryObject) de base. Vous devez disposer de droits d'administrateur pour créer un objet Registre.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Registre.

  2. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

Étapes suivantes

Pour plus d'informations sur l'ajout du registre à une fédération, reportez-vous à la section Création et publication d'un objet Fédération .

ProcedureCréation et publication d'un objet Paquet de registre (RegistryPackage)

Un objet Paquet de registre (RegistryPackage) représente un groupement logique d'un nombre quelconque d'objets de registre.

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Paquet de registre (RegistryPackage).

  2. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

  3. Pour ajouter des objets au paquet, suivez les instructions contenues dans la section Ajout d'objet à un paquet de registre.

ProcedureCréation et publication d'un objet Service

Un objet Service fournit des informations sur un service. Il peut contenir un ou plusieurs objets Liaison de Service (ServiceBinding), qui représente des informations techniques sur le mode d'accès au service.

La manière la plus courante de publier un objet Service consiste à publier un objet Objet Extrinsèque (ExtrinsicObject) comprenant un ou plusieurs fichiers WSDL. Pour plus d'informations, reportez-vous à la section Création et publication d'un objet Objet Extrinsèque (ExtrinsicObject) .

  1. Exécutez les étapes 1–6 de la section Création et publication d'un nouvel objet de registre. Dans l'étape 2, sélectionnez Service.

  2. Exécutez les étapes 8–10 de la section Création et publication d'un nouvel objet de registre.

  3. Pour ajouter des objets Liaison de Service (ServiceBinding) au service, suivez les instructions contenues dans la section Ajout d'une liaison de service à un service.

  4. Pour ajouter des objets Lien de Spécification (SpecificationLink) à un objet Liason de Service (ServiceBinding), suivez les instructions contenues dans la section Ajout d'un lien de spécification à une liaison de service.