Creare e gestire gli account di integrazione per i flussi di lavoro B2B in App per la logica di Azure con Enterprise Integration Pack
Si applica a: App per la logica di Azure (consumo + standard)
Prima di poter creare flussi di lavoro business-to-business (B2B) e di integrazione aziendale usando App per la logica di Azure, è necessario creare una risorsa dell'account di integrazione. Questo account è un contenitore scalabile basato sul cloud in Azure che semplifica l'archiviazione e la gestione degli artefatti B2B definiti e usati nei flussi di lavoro per scenari B2B, ad esempio:
È anche necessario un account di integrazione per scambiare elettronicamente messaggi B2B con altre organizzazioni. Quando altre organizzazioni usano protocolli e formati di messaggi diversi dall'organizzazione, è necessario convertire questi formati in modo che il sistema dell'organizzazione possa elaborare tali messaggi. Con App per la logica di Azure è possibile creare flussi di lavoro che supportano i protocolli standard di settore seguenti:
Questa guida illustra come completare le attività seguenti:
- Creare un account di integrazione.
- Configurare l'accesso alle risorse di archiviazione per un account di integrazione Premium.
- Collegare l'account di integrazione a una risorsa dell'app per la logica.
- Modificare il piano tariffario per l'account di integrazione.
- Scollegare l'account di integrazione da una risorsa dell'app per la logica.
- Spostare un account di integrazione in un altro gruppo di risorse o sottoscrizione di Azure.
- Eliminare un account di integrazione.
Se non si ha familiarità con la creazione di flussi di lavoro di integrazione aziendale B2B in App per la logica di Azure, 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 una sottoscrizione di Azure, iscriversi per creare un account Azure gratuito. Assicurarsi di usare la stessa sottoscrizione di Azure sia per l'account di integrazione che per la risorsa dell'app per la logica.
Indipendentemente dal fatto che si stia lavorando a un flusso di lavoro di app per la logica a consumo o standard, è necessario che la risorsa dell'app per la logica esista già prima di poter collegare l'account di integrazione.
Per le risorse dell'app per la logica a consumo, questo collegamento è necessario prima di poter usare gli artefatti dell'account di integrazione con il flusso di lavoro. Anche se è possibile creare gli artefatti senza questo collegamento, il collegamento è necessario quando si è pronti per l'uso di questi artefatti.
Per le risorse dell'app per la logica Standard, questo collegamento è facoltativo, in base al proprio scenario:
Se si ha un account di integrazione con gli artefatti necessari o si vuole usare, è possibile collegare l'account di integrazione a ogni risorsa dell'app per la logica Standard in cui si vogliono usare gli artefatti.
Alcuni connettori dell'account di integrazione ospitati in Azure, ad esempio AS2, EDIFACT e X12, consentono di creare una connessione all'account di integrazione. Se si usano solo questi connettori, non è necessario il collegamento.
I connettori predefiniti denominati Liquid e File flat consentono di selezionare mappe e schemi caricati in precedenza nella risorsa dell'app per la logica o in un account di integrazione collegato.
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, ovvero non è necessario caricare mappe e schemi in ogni risorsa dell'app per la logica. 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.
Conoscenza di base su come creare flussi di lavoro delle app per la logica. Per altre informazioni, consultare la documentazione seguente:
Creare un account di integrazione
Gli account di integrazione sono disponibili in diversi livelli che variano in base ai prezzi. In base al livello scelto, la creazione di un account di integrazione potrebbe comportare costi. Per altre informazioni, vedere App per la logica di Azure modelli di prezzi e fatturazione e App per la logica di Azure prezzi.
In base ai requisiti e agli scenari, determinare il livello di account di integrazione appropriato da creare. La tabella seguente descrive i livelli disponibili:
L'account di integrazione usa un'identità gestita assegnata dal sistema creata e abilitata automaticamente per autenticare l'accesso.
| Livello | Descrizione |
|---|---|
| Premium (anteprima) | Nota: questa funzionalità è in anteprima ed è soggetta alle Condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure. Per gli scenari con i criteri seguenti: - Archiviare e usare artefatti illimitati, ad esempio partner, contratti, schemi, mappe, certificati e così via. - Usare e usare una risorsa di archiviazione personalizzata, che contiene gli stati di runtime pertinenti per azioni B2B specifiche e standard EDI. Ad esempio, questi stati includono il numero MIC per le azioni AS2 e i numeri di controllo per le azioni X12, se configurati nei contratti. Per accedere a questa risorsa di archiviazione, l'account di integrazione usa l'identità gestita assegnata dal sistema, che viene creata e abilitata automaticamente per l'account di integrazione. È anche possibile applicare altri criteri e governance ai dati, ad esempio le chiavi gestite dal cliente ("Bring Your Own") per la crittografia dei dati. Per archiviare queste chiavi, è necessario un insieme di credenziali delle chiavi. - Configurare e usare un insieme di credenziali delle chiavi per archiviare certificati privati o chiavi gestite dal cliente. Per accedere a queste chiavi, l'account di integrazione Premium usa l'identità gestita assegnata dal sistema, non un'entità servizio condivisa App per la logica di Azure. I prezzi seguono i prezzi standard dell'account di integrazione. Nota: durante l'anteprima, la fattura di Azure usa lo stesso nome del contatore e l'ID di un account di integrazione Standard, ma cambia quando il livello Premium diventa disponibile a livello generale. Limitazioni e problemi noti: - Attualmente non supporta le reti virtuali. - Se si usa un insieme di credenziali delle chiavi per archiviare i certificati privati, l'identità gestita dell'account di integrazione potrebbe non funzionare. Per il momento, usare invece l'identità gestita dell'app per la logica collegata. - Attualmente non supporta l'interfaccia della riga di comando di Azure per App per la logica di Azure. |
| Standard | Per gli scenari in cui sono presenti relazioni B2B più complesse e un numero maggiore di entità che è necessario gestire. Supportato dal contratto di servizio App per la logica di Azure. |
| Basic | Per gli scenari in cui si vuole gestire solo i messaggi o fungere da partner commerciali di piccole dimensioni con una relazione tra partner commerciali con un'entità aziendale più grande. Supportato dal contratto di servizio App per la logica di Azure. |
| Gratuito | Per scenari esplorativi, non per scenari di produzione. Questo livello prevede limiti per la disponibilità, la velocità effettiva e l'utilizzo dell'area. Ad esempio, il livello Gratuito è disponibile solo per le aree pubbliche in Azure, ad esempio Stati Uniti occidentali o Asia sud-orientale, ma non per Microsoft Azure gestito da 21Vianet o Azure per enti pubblici. Nota: non supportato dal contratto di servizio App per la logica di Azure. |
Per questa attività, è possibile usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell.
Importante
Per collegare e usare correttamente l'account di integrazione con l'app per la logica, assicurarsi che entrambe le risorse esistano nella stessa sottoscrizione di Azure e nella stessa area di Azure.
Nella casella di ricerca portale di Azure immettere gli account di integrazione e selezionare Account di integrazione.
In Account di integrazione selezionare Crea.
Nel riquadro Crea un account di integrazione specificare le informazioni seguenti sull'account di integrazione:
Proprietà Richiesto Valore Descrizione Abbonamento Sì <Azure-subscription-name> Il nome della sottoscrizione di Azure Gruppo di risorse Sì <Azure-resource-group-name> Nome del gruppo di risorse di Azure da usare per organizzare le risorse correlate. Per questo esempio, creare un nuovo gruppo di risorse denominato FabrikamIntegration-RG. Nome dell'account di integrazione Sì <integration-account-name> Nome dell'account di integrazione, che può contenere solo lettere, numeri, trattini ( -), caratteri di sottolineatura (_), parentesi (()) e punti (.). Questo esempio usa Fabrikam-Integration.Piano tariffario Sì <livello tariffario> Piano tariffario per l'account di integrazione, che è possibile modificare in un secondo momento. Per questo esempio, selezionare Gratuito. Per altre informazioni, vedere la documentazione seguente:
- Modello di prezzi di App per la logica
- Limiti e configurazione di App per la logica
- Prezzi di App per la logicaAccount di archiviazione Disponibile solo per l'account di integrazione Premium (anteprima) None Nome di un account di archiviazione di Azure esistente. Per l'esempio riportato in questa guida, questa opzione non si applica. Area Sì <Area di Azure> Area di Azure in cui archiviare i metadati dell'account di integrazione. Selezionare la stessa posizione della risorsa dell'app per la logica o creare le app per la logica nella stessa posizione dell'account di integrazione. Per questo esempio, usare Stati Uniti occidentali.
Per usare l'account di integrazione con un ambiente del servizio di integrazione (I edizione Standard), selezionare Associa all'ambiente del servizio di integrazione e quindi selezionare i edizione Standard come posizione. Per creare un account di integrazione dall'interno di un edizione Standard, vedere Creare account di integrazione dall'interno di un edizione Standard.
Nota: la risorsa I edizione Standard verrà ritirata il 31 agosto 2024, a causa della dipendenza da Azure Servizi cloud (versione classica), che si ritira contemporaneamente. Attualmente in anteprima, la funzionalità è disponibile per esportare un account di integrazione Standard per un I edizione Standard in un account di integrazione Premium.Abilitare l'analisi dei log No opzione non selezionata Per questo esempio, non selezionare questa opzione. Al termine, selezionare Rivedi e crea.
Al termine della distribuzione, Azure apre l'account di integrazione.
Se è stato creato un account di integrazione Premium, assicurarsi di configurare l'accesso all'account di archiviazione di Azure associato.
Configurare l'accesso alle risorse di archiviazione per l'account di integrazione Premium
Per leggere gli artefatti e scrivere informazioni sullo stato, l'account di integrazione Premium deve accedere all'account di archiviazione di Azure selezionato e associato. L'account di integrazione usa l'identità gestita assegnata dal sistema creata e abilitata automaticamente per autenticare l'accesso.
Nella portale di Azure aprire l'account di integrazione Premium.
Nel menu dell'account di integrazione, in Impostazioni selezionare Identità.
Nella scheda Assegnata dal sistema , che mostra l'identità gestita assegnata dal sistema abilitata, in Autorizzazioni selezionare Assegnazioni di ruolo di Azure.
Sulla barra degli strumenti Assegnazioni di ruolo di Azure selezionare Aggiungi assegnazione di ruolo (anteprima), specificare le informazioni seguenti, selezionare Salva e quindi ripetere per ogni ruolo richiesto:
Parametro valore Descrizione Scope Storage Per altre informazioni, vedere Informazioni sull'ambito per il controllo degli accessi in base al ruolo di Azure. Abbonamento <Sottoscrizione di Azure> Sottoscrizione di Azure a cui accedere la risorsa. Conto risorse <Azure-storage-account-name> Nome dell'account di archiviazione di Azure a cui accedere.
Nota Se viene visualizzato un errore che indica che non si dispone delle autorizzazioni per aggiungere assegnazioni di ruolo a questo ambito, è necessario ottenere tali autorizzazioni. Per altre informazioni, vedere Ruoli predefiniti di Microsoft Entra.Ruolo - Collaboratore account di archiviazione
- Collaboratore ai dati del BLOB di archiviazione
- Collaboratore dati tabella ArchiviazioneI ruoli richiesti dall'account di integrazione Premium per accedere all'account di archiviazione. Per altre informazioni, vedere Assegnare un ruolo di Azure all'identità gestita assegnata dal sistema
Collegare quindi l'account di integrazione alla risorsa dell'app per la logica.
Collegare all'app per la logica
Per collegare correttamente l'account di integrazione alla risorsa dell'app per la logica, assicurarsi che entrambe le risorse usino la stessa sottoscrizione di Azure e la stessa area di Azure.
Questa sezione descrive come completare questa attività usando il portale di Azure. Se si usa Visual Studio e l'app per la logica si trova in un progetto gruppo di risorse di Azure, è possibile collegare l'app per la logica a un account di integrazione usando Visual Studio.
Nella portale di Azure aprire la risorsa dell'app per la logica.
Nel menu di spostamento dell'app per la logica, in Impostazioni selezionare Impostazioni flusso di lavoro. In Account di integrazione aprire l'elenco Selezionare un account di integrazione e selezionare l'account di integrazione desiderato.
Per completare il collegamento, selezionare Salva.
Dopo aver collegato correttamente l'account di integrazione, Azure visualizza un messaggio di conferma.
Ora il flusso di lavoro dell'app per la logica può usare gli artefatti nell'account di integrazione più i connettori B2B, ad esempio la convalida XML e la codifica o la decodifica dei file flat.
Modificare il piano tariffario
Per aumentare i limiti per un account di integrazione, è possibile eseguire l'aggiornamento a un piano tariffario superiore, se disponibile. Ad esempio, è possibile eseguire l'aggiornamento dal livello Gratuito al livello Basic, al livello Standard o al livello Premium. È anche possibile effettuare il downgrade a un livello inferiore, se disponibile. Per altre informazioni sui prezzi, vedere la documentazione seguente:
Aggiornare il piano tariffario
Per apportare questa modifica, è possibile usare il portale di Azure o l'interfaccia della riga di comando di Azure.
Nella casella di ricerca portale di Azure immettere gli account di integrazione e selezionare Account di integrazione.
Azure mostra tutti gli account di integrazione nelle sottoscrizioni di Azure.
In Account di integrazione selezionare l'account di integrazione che si vuole spostare. Nel menu della risorsa dell'account di integrazione selezionare Panoramica.
Nella pagina Panoramica selezionare Aggiorna piano tariffario, che elenca tutti i livelli superiori disponibili. Quando si seleziona un livello, la modifica diventa effettiva immediatamente.
Downgrade del piano tariffario
Per apportare questa modifica, usare l'interfaccia della riga di comando di Azure.
Se non è già stato fatto, installare i prerequisiti dell'interfaccia della riga di comando di Azure.
Nella portale di Azure aprire l'ambiente Azure Cloud Shell.
Al prompt dei comandi immettere il comando az resource e impostare
skuNamesul livello inferiore desiderato.az resource update --resource-group <resourceGroupName> --resource-type Microsoft.Logic/integrationAccounts --name <integrationAccountName> --subscription <AzureSubscriptionID> --set sku.name=<skuName>Ad esempio, se si ha il livello Standard, è possibile impostare su
skuNameBasic:az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Basic
Scollegare da un'app per la logica
Se si vuole collegare l'app per la logica a un altro account di integrazione o non usare più un account di integrazione con l'app per la logica, eliminare il collegamento usando Azure Resource Explorer.
Aprire la finestra del browser e passare ad Azure Resource Explorer (https://resources.azure.com). Accedere con le stesse credenziali dell'account Azure.
Nella casella di ricerca immettere il nome dell'app per la logica per trovare e aprire l'app per la logica.
Nella barra del titolo dello strumento di esplorazione selezionare Lettura/Scrittura.
Nella scheda Dati selezionare Modifica.
Nell'editor trovare l'oggetto integrationAccount con il formato seguente ed eliminare l'oggetto :
{ // <other-attributes> "integrationAccount": { "name": "<integration-account-name>", "id": "<integration-account-resource-ID>", "type": "Microsoft.Logic/integrationAccounts" }, }Ad esempio:
Nella scheda Dati selezionare Inserisci per salvare le modifiche.
Nel portale di Azure aprire l'app per la logica. Nel menu dell'app per la logica, in Impostazioni flusso di lavoro, verificare che la proprietà Account di integrazione sia ora vuota.
Spostare l'account di integrazione
È possibile spostare l'account di integrazione in un altro gruppo di risorse di Azure o in un'altra sottoscrizione di Azure. Quando si spostano le risorse, Azure crea nuovi ID risorsa, quindi assicurarsi di usare i nuovi ID e aggiornare gli script o gli strumenti associati alle risorse spostate. Se si vuole modificare la sottoscrizione, è necessario specificare anche un gruppo di risorse esistente o nuovo.
Per questa attività, è possibile usare il portale di Azure seguendo i passaggi descritti in questa sezione o nell'interfaccia della riga di comando di Azure.
Nella casella di ricerca portale di Azure immettere gli account di integrazione e selezionare Account di integrazione.
Azure mostra tutti gli account di integrazione nelle sottoscrizioni di Azure.
In Account di integrazione selezionare l'account di integrazione che si vuole spostare. Nel menu dell'account di integrazione selezionare Panoramica.
Nella pagina Panoramica, accanto a Gruppo di risorse o Nome sottoscrizione, selezionare Cambia.
Selezionare anche le risorse correlate da spostare.
In base alla selezione, seguire questa procedura per modificare il gruppo di risorse o la sottoscrizione:
Gruppo di risorse: dall'elenco Gruppo di risorse selezionare il gruppo di risorse di destinazione. In alternativa, per creare un gruppo di risorse diverso, selezionare Crea un nuovo gruppo di risorse.
Sottoscrizione: nell'elenco Sottoscrizione selezionare la sottoscrizione di destinazione. Nell'elenco Gruppo di risorse selezionare il gruppo di risorse di destinazione. In alternativa, per creare un gruppo di risorse diverso, selezionare Crea un nuovo gruppo di risorse.
Per confermare che gli script o gli strumenti associati alle risorse spostate non funzioneranno fino a quando non vengono aggiornati con i nuovi ID risorsa, selezionare la casella di conferma e quindi selezionare OK.
Al termine, assicurarsi di aggiornare tutti gli script con i nuovi ID risorsa per le risorse spostate.
Eliminare l'account di integrazione
Per questa attività, è possibile usare il portale di Azure seguendo i passaggi descritti in questa sezione, nell'interfaccia della riga di comando di Azure o in Azure PowerShell.
Nella casella di ricerca portale di Azure immettere gli account di integrazione e selezionare Account di integrazione.
Azure mostra tutti gli account di integrazione nelle sottoscrizioni di Azure.
In Account di integrazione selezionare l'account di integrazione che si vuole eliminare. Nel menu dell'account di integrazione selezionare Panoramica.
Nella pagina Panoramica selezionare Elimina.
Per confermare che si vuole eliminare l'account di integrazione, selezionare Sì.
