Aggiungere schemi da usare con i flussi di lavoro con App per la logica di Azure

  • Articolo

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

Le azioni del flusso di lavoro, ad esempio file flat e convalida XML, richiedono uno schema per eseguire le attività. Ad esempio, l'azione Di convalida XML richiede un XML Schema per verificare che i documenti usino codice XML valido e abbiano i dati previsti nel formato predefinito. Questo schema è un documento XML che usa il linguaggio XSD (XML Schema Definition) e ha l'estensione del nome di file xsd. Le azioni file flat usano uno schema per codificare e decodificare il contenuto XML.

Questo articolo illustra come aggiungere uno schema all'account di integrazione. Se si usa un flusso di lavoro di app per la logica Standard, è anche possibile aggiungere uno schema direttamente alla risorsa dell'app per la logica.

Prerequisiti

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

  • File di schema da aggiungere. Per creare schemi, è possibile usare gli strumenti seguenti:

    Nota

    Non installare l'estensione insieme all'estensione BizTalk Server. La presenza di entrambe le estensioni potrebbe produrre un comportamento imprevisto. Assicurarsi di avere installato solo una di queste estensioni.

    Nei monitor ad alta risoluzione è possibile che si verifichi un problema di visualizzazione con la finestra di progettazione mappe in Visual Studio. Per risolvere questo problema di visualizzazione, riavviare Visual Studio in modalità DPI-unware o aggiungere il valore del Registro di sistema DPIUNAWARE.

  • In base al fatto che si stia lavorando a un flusso di lavoro dell'app per la logica a consumo o Standard, è necessaria una risorsa dell'account di integrazione. In genere, questa risorsa è necessaria quando si vogliono definire e archiviare artefatti da usare nei flussi di lavoro di integrazione aziendale e B2B.

    Importante

    Per collaborare, sia l'account di integrazione che la risorsa dell'app per la logica devono esistere nella stessa sottoscrizione di Azure e nella stessa area di Azure.

    • Se si usa un flusso di lavoro dell'app per la logica a consumo, è necessario un account di integrazione collegato alla risorsa dell'app per la logica.

    • Se si usa 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 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 in ogni singola app per la logica. Per altre informazioni, vedere Collegare la risorsa dell'app per la logica all'account di integrazione.

      • Il connettore predefinito File flat consente di selezionare uno schema caricato in precedenza nella risorsa dell'app per la logica o in un account di integrazione collegato, ma non entrambi. È quindi possibile usare questo artefatto in tutti i flussi di lavoro figlio all'interno della stessa risorsa dell'app per la logica.

      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.

Limiti

  • I limiti si applicano al numero di artefatti, ad esempio schemi, per account di integrazione. Per altre informazioni, vedere Limiti e informazioni di configurazione per App per la logica di Azure.

  • In base al fatto che si stia lavorando a un flusso di lavoro dell'app per la logica a consumo o standard, potrebbero essere applicati limiti di dimensioni dei file di schema.

    • Se si utilizzano flussi di lavoro Standard, non si applicano limiti alle dimensioni dei file dello schema.

    • Se si lavora con i flussi di lavoro a consumo, si applicano i limiti seguenti:

  • In genere, quando si usa un account di integrazione con il flusso di lavoro, si aggiunge lo schema a tale account. Tuttavia, se si fa riferimento o si importa uno schema che non si trova nell'account di integrazione, è possibile che venga visualizzato l'errore seguente quando si usa l'elemento xsd:redefine:

    An error occurred while processing the XML schemas: ''SchemaLocation' must successfully resolve if <redefine> contains any child other than <annotation>.'.

    Per risolvere questo errore, è necessario usare l'elemento xsd:import o xsd:include anziché xsd:redefineo usare un URI.

Considerazioni per l'aggiunta di schemi

  • Se si usa un flusso di lavoro a consumo, è necessario aggiungere lo schema a un account di integrazione collegato.

  • Se si usa un flusso di lavoro Standard, sono disponibili le opzioni seguenti:

    • Aggiungere lo schema a un account di integrazione collegato. È possibile condividere lo schema e l'account di integrazione tra più risorse dell'app per la logica Standard e i relativi flussi di lavoro figlio.

    • Aggiungere lo schema direttamente alla risorsa dell'app per la logica. Tuttavia, è possibile condividere tale schema solo tra flussi di lavoro figlio nella stessa risorsa dell'app per la logica.

Aggiungere lo schema all'account di integrazione

  1. Nella portale di Azure accedere con le credenziali dell'account Azure.

  2. Nella casella di ricerca principale di Azure immettere gli account di integrazione e selezionare Account di integrazione.

  3. Selezionare l'account di integrazione in cui si vuole aggiungere lo schema.

  4. Nel menu dell'account di integrazione, in Impostazioni selezionare Schemi.

  5. Sulla barra degli strumenti del riquadro Schemi selezionare Aggiungi.

Aggiungere schemi all'app per la logica

Per i flussi di lavoro a consumo, in base alle dimensioni del file dello schema, seguire la procedura per caricare uno schema fino a 2 MB o più di 2 MB, fino a 8 MB.

