Použití rozhraní API projektů V1 s Power Automate

Článek
02/14/2024

Platí pro: Project Operations scénáře založené na zdrojích / položkách, které nejsou na skladě, omezené nasazení – dohoda o pro forma fakturaci

Tento článek popisuje ukázkový tok, který ukazuje, jak vytvořit úplný plán projektu pomocí Microsoft Power Automate, jak vytvořit sadu operací a jak aktualizovat entitu. Příklad ukazuje, jak vytvořit projekt, člena projektového týmu, sady operací, projektové úkoly a přiřazení zdrojů. Tento článek také vysvětluje, jak aktualizovat entitu a provést sadu operací.

Příklad v tomto článku používá PssCreateV1 API. Příklad, který používá PssCreateV2 API, viz Rozhraní API projektového plánu V2 s Power Automate.

Zde je úplný seznam kroků, které jsou zdokumentovány ve vzorovém toku v tomto článku:

Vytvoření triggeru Power Apps
Vytvoření projektu
Inicializujte proměnnou pro člena týmu
Vytvoření obecného člena týmu
Vytvoření sady operacíí
Inicializace proměnné pro ID kbelíku projektu
Vytvoření kbelíku projektu
Inicializujte proměnnou počtu úkolů
Inicializujte proměnnou pro ID projektového úkolu
Dělat dokud
Nastavit projektový úkol
Vytvořit projektový úkol
Vytvoření přiřazení zdroje
Snížit proměnnou
Přejmenovat projektový úkol
Spustit sadu operacíí

Předpoklady

Tento článek předpokládá, že máte základní znalosti o platformě Dataverse, cloudových tocích a rozhraní API projektového plánu. Více informací naleznete v části Reference v dále v tomto článku.

Vytvoření toku

Vyberte prostředí.

Ve svém prostředí můžete vytvářet tok Power Automate.

Přejděte na https://flow.microsoft.com a přihlaste se pomocí přihlašovacích údajů správce.
V pravém horním rohu vyberte Prostředí.
V seznamu vyberte prostředí, kde je nainstalována aplikace Dynamics 365 Project Operations.

Vytvoření řešení

Pokud chcete vytvořit tok s podporou řešení, postupujte podle těchto kroků. Vytvořením toku s podporou řešení můžete tok snadněji exportovat a použít jej později.

V levém navigačním podokně vyberte Řešení.
Na stránce Řešení vyberte Nové řešení.
V dialogovém okně Nové řešení nastavte požadovaná pole a poté vyberte Vytvořit.

Krok 1: Vytvoření triggeru Power Apps

Na stránce Řešení vyberte řešení, které jste vytvořili, a poté vyberte Nový.
V levém podokně vyberte Cloudové toky>Automatizace>Cloudový tok>Okamžitý.
Do pole Název toku zadejte Naplánovat ukázkový tok API.
V seznamu Vyberte, jak tento tok spustit vyberte Power Apps. Když vytvoříte trigger Power Apps, logika je na vás jako autorovi. Např. v tomto článku ponechte vstupní parametry prázdné pro účely testování.
Vyberte Vytvořit.

Krok 2: Vytvoření projektu

Při vytváření vzorového projektu postupujte takto.

V toku, který jste vytvořili, vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Vytvořit projekt.
Do pole Název akce vyberte msdyn_CreateProjectV1.
V poli msdyn_subject vyberte Přidat dynamický obsah.
Na kartě Výraz, do pole funkce zadejte concat('Název projektu - ',utcNow()).
Vyberte OK.

Krok 3: Inicializujte proměnnou pro člena týmu

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole inicializace proměnné. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Init člen týmu.
Do pole Název vložte TeamMemberAction.
V poli Typ vyberte Řetězec.
V poli Hodnota zadejte msdyn_CreateTeamMemberV1.

Krok 4: Vytvořte obecného člena projektového týmu

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Vytvořit člena týmu.
V poli Název akce vyberte TeamMemberAction v dialogovém okně Dynamický obsah.
V poli Parametry akce zadejte následující informace o parametrech.
```
{
    "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"
    }
} 
```
Následuje vysvětlení parametrů:
- @@odata.type – Název typu entity. Například zadejte "Microsoft.Dynamics.CRM.msdyn_projectteam".
- msdyn_projektteamid – Primární klíč ID projektového týmu. Hodnota je výraz globálně jedinečný identifikátor (GUID). ID se generuje z karty výraz.
- msdyn_project@odata.bind – ID vlastnícího projektu. Hodnota je dynamický obsah, který pochází z odezvy kroku „Vytvořit projekt“. Ujistěte se, že jste zadali úplnou cestu a přidali dynamický obsah do závorek. Uvozovky jsou povinné. Například zadejte "/msdyn_projects (PŘIDEJTE DYNAMICKÝ OBSAH)“.
- msdyn_name – Jméno člena týmu. Například zadejte "ScheduleAPIDemoTM1".

Krok 5: Vytvoření sady operacíí

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Vytvořit sadu operací.
V poli Název akce vyberte vlastní akci Dataverse msdyn_CreateOperationSetV1.
V poli Popis zadejte ScheduleAPIDemoOperationSet.
V poli Projekt vyberte v dialogu Dynamický obsah položku msdyn_CreateProjectV1Response ProjectId.

Krok 6: Inicializace proměnné pro ID kbelíku projektu

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole inicializace proměnné. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Inicializace ID kbelíku projektu.
Do pole Název vložte id kbelíku projektu.
V poli Typ vyberte Řetězec.
Do pole Hodnota zadejte @{guid()}.

Krok 7: Vytvoření kbelíku projektu

