test

Guide de l'utilisateur de Service Registry 3.1

Chapitre 2 Recherches dans Registry

Les onglets Recherche et Explorer de la zone de menu permettent d'effectuer des recherches dans Registry.

Utilisation de l'onglet Recherche

Cliquez sur l'onglet Recherche. Le formulaire Recherche s'ouvre. Le formulaire contient une boîte combinée appelée Sélectionner une requête prédéfinie. Il contient également une description de la requête sélectionnée et trois boutons :

Les autres champs du formulaire dépendant du type de requête sélectionné. Par défaut, la requête de base est sélectionnée.

Les sections suivantes décrivent comment utiliser ces composants.

Sélection d'une requête

La boîte combinée Sélectionner une requête prédéfinie contient les éléments affichés dans le Tableau 2–1.

Tableau 2–1 Requêtes prédéfinies

Nom de la requête 

Objet de la recherche 

Requête de base 

Requête générique par défaut, qui permet de rechercher des objets par type, nom, description et classification 

Requête de base - Distinction maj./min. 

Version sensible à la casse de la requête de base 

FindAllMyObjects 

Trouve tous les objets détenus (publiés) par l'utilisateur émetteur de la requête. Si l'utilisateur possède de nombreux objets, cette requête peut prendre un certain temps 

GetCallersUser 

Recherche l'objet User de l'utilisateur qui établit la requête

Requête de découverte WSDL 

Recherche des documents WSDL (Web Services Description Language) 

Requête de découverte de liaison WSDL 

Recherche les liaisons de protocole d'interface de services résumées de service décrites en tant que définitions WSDL Binding 

Requête de découverte de port WSDL 

Recherche les mises en œuvre d'interfaces de service décrites en tant que définitions WSDL Port 

Requête de découverte WSDL PortType 

Recherche les interfaces résumées de service décrites en tant que définitions WSDL PortType 

Requête de découverte de service WSDL 

Recherche les services Web décrits en tant que définitions WSDL Service 

Par défaut, la requête de base est sélectionnée. Le formulaire de base pour Requête de base et Requête de base — Distinction maj./min. contient les composants suivants :

Vous pouvez spécifier un ou tous ces critères dans une seule chaîne. Les sections suivantes expliquent comment effectuer une requête :

Utilisez la requête FindAllMyObjects pour rechercher tous les objets que vous avez publiés. Les résultats de la requête listent tous les objets dont vous êtes propriétaire, excepté les objets AuditableEvent, qui ne doivent pas être modifiés ni supprimés.

Utilisez la requête GetCallersUser pour afficher ou modifier les données concernant l'utilisateur que vous avez créé lors de l'enregistrement.

Pour plus d'informations sur l'utilisation de requêtes WSDL, reportez-vous à la section Exécution de requêtes WSDL.

Recherche d'objet par type

La recherche la plus simple est par type d'objet uniquement.

La valeur par défaut dans la boîte combinée Type d'objet est RegistryObject, qui effectue une recherche de tous les objets dans Registry. Pour affiner la recherche, changez de type d'objet.

L'option ClassificationNode répertorie les concepts au sein des schémas de classification. ClassificationNode est synonyme de Concept.

Le Tableau 2–2 décrit les types d'objet disponibles dans Registry.

Tableau 2–2 Types d'objet dans Service Registry

Type d'objet 

Description 

AdhocQuery

Représente une requête ad hoc exprimée dans une syntaxe de requête. Les objets AdhocQuery sont utilisés pour la découverte d'objets de Registry. Les objets 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 AdhocQuery.

Association

Définit une relation entre deux objets. 

AuditableEvent

Contient un enregistrement d'une modification apportée à un objet. Une collection d'objets AuditableEvent constitue une piste d'audit d'objet.

Classification

Classe un objet à l'aide d'un ClassificationScheme.

ClassificationNode

Représente un élément taxonomique ayant une relation structurelle avec d'autres éléments d'un ClassificationScheme interne. Également appelé Concept.

ClassificationScheme

Représente une taxonomie utilisée pour classer des objets. Dans un ClassificationScheme interne, tous les éléments taxonomiques sont définis dans Registry sous forme d'instances de concept . Dans un 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.

ExternalIdentifier

