Scambiare messaggi EDIFACT usando flussi di lavoro in App per la logica di Azure

Per inviare e ricevere messaggi EDIFACT nei flussi di lavoro creati con App per la logica di Azure, usare il connettore EDIFACT, che fornisce operazioni che supportano e gestiscono la comunicazione EDIFACT.

Questa guida illustra come aggiungere la codifica EDIFACT e le azioni di decodifica a un flusso di lavoro dell'app per la logica esistente. Quando non è disponibile alcun trigger EDIFACT, è possibile attivare qualsiasi trigger per avviare il flusso di lavoro. Gli esempi in questa guida usano il trigger Richiedi.

Informazioni tecniche sul connettore

Il connettore EDIFACT ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.

Operazioni predefinite EDIFACT (solo flussi di lavoro Standard - Anteprima)

Il connettore predefinito EDIFACT in anteprima include le azioni seguenti, simili alle azioni del connettore gestito EDIFACT corrispondenti, tranne dove indicato in Limitazioni e problemi noti.

• Azione di codifica EDIFACT
• Azione decodifica EDIFACT

Limitazioni e problemi noti

• Anteprima del connettore predefinito EDIFACT

  • Questa funzionalità è in anteprima ed è soggetta alle Condizioni supplementari per l'utilizzo per le anteprime di Microsoft Azure.

  • Le azioni di questo connettore supportano attualmente payload fino a almeno 100 MB.

  • L'azione Decodifica EDIFACT in anteprima attualmente non include le funzionalità seguenti:

    • Verificare la presenza di numeri di controllo di interscambio, gruppo e set di transazioni duplicati, se configurati.

    • Mantenere l'intero interscambio.

    In caso contrario, le azioni del connettore predefinito Codifica EDIFACT e Decodifica EDIFACT in anteprima hanno funzionalità simili alle azioni del connettore gestito EDIFACT della controparte.

  • Le azioni di questo connettore attualmente non supportano interscambi con più transazioni o messaggi in batch.

  • Le azioni di questo connettore non generano attualmente il rilevamento specifico di EDI.

Prerequisiti

• Account e sottoscrizione di Azure. Se non si ha ancora una sottoscrizione, iscriversi per ottenere un account Azure gratuito.

• Risorsa dell'account di integrazione in cui si definiscono e archiviano elementi, ad esempio partner commerciali, accordi, certificati e così via, per l'uso nei flussi di lavoro di integrazione aziendale e B2B. Questa risorsa deve soddisfare i requisiti seguenti:

  • Sia l'account di integrazione che la risorsa dell'app per la logica devono essere presenti nella stessa sottoscrizione di Azure e nella stessa area di Azure.

  • Definisce almeno due partner commerciali che partecipano all'operazione EDIFACT usata nel flusso di lavoro. Le definizioni per entrambi i partner devono usare lo stesso qualificatore di identità aziendale, ovvero ZZZ- Definito reciprocamente per questo scenario.

  • Definisce un accordo EDIFACT tra i partner commerciali che partecipano al flusso di lavoro. Ogni accordo richiede un partner host e un partner guest. Il contenuto nei messaggi tra l'utente e l'altro partner deve corrispondere al tipo di accordo. Per informazioni sulle impostazioni dell'accordo da usare per la ricezione e l'invio di messaggi, vedere Impostazioni dei messaggi EDIFACT.

    Importante

    Il connettore EDIFACT supporta solo caratteri UTF-8. Se l'output contiene caratteri imprevisti, verificare che i messaggi EDIFACT usino il set di caratteri UTF-8.

• In base al fatto che si stia lavorando a un flusso di lavoro di app per la logica A consumo o Standard, la risorsa dell'app per la logica potrebbe richiedere un link all'account di integrazione:

  Flusso di lavoro dell'app per la logica	È necessario un link?
  Consumo	Sono necessari la connessione e il link all'account di integrazione. È possibile creare la connessione quando si aggiunge l'operazione EDIFACT al flusso di lavoro.
  Standard	È necessaria la connessione all'account di integrazione, ma non un link. È possibile creare la connessione quando si aggiunge l'operazione EDIFACT al flusso di lavoro.

• Risorsa e flusso di lavoro dell'app per la logica in cui si vogliono usare le operazioni EDIFACT.

  Per altre informazioni, consultare la documentazione seguente:

  • Creare un esempio di flusso di lavoro dell'app per la logica a consumo in App per la logica di Azure multi-tenant

  • Creare un esempio di flusso di lavoro dell'app per la logica Standard in App per la logica di Azure a tenant singolo

Codificare messaggi EDIFACT

L'azione del connettore gestito EDIFACT denominata Codifica messaggio EDIFACT e l'azione del connettore predefinito EDIFACT denominata Codifica EDIFACT esegue le seguenti attività, fatto salvo per quanto indicato in Limitazioni e problemi noti:

• Risolvere l'accordo associando il qualificatore e l'identificatore del mittente e il qualificatore e l'identificatore del destinatario.

• Serializzare l'interscambio di dati elettronici (EDI), che converte i messaggi con codifica XML in set di transazioni EDI nell'interscambio.

• Applicare segmenti di intestazione e trailer del set di transazioni.

• Generare un numero di controllo di interscambio, un numero di controllo di gruppo e un numero di controllo del set di transazioni per ogni interscambio in uscita.

• Sostituire i separatori nei dati del payload.

• Convalidare le proprietà EDI e specifiche del partner, ad esempio lo schema per gli elementi di dati del set di transazioni rispetto allo schema del messaggio, agli elementi dati del set di transazioni e alla convalida estesa sugli elementi dati del set di transazioni.

