Toistuvan tietojen viennin sovelluksen luominen

Artikkeli
12/11/2024

Koskee seuraavia Dynamics 365 -sovelluksia:
Human Resources

Tässä artikkelissa kuvataan, miten luodaan Microsoft Azure logiikkasovellus, joka vie tiedot toistuvan Microsoft Dynamics 365 Human Resources aikataulun perusteella. Opas hyödyntää Human Resourcesin DMF-paketin REST-sovellusohjelmointirajapintaa (API) tietojen viemiseen. Kun tiedot on viety, logiikkasovellus tallentaa viedyn tietopaketin Microsoft OneDrive for Business -kansioon.

Liiketoimintaskenaario

Yhdessä Microsoft Dynamics365 -integrointien tyypillisessä liiketoimintaskenaariossa tiedot on vietävä ketjussa jäljempänä olevaan järjestelmään toistuvalla aikataululla. Tässä opastusohjelmassa kerrotaan, miten kaikki työntekijätietueet Microsoft Dynamics 365 Human Resources viedään ja kuinka työntekijöiden luettelo tallennetaan Yritys-kansioon OneDrive .

Vihje

Tässä oppaassa vietävät tiedot ja vietyjen tietojen kohde ovat vain esimerkkejä. Voit helposti muuttaa ne yrityksesi tarpeiden mukaisiksi.

Käytetyt teknologiat

Tässä oppaassa käytetään seuraavia teknologioita:

Dynamics 365 Human Resources – Vietävien työntekijöiden perustietolähde.
Azure Logic Apps – Tekniikka, joka mahdollistaa toistuvan viennin töiden ajoittamisen ja ajoituksen.
- Liittimet – Tekniikka, jota käytetään logiikkasovelluksen ja tarvittavien päätepisteiden liittämiseen.
  - HTTP ja tunnusliitin Microsoft Entra
  - OneDrive Business Connectoria varten
DMF package REST API – tekniikka, jota käytetään viennin käynnistämiseen ja sen edistymisen seuraamiseen.
OneDrive yrityksen osalta – Viedyt työntekijät ovat viedyn työntekijän kohde.

Edellytykset

Ennen kuin aloitat tämän oppaan mukaisen harjoituksen, seuraavien edellytysten on täytyttävä:

Human Resources -ympäristö, jolla on järjestelmänvalvojatason käyttöoikeudet ympäristössä
Azure-tilaus logiikkasovelluksen isännöintiä varten

Harjoitus

Tämän harjoituksen lopussa sinulla on Human Resources -ympäristöösi ja OneDrive for Business -tiliisi yhdistetty logiikkasovellus. Logiikkasovellus vie tietopaketin Human Resourcesista, odottaa viennin valmistumista, lataa viedyn tietopaketin ja tallentaa tietopaketin määrittämääsi OneDrive for Business -kansioon.

Valmis logiikkasovellus muistuttaa seuraavaa kuvaa.

Logiikkasovelluksen yleiskuva.

Vaihe 1: Luo tietojen vientiprojekti Human Resourcesissa

Luo Human Resourcesissa tietojen vientiprojekti, joka vie työntekijöitä. Anna projektille nimi Vie työntekijät ja varmista, että asetuksen Luo tietopaketti arvona on Kyllä. Lisää projektiin yksittäinen yksikkö (Työntekijä) ja valitse muoto, jossa vienti suoritetaan. (Tässä oppaassa käytetään Microsoft Excel -muotoa.)

Vie työntekijät -tietoprojekti.

Tärkeä

Muista tietojen vientiprojektin nimi. Tarvitset sitä, kun luot logiikkasovelluksen seuraavassa vaiheessa.

Vaihe 2: Luo logiikkasovellus

Tämän harjoituksen keskeisin osa on logiikkasovellus.

Luo logiikkasovellus Azure-portaalissa.
Aloita Logic Apps Designer tyhjällä logiikkasovelluksella.
Lisää Toistuvan aikataulun käynnistin suorittamaan sovellus 24 tunnin välein (tai valitsemasi aikataulun mukaan).
Kutsu ExportToPackage DMF REST API aikatauluttamaan tietopakettisi vienti.
1. Käytä HTTP ja Microsoft Entra -yhdistimen Aktivoi HTTP-pyyntö -toimintoa.
  - Perusresurssien URL-osoite: Henkilöstöresurssiympäristön URL-osoite (älä sisällytä polku- tai nimitilatietoja.)
  - Microsoft Entra Resurssin URI:http://hr.talent.dynamics.com
  Muistiinpano
  
  Human Resources -palvelussa ei vielä ole yhdistintä, joka saisi näkyviin kaikki DMF-paketin REST API:t (esim. ExportToPackage). Sen sijaan ohjelmointirajapintoja on kutsuttava raaoilla HTTP-pyynnöillä HTTP ja Microsoft Entra -yhdistimen kautta. Tämä yhdistin käyttää Microsoft Entra ID:tä Human Resources -todennukseen ja valtuutukseen.
2. Kirjaudu Human Resources -ympäristöösi HTTP ja Microsoft Entra -yhdistimen kautta.
3. Määritä HTTP:n KIRJAA-pyyntö kutsuaksesi DMF REST API:n ExportToPackage.
  - Menetelmä: POST
  - Pyynnön url-osoite: https://< hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.ExportToPackage
  - Pyynnön osa:
```
{
    "definitionGroupId":"Export Workers",
    "packageName":"talent_package.zip",
    "executionId":"",
    "reExecute":false,
    "legalEntityId":"USMF"
}
```
Vihje

Sinun saattaa kannattaa nimetä kukin vaihe uudelleen, jotta se on merkityksellisempi kuin oletusnimi Aktivoi HTTP-pyyntö. Voit esimerkiksi nimetä tämän vaiheen uudelleen muotoon ExportToPackage.
Alusta muuttuja ExportToPackage-pyynnön suoritustilan tallentamista varten.
Odota, kunnes tietojen viennin suoritustila on Onnistui.
1. Lisää Kunnes-silmukka, joka toistuu, kunnes ExecutionStatus-muuttujan arvo on Onnistui.
2. Lisää Viive-toiminto, joka odottaa viisi sekuntia, ennen kuin se kysyy viennin kulloistakin suoritustilaa.
  
  Muistiinpano
  
  Määritä raja-arvoksi 15, jos haluat odottaa enintään 75 sekuntia (15 toistoa × 5 sekuntia) viennin valmistumiseen. Jos vientisi vaatii enemmän aikaa, säädä raja-arvoa sen mukaan.
3. Lisää Aktivoi HTTP-pyyntö -toiminto kutsumaan DMF REST API GetExecutionSummaryStatus ja asettamaan ExecutionStatus-muuttujan arvoksi GetExecutionSummaryStatus-vastauksen tulos.
  
  Tässä esimerkissä ei suoriteta virheiden tarkistusta. Ohjelmointirajapinta GetExecutionSummaryStatus voi palauttaa epäonnistuneita päätetiloja (eli muita tiloja kuin Onnistui). Lisätietoja on kohdassa API-dokumentaatio.
  - Menetelmä: POST
  - Pyynnön url-osoite: https://< hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExecutionSummaryStatus
  - Pyynnön teksti: elin (Invoke_an_HTTP_request)?[" arvo']
    
    Muistiinpano
    
    Sinun on ehkä syötettävä Pyynnön teksti -arvo joko suunnitteluohjelman koodinäkymässä tai toimintoeditorissa.
  Tärkeä
  
  Määritä muuttuja -toiminnon arvo (body('InvokeanHTTPrequest2')?['value']) eroaa Aktivoi HTTP-pyyntö 2 -tekstin arvosta, vaikka suunnitteluohjelma näyttää arvot samalla tavalla.
Hae viedyn paketin URL-latausosoite.
- Lisää Aktivoi HTTP-pyyntö -toiminto kutsuaksesi DMF REST-API:n getexportdpackageurl DMF REST-API-liittymään.
  - Menetelmä: POST
  - Pyynnön URL-osoite: https://< hostname>/namespaces/<namespace_guid>/data/DataManagementDefinitionGroups/Microsoft.Dynamics.DataEntities.GetExportedPackageUrl
  - Pyynnön teksti: {"executionId": body ('GetExportedPackageURL')?[ arvo']}
Lataa viety paketti.
- Lisää HTTP:n HAE -pyyntö (sisäinen HTTP-yhdistintoiminto), joka lataa paketin edellisessä vaiheessa palautetusta URL-osoitteesta.
  - Menetelmä: GET
  - URI: body('Invoke_an_HTTP_request_3').arvo
    
    Muistiinpano
    
    Sinun on ehkä syötettävä URI-arvo joko suunnitteluohjelman koodinäkymässä tai toimintoeditorissa.
  Muistiinpano
  
  Tämä pyyntö ei edellytä lisätodennusta, getexportdpackageurl-API:n palauttama URL-osoite sisältää jaetun käytön allekirjoitustunnuksen, joka myöntää käyttöoikeuden ladattuun tiedostoon.
Tallenna ladattu paketti käyttäenOneDrive for Business -yhdistintä.
- Lisää OneDrive for Business Luo tiedosto -toiminto.
- Muodosta yhteys OneDrive for Business -tiliisi tarpeen mukaan.
  - Kansion polku: Haluamasi kansio
  - Tiedostonimi: worker_package.zip
  - Tiedoston sisältö: Edellisen version (dynaaminen vaihe) tekstiosa.

Vaihe 3: Testaa logiikkasovelllus

Testaa logiikkasovelluksesi valitsemalla suunnitteluohjelman Suorita-painike. Näet, että logiikkaohjelman vaiheita aletaan suorittaa. 30–40 sekunnin kuluttua logiikkasovelluksen suorittamisen pitäisi loppua, ja OneDrive for Business -kansiossasi pitäisi nyt olla uusi viedyt työntekijät sisältävä pakettitiedosto.

Jos jossakin vaiheessa ilmenee virhe, valitse kyseinen vaihe suunnitteluohjelmassa ja tutki sen kentät Syötteet ja Tuotokset. Korjaa virheet ja muuta vaihetta tarpeen mukaan virheiden korjaamiseksi.

Seuraavassa kuvassa näytetään, miltä Logic Apps Designer näyttää, kun kaikki logiikkasovelluksen vaiheet suoritetaan onnistuneesti.

Onnistunut logiikkasovelluksen suoritus.

Yhteenveto

Tässä oppaassa tutustuit logiikkasovelluksen käyttöön tietojen viemiseen Human Resourcesista ja vietyjen tietojen tallentamiseen OneDrive for Business -kansioon. Voit muokata tämän oppaan vaiheita yrityksesi tarpeiden mukaan.

Jaa