Fournit des informations supplémentaires sur un objet en utilisant des valeurs de chaîne dans un schéma d'identification (ClassificationScheme externe). Les numéros DUNS et d'assuré social constituent des exemples de schémas d'identification.

ExternalLink

Fournit un URI pour du contenu résidant à l'extérieur de Registry. 

ExtrinsicObject

Fournit des métadonnées décrivant le contenu dont le type n'est pas intrinsèquement connu de Registry et qui doit, par conséquent, être décrit au moyen d'attributs supplémentaires, tels que le type MIME. 

Federation

Représente un groupe de registres affiliés. 

Notification

Représente une notification de Registry en ce qui concerne un événement correspondant à un abonnement.

Organisation

Fournit des informations sur une organisation. Cette dernière peut être parente, et comporter une ou plusieurs organisations enfants. Inclut toujours un objet User en tant que contact principal, et peut proposer des objets Service.

Person, User

Fournit des informations sur les personnes et les utilisateurs inscrits dans Registry. Les objets User sont affiliés aux objets Organization.

Registry

Représente un registre. 

RegistryPackage

Représente un groupement logique d'un nombre quelconque d'objets de Registry. 

Service

Fournit des informations sur un service. Peut contenir un ou plusieurs objets ServiceBinding.

ServiceBinding

Représente des informations techniques sur le mode d'accès à un service. 

SpecificationLink

Fournit un lien entre un objet ServiceBinding et une spécification technique décrivant l'utilisation du service à l'aide de l'objet ServiceBinding.

Subscription

Définit l'intérêt d'un objet User dans certains types d'objet AuditableEvent . Un objet User crée un objet Subscription afin de recevoir une notification de certains types d'événement.

ProcedureRecherche d'un objet par type

  1. Choisissez un type d'objet dans la boîte combinée Type d'objet.

  2. Cliquez sur le bouton Rechercher ou placez le curseur dans le champ Nom ou Description, puis appuyez sur Entrée.

    La recherche renvoie tous les objets correspondant au type spécifié. Vous pouvez affiner la recherche en indiquant un nom, une description, un état ou une classification.

Recherche par nom et description

Vous pouvez rechercher des objets par nom, par description ou les deux.

ProcedureRecherche d'un objet par nom ou description

  1. Entrez une chaîne dans le champ Nom ou Description.

    Par défaut, le système recherche un nom ou une description correspondant à l'intégralité de la chaîne saisie. Vous pouvez utiliser les caractères génériques pour élargir la recherche.

    Les caractères génériques sont le signe de pourcentage (%) et le trait de soulignement (_).

    Le caractère générique correspond à plusieurs caractères :

    • Entrez %off% pour renvoyer les noms ou descriptions contenant la chaîne off, comme Coffee.

    • Tapez nor% pour renvoyer les noms et descriptions commençant par Nor ou nor, comme North et northern.

    • Tapez %ica pour renvoyer les noms ou descriptions finissant par ica, par exemple America.

    Le caractère trait de soulignement correspond à un seul caractère. Par exemple, la chaîne _us_ renvoie les objets nommés Aus1 et Bus3.

  2. Cliquez sur le bouton Rechercher ou appuyez sur la touche Entrée.

Recherche par état

Un objet dans Registry peut présenter l'un des quatre états suivants :

L'état par défaut d'un objet de registre est Envoyé. Un objet peut être approuvé ou désapprouvé par un administrateur de Registry ou par le propriétaire de l'objet. L'état d'un objet ExtrinsicObject est Retiré si son élément référentiel a été supprimé.

ProcedureRecherche d'un objet par état

  1. Choisissez un état dans la boîte combinée Statut.

  2. Cliquez sur le bouton Rechercher ou placez le curseur dans le champ Nom ou Description, puis appuyez sur Entrée.

    La recherche renvoie tous les objets correspondant à l'état spécifié. Vous pouvez affiner la recherche en indiquant un type d'objet, un nom, une description ou une classification.

Recherche par classification

Les objets Classification classent les objets dans Registry à l'aide des concepts uniques (objets ClassificationNode) qui définissent des valeurs valides dans un schéma de classification. Dans une hiérarchie arborescente, le schéma de classification est le parent qui contient les générations de concepts enfants. Le Tableau 2–3 décrit les schémas de classification fournis par les spécifications de Registry, appelés schémas de classification canoniques. La plupart des termes contenus dans ce tableau sont définis dans les spécifications de Registry.

Tableau 2–3 Schémas de classification canoniques

Nom du schéma de classification 

Utilisation 

Description ou objet 

AssociationType

Fréquente 

Définit les types d'association entre objets de registre. Utilisé comme valeur de l'attribut associationType d'une instance Association pour décrire la nature de l'association.

ContentManagementService

Rare 

Détermine les types de service de gestion du contenu. Utilisé dans la configuration d'un service de gestion du contenu, comme un service de validation ou de catalogage. 

DataType

Fréquente 

Définit les types de données pour les attributs d'objet. Utilisé comme valeur de l'attribut slotType d'une instance Slot pour décrire le type de données de la valeur Slot.

DeletionScopeType

Occasionnelle 

Définit les valeurs de l'attribut deletionScope du message de protocole RemoveObjectsRequest.

EmailType

Rare 

Détermine les types d'adresse e-mail. 

ErrorHandlingModel

Rare 

Détermine les types de modèle de gestion des erreurs des services de gestion du contenu.  

ErrorSeverityType

Rare 

Détermine les types de gravité des différentes erreurs rencontrées par Registry lors du traitement des messages de protocole. 

EventType

Occasionnelle 

Détermine les types d'événement qui peuvent se produire dans Registry. 

InvocationModel

Rare 

Détermine les diverses méthodes d'appel par Registry d'un service de gestion du contenu. 

NodeType

Occasionnelle 

Détermine les différentes méthodes utilisées par ClassificationScheme pour affecter la valeur de l'attribut code à ses objets ClassificationNode (Concept).

NotificationOptionType

Rare 

Détermine les méthodes utilisées par Registry pour avertir le client d'un événement se produisant dans une période Subscription.

ObjectType

Occasionnelle 

Détermine les différents types d'objet RegistryObject pris en charge par Registry.

PhoneType

Rare 

Détermine les types de numéro de téléphone. 

QueryLanguage

Rare 

Détermine les langages de requêtes pris en charge par Registry. 

ResponseStatusType

Rare 

Détermine les différents types d'état de RegistryResponse.

StatusType

Occasionnelle 

Détermine les différents types d'état pour RegistryObject.

SubjectGroup

Rare 

Détermine les groupes auxquels un utilisateur peut appartenir à des fins de contrôle d'accès. 

SubjectRole

Rare 

Détermine les rôles qui peuvent être affectés à un utilisateur à des fins de contrôle d'accès. 

Les schémas de classification canoniques n'ont pas pour principal objectif de classer des objets, mais de fournir des types d'attributs d'objet énumérés. Registry contient également un certain nombre de schémas de classification non canoniques, que vous pouvez créer vous même.

ProcedureRecherche d'un objet par classification

  1. Cliquez sur le bouton Sélectionner le nœud de classification.

    La fenêtre Sélection du nœud de classification s'affiche.

  2. Cliquez sur l'icône du dossier correspondant au schéma de classification à utiliser.

    La valeur affichée entre parenthèses après chaque entrée indique le nombre de concepts (objets ClassificationNode) que contient le parent.

  3. Développez les nœuds de concept sous le schéma de classification jusqu'à ce que vous trouviez le nœud feuille à partir duquel vous souhaitez faire votre recherche. Un nœud feuille est un nœud sous lequel ne figure aucun concept.

  4. Sélectionnez le nœud feuille.

  5. Cliquez sur le bouton Fermer de la fenêtre de sélection du nœud de classification.

    L'ID du concept que vous avez choisi s'affiche dans la zone de texte Valeur.

  6. Cliquez sur le bouton Rechercher ou placez le curseur dans la zone de texte Nom ou Description, ou appuyez sur Entrée.

Exécution de requêtes WSDL

Le panneau Recherche contient des requêtes prédéfinies qui vous permettent de rechercher des fichiers WSDL à l'aide de différents critères :

Cette section explique comment effectuer ces recherches. Pour l'ensemble des recherches, vous pouvez spécifier tous les critères de recherche désirés.

