Condividi tramite

Scambiare messaggi X12 con flussi di lavoro in App per la logica di Azure

  • Articolo

Si applica a: App per la logica di Azure (a consumo e standard)

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

Questa guida pratica illustra come aggiungere le azioni di codifica e decodifica X12 a un flusso di lavoro di app per la logica esistente. Il connettore X12 non include trigger, quindi è possibile usare qualsiasi trigger per avviare il flusso di lavoro. Gli esempi in questa guida usano il trigger Richiedi.

Informazioni tecniche sul connettore

Il connettore X12 ha una versione tra flussi di lavoro in App per la logica di Azure multi-tenant e app per la logica di Azure a tenant singolo. Per informazioni tecniche sul connettoreX12, vedere la documentazione seguente:

Prerequisiti

  • Account e sottoscrizione di Azure. Se non si dispone ancora di una sottoscrizione di Azure, registrarsi per creare 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 X12 usata nel flusso di lavoro. Le definizioni per entrambi i partner devono usare lo stesso qualificatore di identità aziendale X12.

    • Definisce un accordo X12 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 X12.

      Importante

      Se si usano gli schemi HIPAA, è necessario aggiungere una sezione schemaReferences all'accordo. Per altre informazioni, vedere Schemi e tipi di messaggio HIPAA.

    • Definisce gli schemi da utilizzare per la convalida XML.

      Importante

      Se si lavora con schemi HIPAA (Health Insurance Portability and Accountability Act), assicurarsi di esaminare gli schemi e i tipi di messaggio HIPAA.

  • 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 X12 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 X12 al flusso di lavoro.

  • La risorsa e il flusso di lavoro dell'app per la logica in cui si vogliono usare le operazioni X12.

    Per altre informazioni, consultare la documentazione seguente:

Messaggi Encode X12

L'operazione Codifica messaggio X12 esegue le attività seguenti:

  • Risolve l'accordo associando le proprietà del contesto di mittente e del destinatario.
  • Serializza l'interscambio EDI e converte i messaggi con codifica XML in set di transazioni EDI nell'interscambio.
  • Si applica ai segmenti di intestazione e finali del set di transazioni.
  • Genera 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.
  • Sostituisce i separatori nei dati del payload.
  • Convalida le proprietà EDI e specifiche del partner.
    • Convalida dello schema degli elementi dati del set di transazioni rispetto allo schema del messaggio.
    • Convalida EDI sugli elementi di dati del set di transazioni.
    • Convalida estesa sugli elementi dati del set di transazioni.
  • Richiede un Riconoscimento tecnico e funzionale, se configurata.
    • Genera un riconoscimento tecnico in seguito alla convalida dell'intestazione. Il riconoscimento tecnico segnala lo stato dell'elaborazione di un'intestazione e finale di interscambio in base all'indirizzo del ricevitore.
    • Viene un riconoscimento funzionale in seguito alla convalida del corpo. Il riconoscimento funzionale segnala ogni errore rilevato durante l'elaborazione del documento 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 X12 denominata Codifica messaggio X12 in base al nome dell'accordo al flusso di lavoro.

    Nota

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

  3. Quando richiesto, 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 flusso di lavoro A consumo e le informazioni di connessione per l'azione denominata Codifica messaggio X12 in base al nome dell'accordo.

  4. Al termine, seleziona Crea.

  5. Nella casella delle informazioni sull'azione X12 specificare i valori delle proprietà seguenti:

    Proprietà Richiesto Descrizione
    Nome del contratto X12 Sì Accordo X12 da usare.
    Messaggio XML da codificare Sì Messaggio XML da codificare
    Altri parametri No Questa operazione include i seguenti altri parametri:

    - Separatore elementi dati
    - Separatore componenti
    - Carattere sostitutivo
    - Carattere di terminazione segmento
    - Suffisso carattere di terminazione segmento
    - Numero versione controllo
    - Identificatore/Codice del mittente dell'applicazione GS02
    - Identificatore/Codice del destinatario dell'applicazione GS03

    Per altre informazioni, vedere Impostazioni dei messaggi X12.

    Ad esempio, è possibile usare l'output del contenuto Corpo del trigger Richiedi come payload del messaggio XML:

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

