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

Articolo
01/10/2024

Flussi di lavoro dell'app per la logica standard, che vengono eseguiti in App per la logica di Azure a tenant singolo, offrono molte funzionalità nuove e migliorate. Ad esempio, si ottiene l'isolamento 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 usando Visual Studio Code, latenza bassa con flussi di lavoro senza stato e altro ancora.

Se si desiderano i vantaggi dei flussi di lavoro Standard, ma i flussi di lavoro vengono eseguiti in App per la logica di Azure multi-tenant, è ora possibile spostare i flussi di lavoro a consumo in App per la logica di Azure a tenant singolo. Questo commutatore ha senso negli scenari che richiedono alcune funzionalità Standard, ad esempio l'isolamento e l'integrazione della rete, una latenza inferiore o una migliore stimabilità dei costi.

È ora possibile esportare app per la logica di consumo in un'app per la logica Standard. Usando Visual Studio Code e l'estensione Standard (App per la logica di Azure) più recente, 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 per prepararli alla ridistribuzione. Quando si è pronti, è possibile distribuire direttamente da Visual Studio Code o tramite il proprio processo DevOps.

Nota

La funzionalità di esportazione non esegue la migrazione dei flussi di lavoro. Questo strumento replica invece elementi, ad esempio definizioni del flusso di lavoro, connessioni, artefatti dell'account di integrazione e altri. 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.

Si controlla il processo di esportazione e il percorso di migrazione. È possibile testare e convalidare i flussi di lavoro esportati nella soddisfazione con l'ambiente di destinazione. Si sceglie quando disabilitare o eliminare le app per la logica di origine.

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

Limitazioni e problemi noti

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 dell'app per la logica con trigger con impostazioni di concorrenza. Tuttavia, App per la logica di Azure a tenant singolo ignora queste impostazioni.
Le app per la logica devono esistere nella stessa area se si desidera esportarle all'interno dello 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 riutenticare queste connessioni dopo l'esportazione.
Per impostazione predefinita, se un connettore di Azure ha una versione predefinita del connettore, lo strumento di esportazione converte automaticamente il connettore di Azure nel connettore predefinito. Nessuna opzione esiste per rifiutare esplicitamente questo comportamento.

Tipi di operazione esportabili

Operazione	Tipo JSON
Trigger	Predefinito: `Http`, `HttpWebhook`, `Recurrencemanual` , (richiesta) Gestito: `ApiConnectionApiConnectionNotification`, `ApiConnectionWebhook`
Azione	Predefinito: `AppendToArrayVariableForeachTerminateScopeDecrementVariableSelectTableResponseUntilSwitchSetVariableParseJsonJoinJavaScriptCodeInitializeVariableIfHttpIncrementVariableAppendToStringVariableComposeHttpWebhook`,`Wait` - Gestito: `ApiConnection`, `ApiConnectionWebhook`

Prerequisiti

Una o più app per la logica da distribuire nella stessa sottoscrizione e nell'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 collaboratore di Azure, se si seleziona l'opzione Distribuisci connettori gestiti.
Esaminare e soddisfare i requisiti per configurare 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 la finestra di progettazione del flusso 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 dell'app per la logica di consumo 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ò avere più flussi di lavoro. Con questo approccio è possibile convalidare i flussi di lavoro in modo da non perdere alcuna dipendenza quando si selezionano app per la logica per l'esportazione.

Prendere in considerazione i consigli seguenti quando si selezionano app per la logica per l'esportazione:

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 o usare le risorse tramite una catena di processi.
Per l'organizzazione e il numero di flussi di lavoro per app per la logica, vedere Procedure consigliate e raccomandazioni.

Esportare flussi di lavoro a consumo in un progetto locale

Selezionare app per la logica per l'esportazione

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 di Azure (MAIUSC + ALT + A).
Nella barra degli strumenti Dell'area di lavoroselezionare Esporta appper la logica dal menu App per la logica di Azure.
Dopo aver aperto la scheda Esporta , selezionare la sottoscrizione e l'area di Azure e quindi selezionare Avanti.
Selezionare le app per la logica da esportare. Ogni app per la logica selezionata viene visualizzata nell'elenco App per la logica selezionate sul lato. Al termine, selezionare Avanti.

