V2-Projektiaikataulun ohjelmointirajapintojen käyttäminen Power Automaten kanssa

Koskee: Project Operationsin resurssiin / muuhun kuin resurssiin perustuvia skenaarioita, Lite-käyttöönotto-kaupasta proformalaskutukseen

Tässä artikkelissa käsitellään esimerkkityönkulkua, joka näyttää, miten täydellinen projektisuunnitelma luodaan käyttämällä Microsoft Power Automate, miten toimintojoukko luodaan ja miten entiteetti päivitetään. Tässä esimerkissä näytetään, miten luodaan projekti, projektiryhmän jäsen, toimintojoukot, projektitehtävät ja resurssimääritykset. Tässä artikkelissa on myös tietoja entiteetin päivittämisestä ja toimintojoukon suorittamisesta.

Tässä artikkelissa olevassa esimerkissä käytetään PssCreateV2-ohjelmointirajapintaa. Esimerkki, joka käyttää PssCreateV1-ohjelmointirajapintaa on osoitteessaKäytä V1-projektiaikataulun rajapintoja Power Automatella.

Seuraavassa on täydellinen luettelo vaiheista, jotka on dokumentoitu tämän artikkelin esimerkkityönkulussa:

1. PowerApps-käynnistimen luominen
2. Luo projekti
3. Ryhmän jäsenen muuttujan alustaminen
4. Yleisen ryhmän jäsenen luonti
5. Toimintojoukon luominen
6. Luo projektisäilö
7. Tehtävien määrän muuttujan alustaminen
8. Projektitehtävän tunnuksen muuttujan alustaminen
9. Matriisin alustaminen
10. Tee kunnes
11. Määritä projektitehtävä
12. Tehtävän lisääminen matriisiin
13. Luo resurssimääritys
14. Pienennä muuttujaa
15. Tehtävien ja määritysten lisääminen toimintojoukkoon
16. Toimintojoukon suorittaminen

Oletustiedot

Tässä artikkelissa oletetaan, että käytössä on perustiedot Dataverse-alustasta, pilvityönkuluista ja projektiaikataulun ohjelmointirajapinnasta. Lisätietoja on myöhemmin tässä artikkelissa kohdassa Viitteet.

Luo työnkulku

Ympäristön valinta

Voit luoda Power Automate -työnkulun ympäristössäsi.

1. Siirry osoitteeseen https://flow.microsoft.com ja kirjaudu sisään järjestelmänvalvojan tunnistetiedoilla.
2. Valitse Ympäristöt oikeassa yläkulmassa.
3. Valitse luettelosta ympäristö, johon Dynamics 365 Project Operations on asennettu.

Ratkaisun luominen

Voit luoda ratkaisun huomioon ottavan työnkulun seuraavasti. Luomalla ratkaisulle tietoisia työnkulkuja voit viedä työnkulun helpommin myöhemmin käytettäväksi.

1. Valitse siirtymisruudussa Ratkaisut.
2. Valitse Ratkaisut-sivulla Uusi ratkaisu.
3. Määritä Uusi ratkaisu -valintaikkunassa pakolliset kentät ja valitse sitten Luo.

Vaihe 1: PowerApps-käynnistimen luominen

1. Valitse Ratkaisut-sivulla luomasi ratkaisu ja valitse sitten Uusi.
2. Valitse vasemmanpuoleisesta ruudusta Pilvityönkulut>Automaatio>Pilvityönkulku>Välitön.
3. Kirjoita Työnkulun nimi -kenttään Schedule API Demo Flow.
4. Valitse Valitse , miten työnkulku käynnistyy -luettelossa Power Apps. Kun luot Power Apps -käynnistimen, logiikka on tekijän vastuulla. Tämän artikkelin esimerkissä syöteparametrit jätetään tyhjiksi testausta varten.
5. Valitse Luo.

Vaihe 2: Luo projekti

Luo esimerkkiprojekti seuraavien vaiheiden mukaisesti.

1. Valitse luomassasi työnkulussa Uusi vaihe.

   

2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään suorita ei-sidottu toiminto. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.

   

3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.

   

4. Nimeä uudelleen vaihe: Luo projekti.

5. Valitse Toiminnon nimi -kentässä msdyn_CreateProjectV1.

6. Valitse msdyn_subject -kentässä Lisää dynaaminen sisältö.

7. Kirjoita Lauseke-välilehden toimintokenttään concat('Projektin nimi - ',utcNow()).

8. Valitse OK.

Vaihe 3: Ryhmän jäsenen muuttujan alustaminen

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään alusta muuttuja. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Alusta ryhmän jäsen.
5. Anna Nimi-kentässä TeamMemberAction.
6. Kirjoita Tyyppi-kenttään Merkkijono.
7. Syötä Arvo-kenttään msdyn_CreateTeamMemberV1.

Vaihe 4: Luo yleinen ryhmän jäsen.

1. Valitse työnkulussa Uusi vaihe.

2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään suorita ei-sidottu toiminto. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.

