Migracja do Azure Logic Apps Etap 3 - Konwersja: Generowanie workflowów

Dotyczy: Azure Logic Apps (Standard)

Proces migracji projektów integracyjnych może zostać wstrzymany, gdy złożone artefakty źródłowe są trudne do przekształcenia w zasoby możliwe do wdrożenia w Azure Logic Apps (Standard). Na etapie konwersji agent migracji Azure Logic Apps w Visual Studio Code wykorzystuje zatwierdzone wyniki planowania do stworzenia i uruchomienia uporządkowanego planu konwersji. Proces ten tworzy artefakty obejmujące standardowe definicje workflow, konfiguracje połączeń oraz pliki wspierające.

W tym artykule opisano, w jaki sposób Azure Logic Apps Migration Agent tworzy zadania konwersji, które mapują artefakty integracji źródłowej na zasoby projektu aplikacji logiki w warstwie Standard gotowe do wdrożenia oraz w jaki sposób agent uruchamia te zadania, aby stworzyć artefakty projektu gotowe do wdrożenia i uruchomienia.

Akcje etapu konwersji

W Azure Logic Apps Migration Agent po zakończeniu działania Plan Logic App Design działanie Tworzenie zadań konwersji staje się dostępne. Po wybraniu działania Utwórz zadania konwersji agent GitHub Copilot tworzy zadania konwersji, które są niezbędne do wygenerowania artefaktów projektu docelowej aplikacji logiki.

Po przejrzeniu tych zadań i wybraniu aktywności @migration-converterWykonaj Zadania Konwersyjne, agent GitHub agent funkcji Copilot przetwarza wymagane zadania w kolejności zależności. Opcjonalne zadanie Cloud Deployment & Testing nie jest uwzględnione w tej akcji i wymaga osobnej zgody.

1. Generowanie artefaktów projektu aplikacji logiki

Agent @migration-converter generuje dane wyjściowe opisane w poniższych sekcjach.

struktura szkieletowa projektu

Agent @migration-converter najpierw tworzy przestrzeń roboczą Visual Studio Code oraz projekt aplikacji Standard Logic pod tym folderemout. Późniejsze zadania konwersji dodają jedną lub więcej definicji przepływu pracy, połączeń, artefaktów oraz projekt .NET Functions, gdy zatwierdzony plan tego wymaga:

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

W poniższym przykładzie przedstawiono agenta @migration-converter tworzącego strukturę szkieletu projektu i pliki:

Zrzut ekranu przedstawiający etap konwersji generujący pliki przepływu pracy Logic Apps Standard.

Plik definicji przepływu pracy

Dla każdego przepływu pracy w zatwierdzonym planie agent @migration-converter generuje plik workflow.json, który zawiera następujące operacje przepływu pracy:

Operation Opis
Wyzwalacz Każdy przepływ pracy zawsze rozpoczyna się od jednego wyzwalacza, który jest punktem wejścia przepływu pracy. Agent mapuje ten wyzwalacz z portów odbioru lub odbiorników w źródle.
Action Każdy przepływ pracy ma co najmniej jedną akcję wykonującą zadania. Agent mapuje te działania z kształtów orkiestracji, procesorów przepływu lub działań w źródle.
Warunki lub pętle Akcje, które wykonują logikę przepływu sterowania, takie jak If, For each i Until. Agent tłumaczy te akcje z kształtów decyzji i pętli w kodzie źródłowym.
Scopes Akcje z run-after konfiguracjami, których można użyć do skonfigurowania obsługi błędów.

Konfiguracje połączeń

Agent @migration-converter generuje plik connections.json, który zawiera niezbędne konfiguracje dla operacji łączników w przepływach pracy.

W poniższej tabeli opisano grupy łączników wysokiego poziomu:

Grupa łączników Opis i przykłady
Wbudowane Łączniki, których operacje są uruchamiane w tym samym procesie co środowisko wykonawcze Azure Logic Apps (Standard). Na przykład te łączniki obejmują Request, File System, HTTP, Azure Blob Storage, Service Bus, SQL Server, AS2, EDIFACT, X12 i inne.

Aby uzyskać więcej informacji, zobacz:

- Wbudowane łączniki w usłudze Azure Logic Apps
- Azure Logic Apps (Standard) odniesienie do wbudowanych łączników
Współdzielone lub "zarządzane" Łączniki z operacjami, które działają w Azure z wieloma najemcami. Na przykład te łączniki obejmują Salesforce, SAP, Office 365 Outlook, Power BI, SharePoint i nie tylko. Azure Logic Apps obsługuje 1400+ udostępnione łączniki dla Microsoft, Azure i innych platform w chmurze, lokalnie i środowiskach hybrydowych.

Aby uzyskać więcej informacji, zobacz Zarządzane lub udostępnione łączniki w Azure Logic Apps.
Niestandardowe Rozwiązanie Łączniki tworzone przez innych wydawców lub Twoją organizację dla niestandardowych interfejsów API lub innych usług. Aby uzyskać więcej informacji, zobacz Tworzenie niestandardowych wbudowanych łączników dla standardowych przepływów pracy.

Aby uzyskać więcej informacji, Co to są łączniki w Azure Logic Apps.

.NET funkcje lokalne

Jeśli masz składniki platformy źródłowej, które nie mają bezpośredniego odpowiednika łącznika w usłudze Azure Logic Apps (Standard), agent @migration-converter może utworzyć osobny projekt .NET Functions i utworzyć funkcje lokalne w folderze lib/custom projektu aplikacji logiki. To zachowanie często występuje w scenariuszach, w których istnieją następujące elementy:

  • Niestandardowa logika przekształcania danych
  • Złożone reguły analizowania lub walidacji
  • Wywoływanie systemów lokalnych za pomocą protokołów niestandardowych
  • Ocena reguł biznesowych

2. Sprawdzanie kompletności i jakości danych wyjściowych

Agent @migration-converter korzysta z umiejętności no-stubs-code-generation, która wymaga, aby wygenerowane dane wyjściowe nie zawierały żadnych implementacji szkieletowych, kodu zastępczego ani komentarzy TODO. Ten wymóg nie zastępuje ręcznej kontroli ani testów w czasie rzeczywistym.

Umiejętność ta stosuje następujące standardy do wygenerowanych plików:

Standard Opis
Brak szablonów ani kodu zastępczego Cały wygenerowany kod jest kompletny i funkcjonalny.
Prawidłowy kod JSON Wszystkie pliki workflow.json i connections.json są prawidłowe i zgodne ze schematem Azure Logic Apps.
Poprawne odwołania Akcje przepływu pracy odwołują się do prawidłowych połączeń i parametrów.
Obsługa błędów Przepływy pracy obejmują odpowiednie zakresy obsługi błędów.

Aby przygotować wygenerowane dane wyjściowe na etapie walidacji, w którym lokalnie uruchamiasz przepływy pracy do testowania, upewnij się, że ręcznie sprawdzisz definicje, połączenia i wszystkie wygenerowane .NET lokalne funkcje pod kątem niedokładności.

Important

Najlepszym rozwiązaniem jest zawsze przejrzenie wszystkich wygenerowanych danych wyjściowych sztucznej inteligencji przed ich użyciem. Takie dane wyjściowe mogą zawierać nieprawidłowe informacje.

Aby uzyskać więcej informacji, zobacz Quickstart: Migrate an integration project using the Azure Logic Apps Migration Agent (Migrowanie projektu integracji przy użyciu agenta migracji Azure Logic Apps.

Następne kroki