Dela via

Använda API:er för projektscheman V2 med Power Automate

  • Artikel

Gäller: Project Operations för resurs- och icke-lagerbaserade scenarier, lite distribution – handlar för att proforma-fakturering

Denna artikel beskriver ett exempelflöde som visar hur du skapar en komplett projektplan med hjälp av Microsoft Power Automate, hur du skapar en åtgärdsuppsättning och uppdaterar en entitet. Exemplet visar hur du skapar ett projekt, en projektteammedlem, åtgärdsgrupper, projektuppgifter samt resurstilldelningar. Denna artikel förklarar även hur du uppdaterar en entitet och kör en åtgärdsuppsättning.

I exemplet i den här artikeln används PssCreateV2 API. För ett exempel som använder PssCreateV1 API, se Använd V1 Projekttidsplan-API:er med Power Automate.

Följande utgör en fullständig lista över de steg som dokumenteras i exempelflödet i denna artikel:

  1. Skapa en PowerApps-utlösare
  2. Skapa ett projekt
  3. Initiera en variabel för teammedlemmen
  4. Skapa en generisk teammedlem
  5. Skapa en åtgärdsuppsättning
  6. Skapa en projektbucket
  7. Initiera en variabel för antalet uppgifter
  8. Initiera en variabel för projektets uppgifts-ID
  9. Initiera en matris
  10. Gör till
  11. Ange en projektuppgift
  12. Lägga till en uppgift i matrisen
  13. Skapa en resurstilldelning
  14. Minska en variabel
  15. Lägga till uppgifter och tilldelningar i åtgärdsuppsättningen
  16. Kör en åtgärdsuppsättning

Antaganden

Denna artikel förutsätter att du har grundläggande kunskaper om Dataverse-plattformen, molnflöden och API för projektschema. Mer information finns i avsnittet Referenser senare i denna artikel.

Skapa ett flöde

Välj en miljö

Du kan inte skapa Power Automate-flödet i din miljö.

  1. Gå till https://flow.microsoft.com och logga in med dina autentiseringsuppgifter som global administratör.
  2. Välj Miljöer i det övre högra hörnet.
  3. I listan väljer du den miljö där Dynamics 365 Project Operations finns installerat.

Skapa en lösning

Följ dessa steg om du vill skapa ett lösningsmedvetet flöde. Genom att skapa ett lösningsmedvetet flöde kan du enklare exportera flödet och använda det senare.

  1. I den navigeringsrutan väljer du Lösningar.
  2. På sidan Lösningar väljer du Ny lösning.
  3. I dialogrutan Ny lösning anger du erforderliga fält och väljer sedan Skapa.

Steg 1: Skapa en PowerApps-utlösare

  1. På sidan Lösningar väljer du den lösning du skapat och sedan Nytt.
  2. I det vänstra fönstret väljer du Molnflöden>Automation>Molnflöde>Direkt.
  3. I fältet Flödesnamn anger du Schemalägg API-demonstrationsflöde.
  4. I listan Välj hur du vill utlösa detta flöde väljer du Power Apps. När du skapar en Power Apps-utlösare är logiken upp till dig som författare. I denna artikel lämnar du till exempel indataparametrarna tomma för testningssyften.
  5. Välj Skapa.

Steg 2: Skapa ett projekt

Skapa ett exempelprojekt genom att följa stegen nedan.

  1. I flödet som du skapat väljer du Nytt steg.

    Lägga till ett nytt steg.

  2. I dialogrutan Välj en åtgärd anger du utför utgående åtgärd i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.

    Välja en åtgärd.

  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.

    Byta namn på ett steg.

  4. Byt namn på steget Skapa projekt.

  5. I fältet Åtgärdsnamn väljer du msdyn‑CreateProjectV1.

  6. Under fältet msdyn‑subject väljer du Lägg till dynamiskt innehåll.

  7. På fliken Uttryck, i funktionsfältet anger du concat('Project name - ',utcNow()).

  8. Välj OK.