3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.

4. Nimeä uudelleen vaihe: Luo ryhmän jäsen.

5. Valitse Toiminnon nimi -kentässä Dynaamisen sisältö valintaikkunassa TeamMemberAction.

6. Kirjoita Toimintoparametrit-kenttään seuraavat parametritiedot.

   {
       "TeamMember": {
           "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projectteam",
           "msdyn_projectteamid": "@{guid()}",
           "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
           "msdyn_name": "ScheduleAPIDemoTM1"
       }
   } 
   

   Seuraavassa on selitetty parametrit:

   • @@odata.type – Entiteetin nimi. Kirjoita esimerkiksi "Microsoft.Dynamics.CRM.msdyn_projectteam".
   • msdyn_projectteamid – Projektitiimin tunnuksen perusavain. Arvo on GUID-lauseke. Tunnus luodaan Lauseke-välilehdestä.
   • msdyn_project@odata.bind – Omistavan projektin tunnus. Arvo on dynaaminen sisältö, joka tulee Luo projekti -vaiheen vastauksesta. Varmista, että syötät koko polun ja lisäät dynaamisen sisällön sulkeiden väliin. Lainausmerkit ovat pakollisia. Kirjoita esimerkiksi "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_name – Ryhmän jäsenen nimi. Kirjoita esimerkiksi "ScheduleAPIDemoTM1".

Vaihe 5: Toimintojoukon luominen

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään suorita ei-sidottu toiminto. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Luo toimintojoukko.
5. Valitse Toiminnon nimi -kentässä mukautettu msdyn_CreateOperationSetV1 Dataverse -toiminto.
6. Syötä Kuvaus-kenttään ScheduleAPIDemoOperationSet.
7. Valitse Projekti-kentälle msdyn_CreateProjectV1Response ProjectId Dynaaminen sisältö -valintaikkunassa.

Vaihe 6: Luo projektisäilö

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään lisää uusi rivi. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Luo säilö.
5. Valitse Taulukon nimi -kentässä Projektisäilöt.
6. Anna Nimi-kentässä ScheduleAPIDemoBucket1.
7. Anna Projekti-kenttään /msdyn_projects(.
8. Valitse Dynaaminen sisältö -valintaikkunassa msdyn_CreateProjectV1Response ProjectId.
9. Kirjoita Projekti-kenttään ).

Vaihe 7: Tehtävien määrän muuttujan alustaminen

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään alusta muuttuja. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Alusta tehtävien määrä.
5. Anna Nimi-kentässä tehtävien määrä.
6. Kirjoita Tyyppi-kenttään Kokonaisluku.
7. Anna Arvo-kentässä 5.

Vaihe 8: Projektitehtävän tunnuksen muuttujan alustaminen

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään alusta muuttuja. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Alusta ProjectTaskID.
5. Anna Nimi-kentässä msdyn_projecttaskid.
6. Kirjoita Tyyppi-kenttään Merkkijono.
7. Kirjoita Arvo-kenttään lausekkeen muodostimessa guid().

Vaihe 9: Matriisin alustaminen

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään alusta muuttuja. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe Alusta matriisi.
5. Anna Nimi-kentässä Tehtävät ja määritykset.
6. Kirjoita Tyyppi-kenttään Matriisi.

Vaihe 10: Tee kunnes

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään tee kunnes. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Määritä ehdollisen lauseen ensimmäinen arvo dynaamisen sisällön valintaikkunassa tehtävien määrän muuttujalle.
4. Määritä ehdoksi pienempi tai yhtä suuri kuin.
5. Aseta ehdollisen lausekkeen toisen arvon arvoksi 0.

Vaihe 11: Määritä projektitehtävä

1. Valitse työnkulussa Lisää toiminto.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään määritä muuttuja. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse uudessa vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Määritä projektitehtävä.
5. Valitse Nimi-kentässä msdyn_projecttaskid.
6. Kirjoita Arvo-kenttään lausekkeen muodostimessa guid().

Vaihe 12: Tehtävän lisääminen matriisiin

1. Valitse työnkulussa Lisää toiminto.

2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään Lisää matriisiin.

3. Valitse vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.

4. Nimeä uudelleen vaihe Tehtävän lisääminen matriisiin.

5. Valitse Nimi-kentässä Tehtävät ja määritykset.

