Esportare flussi di lavoro ISE in un'app per la logica Standard

Articolo
07/16/2024

I flussi di lavoro delle app per la logica standard, eseguiti in App per la logica di Azure a tenant singolo, offrono molte funzionalità nuove e migliorate. Ad esempio, l'isolamento dell’ambiente di calcolo, l'integrazione della rete virtuale e gli endpoint privati insieme all'hosting dell'ambiente di Servizi app, allo sviluppo locale e al debug con Visual Studio Code, alla bassa latenza con i flussi di lavoro senza stato e altro ancora.

Se si vogliono ottenere i vantaggi dei flussi di lavoro Standard, anche se i propri flussi di lavoro vengono eseguiti in un ambiente del servizio di integrazione (ISE), è ora possibile sostituirlo con App per la logica di Azure a tenant singolo. Questo passaggio è indicato per la maggior parte degli scenari che richiedono alcune funzionalità ISE, ad esempio l'isolamento e l'integrazione di rete, e può contribuire a ridurre i costi di gestione.

È ora possibile esportare i flussi di lavoro delle app per la logica da un ISE a un'app per la logica Standard. Tramite Visual Studio Code e l'estensione più recente di App per la logica di Azure (Standard), si esportano le app per la logica come flussi di lavoro con stato in un progetto di app per la logica Standard. È quindi possibile aggiornare, testare ed eseguire il debug dei flussi di lavoro in locale per prepararli alla ridistribuzione. Quando si è pronti si può eseguire la distribuzione direttamente da Visual Studio Code o tramite il proprio processo di DevOps.

Nota

La funzionalità di esportazione non esegue la migrazione dei flussi di lavoro. Questo strumento replica invece gli artefatti, ad esempio definizioni del flusso di lavoro, connessioni, artefatti dell'account di integrazione e altri ancora. Le risorse dell'app per la logica di origine, i flussi di lavoro, la cronologia dei trigger, la cronologia di esecuzione e altri dati rimangono intatti.

È possibile controllare il processo di esportazione e il percorso di migrazione. È possibile testare e convalidare i flussi di lavoro esportati nell'ambiente di destinazione in modo soddisfacente. Si può scegliere quando disabilitare o eliminare le app per la logica di origine.

Questo articolo contiene informazioni sul processo di esportazione e illustra come esportare i flussi di lavoro delle app per la logica da un ISE a un progetto di app per la logica standard locale in Visual Studio Code.

Problemi noti e limitazioni

Lo strumento di esportazione non esporta informazioni sull'infrastruttura, ad esempio le impostazioni dell'account di integrazione.
Lo strumento di esportazione può esportare i flussi di lavoro delle app per la logica con trigger che dispongono di impostazioni della concorrenza. Tuttavia, App per la logica di Azure a tenant singolo ignora queste impostazioni.
Le app per la logica devono appartenere alla stessa area se le si vuole esportare nello stesso progetto di app per la logica Standard.
Per impostazione predefinita, le credenziali di connessione non vengono clonate dai flussi di lavoro dell'app per la logica di origine. Prima che i flussi di lavoro dell'app per la logica possano essere eseguiti, è necessario ripetere l’autenticazione di queste connessioni dopo l'esportazione.
Per impostazione predefinita, se un connettore di Azure dispone di una versione del connettore incorporata, lo strumento di esportazione converte automaticamente il connettore di Azure in quello incorporato. Non esiste alcuna opzione per rifiutare esplicitamente questo comportamento.
Se l'ID di connessione non è formattato correttamente, viene generato un errore. Prima di esportare il flusso di lavoro, assicurarsi che gli ID di connessione per i connettori corrispondano al formato seguente:

subscriptionId/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationServiceEnvironments/{integration-service-environment-name}/managedApis/{managed-api-name}

Tipi di operazioni esportabili

Operazione	Tipo JSON
Trigger	Integrata: `Http`, `HttpWebhook`, `Recurrence`, `manual`(richiesta) Gestita: `ApiConnection` `ApiConnectionNotification`, `ApiConnectionWebhook`
Azione	Integrata: `AppendToArrayVariable`, `AppendToStringVariable`, `Compose`, `DecrementVariable`, `Foreach`, `Http`, `HttpWebhook`, `If`, `IncrementVariable`, `InitializeVariable`, `JavaScriptCode`, `Join`, `ParseJson`, `Response`, `Scope`, `Select`, `SetVariable`, `Switch`, `Table`, `Terminate`, `Until`, `Wait` - Gestita: `ApiConnection`, `ApiConnectionWebhook`