Steg 3: Initiera en variabel för teammedlemmen

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du initiera variabel i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Init-teammedlem.
  5. I fältet Namn anger du TeamMemberAction.
  6. I fältet Typ väljer du Sträng.
  7. I fältet Värde anger du msdyn‑CreateTeamMemberV1.

Steg 4: Skapa en generisk teammedlem

  1. I flödet väljer du Nytt steg.

  2. I dialogrutan Välj en åtgärd anger du utför utgående åtgärd i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.

  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.

  4. Byt namn på steget Skapa teammedlem.

  5. För fältet Åtgärdsnamn väljer du TeamMemberAction i dialogrutan Dynamiskt innehåll.

  6. Ange följande parameterinformation i fältet Åtgärdsparametrar.

    {
    "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"
    }
}

    Här följer en förklaring av parametrarna:

    • @@odata.type – Entitetens namn. Skriv till exempel "Microsoft.Dynamics.CRM.msdyn_projectteam".
    • msdyn‑projectteamid – Den primära nyckeln för projektteamets ID. Värdet är ett GUID-uttryck (globalt unik identifierare). ID:t skapas från fliken Uttryck.
    • msdyn_project@odata.bind – ID för projektets kalender. Värdet blir dynamiskt innehåll som kommer från svaret i steget Skapa projekt. Kontrollera att du anger den fullständiga sökvägen och lägger till dynamiskt innehåll mellan parenteserna. Citattecken krävs. Skriv till exempel "/msdyn‑projects(ADD DYNAMIC CONTENT)".
    • msdyn‑name – Namnet på teammedlemmen. Skriv till exempel "ScheduleAPIDemoTM1".

Steg 5: Skapa en åtgärdsuppsättning

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du utför utgående åtgärd i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Skapa åtgärdsuppsättning.
  5. I fältet Åtgärdsnamn väljer du den anpassade msdyn_CreateOperationSetV1 Dataverse-åtgärden.
  6. I fältet Beskrivning anger du ScheduleAPIDemoOperationSet.
  7. För fältet Projekt väljer du msdyn_CreateProjectV1Response ProjectId i dialogrutan Dynamiskt innehåll.

Steg 6: Skapa en projektbucket

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du lägg till ny rad i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Skapa bucket.
  5. I fältet Tabellnamn väljer du Projekt-buckets.
  6. I fältet Namn anger du ScheduleAPIDemoBucket1.
  7. I fältet Projekt anger du /msdyn‑projects(.
  8. I dialogrutan Dynamiskt innehåll väljer du msdyn_CreateProjectV1Response ProjectId.
  9. I fältet Projekt anger du ).

Steg 7: Initiera en variabel för antalet uppgifter

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du initiera variabel i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Init antalet uppgifter.
  5. I fältet Namn anger du antalet uppgifter.
  6. I fältet Typ väljer du Heltal.
  7. I fältet Värde anger du 5.

Steg 8: Initiera en variabel för projektets uppgifts-ID

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du initiera variabel i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Init ProjectTaskID.
  5. Ange msdyn_projecttaskid i fältet Namn.
  6. I fältet Typ väljer du Sträng.
  7. För fältet Värde anger du guid() i uttrycksverktyget.

Steg 9: Initiera en matris

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du initiera variabel i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Init matris.
  5. I fältet Namn anger du Uppgifter och tilldelningar.
  6. I fältet Typ väljer du Matris.

Steg 10: Gör till

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du Gör till i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. Ange det första värdet i den villkorliga instruktionen till variabeln antal uppgifter från dialogrutan Dynamiskt innehåll.
  4. Ange villkoret som mindre än lika med.
  5. Ange det andra värdet i den villkorliga instruktionen som 0.

Steg 11: Ange en projektuppgift

  1. I flödet, välj Lägg till en åtgärd.
  2. I dialogrutan Välj en åtgärd anger du ange variabel i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Ange projektuppgift.
  5. I fältet Namn väljer du msdyn‑projecttaskid.
  6. För fältet Värde anger du guid() i uttrycksverktyget.

