V1 API's voor projectplanning gebruiken met Power Automate

Van toepassing op: Project Operations voor scenario's op basis van resources/niet-voorradige artikelen, vereenvoudigde implementatie - van deal tot pro-formafacturering

Dit artikel bevat een beschrijving van een voorbeeldstroom die laat zien hoe u een compleet projectplan kunt maken met behulp van Microsoft Power Automate, hoe u een bewerkingsset maakt en hoe u een entiteit bijwerkt. Het voorbeeld laat zien hoe u een project, projectteamlid, bewerkingssets, projecttaken en resourcetoewijzingen maakt. In dit artikel wordt ook uitgelegd hoe u een entiteit bijwerkt en een bewerkingsset uitvoert.

In het voorbeeld in dit artikel wordt de PssCreateV1 API gebruikt. Voor een voorbeeld waarbij de PssCreateV2 API wordt gebruikt, zie V2 API's voor projectplanning gebruiken met Power Automate.

Hieronder vindt u een volledige lijst van de stappen die zijn gedocumenteerd in de voorbeeldstroom in dit artikel:

  1. Een Power Apps-trigger maken
  2. Een project maken
  3. Een variabele initialiseren voor het teamlid
  4. Een algemeen teamlid maken
  5. Een bewerkingsset maken
  6. Een variabele initialiseren voor de projectbucket-id
  7. Een projectbucket maken
  8. Een variabele initialiseren voor het aantal taken
  9. Een variabele initialiseren voor de projecttaak-id
  10. Doen tot
  11. Een projecttaak instellen
  12. Een projecttaak maken
  13. Een resourcetoewijzing maken
  14. Een variabele verlagen
  15. Naam van een projecttaak wijzigen
  16. Een bewerkingsset uitvoeren

Aannames

In dit artikel wordt ervan uitgegaan dat u over basiskennis van het Dataverse-platform, cloudstromen en de API voor projectplanning beschikt. Zie de sectie Verwijzingen verderop in dit artikel voor meer informatie.

Stroom maken

Selecteer een omgeving

U kunt de Power Automate-stroom maken in uw omgeving.

  1. Ga naar https://flow.microsoft.com en gebruik uw beheerdersreferenties om zich aan te melden.
  2. Selecteer Omgevingen in de rechterbovenhoek.
  3. Selecteer in de lijst de omgeving waarin Dynamics 365 Project Operations is geinstalleerd.

Een oplossing maken

Volg deze stappen om een oplossingsbewuste stroom te maken. Door een oplossingsbewuste stroom te maken, kunt u de stroom gemakkelijker exporteren voor later gebruik.

  1. Selecteer in het navigatiedeelvenster de optie Oplossingen.
  2. Selecteer Nieuwe oplossing op de pagina Oplossingen.
  3. Stel in het dialoogvenster Nieuwe oplossing de vereiste velden in en selecteer vervolgens Maken.

Stap 1: Een Power Apps-trigger maken

  1. Selecteer op de pagina Oplossingen de oplossing die u hebt gemaakt en selecteer vervolgens Nieuw.
  2. Selecteer in het linkerdeelvenster de optie Cloudstromen>Automatisering>Cloudstroom>Direct.
  3. Voer in het veld Stroomnaam de waarde API-demostroom plannen in.
  4. Selecteer in de lijst Kiezen hoe deze stroom wordt geactiveerd de optie Power Apps. Wanneer u een Power Apps-trigger maakt, bepaalt u als auteur de logica. Laat voor het voorbeeld in dit artikel de invoerparameters leeg voor testdoeleinden.
  5. Selecteer Maken.

Stap 2: Een project maken

Voer deze stappen uit om een voorbeeldproject te maken.

  1. Selecteer in de stroom die u hebt gemaakt de optie Nieuwe stap.

    Een nieuwe stap toevoegen.

  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.

    Een bewerking selecteren.

  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.

    Een stap een andere naam geven.

  4. Geef de stap Project maken een nieuwe naam.

  5. Selecteer in het veld Actienaam de waarde msdyn_CreateProjectV1.

  6. Selecteer in het veld msdyn_subject de waarde Dynamische inhoud toevoegen.

  7. Voer op het tabblad Expressie in het functieveld de waarde concat('Project name - ',utcNow()) in.

  8. Selecteer OK.

Stap 3: Een variabele initialiseren voor het teamlid

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde variabele initialiseren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap Init teamlid.
  5. Voer in het veld Naam de tekst TeamMemberAction in.
  6. Selecteer in het veld Type de optie Tekenreeks.
  7. Voer msdyn_CreateTeamMemberV1 in het veld Waarde in.

