Vytvoření aplikace pro export opakujících se dat

Článek
05/17/2024

Platí pro tyto aplikace Dynamics 365:
Human Resources

Tento článek popisuje, jak vytvořit logic app v Microsoft Azure, která exportuje data z Microsoft Dynamics 365 Human Resources podle opakujícího se plánu. Výukový kurz využívá pro export dat rozhraní API REST balíčku DMF aplikace Human Resources. Po exportu dat uloží logic app exportovaný balíček dat do složky Microsoft OneDrive pro firmy.

Scénáře obchodu

V jednom typickém obchodním scénáři pro integrace Microsoft Dynamics 365 je nutné data exportovat do podrřízeného systému v opakovaném plánu. Tento výukový program ukazuje, jak exportovat všechny záznamy pracovníka z Microsoft Dynamics 365 Human Resources a uložit seznam pracovníků do složky OneDrive pro firmy.

Tip

Konkrétní data, která jsou exportována v tomto kurzu a cíl exportovaných dat, jsou pouze příklady. Lze je snadno změnit tak, aby splňovaly vaše obchodní potřeby.

Použité technologie

Tento výukový kurz používá následující technologie:

Dynamics 365 Human Resources – Hlavní zdroj dat pro pracovníky, kteří budou exportováni.
Azure Logic Apps – technologie, která poskytuje orchestraci a plánování opakovaného exportu.
- Konektory – technologie, která se používá k propojení logic app s požadovanými koncovými body.
  - Konektor Konektor HTTP s Microsoft Entra ID
  - Konektor OneDrive pro firmy
Rozhraní REST API balíčku DMF – technologie, která slouží k aktivaci exportu a sledování jejího průběhu.
OneDrivepro firmy – cíl pro exportované pracovníky.

Předpoklady

Před zahájením cvičení v tomto kurzu je nutné mít k dispozici následující položky:

Prostředí Human Resources, které má oprávnění na úrovni správce v daném prostředí
Předplatné Azure pro hostování logic app

Cvičení

Na konci tohoto cvičení budete mít logic app, která je připojena k prostředí Human Resources a ke svému účtu OneDrive pro firmy. Logic app exportuje balíček dat z Human Resources, počká na dokončení exportu, stáhne exportovaný balíček dat a uloží jej do složky OneDrive pro firmy, kterou jste určili.

Dokončená logic app se bude podobat následující ilustraci.

Přehled logic app.

Krok 1: Vytvoření projektu exportu dat v Human Resources

V aplikaci Human Resources vytvořte projekt exportu dat, který exportuje pracovníky. Nazvěte projekt Export pracovníků a ujistěte se, že je možnost Generovat balíček dat nastaven na Ano. Přidejte do projektu jednu entitu (Pracovník) a vyberte formát, do kterého chcete exportovat. (V tomto výukovém kurzu se používá formát Microsoft Excel.)

Datový projekt exportu pracovníků.

Důležité

Zapamatujte si název projektu exportu dat. Budete ho potřebovat při vytváření logic app v dalším kroku.

Krok 2: Vytvoření logic app

Sada cvičení zahrnuje vytvoření logic app.

Na portálu Azure vytvořte logic app.
V aplikaci Logic Apps Designer začněte s prázdnou logic app.
Přidejte aktivační událost plánu opakování pro spuštění logic app každých 24 hodin (nebo podle zvoleného plánu).
Volejte ExportToPackage DMF REST API pro naplánování exportu vašeho datového balíčku.
1. Použijte akci Vyvolat požadavek HTTP z HTTP s konektorem Microsoft Entra.
  - Základní adresa URL zdroje : adresa URL vašeho prostředí Human Resources (Nezahrnujte informace o cestě a oboru názvů.)
  - URI zdroje Microsoft Entra:http://hr.talent.dynamics.com
  Poznámka
  
  Služba Human Resources ještě neposkytuje konektor, který vystavuje všechna rozhraní API, která tvoří rozhraní REST API balíčku DMF, jako například ExportToPackage. Místo toho je nutné volat rozhraní API pomocí nezpracovaných požadavků HTTPS prostřednictvím protokolu HTTP s konektorem Microsoft Entra. Tento konektor používá Microsoft Entra ID pro ověřování a autorizaci Human Resources.
2. Přihlaste se ke svému prostředí Human Resources prostřednictvím protokolu HTTP s konektorem Microsoft Entra.
3. Nastavte požadavek HTTP POST na volání ExportToPackage DMF REST API.
  - Metoda: POST
  - URL adresa požadavku: https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - Tělo požadavku:
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
Tip

