Procedura dettagliata (EDIFACT): ricezione di interscambi EDI e invio di un riconoscimento

Articolo
10/14/2023

Questa procedura dettagliata fornisce un set di procedure dettagliate che creano una soluzione per ricevere interscambi EDIFACT usando BizTalk Server. In questa soluzione un interscambio EDIFACT viene trasmesso da un partner commerciale, Fabrikam, a un altro, Contoso.

Prerequisiti

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

Modalità di ricezione di interscambi EDIFACT tramite la soluzione

Verranno eseguite le operazioni seguenti:

Nota

Gli eventi riportati nell'elenco possono verificarsi in un ordine diverso rispetto a quello visualizzato.

Ricezione di un interscambio EDIFACT file flat dal partner commerciale Fabrikam.
Convalida dell'interscambio EDIFACT a fronte dello schema, disassemblaggio del messaggio in XML e rilascio del codice XML del messaggio nel MessageBox.
Generazione e rilascio nel MessageBox di un riconoscimento tecnico (ricezione del messaggio) per l'interscambio EDI ricevuto.
Generazione e rilascio nel MessageBox di un riconoscimento funzionale (accettazione o rifiuto dell'interscambio EDI ricevuto).
Prelievo del codice XML del messaggio tramite una porta di trasmissione FILE unidirezionale e assemblaggio dell'interscambio EDI del messaggio.
Trasmissione dell'interscambio EDI alla cartella locale Contoso.
Prelievo del riconoscimento tecnico tramite una porta di trasmissione FILE unidirezionale e assemblaggio dell'interscambio.
Trasmissione del riconoscimento tecnico alla cartella locale Fabrikam.
Prelievo del riconoscimento funzionale tramite una porta di trasmissione FILE unidirezionale e assemblaggio dell'interscambio.
Trasmissione del riconoscimento funzionale a Fabrikam.

Funzionalità della soluzione

Ai fini di questa procedura dettagliata verrà abilitata la seguente funzionalità:

La soluzione è progettata per gli interscambi che utilizzano la codifica EDIFACT

Nota

Per istruzioni su come creare una soluzione simile per gli interscambi X12, vedere Procedura dettagliata (X12): ricezione di interscambi EDI e invio di un riconoscimento.
Sull'interscambio in ingresso verranno eseguite la convalida del tipo EDI e la convalida estesa.
Verranno generati i riconoscimenti tecnici e funzionali per la restituzione al mittente dell'interscambio.
La soluzione utilizza un indirizzo di ricezione unidirezionale con un tipo di trasporto FILE.

Nota

È possibile utilizzare un indirizzo e una porta di ricezione sollecitazione-risposta bidirezionale per ricevere il messaggio, ma in tal caso non sarà possibile utilizzare un tipo di trasporto FILE per l'indirizzo di ricezione. Per altre informazioni, vedere Configurazione di una porta per ricevere messaggi EDI e riconoscimenti.
Verrà abilitata la segnalazione EDI e i set di transazioni verranno salvati per essere visualizzati dal rapporto Stato interscambio.
A scopo di test, la soluzione utilizza tre porte di trasmissione per trasmettere l'interscambio EDIFACT e i riconoscimenti creati alle cartelle locali.

Nella figura seguente viene illustrata l'architettura di questa soluzione:

Configurazione e test della procedura dettagliata

Di seguito sono elencate le procedure necessarie per questa soluzione:

Aggiungere gli schemi di messaggio necessari a un progetto BizTalk e quindi compilare e distribuire il progetto, rendendo disponibili gli schemi per l'uso da parte di BizTalk Server nell'elaborazione dell'interscambio ricevuto.
Creare una porta di ricezione unidirezionale per BizTalk Server per ricevere l'interscambio EDIFACT dal partner commerciale e generare un riconoscimento. Questo indirizzo di ricezione è associato alla cartella di file in cui Fabrikam rilascia l'interscambio EDIFACT da trasmettere a Contoso.

Nota

È possibile utilizzare un indirizzo e una porta di ricezione sollecitazione-risposta bidirezionale per ricevere il messaggio, ma in tal caso non sarà possibile utilizzare un tipo di trasporto FILE per l'indirizzo di ricezione.
Creazione di una porta di trasmissione che trasmette l'interscambio EDI a una cartella Contoso locale e di un'altra che trasmette i riconoscimenti tecnici e funzionali a una cartella Fabrikam locale.

Nota

Diversamente dai riconoscimenti X12, i tipi di messaggio per i riconoscimenti funzionali e tecnici sono gli stessi, Di conseguenza, il filtro porta di invio creato usando la BTS.MessageType proprietà di contesto filtra sia i riconoscimenti che li recapita alla stessa cartella.
Creazione di un'entità (trading partner) per Fabrikam e per Contoso.
Creazione di un profilo business per ciascuno dei partner commerciali.
Creazione di un accordo tra i due profili tramite configurazione delle proprietà EDI per consentire la ricezione del messaggio e la trasmissione del riconoscimento.

Test della procedura dettagliata mediante un interscambio EDIFACT di test. Per questa procedura dettagliata, è possibile copiare e incollare quanto segue in un file di testo. Lo schema per questo file è EFACT_D98A_APERAK.xsd.

UNA:+,?*'  
UNB+UNOB:1+7654321:ZZZ+1234567:ZZZ+353501:3023+UNB5'  
UNG+INVOIC+UNG2.1:ZZZ+UNG3.1:ZZZ+060413:2314+UNG5+UN+D:98B'  
UNH+UNH1+APERAK:D:98A:UN++13+UNH5.1+UNH6.1+UNH7.1'  
BGM+1+C10601'  
DTM+10'  
FTX+AAA++C10701+C10801'  
CNT+1:14'  
RFF+AAA'  
DTM+10'  
NAD+AA+C08201+C05801+C08001+C05901'  
CTA++C05601'  
COM+C07601:AA'  
ERC+C90101'  
FTX+AAA++C10701+C10801'  
RFF+AAA'  
FTX+AAA++C10701+C10801'  
UNT+15+UNH1'  
UNE+1+UNG5'  
UNZ+1+UNB5'

Configurazione della procedura dettagliata

In questa sezione vengono descritti i passaggi per configurare la procedura dettagliata.

Per distribuire lo schema messaggi

In Visual Studio creare o aprire un progetto BizTalk.

Nota

In questo argomento si presuppone che dall'applicazione in uso sia già stato aggiunto un riferimento all'applicazione EDI BizTalk, che contiene schemi EDI, pipeline e orchestrazioni. In caso contrario, vedere Aggiungere un riferimento all'applicazione EDI BizTalk Server.
Fare clic con il pulsante destro del mouse sul progetto, scegliere Aggiungi e quindi fare clic su Elemento esistente. Passare alla cartella in \Programmi (x86)\Microsoft BizTalk Server VERSION>XSD_Schema<\EDI\EDIFACT\D98A e quindi fare doppio clic sullo schema (EFACT_D98A_APERAK.xsd).

Nota

Se si usa il messaggio di test di esempio fornito in questo argomento, è necessario usare lo schema EFACT_D98A_APERAK.xsd .

Nota

Se gli schemi EDI non sono stati scollegati nelle cartelle \XSD_Schema\EDI, eseguire il file MicrosoftEdiXSDTemplates.exe nella cartella \XSD_Schema\EDI per decomprimere gli schemi nella cartella predefinita.
Aggiungere il file di chiave dell'assembly al progetto e quindi compilare e distribuire l'assembly.

Per creare una porta di ricezione unidirezionale (per Fabrikam) per ricevere l'interscambio EDI

In Esplora risorse creare una cartella locale in cui ricevere l'interscambio.
In BizTalk Server Console di amministrazione fare clic con il pulsante destro del mouse sul nodo Porte di ricezione nel nodo Applicazione BizTalk 1, scegliere Nuovo e quindi fare clic su Porta di ricezione unidirezionale.
Assegnare un nome alla porta di ricezione e quindi fare clic su Posizioni di ricezione nell'albero della console.
Fare clic su Nuovo.
Assegnare un nome al percorso di ricezione, selezionare FILE per Tipo e quindi fare clic su Configura.
Passare a una cartella per la casella di testo Ricezione cartella . Questa cartella è stata creata al passaggio 1 di questa procedura. Immettere una maschera file, ad esempio *.edi o *.txt.
Fare clic su OK.
Per La pipeline di ricezione selezionare EdiReceive.
Fare clic su OK nella finestra di dialogo Proprietà percorso di ricezione . Fare di nuovo clic su OK nella finestra di dialogo Proprietà porta di ricezione .
Nell'albero della console fare clic su Posizioni di ricezione. Nel riquadro Posizioni di ricezione fare clic con il pulsante destro del mouse sul percorso di ricezione e quindi scegliere Abilita.

Per creare una porta di trasmissione statica unidirezionale (per Contoso) per trasmettere l'interscambio EDI

In Esplora risorse creare una cartella locale a cui trasmettere l'interscambio di test.
In BizTalk Server Console di amministrazione fare clic con il pulsante destro del mouse sul nodo Invia porte nel nodo Applicazione BizTalk 1, scegliere Nuovo e quindi fare clic su Porta di invio statica in modalità unidirezionale.
Nella finestra di dialogo Invia proprietà porta assegnare un nome alla porta di invio.
Nella sezione Trasporto selezionare FILE per Tipo e quindi fare clic su Configura.
Per la cartella Destination passare alla cartella per ricevere l'interscambio. Questa cartella è stata creata al passaggio 1 di questa procedura. Per Maschera file immettere il formato di interscambio, ad esempio *.edi o *.txt.
Fare clic su OK.
In Invia pipeline selezionare EdiSend.
Nell'albero della console selezionare Filtri. Immettere un filtro per sottoscrivere l'interscambio EDI. Ad esempio, per Proprietà, immettere BTS. MessageType; per Operatore immettere ; e per Valore immettere ==lo schema per l'interscambio, http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006#EFACT_D98A_APERAK.

Nota

Questa impostazione del filtro garantisce che gli interscambi, non i riconoscimenti, vengano trasmessi alla cartella associata a questa porta di trasmissione.
Fare clic su OK.
Nell'albero della console fare clic su Invia porte. Nel riquadro Porte di invio fare clic con il pulsante destro del mouse sulla porta di invio e quindi scegliere Avvia.

Per creare una porta di trasmissione statica unidirezionale per la trasmissione dei riconoscimenti

In Esplora risorse creare una cartella locale per la trasmissione dei riconoscimenti tecnici e funzionali.
In BizTalk Server Console di amministrazione fare clic con il pulsante destro del mouse sul nodo Invia porte nel nodo Applicazione BizTalk 1, scegliere Nuovo e quindi fare clic su Porta di invio statica in modalità unidirezionale.
Nella finestra di dialogo Invia proprietà porta assegnare un nome alla porta di invio.
Nella sezione Trasporto selezionare FILE per Tipo e quindi fare clic su Configura.
Per la cartella Destination passare a una cartella per ricevere i due riconoscimenti. Questa cartella è stata creata al passaggio 1 di questa procedura. Per Maschera file immettere il formato di interscambio, ad esempio *.edi o *.txt.
Fare clic su OK.
In Invia pipeline selezionare EdiSend.
Nell'albero della console selezionare Filtri. Immettere un filtro per sottoscrivere i riconoscimenti. Ad esempio, per Proprietà, immettere BTS. MessageType; per Operatore immettere ; e per Valore immettere ==lo schema per il riconoscimento, http://schemas.microsoft.com/Edi/Edifact#Efact_Contrl_Root.
Fare clic su OK.
Nell'albero della console fare clic su Invia porte. Nel riquadro Porte di invio fare clic con il pulsante destro del mouse sulla porta di invio e quindi scegliere Avvia.

Per creare un'entità e un profilo business per Fabrikam

Fare clic con il pulsante destro del mouse sul nodo Parti nella console di amministrazione BizTalk Server, scegliere Nuovo e quindi fare clic su Party.
Immettere un nome per la parte nella casella di testo Nome e quindi fare clic su OK.

Nota

Selezionando la casella di controllo Local BizTalk elabora i messaggi ricevuti dall'entità OR supporta l'invio di messaggi da questa parte, è possibile specificare che la parte creata è per la stessa organizzazione che ospita anche BizTalk Server. Di conseguenza, alcune proprietà verranno abilitate o disabilitate durante la creazione di un accordo. Tuttavia, ai fini della procedura dettagliata, è possibile lasciare selezionata questa casella di controllo.
Fare clic con il pulsante destro del mouse sul nome dell'entità, scegliere Nuovo e quindi fare clic su Profilo business.
Nella finestra di dialogo Proprietà profilo immettere Fabrikam_Profile nella casella di testo Nome.

Nota

Quando si crea un'entità, viene creato anche un profilo. È possibile rinominare e utilizzare tale profilo anziché crearne uno nuovo. Per rinominare un profilo, fare clic con il pulsante destro del mouse sul profilo e selezionare Proprietà. Nella pagina Generale specificare un nome per il profilo.

Per creare un'entità e un profilo business per Contoso

Fare clic con il pulsante destro del mouse sul nodo Parti nella console di amministrazione BizTalk Server, scegliere Nuovo e quindi fare clic su Party.
Immettere un nome per la parte nella casella di testo Nome e quindi fare clic su OK.

Nota

Selezionando la casella di controllo Local BizTalk elabora i messaggi ricevuti dall'entità OR supporta l'invio di messaggi da questa parte, è possibile specificare che la parte creata è per la stessa organizzazione che ospita anche BizTalk Server. Di conseguenza, alcune proprietà verranno abilitate o disabilitate durante la creazione di un accordo. Tuttavia, ai fini della procedura dettagliata, è possibile lasciare selezionata questa casella di controllo.
Fare clic con il pulsante destro del mouse sul nome dell'entità, scegliere Nuovo e quindi fare clic su Profilo business.
Nella finestra di dialogo Proprietà profilo immettere Contoso_Profile nella casella di testo Nome nella pagina Generale.

Nota

Quando si crea un'entità, viene creato anche un profilo. È possibile rinominare e utilizzare tale profilo anziché crearne uno nuovo. Per rinominare un profilo, fare clic con il pulsante destro del mouse sul profilo e selezionare Proprietà. Nella pagina Generale specificare un nome per il profilo.

Per creare un accordo tra i due profili business

Fare clic con il pulsante destro del mouse su Fabrikam_Profile, scegliere Nuovo e quindi fare clic su Contratto.
Nella pagina Proprietà generali immettere un nome per il contratto nella casella di testo Nome .
Nell'elenco a discesa Protocollo selezionare EDIFACT.
Nella sezione Secondo partner selezionare Contoso nell'elenco a discesa Nome.
Nell'elenco a discesa Profilo della sezione Secondo partner selezionare Contoso_Profile.

Si noterà che due nuove schede vengono aggiunte accanto alla scheda Generale . Ogni scheda è per la configurazione di un contratto unidirezionale e ogni contratto unidirezionale rappresenta una transazione completa del messaggio (incluso il trasferimento dei messaggi e il trasferimento di riconoscimento).
Nella scheda Generale , nella pagina Proprietà generali , nella sezione Impostazioni host comuni selezionare Attiva report e quindi selezionare Archivia payload dei messaggi per la creazione di report.

Eseguire le attività seguenti nella scheda Fabrikam-Contoso>.

Nella pagina Identificatori nella sezione Impostazioni interscambio immettere i valori per i campi qualificatore e identificatore (UNB2.1, UNB2.2, UNB3.1 e UNB3.2) che corrispondono ai valori per tali campi di intestazione nel messaggio di test.

Nota

BizTalk Server richiede i campi qualificatore e identificatore per il mittente e il destinatario per eseguire la risoluzione del contratto. Corrisponderà ai valori di UNB2.1, UNB2.2, UNB3.1 e UNB3.2 nell'intestazione di interscambio con quelli nelle proprietà di un contratto. BizTalk Server risolverà anche il contratto corrispondendo al qualificatore e all'identificatore del mittente (senza il qualificatore e l'identificatore del ricevitore). Se BizTalk Server non è in grado di risolvere il contratto, userà le proprietà del contratto di fallback.

Nota

Se si usa il messaggio di esempio fornito in precedenza in questo argomento come messaggio di test, impostare UNB2.1 su 7654321, UNB2.2 su ZZZ – Mutually Defined, UNB3.1 su 1234567 e UNB3.2 su ZZZ – Mutually Defined.
Nella pagina Riconoscimenti nella sezione Impostazioni interscambio controllare la ricezione del messaggio (CONTRL) previsto e riconoscimento (CONTRL).
Nella pagina Buste nella sezione Impostazioni interscambio selezionare Applica segmento UNA (Consigli per il servizio stringhe) e Applica segmenti UNG (intestazione gruppo funzionale).
Nella pagina Convalida nella sezione Impostazioni interscambio assicurarsi che l'opzione Numero di controllo interscambio (UNB5) sia deselezionata.

Nota

Cancellare la proprietà UnB5 (Interscambio Control Number) consente di ricevere più istanze dello stesso messaggio.
Nella pagina Charset e Separatori nella sezione Impostazioni interscambio selezionare l'opzione CR LF per il suffisso UNA6.
Nella pagina Impostazioni host locali nella sezione Impostazioni interscambio deselezionare l'opzione Route ACK per inviare la pipeline sulla porta di ricezione della risposta richiesta .

Nota

Se si usa una porta di ricezione bidirezionale per ricevere l'interscambio e restituire il riconoscimento, selezionare Route ACK per inviare la pipeline sulla porta di ricezione della risposta richiesta.
Nella pagina Invia porte nella sezione Impostazioni interscambio associare le porte di invio che riceveranno l'interscambio da Fabrikam e le porte di invio che riceveranno i riconoscimenti da Contoso. Nella griglia Invia porte , nella colonna Nome fare clic su una cella vuota e nell'elenco a discesa selezionare la porta di invio creata per ricevere l'interscambio EDI da Fabrikam. Ripetere il passaggio per la porta di trasmissione creata per la ricezione dei riconoscimenti funzionali e tecnici.
Nella pagina Convalida nella sezione Impostazioni set di transazioni lasciare selezionata la convalida del tipo EDI e selezionare Convalida dei tipi estesi.
Se si usa uno degli schemi standard forniti con BizTalk Server, nella pagina Impostazioni host locali nella sezione Impostazioni set di transazioni selezionare lo spazio dei nomi per lo schema da usare per elaborare l'interscambio in ingresso. Se si usa uno schema personalizzato, immettere i valori nella griglia Personalizza spazio dei nomi di destinazione, in modo che BizTalk Server possa determinare lo spazio dei nomi usando i valori di intestazione gruppo e set di transazioni.

Nella pagina Buste nella sezione Impostazioni set di transazioni immettere i valori per tutte le colonne nella prima riga della griglia.

Usare	Per
Default	Selezionare Predefinita.
Per messaggio di tipo UNH2.1	Selezionare il tipo di messaggio di test APERAK.
UNH2.2	Immettere la versione EDI, D.
UNH2.3	Immettere il numero di versione 98A.
UNH2.5	È possibile lasciare vuoto questo campo.
Spazio dei nomi di destinazione	Selezionare `http://schemas.microsoft.com/Edi/Edifact`.
UNG1	Specificare l'ID gruppo funzionale, FATTURAZIONE.
UNG2.1	Immettere un valore per l'identificazione del mittente dell'applicazione.
UNG2.1	Immettere un valore per il qualificatore del codice del mittente dell'applicazione, ad esempio ZZZ.
UNG3.1	Immettere un valore per l'identificazione del ricevitore dell'applicazione.
UNG3.2	Immettere un valore per il qualificatore di codice ricevitore dell'applicazione, ad esempio ZZZ.
UNG6	Immettere un valore per l'agenzia di controllo, Esempio, UN.
UNG7.1	Immettere il numero di versione del tipo del messaggio, Esempio, D.
UNG7.2	Immettere il numero di rilascio del tipo del messaggio, Esempio , 98A.
UNG7.3	È possibile lasciare vuoto questo campo.
UNG8	È possibile lasciare vuoto questo campo.

Eseguire le attività seguenti nella scheda Contoso-Fabrikam>.

Nota

In questa procedura dettagliata viene specificato il valore necessario nella scheda, in modo da creare correttamente l'accordo. Per creare correttamente un contratto, entrambe le schede dei contratti unidirezionale devono avere valori definiti per UNG2.1, UNG2.2, UNG3.1 e UNG3.2.

Nota

Anche se l'acknowledgement fa parte della stessa transazione di messaggio, le proprietà correlate alla modalità di generazione dell'acknowledgement vengono configurate nella scheda Contoso-Fabrikam>. Ciò è necessario perché le proprietà del contesto di acknowledgement per i qualificatori di mittente e ricevitore sono impostate sull'opposto dei valori specificati nella scheda Contoso-Fabrikam>. Ad esempio, se gli identificatori di mittente e ricevitore sono impostati su 7654321 e 1234567 nella scheda Fabrikam-Contoso>, le proprietà del contesto del mittente e del destinatario verranno impostate su 1234567 e 7654321 nell'acknowledgement. In genere nell'altra scheda dell'accordo unidirezionale gli identificatori di mittente e ricevitore sono rispettivamente impostati su 1234567 e 7654321. Di conseguenza, il messaggio di riconoscimento verrà risolto in base a tale accordo e verrà selezionata l'impostazione delle proprietà. Pertanto, se si vuole avere l'acknowledgement per usare separatori di elementi diversi o se si vuole avere l'acknowledgement per l'uso di CR LF, specificare le proprietà nella scheda Contoso-Fabrikam>.

Dal punto di vista concettuale, le proprietà per il riconoscimento verranno prelevate da qualsiasi scheda degli accordi unidirezionali in cui i qualificatori del mittente e del ricevitore sono uguali a quelli impostati nelle proprietà di contesto del riconoscimento. Tuttavia per una maggior praticità tali qualificatori vengono in genere impostati nell'altra scheda dell'accordo unidirezionale dell'accordo creato e in base al quale è stato risolto l'interscambio.
1. Nella pagina Identificatori nella sezione Impostazioni interscambio immettere i valori per i campi qualificatore e identificatore (UNG2.1, UNG2.2, UNG3.1 e UNG3.2) che corrispondono ai valori per tali campi di intestazione nel messaggio di test.
  
  Nota
  
  Se si usa il messaggio di esempio fornito in precedenza in questo argomento come messaggio di test, impostare UNB2.1 su 1234567, UNB2.2 su ZZZ - Mutually Defined, UNB3.1 su 7654321 e UNB3.2 su ZZZ - Mutually Defined.
Fare clic su Applica.
Fare clic su OK. Il contratto appena aggiunto è elencato nella sezione Contratti del riquadro Parti e profili di business . Il nuovo accordo aggiunto è abilitato per impostazione predefinita.

Test della procedura dettagliata

In questa sezione sono disponibili informazioni sul test della procedura dettagliata.

Per sottoporre a test la procedura dettagliata

In Esplora risorse rilasciare l'interscambio EDI di test nella cartella di ricezione locale.

Nota

Per un messaggio di test, è possibile utilizzare il messaggio di esempio fornito in precedenza in questo argomento. Copiare il messaggio in un file di testo e salvare il file con estensione txt. Se si utilizza questo messaggio, è necessario che lo schema EFACT_D98A_APERAK.xsd sia stato distribuito. Lo schema è disponibile eseguendo il file MicrosoftEdiXSDTemplates.exe (nella cartella \XSD_Schema\EDI) per decomprimere gli schemi nella cartella predefinita. Lo schema EFACT_D98A_APERAK.xsd è quindi disponibile in \Programmi (x86)\Microsoft BizTalk Server VERSION>XSD_Schema<\EDI\EDIFACT\D98A.
Aprire la cartella associata alla porta di trasmissione per gli interscambi e verificare che contenga l'interscambio EDI.
Aprire la cartella associata alla porta di trasmissione per i riconoscimenti e verificare che contenga i riconoscimenti tecnici e funzionali.

Vedere anche

Sviluppo e configurazione di soluzioni EDI BizTalk Server

Condividi tramite