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 tramite 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 Request.

Riferimento tecnico Connessione or

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 di Connessione or
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 sul connettore gestito EDIFACT - Limiti dei messaggi EDIFACT
Consumo	Ambiente del servizio di integrazione	Connettore gestito EDIFACT (classe Standard) ed EDIFACT I edizione Standard versione, con limiti di messaggio diversi rispetto alla 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 sul connettore gestito 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 è diversa 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 sul connettore gestito 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.

• Azione di codifica EDIFACT
• Azione decodifica EDIFACT

Limitazioni e problemi noti

• Anteprima del connettore predefinito EDIFACT

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

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

  • L'azione di 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 predefinite del connettore EDIFACT e Codifica EDIFACT in anteprima hanno funzionalità simili alle azioni del connettore gestito EDIFACT corrispondenti.

  • 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 archivia elementi, ad esempio partner commerciali, contratti, 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 esistere 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- A vicenda definito per questo scenario.

  • Definisce un accordo EDIFACT tra i partner commerciali che partecipano al flusso di lavoro. Ogni contratto richiede un partner host e un partner guest. Il contenuto nei messaggi tra l'utente e l'altro partner deve corrispondere al tipo di contratto. Per informazioni sulle impostazioni del contratto 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 collegamento all'account di integrazione:

  Flusso di lavoro dell'app per la logica	Collegamento obbligatorio?
  Consumo	sono necessari Connessione ion e collegamenti all'account di integrazione. È possibile creare la connessione quando si aggiunge l'operazione EDIFACT al flusso di lavoro.
  Standard	Connessione all'account di integrazione necessario, ma non è necessario alcun collegamento. È 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 Encode to EDIFACT message action and the EDIFACT built-in connector action named EDIFACT Encode esegue le attività seguenti, tranne dove indicato in Limitazioni e problemi noti:

• Risolvere il contratto abbinando il qualificatore e l'identificatore del mittente e il qualificatore e l'identificatore del ricevitore.

• 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 interscambio, un numero di controllo del 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 ricevuta per un interscambio.

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

Consumo

1. Nella 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 Encode to EDIFACT message by agreement name (Codifica al messaggio EDIFACT in base al nome del contratto) al flusso di lavoro.

   Nota

   Se invece si vuole usare l'azione Encode to EDIFACT message by identityes, è necessario specificare valori diversi, ad esempio l'identificatore mittente e l'identificatore ricevitore specificati dal contratto EDIFACT. È anche necessario specificare il messaggio XML da codificare, che può essere l'output del trigger o un'azione precedente.

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

   Proprietà	Richiesto	Descrizione
   Nome connessione	Sì	Nome della connessione
   Account di integrazione	Sì	Nell'elenco degli account di integrazione disponibili selezionare l'account da usare.

   Ad esempio:

   

4. Al termine, seleziona Crea.

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

   Proprietà	Richiesto	Descrizione
   Nome del contratto EDIFACT	Sì	Contratto EDIFACT da utilizzare.
   Messaggio XML da codificare	Sì	Identificatore aziendale per il mittente del messaggio come specificato dal contratto EDIFACT
   Altri parametri	No	Questa operazione include gli altri parametri seguenti: - Separatore elemento dati - Indicatore di rilascio - Separatore dei componenti - Separatore ripetizioni - Carattere di terminazione segmento - Suffisso del carattere di terminazione segmento - Indicatore decimale 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 Richiesta:

   

6. Salvare il flusso di lavoro.

Standard

Connettore predefinito EDIFACT (anteprima)

1. Nella 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 EDIFACT al flusso di lavoro.

3. Nel riquadro azioni EDIFACT specificare i valori delle proprietà obbligatori:

   Proprietà	Richiesto	Descrizione
   Messaggio da codificare	Sì	Contenuto del messaggio XML da codificare. In particolare, l'identificatore di business per il mittente del messaggio, come specificato dal contratto EDIFACT.
   Parametri avanzati	No	Nell'elenco aggiungere tutte le altre proprietà che si desidera utilizzare. Questa operazione include gli altri parametri seguenti: - Qualificatore del ricevitore dell'identità mittente - Identificatore del ricevitore dell'identità del mittente - Qualificatore ricevitore di identità ricevitore - Identificatore del ricevitore di identità ricevitore - Nome del contratto EDIFACT

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

   

4. Salvare il flusso di lavoro.

Connettore gestito EDIFACT