6. Kirjoita Arvo-kenttään seuraavat parametritiedot.

   {
       "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projecttask",
       "msdyn_projecttaskid": "@{variables('msdyn_projecttaskid')}",
       "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
       "msdyn_subject": "ScheduleAPIDemoTask1",
       "msdyn_projectbucket@odata.bind": "/msdyn_projectbuckets(@{outputs('Create_Bucket')?['body/msdyn_projectbucketid']})",
       "msdyn_start": "@{addDays(utcNow(), 1)}",
       "msdyn_scheduledstart": "@{utcNow()}",
       "msdyn_scheduledend": "@{addDays(utcNow(), 5)}",
       "msdyn_LinkStatus": "192350000"
   }
   

   Seuraavassa on selitetty parametrit:

   • @@odata.type – Entiteetin nimi. Kirjoita esimerkiksi "Microsoft.Dynamics.CRM.msdyn_projecttask".
   • msdyn_projecttaskid – Tehtävän yksilöllinen tunnus. Arvoksi on määritettävä dynaaminen muuttuja, joka on peräisin kohteesta msdyn_projecttaskid.
   • msdyn_project@odata.bind – Omistavan projektin tunnus. Arvo on dynaaminen sisältö, joka tulee Luo projekti -vaiheen vastauksesta. Varmista, että syötät koko polun ja lisäät dynaamisen sisällön sulkeiden väliin. Lainausmerkit ovat pakollisia. Kirjoita esimerkiksi "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_subject – Mikä tahansa tehtävän nimi.
   • msdyn_projectbucket@odata.bind – Projektisäilö, joka sisältää tehtävät. Arvo on dynaaminen sisältö, joka tulee Luo projektisäilö -vaiheen vastauksesta. Varmista, että syötät koko polun ja lisäät dynaamisen sisällön sulkeiden väliin. Lainausmerkit ovat pakollisia. Kirjoita esimerkiksi "/msdyn_projectbuckets(LISÄÄ DYNAAMINEN SISÄLTÖ)".
   • msdyn_start – Alkamispäivän dynaaminen sisältö. Esimerkiksi huominen näkyy muodossa "addDays(utcNow(), 1)".
   • msdyn_scheduledstart – Suunniteltu aloituspäivä. Esimerkiksi huominen näkyy muodossa "addDays(utcNow(), 1)".
   • msdyn_scheduleend – Aikataulutettu päättymispäivä. Valitse tuleva päivämäärä. Määritä esimerkiksi "addDays(utcNow(), 5)".
   • msdyn_LinkStatus – Linkki laskumääritykseen. Kirjoita esimerkiksi "192350000", jos laskutuksen määritykseen ei ole linkkiä tai "192350001", jos laskutuksen asetukset on linkitetty.

Vaihe 13: Resurssimäärityksen luominen

1. Valitse työnkulussa Lisää toiminto.

2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään Lisää matriisiin.

3. Valitse vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.

4. Nimeä uudelleen vaihe Määrityksen lisääminen matriisiin.

5. Valitse Nimi-kentässä Tehtävät ja määritykset.

6. Kirjoita Arvo-kenttään seuraavat parametritiedot.

   {
       "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_resourceassignment",
       "msdyn_resourceassignmentid": "@{guid()}",
       "msdyn_name": "ScheduleAPIDemoAssign1",
       "msdyn_taskid@odata.bind": "/msdyn_projecttasks(@{variables('msdyn_projecttaskid')})",
       "msdyn_projectteamid@odata.bind": "/msdyn_projectteams(@{outputs('Create_Team_Member')?['body/TeamMemberId']})",
       "msdyn_projectid@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})"
   }
   

Vaihe 14: Pienennä muuttujaa

1. Valitse työnkulussa Lisää toiminto.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään pienennä muuttujaa. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse Nimi-kentässä tehtävien määrä.
4. Anna Arvo-kentässä 1.

Vaihe 15: Tehtävien ja määritysten lisääminen toimintojoukkoon

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään suorita ei-sidottu toiminto. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe Tehtävien ja määritysten lisääminen toimintojoukkoon.
5. Valitse Toiminnon nimi -kentässä msdyn_PssCreateV2.
6. Valitse Dynaaminen sisältö -valintaikkunan OperationSetId-kentän arvoksi msdyn_CreateOperationSetV1Response OperationSetId.
7. Valitse EntityCollection-kentässä Vaihda syöte koko matriisiin.
8. Valitse kentässä EntityCollection Tehtävät ja määritykset Dynaaminen sisältö -dialogi-ikkunassa.

Vaihe 16: Toimintojoukon suorittaminen

1. Valitse työnkulussa Uusi vaihe.
2. Kirjoita Valitse toiminto - valintaikkunan hakukenttään suorita ei-sidottu toiminto. Valitse sitten Toiminnot-välilehden tulosluettelosta toiminto.
3. Valitse vaiheessa kolme pistettä (…) ja valitse sitten Nimeä uudelleen.
4. Nimeä uudelleen vaihe: Suorita toimintojoukko.
5. Valitse Toiminnon nimi -kentässä msdyn_ExecuteOperationSetV1.
6. Valitse Dynaaminen sisältö -valintaikkunan OperationSetId-kentän arvoksi msdyn_CreateOperationSetV1Response OperationSetId.

Viitteet

• Työnkulkujen ja Dataversen integroimisen yleiskuvaus – Power Automate
• Projektiaikataulun ohjelmointirajapintojen käyttö toimintojen suorittamiseen aikataulutusentiteeteillä
• Yleiskatsaus pilvityönkuluista – Power Automate
• Yleistä ratkaisutietoisista työnkuluista – Power Automate