Steg 12: Lägg till en uppgift i matrisen

  1. I flödet, välj Lägg till en åtgärd.

  2. I dialogrutan Välj en åtgärd anger du Lägg till i matris i sökfältet.

  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.

  4. Byt namn på steget Lägg till en uppgift i matrisen.

  5. I fältet Namn väljer du Uppgifter och tilldelningar.

  6. Ange följande parameterinformation i fältet Värde.

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

    Här följer en förklaring av parametrarna:

    • @@odata.type – Entitetens namn. Skriv till exempel "Microsoft.Dynamics.CRM.msdyn‑projecttask".
    • msdyn‑projecttaskid – Uppgiftens unika ID. Värdet ska anges till en dynamisk variabel från msdyn_projecttaskid.
    • msdyn_project@odata.bind – ID för projektets kalender. Värdet blir dynamiskt innehåll som kommer från svaret i steget Skapa projekt. Kontrollera att du anger den fullständiga sökvägen och lägger till dynamiskt innehåll mellan parenteserna. Citattecken krävs. Skriv till exempel "/msdyn‑projects(ADD DYNAMIC CONTENT)".
    • msdyn‑subject – Valfritt uppgiftsnamn.
    • msdyn_projectbucket@odata.bind – Den projektbucket som innehåller uppgifterna. Värdet blir dynamiskt innehåll som kommer från svaret i steget "Skapa bucket". Kontrollera att du anger den fullständiga sökvägen och lägger till dynamiskt innehåll mellan parenteserna. Citattecken krävs. Skriv till exempel "/msdyn‑projectbuckets(ADD DYNAMIC CONTENT)".
    • msdyn‑start – Dynamiskt innehåll för startdatum. Morgondagen representeras till exempel som "addDays(utcNow(), 1)".
    • msdyn‑scheduledstart – Det tidsplanerade startdatumet. Morgondagen representeras till exempel som "addDays(utcNow(), 1)".
    • msdyn‑scheduleend – Det schemalagda slutdatumet. Välj ett datum i framtiden. Ange till exempel "addDays(utcNow(), 5)".
    • msdyn_LinkStatus – Länken till faktureringsinställningarna. Skriv till exempel "192350000" om det inte finns någon länk till faktureringskonfigurationen eller "192350001" om faktureringskonfigurationen är länkad.

Steg 13: Skapa en resurtilldelning

  1. I flödet, välj Lägg till en åtgärd.

  2. I dialogrutan Välj en åtgärd anger du Lägg till i matris i sökfältet.

  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.

  4. Byt namn på steget Lägg till tilldelning i matrisen.

  5. I fältet Namn väljer du Uppgifter och tilldelningar.

  6. Ange följande parameterinformation i fältet Värde.

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

Steg 14: Minska en variabel

  1. I flödet, välj Lägg till en åtgärd.
  2. I dialogrutan Välj en åtgärd anger du minska variabel i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I fältet Namn välje du antal uppgifter.
  4. I fältet Värde anger du 1.

Steg 15: Lägga till uppgifter och tilldelningar i åtgärdsuppsättningen

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du utför utgående åtgärd i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Lägga till uppgifter och tilldelningar i åtgärdsuppsättningen.
  5. I fältet Åtgärdsnamn väljer du msdyn_PssCreateV2.
  6. För fältet OperationSetId, välj msdyn_CreateOperationSetV1Response OperationSetId i dialogrutan Dynamiskt innehåll.
  7. I fältet EntityCollection, välj Växla ingång till hela matrisen.
  8. För fältet EntityCollection, välj Uppgifter och tilldelningar i dialogrutan Dynamiskt innehåll.

Steg 16: Kör en åtgärdsuppsättning

  1. I flödet väljer du Nytt steg.
  2. I dialogrutan Välj en åtgärd anger du utför utgående åtgärd i sökfältet. På fliken Åtgärder markerar du åtgärden i resultatlistan.
  3. I det nya steget markerar du ellipsen (...) och sedan Byt namn.
  4. Byt namn på steget Kör åtgärdsuppsättning.
  5. I fältet Åtgärdsnamn väljer du msdyn‑ExecuteOperationSetV1.
  6. För fältet OperationSetId, välj msdyn_CreateOperationSetV1Response OperationSetId i dialogrutan Dynamiskt innehåll.

Referenser