Migrazione verso App per la logica di Azure Fase 3 - Conversione: Generare flussi di lavoro

Si applica a: App per la logica di Azure (Standard)

Il processo di migrazione per i progetti di integrazione può bloccarsi quando gli artefatti di origine complessi sono difficili da trasformare in risorse distribuibili in App per la logica di Azure (Standard). Nella fase di Conversione, l'App per la logica di Azure Migration Agent in Visual Studio Code utilizza i risultati approvati della pianificazione per creare ed eseguire un piano di conversione ordinato. Questo processo crea artefatti che includono definizioni standard di workflow, configurazioni di connessione e file di supporto.

Questo articolo descrive come l'agente di migrazione di App per la logica di Azure crei attività di conversione che eseguono il mapping degli artefatti di integrazione di origine alle risorse di progetto per app logiche nel formato Standard e come l'agente esegua queste attività per produrre artefatti di progetto pronti per il deploy e l'esecuzione.

Azioni della fase di conversione

Nell'agente di migrazione App per la logica di Azure, dopo aver completato l'attività Plan Logic App Design, l'attività Crea attività di conversione diventa disponibile. Quando si seleziona l'attività Crea attività di conversione, l'agente GitHub Copilot crea le attività di conversione necessarie per generare gli artefatti del progetto dell'applicazione di logica di destinazione.

Dopo aver esaminato questi compiti e selezionato l'attività Esegui Compiti di Conversione, l'agente @migration-converter GitHub agente Copilot elabora i compiti richiesti in ordine di dipendenze. Il compito opzionale Cloud Deployment & Testing non è incluso in questa azione e richiede un'approvazione separata.

1: Generare gli artefatti del progetto di app logica

L'agente @migration-converter genera gli output descritti nelle sezioni seguenti.

Struttura di scaffolding del progetto

L'agente @migration-converter crea innanzitutto un workspace Visual Studio Code e un progetto di app Standard Logic sotto la out cartella. I compiti di conversione successivi aggiungono una o più definizioni di workflow, connessioni, artefatti e un progetto .NET Functions quando il piano approvato lo richiede:

out/
└── <workspace-name>/
    ├── <workspace-name>.code-workspace
    ├── <logic-app-name>/
    │   ├── host.json
    │   ├── local.settings.json
    │   ├── connections.json                 # Added when connectors are configured
    │   ├── <workflow-name>/
    │   │   └── workflow.json
    │   ├── Artifacts/                       # Added only when required
    │   └── lib/custom/                      # Added when local functions are built
    └── Functions/                           # Added only when local functions are required

L'esempio seguente illustra l'agente @migration-converter che crea la struttura e i file dello scaffolding del progetto:

Screenshot che mostra la fase di conversione che genera i file del flusso di lavoro di Logic Apps Standard.

File di definizione del flusso di lavoro

Per ogni flusso di lavoro nel piano approvato, l'agente @migration-converter genera un workflow.json file che contiene le seguenti operazioni di workflow:

Operation Descrizione
Trigger Ogni flusso di lavoro inizia sempre con un singolo trigger, ovvero il punto di ingresso del flusso di lavoro. L'agente esegue il mapping di questo trigger dalle porte di ricezione o dai listener nell'origine.
Action Ogni flusso di lavoro ha una o più azioni che eseguono attività. L'agente mappa queste azioni dalle forme di orchestrazione, dai processori di flusso o dalle attività nella sorgente.
Condizioni o cicli Azioni che eseguono la logica del flusso di controllo, ad esempio If, For each e Until. L'agente converte queste azioni da forme e cicli decisionali nell'origine.
Ambiti Azioni con run-after configurazioni che è possibile usare per configurare la gestione degli errori.

Configurazioni di connessione

L'agente @migration-converter genera un connections.json file che archivia le configurazioni necessarie per le operazioni del connettore nei flussi di lavoro.

La tabella seguente descrive i gruppi di connettori di alto livello:

Gruppo di connettori Descrizione ed esempi
Integrato Connettori con operazioni eseguite nello stesso processo del runtime di App per la logica di Azure (Standard). Ad esempio, questi connettori includono Request, File System, HTTP, Archiviazione BLOB di Azure, bus di servizio, SQL Server, AS2, EDIFACT, X12 e altri.

Per altre informazioni, vedere:

- Connettori predefiniti in App per la logica di Azure
Informazioni di riferimento per i connettori predefiniti - App per la logica di Azure (Standard)
Condiviso o "gestito" Connettori con operazioni eseguite in un ambiente multi-tenant di Azure. Ad esempio, questi connettori includono Salesforce, SAP, Office 365 Outlook, Power BI, SharePoint e altro ancora. App per la logica di Azure supporta 1.400+ connettori condivisi per Microsoft, Azure e altre piattaforme negli ambienti cloud, locali e ibridi.

Per altre informazioni, vedere Gestisci o condivisi connettori in App per la logica di Azure.
Personalizzato Connettori di altri editori o dell'organizzazione creati per API personalizzate o altri servizi. Per altre informazioni, vedere Creare connettori predefiniti personalizzati per i flussi di lavoro Standard.

Per altre informazioni, Cosa sono i connettori in App per la logica di Azure.

.NET funzioni locali

Se hai componenti della piattaforma di origine che non hanno un connettore equivalente diretto in App per la logica di Azure (Standard), l'agente @migration-converter può creare un progetto .NET Functions separato e compilare funzioni locali nella cartella lib/custom del progetto dell'app per la logica. Questo comportamento si verifica in genere negli scenari in cui sono disponibili le operazioni seguenti:

  • Logica di trasformazione dei dati personalizzata
  • Regole di analisi o convalida complesse
  • Chiamate a sistemi locali tramite protocolli personalizzati
  • Valutazione delle regole di business

2. Controllare la completezza e la qualità dell'output

L'agente @migration-converter utilizza l'abilità no-stubs-code-generation, che richiede che l'output generato non contenga implementazioni stub, codice segnaposto o commenti TODO. Questo requisito non sostituisce la revisione manuale o i test in tempo reale.

L'abilità applica i seguenti standard ai file generati:

Standard Descrizione
Nessun codice segnaposto o stub Tutto il codice generato è completo e funzionale.
JSON valido Tutti i file workflow.json e connections.json sono validi e conformi allo schema App per la logica di Azure.
Riferimenti corretti Le azioni del flusso di lavoro fanno riferimento alle connessioni e ai parametri corretti.
Gestione degli errori I flussi di lavoro includono gli ambiti di gestione degli errori appropriati.

Per preparare l'output generato per la fase di convalida in cui si eseguono localmente i flussi di lavoro per il test, assicurarsi di controllare manualmente le definizioni del flusso di lavoro, le connessioni ed eventuali .NET funzioni locali generate per errori.

Importante

Come procedura consigliata, esaminare sempre gli output generati dall'intelligenza artificiale prima di usarli. Tali output potrebbero includere informazioni non corrette.

Per altre informazioni, vedere Quickstart: Eseguire la migrazione di un progetto di integrazione usando App per la logica di Azure Migration Agent.

Passaggi successivi