Invio di un riconoscimento EDI
I riconoscimenti indicano lo stato di trasmissione dei messaggi EDI. Dopo che BizTalk Server riceve un interscambio EDI, restituisce uno o più riconoscimenti al mittente di un interscambio EDI, a seconda dei riconoscimenti abilitati.
I riconoscimenti dei messaggi EDI si suddividono in due tipi, determinati dal livello di convalida:
Riconoscimento tecnico generato in seguito alla convalida dell'intestazione. Il riconoscimento tecnico segnala lo stato dell'elaborazione di un'intestazione e finale di interscambio in base all'indirizzo del ricevitore.
Riconoscimento funzionale generato in seguito alla convalida del corpo. Il riconoscimento funzionale segnala ogni errore rilevato durante l'elaborazione del documento ricevuto.
BizTalk Server possono restituire riconoscimenti tecnici e funzionali in risposta a un singolo interscambio. BizTalk Server restituisce un singolo riconoscimento tecnico per ogni interscambio. Per gli interscambi X12 restituisce un riconoscimento funzionale per ogni gruppo ricevuto, mentre per gli interscambi EDIFACT restituisce un riconoscimento funzionale per ogni interscambio, indipendentemente dal numero di gruppi contenuti in tale interscambio.
Riconoscimenti X12
Riconoscimento tecnico X12
Se l'intestazione ISA e il trailer IEA di un messaggio X12 sono validi (indipendentemente da altro contenuto), viene inviato un riconoscimento positivo TA1. Per altre informazioni sul contenuto di un riconoscimento TA1, vedere Riconoscimento X12 TA1.
Riconoscimento funzionale X12
Per riconoscere la ricezione di un interscambio o di un gruppo funzionale, per accettare o rifiutare uno o più gruppi funzionali o una o più transazioni e per verificare e segnalare la conformità agli standard, viene usato un riconoscimento 997. Se BizTalk Server riceve un interscambio con più gruppi, restituirà un riconoscimento per ogni gruppo. Se un gruppo contiene più set di transazioni, il riconoscimento relativo a tale gruppo conterrà più cicli AK2, uno per ogni set di transazioni, a seconda che i cicli AK2 vengano generati o meno per i set di transazioni accettati. Per altre informazioni sul contenuto di un riconoscimento 997, vedere Riconoscimento X12 997.
Nota
Quando la pipeline di ricezione EDI crea il segmento GS (Intestazione gruppo funzionale) per il riconoscimento funzionale X12, il codice mittente applicazione (GS02) e il codice ricevitore applicazione (GS03) vengono recuperati dal gruppo funzionale sottoposto a riconoscimento. Tuttavia, il codice GS02 nel messaggio in arrivo è mappato al codice GS03 nell'ACK e il codice GS03 nel messaggio in arrivo è mappato al codice GS02 nell'ACK.
Riconoscimenti EDIFACT
Riconoscimento tecnico EDIFACT
Per EDIFACT non viene usato un riconoscimento tecnico distinto, bensì vengono riutilizzate sezioni del riconoscimento funzionale o dell'ACK CONTRL (vedere più avanti) per l'ACK di ricezione. Questo comportamento emula un riconoscimento tecnico.
Per altre informazioni sul riconoscimento CONTRL tecnico, vedere Messaggio CONTRL EDIFACT come riconoscimento tecnico.
Riconoscimento funzionale EDIFACT
Per EDIFACT viene usato il riconoscimento funzionale CONTRL per riconoscere un interscambio, un gruppo e un messaggio ricevuti, per accettare o rifiutare un interscambio, un gruppo e un messaggio ricevuti e per elencare gli eventuali errori di sintassi e le funzionalità non supportate contenuti in tali elementi. L'ACK CONTRL segnala i risultati di un controllo sintattico dell'interscambio completo ricevuto.
Per altre informazioni sul riconoscimento CONTRL funzionale, vedere Messaggio CONTRL EDIFACT come riconoscimento funzionale.
Condizioni per la generazione di un riconoscimento
La pipeline di ricezione EDI genera un riconoscimento in presenza di una delle seguenti condizioni:
Un elemento dati nell'interscambio ricevuto richiede il riconoscimento. Per i messaggi con codifica X12, la pipeline di ricezione genererà un ACK TA1 tecnico se l'elemento dati ISA14 è impostato su 1. Per i messaggi con codifica EDIFACT, la pipeline di ricezione genererà un ACK CONTRL tecnico se l'elemento dati UNB9 è impostato su 2 e genererà un ACK CONTRL funzionale se l'elemento dati UNB9 è impostato su 1.
Una proprietà dell'accordo richiede il riconoscimento. Per gli interscambi X12, queste proprietà sono le proprietà previste TA1 e 997 Previste nella pagina Riconoscimenti delle schede del contratto bidirezionale della finestra di dialogo Proprietà contratto contratto . Per gli interscambi EDIFACT, queste proprietà sono la ricezione del messaggio (CONTRL) prevista e l'acknowledgement (CONTRL) previsti nella pagina Acknowledgements (Acknowledgements ) delle schede del contratto bidirezionale della finestra di dialogo Proprietà contratto . Quando si abilita un tipo di riconoscimento, è inoltre possibile indicare se si desidera inviarlo in batch.
Una proprietà globale richiede il riconoscimento quando non è determinato alcun accordo per l'interscambio. Si tratta delle proprietà
TA1 Proprietà previste e 997 Previste nella pagina Riconoscimenti della scheda Contratto della finestra di dialogo Impostazioni di fallback X12 .
Prevista la ricezione del messaggio (CONTRL) e dell'acknowledgement (CONTRL) nella pagina Acknowledgements (Acknowledgements ) della scheda Contratto della finestra di dialogo Impostazioni di fallback EDIFACT .
Per EDIFACT, la pipeline di ricezione EDI restituisce due riconoscimenti CONTRL distinti se vengono richiesti sia un riconoscimento tecnico che un riconoscimento funzionale. L'ACK CONTRL tecnico includerà solo le informazioni relative al riconoscimento della ricezione. L'ACK CONTRL funzionale includerà sia le informazioni di ricezione che le informazioni relative al riconoscimento funzionale. Per altre informazioni, vedere Riconoscimento CONTRL EDIFACT.
Identificazione di un riconoscimento con un numero di controllo
Ogni riconoscimento deve essere identificato da un numero di controllo del set di transazioni per X12 (l'elemento dati ST2) o da un numero di riferimento del set di transazioni per EDIFACT (l'elemento dati UNH1). Se un contratto è configurato per il riconoscimento in uscita, BizTalk Server imposterà il controllo o il numero di riferimento del set di transazioni sul valore impostato per il contratto in base al seguente:
Per gli acknowledgement X12 : proprietà (ACK Control Number (ST02) nella pagina Impostazioni host locale (sezione Impostazioni ricevitore) della scheda Contratto nella finestra di dialogo Proprietà contratto
Per gli acknowledgement EDIFACT : (proprietà Numero di controllo Edifact Ack nella pagina Impostazioni host locale (sezione Impostazioni ricevitore) della scheda Contratto nella finestra di dialogo Proprietà contratto
Se BizTalk Server non determina il contratto per il riconoscimento, userà le stesse proprietà indicate in precedenza, ma disponibile nella scheda contratto nelle finestre di dialogo Impostazioni di fallback X12 ad EDIFACT Fallback Settings . Questa impostazione si applica sia ai riconoscimenti funzionali che a quelli tecnici, se sono configurati entrambi. Questo numero intero viene incrementato di uno per ogni riconoscimento o interscambio generato.
La busta di un riconoscimento viene creata dai dati del messaggio ricevuto in base allo schema di controllo del riconoscimento.
Preparazione del riconoscimento
BizTalk Server compila la busta per un riconoscimento proprio come crea una busta per un messaggio, esaminando le definizioni dell'intestazione del controllo interscambio e dell'intestazione del gruppo funzionale. Per altre informazioni, vedere Risoluzione del contratto e determinazione dello schema per i messaggi EDI in uscita.
Per abilitare il routing trasparente del riconoscimento generato (TA1, 997 o CONTRL), il disassembler EDI popola le DestinationPartyReceiverQualifierproprietà , DestinationPartyReceiverIdentifier, DestinationPartySenderQualifiere DestinationPartySenderIdentifier nel riconoscimento.
Riconoscimenti sincroni e asincroni
È possibile inviare i riconoscimenti EDI in modo sincrono o asincrono. Se sincrono, BizTalk Server instradare il riconoscimento direttamente alla pipeline di invio di una porta di ricezione richiesta-risposta bidirezionale. Se asincrona, BizTalk Server instrada il riconoscimento a MessageBox e una porta di trasmissione sottoscriverà tale messaggio.
Per specificare che BizTalk Server invia il riconoscimento in modo sincrono, selezionare Route ACK per inviare la pipeline sulla porta di ricezione di richiesta-risposta nella pagina Impostazioni host locali (sezione Impostazioni ricevitore) in Impostazioni interscambio nella scheda Contratto bidirezionale (per i contratti X12 ed EDIFACT). Se si deseleziona questa proprietà, sarà necessario configurare la pipeline di trasmissione della porta di ricezione bidirezionale in modo che restituisca un interscambio EDI.
In uno scenario in cui viene usata una porta di ricezione richiesta-risposta e in cui sono abilitati sia un riconoscimento tecnico che un riconoscimento funzionale, il riconoscimento tecnico verrà restituito in modo sincrono e quello funzionale in modo asincrono.
Quando si riceve un messaggio con codifica EDIINT/AS2 tramite HTTP/HTTPS, se viene inviato un MDN in risposta a un payload EDI con wrapping MIME (nello stesso socket), non verrà inviato un riconoscimento EDI in modalità sincrona. Se in questo caso viene selezionata la proprietà Route ACK per l'invio della pipeline sulla porta di ricezione della risposta richiesta, BizTalk Server ignorerà la proprietà .
Vedere anche
Struttura dei riconoscimenti EDI
Schemi di controllo e di servizio EDI
Riconoscimento X12 TA1
Riconoscimento X12 997
Riconoscimento EDIFACT CONTRL
Messaggio EDIFACT CONTRL come riconoscimento tecnico
Messaggio EDIFACT CONTRL come riconoscimento funzionale