Suggerimento

È anche possibile cercare app per la logica e filtrare nel 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 dell'esportazione

Al termine della convalida dell'esportazione, esaminare i risultati espandendo la voce per ogni app per la logica.

Le app per la logica con errori non sono idonee per l'esportazione. È necessario rimuovere queste app per la logica dall'elenco di esportazione finché non vengono risolte all'origine. Per rimuovere un'app per la logica dall'elenco, selezionare Indietro.

Ad esempio, SourceLogicApp2 ha un errore e non può essere esportato fino alla correzione:
Le app per la logica che passano la convalida con o senza avvisi sono ancora idonee per l'esportazione. Per continuare, selezionare Esporta se tutte le app convalidano correttamente o selezionare Esporta con avvisi se le app hanno avvisi.

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

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

Icona di convalida	Stato convalida
	La convalida dell'elemento è stata passata, in modo che l'esportazione possa continuare senza problemi per risolvere i problemi.
	Convalida non riuscita dell'elemento, quindi l'esportazione non può continuare. La voce di convalida per l'elemento non riuscito viene espansa automaticamente 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 necessaria. La voce di convalida per l'elemento con un avviso viene automaticamente espansa e fornisce informazioni sull'avviso e sulla correzione post-esportazione necessaria.

Dopo aver visualizzato la sezione Fine esportazione , per Percorso di esportazione selezionare una cartella locale per il nuovo progetto di app per la logica Standard.
Se il flusso di lavoro ha connessioni gestite da distribuire, che è consigliato solo per gli ambienti non di produzione, selezionare Distribuisci connessioni gestite, che mostra i gruppi di risorse esistenti nella sottoscrizione di Azure. Selezionare il gruppo di risorse in cui si desidera distribuire le connessioni gestite.
In Dopo i passaggi di esportazione esaminare i passaggi necessari dopo l'esportazione, ad esempio:
In base allo scenario, selezionare Esporta e termina o Esporta con avvisi e fine.

Lo strumento di esportazione scarica il progetto nel percorso della cartella selezionato, espande il progetto in Visual Studio Code e distribuisce le connessioni gestite, se è stata selezionata tale opzione.
Al termine di questo processo, Visual Studio Code apre una nuova area di lavoro. È ora possibile chiudere in modo sicuro la finestra di esportazione.
Dal progetto dell'app per la logica Standard aprire ed esaminare il file di README.md per i passaggi successivi all'esportazione necessari.

Passaggi successivi all'esportazione

Procedura di correzione

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

Dal progetto app per la logica Standard aprire il file README.md ed esaminare 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 modifiche 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 configurare manualmente l'app per la logica Standard con un collegamento di riferimento all'account di integrazione che contiene gli artefatti necessari. Per altre informazioni, vedere Collegare l'account di integrazione a un'app per la logica Standard.

Azioni e impostazioni batch

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

Struttura della cartella del progetto

Al termine del processo di esportazione, il progetto app per la logica Standard contiene nuove cartelle e file insieme alla maggior parte degli altri in un tipico progetto di app per la logica Standard.

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

Cartella	File	Descrizione
.development\deployment	LogicAppStandardConnections.parameters.json	File di 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 di parametri del modello di Azure Resource Manager per la distribuzione della risorsa dell'app per la logica Standard
	LogicAppStandardInfrastructure.template.json	Definizione del modello di Azure Resource Manager per la distribuzione della risorsa dell'app per la logica Standard
.logs\export	exportReport.json	Esportare il file non elaborato di riepilogo del report, che include tutti i passaggi necessari per la correzione post-esportazione
	exportValidation.json	File non elaborato del report di convalida, che include i risultati di convalida per ogni app per la logica esportata
	README.md	File Markdown con riepilogo dei risultati dell'esportazione, incluse le app per la logica create e tutti i passaggi successivi necessari

Passaggi successivi

Eseguire, testare ed eseguire il debug in locale

Condividi tramite