Použitie rozhraní API plánovania projektov V1 so službou Power Automate

Článok
02/09/2024

Vzťahuje sa na: Projektové operácie pre scenáre založené na zdrojoch/nezásobách, Lite nasadenie – dohoda s proforma fakturáciou

Tento článok popisuje vzorový postup, ktorý ukazuje, ako vytvoriť úplný plán projektu pomocou Microsoft Power Automate, ako vytvoriť množinu operácií a ako aktualizovať entitu. Príklad ukazuje, ako vytvoriť projekt, člena projektového tímu, množiny operácií, projektové úlohy a priradenia zdrojov. Tento článok tiež vysvetľuje, ako aktualizovať entitu a spustiť množinu operácií.

Príklad v tomto článku používa PssCreateV1 API. Príklad, ktorý používa PssCreateV2 API, nájdete v časti V2 Project schedule APIs with Power Automate.

Tu je úplný zoznam krokov, ktoré sú zdokumentované vo vzorovom postupe v tomto článku:

Vytvorte Power Apps spúšťač
Vytvorte projekt
Inicializujte premennú pre člena tímu
Vytvorte všeobecného člena tímu
Vytvorte súpravu operácií
Inicializujte premennú pre ID segmentu projektu
Vytvorte skupinu projektov
Inicializujte premennú pre počet úloh
Inicializujte premennú pre ID projektovej úlohy
Urobte do
Nastavte projektovú úlohu
Vytvorte projektovú úlohu
Vytvorte priradenie zdroja
Znížte premennú
Premenujte projektovú úlohu
Spustite sadu operácií

Predpoklady

Tento článok predpokladá, že máte základné znalosti o Dataverse platforme, cloudových tokoch a rozhraní Project Schedule API. Ďalšie informácie nájdete v časti Referencie ďalej v tomto článku.

Vytvorte postup

Vyberte prostredie

Vo svojom prostredí môžete vytvoriť postup Power Automate.

Prejdite na stránku https://flow.microsoft.com a prihláste sa pomocou poverení správcu.
V pravom hornom rohu vyberte Prostredia.
V zozname vyberte prostredie, kde je nainštalované Dynamics 365 Project Operations.

Vytvorenie riešenia

Podľa týchto krokov vytvorte tok zohľadňujúci riešenie. Vytvorením postupu podporujúceho riešenie môžete postup jednoduchšie exportovať a použiť ho neskôr.

Na navigačnej table vyberte Riešenia.
Na stránke Riešenia vyberte Nové riešenie.
V dialógovom okne Nové riešenie nastavte požadované polia a potom vyberte Vytvoriť.

Krok 1: Vytvorte Power Apps spúšťač

Na stránke Riešenia vyberte riešenie, ktoré ste vytvorili, a potom vyberte Nové.
V ľavom paneli vyberte Cloudové toky>Automatizácia>Cloudový tok>Okamžité.
Do poľa Názov toku zadajte Schedule API Demo Flow.
V zozname Vyberte spôsob spustenia tohto postupu vyberte Power Apps. Keď vytvoríte spúšťač Power Apps, logika je na vás ako autorovi. V príklade v tomto článku ponechajte vstupné parametre prázdne na účely testovania.
Vyberte položku Vytvoriť.

Krok 2: Vytvorenie projektu

Ak chcete vytvoriť vzorový projekt, postupujte podľa týchto krokov.

V toku, ktorý ste vytvorili, vyberte Nový krok.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Vytvoriť projekt.
V poli Názov akcie vyberte msdyn_CreateProjectV1.
V poli msdyn_subject vyberte Pridať dynamický obsah.
Na karte Výraz do poľa funkcie zadajte concat('Názov projektu - ',utcNow()).
Vyberte položku OK.

Krok 3: Inicializujte premennú pre člena tímu

V toku vyberte Nový krok.
V dialógovom okne Vyberte operáciu do vyhľadávacieho poľa zadajte inicializovať premennú. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Init člen tímu.
Do poľa Názov zadajte Akcia člena tímu.
V poli Typ vyberte Reťazec.
Do poľa Hodnota zadajte msdyn_CreateTeamMemberV1.

Krok 4: Vytvorte všeobecného člena tímu

