Share via

Power Automate で V1 プロジェクト スケジュール API を使用する

  • [アーティクル]

適用対象: リソース/非在庫ベースのシナリオに使用する Project Operations、見積請求に対応する小規模の展開

この記事では、Microsoft Power Automate を使用して完全なプロジェクト計画を作成する方法、操作セットを作成する方法、およびエンティティを更新する方法を示すサンプル フローについて説明しています。 この例は、プロジェクト、プロジェクトチームのメンバー、操作セット、プロジェクト タスク、リソースの割り当てを作成する方法を示しています。 この記事では、エンティティを更新して操作セットを実行する方法についても説明しています。

この記事の例では、PssCreateV1 API を使用します。 PssCreateV2 API を使用する例については、Power Automate での V2 プロジェクト スケジュール API を参照してください。

この記事のサンプル フローに記載されているステップの完全なリストを次に示します:

  1. Power Apps トリガーの作成
  2. プロジェクトの作成
  3. チーム メンバーの変数を初期化する
  4. 汎用チーム メンバーの作成
  5. 操作セットの作成
  6. プロジェクト バケット ID の変数を初期化する
  7. プロジェクト バケットの作成
  8. タスクの数の変数を初期化する
  9. プロジェクト タスク ID の変数を初期化する
  10. 終点
  11. プロジェクト タスクを設定する
  12. プロジェクト タスクを作成する
  13. リソース割り当てを作成する
  14. 変数を減らす
  15. プロジェクト タスクの名前を変更する
  16. 操作セットの実行

前提条件

この記事では、Dataverse プラットフォーム、クラウド フロー、プロジェクト スケジュール API の基本的な知識があることを前提としています。 詳細については、この記事の後にある 参照 セクションをご覧ください。

フローの作成

環境を選択する

自分の環境で、Power Automate フローを作成できます。

  1. https://flow.microsoft.com に移動し、管理者資格情報を使用してサインインします。
  2. 右上隅で、環境 を選択します。
  3. 一覧から、Dynamics 365 Project Operations がインストールされている環境を選択します。

ソリューションの作成

次のステップに従って、ソリューション対応フロー を作成します。 ソリューション対応フローを作成することにより、フローをより簡単にエクスポートして後で使用することができます。

  1. ナビゲーション ウィンドウで ソリューション を選択します。
  2. ソリューション ページで、新しいソリューション を選択します。
  3. 新規ソリューション ダイアログ ボックスで、必須フィールドを設置して、作成 を選択します。

ステップ 1: Power Apps トリガーを作成する

  1. ソリューション ページで、作成したマイ自動化ソリューションを選択して、新規 を選択します。
  2. 左ペインで、クラウド フロー>オートメーション>クラウド フロー>インスタント を選択します。
  3. フロー名 フィールドで、API デモ フローのスケジュール を入力します。
  4. このフローをトリガーする方法を選択 リストで、Power Apps を選択します。 Power Apps トリガーを作成する時、ロジックは作成者としてのあなた次第です。 この記事の例では、テストのために入力パラメーターを空白のままにします。
  5. 作成 を選択します。

手順2 : プロジェクトの作成

これらのステップに従って、サンプル プロジェクトを作成します。

  1. 作成したフローで、新規ステップ を選択します。

    新しいステップを追加します。

  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。

    操作の選択

  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。

    ステップの名前変更

  4. ステップの名前を タスクの作成 に変更します。

  5. アクション名 フィールドで、msdyn_CreateProjectV1 を選択します。

  6. msdyn_subject フィールドで、動的コンテンツを追加する を選択します。

  7. Expression タブの機能フィールドで、concat('Project name - ',utcNow()) を入力します。

  8. OK を選びます。

ステップ 3: チーム メンバーの変数を初期化する

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、変数を初期化する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. このステップ Init チーム メンバー の名前を変更します。
  5. 名前 フィールドで、TeamMemberAction と入力します。
  6. タイプ フィールドで、文字列 を選択します。
  7. 値 フィールドに、msdyn_CreateTeamMemberV1 と入力します。