• Generare un documento XML per ogni set di transazioni.

• Richiedere un riconoscimento tecnico, un riconoscimento funzionale o entrambi, se configurati.

  • Come riconoscimento tecnico, il messaggio CONTRL indica la ricezione di un interscambio.

  • Come riconoscimento funzionale, il messaggio CONTRL indica l'accettazione o il rifiuto dell'interscambio, del gruppo o del messaggio ricevuto, compreso un elenco di errori o funzionalità non supportate.

Decodificare messaggi EDIFACT

L'azione del connettore gestito EDIFACT denominata Decodifica messaggio EDIFACT e l'azione del connettore predefinito EDIFACT denominata Decodifica EDIFACT esegue le attività seguenti, ad eccezione dei casi indicati in Limitazioni e problemi noti:

• Convalida la busta in base all'accordo tra partner commerciali.

• Risolvere l'accordo associando il qualificatore e l'identificatore del mittente unitamente al qualificatore e all'identificatore del destinatario.

• Suddivide un interscambio in diversi set di transazioni quando l'interscambio ha più di una transazione basata sulle impostazioni di ricezione dell'accordo.

• Disassemblare l'interscambio.

• Convalidare l'interscambio elettronico dei dati (EDI) e le proprietà specifiche del partner, ad esempio la struttura della busta di interscambio, lo schema della busta rispetto allo schema di controllo, lo schema per gli elementi di dati del set di transazioni e la convalida estesa sugli elementi di dati del set di transazioni.

• Verificare che i numeri di controllo interscambio, gruppo e set di transazioni non siano duplicati (solo connettore gestito), se configurati, ad esempio:

  • Confronta il numero di controllo dell'interscambio con quello degli interscambi ricevuti in precedenza.

  • Controllare il numero di controllo del gruppo con gli altri numeri di controllo del gruppo dell'interscambio.

  • Controllare il numero di controllo del set di transazioni con gli altri numeri di controllo del set transazioni in tale gruppo.

• Suddividere l'interscambio in set di transazioni o mantenere l'intero interscambio (solo connettore gestito), ad esempio:

  • Suddividi interscambio in set di transazioni - Sospendi set di transazioni in caso di errore.

    L'azione di decodifica suddivide l'interscambio in set di transazioni e analizza ogni set di transazioni. L'azione emette solo i set di transazioni che non sono stati convalidati in badMessages e restituisce i restanti set di transazioni in goodMessages.

  • Suddividi interscambio in set di transazioni - Sospendi interscambio in caso di errore.

    L'azione di decodifica suddivide l'interscambio in set di transazioni e analizza ogni set di transazioni. Se la convalida di uno o più set di transazioni dell'interscambio non riesce, l'azione emette tutti i set di transazioni in quell'interscambio in badMessages.

  • Mantieni interscambio - Sospendi set transazioni in caso di errore.

    L'azione di decodifica mantiene l'interscambio ed elabora l'intero interscambio in batch. L'azione emette solo i set di transazioni che non sono stati convalidati in badMessages e restituisce i restanti set di transazioni in goodMessages.

  • Mantieni interscambio - Sospendi interscambio in caso di errore.

    L'azione di decodifica mantiene l'interscambio ed elabora l'intero interscambio in batch. Se la convalida di uno o più set di transazioni dell'interscambio non riesce, l'azione emette tutti i set di transazioni in quell'interscambio in badMessages.

• Generare un riconoscimento tecnico, un riconoscimento funzionale o entrambi, se configurati.

  • Un riconoscimento tecnico o CONTRL ACK che segnala i risultati da un controllo sintattico nell'interscambio completo ricevuto.

  • Riconoscimento funzionale che riconosce l'accettazione o il rifiuto per l'interscambio o il gruppo ricevuto.

Gestire segmenti UNH2.5 nei documenti EDIFACT

In un documento EDIFACT il segmento UNH2.5 viene usato per la ricerca dello schema. In questo messaggio EDIFACT di esempio, ad esempio, il campo UNH è EAN008:

UNH+SSDD1+ORDERS:D:03B:UN:EAN008

Per gestire un documento EDIFACT o elaborare un messaggio EDIFACT con un segmento UN2.5, seguire questa procedura:

1. Aggiornare o distribuire uno schema con il nome del nodo radice UNH2.5.

   Si supponga, ad esempio, che il nome radice dello schema per il campo UNH di esempio sia EFACT_D03B_ORDERS_EAN008. Per ogni D03B_ORDERS che ha un segmento UNH2.5 diverso, è necessario distribuire un singolo schema.

2. Nel portale di Azure aggiungere lo schema alla risorsa dell'account di integrazione o alla risorsa dell'app per la logica, in base al flusso di lavoro dell'app per la logica A consumo o Standard.

3. Indipendentemente dal fatto che si usi l'azione di decodifica o codifica EDIFACT, caricare lo schema e configurare le impostazioni dello schema nelle sezioni Impostazioni di ricezione o Impostazioni di invio dell'accordo EDIFACT.

4. Per modificare l'accordo EDIFACT, nel riquadro Accordi selezionare l'accordo. Nella barra degli strumenti del riquadro Accordi selezionare Modifica come JSON.

   • Nella sezione receiveAgreement dell'accordo trovare la schemaReferences sezione e aggiungere il valore UNH2.5.

     

   • Nella sezione del sendAgreementcontratto trovare la schemaReferences sezione e aggiungere il valore UNH2.5.

     

Passaggi successivi

• Impostazioni dei messaggi EDIFACT