Korduvate andmete ekspordi rakenduse loomine

Artikkel
07/12/2024

Rakendub nendele Dynamics 365 rakendustele:
Human Resources

See artikkel kirjeldab, kuidas luua loogikarakendus Microsoft Azure , mis ekspordib Microsoftist Dynamics 365 Human Resources andmeid korduvas graafikus. Õpetus kasutab andmete eksportimiseks rakenduse Human Resources DMF-i paketi REST rakenduse programmeerimisliidest (API). Pärast andmete eksportimist salvestab loogikarakendus eksporditud andmed Microsoft OneDrive for Businessi kausta.

Äristsenaarium

Ühes tüüpilises Microsoft Dynamics 365 integreerimise äristsenaariumis tuleb andmeid eksportida allsüsteemi korduva graafiku alusel. See õpetus näitab, kuidas eksportida kõik töötajate kirjed rakendusest Microsoft Dynamics 365 Human Resources ja salvestada töötajate loend OneDrive for Businessi kausta.

Näpunäide

Selles õpetus eksporditavad konkreetsed andmed ja eksporditud andmete sihtkoht on ainult näited. Saate neid oma ettevõtte vajadustele vastavalt hõlpalt muuta.

Kasutatud tehnoloogiad

See õpetus kasutab järgmisi tehnoloogiaid.

Dynamics 365 Human Resources : koondandmeallikas töötajate jaoks, mis eksporditakse.
... Azure Logic Apps– tehnoloogia, mis pakub korduva ekspordi orkestratsiooni ja planeerimist.
- Ühendused – tehnoloogia, mida kasutatakse loogikarakenduse ühendamiseks nõutavate lõpp-punktidega.
  - Microsoft Entra HTTP ID-ühendusega
  - OneDrive Business Connectori jaoks
DMF-paketi REST API – tehnoloogia, mida kasutatakse ekspordi käivitamiseks ja selle edenemise jälgimiseks.
OneDrive ettevõttele – eksporditud töötajate sihtkoht;

Eeltingimused

Enne selle õpetuse harjutusega alustamist peavad teil olema järgmised üksused.

Inimressursside keskkond, millel on keskkonnas administraatori taseme load
Azure’i kordustellimus loogikarakenduse majutamiseks

Harjutus

Selle harjutuse lõpus on teil loogikarakendus, mis on ühendatud teie inimressursside keskkonna ja OneDrive for Businessi kontoga. Loogikarakendus ekspordib rakendusest Human Resources andmepaketi, ootab eksportimise lõpule jõudmist, laadib eksporditud andmepaketi alla ja salvestab andmepaketi määratud OneDrive for Businessi kausta.

Lõpetatud loogikarakendus sarnaneb järgmisele joonisele.

Loogikarakenduse ülevaade.

1. etapp: andmete eksportimise projekti loomine rakenduses Human Resources

Looge rakenduses Human Resources andmete eksportimise projekt, mis ekspordib töötajaid. Määrake projekti eksporditöötajatele nimi ja veenduge, et andmepaketi loomise suvandi väärtuseks oleks määratud Jah. Lisage projekti üksiküksus (Töötaja) ja valige vorming, mida eksportida. (Selles õpetuses on kasutatud Microsoft Exceli vormingut.)

Töötajate eksportimise andmeprojekt.

Oluline

Jätke andmete eksportimise projekti nimi meelde. Seda on vaja, kui loote järgmises etapis loogikarakenduse.

2. etapp: loogikarakenduse loomine

Suur osa harjutusest hõlmab loogikarakenduse loomist.

Looge Azure’i portaalis loogikarakendus.
Alustage Logic Apps Designeris tühja loogikarakendusega.
Lisage kordumisgraafiku käivitaja , et käivitada loogikarakendus iga 24 tunni järel (või vastavalt oma valikule).
Kutsuge ExportToPackage DMF REST API andmepaketi eksportimise plaanimiseks.
1. Kasutage http ja konnektori HTTP-päringu tegevuse kutsumist Microsoft Entra .
  - Baasressursi URL: teie inimressursside keskkonna URL (ärge kaasake tee/nimeruumi teavet.)
  - Microsoft Entra Ressursi URI:http://hr.talent.dynamics.com
  Paberraha
  
  Inimressursid teenus ei anna veel ühenduse, mis võimaldab kasutada kõiki DMF-paketi ÜLEJÄÄNUD API-sid (nt ExportToPackage) kõiki API-sid. Selle asemel peate API-d helistama, kasutades toor-HTTPS-taotlusi HTTP kaudu konnektoriga Microsoft Entra . Konnektor kasutab Microsoft Entra ID-d autentimiseks ja inimressursside autoriseerimiseks.
2. Logige HTTP ja konnektori kaudu sisse inimressursside keskkonda Microsoft Entra .
3. Seadistage HTTP POST-taotlus ExportToPackage DMF REST API kutsumiseks.
  - Meetod: POST
  - Taotluse URL:hostinimi https://<>/nimeruumid/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - Taotluse keha:
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
Näpunäide