ステップ 4: 汎用プロジェクトチームメンバーを作成する

  1. フローで、新規ステップ を選択します。

  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。

  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。

  4. このステップ Init チーム メンバー の名前を変更します。

  5. アクション名 フィールドで、動的コンテンツ ダイアログ ボックスで TeamMemberAction を選択します。

  6. アクション パラメータ フィールドに、次のパラメータ情報を入力します。

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

    パラメーターの説明を以下に示します:

    • @@odata.type – エンティティ名。 たとえば、"Microsoft.Dynamics.CRM.msdyn_projectteam" と入力します。
    • msdyn_projectteamid – プロジェクト チーム ID の主キー。 この値は、グローバル一意識別子 (GUID) 式です。 この ID は、式タブから生成されます。
    • msdyn_project@odata.bind – 所有するプロジェクトのプロジェクト ID。 この値は、"プロジェクトの作成" ステップの応答から得られる動的コンテンツになります。 必ずフル パスを入力し、括弧の間に動的コンテンツを追加してください。 引用符が必要です。 たとえば、"/msdyn_projects(ADD DYNAMIC CONTENT)" と入力します。
    • msdyn‑name – チームメンバーの名前。 たとえば、"ScheduleAPIDemoTM1" と入力します。

ステップ 5: 操作セットの作成

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. ステップ 操作セットの作成 の名前を変更します。
  5. アクション名 フィールドで、msdyn_CreateOperationSetV1 Dataverse カスタム アクションを選択します。
  6. 説明 フィールドに、ScheduleAPIDemoOperationSet と入力します。
  7. プロジェクト フィールドに対して、動的コンテンツ ダイアログボックスで msdyn_CreateProjectV1Response ProjectId を選択します。

ステップ 6: プロジェクト バケット ID の変数を初期化する

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、変数を初期化する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. ステップ プロジェクト バケット ID を初期化する の名前を変更します。
  5. 名前 フィールドで、project bucket id と入力します。
  6. タイプ フィールドで、文字列 を選択します。
  7. 数値フィールドに、@{guid()} と入力します。

ステップ 7: プロジェクト バケットを生成する

  1. フローで、アクションの追加 を選択します。

  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。

  3. ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。

  4. ステップ バケットの作成 の名前を変更します。

    1. アクション名 フィールドで、msdyn_PssCreateV1 を選択します。

  6. エンティティ フィールドに、次のパラメータ情報を入力します。

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

    パラメーターの説明を以下に示します:

    • @@odata.type – エンティティ名。 例えば、Microsoft.Dynamics.CRM.msdyn_projectbucket と入力します。
    • msdyn_projectbucketid – プロジェクト バケットの一意の ID。 この値は ステップ 6 からの動的変数に設定する必要があります。
    • msdyn_project@odata.bind – 所有するプロジェクトのプロジェクト ID。 この値は、"プロジェクトの作成" ステップの応答から得られる動的コンテンツになります。 必ずフル パスを入力し、括弧の間に動的コンテンツを追加してください。 引用符が必要です。 たとえば、"/msdyn_projects(ADD DYNAMIC CONTENT)" と入力します。
    • msdyn_name – プロジェクト バケットの名前。

  7. OperationSetId フィールドに対して、動的コンテンツ ダイアログ ボックスで msdyn_CreateOperationSetV1Response OperationSetId を選択します。

ステップ 8: タスク数の変数を初期化する

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、変数を初期化する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. ステップの名 タスク数の初期化 の名前を変更します。
  5. 名前 フィールドで、タスク数 と入力します。
  6. タイプ フィールドで、整数 を選択します。
  7. 数値フィールドに、5 と入力します。

ステップ 9: プロジェクト タスク ID の変数を初期化する

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、変数を初期化する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. ステップ Init ProjectTaskID の名前を変更します。
  5. 名前 フィールドで、msdyn_projecttaskid と入力します。
  6. タイプ フィールドで、文字列 を選択します。
  7. 値 フィールドに対して、式ビルダーに guid() と入力します。

ステップ 10: 終点

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、終点 と入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 条件文の最初の値を 動的コンテンツ ダイアログ ボックスからの タスクの数 変数に設定します。
  4. 条件を 以下 にセットします。
  5. 条件ステートメントの 2 番目の値を 0 に設定します。

ステップ 11: プロジェクト タスクを設定する

  1. フローで、アクションの追加 を選択します。
  2. 操作の選択 ダイアログ ボックスで、検索フィールドに、変数を設定 を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 新規ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. ステップ プロジェクト タスクの設定 の名前を変更します。
  5. 名前 フィールドで msdyn_projecttaskid を選択します。
  6. 値 フィールドに対して、式ビルダーに guid() と入力します。

