Teilen über

V1 Projektzeitplan-APIs mit Power Automate verwenden

  • Artikel

Gilt für: Project Operations für Ressourcen/nicht vorrätige Szenarien, Lite-Bereitstellung – Abwicklung der Proforma-Rechnungsstellung

Dieser Artikel beschreibt einen beispielhaften Flow, der zeigt, wie Sie einen vollständigen Projektplan mit Hilfe von Microsoft Power Automate erstellen, wie Sie ein Operation Set festlegen und wie Sie eine Entität aktualisieren. Das Beispiel zeigt, wie Sie ein Projekt, ein Projektteammitglied, Vorgangssätze, Projektaufgaben und Ressourcenzuweisungen erstellen. In diesem Artikel wird außerdem erläutert, wie Sie eine Entität aktualisieren und einen Operationssatz ausführen.

Das Beispiel in diesem Artikel verwendet die PssCreateV1-API. Ein Beispiel, das die PssCreateV2-API verwendet, finden Sie unter V2 Projektzeitplan-APIs mit Power Automate.

Hier ist eine vollständige Liste der Schritte, die im Beispiel-Flow in diesem Artikel dokumentiert sind:

  1. Erstellen eines Power Apps-Triggers
  2. Erstellen eines Projekts
  3. Initialisieren einer Variable für das Teammitglied
  4. Erstellen eines generischen Teammitglieds
  5. Einen Optionssatz erstellen
  6. Initialisieren einer Variable für die Projekt-Bucket-Kennung
  7. Einen Projekt-Bucket erstellen
  8. Initialisieren einer Variable für die Anzahl der Aufgaben
  9. Initialisieren einer Variable für die Projektaufgabenkennung
  10. Erledigen bis
  11. Eine Projektaufgabe festlegen
  12. Eine Aufgaben erstellen
  13. Eine Ressourcenzuweisung erstellen
  14. Eine Variable verringern
  15. Eine Projektaufgabe umbenennen
  16. Einen Optionssatz ausführen

Voraussetzungen

Dieser Artikel setzt voraus, dass Sie über grundlegende Kenntnisse der Dataverse-Plattform, der Cloud-Flows und der Projektplanungs-API verfügen. Weitere Informationen finden Sie im Abschnitt Referenzen weiter unten in diesem Artikel.

Workflow erstellen

Umgebung auswählen

Sie können den Power Automate-Flow in Ihrer Umgebung erstellen.

  1. Gehen Sie zu https://flow.microsoft.com und verwenden Sie Ihre Administrator-Anmeldeinformationen, um sich anzumelden.
  2. Wählen Sie oben rechts Umgebungen aus.
  3. Wählen Sie in der Liste die Umgebung aus, in der Dynamics 365 Project Operations installiert ist.

Lösung erstellen

Mithilfe der folgenden Anleitung können Sie einen lösungsfähigen Flow erstellen. Indem Sie einen lösungsorientierten Flow erstellen, können Sie den Flow einfacher exportieren, um ihn später zu verwenden.

  1. Wählen Sie im Navigationsbereich Lösungen aus.
  2. Wählen Sie auf der Seite Lösungen die Option Neue Lösung aus.
  3. Legen Sie im Dialogfeld Neue Lösung die erforderlichen Felder fest, und wählen Sie dann Erstellen.

Schritt 1: Einen Power Apps-Trigger erstellen

  1. Wählen Sie auf der Seite Lösungen die Lösung aus, die Sie erstellt haben, und wählen Sie dann Neu.
  2. Wählen Sie im linken Bereich Cloud-Flows>Automatisierung>Cloud-Flow>Sofort.
  3. Geben Sie im Flow-Name-Feld API-Demo-Flow planen ein.
  4. In der Liste Trigger für diesen Flow auswählen wählen Sie Power Apps aus. Beim Erstellen eines Power Apps-Triggers liegt die Logik bei Ihnen als Autor. Lassen Sie für das Beispiel in diesem Artikel die Eingabeparameter zu Testzwecken leer.
  5. Wählen Sie Erstellen.