Messaggi Decode X12

L'operazione Decodifica messaggio X12 esegue le attività seguenti:

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

  • Convalida le proprietà EDI e specifiche del partner.

    • Convalida strutturale EDI e convalida estesa dello schema
    • Convalida strutturale della busta interscambio
    • Convalida dello schema della busta in base allo schema di controllo
    • Convalida dello schema degli elementi dati del set di transazioni rispetto allo schema del messaggio
    • Convalida EDI sugli elementi dati del set di transazioni

  • Verifica che i numeri di controllo di un set di interscambio, gruppo e di transazioni non siano duplicati.

    • Controlla il numero di controllo dell'interscambio rispetto agli interscambi ricevuti in precedenza.
    • Controlla il numero di controllo del gruppo con gli altri numeri di controllo del gruppo dell'interscambio.
    • Controlla il numero di controllo del set di transazioni con gli altri numeri di controllo del set transazioni in tale gruppo.

  • Suddivide un interscambio in set di transazioni o mantiene l'intero interscambio:

    • Suddividere l'interscambio in set di transazioni o sospendere i set di transazioni in caso di errore: analizzare ogni set di transazioni. L'azione Decodifica X12 restituisce solo i set di transazioni che non sono stati convalidati in badMessages e restituisce i restanti set di transazioni in goodMessages.

    • Suddividere l'interscambio in set di transazioni o sospendere l'interscambio in caso di errore: analizzare ogni set di transazioni. Se la convalida di uno o più set di transazioni dell'interscambio non riesce, l'azione Decodifica X12 restituisce tutti i set di transazioni in quell'interscambio in badMessages.

    • Mantenere l'interscambio o sospendere i set transazioni in caso di errore: Mantenere l'interscambio ed elaborare l'intero interscambio in batch. L'azione Decodifica X12 restituisce solo i set di transazioni che non sono stati convalidati in badMessages e restituisce i restanti set di transazioni in goodMessages.

    • Mantenere l'interscambio o sospenderlo in caso di errore: Mantenere l'interscambio ed elaborare l'intero interscambio in batch. Se la convalida di uno o più set di transazioni dell'interscambio non riesce, l'azione Decodifica X12 restituisce tutti i set di transazioni in quell'interscambio in badMessages.

  • Genera un Riconoscimento tecnico e funzionale, se configurata.

    • Genera un riconoscimento tecnico in seguito alla convalida dell'intestazione. Il riconoscimento tecnico segnala lo stato dell'elaborazione di un'intestazione e finale di interscambio in base all'indirizzo del ricevitore.
    • Viene un riconoscimento funzionale in seguito alla convalida del corpo. Il riconoscimento funzionale segnala ogni errore rilevato durante l'elaborazione del documento 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 X12 denominata Decodifica messaggio X12 al flusso di lavoro.

  3. Quando richiesto, 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 flusso di lavoro A consumo e le informazioni di connessione per l'azione denominata Decodifica messaggio X12(Decodifica messaggio X12).

  4. Al termine, seleziona Crea.

  5. Nella casella delle informazioni sull'azione X12 specificare i valori delle proprietà seguenti:

    Proprietà Richiesto Descrizione
    Messaggio file flat X12 da decodificare Sì Messaggio X12 in formato file flat da decodificare

    Nota: il payload o il contenuto del messaggio XML per l'array di messaggi, valido o negativo, è codificato in base64. Pertanto è necessario usare un'espressione che elabori questo contenuto. Ad esempio, l'espressione seguente elabora il contenuto del messaggio come XML:

    xml(base64ToBinary(item()?['Body']))
    Altri parametri No Questa operazione include i seguenti altri parametri:

    - Preserve Interchange
    - Sospendi interscambio in caso di errore

    Per altre informazioni, vedere Impostazioni dei messaggi X12.

    Ad esempio, è possibile usare l'output del contenuto Corpo del trigger Richiedi come payload del messaggio XML, ma è prima necessario pre-elaborare questo contenuto usando un'espressione:

    Screenshot che mostra il flusso di lavoro A consumo, l'azione denominata Decodifica messaggio X12 e le proprietà dell'azione.

Passaggi successivi