V toku vyberte položku Přidat akci.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V tomto kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Vytvořit kbelík.
1. Do pole Název akce vyberte msdyn_PssCreateV1.
V poli Entita zadejte následující informace o parametrech.
```
{
    "@@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']})",
}
```
Následuje vysvětlení parametrů:
- @@odata.type – Název typu entity. Například zadejte "Microsoft.Dynamics.CRM.msdyn_projectbucket".
- msdyn_projectbucketid – Jedinečné ID kbelíku projektu. Hodnota by měla být nastavena z dynamické proměnné v kroku 6.
- msdyn_project@odata.bind – ID vlastnícího projektu. Hodnota je dynamický obsah, který pochází z odezvy kroku „Vytvořit projekt“. Ujistěte se, že jste zadali úplnou cestu a přidali dynamický obsah do závorek. Uvozovky jsou povinné. Například zadejte "/msdyn_projects (PŘIDEJTE DYNAMICKÝ OBSAH)“.
- msdyn_name – Název kbelíku projektu.
Pro pole OperationSetId vyberte položku msdyn_CreateOperationSetV1Response OperationSetId v dialogu Dynamický obsah.

Krok 8: Inicializujte proměnnou počtu úkolů

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole inicializace proměnné. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Init Počet úkolů.
Do pole Název vložte počet úkolů.
V poli Typ vyberte Integer.
Do pole Hodnota zadejte 5.

Krok 9: Inicializujte proměnnou pro ID projektového úkolu

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole inicializace proměnné. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Init ProjectTaskID.
Do pole Název vložte msdyn_projecttaskid.
V poli Typ vyberte Řetězec.
Do pole Hodnota zadejte guid() v nástroji pro tvorbu výrazů.

Krok 10: Provádět dokud

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provádět dokud. Poté na kartě Akce vyberte operaci v seznamu výsledků.
Nastavte první hodnotu v podmíněném příkazu na proměnnou počet úkolů z dialogového okna Dynamický obsah.
Nastavte podmínku na menší než nebo rovno.
Nastavte druhou hodnotu v podmíněném příkazu na 0.

Krok 11: Nastavit projektový úkol

V toku vyberte položku Přidat akci.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole nastavit proměnnou. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V novém kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Nastavit projektový úkol.
Do pole Název vyberte msdyn_projecttaskid.
Do pole Hodnota zadejte guid() v nástroji pro tvorbu výrazů.

Krok 12: Vytvoření projektového úkolu

Chcete-li vytvořit projektový úkol, který má jedinečné ID, které náleží aktuálnímu projektu a vámi vytvořenému segmentu projektu, postupujte podle těchto kroků.

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V tomto kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Vytvořit projektový úkol.
Do pole Název akce vyberte msdyn_PssCreateV1.
V poli Entita zadejte následující informace o parametrech.
```
{
    "@@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)}"
}
```
Následuje vysvětlení parametrů:
- @@odata.type – Název typu entity. Například zadejte "Microsoft.Dynamics.CRM.msdyn_projecttask".
- msdyn_projecttaskid – Jedinečné ID úkolu. Hodnota by měla být nastavena na dynamickou proměnnou z msdyn_projecttaskid.
- msdyn_project@odata.bind – ID vlastnícího projektu. Hodnota je dynamický obsah, který pochází z odezvy kroku „Vytvořit projekt“. Ujistěte se, že jste zadali úplnou cestu a přidali dynamický obsah do závorek. Uvozovky jsou povinné. Například zadejte "/msdyn_projects (PŘIDEJTE DYNAMICKÝ OBSAH)“.
- msdyn_subject – Libovolný název úkolu.
- msdyn_projectbucket@odata.bind – Kbelík projektu, který obsahuje úkoly. Hodnota je stejná jako pro nastavení msdyn_projectbucketid v kroku „Vytvoření kbelíku“. Ujistěte se, že jste zadali úplnou cestu a přidali dynamický obsah do závorek. Uvozovky jsou povinné. Například zadejte "/msdyn_projectbuckets(PŘIDEJTE DYNAMICKÝ OBSAH)“.
- msdyn_start – Dynamický obsah pro datum zahájení. Například zítřek je reprezentován jako "addDays(utcNow(), 1)".
- msdyn_scheduledstart – Plánované datum zahájení operace. Například zítřek je reprezentován jako "addDays(utcNow(), 1)".
- msdyn_scheduleend – Plánované datum ukončení. Vyberte datum v budoucnosti. Například zadejte "addDays(utcNow(), 5)".
- msdyn_LinkStatus – Stav odkazu. Například zadejte "192350000".
Pro pole OperationSetId vyberte položku msdyn_CreateOperationSetV1Response OperationSetId v dialogu Dynamický obsah.

Krok 13: Vytvoření přiřazení zdrojů

V toku vyberte položku Přidat akci.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V tomto kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Vytvořit přiřazení.
Do pole Název akce vyberte msdyn_PssCreateV1.

V poli Entita zadejte následující informace o parametrech.

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

Pro pole OperationSetId vyberte položku msdyn_CreateOperationSetV1Response OperationSetId v dialogu Dynamický obsah.

Krok 14: Snížit proměnnou

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole snížení proměnné. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V poli Název vyberte počet úkolů.
Do pole Hodnota zadejte 1.

Krok 15: Přejmenujte projektový úkol

V toku vyberte Nový krok.
V dialogovém okně Vybrat operaci zadejte do vyhledávacího pole provedení nevázané akce. Poté na kartě Akce vyberte operaci v seznamu výsledků.
V tomto kroku vyberte tři tečky (...) a potom vyberte Přejmenovat.
Přejmenujte krok Přejmenovat projektový úkol.
Do pole Název akce vyberte msdyn_PssUpdateV1.