Convalidare XML nei flussi di lavoro con App per la logica di Azure

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

Negli scenari business-to-business (B2B) di integrazione aziendale, i partner commerciali in un accordo spesso devono assicurarsi che i messaggi scambiati siano validi prima che qualsiasi elaborazione dati possa iniziare. Il flusso di lavoro dell'app per la logica può convalidare messaggi e documenti XML usando l'azione di convalida XML e uno schema predefinito.

Se non si ha familiarità con le app per la logica, vedere Che cos'è App per la logica di Azure? Per altre informazioni sull'integrazione aziendale B2B, vedere Flussi di lavoro di integrazione aziendale B2B con App per la logica di Azure ed Enterprise Integration Pack.

Prerequisiti

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

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

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

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

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

  • Esiste nella stessa località o nella stessa area di Azure della risorsa dell'app per la logica in cui si prevede di usare l'azione Convalida XML*.

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

    • Schema da utilizzare per la convalida del contenuto XML.

    • Collegamento alla risorsa dell'app per la logica.

  • 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 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 artefatti, ad esempio partner, contratti e certificati, insieme all'uso delle operazioni AS2, X12 ed EDIFACT . Non è tuttavia 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 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 le operazioni di RosettaNet .

Aggiungere un'azione di convalida XML

1. Nella portale di Azure aprire l'app per la logica e il flusso di lavoro nella visualizzazione della finestra di progettazione.

2. Se si dispone di un'app per la logica vuota che non dispone di un trigger, aggiungere qualsiasi trigger desiderato. In questo esempio viene utilizzato il trigger Request. In caso contrario, continuare con il passaggio successivo.

   Per aggiungere il trigger Richiesta, nella casella di ricerca della finestra di progettazione immettere HTTP requeste selezionare il trigger Richiesta denominato Quando viene ricevuta una richiesta HTTP.

3. Nel passaggio del flusso di lavoro in cui si vuole aggiungere l'azione Convalida XML , scegliere uno dei passaggi seguenti:

   Per un'app per la logica basata su piano a consumo o ISE, scegliere un passaggio:

   • Per aggiungere l'azione Convalida XML alla fine del flusso di lavoro, selezionare Nuovo passaggio.

   • Per aggiungere l'azione Convalida XML 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.

   Per un'app per la logica basata su piano Standard, scegliere un passaggio:

   • Per aggiungere l'azione Convalida XML alla fine del flusso di lavoro, selezionare il segno più (+) e quindi selezionare Aggiungi un'azione.

   • Per aggiungere l'azione Convalida XML tra i passaggi esistenti, selezionare il segno più (+) visualizzato tra questi passaggi e quindi selezionare Aggiungi un'azione.

4. In Scegliere un'operazione selezionare Predefinita. Nella casella di ricerca immettere xml validation. Nell'elenco delle azioni selezionare Convalida XML.

5. Per specificare il contenuto XML per la convalida, fare clic all'interno della casella Contenuto in modo che venga visualizzato l'elenco di contenuto dinamico.

   L'elenco di contenuto dinamico mostra i token di proprietà che rappresentano gli output dei passaggi precedenti nel flusso di lavoro. Se l'elenco non mostra una proprietà prevista, controllare l'intestazione del trigger o dell'azione nell'elenco e se è possibile selezionare Visualizza altro.

   Per un'app per la logica basata su piano a consumo o ISE, la finestra di progettazione è simile all'esempio seguente:

   

   Per un'app per la logica basata su piano Standard, la finestra di progettazione è simile all'esempio seguente:

   

6. Nell'elenco di contenuto dinamico selezionare il token di proprietà per il contenuto da convalidare.

   In questo esempio viene selezionato il token Body dal trigger.

7. Per specificare lo schema da usare per la convalida, aprire l'elenco Nome schema e selezionare lo schema aggiunto in precedenza.

8. Al termine, assicurarsi di salvare il flusso di lavoro dell'app per la logica.

   La configurazione dell'azione di convalida XML è stata completata. In un'app reale, è possibile archiviare i dati convalidati in un'app line-of-business (LOB), ad esempio SalesForce. Per inviare l'output convalidato a Salesforce, aggiungere un'azione Salesforce.

9. Per testare l'azione di convalida, attivare ed eseguire il flusso di lavoro. Ad esempio, per il trigger Di richiesta, inviare una richiesta all'URL dell'endpoint del trigger.

   L'azione convalida XML viene eseguita dopo l'attivazione del flusso di lavoro e quando il contenuto XML è disponibile per la convalida.

Passaggi successivi

• Aggiungere schemi per la convalida XML in App per la logica di Azure
• Trasformare XML per i flussi di lavoro in App per la logica di Azure