匯出專案內容定義
頁面描述使用 ExportProjectContent 工具時 JSON 的輸出格式和定義。
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| /專案 | JSONObject | 專案層級值 |
| /project/fields | JSONArray | 專案層級屬性的定義 |
| /project/assignments | JSONArray | 指派及其值的清單 |
| /project/assignments/fields | JSONArray | 指派屬性的定義 |
| /project/attachments | JSONArray | 附件及其值的清單 |
| /project/attachments/fields | JSONArray | 附件屬性的定義 |
| /project/buckets | JSONArray | 貯體及其值的清單 |
| /project/buckets/fields | JSONArray | 值區屬性的定義 |
| /project/calendars | JSONArray | 行事曆及其值的清單 |
| /project/calendars/fields | JSONArray | 行事曆屬性的定義 |
| /project/checklistItems | JSONArray | 檢查清單專案及其值的清單 |
| /project/checklistItems/fields | JSONArray | 檢查清單專案屬性的定義 |
| /project/conditionalColoringRules | JSONArray | 條件式著色規則及其值的清單 |
| /project/conditionalColoringRules/fields | JSONArray | 條件式著色規則屬性的定義 |
| /project/conversations | JSONArray | 交談及其值的清單 |
| /project/conversations/fields | JSONArray | 交談屬性的定義 |
| /project/goalAssociations | JSONArray | 目標關聯及其值的清單 |
| /project/goalAssociations/fields | JSONArray | 目標關聯的定義 |
| /project/goals | JSONArray | 目標及其值的清單 |
| /project/goals/fields | JSONArray | 目標屬性的定義 |
| /project/labelassociations | JSONArray | 標籤關聯及其值的清單 |
| /project/labelassociations/fields | JSONArray | 標籤關聯屬性的定義 |
| /project/labels | JSONArray | 標籤及其值的清單 |
| /project/labels/fields | JSONArray | 標籤屬性的定義 |
| /project/links | JSONArray | 連結及其值的清單 |
| /project/links/fields | JSONArray | 連結屬性的定義 |
| /project/resources | JSONArray | 資源及其值的清單 |
| /project/resources/fields | JSONArray | 資源屬性的定義 |
| /project/sprints | JSONArray | 短期衝刺及其值的清單 |
| /project/sprints/fields | JSONArray | 短期衝刺屬性的定義 |
| /project/tasks | JSONArray | 工作及其值的清單 |
| /project/tasks/fields | JSONArray | 工作屬性的定義 |
| /project/views/grid | JSONArray | 格線檢視屬性清單 |
| /project/views/grid/fields | JSONArray | 格線檢視及其值的定義 |
專案層級屬性
參考 /project/fields
| 屬性名稱 | 類型 | 描述 | 列舉值 |
|---|---|---|---|
| projectStart | datetime | 將專案開始日期。 | |
| name | 字串 | 專案名稱。 | |
| calendarId | GUID | 用於專案的 Dataverse 行事曆識別碼。 | |
| durationInDays | double | 專案的持續時間 (天) 。 | |
| projectManagerId | GUID | 專案經理的 Dataverse 專案小組成員識別碼。 | |
| workTemplateId | GUID | 用來建立專案行事曆的 Dataverse Work 範本識別碼。 | |
| timezoneOffset | timezoneOffset | 以 +/-HH：MM：SS 格式表示的專案時區位移。 | |
| timezoneName | 字串 | 專案的時區名稱。 | |
| projectManagerResourceId | GUID | 專案經理的 Dataverse 可預約資源識別碼。 | |
| officeGroupId | GUID | Microsoft Entra連結至專案的 Microsoft 365 群組識別碼。 | |
| projectState | 枚舉 | 專案的狀態。 | 作用中、非使用中 |
| projectManagerAadId | GUID | Microsoft Entra專案經理的使用者識別碼。 | |
| hasCustomCalendar | bool | 指出專案是否有自訂行事曆。 | |
| defaultSprintCreated | bool | 是否已建立預設短期衝刺。 | |
| ignoreResourceCalendars | bool | 排程會在資源行事曆上使用專案行事曆。 | |
| 工作 | double | 專案的總工時以秒為單位。 | |
| actualWork | double | 以秒為單位完成專案的工時。 | |
| remainingWork | double | 專案剩餘工時，以秒為單位。 | |
| 時間 | 時間 | 以秒為單位的專案持續時間。 | |
| percentComplete | 百分比 | 專案工期完成的百分比。 | |
| percentWorkComplete | 百分比 | 專案工時完成的百分比。 | |
| earliestTaskStart | datetime | 最早的任務開始日期。 | |
| latestTaskFinish | datetime | 最新的任務完成日期。 |
工作分派屬性
參考 /project/assignments/fields。 它們是工作記錄的一部分。
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| 單位 | double | 將資源指派給任務的單位數，以百分比表示，假設資源的 MaxUnits 值為 100%。 |
| 工作 | double | 資源在幾秒內排程在任務上執行的總工時。 |
| actualWork | double | 資源已在幾秒內完成的工作量。 |
| remainingWork | double | 指派給任務的資源在幾秒內完成指派所需的時間量。 |
| 開始 | datetime | 已指派資源排程開始處理工作的日期和時間。 |
| 完成 | datetime | 此指派排程完成的日期和時間。 |
| actualStart | datetime | 工作分派實際開始的日期和時間。 |
| actualFinish | datetime | 實際完成指派的日期和時間。 |
| 繼續 | datetime | 繼續指派的日期。 |
| 延遲 | 時間 | 資源在工作開始日期之後等待的時間量，以秒為單位開始工作分派。 |
| percentWorkComplete | 百分比 | 工作分派的目前狀態，以已完成的工作分派工作百分比表示。 |
| remainingWorkContour | 輪廓 | 指出剩餘工時如何分散到工作分派的持續時間。 表示為每個區段的開始日期和位移、持續時間和工作的陣列。 如需詳細資訊，請參閱 Contour 結構的詳細資訊。 |
| actualWorkContour | 輪廓 | 指出實際工時如何分散到工作分派的持續時間。 表示為每個區段的開始日期和位移、持續時間和工作的陣列。 如需詳細資訊，請參閱 Contour 結構的詳細資訊。 |
| overallocated | bool | 指出是否將資源指派給特定工作的工作，而不是在資源的正常工作容量內完成的工作。 |
| 停止 | datetime | 工作分派停止的日期。 |
| taskId | GUID | 此工作分派的 Dataverse 專案工作識別碼。 |
| resourceId | GUID | Dataverse 專案小組成員識別碼。 |
| totalWorkContour | 輪廓 | 指出工作分派期間的總工時分佈方式。 表示為每個區段的開始日期和位移、持續時間和工作的陣列。 如需詳細資訊，請參閱 Contour 結構的詳細資訊。 |
輪廓結構
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| start | datetime | 輪廓的開始日期。 |
| 補償 | JSONArray | 要加入至輪廓開始以指出線段開頭的秒數。 |
| durations | JSONArray | 每個區段的持續時間，以秒為單位。 |
| 工作 | JSONArray | 在每個區段的秒數內工作。 |
範例
"remainingWorkContour": {
"start": "2022-12-08T09:00:00Z",
"offsets": [ 0, 54000 ],
"durations": [ 54000, 3600 ],
"work": [ 27000.0, 1800.0 ]
}
區段 X
- Start = 「start」 + X offset in seconds
- Duration = 以秒為單位的區段 X 持續時間
- 工時 = 以秒為單位的區段 X 工時
輪廓從 2023-02-13T09：00：00Z 開始
- 區段 1：
- Start = 2022-12-08T09：00：00Z + 0 seconds - > 2022-12-08T09：00：00Z
- 持續時間 = 54000 秒 - > 900 分鐘 - > 15 小時是區段的長度
- 工時 = 27000 秒 - > 450 分鐘 - > 區段中的 7.5 小時工作
- 區段 2：
- Start = 2023-02-13T18：00：00Z + 54000 秒 (15 小時) - > 2022-12-09T00：00：00Z
- 持續時間 = 3600 秒 - > 60 分鐘 - > 1 小時是區段的長度
- 工時 = 1800 秒 - > 30 分鐘 - > 區段中的 0.5 小時工作
附件屬性
參考 /project/attachments/fields。
| 屬性名稱 | 類型 | 描述 | 列舉值 |
|---|---|---|---|
| taskId | GUID | Dataverse 專案工作識別碼。 | |
| name | 字串 | 附件的別名。 | |
| Uri | 字串 | 儲存附件的位置。 | |
| 類型 | 枚舉 | 連結的類型。 | Word、Excel、PowerPoint、OneNote、Project、Visio、Pdf、ExternalLink、Other |
| showOnCard | bool | 指出是否在面板檢視的卡片上顯示連結。 |
貯體屬性
參考 /project/buckets/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| 以 | 整數 | Project 中貯體的顯示順序。 |
| name | 字串 | 貯體名稱。 |
| color | 整數 | 指派給貯體的色彩索引。 |
行事曆屬性
參考 /project/calendar/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 行事曆的名稱。 |
| 資料 | calendarData | 藉由定義資源可以運作的時間來描述行事曆。 defaultWorkWeek 具有一周中每一天的預設工作時間。 overrideWorkWeeks 是工作周定義的集合，當該覆寫有效時，會覆寫 defaultWorkWeek。 exceptions 是日層級的陣列，當該例外狀況生效時，會覆寫 。 exceptions take priority overrideWorkWeeks， which take priority over defaultWorkWeek. |
| baseCalendarId | GUID | 基準行事曆的 Dataverse 行事曆識別碼。 空 GUID 表示沒有基準行事曆。 |
| timezoneOffset | timezoneOffset | +/-HH：MM：SS 格式的時區位移。 |
| timezoneName | 字串 | 時區的名稱。 |
檢查清單屬性
參考 /project/checklistItems/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| taskId | GUID | Dataverse 專案工作識別碼。 |
| name | 字串 | 檢查清單項目的名稱。 |
| 完成 | bool | 指出專案是否已核取。 |
| 以 | double | 顯示名稱工作中檢查清單專案的順序。 |
條件式著色規則屬性
參考 /project/conditionalColoringRules/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| 以 | 整數 | 規則順序。 |
| 運算式 | conditionalRules | 用來為欄位儲存格著色之規則的正式描述。 |
| color | 整數 | 如果此規則評估為 true，則在 tasks gridColor 屬性的這個欄位上設定的色彩索引。 |
| columnId | column | 當運算式為 true 時，將套用色彩的資料行。 |
交談屬性
參考 /project/conversations/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| teamsChannelId | 字串 | 包含交談的 Teams 頻道識別碼。 |
| teamsConversationId | 字串 | Teams 交談識別碼。 |
目標關聯屬性
參考 /project/goalAssociations/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| taskId | GUID | 專案工作識別碼。 |
| goalId | GUID | 專案目標識別碼。 |
| taskOrder | 字串 | 排序工作的目標關聯順序 |
目標屬性
參考 /project/goals/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 專案目標的名稱。 |
| color | 整數 | 目標的色彩索引。 |
| 優先 | 整數 | 目標的優先順序。 |
| 狀態 | 整數 | 目標的狀態。 |
| startDate | datetime | 目標的開始日期。 |
| finishDate | datetime | 目標的完成日期。 |
| 筆記 | HTML | 以 HTML 格式化的目標附注。 |
| 未格式化的注標 | HTML | 已移除所有 HTML 的目標附注。 |
| 以 | 字串 | 目標順序 |
標籤關聯屬性
參考 /project/labelassociations/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| taskId | GUID | Dataverse 專案工作識別碼。 |
| labelId | GUID | Dataverse 專案標籤識別碼。 |
標籤屬性
參考 /project/labels/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| 文字 | 字串 | 專案標籤的名稱。 |
| index | 整數 | 標籤的色彩索引。 |
連結屬性
參考 /project/links/fields
| 屬性名稱 | 類型 | 描述 | 列舉值 |
|---|---|---|---|
| linkType | 枚舉 | 相依性的類型。 | FinishToFinish、FinishToStart、StartToFinish、StartToStart |
| 延遲 | 時間 | 工作應該要多久才能開始。 | |
| delayUnits | 枚舉 | 延遲所在的單位。 | 分鐘、小時、天、周、月 |
| predecessorId | GUID | 前置任務的 Dataverse 專案工作識別碼。 | |
| successorId | GUID | 後續任務的 Dataverse 專案工作識別碼。 | |
| 司機 | bool | 指出連結是否驅動關鍵路徑。 |
資源屬性
參考 /project/resources/fields
| 屬性名稱 | 類型 | 描述 | 列舉值 |
|---|---|---|---|
| name | 字串 | 小組成員的名稱。 | |
| overallocated | bool | 如果小組成員已在此專案上過度分派。 | |
| userPrincipalName | 字串 | Microsoft Entra使用者的使用者主體名稱。 | |
| bookableResourceId | GUID | 這個小組成員的可預約資源識別碼。 | |
| aadId | GUID | Microsoft Entra可預約資源的使用者識別碼。 | |
| 通用 | bool | 表示這是泛型資源。 | |
| 類型 | 枚舉 | 可預約的資源類型。 | XrmUser、XrmContact、XrmAccount、XrmEquipment、XrmGeneric、AadUser、AadUserTypeNull、AadUserTypeMember、XrmBookableResource |
| jobTitle | 字串 | 可預約資源的職稱。 | |
| aadUserType | 枚舉 | 如果可預訂的資源是Microsoft Entra成員或來賓。 | 成員、來賓 |
Sprint 屬性
參考 /project/sprints/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 短期衝刺的名稱。 |
| 開始 | datetime | 短期衝刺開始的日期。 |
| 完成 | datetime | 短期衝刺結束的日期。 |
工作屬性
參考 /project/tasks/fields
| 屬性名稱 | 類型 | 描述 | 列舉值 |
|---|---|---|---|
| 工作 | double | 所有指派的資源排程要在工作上執行的總工時。 | |
| actualWork | double | 指派給工作的資源已完成的工作量。 | |
| remainingWork | double | 所有指派給任務的資源所排程執行的非加班工時總數。 | |
| name | 字串 | 工作名稱。 | |
| constraintType | 枚舉 | 任務開始或完成日期的條件約束。 | AsSoonAsPossible、AsLateAsPossible、MustStartOn、MustFinishOn、StartNoEarlierThan、StartNoLaterThan、FinishNoEarlierThan、FinishNoLaterThan |
| constraintDate | datetime | 指出工作 ConstraintType 中定義的限制開始或完成日期。 除非條件約束類型設定為 [盡可能晚] 或 [儘快]，否則為必要專案。 | |
| 關鍵 | bool | 指出任務在排程中是否有空間可以滑動，或是否在關鍵路徑上。 | |
| freeSlack | 時間 | 任務可延遲而不會延遲任何後續任務的實際時間量。 如果任務沒有後續任務，則可用的寬限時間是工作可以延遲而不會延遲整個專案的時間量。 | |
| totalSlack | 時間 | 任務可以延遲的時間量，而不會延遲專案的完成日期。 | |
| index | 整數 | 工作的整數順序。 | |
| 里程碑 | bool | 指出工作是否為里程碑。 | |
| actualDuration | 時間 | 目前任務的實際工作時間範圍，根據排程工期和目前剩餘工時或完成百分比。 實際持續時間可以根據完成百分比或剩餘工期，以兩種方式計算。 | |
| scheduledDuration | 時間 | 使用中工作時間的總範圍。 | |
| remainingDuration | 時間 | 完成任務未完成部分所需的時間量。 | |
| percentComplete | 百分比 | 已完成任務工期的百分比。 | |
| scheduledStart | datetime | 專案所計算的開始日期和時間。 | |
| scheduledFinish | datetime | 專案所計算的完成日期和時間。 | |
| earlyStart | datetime | 根據前置任務和後續任務及其他條件約束的早期開始日期，任務可以開始的最早日期。 | |
| earlyFinish | datetime | 任務可以完成的最早日期，根據前置任務和後續任務的早期完成日期、其他條件約束，以及任何撫平延遲。 | |
| lateStart | datetime | 任務可以啟動但不會延遲專案完成的最新日期。 | |
| lateFinish | datetime | 任務可在不延遲專案完成的情況下完成的最新日期。 | |
| actualStart | datetime | 工作實際開始的日期和時間。 | |
| actualFinish | datetime | 工作實際完成的日期和時間。 | |
| outlineLevel | 整數 | 指出專案大綱階層中任務層級的數位。 | |
| cdsEffortCompleted | double | 如專案作業時程表中所報告，在此任務上完成的工作量。 | |
| cdsEffortRemaining | double | 此任務的剩餘工時，如專案作業時程表中所報告。 | |
| cdsEffortEstimateAtComplete | double | 如專案作業時程表中所報告，完成工作的總投入量預測。 | |
| cdsPercentComplete | double | 專案作業時程表中所報告的已完成工時百分比。 | |
| cdsScheduleVariance | double | 根據 Project Operations 時程表中所報告的完成預估，估計工時與預測工時之間的差異。 | |
| 摘要 | bool | 指出任務是否為摘要任務。 | |
| 繼續 | datetime | 任務剩餘部分排程繼續的日期。 | |
| 停止 | datetime | 表示工作實際部分結束的日期。 | |
| outlineNumber | 字串 | 指出任務在大綱中的確切位置。 例如，「7.2」 表示工作是第七個最上層摘要任務底下的第二個子工作。 | |
| completeThrough | datetime | 實際持續時間結束的日期和時間。 | |
| 類型 | 枚舉 | 工作類型。 | FixedUnits、FixedDuration、FixedWork |
| durationDisplayFormat | 枚舉 | 顯示持續時間的顯示格式。 | 分鐘、小時、天、周、月 |
| 倒塌 | bool | 指出是否在檢視中折迭工作。 | |
| 最後 期限 | datetime | 輸入為任務期限的日期。 | |
| startSlack | 時間 | earlyStart 和 lateStart 日期之間的差異。 | |
| finishSlack | 時間 | earlyFinish 和 lateFinish 日期之間的差異。 | |
| 以 | double | 以雙精度浮點數表示之工作的順序。 | |
| parentId | GUID | 父任務的 Dataverse 專案工作識別碼。 | |
| scheduleDrivers | stringArray | 描述為何工作排定在開始日期開始。 可以包含任何 Actual、LevelingDelay、Constraint、Predecessor、ProjectStart、Calendar、Child、Parent、Deadline、Link。 | |
| 開始 | datetime | 排程開始工作的日期和時間。 | |
| 完成 | datetime | 排程完成工作的日期和時間。 | |
| 時間 | 時間 | 使用中工作時間的總範圍。 | |
| bucketId | GUID | 工作所屬的 Dataverse Project Bucket 識別碼。 | |
| bucketOrder | 字串 | 貯體中任務的順序。 | |
| sprintOrder | 字串 | 短期衝刺內的工作順序。 | |
| 筆記 | HTML | 輸入以 HTML 格式化之工作的相關注意事項。 | |
| 未格式化的注標 | HTML | 已移除所有 HTML 的附注。 | |
| 手動 | bool | 此工作為空白或具有日期。 | |
| showNotesOnCard | bool | 指出筆記是否會顯示在面板檢視的卡片上。 | |
| showChecklistOnCard | bool | 指出檢查清單專案是否會顯示在面板檢視的卡片上。 | |
| 優先 | 整數 | 表示指派給工作的重要性層級，其中 5 為標準優先順序;數位越低，工作就越緊急。 | |
| sprintId | GUID | 指派工作之短期衝刺的屬性名稱。 | |
| gridColor | gridColor | 此任務上每個欄位的色彩索引，其中 conditionalColoringRule 已評估為 true。 如需色彩索引對應，請參閱 。 | |
| [guid] | 枚舉 | 工作自訂欄位定義。 如需定義，請參閱 工作自訂欄位屬性 。 | stringOption、datetime、double、bool、string |
工作自訂欄位屬性
| 屬性名稱 | 類型 | 描述 | 列舉值 |
|---|---|---|---|
| id | GUID | 工作自訂欄位的唯一識別碼。 | |
| 類型 | 枚舉 | 自訂欄位的類型 | stringOption、datetime、double、bool、string |
| 自 定義 | bool | 如果是本機自訂欄位，則為 true | |
| name | 字串 | 自訂欄位的名稱 | |
| 匯總 | 枚舉 | 如果 type=double，則為匯總類型 | max、min、sum、average |
| values | JSONArray | 如果 type=stringOption，則為選項的值。 請參閱 選擇類型 |
自訂欄位類型
| 自訂欄位類型 | 列舉類型 |
|---|---|
| 文字 | 字串 |
| 日期 | datetime |
| 數字 | double |
| 是/否 | bool |
| 選擇 | stringOption |
選擇類型
針對 'stringOption' 類型的自訂欄位
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| 識別碼 | GUID | 選擇的唯一識別碼 |
| 數值 | 字串 | 顯示選擇的值 |
| 以 | double | 選擇的顯示順序 |
| color | 整數 | 指派給值的色彩索引。 |
檢視屬性
參考 /project/views/grid/fields
| 屬性名稱 | 類型 | 描述 |
|---|---|---|
| Name | 字串 | 方格檢視的名稱。 |
| columns | columns | 檢視中顯示的資料行陣列及其寬度。 |