Võite soovida iga kasutaja samm, et oleks otstarbekam kui vaikenimi,kutsuge HTTP-taotlus. Näiteks saate seda nime samm ExportToPackage.
Lähtestage muutuja, et talletada ExportToPackage’i nõude täitmisolek .
Oodake, kuni lepingu täitmisolek andmeeksport õnnestunud.
1. Lisage silmus , mis kordub, kuni muutuja ExecutionStatus väärtus on edukas.
2. Lisage viivitustegevus , mis ootab viis sekundit, enne kui ekspordi praegust täitmisolekut pollitakse.
  
  Paberraha
  
  Seadke ekspordi lõpuleviiduseks piirangu arvuks 15 , et oodata maksimaalselt 75 sekundit (15 × iteratsiooni × 5 sekundit). Kui teie eksportimisele kulub rohkem aega, reguleerige limiidi arvu vastavalt vajadusele.
3. Lisage Invoke HTTP-nõude tegevus GetExecutionSummaryStatus DMF REST API kutsumiseks ja seadke muutuja ExecutionStatus väärtuseks GetExecutionSummaryStatus vastus.
  
  See näide ei tee veakontrolli. GetExecutionSummaryStatus API saab tagastada mitteeduaalseid terminali eisisõnue (teiste kui Õnnestus). Lisateavet vt API dokumentatsioonist.
  - Meetod: POST
  - Taotluse URL:hostinimi https://<>/nimeruumid/<namespace_guid>/andmed/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus
  - Taotluse keha (’ Invoke_an_HTTP_request’)?[’ väärtus]]
    
    Paberraha
    
    Võimalik, et peate sisestama taotluse väärtuse keha kas koodivaates või kujundaja funktsiooniredaktoris.
  Oluline
  
  Muutuja komplekti tegevuse väärtus (keha(’Invoke_an_HTTP_request_2’)?[’ väärtus]) erineb HTTP-taotluse 2 kehaväärtuse kutsumise väärtusest, kuigi kujundaja näitab väärtusi samal viisil.
Hankige eksporditud paketi allalaadimise URL.
- Lisage Invoke HTTP-taotluse tegevus GetExportedPackageUrl DMF REST API kutsumiseks.
  - Meetod: POST
  - Taotluse URL:hostinimi https://<>/nimeruumid/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageUrl
  - Taotluse keha: {"executionId": body(’GetExportedPackageURL’)?[’ väärtus]]}
Laadige eksporditud pakett alla.
- Lisage HTTP GET-taotlus (integreeritud HTTP konnektori tegevus ), et laadida pakett alla URL-ist, mis tagastati eelmises samm.
  - Meetod: HANGI
  - URI: keha (Invoke_an_HTTP_request_3).väärtus
    
    Paberraha
    
    Võimalik, et peate URI väärtuse sisestama kas koodivaates või kujundaja funktsiooniredaktoris.
  Paberraha
  
  See taotlus ei nõua täiendavat autentimist, kuna URL , mille getExportedPackageUrl API tagastab , sisaldab ühiskasutusega juurdepääsu allkirjade tõend, mis annab juurdepääsu faili allalaadimisele.
Allalaaditud paketi salvestamine OneDrive Business Connectori jaoks.
- Lisab äri OneDrive loomise faili tegevuse .
- Ühendage vastavalt vajadusele oma OneDrive for Businessi konto.
  - Kaustatee: teie valitud kaust
  - Faili nimi: worker_package.zip
  - Faili sisu: eelmise versiooni keha samm (dünaamiline sisu)

3. etapp: loogikarakenduse testimine

Oma loogikarakenduse testimiseks valige kujundajas nupp Käivita. Näete, et loogikarakenduse etapid algavad. Pärast 30 kuni 40 sekundit peaks loogikarakendus lõpetama töötamise ja teie OneDrive for Businessi kaust peaks sisaldama uut pakettfali, mis sisaldab eksporditud töötajaid.

Kui tõrkest teatatakse mis tahes samm, valige kujundajas nurjunud samm ning uurige selle puhul sisendite ja väljundite välju. Siluge ja reguleerige etappi tõrgete kõrvaldamiseks vastavalt vajadusele.

Järgmisel joonisel on näha, kuidas Logic Apps Designer välja näeb, kui kõik loogikarakenduse etapid töötavad edukalt.

Edukas loogikarakenduse käitamine.

Kokkuvõte

Selles õpetuses saite teada, kuidas kasutada loogikarakendusi, et eksportida andmeid rakendusest Human Resources, ja salvestada eksporditud andmed OneDrive for Businessi kausta. Saate selle õpetuse etappe vastavalt vajadusele muuta, et need vastaksid teie ettevõtte vajadustele.

Jagamisviis: