Définition d’une règle métier pour une orchestration de processus privé

2025-06-05

Vous pouvez définir une règle métier à utiliser dans un processus privé de reconnaissance. Cela vous permet de modifier dynamiquement la règle métier sans arrêter l’orchestration de processus privé. Ce processus utilise le moteur de règles métier Microsoft® BizTalk Accelerator pour RosettaNet (BTARN). Le processus implique les étapes suivantes :

Ajout d’un nouveau vocabulaire. Cela implique de définir au moins une valeur constante de vocabulaire. Cela établit un seuil pour les règles métier. Il implique également la définition des éléments Get et Set des documents XML. Cela établit la façon dont Microsoft BTARN utilise le seuil.
Ajout d’une nouvelle stratégie. Cela implique la création d’une stratégie, la création d’un ensemble de règles, puis l’enregistrement, la publication et le déploiement de la stratégie.
Appel de la règle métier à partir de l'orchestration de processus interne. Cela implique l’ajout d’une forme Règles d'Appel à l’orchestration.

Le SDK BTARN inclut un exemple de stratégie métier BTARN, samplebtarnpolicy.xml, dans <drive> :\Program Files\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\PipAutomation\3A4. Pour plus d’informations, consultez l’exemple de stratégie métier BTARN.

L’orchestration PIP3A4PrivateResponder.odx est un exemple d’orchestration de processus privé qui montre comment implémenter un processus privé de réponse spécifique à PIP (Partner Interface Process) intégrant une règle métier. Pour plus d’informations sur cet exemple, consultez 3A4 Orchestration de réponse privée à l’aide d’une règle commerciale.

Pour plus d’informations sur les vocabulaires et les stratégies, consultez la rubrique « Développement avec des règles métier » dans BizTalk Server.

Pour ajouter un nouveau vocabulaire

Cliquez sur Démarrer, pointez sur Tous les programmes, pointez sur MicrosoftBizTalk Server, puis cliquez sur Compositeur de règles d’entreprise.
Si la boîte de dialogue Ouvrir le magasin de règles s’ouvre, sélectionnez la base de données du moteur de règles BizTalk que vous avez configurée sur le serveur actuel, puis cliquez sur OK.
Dans Microsoft Business Rule Composer, dans le volet Explorateur de faits, cliquez avec le bouton droit sur Vocabulaires, puis cliquez sur Ajouter un nouveau vocabulaire.
Dans le volet Propriétés (en bas à gauche), définissez la propriété Name sur le nom du vocabulaire approprié, puis appuyez sur Entrée.
Développez le dossier de vocabulaire que vous venez de créer, cliquez avec le bouton droit sur la version 1.0 (non enregistrée), puis cliquez sur Ajouter une nouvelle définition.
Dans la page De l’Assistant Définition de vocabulaire , sélectionnez Valeur constante, Plage de valeurs ou Ensemble de valeurs, puis cliquez sur Suivant.
Sur la valeur constante, la plage de valeurs ou la page Définir des valeurs , dans la zone Nom de la définition , tapez le nom de la valeur constante de vocabulaire appropriée, telle que La quantité maximale autorisée, puis cliquez sur Suivant.
Dans la page Définir une valeur constante , dans la zone Champ Valeur , tapez le seuil, puis cliquez sur Terminer.

Pour définir les éléments « Get » et « Set »

Dans le Compositeur de règles d'entreprise, dans le volet Explorateur de faits, sous le dossier de vocabulaire créé dans la section « Pour ajouter une nouvelle procédure de vocabulaire », cliquez sur la version 1.0 (non enregistrée) puis cliquez sur Ajouter une nouvelle définition.
Dans la page De l’Assistant Définition de vocabulaire , sélectionnez Élément de document XML ou Attribut, puis cliquez sur Suivant.
Dans la page Élément de document XML ou Attribut , dans la zone de texte Nom de définition, tapez un nom pour un élément Get .
Cliquez sur Parcourir, accédez à l’emplacement du schéma que vous souhaitez utiliser, sélectionnez le fichier de schéma, puis cliquez sur Ouvrir.
Si la page Sélectionner un nœud racine s’ouvre, sélectionnez le nœud racine à parcourir.
Dans la page Sélectionner une liaison , accédez au champ pour lequel vous souhaitez définir le seuil, puis cliquez sur OK.
Dans la zone Type de document , tapez le nom du document.
Dans la section Type d’opération, sélectionnez Effectuer l’opération « Obtenir ».
Cliquez sur Terminer.
Répétez ces étapes pour définir une ou plusieurs Set opérations, sélectionnez Effectuer l’opération « Définir » pour le type d’opération.

Pour enregistrer et publier le vocabulaire

Dans le Compositeur de règles métier, dans le volet Explorateur de faits, sous le dossier de vocabulaire que vous avez créé, cliquez avec le bouton droit sur la version 1.0 (non enregistrée), puis cliquez sur Enregistrer.
Dans le volet Explorateur de faits, sous le dossier 3A4PurchaseOrderVocabulary, cliquez avec le bouton droit sur Version 1.0, puis sélectionnez Publier.

Pour ajouter une nouvelle stratégie et des règles