1. Nella 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 Encode to EDIFACT message by agreement name (Codifica al messaggio EDIFACT in base al nome del contratto) al flusso di lavoro.

   Nota

   Se invece si vuole usare l'azione Encode to EDIFACT message by identityes, è necessario specificare valori diversi, ad esempio l'identificatore mittente e l'identificatore ricevitore specificati dal contratto EDIFACT. È anche necessario specificare il messaggio XML da codificare, che può essere l'output del trigger o un'azione precedente.

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

   Proprietà	Richiesto	Descrizione
   Nome connessione	Sì	Nome della connessione
   ID account di integrazione	Sì	ID risorsa per l'account di integrazione, che ha il formato seguente: /subscriptions/<Azure-subscription-ID>/resourceGroups/<resource-group-name>/providers/Microsoft.Logic/integrationAccounts/<integration-account-name> Ad esempio: /subscriptions/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/resourceGroups/integrationAccount-RG/providers/Microsoft.Logic/integrationAccounts/myIntegrationAccount Per trovare questo ID risorsa, seguire questa procedura: 1. Nel portale di Azure aprire l'account di integrazione. 2. Nel menu dell'account di integrazione selezionare Panoramica. 3. Nella pagina Panoramica selezionare Visualizzazione JSON. 4. Dalla proprietà ID risorsa copiare il valore.
   URL di firma di accesso condiviso dell'account di integrazione	Sì	URL dell'endpoint della richiesta che usa l'autenticazione di firma di accesso condiviso (SAS) per fornire l'accesso all'account di integrazione. Questo URL di callback ha il formato seguente: https://<request-endpoint-URI>sp=<permissions>sv=<SAS-version>sig=<signature> Ad esempio: https://prod-04.west-us.logic-azure.com:443/integrationAccounts/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX?api-version=2015-08-1-preview&sp=XXXXXXXXX&sv=1.0&sig=ZZZZZZZZZZZZZZZZZZZZZZZZZZZ Per trovare questo URL, seguire questa procedura: 1. Nel portale di Azure aprire l'account di integrazione. 2. Nel menu dell'account di integrazione, in Impostazioni, selezionare URL di callback. 3. Dalla proprietà URL callback generato copiare il valore.
   Dimensioni del blocco dei numeri di controllo	No	Dimensioni del blocco di numeri di controllo da riservare da un contratto per scenari con velocità effettiva elevata

   Ad esempio:

   

4. Al termine, seleziona Crea.

5. Nel riquadro azioni EDIFACT specificare i valori delle proprietà seguenti:

   Proprietà	Richiesto	Descrizione
   Nome del contratto EDIFACT	Sì	Contratto EDIFACT da utilizzare.
   Messaggio XML da codificare	Sì	Identificatore aziendale per il mittente del messaggio come specificato dal contratto EDIFACT
   Altri parametri	No	Questa operazione include gli altri parametri seguenti: - Separatore elemento dati - Indicatore di rilascio - Separatore dei componenti - Separatore ripetizioni - Carattere di terminazione segmento - Suffisso del carattere di terminazione segmento - Indicatore decimale 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 Richiesta:

   

6. Salvare il flusso di lavoro.

Decodificare messaggi EDIFACT

L'azione del connettore gestito EDIFACT denominata Decode EDIFACT message action e l'azione predefinita del connettore EDIFACT denominata EDIFACT Decode esegue le attività seguenti, ad eccezione dei casi indicati in Limitazioni e problemi noti:

• Convalidare la busta rispetto all'accordo tra partner commerciali.

• Risolvere il contratto associando il qualificatore e l'identificatore del mittente insieme al qualificatore e all'identificatore del ricevitore.

• Suddividere un interscambio in più set di transazioni quando l'interscambio ha più transazioni, in base all'Impostazioni Di ricezione del contratto.