Můžete chtít přejmenovat každý krok tak, aby byl výstižnější než výchozí název, Vyvolat požadavek HTTP. Tento krok můžete například přejmenovat na ExportToPackage.
Inicializujte proměnnou pro uložení stavu spuštění požadavku ExportToPackage.
Počkejte, než bude stav spuštění exportu dat Úspěšný.
1. Přidejte do smyčky, což se opakuje, než bude hodnota proměnné ExecutionStatusÚspěšné.
2. Přidejte akci zpoždění, která počká pět sekund předtím, než se dotazuje na stav aktuálního spuštění exportu.
  
  Poznámka
  
  Nastavte počet limitů na 15 a počkejte na dokončení exportu maximálně 75 sekund (15 iterací x 5 sekund). Pokud export trvá déle, upravte podle potřeby počet limitů.
3. Přidejte akci Vyvolat požadavek HTTP pro volání GetExecutionSummaryStatus DMF REST API a nastavte proměnnou ExecutionStatus na výsledek odpovědi GetExecutionSummaryStatus.
  
  Tato ukázka neprovádí kontrolu chyb. Rozhraní API GetExecutionSummaryStatus může vracet neúspěšné stavy terminálu (ostatní stavy, než úspěšné). Další informace naleznete v dokumentaci k rozhraní API.
  - Metoda: POST
  - URL adresa požadavku: https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus
  - Tělo požadavku: body('Invoke_an_HTTP_request')?['value']
    
    Poznámka
    
    Je možné, že budete muset zadat hodnotu Tělo požadavku v zobrazení kódu nebo v editoru funkcí v návrháři.
  Důležité
  
  Hodnota akce Nastavení proměnné (body('Invoke_an_HTTP_request2')?['value']) se bude lišit od hodnoty těla pro Vyvolat požadavek HTTP 2, a to i v případě, že návrhář zobrazí hodnoty stejným způsobem.
Získejte URL adresu stažení exportovaného balíčku.
- Přidejte akci Vyvolat požadavek HTTP pro volání GetExportedPackageUrl DMF REST API.
  - Metoda: POST
  - URL adresa požadavku: https://<hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageUrl
  - Tělo požadavku: {"executionId": body('GetExportedPackageURL')?['value']}
Stáhněte exportovaný balíček.
- Přidejte požadavek HTTP GET (vestavěnou akci konektoru HTTP) a stáhněte balíček z URL adresy, která se vrátila v předchozím kroku.
  - Metoda: GET
  - URI: body('Invoke_an_HTTP_request_3').value
    
    Poznámka
    
    Je možné, že budete muset zadat hodnotu URI v zobrazení kódu nebo v editoru funkcí v návrháři.
  Poznámka
  
  Tento požadavek nevyžaduje žádné další ověření, protože adresa URL, kterou vrací GetExportedPackageUrl API, zahrnuje token podpisů sdílených přístupů, který uděluje přístup ke stažení souboru.
Uložte stažený balíček pomocí konektoru OneDrive pro firmy.
- Přidejteakci vytvoření souboru OneDrive pro firmy.
- Podle potřeby se připojte ke svému účtu OneDrive pro firmy.
  - Cesta ke složce: složka podle vašeho výběru
  - Název souboru: worker_package.zip
  - Obsah souboru: tělo z předchozího kroku (dynamický obsah)

Krok 3: Testování logic app

Chcete-li testovat logic app, vyberte v návrháři tlačítko Spustit. Uvidíte, že kroky spuštění logic app budou spuštěny. Po 30 až 40 sekundách by mělo být spuštění logic app dokončeno a složka OneDrive pro firmy by měla obsahovat nový soubor balíčku, který obsahuje exportované pracovníky.

Pokud je u některého kroku hlášeno selhání, vyberte v návrháři neúspěšný krok a zkontrolujte pole Vstupy a Výstupy. Proveďte ladění a upravte krok podle potřeby, aby se chyby opravily.

Následující obrázek ukazuje, jak vypadá aplikace Logic Apps Designer, když jsou všechny kroky logic app úspěšně spuštěny.

Úspěšné spuštění logic app.

Souhrn

V tomto návodu jste se seznámili s použitím llogic app k exportu dat z Human Resources a k uložení exportovaných dat do složky OneDrive pro firmy. Kroky v tomto výukovém programu můžete upravit podle potřeb firmy.

Sdílet prostřednictvím