Prerequisiti

Una o più app per la logica da distribuire nella stessa sottoscrizione e nella stessa area di Azure, ad esempio Stati Uniti orientali 2.
Accesso a livello di sottoscrizione del lettore di Azure alla sottoscrizione in cui sono attualmente distribuite le app per la logica.
Accesso a livello di gruppo di risorse del collaboratore di Azure, se è selezionata l'opzione Distribuisci connettori gestiti.
Rivedere e verificare che siano soddisfatti i requisiti per la configurazione di Visual Studio Code con l'estensione App per la logica di Azure (Standard).

Nota

Assicurarsi di installare la versione 2.0.16 o successiva per l'estensione App per la logica di Azure (Standard) per Visual Studio Code. Alcuni scenari di conversione richiedono lo strumento Progettazione flussi di lavoro più recente, disponibile a partire da questa versione.

Raggruppare le app per la logica per l'esportazione

Con l'estensione App per la logica di Azure (Standard) è possibile combinare più flussi di lavoro di app per la logica ospitati da ISE in un singolo progetto di app per la logica Standard. In App per la logica di Azure a tenant singolo, una risorsa dell'app per la logica Standard può disporre di più flussi di lavoro. Tramite questo approccio, è possibile pre-convalidare i flussi di lavoro in modo da non perdere alcuna dipendenza quando si selezionano le app per la logica da esportare.

Quando si selezionano app per la logica da esportare, prendere in considerazione le raccomandazioni seguenti:

Raggruppare le app per la logica in cui i flussi di lavoro condividono le stesse risorse, ad esempio artefatti dell'account di integrazione, mappe e schemi, oppure usare le risorse tramite una catena di processi.
Per l'organizzazione e il numero di flussi di lavoro per le app per la logica, rivedere Procedure consigliate e raccomandazioni.

Esportare flussi di lavoro ISE in un progetto locale

Selezionare le app per la logica da esportare

In Visual Studio Code accedere ad Azure, se non è già stato fatto.
Nella barra delle attività di Visual Studio Code, selezionare Azure per aprire la finestra Azure (MAIUSC + ALT + A).
Nella barra degli strumenti della sezione Area di lavoro, selezionare Esporta app per la logica nel menu App per la logica di Azure.
Dopo aver aperto la scheda Esporta, selezionare la sottoscrizione di Azure e l’istanza ISE, quindi selezionare Avanti.
Selezionare le app per la logica da esportare. Ogni app per la logica selezionata viene visualizzata a lato nell'elenco App per la logica selezionate. Al termine, seleziona Avanti.

Suggerimento

È anche possibile cercare le app per la logica e filtrarle in base al gruppo di risorse.

Lo strumento di esportazione inizia a verificare se le app per la logica selezionate sono idonee per l'esportazione.

Esaminare i risultati della convalida di esportazione

Al termine della convalida di esportazione, esaminare i risultati espandendo la voce corrispondente a ogni app per la logica.

Le app per la logica che presentano errori non sono idonee per l'esportazione. È necessario rimuovere queste app per la logica dall'elenco delle esportazioni fino a quando non vengono corrette all'origine. Per rimuovere un'app per la logica dall'elenco, selezionare Indietro.

Ad esempio, SourceLogicApp2 presenta un errore e non può essere esportata fino a quando non viene risolto:
Le app per la logica che superano la convalida con o senza avvisi sono idonee per l'esportazione. Per continuare, selezionare Esporta se tutte le app vengono convalidate correttamente, oppure selezionare Esporta con avvisi se le app presentano degli avvisi.

Ad esempio, SourceLogicApp3 presenta un avviso, ma è comunque possibile continuare a esportare:

Nella tabella seguente vengono fornite ulteriori informazioni su ogni icona e stato di convalida:

Icona Convalida	Stato convalida
	Convalida dell’elemento riuscita, quindi l'esportazione può continuare senza problemi da risolvere.
	Convalida dell'elemento non riuscita, quindi l'esportazione non può continuare. La voce di convalida dell'elemento per cui l'operazione non è riuscita viene visualizzata automaticamente in formato espanso e fornisce informazioni sull'errore di convalida.
	L'elemento ha superato la convalida con un avviso, ma l'esportazione può continuare con la risoluzione post-esportazione richiesta. La voce di convalida dell'elemento con un avviso viene visualizzata automaticamente in formato espanso e contiene informazioni sull'avviso e sulla correzione post-esportazione richiesta.

