使用 V2 專案排程 API 與 Power Automate

發行項
10/11/2023

適用於：資源/非庫存型案例適用的 Project Operations、精簡部署 - 交易至開立預估發票

本文說明的範例流程示範使用 Microsoft Power Automate 建立完整專案計劃、建立作業集和更新實體的方法。此範例顯示如何建立專案、專案團隊成員、作業集、專案工作和資源指派。本文還說明如何更新實體以及執行作業集。

本文中的範例使用 PssCreateV2 API。如需使用 PssCreateV1 API 的範例，請參閱將 V1 專案排程 API 與 Power Automate 搭配使用。

以下是本文範例流程中所記載步驟的完整清單：

建立PowerApps 觸發程式
建立專案
初始化團隊成員的變數
建立一般團隊成員
建立作業集
建立專案貯體
初始化工作數目的變數
初始化專案工作識別碼的變數
初始化陣列
執行直到
設定專案工作
將工作新增至陣列
建立資源指派
遞減變數
將工作和指派新增至作業集
執行作業集

假設

本文假設您具備 Dataverse 平台、雲端流程及專案排程 API 的基本知識。如需詳細資訊，請參閱本文稍後的參考資料。

建立流程

選取環境

您可以在環境中建立 Power Automate 流程。

前往 https://flow.microsoft.com，並使用系統管理員認證登入。
在右上角選取環境。
在清單中，選取已安裝 Dynamics 365 Project Operations 的環境。

建立解決方案

依照這些步驟建立解決方案感知流程。您可以建立有解決方案感知流程，更輕鬆地匯出流程以供日後使用。

在瀏覽窗格中，選取解決方案。
在解決方案頁面上，選取新增解決方案。
在新增解決方案對話方塊中，設定必要的欄位，然後選取建立。

步驟 1：建立 PowerApps 觸發程序

在解決方案頁面上，選取您所建立的解決方案，然後選取新增。
在左窗格中，選取雲端流程>自動化>雲端流程>即時。
在流程名稱欄位中，輸入排程 API 示範流程。
在選擇觸發此流程的方式清單中，選取 Power Apps。建立 Power Apps 觸發程序時，邏輯取決於身為作者的您。對於本文中的範例，讓輸入參數保持空白以進行測試。
選取建立。

步驟 2：建立專案

依照下列步驟建立建立範例專案。

在您建立的流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入執行未繫結動作。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為建立專案。
在動作名稱欄位中，選取 msdyn_CreateProjectV1。
在 msdyn_subject 欄位底下，選取新增動態內容。
在運算式索引標籤的函數欄位中，輸入 concat('Project name - ',utcNow())。
選取確定。

步驟 3：初始化團隊成員的變數

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入初始化變數。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為初始化團隊成員。
在名稱欄位中，輸入 TeamMemberAction。
在類型欄位中，選取字串。
在值欄位中，輸入 msdyn_CreateTeamMemberV1。

