Procedura dettagliata (X12): trasmissione di interscambi EDI
Questa procedura dettagliata fornisce un set di procedure dettagliate che creano una soluzione per l'invio di interscambi EDI tramite BizTalk Server.
Prerequisiti
È necessario essere connessi come membro del gruppo BizTalk Server Administrators o BizTalk Server operatori B2B.
Trasmissione di interscambi EDI tramite la soluzione
Verranno eseguite le operazioni seguenti:
Una porta di ricezione FILE unidirezionale riceve un messaggio EDI da Fabrikam.
Mediante la pipeline EdiReceive, la porta di ricezione controlla il messaggio e lo converte in XML. La porta di ricezione rilascia quindi il messaggio di test nel MeassageBox.
Una porta di trasmissione statica unidirezionale preleva il messaggio XML dal MessageBox.
La porta di trasmissione statica unidirezionale convalida il messaggio EDI a fronte dello schema messaggi, serializza il messaggio EDI in un interscambio EDI e quindi trasmette il messaggio EDI alla cartella locale del partner commerciale Contoso.
Funzionalità della soluzione
In questa procedura dettagliata viene utilizzata la funzionalità seguente:
La ricezione di un riconoscimento non è testata in questa procedura dettagliata. Per informazioni su come ricevere un riconoscimento, vedere procedura dettagliata (X12): ricezione di interscambi EDI e invio di un acknowledgement
La soluzione è progettata per gli interscambi tramite la codifica X12, non la codifica EDIFACT.
Nota
La configurazione utilizzata per HIPAA e per la codifica EDIFACT è quasi parallela a quella utilizzata per la codifica X12.
Sull'interscambio in uscita verranno eseguite la convalida del tipo EDI e la convalida estesa.
La soluzione utilizza una porta di trasmissione statica unidirezionale con un tipo di trasporto FILE.
Nota
Invece di una porta di trasmissione statica unidirezionale, è possibile utilizzare una porta di trasmissione statica bidirezionale per trasmettere l'interscambio e ricevere il riconoscimento. È inoltre possibile utilizzare una porta di trasmissione unidirezionale dinamica per trasmettere l'interscambio. Per altre informazioni sull'uso di una porta di trasmissione dinamica, vedere Configurazione di una porta di trasmissione dinamica per l'invio di interscambi EDI e riconoscimenti.
Nota
È possibile utilizzare un adapter HTTP e il trasporto AS2. Per altre informazioni su questa operazione, vedere Procedura dettagliata (AS2): Invio di EDI su AS2 con un MDN sincrono o procedura dettagliata (AS2): Invio di EDI su AS2 con un MDN asincrono.
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 un indirizzo di ricezione per ricevere un messaggio di test.
Nella figura seguente viene illustrata l'architettura di questa soluzione, che utilizza una porta di trasmissione statica unidirezionale.
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 gli schemi disponibili per l'uso da parte di BizTalk Server nell'elaborazione dell'interscambio in uscita.
Creare una porta di ricezione e una posizione per BizTalk Server ricevere l'interscambio EDI. Questo indirizzo di ricezione è associato alla cartella di file in cui Fabrikam rilascia l'interscambio EDI da trasmettere a Contoso. L'indirizzo di ricezione utilizzerà la pipeline di ricezione EdiReceive.
Creare una porta di trasmissione per BizTalk Server per inviare l'interscambio EDI a Contoso. In questa procedura dettagliata verrà creata una di trasmissione statica unidirezionale.
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.
Per testare la procedura, dettagliata utilizzare un interscambio EDI di test.
Nota
Per un messaggio di test è possibile utilizzare il file SamplePO.txt utilizzato nell'esercitazione EDI Interface Developer. Il file viene fornito nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\. Si tratta di un messaggio 850 X12.
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, quindi fare clic su Elemento esistente. Passare alla cartella in \Programmi (x86)\Microsoft BizTalk Server VERSION>XSD_Schema<\EDI e quindi fare doppio clic sullo schema.
Nota
Se gli schemi EDI non sono stati decompressi nelle cartelle \XSD_Schema\EDI, eseguire il file MicrosoftEdiXSDTemplates.exe nella cartella \XSD_Schema\EDI per decomprimere gli schemi nella cartella predefinita.
Nota
Se si usa il file SamplePO.txt usato nell'esercitazione per sviluppatori di interfaccia EDI, è necessario usare lo schema X12_00401_850.xsd fornito nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\Inbound_EDI. Non è necessario utilizzare lo schema X12 850 nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema.
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.
Denominare la porta di ricezione e quindi fare clic su Percorsi 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.
Immettere una cartella per Receive folder (Cartella di ricezione) e immettere *.txt per la maschera file.
Fare clic su OK.
Per Pipeline di ricezione selezionare EdiReceive.
Fare clic su OK e quindi di nuovo su OK.
Nell'albero della console fare clic su Posizioni di ricezione. Nel riquadro Località 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 per la trasmissione dell'interscambio EDI.
In BizTalk Server Console di amministrazione fare clic con il pulsante destro del mouse sul nodo Porte di trasmissione nel nodo Applicazione BizTalk 1, scegliere Nuovo e quindi fare clic su Porta di trasmissione statica unidirezionale.
Nella finestra di dialogo Proprietà porta di trasmissione assegnare un nome alla porta di trasmissione.
Nella sezione Trasporto selezionare il tipo, ad esempio FILE.
Se si usa un tipo DI FILE, fare clic su Configura. Nella cartella Destinazione passare a una cartella a cui inviare l'interscambio. Per Nome file immettere %MessageID%.edi. Fare clic su OK.
In Invia pipeline selezionare EdiSend.
Nell'albero della console selezionare Filtri e immettere un'espressione di filtro per la porta di trasmissione da usare per sottoscrivere il messaggio. Come espressione filtro, ad esempio, è possibile utilizzare l'indirizzo di ricezione che riceverà il messaggio di test originale. A tale scopo, in Proprietà immettere BTS. ReceivePortName; per Operatore immettere ==e per Valore immettere il nome della porta di ricezione creata per ricevere il messaggio XML da Fabrikam.
Nota
È possibile applicare il filtro a un'altra proprietà di propria scelta, ad esempio a BTS.MessageType.
Fare clic su OK.
Fare clic sul nodo Porte di trasmissione nella Console di amministrazione, fare clic con il pulsante destro del mouse sulla porta di trasmissione e quindi scegliere Avvia.
Per creare un'entità e un profilo business per Fabrikam
Fare clic con il pulsante destro del mouse sul nodo Entità nella console di amministrazione BizTalk Server, scegliere Nuovo e quindi fare clic su Entità.
Immettere un nome per l'entità 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à OPPURE supporta l'invio di messaggi da questa parte, è possibile specificare che l'entità 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 di business.
Nella pagina Generale della 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 scegliere 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 Entità nella console di amministrazione BizTalk Server, scegliere Nuovo e quindi fare clic su Entità.
Immettere un nome per l'entità 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à OPPURE supporta l'invio di messaggi da questa parte, è possibile specificare che l'entità 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 di business.
Nella pagina Generale della finestra di dialogo Proprietà profilo immettere Contoso_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 scegliere 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 X12.
Nell'elenco a discesa Nome della sezione Second Partner (Secondo partner) selezionare Contoso.
Nell'elenco a discesa Profilo della sezione Second Partner (Secondo partner) selezionare Contoso_Profile.
Si noterà che vengono aggiunte due nuove schede 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 acknowledgement).
Nella scheda Generale , nella pagina Proprietà generali , nella sezione Impostazioni host comuni selezionare Attiva creazione report e quindi selezionare Archivia payload del messaggio 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 (ISA5, ISA6, ISA7 e ISA8) 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 ISA5, ISA6, ISA7 e ISA8 nell'intestazione di interscambio con quelli nelle proprietà di un contratto. BizTalk Server risolverà anche il contratto abbinando il qualificatore e l'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 file SamplePO.txt da "EDI Interface Developer Tutorial" come messaggio di test, impostare ISA5 su ZZ, ISA6 su THEM, ISA7 su ZZ e ISA8 su US.
Nella pagina Convalida nella sezione Impostazioni interscambio verificare che l'opzione Verifica la presenza di ISA13 duplicata sia deselezionata.
Nota
La cancellazione della proprietà Check for duplicate ISA13 consente di ricevere più istanze dello stesso messaggio.
Nella pagina Charset and Separators (Set di caratteri e separatori ) nella sezione Impostazioni interscambio selezionare l'opzione CR LF .
Nella pagina Porte di trasmissione nella sezione Impostazioni interscambio associare la porta di trasmissione che riceverà l'interscambio EDI da Fabrikam. Nella griglia Porte di trasmissione, sotto la colonna Nome , fare clic su una cella vuota e nell'elenco a discesa selezionare la porta di trasmissione creata per la ricezione dell'interscambio EDI da Fabrikam.
Nella pagina Convalida nella sezione Impostazioni set di transazioni lasciare la convalida del tipo EDI selezionata e selezionare Convalida estesa.
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.
Usare Per Default Selezionare la casella di controllo nella colonna Per ST1 Selezionare 850 - Ordine di acquisto. GS2 Immettere THEM. Spazio dei nomi di destinazione Selezionare http://schemas.microsoft.com/BizTalk/EDI/X12/2006.Nota
L'impostazione delle proprietà consente di BizTalk Server di determinare lo schema da usare nell'elaborazione dell'interscambio 850 in ingresso. Se un interscambio presenta i valori GS02 e ST01 immessi in una riga della griglia, per determinare lo schema da utilizzare verrà utilizzato lo spazio dei nomi di destinazione per la stessa riga.
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 la casella di controllo nella colonna Predefinita . Nota: Quando si seleziona questa riga come predefinita, i valori per GS1, GS2, GS3, GS7 e GS8 vengono usati anche se i valori per tipo di transazione, versione/versione e spazio dei nomi di destinazione non corrispondono al messaggio. Tipo di transazione Selezionare il tipo di messaggio del test , 850 - Ordine di acquisto. Versione/Rilascio Immettere la versione EDI 00401. Spazio dei nomi di destinazione Selezionare http://schemas.microsoft.com/BizTalk/EDI/X12/2006.GS1 Verificare che il tipo di messaggio del messaggio di test sia selezionato, po - ordine di acquisto (850). GS2 Immettere un valore per il mittente dell'applicazione. GS3 Immettere un valore per il ricevitore dell'applicazione. GS4 Selezionare il formato data desiderato. Nota: È necessario selezionare il valore nell'elenco a discesa, non solo fare clic sul campo per visualizzare l'impostazione predefinita. Se si fa clic nel campo senza selezionare il valore dall'elenco a discesa, tale valore non risulterà effettivamente selezionato. GS5 Selezionare il formato ora desiderato. GS7 Selezionare X - Accredited Standards Committee X12. GS8 Verificare che la versione EDI sia stata immessa, 00401. Nota
BizTalk Server imposterà i valori per GS01, GS02, GS03, GS04, GS05, GS07 e GS08 dei riconoscimenti in uscita in base ai valori immessi per tipo di transazione, versione/versione e spazio dei nomi di destinazione. La pipeline di trasmissione prova ad abbinare il tipo del set di transazioni, la versione X12 e lo spazio dei nomi di destinazione con i valori corrispondenti nell'intestazione del messaggio. In caso di esito positivo, vengono utilizzati i valori GS associati ai valori dello spazio dei nomiTipo di transazione, Versione/Versione e Destinazione.
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 di contratto unidirezionale devono avere valori definiti per ISA5, ISA6, ISA7 e ISA8.
Nella pagina Identificatori nella sezione Impostazioni interscambio immettere i valori per i campi qualificatore e identificatore (ISA5, ISA6, ISA7 e ISA8) che corrispondono ai valori per tali campi di intestazione nel messaggio di test.
Nota
Se si usa il file SamplePO.txt da "EDI Interface Developer Tutorial" come messaggio di test, impostare ISA5 su ZZ, ISA6 su US, ISA7 su ZZ e ISA8 su THEM.
Fare clic su Applica.
Fare clic su OK. Il nuovo contratto aggiunto è elencato nella sezione Contratti del riquadro Profili aziendali e parti . 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 file SamplePO.txt utilizzato nell'esercitazione EDI Interface Developer. Questo file viene fornito nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial. Si tratta di un messaggio 850 X12. Se si usa questo messaggio, è necessario aver distribuito lo schema X12_00401_850.xsd fornito nella cartella \Programmi (x86)\Microsoft BizTalk Server <VERSION>SDK\EDI Interface Developer Tutorial\Inbound_EDI. Non è necessario usare lo schema X12 850 nella cartella \Programmi (x86)\Microsoft BizTalk Server <XSD_Schema VERSION>.
In Esplora risorse aprire la cartella di destinazione specificata per la porta di trasmissione. Verificare che la cartella contenga un interscambio EDI di output con le intestazioni ISA, GS e ST corrispondenti ai valori immessi nelle proprietà dell'accordo.