Codificare e decodificare file flat in App per la logica di Azure

Prima di inviare contenuto XML a un business partner in uno scenario business-to-business (B2B), è consigliabile codificare prima tale contenuto. Creando un flusso di lavoro dell'app per la logica, è possibile codificare e decodificare file flat usando le azionifileflat incorporate.

Anche se non sono disponibili trigger di file flat, è possibile usare un trigger o un'azione diversa per ottenere o alimentare il contenuto XML da diverse origini nel flusso di lavoro per la codifica o la decodifica. Ad esempio, è possibile usare il trigger Richiesta, un'altra app o altri connettori supportati da App per la logica di Azure. È possibile usare azioni file flat con flussi di lavoro nei tipi di risorse App per la logica (consumo) e App per la logica (Standard).

Nota

Per App per la logica (Standard), le azioni file flat sono attualmente in anteprima.

Questo articolo illustra come aggiungere le azioni di codifica e decodifica di file flat a un flusso di lavoro di app per la logica esistente. Se non si ha una nuova versione delle app per la logica, vedere la documentazione seguente:

Prerequisiti

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

  • Risorsa dell'account di integrazione in cui definire e archiviare elementi, ad esempio partner commerciali, contratti, certificati e così via, da usare nei flussi di lavoro di integrazione aziendale e B2B. Questa risorsa deve soddisfare i requisiti seguenti:

    • È associato alla stessa sottoscrizione di Azure della risorsa dell'app per la logica.

    • Si trova nella stessa posizione o area di Azure della risorsa dell'app per la logica.

    • Se si usa il tipo di risorsa App per la logica (consumo),l'account di integrazione richiede gli elementi seguenti:

    • Se si usa il tipo di risorsa App per la logica (Standard),gli schemi non vengono archiviati nell'account di integrazione. È invece possibile aggiungere direttamente gli schemi alla risorsa dell'app per la logica usando il portale di Azure o Visual Studio Code. È quindi possibile usare questi schemi in più flussi di lavoro all'interno della stessa risorsa dell'app per la logica.

      È comunque necessario un account di integrazione per archiviare altri elementi, ad esempio partner, contratti e certificati, oltre a usare le operazioni AS2,X12ed EDIFACT. Tuttavia, non è necessario collegare la risorsa dell'app per la logica all'account di integrazione, quindi la funzionalità di collegamento non esiste. L'account di integrazione deve comunque soddisfare altri requisiti, ad esempio l'uso della stessa sottoscrizione di Azure e l'esistente nella stessa posizione della risorsa dell'app per la logica.

      Nota

      Attualmente, solo il tipo di risorsa App per la logica (consumo) supporta le operazioni RosettaNet. Il tipo di risorsa App per la logica (Standard) non include operazioni RosettaNet.

  • Flusso di lavoro dell'app per la logica, vuoto o esistente, in cui si vuole usare l'azione File flat.

    Se si dispone di un flusso di lavoro vuoto, usare qualsiasi trigger per avviare il flusso di lavoro. In questo esempio viene utilizzato il trigger Request.

Limiti

Assicurarsi che i gruppi XML contenuti nello schema di file flat generato non presentino un numero eccessivo della proprietà impostata su un valore max countmax count Evitare di annidare un gruppo XML con un valore di proprietà maggiore di 1 all'interno di un altro gruppo XML con max count una proprietà maggiore di max count 1.

Ogni volta che lo schema di file flat consente di scegliere il frammento successivo, il motore di App per la logica di Azure che analizza lo schema genera un simbolo e una stima per tale frammento. Se lo schema consente troppi costrutti di questo tipo, ad esempio più di 100.000, l'espansione dello schema diventa eccessivamente grande, con un utilizzo eccessivo di risorse e tempo.

Azione Aggiungi codifica file flat

  1. Nella finestra di portale di Azureaprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

  2. Se si dispone di un flusso di lavoro vuoto che non dispone di un trigger, aggiungere qualsiasi trigger desiderato. In caso contrario, continuare con il passaggio successivo.

    Questo esempio usa il trigger Richiesta, denominato Quando viene ricevuta una richiesta HTTP,e gestisce le richieste in ingresso dall'esterno del flusso di lavoro dell'app per la logica. Per aggiungere il trigger Richiesta, seguire questa procedura:

    1. Nella casella di ricerca della finestra di progettazione selezionare Predefinita. Nella casella di ricerca della finestra di progettazione immettere HTTP request .

    2. Nell'elenco dei trigger selezionare il trigger di richiesta denominato Quando viene ricevuta una richiesta HTTP.

    Suggerimento

    Fornire uno schema JSON è facoltativo. Se si ha un payload di esempio dalla richiesta in ingresso, selezionare Usa payload di esempio per generare lo schema,immettere il payload di esempio e selezionare Fine. Lo schema viene visualizzato nella casella Schema JSON del corpo della richiesta.

  3. Nel passaggio del flusso di lavoro in cui si vuole aggiungere l'azione Codifica file flat scegliere un'opzione:

    • Per aggiungere l'azione Codifica file flat alla fine del flusso di lavoro, selezionare Nuovo passaggio.

    • Per aggiungere l'azione Codifica file flat tra i passaggi esistenti, spostare il puntatore sulla freccia che connette tali passaggi in modo che venga visualizzato il segno più ( ). Selezionare il segno più e quindi selezionare Aggiungi un'azione.

  4. Nella casella di ricerca Scegliere un'operazione immettere . Nell'elenco delle azioni selezionare l'azione denominata Flat File Encoding.

    Screenshot che mostra la finestra portale di Azure e Progettazione consumo con

  5. Fare clic all'interno della casella Contenuto in modo che venga visualizzato l'elenco di contenuto dinamico. Nella sezione Quando viene ricevuta una richiesta HTTP dell'elenco selezionare la proprietà Corpo che contiene l'output del corpo della richiesta dal trigger e il contenuto da codificare.

    Screenshot che mostra la finestra di progettazione a consumo e la proprietà

    Suggerimento

    Se la proprietà Corpo non viene visualizzata nell'elenco di contenuto dinamico, selezionare Altre informazioni accanto all'etichetta della sezione Quando viene ricevuta una richiesta HTTP. È anche possibile immettere direttamente il contenuto da decodificare nella casella Contenuto.

  6. Nell'elenco Nome schema selezionare lo schema nell'account di integrazione collegato da usare per la codifica, ad esempio:

    Screenshot che mostra Progettazione utilizzo e l'elenco

    Nota

    Se nell'elenco non viene visualizzato alcuno schema, l'account di integrazione non contiene file di schema da usare per la codifica. Upload lo schema che si vuole usare nell'account di integrazione.

  7. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

  8. Per testare il flusso di lavoro, inviare una richiesta all'endpoint HTTPS, visualizzato nella proprietà URL HTTP POST del trigger di richiesta, e includere il contenuto XML da codificare nel corpo della richiesta.

