Convalidare il codice XML nei flussi di lavoro con App per la logica di Azure
Si applica a: App per la logica di Azure (a consumo e 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 Convalida XML e uno schema predefinito.
Se non si ha familiarità con le app per la logica, consultare Informazioni su 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
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, 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 usato il trigger di Richiesta.
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 Convalida XML*.
Se si usa il tipo di risorsa App per la logica (A consumo),l'account di integrazione richiede gli elementi seguenti:
Schema da utilizzare per convalidare il contenuto XML.
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, accordi e certificati, insieme all'uso delle operazioni AS2, X12 ed EDIFACT. Tuttavia, non è necessario collegare la risorsa dell'app per la logica all'account di integrazione, quindi la funzionalità di collegamento non è disponibile. L'account di integrazione deve comunque soddisfare altri requisiti, ad esempio l'uso della stessa sottoscrizione di Azure e la presenza nella stessa posizione della risorsa dell'app per la logica.
Nota
Attualmente, solo il tipo di risorsa App per la logica (A consumo) supporta le operazioni di RosettaNet. Il tipo di risorsa App per la logica (Standard) non include le operazioni RosettaNet.
Aggiungi operazione di convalida XML
Nel portale di Azure aprire l'app per la logica e il flusso di lavoro nella vista della finestra di progettazione.
Se si dispone di un'app per la logica vuota che non dispone di un trigger, aggiungere qualsiasi trigger desiderato. In questo esempio viene usato il trigger di Richiesta. In caso contrario, continuare con il passaggio successivo.
Per aggiungere il trigger Richiedi, nella casella di ricerca della finestra di progettazione immettere
HTTP requeste selezionare il trigger Richiedi denominato Quando si riceve una richiesta HTTP.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 A consumo, scegliere uno dei passaggi seguenti:
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 selezionareAggiungi un'azione.
Per aggiungere l'azione Convalida XML tra i passaggi esistenti, selezionare il segno più (+ ) visualizzato tra questi passaggi e quindi selezionareAggiungi un'azione .
In Scegliere un'operazione selezionare Predefinita. Nella casella di ricerca immettere
xml validation. Nell'elenco delle azioni selezionare Convalida XML.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 A consumo, 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:
Nell'elenco di contenuto dinamico selezionare il token di proprietà per il contenuto da convalidare.
In questo esempio viene selezionato il token Corpo dal trigger.
Per specificare lo schema da usare per la convalida, aprire l'elenco Nome schema e selezionare lo schema aggiunto in precedenza.
Al termine, assicurarsi di salvare il flusso di lavoro dell'app per la logica.
La configurazione dell'azione 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 della convalida a Salesforce, aggiungere un'azione Salesforce.
Per testare l'azione di convalida, attivare ed eseguire il flusso di lavoro. Ad esempio, per il trigger Richiedi, 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.