Implémentation d'un mécanisme externe de déclenchement d'un lot

Article
07/21/2023

Vous pouvez activer le déclenchement d'un lot à l'aide d'un déclencheur externe. Le déclenchement peut être activé automatiquement par une application sectorielle principale lorsqu'un seuil spécifique est atteint. Ce mécanisme s’ajoute au déclenchement automatique de la mise en production du lot par une planification ou un nombre de jeux de transactions ou de caractères, ou au déclenchement manuel du lot en cliquant sur le bouton Remplacer dans la page Configuration du lot de l’onglet contrat unidirectionnel.

Pour implémenter un déclencheur externe, vous devez configurer un port et un emplacement de réception pour le traitement de OverrideControlMessage. L’emplacement de réception doit utiliser le pipeline de Edi.BatchControlMessageRecvPipeline réception. Il s’agit du même pipeline que celui utilisé par l’emplacement de réception BatchControlMessageRecvLoc que BizTalk Server utilise pour traiter les messages de remplacement manuels. Toutefois, BatchControlMessageRecvLoc est un emplacement de réception SQL tandis que l'emplacement de réception que vous configurez pour un déclencheur externe peut utiliser un autre type d'adaptateur.

Un déclenchement externe est exécuté par un message de contrôle XML. Pour déclencher le lot, l'application principale achemine le message de contrôle vers l'emplacement de réception. Vous pouvez modifier le message de contrôle pour activer, remplacer ou arrêter le lot. Consultez la procédure suivante de création du message de contrôle.

Pour activer le déclencheur de mise en production externe, vous devez sélectionner la propriété Déclencheur de mise en production externe dans la page Configuration par lot de la boîte de dialogue Propriétés du contrat pour X12 ou EDIFACT. Cette propriété indique qu'un message de déclenchement externe est nécessaire pour le déclenchement du lot. Le bouton Remplacer , le bouton Arrêter et les contrôles Plage d’activation restent valides si la propriété Déclencheur de mise en production externe a été sélectionnée.

Prérequis

Vous devez être connecté en tant que membre du groupe Administrateurs BizTalk Server ou BizTalk Server groupe Opérateurs B2B.

Pour créer un emplacement de réception pour le message de déclenchement externe du lot

Dans BizTalk Server console d’administration, créez un port de réception unidirectionnel. Pour obtenir des instructions sur la création d’un port de réception, consultez Guide pratique pour créer un port de réception.
Créez un emplacement de réception unidirectionnel dans le port de réception.
Sélectionnez le type de transport. Vous pouvez sélectionner un type quelconque pour cet emplacement de réception. Une solution courante consiste à sélectionner le type FILE et à entrer un dossier pour la réception du fichier.
Pour Pipeline de réception, sélectionnez BatchControlMessageRecvPipeline.
Cliquez sur OK.

Pour créer le message de déclenchement externe du lot

Dans le Bloc-notes, créez un fichier et nommez celui-ci avec une extension .xml.
Ajoutez le code suivant au fichier :
```
<?xml version="1.0" encoding="utf-8"?>  
<ControlMessage xmlns="http://SQLControlMessage.IssueSelect">  
  <PAM_Control xmlns="http://SQLControlMessage.IssueSelect">  
    <DestinationParty>[Party ID]</DestinationParty>  
    <EdiMessageType>[0 for X12\HIPAA|1 for Edifact]</EdiMessageType>  
    <ActionType>EdiBatchOverride</ActionType>  
    <ActionDateTime>[yyyy-mm-ddThh:mm:ss.sss]</ActionDateTime>  
    <UsedOnce>0</UsedOnce>  
    <BatchId>[Batch ID]</BatchId>  
    <BatchName>[Batch Name]</BatchName>  
    <DestinationPartyName>[Destination Party/Partner name]</DestinationPartyName>  
    <SenderPartyName>[Sender Party/Partner name]</SenderPartyName>  
    <AgreementName>[Agreement Name]</AgreementName>  
    <ReceiverPartyNameType>[Receiver Party/Partner name]</ReceiverPartyNameType>  
    <ToBeBatched>1</ToBeBatched>  
  </PAM_Control>  
</ControlMessage>  
```
Remplacez les valeurs du fragment ci-dessus comme suit :
- Spécifiez le type d'action. En règle générale, l’ActionType doit être défini sur EdiBatchOverride pour remplacer les paramètres de lot effectués dans le contrat. Vous pouvez également définir ce paramètre sur EdiBatchTerminate pour terminer le lot via un déclencheur externe.
  
  Notes
  
  Il est déconseillé d'utiliser un déclencheur externe pour activer un lot. Par conséquent, vous ne devez pas spécifier ActionType comme EdiBatchActivate.
- Déterminez l'ID et le nom du lot. Pour ce faire, ouvrez la boîte de dialogue Propriétés de l’accord et, sous l’onglet Contrat unidirectionnel, cliquez sur Configuration par lot. Cliquez sur l’onglet pour remplacer le lot et entrez la valeur des champs Nom du lot et ID de lot dans les nœuds BatchName et BatchID du message de contrôle.
- Spécifiez le nom du tiers de destination. Dans la console Administration BizTalk Server, cliquez sur le nœud Parties et, dans la page Parties et profils d’entreprise, obtenez le nom du tiers/partenaire qui recevra les échanges par lots. Entrez le nom dans le nœud ReceiverPartyNameType du message de contrôle.
- Spécifiez le nom du tiers expéditeur. Dans la console d’administration BizTalk Server, cliquez sur le nœud Parties et, dans la page Parties et profils d’entreprise, obtenez le nom du tiers/partenaire qui enverra les échanges par lots. Entrez le nom dans le nœud SenderPartyName du message de contrôle.
- Spécifiez le nom de l'accord. Dans la console Administration BizTalk Server, cliquez sur le nœud Parties, puis, dans la page Parties et profils d’entreprise, dans la section Contrats, cliquez avec le bouton droit sur le contrat dont la configuration de lot doit être remplacée à l’aide du message de contrôle, puis cliquez sur Propriétés. Dans la boîte de dialogue Propriétés du contrat , sous l’onglet Général , dans la page Propriétés générales , copiez la valeur du champ Nom de la section Paramètres de l’accord , puis collez-la dans le nœud AgreementName du message de contrôle.
Notes

Il n'est pas nécessaire de spécifier un ID de tiers de destination. Cet élément est requis dans le message de contrôle uniquement à des fins de compatibilité descendante.
Enregistrez le fichier .

Pour activer le déclencheur externe

Dans la console Administration BizTalk Server, cliquez sur le nœud Parties, puis, dans la page Parties et profils d’entreprise, dans la section Contrats, cliquez avec le bouton droit sur le contrat dont la configuration de lot doit être remplacée à l’aide du message de contrôle, puis cliquez sur Propriétés. Dans la boîte de dialogue Propriétés de l’accord , sous l’onglet Accord unidirectionnel, cliquez sur Configuration par lot.
Dans la page Configuration du lot , cliquez sur l’onglet du lot pour lequel vous souhaitez avoir un déclencheur de mise en production externe, puis, dans la section Mise en production , sélectionnez Déclencheur de mise en production externe.
Cliquez sur OK.

Voir aussi

Configuration des lots EDI
Création d'un emplacement de réception

Partager via