Schritt 2: Ein Projekt erstellen

Führen Sie diese Schritte aus, um ein Beispielprojekt zu erstellen.

  1. Wählen Sie in dem von Ihnen erstellten Flow Neuer Schritt.

    Hinzufügen eines neuen Schritts

  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.

    Auswählen eines Vorgangs

  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.

    Umbenennen eines Schritts

  4. Benennen Sie den Schritt in Projekt erstellen um.

  5. Wählen Sie im Feld Aktionsnamemsdyn_CreateProjectV1 aus.

  6. Im msdyn_subject-Feld wählen Sie Dynamische Inhalte hinzufügen.

  7. Geben Sie auf der Registerkarte Ausdruck im Funktionsfeld concat('Project name - ',utcNow()) ein.

  8. Wählen Sie OK aus.

Schritt 3: Initialisieren einer Variable für das Teammitglied

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Variable initialisieren ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Mitglied des Init-Teams um.
  5. Geben Sie im Feld Name den Text TeamMemberAction ein.
  6. Wählen Sie im Feld TypZeichenfolge aus.
  7. Geben Sie im Feld Wertmsdyn_CreateTeamMemberV1 ein.

Schritt 4: Ein generisches Teammitglied erstellen

  1. Wählen Sie im Flow Neuer Schritt.

  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.

  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.

  4. Benennen Sie den Schritt in Teammitglied erstellen um.

  5. Im Aktionsname-Feld wählen Sie TeamMemberAction in der Dynamische Inhalte-Dialogbox.

  6. Im Aktionsparameter-Feld geben Sie die folgenden Parameterinformationen ein.

    {
    "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 finden Sie eine Erklärung der Parameter:

    • @@odata.type – der Entitätstypname. Geben Sie beispielsweise „Microsoft.Dynamics.CRM.msdyn_projectteam“ ein.
    • msdyn_projectteamid – der Primärschlüssel der Projektteam-ID. Der Wert ist eine Globally Unique Identifier- bzw. GUID-Ausdruck. Die ID wird aus der Registerkarte „Ausdruck“ generiert.
    • msdyn_project@odata.bind – Die Projekt-ID des besitzenden Projekts. Der Wert ist dynamischer Inhalt, der aus der Antwort des Schritts „Projekt erstellen“ stammt. Stellen Sie sicher, dass Sie den vollständigen Pfad eingeben und dynamische Inhalte zwischen den Klammern hinzufügen. Anführungszeichen sind erforderlich. Geben Sie beispielsweise „/msdyn_projects(DYNAMISCHEN INHALT HINZUFÜGEN)“ ein.
    • msdyn_name – Der Name des Teammitglieds. Geben Sie zum Beispiel "ScheduleAPIDemoTM1" ein.

Schritt 5: Einen Optionssatz erstellen

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Operationsset erstellen um.
  5. Im Aktionsname-Feld wählen Sie die benutzerdefinierte Dataverse-Aktion msdyn_CreateOperationSetV1 aus.
  6. Geben Sie im Feld ZuordnungsdemoScheduleAPIDemoOperationSet ein.
  7. Wählen Sie im Feld Projekt aus dem Dialogfeld Dynamischer Inhaltmsdyn_CreateProjectV1Response ProjectId aus.

Schritt 6: Initialisieren einer Variable für die Projekt-Bucket-Kennung

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Variable initialisieren ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Projekt-Bucket-Kennung initialisieren um.
  5. Geben Sie im Feld Name den Text Projekt-Bucket-Kennung ein.
  6. Wählen Sie im Feld TypZeichenfolge aus.
  7. Geben Sie im Feld Wert@{guid()} ein.

Schritt 7: Einen Projekt-Bucket erstellen

  1. Wählen Sie im Flow Aktion hinzufügen aus.

  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.

  3. In dem Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.

  4. Benennen Sie den Schritt in Bucket erstellen um.

    1. Wählen Sie im Feld Aktionsnamemsdyn_PssCreateV1 aus.

  6. Im Entität-Feld geben Sie die folgenden Parameterinformationen ein.

    {
    "@@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 finden Sie eine Erklärung der Parameter:

    • @@odata.type – der Entitätstypname. Geben Sie beispielsweise Microsoft.Dynamics.CRM.msdyn_projectbucket ein.
    • msdyn_projectbucketid – Die eindeutige Kennung des Projekt-Buckets. Der Wert sollte auf die dynamische Variable aus Schritt 6 gesetzt werden.
    • msdyn_project@odata.bind – Die Projekt-ID des besitzenden Projekts. Der Wert ist dynamischer Inhalt, der aus der Antwort des Schritts „Projekt erstellen“ stammt. Stellen Sie sicher, dass Sie den vollständigen Pfad eingeben und dynamische Inhalte zwischen den Klammern hinzufügen. Anführungszeichen sind erforderlich. Geben Sie beispielsweise „/msdyn_projects(DYNAMISCHEN INHALT HINZUFÜGEN)“ ein.
    • msdyn_name – Der Name des Projekt-Buckets.

  7. Geben Sie im Feld OperationSetIdmsdyn_CreateOperationSetV1Response OperationSetId im Dialogfeld Dynamischer Inhalt ein.

Schritt 8: Initialisieren einer Variable für die Anzahl der Aufgaben

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Variable initialisieren ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Anzahl der Aufgaben initialisieren um.
  5. Geben Sie im Feld Name den Text Anzahl der Aufgaben ein.
  6. Wählen Sie im Feld Typ den Wert Ganzzahl aus.
  7. Geben Sie im Feld Wert die Zahl 5 ein.

Schritt 9: Initialisieren einer Variable für die Projektaufgabenkennung

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Variable initialisieren ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Init ProjectTaskID um.
  5. Geben Sie im Feld Name den Wert msdyn_projecttaskid ein.
  6. Wählen Sie im Feld TypZeichenfolge aus.
  7. Im Wert-Feld geben Sie guid() im Ausdrucks-Generator ein.

Schritt 10: Erledigen bis

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Erledigen bis ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. Legen Sie den ersten Wert in der bedingten Anweisung auf die Anzahl der Aufgaben-Variable aus der Dynamische Inhalte-Dialogbox fest.
  4. Legen Sie die Bedingung auf kleiner oder gleich fest.
  5. Setzen Sie den zweiten Wert in der bedingten Anweisung auf 0.

Schritt 11: Eine Projektaufgabe festlegen

  1. Wählen Sie im Flow Aktion hinzufügen aus.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Variable festlegen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem neuen Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Projektaufgabe festlegen um.
  5. Wählen Sie im Name-Feld msdyn_projecttaskid aus.
  6. Im Wert-Feld geben Sie guid() im Ausdrucks-Generator ein.

Schritt 12: Eine Projektaufgabe erstellen

Befolgen Sie diese Schritte, um eine Projektaufgabe mit einer eindeutigen ID zu erstellen, die zum aktuellen Projekt und dem von Ihnen erstellten Projekt-Bucket gehört.

  1. Wählen Sie im Flow Neuer Schritt.

  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.

  3. In dem Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.

  4. Benennen Sie den Schritt in Projektaufgabe erstellen um.

  5. Wählen Sie im Feld Aktionsnamemsdyn_PssCreateV1 aus.

  6. Im Entität-Feld geben Sie die folgenden Parameterinformationen ein.

    {
    "@@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 finden Sie eine Erklärung der Parameter:

    • @@odata.type – der Entitätstypname. Geben Sie beispielsweise „Microsoft.Dynamics.CRM.msdyn_projecttask“ ein.
    • msdyn_projecttaskid – die eindeutige ID der Aufgabe. Der Wert sollte auf eine dynamische Variable von msdyn_projecttaskid gesetzt werden.
    • msdyn_project@odata.bind – Die Projekt-ID des besitzenden Projekts. Der Wert ist dynamischer Inhalt, der aus der Antwort des Schritts „Projekt erstellen“ stammt. Stellen Sie sicher, dass Sie den vollständigen Pfad eingeben und dynamische Inhalte zwischen den Klammern hinzufügen. Anführungszeichen sind erforderlich. Geben Sie beispielsweise „/msdyn_projects(DYNAMISCHEN INHALT HINZUFÜGEN)“ ein.
    • msdyn_subject – beliebiger Aufgabenname.
    • msdyn_projectbucket@odata.bind– der Projekt-Bucket, der die Aufgaben enthält. Der Wert ist derselbe, der zum Festlegen von msdyn_projectbucketid im Schritt „Bucket erstellen“ verwendet wird. Stellen Sie sicher, dass Sie den vollständigen Pfad eingeben und dynamische Inhalte zwischen den Klammern hinzufügen. Anführungszeichen sind erforderlich. Geben Sie beispielsweise „/msdyn:projectbuckets(DYNAMISCHEN INHALT HINZUFÜGEN)“ ein.
    • msdyn_start – dynamische Inhalte für das Startdatum. Beispielsweise wird der nächste Tag als „addDays(utcNow(), 1)“ dargestellt.
    • msdyn_scheduledstart – das eingeplante Startdatum. Beispielsweise wird der nächste Tag als „addDays(utcNow(), 1)“ dargestellt.
    • msdyn_scheduleend – Das geplante Enddatum. Wählen Sie ein Datum in der Zukunft aus. Geben Sie zum Beispiel "addDays(utcNow(), 5)" an.
    • msdyn_LinkStatus – der Linkstatus. Geben Sie z. B. "192350000" ein.

  7. Geben Sie im Feld OperationSetIdmsdyn_CreateOperationSetV1Response OperationSetId im Dialogfeld Dynamischer Inhalt ein.

Schritt 13: Erstellen einer Ressourcenzuweisung

  1. Wählen Sie im Flow Aktion hinzufügen aus.

  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.

  3. In dem Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.

  4. Benennen Sie den Schritt in Zuweisung erstellen um.

  5. Wählen Sie im Feld Aktionsnamemsdyn_PssCreateV1 aus.

  6. Im Entität-Feld geben Sie die folgenden Parameterinformationen ein.

    {
    "@@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. Geben Sie im Feld OperationSetIdmsdyn_CreateOperationSetV1Response OperationSetId im Dialogfeld Dynamischer Inhalt ein.

Schritt 14: Eine Variable verringern

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld Variable verringern ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. Wählen Sie im Feld Name den Text Anzahl der Aufgaben aus.
  4. Geben Sie im Feld Wert die Zahl 1 ein.

Schritt 15: Eine Projektaufgabe umbenennen

  1. Wählen Sie im Flow Neuer Schritt.

  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.

  3. In dem Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.

  4. Benennen Sie den Schritt in Projektaufgabe umbenennen um.

  5. Wählen Sie im Feld Aktionsnamemsdyn_PssUpdateV1 aus.

  6. Im Entität-Feld geben Sie die folgenden Parameterinformationen ein.

    {
    "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projecttask",
    "msdyn_projecttaskid": "@{variables('msdyn_projecttaskid')}",
    "msdyn_subject": "ScheduleDemoTask1-UpdatedName"
}

  7. Geben Sie im Feld OperationSetIdmsdyn_CreateOperationSetV1Response OperationSetId im Dialogfeld Dynamischer Inhalt ein.

Schritt 16: Einen Optionssatz ausführen

  1. Wählen Sie im Flow Neuer Schritt.
  2. Geben Sie im Dialogfeld Vorgang auswählen im Suchfeld ungebundene Aktion ausführen ein. Wählen Sie dann auf der Aktionen-Registerkarte die Operation in der Ergebnisliste aus.
  3. In dem Schritt wählen Sie die Ellipse (...) und dann Umbenennen aus.
  4. Benennen Sie den Schritt in Operationsset ausführen um.
  5. Wählen Sie im Feld Aktionsnamemsdyn_ExecuteOperationSetV1 aus.
  6. Geben Sie im Feld OperationSetIdmsdyn_CreateOperationSetV1Response OperationSetId im Dialogfeld Dynamischer Inhalt ein.

Referenzen