V toku vyberte Nový krok.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Vytvoriť člena tímu.
Pre pole Názov akcie vyberte Akcia člena tímu v Dynamický obsah dialógové okno.
Do poľa Parametre akcie zadajte nasledujúce informácie o parametroch.
```
{
    "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"
    }
} 
```
Tu je vysvetlenie parametrov:
- @@odata.type – Názov entity. Zadajte napríklad "Microsoft.Dynamics.CRM.msdyn_projectteam".
- msdyn_projectteamid – Primárny kľúč ID projektového tímu. Hodnota je výraz jednoznačného globálneho identifikátora (GUID). ID sa generuje z karty výrazu.
- msdyn_project@odata.bind – ID projektu vlastníka projektu. Hodnota je dynamický obsah, ktorý pochádza z odpovede kroku „Vytvoriť projekt“. Uistite sa, že ste zadali celú cestu a pridali dynamický obsah do zátvoriek. Úvodzovky sú povinné. Zadajte napríklad "/msdyn_projects(PRIDAŤ DYNAMICKÝ OBSAH)".
- msdyn_name – Meno člena tímu. Zadajte napríklad "ScheduleAPIDemoTM1".

Krok 5: Vytvorte súpravu operácií

V toku vyberte Nový krok.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Vytvorenie sady operácií.
V poli Názov akcie vyberte vlastnú akciu msdyn_CreateOperationSetV1 Dataverse .
Do poľa Popis zadajte ScheduleAPIDemoOperationSet.
V poli Projekt v dialógovom okne Dynamický obsah vyberte msdyn_CreateProjectV1Response ProjectId.

Krok 6: Inicializujte premennú pre ID segmentu projektu

V toku vyberte Nový krok.
V dialógovom okne Vyberte operáciu do vyhľadávacieho poľa zadajte inicializovať premennú. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Identifikátor inicializácie projektového segmentu.
Do poľa Názov zadajte identifikátor segmentu projektu.
V poli Typ vyberte Reťazec.
Do poľa Hodnota zadajte @{guid()}.

Krok 7: Vytvorte skupinu projektov

V toku vyberte Pridať akciu.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V tomto kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Vytvoriť segment.
1. V poli Názov akcie vyberte msdyn_PssCreateV1.
Do poľa Entita zadajte nasledujúce informácie o parametroch.
```
{
    "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projectbucket",
    "msdyn_projectbucketid": "@{variables('project bucket id')}",
    "msdyn_name": "ScheduleAPIDemoBucket1",
    "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
}
```
Tu je vysvetlenie parametrov:
- @@odata.type – Názov entity. Zadajte napríklad "Microsoft.Dynamics.CRM.msdyn_projectbucket".
- msdyn_projectbucketid – Jedinečné ID sektora projektu. Hodnota by mala byť nastavená z dynamickej premennej z kroku 6.
- msdyn_project@odata.bind – ID projektu vlastníka projektu. Hodnota je dynamický obsah, ktorý pochádza z odpovede kroku „Vytvoriť projekt“. Uistite sa, že ste zadali celú cestu a pridali dynamický obsah do zátvoriek. Úvodzovky sú povinné. Zadajte napríklad "/msdyn_projects(PRIDAŤ DYNAMICKÝ OBSAH)".
- msdyn_name – názov skupiny projektu.
Pre pole OperationSetId vyberte msdyn_CreateOperationSetV1Response OperationSetId v Dynamický obsah dialógové okno.

Krok 8: Inicializujte premennú pre počet úloh

V toku vyberte Nový krok.
V dialógovom okne Vyberte operáciu do vyhľadávacieho poľa zadajte inicializovať premennú. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Init Počet úloh.
Do poľa Názov zadajte počet úloh.
V poli Typ vyberte Celé číslo.
Do poľa Hodnota zadajte 5.

Krok 9: Inicializujte premennú pre ID projektovej úlohy

V toku vyberte Nový krok.
V dialógovom okne Vyberte operáciu do vyhľadávacieho poľa zadajte inicializovať premennú. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Init ProjectTaskID.
Do poľa Názov zadajte msdyn_projecttaskid.
V poli Typ vyberte Reťazec.
Pre pole Hodnota zadajte v nástroji na tvorbu výrazov guid() .

Krok 10: Urobte do

V toku vyberte Nový krok.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte urobiť do. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
Prvú hodnotu v podmienenom príkaze nastavte na premennú počet úloh v dialógovom okne Dynamický obsah .
Nastavte podmienku na menej ako rovné.
Nastavte druhú hodnotu v podmienenom príkaze na 0.

