Condividi tramite

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

  • Articolo

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.

App per la logica Ambiente Versione del connettore
Consumo App per la logica di Azure multi-tenant Connettore gestito EDIFACT (classe Standard). Il connettore EDIFACT fornisce solo azioni, ma è possibile usare qualsiasi trigger che funzioni per lo scenario. Per altre informazioni, vedere la documentazione seguente:

- Informazioni di riferimento sui connettori gestiti EDIFACT
- Limiti dei messaggi EDIFACT
Standard App per la logica di Azure a tenant singolo e ambiente del servizio app v3 (solo piani di Windows) Connettore predefinito EDIFACT (anteprima) e connettore gestito EDIFACT. La versione predefinita differisce nei modi seguenti:

- La versione predefinita fornisce solo azioni, ma è possibile usare qualsiasi trigger che funzioni per lo scenario.

- La versione predefinita può accedere direttamente alle reti virtuali di Azure. Non è necessario un gateway dati locale.

Per altre informazioni, vedere la documentazione seguente:

- Informazioni di riferimento sui connettori gestiti EDIFACT
- Operazioni predefinite del connettore EDIFACT
- Limiti dei messaggi EDIFACT

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.

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:

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.

  1. Nel portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.

  2. Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione EDIFACT denominata Codifica messaggio EDIFACT in base al nome dell'accordo al flusso di lavoro.

    Nota

    Se invece si vuole usare l'azione Codifica al messaggio EDIFACT in base alle identità, è necessario specificare valori differenti, ad esempio l'identificatore mittente e l'identificatore destinatario indicati dall'accordo EDIFACT. È anche necessario specificare il messaggio XML da codificare, che può essere l'output del trigger o un'azione precedente.

  3. Specificare le seguenti informazioni di connessione per l'account di integrazione:

    Proprietà Richiesto Descrizione
    Nome connessione Sì Nome per la connessione
    Account di integrazione Sì Selezionare l'account da usare nell'elenco degli account di integrazione disponibili.

    Ad esempio:

    Screenshot che mostra il portale di Azure, il flusso di lavoro A consumo e la casella di connessione per l'azione denominata Codifica messaggio EDIFACT in base al nome dell'accordo.

  4. Al termine, seleziona Crea.

  5. Nell'azione EDIFACT specificare i valori delle proprietà seguenti:

    Proprietà Richiesto Descrizione
    Nome dell'accordo EDIFACT Sì Accordo EDIFACT da utilizzare.
    Messaggio XML da codificare Sì Identificatore aziendale per il mittente del messaggio come specificato dall'accordo EDIFACT
    Altri parametri No Questa operazione include i seguenti altri parametri:

    - Separatore elementi dati
    - Indicatore versione
    - Separatore componenti
    - Separatore ripetizioni
    - Carattere di terminazione segmento
    - Suffisso carattere di terminazione segmento
    - Indicatore decimali

    Per altre informazioni, vedere Impostazioni dei messaggi EDIFACT.

    Ad esempio, il payload del messaggio XML da codificare può essere l'output del contenuto del Corpo dal trigger Richiedi:

    Screenshot che mostra il flusso di lavoro A consumo, l'azione denominata Codifica messaggio EDIFACT in base al nome dell'accordo e le proprietà di codifica del messaggio.

  6. Salvare il flusso di lavoro.

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.

  1. Nel portale di Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.

  2. Nella finestra di progettazione seguire questa procedura generale per aggiungere l'azione EDIFACT denominata Decodifica messaggio EDIFACT al flusso di lavoro.

  3. Specificare le seguenti informazioni di connessione per l'account di integrazione:

    Proprietà Richiesto Descrizione
    Nome connessione Sì Nome per la connessione
    Account di integrazione Sì Selezionare l'account da usare nell'elenco degli account di integrazione disponibili.

    Ad esempio:

    Screenshot che mostra la finestra di progettazione del flusso di lavoro A consumo e il riquadro di connessione per l'azione denominata Decodifica messaggio EDIFACT.

  4. Al termine, seleziona Crea.

  5. Nell'azione EDIFACT specificare i valori delle proprietà seguenti:

    Proprietà Richiesto Descrizione
    Messaggio file flat EDIFACT da decodificare Sì Messaggio file flat XML da decodificare.
    Altri parametri No Questa operazione include i seguenti altri parametri:

    - Separatore componenti
    - Separatore elementi dati
    - Indicatore versione
    - Separatore ripetizioni
    - Carattere di terminazione segmento
    - Suffisso carattere di terminazione segmento
    - Indicatore decimali
    - Set di caratteri payload
    - Suffisso carattere di terminazione segmento
    - Preserve Interchange
    - Sospendi interscambio in caso di errore

    Per altre informazioni, vedere Impostazioni dei messaggi EDIFACT.

    Ad esempio, il payload del messaggio XML da decodificare può essere l'output del contenuto del Corpo dal trigger Richiedi:

    Screenshot che mostra il flusso di lavoro A consumo, l'azione denominata Decodifica messaggio EDIFACT e le proprietà di decodifica dei messaggi.

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.

      Screenshot che mostra il portale di Azure con la sezione

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

      Screenshot che mostra il portale di Azure con la sezione

Passaggi successivi