Dopo aver visualizzato la sezione Fine esportazione, per Percorso di esportazione, individuare e selezionare una cartella locale per il nuovo progetto di app per la logica Standard.
Se il flusso di lavoro dispone di connessioni gestite da distribuire, un’opzione consigliata solo per gli ambienti non di produzione, selezionare Distribuisci connessioni gestite, per visualizzare i gruppi di risorse esistenti nella sottoscrizione di Azure. Selezionare il gruppo di risorse in cui si vuole distribuire le connessioni gestite.
In Passaggi post-esportazione, rivedere tutti i passaggi necessari per la post-esportazione, ad esempio:
In base allo scenario, selezionare Esporta e termina o Esporta con avvisi e termina.

Lo strumento di esportazione scarica il progetto nella cartella selezionata, lo espande in Visual Studio Code e distribuisce tutte le connessioni gestite, se tale opzione è stata selezionata.
Al termine di questo processo, Visual Studio Code apre una nuova area di lavoro. Ora è possibile chiudere in modo sicuro la finestra di esportazione.
Nel progetto dell'app per la logica Standard, aprire e rivedere il file README.md con i passaggi post-esportazione necessari.

Passaggi post-esportazione

Procedura di correzione

Alcuni flussi di lavoro dell'app per la logica esportati richiedono l'esecuzione di passaggi di correzione post-esportazione nella piattaforma Standard.

Nel progetto dell'app per la logica Standard, aprire il file README.md e rivedere i passaggi di correzione per i flussi di lavoro esportati. Lo strumento di esportazione genera il file README.md, che contiene tutti i passaggi di post-esportazione necessari.
Prima di apportare qualsiasi modifica al flusso di lavoro dell'app per la logica di origine, assicurarsi di testare la nuova risorsa e i flussi di lavoro dell'app per la logica Standard.

Azioni e impostazioni dell'account di integrazione

Se si esportano azioni che dipendono da un account di integrazione, è necessario impostare manualmente l'app per la logica Standard con un collegamento di riferimento all'account di integrazione che contiene gli artefatti necessari. Per altre informazioni, rivedere Collegare l'account di integrazione a un'app per la logica Standard.

Se si dispone di un account di integrazione Standard creato dall'interno di un ISE, è possibile esportare tale account di integrazione in un account di integrazione Premium esistente.

Azioni e impostazioni del batch

Se si esportano azioni che prevedono l'uso di azioni Batch con più configurazioni archiviate in un account di integrazione, è necessario configurare manualmente tali azioni con i valori corretti dopo l'esportazione. Per ulteriori informazioni, rivedere Inviare, ricevere ed elaborare messaggi in batch in App per la logica di Azure.

Struttura della cartella del progetto

Al termine del processo di esportazione, il progetto dell'app per la logica Standard contiene cartelle e file nuovi, insieme alla maggior parte di quelli presenti in un progetto tipico di app per la logica Standard.

La tabella seguente descrive le cartelle e i file nuovi aggiunti dal processo di esportazione:

Cartella	File	Descrizione
.development\deployment	LogicAppStandardConnections.parameters.json	File dei parametri del modello di Azure Resource Manager per la distribuzione di connettori gestiti
	LogicAppStandardConnections.template.json	Definizione del modello di Azure Resource Manager per la distribuzione di connettori gestiti
	LogicAppStandardInfrastructure.parameters.json	File dei parametri del modello di Azure Resource Manager per la distribuzione delle risorse di app per la logica Standard
	LogicAppStandardInfrastructure.template.json	Definizione del modello di Azure Resource Manager per la distribuzione delle risorse di app per la logica Standard
.logs\export	exportReport.json	File RAW di riepilogo del report dell’esportazione, che include tutti i passaggi necessari per la correzione post-esportazione
	exportValidation.json	File RAW del report di convalida, che contiene i risultati della convalida per ogni app per la logica esportata.
	README.md	File markdown con il riepilogo dei risultati dell'esportazione, contenente le app per la logica create e tutti i passaggi successivi necessari.

Passaggi successivi

Eseguire, testare ed eseguire il debug in locale

Condividi tramite