Dans Le compositeur de règles d’entreprise, dans le volet Explorateur de stratégies, cliquez avec le bouton droit sur Stratégies, puis cliquez sur Ajouter une nouvelle stratégie.
Cliquez sur Policy1.
Dans le volet Propriétés, définissez la propriété Name sur le nom de stratégie approprié.
Dans le volet Explorateur de stratégies, sous le dossier de la nouvelle stratégie, cliquez avec le bouton droit sur la version 1.0 (non enregistrée), puis cliquez sur Ajouter une nouvelle règle.
Cliquez sur Règle1.
Dans le volet Propriétés, définissez la propriété Name sur le nom de la règle souhaitée, puis appuyez sur Entrée.
Dans le compositeur de règles, sous le volet SI , cliquez avec le bouton droit sur Conditions, puis sélectionnez une condition logique, le cas échéant.
Dans le volet Explorateur de faits, sous Vocabulaires, développez Prédicats, développez Version 1.0 - Publiée, sélectionnez le prédicat souhaité, faites-le glisser vers la zone de composition, puis déposez-le sur Conditions ou l’opérateur logique.
Dans le volet Explorateur de faits, sous le dossier Vocabulaires, déroulez le vocabulaire que vous avez créé, déroulez Version 1.0 - Publiée, sélectionnez un élément Get ou Set, faites-le glisser vers la surface du compositeur et déposez-le sur argument1.
Sous le dossier de vocabulaire, sélectionnez un élément Get ou Set, faites-le glisser vers la zone du compositeur et déposez-le sur argument2.
Sous le dossier de vocabulaire, sélectionnez un élément Set, faites-le glisser vers la surface du compositeur et déposez-le dans la zone Actions du volet THEN.
Si une variable est associée à l’élément Set , cliquez sur la variable, apportez des modifications le cas échéant, puis appuyez sur Entrée. Si nécessaire, répétez avec d’autres Set éléments.

Pour enregistrer, publier et déployer la politique

Une fois que vous avez terminé de définir les règles, dans Le compositeur de règles métiers, dans le volet Explorateur de stratégies, sous le dossier de stratégie que vous avez créé, cliquez avec le bouton droit sur la version 1.0 (non enregistrée), puis cliquez sur Enregistrer.
Dans le volet Explorateur de stratégies, sous le dossier de stratégie que vous avez créé, cliquez avec le bouton droit sur version 1.0, puis cliquez sur Publier.
Dans le volet Explorateur de stratégies, sous le dossier de stratégie que vous avez créé, cliquez avec le bouton droit sur la version 1.0, puis cliquez sur Déployer.

Pour appeler la règle métier à partir de l’orchestration

Démarrez Microsoft Visual Studio 2012.
Dans le menu Fichier , pointez sur Ouvrir, puis cliquez sur Projet/Solution.
Recherchez la solution qui contient l’orchestration depuis laquelle vous devez faire appel à la règle métier, puis cliquez sur Ouvrir.
Cliquez sur Affichage, pointez sur Autres fenêtres, puis cliquez sur Mode Orchestration.
Développez Variables. Assurez-vous que la liste des variables d’orchestration contient une variable qui correspond à chaque paramètre de la stratégie métier que vous appelez à partir de l’orchestration. Vérifiez que la variable a le même type que le paramètre de stratégie. Si la liste ne contient pas de variable d’orchestration pour chaque paramètre de stratégie, cliquez avec le bouton droit sur Variables, puis cliquez sur Nouvelle variable. En mode Orchestration, tapez un nom de variable, puis dans la fenêtre Propriétés, entrez le type du paramètre.
Dans la boîte à outils, faites glisser un élément Règles d’appel sur la surface de conception de l’orchestration, puis déposez-le sous l’élément Recevoir.
Double-cliquez sur la forme Règles d’appel .
Dans la zone Sélectionner la stratégie métier que vous souhaitez appeler , sélectionnez la stratégie métier dans la liste déroulante.
Pour le premier paramètre affiché, pour Nom du paramètre, sélectionnez un nom dans la liste déroulante.

Remarque

BTARN remplit la liste des paramètres de stratégie avec tous les paramètres de la stratégie métier. Pour chaque paramètre de la liste, BTARN entre une valeur dans Le type de paramètre à partir de la stratégie métier. Dans la liste déroulante associée au Nom du paramètre, BTARN entre les noms de toutes les variables de la liste de variables de l’orchestration qui ont le même type que les paramètres de stratégie. En sélectionnant une variable d’orchestration, vous associez cette variable au paramètre de stratégie. Vous pouvez afficher les variables d’orchestration en mode Orchestration.
Répétez l’étape 9 pour tous les autres paramètres.
Dans la fenêtre Création d’orchestration, entrez toutes les formes supplémentaires requises pour le traitement associé à la stratégie métier, notamment l’ajout d’une forme Décision sous la forme Règles d’appel .

Remarque

Pour obtenir un exemple d’utilisation d’une forme de règles d’appel dans une orchestration, consultez l’orchestration PIP3A4PrivateResponder.odx incluse dans le Kit de développement logiciel (SDK) BTARN. Il se trouve sur <drive> :\Program Files\Microsoft BizTalk <version> Accelerator for RosettaNet\SDK\PipAutomation\3A4\PR. Pour plus d’informations, consultez L'Orchestration de Répondeur Privé 3A4 à l’aide d’une Règle d’Entreprise.
Cliquez sur OK.

Voir aussi

Guide de programmation
Exemple de stratégie métier BTARN
Orchestration de répondeur privé 3A4 à l’aide d’une règle d’entreprise