步驟 4：建立一般團隊成員

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入執行未繫結動作。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為建立團隊成員。
在動作名稱欄位的動態內容 對話方塊中，選取 TeamMemberAction。
在動作參數欄位中，輸入下列參數資訊。
```
{
    "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 – 專案團隊識別碼的主索引鍵。此值是全域唯一識別碼 (GUID) 運算式。此識別碼是從運算式索引標籤中產生。
- msdyn_project@odata.bind – 所屬專案的專案識別碼。此值是來自「建立專案」步驟回應中的動態內容。確定您已輸入完整路徑，並在括弧之間加入動態內容。需要引號。例如，輸入 "/msdyn_projects(ADD DYNAMIC CONTENT)"。
- msdyn_name – 團隊成員的名稱。例如，輸入 "ScheduleAPIDemoTM1"。

步驟 5：建立作業集

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入執行未繫結動作。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為建立作業集。
在動作名稱欄位中，選取 msdyn_CreateOperationSetV1 Dataverse 自訂動作。
在描述欄位中，輸入 ScheduleAPIDemoOperationSet。
對於專案欄位，選取動態內容對話方塊中的 msdyn_CreateProjectV1Response ProjectId。

步驟 6：建立專案貯體

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入新增資料列。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為建立貯體。
在資料表名稱欄位中，選取專案貯體。
在名稱欄位中，輸入 ScheduleAPIDemoBucket1。
在專案欄位中，輸入 /msdyn_projects(。
在動態內容對話方塊中，選取 msdyn_CreateProjectV1Response ProjectId。
在專案欄位中，輸入 )。

步驟 7：初始化工作數目的變數

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入初始化變數。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為初始化工作數目。
在名稱欄位中，輸入工作數目。
在類型欄位中，選取整數。
在值欄位中，輸入 5。

步驟 8：初始化專案工作識別碼的變數

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入初始化變數。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為Init ProjectTaskID。
在名稱欄位中，輸入 msdyn_projecttaskid。
在類型欄位中，選取字串。
在值欄位的運算式產生器中，輸入 guid()。

步驟 9：初始化陣列

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入初始化變數。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為初始化陣列。
在名稱欄位中，輸入工作和指派。
在類型欄位中，選取陣列。

步驟 10：執行直到

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入執行直到。然後，在動作索引標籤上，選取結果清單中的作業。
將條件陳述式中的第一個值設定為動態內容對話方塊中的工作數目變數。
將條件設定為小於等於。
將條件陳述式中的第二個值設定為0。

步驟 11：設定專案工作

在流程中，選取新增動作。
在選擇作業對話方塊的搜尋欄位中，輸入設定變數。然後，在動作索引標籤上，選取結果清單中的作業。
在新的步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為設定專案工作。
在名稱欄位中，選取 msdyn_projecttaskid。
在值欄位的運算式產生器中，輸入 guid()。

步驟 12：將工作新增至陣列

在流程中，選取新增動作。
在選擇作業對話方塊的搜尋欄位中，輸入附加至陣列。
在步驟中，選取省略符號 (…)，然後選取重新命名。
重新命名步驟將工作新增至陣列。
在名稱欄位中，選取工作和指派。
在值欄位中，輸入下列參數資訊。
```
{
    "@@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"
}
```
以下是參數的說明：
- @@odata.type – 實體名稱。例如，輸入 "Microsoft.Dynamics.CRM.msdyn_projecttask"。
- msdyn_projecttaskid – 工作的唯一識別碼。此值應設定為 msdyn_projecttaskid 中的動態變數。
- msdyn_project@odata.bind – 所屬專案的專案識別碼。此值是來自「建立專案」步驟回應中的動態內容。確定您已輸入完整路徑，並在括弧之間加入動態內容。需要引號。例如，輸入 "/msdyn_projects(ADD DYNAMIC CONTENT)"。
- msdyn_subject – 任何工作名稱。
- msdyn_projectbucket@odata.bind – 包含工作的專案貯體。此值是來自「建立貯體」步驟回應中的動態內容。確定您已輸入完整路徑，並在括弧之間加入動態內容。需要引號。例如，輸入 "/msdyn_projectbuckets(ADD DYNAMIC CONTENT)"。
- msdyn_start – 開始日期的動態內容。例如，將明天表示為 "addDays(utcNow(), 1)"。
- msdyn_scheduledstart – 排定的開始日期。例如，將明天表示為 "addDays(utcNow(), 1)"。
- msdyn_scheduleend – 排定的結束日期。選取未來的日期。例如，指定 "addDays(utcNow(), 5)"。
- msdyn_LinkStatus – 帳單設定的連結。例如，輸入 "192350000" (若無帳單設定連結) 或 "192350001" (若已連結帳單設定)。

步驟 13：建立資源指派

在流程中，選取新增動作。
在選擇作業對話方塊的搜尋欄位中，輸入附加至陣列。
在步驟中，選取省略符號 (…)，然後選取重新命名。
重新命名步驟將指派新增至陣列。
在名稱欄位中，選取工作和指派。

在值欄位中，輸入下列參數資訊。

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

步驟 14：遞減變數

在流程中，選取新增動作。
在選擇作業對話方塊的搜尋欄位中，輸入遞減變數。然後，在動作索引標籤上，選取結果清單中的作業。
在名稱欄位中，選取工作數目。
在值欄位中，輸入 1。

步驟 15：將工作和指派新增至作業集

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入執行未繫結動作。然後，在動作索引標籤上，選取結果清單中的作業。
在步驟中，選取省略符號 (…)，然後選取重新命名。
重新命名步驟將工作和指派新增至作業集。
在動作名稱欄位中，選取 msdyn_PssCreateV2。
對於 OperationSetId 欄位，選取動態內容對話方塊中的 msdyn_CreateOperationSetV1Response OperationSetId。
在 EntityCollection 欄位中，選取將輸入切換為整個陣列。
對於 EntityCollection 欄位，選取動態內容對話方塊中的工作和指派。

步驟 16：執行作業集

在流程中，選取新增步驟。
在選擇作業對話方塊的搜尋欄位中，輸入執行未繫結動作。然後，在動作索引標籤上，選取結果清單中的作業。
在步驟中，選取省略符號 (…)，然後選取重新命名。
將步驟重新命名為執行作業集。
在動作名稱欄位中，選取 msdyn_ExecuteOperationSetV1。
對於 OperationSetId 欄位，選取動態內容對話方塊中的 msdyn_CreateOperationSetV1Response OperationSetId。

共用方式為