Stofna forrit fyrir útflutning endurtekinna gagna

Grein
05/29/2024

Á við um þessi Dynamics 365-forrit:
Human Resources

Þessi grein lýsir því hvernig á að búa Microsoft Azure til rökfræðiforrit sem flytur út gögn frá Microsoft Dynamics 365 Human Resources samkvæmt endurtekinni áætlun. Kennslan nýtir sér DMF pakka REST forritunarviðmóts mannauðsmála (API) til að flytja gögnin út. Eftir að gögnin hafa verið flutt út vistar rökfræðiforritið útflutta gagnapakkann til Microsoft OneDrive fyrir viðskiptamöppu.

Sviðsmynd fyrirtækis

Í einni dæmigerðri atburðarás fyrir Microsoft Dynamics 365 samþættingar, gögn verða að vera flutt út í ofansækin kerfi eftir endurteknum tímaáætlun. Þessi kennsla sýnir hvernig á að flytja út allar starfsmannaskrár úr Microsoft Dynamics 365 Human Resources og vista lista yfir starfsmenn í OneDrive fyrir viðskiptamöppu.

Ábending

Sértæk gögn sem eru flutt út í þessari kennslu og ákvörðunarstað gagna eru aðeins dæmi. Þú getur auðveldlega breytt þeim til að mæta viðskiptaþörfum þínum.

Tækni notuð

Þessi kennsla notar eftirfarandi tækni:

Dynamics 365 Human Resources – Aðalgagnagjafi fyrir starfsmenn sem verða fluttir út.
Azure Logic Apps – Tæknin sem veitir hljómsveit og tímasetningu endurtekins útflutnings.
- Tengi – Tæknin sem er notuð til að tengja rökfræðiforritið við nauðsynlega endapunkta.
  - HTTP með Microsoft Entra auðkennistengi
  - OneDrive fyrir Business Connector
DMF pakki REST API – Tæknin sem er notuð til að koma af stað útflutningi og fylgjast með framvindu hans.
OneDrive fyrir fyrirtæki – Áfangastaður útfluttra starfsmanna.

Forkröfur

Áður en þú byrjar að æfa þig í þessari kennslu verðurðu að hafa eftirfarandi atriði:

Mannauðsumhverfi sem hefur leyfi stjórnanda á umhverfinu
Azure-áskrift til að hýsa rökfræðiforritið

Æfingin

Í lok þessarar æfingar muntu hafa rökfræðiforrit sem er tengt mannauðsumhverfi þínu og þínu OneDrive fyrir viðskiptareikning. Rökfræðiforritið mun flytja út gagnapakka frá mannauðsmálum, bíða eftir að útflutningi ljúki, hlaða niður útflutta gagnapakkanum og vista gagnapakkann í OneDrive fyrir viðskiptamöppu sem þú tilgreindi.

Lokið rökfræðiforrit mun líkjast eftirfarandi mynd.

Yfirlit yfir rökfræðiforrit.

Skref 1: Búðu til gagnaútflutningsverkefni í mannauðsmálum

Í Human Resources skaltu búa til gagnaútflutningsverkefni sem flytur starfsfólk út. Gefðu verkinu heiti Flytja út starfsmenn og vertu viss um að valkosturinn Mynda gagnapakka sé stilltur á Já. Bætið einni einingu (starfsmanni) við verkið og veljið sniðið til að flytja út í. (Microsoft Excel snið er notað í þessari kennslu.)

Gagnaverk vegna útflutnings starfsmanns.

Mikilvægt

Mundu heiti gagnaútflutningsverksins. Þú þarft það þegar þú býrð til rökfræðiforritið í næsta skrefi.

Skref 2: Búðu til rökfræðiforritið

Meginhluti æfingarinnar felur í sér að búa til rökfræðiforritið.

Búðu til rökfræðiforrit í Azure-gáttinni.
Byrjaðu með autt rökfræðiforrit hjá Logic Apps Designer.
Bættu við kveikju endurtekningaráætlunar til að keyra rökfræðiforritið á 24 klukkustunda fresti (eða samkvæmt áætlun að eigin vali).
Hringdu í ExportToPackage DMF REST API til að skipuleggja útflutning gagnapakkans þíns.
1. Notaðu aðgerðina Kalla fram HTTP beiðni úr HTTP með Microsoft Entra tengi.
  - Vefslóð grunnauðlindar: Vefslóð mannauðsumhverfis þíns (Ekki taka með upplýsingar um slóð/nafnrými.)
  - Microsoft Entra Slóð auðlindar:http://hr.talent.dynamics.com
  Nóta
  
  Mannauðsþjónustan býður ekki enn upp á tengi sem afhjúpar öll API sem mynda DMF-pakkann REST API, eins og ExportToPackage. Í staðinn verður þú að hringja í API með því að nota hráar HTTPS beiðnir í gegnum HTTP með Microsoft Entra tengi. Þetta tengi notar Microsoft Entra kenni fyrir sannvottun og heimild fyrir Mannauð.
2. Skráðu þig inn í mannauðsumhverfið þitt í gegnum HTTP með Microsoft Entra tengi.
3. Setja upp HTTP POST-beiðni til að kalla á ExportToPackage DMF REST API.
  - Aðferð: POST
  - Vefslóð beiðninnar:hýsilheiti https://</>nafnsvið /<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - Meginmál beiðninnar:
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
Ábending