ProcedureExécution d'une requête de découverte WSDL

  1. Sélectionnez Requête de découverte WSDL dans la boîte combinée Sélectionner une requête prédéfinie.

    Un formulaire de recherche s'affiche.

  2. Saisissez des valeurs dans les champ Nom et/ou Description.

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

  4. Saisissez une valeur dans le champ Espace nom cible.

  5. Cliquez sur Rechercher ou appuyez sur Entrée.

ProcedureExécution d'une requête de découverte de liaison WSDL

  1. Sélectionnez Requête de découverte de liaison WSDL dans la boîte combinée Sélectionner une requête prédéfinie.

    Une formulaire de recherche s'affiche.

  2. Saisissez les valeurs désirées dans les champs Nom de liaison et/ou Description de liaison.

  3. Sélectionnez une valeur dans la boîte combinée État de la liaison.

  4. Saisissez une valeur dans le champ Espace nom cible liaison.

  5. Sélectionnez une valeur dans la boîte combinée Type de protocole de liaison.

  6. Sélectionnez une valeur dans la boîte combinée Type de transport de liaison.

  7. Sélectionnez une valeur dans la boîte combinée Style de liaison SOAP.

  8. Vous pouvez également cocher la case Prendre en compte le type de port. Si vous cochez cette case :

    1. Saisissez les valeurs désirées dans les champs Nom du type de port et/ou Description du type de port.

    2. Sélectionnez une valeur dans la boîte combinée État du type de port.

    3. Saisissez une valeur dans le champ Nom de l'espace ciblé pour le type de port.

  9. Cliquez sur Rechercher ou appuyez sur Entrée.

ProcedureExécution d'une requête de découverte de port WSDL

  1. Sélectionnez Requête de découverte du port WSDL dans la boîte combinée Sélectionner une requête prédéfinie.

    Une formulaire de recherche s'affiche.

  2. Saisissez les valeurs désirées dans les champ Nom du port et/ou Description du port.

  3. Sélectionnez une valeur dans la boîte combinée État port.

  4. Saisissez une valeur dans le champ Espace nom cible port.

  5. Saisissez une valeur dans le champ Point limite port.

  6. Vous pouvez également cocher la case Prendre en compte la liaison. Si vous avez coché cette case :

    1. Saisissez les valeurs désirées dans les champs Nom de liaison et/ou Description de liaison.

    2. Sélectionnez une valeur dans la boîte combinée État de la liaison.

    3. Saisissez une valeur dans le champ Espace nom cible liaison.

    4. Sélectionnez une valeur dans la boîte combinée Type de protocole de liaison.

    5. Sélectionnez une valeur dans la boîte combinée Type de transport de liaison.

    6. Sélectionnez une valeur dans la boîte combinée Style de liaison SOAP.

    7. Vous pouvez également cocher la case Prendre en compte le type de port. Si vous avez coché cette case :

      1. Saisissez les valeurs désirées dans les champs Nom du type de port et/ou Description du type de port.

      2. Sélectionnez une valeur dans la boîte combinée État du type de port.

      3. Saisissez une valeur dans le champ Nom de l'espace ciblé pour le type de port.

  7. Cliquez sur Rechercher ou appuyez sur Entrée.

ProcedureExécution d'une requête de découverte WSDL PortType

  1. Sélectionnez Requête de découverte WSDL PortType dans la boîte combinée Sélectionner une requête prédéfinie.

    Un formulaire de recherche s'affiche.

  2. Saisissez les valeurs désirées dans les champ Nom du type de port et Description du type de port.

  3. Sélectionnez une valeur dans la boîte combinée État du type de port.

  4. Saisissez une valeur dans le champ Nom de l'espace ciblé pour le type de port.

  5. Cliquez sur Rechercher ou appuyez sur Entrée.

ProcedureExécution d'une requête de découverte de service WSDL

  1. Sélectionnez Requête de découverte de service WSDL dans la boîte combinée Sélectionner une requête prédéfinie.

    Un formulaire de recherche s'affiche.

  2. Saisissez les valeurs désirées dans les champs Nom du service et/ou Description du service.

  3. Sélectionnez une valeur dans la boîte combinée État du service.

  4. Saisissez une valeur dans le champ Espace nom cible service.

  5. Vous pouvez également cocher la case Prendre en compte le port. Si vous avez coché cette case :

    1. Saisissez les valeurs désirées dans les champs Nom du port et/ou Description du port.

    2. Sélectionnez une valeur dans la boîte combinée État du port.

    3. Saisissez une valeur dans le champ Espace nom cible port.

    4. Saisissez une valeur dans le champ Point limite port.

    5. Vous pouvez également cocher la case Prendre en compte la liaison. Si vous avez coché cette case :

      1. Saisissez les valeurs désirées dans les champs Nom de liaison et/ou Description de liaison.

      2. Sélectionnez une valeur dans la boîte combinée État de la liaison.

      3. Saisissez une valeur dans le champ Espace nom cible liaison.

      4. Sélectionnez une valeur dans la boîte combinée Type de protocole de liaison.

      5. Sélectionnez une valeur dans la boîte combinée Type de transport de liaison.

      6. Sélectionnez une valeur dans la boîte combinée Style de liaison SOAP.

      7. Vous pouvez également cocher la case Prendre en compte le type de port. Si vous avez coché cette case :

        1. Saisissez les valeurs désirées dans les champ Nom du type de port et/ou Description du type de port.

        2. Sélectionnez une valeur dans la lise déroulante État du type de port.

        3. Saisissez une valeur dans le champ Nom de l'espace ciblé pour le type de port.

  6. Cliquez sur Rechercher ou appuyez sur Entrée.

Étapes suivantes

Pour plus d'informations sur la localisation du fichier WSDL associé au service détecté, reportez-vous à la section Recherche du document WSDL pour un service.

ProcedureRecherche du document WSDL pour un service

Après avoir créé un service, vous souhaiterez généralement trouver le fichier WSDL associé au service pour pouvoir l'utiliser pour créer un proxy client afin de communiquer avec le service. Pour cela, effectuez les opérations suivantes :

  1. Cliquez sur le lien Détails pour l'objet Service.

  2. Cliquez sur l'onglet Associations.

    La colonne Objet source contient un lien appelé WSDL.

  3. Cliquez sur le lien WSDL.

    Une fenêtre Détails s'affiche.

  4. Cliquez sur Voir le contenu de l'élément référentiel pour visualiser le fichier WSDL.

  5. Enregistrez le fichier sur le système local à l'aide de l'option de menu Enregistrer sous du navigateur.

Affichage des résultats de la recherche

Les objets trouvés suite à une recherche apparaissent dans la zone Objets de registre.

Cette zone est composée des éléments suivants :

Pour les objets ExtrinsicObject, deux colonnes supplémentaires sont affichées : Version du contenu et Commentaire de la version du contenu. Ces colonnes s'appliquent à l'élément référentiel de l'objet ExtrinsicObject.

Pour deux types d'objet, les colonnes Version et Commentaire de version sont remplacées par un autre intitulé :

ProcedureUtilisation de la fonction Signet

La fonction Signet de l'interface utilisateur vous permet de conserver un ou plusieurs objets dans la zone Objets de registre pendant la recherche d'autres objets. Vous pouvez alors créer une relation entre deux objets. Reportez-vous à la section Création d'une relation entre objets pour plus d'informations.

  1. Cliquez sur Recherche et exécutez une requête.

  2. Dans la zone Objets de registre, cochez la case Sélection pour l'objet que vous désirez conserver, puis cliquez sur le bouton Créer un signet.

    Les objets s'affichent alors dans la zone Objets marqués comme signet au-dessus des résultats de la recherche.

  3. Exécutez une autre requête.

Étapes suivantes

Lorsque vous avez terminé d'utiliser un objet marqué comme signet, cochez la case Sélection pour l'objet, puis cliquez sur le bouton Supprimer les signets. L'objet est supprimé de la zone Objets marqués comme signet. Si cet objet est seul à figurer dans la zone Objets marqués comme signet, cette dernière disparaît.

Affichage des détails de l'objet

Dans le tableau des résultats de recherche, cliquez sur le lien Détails d'un objet pour ouvrir la zone Détails sous la zone Objets de registre.

Cette section contient une rangée de boutons et une d'onglets :

Tableau 2–4 Onglets d'attributs de la zone Détails

Nom de l'onglet 