Stap 4: Een algemeen teamlid maken

  1. Selecteer in de stroom de optie Nieuwe stap.

  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.

  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.

  4. De naam van de stap Teamlid maken wijzigen.

  5. Selecteer in het veld Actienaam de waarde TeamMemberAction in het dialoogvenster Dynamische inhoud.

  6. Voer in het veld Actieparameters de volgende parameterinformatie in.

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

    Hier volgt een uitleg van de parameters:

    • @@odata.type: de naam van de entiteit. Voer bijvoorbeeld "Microsoft.Dynamics.CRM.msdyn_projectteam" in.
    • msdyn_projectteamid: de primaire sleutel van de projectteam-id. De waarde is een GUID-expressie (Globally Unique Identifier). De id wordt gegenereerd op het tabblad Expressie.
    • msdyn_project@odata.bind – de project-id van het project dat eigenaar is. De waarde is dynamische inhoud die afkomstig is van de respons op de stap "Project maken". Zorg ervoor dat u het volledige pad invoert en voeg dynamische inhoud toe tussen de haakjes. Aanhalingstekens zijn verplicht. Voer bijvoorbeeld "/msdyn_projects(DYNAMISCHE INHOUD TOEVOEGEN)" in.
    • msdyn_name: de naam van het teamlid. Voer bijvoorbeeld "ScheduleAPIDemoTM1" in.

Stap 5: Een bewerkingsset maken

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap Bewerkingsset maken.
  5. Selecteer in het veld Actienaam de aangepaste Dataverse-actie msdyn_CreateOperationSetV1.
  6. Voer ScheduleAPIDemoOperationSet in het veld Beschrijving in.
  7. Selecteer in het veld Project uit het dialoogvenster Dynamische inhoud de waarde msdyn_CreateProjectV1Response ProjectId.

Stap 6: een variabele initialiseren voor de projectbucket-id

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde variabele initialiseren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap in Init projectbucket-id.
  5. Voer in het veld Naamprojectbucket-id in.
  6. Selecteer in het veld Type de optie Tekenreeks.
  7. Voer in het veld Waarde de waarde @{guid()} in.

Stap 7: Een projectbucket maken

  1. In de stroom selecteert u Een actie toevoegen.

  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.

  3. Selecteer in de stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.

  4. Geef de stap Bucket maken een nieuwe naam.

    1. Selecteer in het veld Actienaam de waarde msdyn_PssCreateV1.
  5. Voer in het veld Entiteit de volgende parameterinformatie in.

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

    Hier volgt een uitleg van de parameters:

    • @@odata.type: de naam van de entiteit. Voer bijvoorbeeld "Microsoft.Dynamics.CRM.msdyn_projectbucket" in.
    • msdyn_projectbucketid – De unieke id van de projectbucket. De waarde moet worden ingesteld vanuit de dynamische variabele uit stap 6.
    • msdyn_project@odata.bind – de project-id van het project dat eigenaar is. De waarde is dynamische inhoud die afkomstig is van de respons op de stap "Project maken". Zorg ervoor dat u het volledige pad invoert en voeg dynamische inhoud toe tussen de haakjes. Aanhalingstekens zijn verplicht. Voer bijvoorbeeld "/msdyn_projects(DYNAMISCHE INHOUD TOEVOEGEN)" in.
    • msdyn_name – de naam van de projectbucket.
  6. Selecteer voor het veld OperationSetId de waarde msdyn_CreateOperationSetV1Response OperationSetId in het dialoogvenster Dynamische inhoud.

Stap 8: Een variabele initialiseren voor het aantal taken

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde variabele initialiseren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap Init Aantal taken.
  5. Voer in het veld Naam de tekst aantal taken in.
  6. Selecteer in het veld Type de optie Geheel getal.
  7. Voer in het veld Waarde de waarde 5 in.

Stap 9: Een variabele initialiseren voor de projecttaak-id

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde variabele initialiseren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap Init ProjectTaskID.
  5. Voer in het veld Naam de waarde msdyn_projecttaskid in.
  6. Selecteer in het veld Type de optie Tekenreeks.
  7. Voer in het veld Waarde de waarde guid() in de opbouwfunctie voor expressies in.

Stap 10: Doen tot

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde doen tot in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Stel de eerste waarde in de voorwaardelijke instructie in op de variabele aantal taken in het dialoogvenster Dynamische inhoud.
  4. Stel de voorwaarde in op kleiner dan of gelijk aan.
  5. Stel de tweede waarde in de voorwaardelijke instructie in op 0.

Stap 11: Een projecttaak instellen

  1. In de stroom selecteert u Een actie toevoegen.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde variabele instellen in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de nieuwe stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap Projecttaak instellen.
  5. Selecteer msdyn_projecttaskid in het veld Naam.
  6. Voer in het veld Waarde de waarde guid() in de opbouwfunctie voor expressies in.

Stap 12: Een projecttaak maken