Þú might vilja til gefa nýtt nafn hvor stíga svo þessi þess' fleiri þýðingarmikill en the vanræksla nafn,Ákalla óákveðinn greinir í ensku HTTP beiðni. Til dæmis er hægt að endurnefna þetta skref ExportToPackage.
Frumstilla breytu til að geyma keyrslustöðu beiðninnar ExportToPackage .
Bíðið þar til keyrslustaða gagnaútflutnings tókst .
1. Bætið við Til-lykkju sem endurtekst þar til gildi breytunnar ExecutionStatus tekst .
2. Bætið við aðgerðinni Töf sem bíður í fimm sekúndur áður en hún kýs gildandi framkvæmdarstöðu útflutningsins.
  
  Nóta
  
  Stilltu markatalninguna á 15 til að bíða að hámarki í 75 sekúndur (15 endurtekningar × 5 sekúndur) eftir að útflutningi ljúki. Ef útflutningur þinn tekur lengri tíma, aðlagaðu mörkin eftir því sem við á.
3. Bæta við aðgerðinni Kalla fram HTTP-beiðni til að kalla á GetExecutionSummaryStatus DMF REST API, og stilla breytuna ExecutionStatus á niðurstöðu svarsins GetExecutionSummaryStatus .
  
  Þetta sýnishorn gerir ekki villu við athugun. API fyrir GetExecutionSummaryStatus getur skilað óheppnuðum útstöðvarstöðum (þ.e. öðrum ríkjum en þeim sem tókust). Frekari upplýsingar er að finna í fylgigögnum með API.
  - Aðferð: POST
  - Vefslóð beiðninnar: https://<hýsilheiti>/nafnsvið /<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus
  - Meginmál beiðninnar: body ('Invoke_an_HTTP_request')?[' gildi']
    
    Nóta
    
    Það gæti þurft að færa inn meginmál beiðnigildisins annað hvort í kóðayfirliti eða í aðgerðaritilinn í hönnuðinum.
  Mikilvægt
  
  Gildið fyrir aðgerðina Stilla breytu (meginmál('Invoke_an_HTTP_request_2')?[' gildið ']) verður frábrugðið gildinu fyrir Kalla fram HTTP beiðni 2 meginmálsgildi, jafnvel þótt hönnuðurinn sýni gildin á sama hátt.
Sæktu niðurflutta slóð útflutts pakkans.
- Bæta við aðgerð HTTP-beiðni til að kalla fram GetExportedPackageUrl DMF REST API.
  - Aðferð: POST
  - Vefslóð beiðninnar: https://<hýsilheiti>/nafnsvið /<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageUrl
  - Meginmál beiðninnar: { "executionId": body ('GetExportedPackageURL')?[' gildi']}
Sæktu útflutta pakkann.
- Bættu við HTTP GET beiðni (innbyggðri HTTP tengiaðgerð) til að hlaða niður pakkanum frá slóðinni sem var skilað í fyrra skrefi.
  - Aðferð: GET
  - URI: líkami ('Invoke_an_HTTP_request_3').gildi
    
    Nóta
    
    Þú gætir þurft að slá inn URI gildið annað hvort í kóðaskjá eða í aðgerðaritlinum í hönnuðinum.
  Nóta
  
  Þessi beiðni krefst ekki frekari auðkenningar, vegna þess að vefslóðin sem GetExportedPackageUrl API skilar inniheldur samnýtt undirskriftartákn sem veitir aðgang til að hlaða niður skránni.
Vistaðu niðurhalaða pakkann með því að nota OneDrive for Business tengi.
- Bættu við OneDrive fyrir fyrirtæki Búa til skrá aðgerð.
- Tengstu þínu OneDrive fyrir viðskiptareikning, eins og krafist er.
  - Möppuslóð: Mappa að eigin vali
  - Skráarheiti: worker_package.zip
  - Innihald skráar: Meginmálið frá fyrra skrefi (breytilegt efni)

Skref 3: Prófaðu rökfræðiforritið

Til að prófa rökfræðiforritið þitt skaltu velja Run hnappinn í hönnuðinum. Þú munt sjá að skrefin í rökfræðiforritinu byrja að keyra. Eftir 30 til 40 sekúndur ætti rökfræðiforritið að klára að keyra og þitt OneDrive fyrir viðskiptamöppu ætti að innihalda nýja pakkaskrá sem inniheldur útfluttu starfsmennina.

Ef tilkynnt er um bilun í einhverju skrefi skaltu velja skrefið sem mistókst í hönnuðinum og skoða inntak og úttak reiti fyrir það. Kemba og aðlaga skrefið eins og þarf til að leiðrétta villurnar.

Eftirfarandi mynd sýnir hvernig Logic Apps Designer lítur út þegar öll skref í rökfræðiforritinu ganga vel.

Árangursrík keyrsla rökfræðiforrits.

Samantekt

Í þessari einkatími lærðir þú hvernig á að nota rökfræðiforrit til að flytja gögn úr mannauðsmálum og vista útflutt gögn í OneDrive fyrir viðskiptamöppu. Þú getur breytt skrefunum í þessari kennslu eins og þörf krefur til að henta þínum viðskiptaþörfum.

Deila með