S'applique à 

Détails relatifs à Object_Type

Tous les objets (Object_Type est le nom du type d'objet)

Emplacements 

Tous les objets 

Classifications 

Tous les objets 

Identificateurs externes 

Tous les objets 

Associations 

Tous les objets 

Liens externes 

Tous les objets 

Piste d'audit 

Tous les objets 

Adresses postales 

Organisation, Utilisateur (User)

Numéros de téléphone 

Organisation, Utilisateur (User)

Adresses email 

Organisation, Utilisateur (User)

Utilisateurs 

Organisation

Organisations 

Organisation

Liaisons de service 

Service

Liens de spécification 

Liaison de Service (ServiceBinding)

Concepts 

Schéma de classification (ClassificationScheme), Nœud de Classification (ClassificationNode)

Membres 

Paquet de registre (RegistryPackage)

Objets affectés 

Événement pouvant faire l'objet d'un audit (AuditableEvent)

Cliquez sur un onglet pour savoir si l'attribut de l'objet contient des valeurs. S'il en contient, cliquez sur le lien Détails de la valeur d'attribut pour ouvrir la fenêtre de navigateur Web et afficher les détails de cette valeur.

L'onglet Associations génère un tableau contenant trois liens pour chaque association :

Dans les colonnes Objet source et Objet cible, le type d'objet dont vous visualisez les associations s'affiche en gras.

L'onglet Piste d'audit ne génère pas de tableau contenant le lien Détails. Cet onglet génère un tableau contenant les informations suivantes :

Pour la plupart des objets, les champs de la zone Détails sont les suivants :

Pour la plupart des objets, les champs sont explicites (adresses postales d'un objet Organization, par exemple). Pour certains objets, les champs demandent une explication. Les sections suivantes décrivent ces champs :

Affichage des détails d'un objet Association

La zone Détails correspondant à un objet Association contient les champs supplémentaires suivants :

Affichage des détails du schéma de classification

La zone Détails correspondant à un objet ClassificationScheme contient les champs supplémentaires suivants :

Affichage des détails d'objet Extrinsèque

La zone Détails correspondant à un objet ExtrinsicObject contient les champs supplémentaires suivants :

Affichage des détails de lien externe

La zone Détails correspondant à un objet ExternalLink contient les champs supplémentaires suivants :

Utilisation de l'onglet Explorer

L'onglet Explorer vous permet de parcourir le contenu de Registry et du référentiel à l'aide d'une métaphore de hiérarchie de dossiers de fichiers. Le dossier racine, nommé registry, contient la totalité du contenu de Registry.

ProcedureUtilisation de l'onglet Explorer

  1. Cliquez sur le lien Explorer.

  2. Cliquez sur le dossier appelé Registry. Ce dossier contient deux sous-dossiers : userData (où se trouve l'ensemble du contenu utilisateur) et ClassificationSchemes.

  3. Cliquez sur un lien pour afficher les objets Registry de ce type. Cliquez sur un dossier ou développez un nœud pour afficher les types d'objet du niveau suivant.

ProcedureExploration du dossier ClassificationSchemes

  1. Cliquez sur le dossier ClassificationSchemes pour ouvrir l'arborescence ClassificationSchemes dans la zone de menus.

  2. Cliquez sur un lien pour visualiser ce schéma de classification dans la zone Objets de registre.

  3. Cliquez sur un dossier de schéma de classification pour visualiser les concepts qu'il contient.

    Si les icônes de concept sont des dossiers, elles contiennent des sous-concepts et vous pouvez cliquer dessus pour les développer. Si les icônes de concept sont des fichiers, elles ne contiennent aucun sous-concept.

    Si le dossier du schéma de classification est une icône de fichier, le schéma de classification n'inclut pas de concepts pouvant être visualisés dans la zone Explorer.

  4. Cliquez sur un lien Concept pour afficher le concept dans la zone Objets de registre.

ProcedureExploration du dossier UserData

  1. Développez le nœud userData.

  2. Développez le nœud RegistryObject. Ne cliquez sur le dossier que si vous souhaitez afficher tous les objets de registre.

  3. Cliquez sur un dossier pour afficher les objets de registre de ce type. Développez un nœud pour afficher les types d'objet du niveau suivant.