Implementazione di un meccanismo di rilascio batch esterno

Articolo
10/14/2023

È possibile attivare il rilascio di un batch mediante un trigger di rilascio esterno. Il rilascio può essere attivato automaticamente da un'applicazione line-of-business back-end al raggiungimento di una determinata soglia. Questo meccanismo consente di attivare automaticamente il rilascio batch in base a una pianificazione o a un conteggio di set di transazioni o caratteri oppure attivando manualmente il batch facendo clic sul pulsante Override nella pagina Configurazione batch della scheda contratto unidirezionale.

Per implementare un trigger di rilascio esterno, è necessario configurare una porta e un indirizzo di ricezione per elaborare OverrideControlMessage. Il percorso di ricezione deve usare la Edi.BatchControlMessageRecvPipeline pipeline di ricezione. Si tratta della stessa pipeline usata dal percorso di ricezione batchControlMessageRecvLoc che BizTalk Server usa per elaborare i messaggi di override manuale. BatchControlMessageRecvLoc è, tuttavia, un indirizzo di ricezione di tipo SQL, mentre l'indirizzo di ricezione configurato per un trigger di rilascio esterno può utilizzare qualsiasi tipo di adapter.

Un rilascio di un batch esterno viene attivato da un messaggio di controllo XML. Per attivare il batch, l'applicazione back-end instrada il messaggio di controllo all'indirizzo di ricezione. È possibile modificare il messaggio di controllo per attivare e terminare il batch o eseguirne l'override. Per la creazione del messaggio di controllo, vedere la procedura seguente.

Per abilitare il trigger di rilascio esterno, è necessario selezionare la proprietà Trigger di rilascio esterno nella pagina Configurazione batch della finestra di dialogo Proprietà contratto per X12 o EDIFACT. Questa proprietà indica che è necessario un messaggio di rilascio esterno per il rilascio del batch. Il pulsante Override , il pulsante Stop e i controlli Intervallo di attivazione rimangono validi se è stata selezionata la proprietà Trigger di versione esterna .

Prerequisiti

È necessario essere connessi come membro del gruppo Administrators BizTalk Server o BizTalk Server gruppo Operatori B2B.

Per creare un indirizzo di ricezione per il messaggio del trigger di rilascio del batch esterno

In BizTalk Server Console di amministrazione creare una porta di ricezione unidirezionale. Per istruzioni su come creare una porta di ricezione, vedere Come creare una porta di ricezione.
Creare un indirizzo di ricezione unidirezionale nella porta di ricezione.
Selezionare il tipo di trasporto. È possibile selezionare qualsiasi tipo per questo indirizzo di ricezione. Una soluzione comune consiste nel selezionare il tipo FILE e immettere una cartella in cui ricevere il file.
Per La pipeline di ricezione selezionare BatchControlMessageRecvPipeline.
Fare clic su OK.

Per creare il messaggio del trigger di rilascio del batch esterno

Nel Blocco note creare un nuovo file e assegnargli un nome con estensione xml.
Aggiungere il codice seguente al file:
```
<?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>  
```
Sostituire i valori nell'estratto precedente come indicato di seguito:
- Specificare il tipo di azione. In genere, actionType deve essere impostato su EdiBatchOverride per eseguire l'override delle impostazioni batch eseguite nel contratto. È anche possibile impostare questa opzione su EdiBatchTerminate per terminare il batch tramite un trigger esterno.
  
  Nota
  
  Microsoft consiglia di non utilizzare il trigger di rilascio esterno per attivare un batch. Non è quindi consigliabile specificare ActionType come EdiBatchActivate.
- Determinare l'ID batch e il nome batch. A tale scopo, aprire la finestra di dialogo Proprietà contratto e nella scheda contratto unidirezionale fare clic su Configurazione batch. Fare clic sulla scheda per l'override del batch e immettere il valore dei campi Nome batch e ID Batch nei nodi BatchName e BatchID del messaggio di controllo.
- Specificare il nome dell'entità di destinazione. Nella console di amministrazione di BizTalk Server fare clic sul nodo Parti e nella pagina Profili aziendali e parti ottenere il nome dell'entità/partner che riceverà gli interscambi in batch. Immettere il nome nel nodo ReceiverPartyNameType del messaggio di controllo.
- Specificare il nome dell'entità mittente. Nella console di amministrazione BizTalk Server fare clic sul nodo Parti e nella pagina Profili aziendali e parti ottenere il nome dell'entità/partner che inviano gli interscambi in batch. Immettere il nome nel nodo SenderPartyName del messaggio di controllo.
- Specificare il nome dell'accordo. Nella console di amministrazione di BizTalk Server fare clic sul nodo Parti e nella pagina Profili aziendali e parti nella sezione Contratti fare clic con il pulsante destro del mouse sul contratto con la configurazione batch che deve essere sottoposto a override usando il messaggio di controllo e quindi fare clic su Proprietà. Nella scheda Generale della finestra di dialogo Proprietà contratto copiare il valore dal campo Nome nella sezione Parametri contratto e incollarlo nel nodo AgreementName del messaggio di controllo.
Nota

Non è necessario specificare un ID entità di destinazione. L'elemento è necessario nel messaggio di controllo solo per la compatibilità con le versioni precedenti.
Salvare il file.

Per abilitare il trigger di rilascio esterno

Nella console di amministrazione di BizTalk Server fare clic sul nodo Parti e nella pagina Profili aziendali e parti nella sezione Contratti fare clic con il pulsante destro del mouse sul contratto con la configurazione batch che deve essere sottoposto a override usando il messaggio di controllo e quindi fare clic su Proprietà. Nella scheda Contratto proprietà della finestra di dialogo Proprietà contratto fare clic su Configurazione batch.
Nella pagina Configurazione batch fare clic sulla scheda per il batch per il quale si vuole avere un trigger di rilascio esterno e quindi nella sezione Versione selezionare Trigger versione esterna.
Fare clic su OK.

Vedere anche

Configurazione dei batch EDI
Come creare un indirizzo di ricezione

Condividi tramite