La configurazione dell'azione di codifica file flat è stata completata. In un'app reale, è possibile archiviare i dati codificati in un'app line-of-business (LOB), ad esempio Salesforce. In caso contrario, è possibile inviare i dati codificati a un partner commerciale. Per inviare l'output dell'azione di codifica a Salesforce o al partner commerciale, usare gli altri connettori disponibili in App per la logica di Azure.

Aggiungere l'azione Decodifica file flat

  1. Nella finestra di portale di Azureaprire il flusso di lavoro dell'app per la logica nella finestra di progettazione.

  2. Se si dispone di un flusso di lavoro vuoto che non dispone di un trigger, aggiungere i trigger desiderati. In caso contrario, continuare con il passaggio successivo.

    Questo esempio usa il trigger Di richiesta, denominato Alla ricezione di una richiesta HTTP,e gestisce le richieste in ingresso dall'esterno del flusso di lavoro dell'app per la logica. Per aggiungere il trigger di richiesta, seguire questa procedura:

    1. Nella casella di ricerca della finestra di progettazione selezionare Predefinita. Nella casella di ricerca della finestra di progettazione immettere HTTP request .

    2. Nell'elenco dei trigger selezionare il trigger di richiesta denominato Alla ricezione di una richiesta HTTP.

    Suggerimento

    Specificare uno schema JSON è facoltativo. Se si dispone di un payload di esempio dalla richiesta in ingresso, selezionare Use sample payload to generate schema (Usa payload di esempio per generare lo schema),immettere il payload di esempio e selezionare Done (Fine). Lo schema viene visualizzato nella casella Schema JSON del corpo della richiesta.

  3. Nel passaggio del flusso di lavoro in cui si vuole aggiungere l'azione Decodifica file flat scegliere un'opzione:

    • Per aggiungere l'azione Decodifica file flat alla fine del flusso di lavoro, selezionare Nuovo passaggio.

    • Per aggiungere l'azione Decodifica file flat tra passaggi esistenti, spostare il puntatore sulla freccia che connette tali passaggi in modo che venga visualizzato il segno più ( ). Selezionare il segno più e quindi selezionare Aggiungi un'azione.

  4. Nella casella di ricerca Scegliere un'operazione immettere . Nell'elenco delle azioni selezionare l'azione denominata Decodifica file flat.

    Screenshot che mostra il portale di Azure e Progettazione consumo con

  5. Fare clic all'interno della casella Contenuto in modo che venga visualizzato l'elenco di contenuto dinamico. Nella sezione Alla ricezione di una richiesta HTTP dell'elenco selezionare la proprietà Corpo che contiene l'output del corpo della richiesta dal trigger e il contenuto da decodificare.

    Screenshot che mostra La finestra di progettazione consumo e la proprietà

    Suggerimento

    Se la proprietà Corpo non viene visualizzata nell'elenco di contenuto dinamico, selezionare Vedi altro accanto all'etichetta della sezione Alla ricezione di una richiesta HTTP. È anche possibile immettere direttamente il contenuto da decodificare nella casella Contenuto.

  6. Nell'elenco Nome schema selezionare lo schema nell'account di integrazione collegato da usare per la decodifica, ad esempio:

    Screenshot che mostra Progettazione consumo e l'elenco

    Nota

    Se nell'elenco non viene visualizzato alcuno schema, l'account di integrazione non contiene file di schema da usare per la decodifica. Upload lo schema da usare per l'account di integrazione.

  7. Salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione selezionare Salva.

  8. Per testare il flusso di lavoro, inviare una richiesta all'endpoint HTTPS, visualizzato nella proprietà URL HTTP POST del trigger di richiesta, e includere il contenuto XML da decodificare nel corpo della richiesta.

La configurazione dell'azione di decodifica del file flat è stata completata. In un'app reale è possibile archiviare i dati decodificati in un'app line-of-business (LOB), ad esempio Salesforce. In caso contrario, è possibile inviare i dati decodificati a un partner commerciale. Per inviare l'output dell'azione di decodifica a Salesforce o al partner commerciale, usare gli altri connettori disponibili in App per la logica di Azure.

Passaggi successivi