Volg deze stappen om een projecttaak te maken met een unieke id die hoort bij het huidige project en de projectbucket die u hebt gemaakt.

  1. Selecteer in de stroom de optie Nieuwe stap.

  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.

  3. Selecteer in de stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.

  4. Wijzig de naam van de stap Projecttaak maken.

  5. Selecteer in het veld Actienaam de waarde msdyn_PssCreateV1.

  6. Voer in het veld Entiteit de volgende parameterinformatie in.

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

    Hier volgt een uitleg van de parameters:

    • @@odata.type: de naam van de entiteit. Voer bijvoorbeeld "Microsoft.Dynamics.CRM.msdyn_projecttask" in.
    • msdyn_projecttaskid: de unieke id van de taak. De waarde moet worden ingesteld op een dynamische variabele van msdyn_projecttaskid.
    • msdyn_project@odata.bind – de project-id van het project dat eigenaar is. De waarde is dynamische inhoud die afkomstig is van de respons op de stap "Project maken". Zorg ervoor dat u het volledige pad invoert en voeg dynamische inhoud toe tussen de haakjes. Aanhalingstekens zijn verplicht. Voer bijvoorbeeld "/msdyn_projects(DYNAMISCHE INHOUD TOEVOEGEN)" in.
    • msdyn_subject: een willekeurige taaknaam.
    • msdyn_projectbucket@odata.bind: de projectbucket die de taken bevat. De waarde is gelijk aan die wordt gebruikt om de msdyn_projectbucketid in te stellen bij de stap 'Bucket maken'. Zorg ervoor dat u het volledige pad invoert en voeg dynamische inhoud toe tussen de haakjes. Aanhalingstekens zijn verplicht. Voer bijvoorbeeld "/msdyn_projectbuckets(DYNAMISCHE INHOUD TOEVOEGEN)" in.
    • msdyn_start: dynamische inhoud voor de begindatum. Morgen wordt bijvoorbeeld weergegeven als "addDays(utcNow(), 1)".
    • msdyn_scheduledstart: de geplande begindatum. Morgen wordt bijvoorbeeld weergegeven als "addDays(utcNow(), 1)".
    • msdyn_scheduleend: de geplande einddatum. Selecteer een datum in de toekomst. Geef bijvoorbeeld "addDays(utcNow(), 5)" op.
    • msdyn_LinkStatus: de koppelingsstatus. Voer bijvoorbeeld "192350000" in.
  7. Selecteer voor het veld OperationSetId de waarde msdyn_CreateOperationSetV1Response OperationSetId in het dialoogvenster Dynamische inhoud.

Stap 13: Een resourcetoewijzing maken

  1. In de stroom selecteert u Een actie toevoegen.

  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.

  3. Selecteer in de stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.

  4. Geef de stap Toewijzing maken een nieuwe naam.

  5. Selecteer in het veld Actienaam de waarde msdyn_PssCreateV1.

  6. Voer in het veld Entiteit de volgende parameterinformatie in.

    {
        "@@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']})"
    }
    
  7. Selecteer voor het veld OperationSetId de waarde msdyn_CreateOperationSetV1Response OperationSetId in het dialoogvenster Dynamische inhoud.

Stap 14: Een variabele verlagen

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde variabele verlagen in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in het veld Naam de tekst aantal taken.
  4. Voer in het veld Waarde de waarde 1 in.

Stap 15: De naam van een projecttaak wijzigen

  1. Selecteer in de stroom de optie Nieuwe stap.

  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.

  3. Selecteer in de stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.

  4. Wijzig de naam van de stap Naam van projecttaak wijzigen.

  5. Selecteer in het veld Actienaam de waarde msdyn_PssUpdateV1.

  6. Voer in het veld Entiteit de volgende parameterinformatie in.

    {
        "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projecttask",
        "msdyn_projecttaskid": "@{variables('msdyn_projecttaskid')}",
        "msdyn_subject": "ScheduleDemoTask1-UpdatedName"
    }
    
  7. Selecteer voor het veld OperationSetId de waarde msdyn_CreateOperationSetV1Response OperationSetId in het dialoogvenster Dynamische inhoud.

Stap 16: Een bewerkingsset uitvoeren

  1. Selecteer in de stroom de optie Nieuwe stap.
  2. Voer in het dialoogvenster Een bewerking kiezen de waarde niet-gebonden actie uitvoeren in. Selecteer daarna op het tabblad Acties de bewerking in de lijst met resultaten.
  3. Selecteer in de stap het beletselteken (...) en selecteer vervolgens Naam wijzigen.
  4. Wijzig de naam van de stap Bewerkingsset uitvoeren.
  5. Selecteer in het veld Actienaam de waarde msdyn_ExecuteOperationSetV1.
  6. Selecteer voor het veld OperationSetId de waarde msdyn_CreateOperationSetV1Response OperationSetId in het dialoogvenster Dynamische inhoud.

Verwijzingen