ステップ 12: プロジェクト タスクを生成する

次のステップに従って、現在のプロジェクトと作成したプロジェクトバケットに属する一意の ID を持つプロジェクト タスクを作成します。

  1. フローで、新規ステップ を選択します。

  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。

  3. ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。

  4. ステップ プロジェクト タスクの作成 の名前を変更します。

  5. アクション名 フィールドで、msdyn_PssCreateV1 を選択します。

  6. エンティティ フィールドに、次のパラメータ情報を入力します。

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

    パラメーターの説明を以下に示します:

    • @@odata.type – エンティティ名。 たとえば、"Microsoft.Dynamics.CRM.msdyn_projecttask" と入力します。
    • msdyn_projecttaskid – タスクの一意の ID。 この値は msdyn_projecttaskid からの動的変数に設定する必要があります。
    • msdyn_project@odata.bind – 所有するプロジェクトのプロジェクト ID。 この値は、"プロジェクトの作成" ステップの応答から得られる動的コンテンツになります。 必ずフル パスを入力し、括弧の間に動的コンテンツを追加してください。 引用符が必要です。 たとえば、"/msdyn_projects(ADD DYNAMIC CONTENT)" と入力します。
    • msdyn_subject – 任意のタスク名。
    • msdyn_projectbucket@odata.bind – タスクを含むプロジェクト バケット。 この値は、「バケットの作成」ステップで msdyn_projectbucketid を設定するために使用したものと同じです。 必ずフル パスを入力し、括弧の間に動的コンテンツを追加してください。 引用符が必要です。 たとえば、"/msdyn_projectbuckets(ADD DYNAMIC CONTENT)" と入力します。
    • msdyn_start – 開始日の動的コンテンツ。 たとえば、明日は "addDays(utcNow(), 1)" のように表されます。
    • msdyn_scheduledstart – スケジュールされた開始日。 たとえば、明日は "addDays(utcNow(), 1)" のように表されます。
    • msdyn_scheduleend – スケジュールされた終了日。 将来の日付を選択します。 たとえば、"addDays(utcNow(), 5)" を指定します。
    • msdyn_LinkStatus – リンクのステータス。 たとえば、"192350000" と入力します。

  7. OperationSetId フィールドに対して、動的コンテンツ ダイアログ ボックスで msdyn_CreateOperationSetV1Response OperationSetId を選択します。

ステップ 13: リソース割り当てを作成する

  1. フローで、アクションの追加 を選択します。

  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。

  3. ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。

  4. このステップ 割り当ての作成 の名前を変更します。

  5. アクション名 フィールドで、msdyn_PssCreateV1 を選択します。

  6. エンティティ フィールドに、次のパラメータ情報を入力します。

    {
    "@@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. OperationSetId フィールドに対して、動的コンテンツ ダイアログ ボックスで msdyn_CreateOperationSetV1Response OperationSetId を選択します。

ステップ 14: 変数を減らす

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、変数を減らす を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. 名前 フィールドで、タスク数 を選択します。
  4. 数値フィールドに、1 と入力します。

ステップ 15: プロジェクト タスクの名前を変更する

  1. フローで、新規ステップ を選択します。

  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。

  3. ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。

  4. ステップ プロジェクト タスクの名前を変更する の名前を変更します。

  5. アクション名 フィールドで、msdyn_PssUpdateV1 を選択します。

  6. エンティティ フィールドに、次のパラメータ情報を入力します。

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

  7. OperationSetId フィールドに対して、動的コンテンツ ダイアログ ボックスで msdyn_CreateOperationSetV1Response OperationSetId を選択します。

ステップ 16: 操作セットの実行

  1. フローで、新規ステップ を選択します。
  2. 操作を選択する ダイアログ ボックスで、検索フィールドに、アンバウンド アクションを実行する を入力します。 次に、アクション タブで、結果のリストから操作を選択します。
  3. ステップで省略記号 (…) を選択し、次に 名前の変更 を選択します。
  4. ステップ 操作セットの実行 の名前を変更します。
  5. アクション名 フィールドで、msdyn_ExecuteOperationSetV1 を選択します。
  6. OperationSetId フィールドに対して、動的コンテンツ ダイアログ ボックスで msdyn_CreateOperationSetV1Response OperationSetId を選択します。

参照