Services : Création de règles de médiation pour des services

Utilisez le widget Administration des règles de médiation pour créer des règles de médiation et des annexes de politique dans WebSphere Service Registry and Repository (WSRR). Les règles de médiation permettent de contrôler les interactions des services en utilisant des informations contextuelles.

Avant de commencer

  1. Utilisez IBM Integration Designer pour créer un module contenant une primitive de médiation Résolution de règle.
  2. Déployez le module dans WebSphere Enterprise Service Bus (WebSphere ESB) ou IBM Business Process Manager.
  3. Vérifiez que WebSphere ESB ou IBM Business Process Manager contient une définition pour le WSRR que vous souhaitez.
  4. Dans WSRR, chargez le fichier d'archive d'entreprise qui contient votre module. Chargez également les documents WSDL correspondant aux services pour lesquels vous souhaitez joindre des règles de médiation.
  5. Créez un espace métier qui contient les widgets d'administration nécessaires, notamment le widget Navigateur de services et Administration des règles de médiation.

Pourquoi et quand exécuter cette tâche

Vous pouvez contrôler les demandes de service dynamiquement à l'aide des règles de médiation qui permettent de remplacer les propriétés du module lors de l'exécution. Ces règles de médiation sont enregistrées dans WSRR. Vous pouvez définir une ou plusieurs règles de médiation pour les services utilisés par votre module ; chaque règle peut remplacer une ou plusieurs propriétés de module. En option, vous pouvez créer une ou plusieurs conditions à l'entrée dans chaque connexion de règle. Lors de l'exécution des demandes de service, les conditions à l'entrée sont comparées aux valeurs de condition dans le message. Toutes les conditions à l'entrée doivent être remplies pour qu'une règle de médiation associée puisse être utilisée.

Procédure

  1. Connectez-vous à votre espace métier et accédez à l'espace que vous avez créé pour administrer les services.
  2. Dans le widget Navigateur de services, vérifiez que la définition WSRR correcte est affichée. Si ce n'est pas le cas, sélectionnez la définition WSRR correcte. Si votre serveur d'applications comporte des définitions pour plusieurs instances de WSRR, vous pouvez afficher les services qui sont définis sur chaque instance. La liste des services est actualisée.
  3. Sélectionnez le niveau auquel vous voulez créer une règle de médiation. Vous pouvez joindre une règle de médiation au niveau du service, du noeud final ou d'une opération. Le widget Administration des règles de médiation s'actualise. L'opération suivante s'affiche :
    • Le nom du service, noeud final ou de l'opération que vous avez sélectionné.
    • La définition WSRR sélectionnée.
    • Les connexions de règles existant éventuellement pour le service, le noeud final ou l'opération sélectionné.
  4. Entrez le nom de la Nouvelle connexion de règles. Les connexions de règles associent une règle de médiation à un service cible. Dans WSRR, la règle et la connexion de règle sont deux éléments distincts.
  5. Cliquez sur Créer Le widget Administration des règles de médiation s'actualise. Vous pouvez à présent spécifier le groupe de propriétés qui vous intéresse et le nom de la nouvelle règle de médiation.
  6. Sélectionnez un nom de groupe. Chaque groupe contient les propriétés du module. Sélectionnez le groupe dont vous voulez remplacer les valeurs de propriété.
  7. Entrez un nom dans la zone Nouvelle règle. Il s'agit du nom de la règle de médiation que vous voulez créer et connecter au service, noeud final ou opération.
  8. Cliquez sur Suivant Le widget Administration des règles de médiation s'actualise. Vous pouvez maintenant ajouter des assertions et des conditions à l'entrée.
    Remarque : Vous ne pouvez pas modifier les assertions de règles de médiation dans un espace métier une fois que vous avez créé une règle de médiation. Vous devez donc ajouter toutes les assertions dont vous avez besoin avant d'enregistrer la règle de médiation.
  9. Définissez une ou plusieurs assertions. Les assertions correspondent à des propriétés du module auxquelles la règle de médiation peut se substituer. Dans WSRR, les propriétés du module que vous voulez remplacer apparaissent sous la forme d'assertions de règle.
    Remarque : Le widget requiert que chaque connexion de règle possède au moins une assertion.
    1. Sélectionnez un nom de propriété. Il s'agit du nom d'alias de la propriété. Il permet d'identifier la propriété dans le flux de médiation.
    2. Entrez une valeur adaptée dans la zone Valeur. Par exemple, All, 10 ou /body/input/address. Lorsque celle-ci est disponible, elle est prioritaire lors de l'exécution. Si aucune règle n'est trouvée, ou si la règle n'est pas adaptée, l'environnement d'exécution utilise la valeur de la propriété promue.
    3. Cliquez sur Ajouter une assertion.
  10. Facultatif : Définissez une ou plusieurs conditions à l'entrée. Les conditions à l'entrée doivent être remplies pour que la règle puisse être utilisée. Dans WSRR, les conditions à l'entrée sont des propriétés utilisateur de l'objet de connexion de règle.
    1. Entrez un nom de condition à l'entrée dans la zone Nom de la connexion à l'entrée. Le nom d'une condition à l'entrée commence toujours par le préfixe medGate_.
    2. Entrez une valeur de condition à l'entrée dans la zone Valeur. La valeur de la condition à l'entrée est constituée des éléments suivants : nom de la condition de règle, opération et valeur à l'entrée.
      • Le nom de la condition de règle que vous entrez doit être associé à un nom de condition de règle dans le module.
      • L'opération peut correspondre à : = , != , > , < , <= ou >= .
      • La valeur à l'entrée est celle avec laquelle la comparaison est établie (par exemple, country = France).
    3. Cliquez sur Ajouter une condition de passerelle.
  11. Facultatif : Si vous souhaitez supprimer une assertion ou une condition à l'entrée, cliquez sur l'icône de suppression de l'assertion ou de la condition à l'entrée appropriée. Si vous placez le curseur de la souris sur une assertion ou une condition à l'entrée, l'icône de suppression, en forme de croix, apparaît à la fin de la ligne.
  12. Cliquez sur Enregistrer.

Résultats

Dans WSRR, une règle de médiation et une connexion de règle sont créées. La connexion connecte la règle de médiation au service, noeud final ou à l'opération. Si vous avez ajouté une condition à l'entrée, WSRR crée une propriété utilisateur sur la connexion de la règle. La propriété utilisateur représente la condition.