• 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:

  • Controllare il numero di controllo dell'interscambio rispetto agli interscambi ricevuti in precedenza.

  • Controllare il numero di controllo del gruppo rispetto ad altri numeri di controllo del gruppo nell'interscambio.

  • Controllare il numero di controllo del set di transazioni rispetto ad altri numeri di controllo del set di transazioni in tale gruppo.

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

  • Divisione interscambio come set di transazioni: sospendi i 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 restituisce solo i set di transazioni che non riescono a convalidare badMessagese restituisce i set di transazioni rimanenti su goodMessages.

  • Divisione interscambio come set di transazioni: sospendere l'interscambio in caso di errore.

    L'azione di decodifica suddivide l'interscambio in set di transazioni e analizza ogni set di transazioni. Se uno o più set di transazioni nell'interscambio non riescono a convalidare, l'azione restituisce tutti i set di transazioni nell'interscambio su badMessages.

  • Mantieni interscambio: sospendi i set di transazioni in caso di errore.

    L'azione di decodifica mantiene l'interscambio ed elabora l'intero interscambio in batch. L'azione restituisce solo i set di transazioni che non riescono a convalidare badMessagese restituisce i set di transazioni rimanenti su goodMessages.

  • Mantieni interscambio: sospende l'interscambio in caso di errore.

    L'azione di decodifica mantiene l'interscambio ed elabora l'intero interscambio in batch. Se uno o più set di transazioni nell'interscambio non riescono a convalidare, l'azione restituisce tutti i set di transazioni nell'interscambio su badMessages.

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

  • Un riconoscimento tecnico o CONTRL ACK, che segnala i risultati di un controllo sintattico sull'interscambio ricevuto completo.

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

Consumo

1. Nella 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 Decode EDIFACT message to your workflow (Decode EDIFACT message to your workflow).

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

   Proprietà	Richiesto	Descrizione
   Nome connessione	Sì	Nome della connessione
   Account di integrazione	Sì	Nell'elenco degli account di integrazione disponibili selezionare l'account da usare.

   Ad esempio:

   

4. Al termine, seleziona Crea.

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

   Proprietà	Richiesto	Descrizione
   Messaggio di file flat EDIFACT da decodificare	Sì	Messaggio di file flat XML da decodificare.
   Altri parametri	No	Questa operazione include gli altri parametri seguenti: - Separatore dei componenti - Separatore elemento dati - Indicatore di rilascio - Separatore ripetizioni - Carattere di terminazione segmento - Suffisso del carattere di terminazione segmento - Indicatore decimale - Set di caratteri payload - Suffisso del carattere di terminazione segmento - Mantieni interscambio - 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 del trigger Richiesta:

   

Standard

Connettore predefinito EDIFACT (anteprima)

1. Nella 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 questi passaggi generali per aggiungere l'azione EDIFACT denominata EDIFACT Decode al flusso di lavoro.

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

   Proprietà	Richiesto	Descrizione
   Messaggio da decodificare	Sì	Messaggio di file flat XML da decodificare.
   Altri parametri	No	Questa operazione include gli altri parametri seguenti: - Separatore componenti - Separatore elementi dati - Indicatore di versione - Separatore ripetizioni - Carattere di terminazione segmento - Suffisso terminatore segmento - Indicatore decimale - Set di caratteri payload - Suffisso terminatore segmento - Mantieni interscambio - 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 del trigger Richiesta:

   

4. Salvare il flusso di lavoro.

Connettore gestito EDIFACT

1. Nella 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 Decode EDIFACT message to your workflow (Decode EDIFACT message to your workflow).

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

   Proprietà	Richiesto	Descrizione
   Nome connessione	Sì	Nome della connessione
   Account di integrazione	Sì	Nell'elenco degli account di integrazione disponibili selezionare l'account da usare.

   Ad esempio:

   

4. Al termine, seleziona Crea.

5. Nel riquadro azioni EDIFACT specificare i valori delle proprietà seguenti:

   Proprietà	Richiesto	Descrizione
   Nome del contratto EDIFACT	Sì	Contratto EDIFACT da utilizzare.
   Messaggio XML da codificare	Sì	Identificatore aziendale per il mittente del messaggio come specificato dal contratto EDIFACT
   Altri parametri	No	Questa operazione include gli altri parametri seguenti: - Separatore elemento dati - Indicatore di rilascio - Separatore dei componenti - Separatore ripetizioni - Carattere di terminazione segmento - Suffisso del carattere di terminazione segmento - Indicatore decimale 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 del trigger Richiesta:

   

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. Nella portale di Azure aggiungere lo schema alla risorsa dell'account di integrazione o alla risorsa dell'app per la logica, in base al fatto che si disponga rispettivamente di un 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 rispettivamente nelle sezioni Receive Impostazioni o Send Impostazioni del contratto EDIFACT.

4. Per modificare il contratto EDIFACT, nel riquadro Contratti selezionare il contratto. Sulla barra degli strumenti del riquadro Contratti selezionare Modifica come JSON.

   • Nella sezione del receiveAgreement contratto 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