Aggiungere schemi fino a 2 MB

  1. Nel riquadro Aggiungi schema immettere un nome per lo schema. Mantenere selezionato File piccolo. Accanto alla casella Schema selezionare l'icona della cartella. Trovare e selezionare lo schema che si sta caricando.

  2. Al termine, seleziona OK.

    Al termine del caricamento dello schema, lo schema viene visualizzato nell'elenco Schemi.

Aggiungere schemi con dimensioni maggiori di 2 MB

Per aggiungere schemi più grandi per i flussi di lavoro a consumo da usare, è possibile usare l'API REST App per la logica di Azure - Schemi o caricare lo schema in un contenitore BLOB di Azure nell'account di archiviazione di Azure. I passaggi per l'aggiunta di schemi variano in base al fatto che il contenitore BLOB abbia accesso in lettura pubblico. Prima di tutto, verificare se il contenitore BLOB ha accesso in lettura pubblico seguendo questa procedura: Impostare il livello di accesso pubblico per il contenitore BLOB

Controllare il livello di accesso del contenitore

  1. Aprire Azure Storage Explorer. Nella finestra di Explorer espandere la sottoscrizione di Azure, se necessario.

  2. Espandere Archiviazione Account> {account-archiviazione}>Contenitori BLOB. Selezionare il contenitore BLOB.

  3. Scegliere Set Public Access Level (Imposta livello di accesso pubblico) dal menu di scelta rapida del contenitore BLOB.

Caricare in contenitori con accesso pubblico

  1. Caricare lo schema nell'account di archiviazione. Nella finestra di destra selezionare Carica.

  2. Al termine del caricamento, selezionare lo schema caricato. Sulla barra degli strumenti selezionare Copia URL in modo da copiare l'URL dello schema.

  3. Tornare al portale di Azure in cui è aperto il riquadro Aggiungi schema. Immettere un nome per lo schema. Selezionare File di grandi dimensioni (maggiore di 2 MB).

    Verrà ora visualizzata la casella URI del contenuto, invece della casella Schema.

  4. Nella casella URI del contenuto incollare l'URL dello schema. Terminare l'aggiunta dello schema.

Al termine del caricamento dello schema, lo schema viene visualizzato nell'elenco Schemi. Nella pagina Panoramica dell'account di integrazione, in Artefatti, viene visualizzato lo schema caricato.

Caricare in contenitori senza accesso pubblico

  1. Caricare lo schema nell'account di archiviazione. Nella finestra di destra selezionare Carica.

  2. Al termine del caricamento, generare una firma di accesso condiviso per lo schema. Dal menu di scelta rapida scegliere Get Shared Access Signature (Ottieni firma di accesso condiviso).

  3. Nel riquadro Firma di accesso condiviso selezionare Generate container-level shared access signature URI (Genera l'URI di firma di accesso condiviso a livello di contenitore)>Crea. Dopo aver generato l'URL della firma di accesso condiviso, accanto alla casella URL selezionare Copia.

  4. Tornare al portale di Azure in cui è aperto il riquadro Aggiungi schema. Selezionare File di grandi dimensioni.

    Verrà ora visualizzata la casella URI del contenuto, invece della casella Schema.

  5. Nella casella URI del contenuto incollare l'URI di firma di accesso condiviso generato in precedenza. Terminare l'aggiunta dello schema.

Al termine del caricamento dello schema, lo schema viene visualizzato nell'elenco Schemi. Nella pagina Panoramica dell'account di integrazione, in Artefatti, viene visualizzato lo schema caricato.

Modificare uno schema

Per aggiornare uno schema esistente, è necessario caricare un nuovo file di schema contenente le modifiche desiderate. È tuttavia possibile scaricare prima lo schema esistente e poi modificarlo.

  1. Nel portale di Azure aprire l'account di integrazione, se non è già aperto.

  2. Nel menu dell'account di integrazione, in Impostazioni selezionare Schemi.

  3. Dopo aver aperto il riquadro Schemi , selezionare lo schema. Per scaricare e modificare prima lo schema, nella barra degli strumenti del riquadro Schemi selezionare Scarica e salvare lo schema.

  4. Quando si è pronti per caricare lo schema aggiornato, nel riquadro Schemi selezionare lo schema da aggiornare. Nella barra degli strumenti del riquadro Schemi selezionare Aggiorna.

  5. Trovare e selezionare lo schema aggiornato che si vuole caricare.

  6. Al termine, seleziona OK.

    Al termine del caricamento del file dello schema, lo schema aggiornato viene visualizzato nell'elenco Schemi.

Eliminare uno schema

  1. Nel portale di Azure aprire l'account di integrazione, se non è già aperto.

  2. Nel menu dell'account di integrazione, in Impostazioni selezionare Schemi.

  3. Dopo aver aperto il riquadro Schemi , selezionare lo schema e quindi selezionare Elimina.

  4. Per confermare che si vuole eliminare lo schema, selezionare Sì.

Passaggi successivi