Krok 11: Nastavte projektovú úlohu

V toku vyberte Pridať akciu.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte nastaviť premennú. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V novom kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Nastaviť úlohu projektu.
V poli Názov vyberte msdyn_projecttaskid.
Pre pole Hodnota zadajte v nástroji na tvorbu výrazov guid() .

Krok 12: Vytvorte projektovú úlohu

Podľa týchto krokov vytvorte projektovú úlohu, ktorá má jedinečné ID, ktoré patrí aktuálnemu projektu a kontajneru projektov, ktorý ste vytvorili.

V toku vyberte Nový krok.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V tomto kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Vytvorenie projektovej úlohy.
V poli Názov akcie vyberte msdyn_PssCreateV1.
Do poľa Entita zadajte nasledujúce informácie o parametroch.
```
{
    "@@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(@{variables('project bucket id')})",
    "msdyn_start": "@{addDays(utcNow(), 1)}",
    "msdyn_scheduledstart": "@{utcNow()}",
    "msdyn_scheduledend": "@{addDays(utcNow(), 5)}"
}
```
Tu je vysvetlenie parametrov:
- @@odata.type – Názov entity. Zadajte napríklad "Microsoft.Dynamics.CRM.msdyn_projecttask".
- msdyn_projecttaskid – Jedinečné ID úlohy. Hodnota by mala byť nastavená na dynamickú premennú z msdyn_projecttaskid.
- msdyn_project@odata.bind – ID projektu vlastníka projektu. Hodnota je dynamický obsah, ktorý pochádza z odpovede kroku „Vytvoriť projekt“. Uistite sa, že ste zadali celú cestu a pridali dynamický obsah do zátvoriek. Úvodzovky sú povinné. Zadajte napríklad "/msdyn_projects(PRIDAŤ DYNAMICKÝ OBSAH)".
- msdyn_subject – Ľubovoľný názov úlohy.
- msdyn_projectbucket@odata.bind – Skupina projektu, ktorá obsahuje úlohy. Hodnota je rovnaká ako hodnota použitá na nastavenie msdyn_projectbucketid v kroku „Vytvoriť segment“. Uistite sa, že ste zadali celú cestu a pridali dynamický obsah do zátvoriek. Úvodzovky sú povinné. Zadajte napríklad "/msdyn_projectbuckets(PRIDAŤ DYNAMICKÝ OBSAH)".
- msdyn_start – Dynamický obsah pre dátum začiatku. Napríklad zajtrajšok je reprezentovaný ako "addDays(utcNow(), 1)".
- msdyn_scheduledstart – Plánovaný dátum začiatku. Napríklad zajtrajšok je reprezentovaný ako "addDays(utcNow(), 1)".
- msdyn_scheduleend – Plánovaný dátum ukončenia. Vyberte budúci dátum. Zadajte napríklad "addDays(utcNow(), 5)".
- msdyn_LinkStatus – Stav prepojenia. Zadajte napríklad "192350000".
Pre pole OperationSetId vyberte msdyn_CreateOperationSetV1Response OperationSetId v Dynamický obsah dialógové okno.

Krok 13: Vytvorte priradenie zdroja

V toku vyberte Pridať akciu.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V tomto kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Vytvoriť zadanie.
V poli Názov akcie vyberte msdyn_PssCreateV1.

Do poľa Entita zadajte nasledujúce informácie o parametroch.

{
    "@@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']})"
}

Pre pole OperationSetId vyberte msdyn_CreateOperationSetV1Response OperationSetId v Dynamický obsah dialógové okno.

Krok 14: Znížte premennú

V toku vyberte Nový krok.
V dialógovom okne Vyberte operáciu do vyhľadávacieho poľa zadajte zmeniť premennú. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V poli Názov vyberte počet úloh.
Do poľa Hodnota zadajte 1.

Krok 15: Premenujte úlohu projektu

V toku vyberte Nový krok.
V dialógovom okne Vybrať operáciu do vyhľadávacieho poľa zadajte vykonať neviazanú akciu. Potom na karte Akcie vyberte operáciu v zozname výsledkov.
V tomto kroku vyberte tri bodky (…) a potom vyberte Premenovať.
Premenujte krok Premenovanie projektovej úlohy.
V poli Názov akcie vyberte msdyn_PssUpdateV1.