Condividi tramite


Analizzare il codice XML usando gli schemi nei flussi di lavoro Standard con App per la logica di Azure (anteprima)

Si applica: App per la logica di Azure (Standard)

Importante

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

Negli scenari di migrazione business-to-business (B2B) o BizTalk di integrazione aziendale potrebbe essere necessario analizzare i documenti XML. Il flusso di lavoro dell'app per la logica Standard può analizzare XML usando l'azione parse XML with Schema, che richiede uno schema XSD.

Si supponga, ad esempio, di ricevere regolarmente ordini cliente o fatture che utilizzano XML come formato di scambio e di dover accedere a singoli elementi XML nella finestra di progettazione del flusso di lavoro per App per la logica di Azure.

Limiti

Questa azione non è attualmente supportata per la risorsa e il flusso di lavoro dell'app per la logica a consumo.

Prerequisiti

  • Account e 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 Standard che inizia già con un trigger in modo da poter aggiungere l'azione Analizza XML con schema al flusso di lavoro.

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

    • È 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 Analizza XML con schema .

    • Se si usa una risorsa e un flusso di lavoro dell'app per la logica Standard, è possibile collegare l'account di integrazione alla risorsa dell'app per la logica, caricare gli schemi XSD direttamente nella risorsa dell'app per la logica o entrambi, in base agli scenari seguenti:

      • Se si ha già un account di integrazione con gli artefatti necessari o da usare, è possibile collegare l'account di integrazione a più risorse dell'app per la logica Standard in cui si vogliono usare gli artefatti. In questo modo, non è necessario caricare schemi XSD in ogni singola app per la logica. Per altre informazioni, vedere Collegare la risorsa dell'app per la logica all'account di integrazione.

      • Se non si ha un account di integrazione o si prevede di usare gli artefatti in più flussi di lavoro all'interno della stessa risorsa dell'app per la logica, è possibile aggiungere direttamente schemi alla risorsa dell'app per la logica usando il portale di Azure o Visual Studio Code.

      Pertanto, se non si ha o non è necessario un account di integrazione, è possibile usare l'opzione di caricamento. In caso contrario, è possibile usare l'opzione di collegamento. In entrambi i casi, è possibile usare questi artefatti in tutti i flussi di lavoro figlio all'interno della stessa risorsa dell'app per la logica.

    È comunque necessario un account di integrazione per archiviare altri artefatti, ad esempio partner, accordi e certificati, insieme all'uso delle operazioni AS2, X12 ed EDIFACT.

  • Schema XSD da usare con l'azione Analizza XML con schema . Assicurarsi che questo schema includa un elemento radice, simile all'esempio seguente:

    <xs:element name="Root">
        <....>
    </xs:element>
    

Aggiungere un'azione Analizza XML con schema

  1. Nel portale di Azure, aprire l'app per la logica e il flusso di lavoro Standard nella finestra di progettazione.

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

    In questo esempio viene usato il trigger di Richiesta.

  3. Nel passaggio del flusso di lavoro in cui si vuole aggiungere l'azione Analizza XML con schema , seguire questa procedura generale per aggiungere l'azione denominata Analizza XML con schema.

  4. Nella casella Contenuto specificare il contenuto XML da analizzare usando i dati XML ricevuti nella richiesta HTTP.

    1. Per selezionare gli output delle operazioni precedenti nel flusso di lavoro, nell'azione Analizza XML con schema selezionare all'interno della casella Contenuto e selezionare l'opzione elenco di contenuto dinamico (icona a forma di fulmine).

    2. Nell'elenco di contenuto dinamico selezionare il token per il contenuto da analizzare.

      In questo esempio viene selezionato il token Corpo dal trigger.

      Screenshot che mostra il flusso di lavoro Standard con l'elenco di contenuto dinamico aperto.

  5. Nell'elenco Origine selezionare il percorso in cui è stato caricato lo schema XSD, la risorsa LogicApp o IntegrationAccount.

  6. Nell'elenco Nome selezionare lo schema XSD.

  7. Al termine, salvare il flusso di lavoro.

    È stata completata la configurazione dell'azione Analizza XML con schema . In un'app reale, è possibile archiviare i dati analizzati in un'app line-of-business (LOB), ad esempio Salesforce. Per inviare l'output analizzato a Salesforce, aggiungere un'azione Salesforce.

  8. Per testare l'azione di analisi, 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 Analizza XML con schema viene eseguita dopo l'attivazione del flusso di lavoro e quando il contenuto XML è disponibile per l'analisi.

Parametri avanzati

Nella tabella seguente vengono descritti i parametri avanzati disponibili in questa azione:

Parametro valore Descrizione
Elaborazione DTD - Ignora
- Parse.
- Proibire
Specificare come gestire la definizione del tipo di documento XML (DTD).
Normalizzare XML No o Indica se normalizzare il contenuto XML.
Ignora spazi vuoti? No o Se analizzare o ignorare spazi vuoti non significativi, ad esempio spazi, schede e righe vuote nei documenti XML.
Ignorare le istruzioni di elaborazione XML? No o Se seguire o ignorare le istruzioni di elaborazione XML.
Ignora attributi XML No o Indica se scrivere o ignorare gli attributi XML.
Usare nomi completi? No o Indica se usare nomi locali più semplici o nomi XML completi.
Nome completo del nodo radice <root-node-qualified-name> Il nome completo del nodo radice nel caso in cui lo schema contenga più definizioni di elementi senza riferimenti.