Passaggio 2 (per Azure): Creare un contratto EDI

In questo argomento si creeranno partner usando il portale BizTalk di Azure disponibile come parte della Servizi BizTalk di Microsoft Azure. Verrà inoltre creato un accordo tra i due partner (Northwind e Contoso) per elaborare il messaggio relativo all'ordine cliente X12 inviato da Contoso a Northwind.

Per creare i partner

1. Usando l'account Microsoft, accedere al portale.

2. Creare un partner per Northwind. Seguire la procedura descritta in Partner e profili per creare un partner.

   Importante

   Contrassegnare questo partner come partner gestito.

3. Ripetere questi passaggi per creare un partner per Contoso. Non contrassegnare questo partner come partner gestito.

Per creare un accordo

1. Nella home page del portale fare clic su Contratti.

2. Nella pagina Contratti fare clic sulla scheda X12 , se non si è già in quella scheda. Fare quindi clic su Crea contratto.

3. Nella pagina Nuovo contratto immettere i dettagli seguenti:

   Campo	Descrizione
   Nome	Immettere un nome per il contratto. Per questa esercitazione, specificare il nome come DemoAgreement. Nota: Si tratta di un campo obbligatorio. Il nome del contratto deve essere univoco.
   Descrizione	Immettere note o un descrizione per il contratto.
   Partner 1 Profile (gestito)	Selezionare il partner gestito per l'accordo. Un partner gestito è un partner che viene gestito dal provider del servizio e per il quale vengono distribuite le pipeline durante la distribuzione dell'accordo. I partner gestiti dal provider del servizio in genere vengono configurati come partner gestito, a differenza dei partner aziendali. Nota: Per questa esercitazione, il partner gestito è Northwind. Nota: Il profilo predefinito viene visualizzato nel campo Profilo. Scegliere il profilo desiderato che è stato configurato per il partner.
   Partner 2 Profile	Selezionare il partner (non gestito) per l'accordo. Nota: Il profilo predefinito viene visualizzato nel campo Profilo. Scegliere il profilo desiderato che è stato configurato per il partner.

   Identità

   Campo	Descrizione
   Partner 1 ID Qualifier	Selezionare un qualificatore di autenticazione che fornisca le identità di business univoche ai partner commerciali. Per questa esercitazione, selezionare ZZ-Mutually Defined.
   Valore	Immettere Northwind.
   Qualificatore ID partner 2	Selezionare un qualificatore di autenticazione che fornisca le identità di business univoche ai partner commerciali. Per questa esercitazione, selezionare ZZ-Mutually Defined.
   Valore	Immettere Contoso.

   Rilevamento

   Campo	Descrizione
   Rileva proprietà del messaggio sul lato invio	Selezionare questa opzione per archiviare le proprietà del messaggio quando il messaggio EDI viene inviato al partner. Dopo l'archiviazione, è possibile eseguire query su questi dati facendo clic su Rilevamento nel riquadro sinistro nel portale BizTalk di Azure. Se abilitato, è inoltre possibile archiviare il corpo del messaggio selezionando Rileva corpo del messaggio sul lato invio.
   Rileva proprietà del messaggio sul lato ricezione	Selezionare questa opzione per archiviare le proprietà del messaggio quando il messaggio EDI viene ricevuto da un partner. Dopo l'archiviazione, è possibile eseguire query su questi dati facendo clic su Rilevamento nel riquadro sinistro nel portale BizTalk di Azure. Se abilitato, è inoltre possibile archiviare il corpo del messaggio selezionando Rileva corpo del messaggio sul lato ricezione.

4. Fare clic su Continue.

   Facendo clic su Continua vengono aggiunte due nuove schede, una per le impostazioni di ricezione e l'altra per le impostazioni di invio. Ogni scheda è per un contratto unidirezionale tra i due partner, uno per la ricezione di messaggi e l'altro per inviare messaggi.

5. Specificare le impostazioni di ricezione.

   1. Nella pagina Trasporto impostare Tipo di trasporto su HTTP.

      Il campo Endpoint mostra l'URL a cui Contoso deve inviare il messaggio dell'ordine di vendita X12.

   2. Nella pagina Protocollo specificare i valori seguenti.

      1. Se necessario, specificare i valori per ISA1, ISA2, ISA3 e ISA4.

      2. In Acknowledgements (Riconoscimenti) selezionare TA1 expected e 997 expected (Previsto TA1) e 997 se si desidera generare riconoscimenti tecnici e funzionali in risposta alla ricezione del messaggio.

      3. In Schemi fare clic sul pulsante Carica e caricare lo schema X12 840 (scaricato dall'Area download) e lo schema SalesOrder (creato in Per creare uno schema all'interno del progetto EDI).

         Impostare le proprietà seguenti nella sezione Schemi .

         Proprietà	Valore
         Versione	00401
         Tipo transazione (ST1)	840
         SCHEMA	/X12_00401_840.xsd

   3. Nella pagina Trasforma caricare la trasformazione creata in Per creare una trasformazione all'interno del progetto EDI.

      In Scegliere le mappe da eseguire come parte del contratto scegliere /X12_00401_840.xsd per Schemi e /EDI840TOSALESORDER. TRFM per Transform file name .TRFM for Transform file name.

   4. Nella pagina Route selezionare Route to Service Bus Queue (Instrada alla coda del bus di servizio ) e specificare l'indirizzo relativo della coda a cui viene inviato il messaggio. Per questa esercitazione, specificare l'indirizzo relativo in queueordersedi modo che l'URL completo sia https://<namespace>.servicebus.appfabriclabs.com/queueordersedi.

      Nota

      In questa esercitazione non viene trattato lo scenario in cui un messaggio con esito negativo viene inviato all'endpoint specificato in Message Suspension Settings. Se la distribuzione dell'accordo ha esito positivo, sarà invece necessario specificare un valore per questa impostazione. È possibile immettere un valore non vuoto.

6. Specificare le impostazioni di invio.

   Nota

   Per lo scenario illustrato in questa esercitazione, non è necessaria alcuna configurazione sul lato invio per l'accordo. Non è tuttavia possibile distribuire un accordo senza specificare le impostazioni di invio, anche se si tratta di valori fittizi. Inoltre, nella scheda Impostazioni di invio non è necessario specificare valori fittizi per l'URI in ingresso, la trasformazione e l'invio in batch.

   1. Nella pagina Protocollo , in Schemi, fare clic sul pulsante Carica e caricare lo schema per il messaggio X12 840.

      Impostare la versione su 00401, tipo di transazione su 840 e schema su X12_00401_840.

   2. Nella pagina Trasporto specificare gli endpoint in cui verranno inviati i messaggi di risposta o gli acknowledgement ai partner. È necessario specificare un endpoint per ogni messaggio elaborato correttamente, oltre che per i messaggi sospesi a causa di un errore di elaborazione.

7. Fare clic su Distribuisci contratto per distribuire il contratto. Il contratto viene ora distribuito nell'URL visualizzato nella pagina Trasporto della scheda Impostazioni di ricezione.

Vedere anche

Esercitazione 4: Creazione di un'applicazione ibrida con BizTalk Server 2013