导出项目内容定义

项目
06/25/2023

使用 ExportProjectContent 工具时，Page 描述了 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	sprint 属性的定义
/project/tasks	JSONArray	任务及其值列表
/project/tasks/fields	JSONArray	任务属性的定义
/project/views/grid	JSONArray	网格视图属性列表
/project/views/grid/fields	JSONArray	网格视图及其值的定义

项目级别属性

引用 /project/fields

属性名称	类型	说明	枚举值
projectStart	datetime	项目的开始日期。
name	string	项目的名称。
calendarId	guid	用于项目的 Dataverse 日历 ID。
durationInDays	double	项目的工期 (天) 。
projectManagerId	guid	项目经理的 Dataverse 项目团队成员 ID。
workTemplateId	guid	用于创建项目日历的 Dataverse 工作模板 ID。
timezoneOffset	timezoneOffset	项目的时区偏移量采用 +/-HH：MM：SS 格式。
timezoneName	string	项目的时区名称。
projectManagerResourceId	guid	项目经理的 Dataverse 可预订资源 ID。
officeGroupId	guid	Microsoft Entra链接到项目的 Microsoft 365 组 ID。
projectState	枚举	项目的状态。	活动、非活动
projectManagerAadId	guid	Microsoft Entra项目经理的用户 ID。
hasCustomCalendar	布尔值	指示项目是否具有自定义日历。
defaultSprintCreated	布尔值	是否已创建默认冲刺。
ignoreResourceCalendars	布尔值	计划使用项目日历而不是资源日历。
工时	double	项目的总工时数（以秒为单位）。
actualWork	double	项目完成工时（以秒为单位）。
remainingWork	double	项目的剩余工时（以秒为单位）。
duration	duration	项目的持续时间（以秒为单位）。
percentComplete	百分号	项目工期已完成的百分比。
percentWorkComplete	百分号	项目工时已完成的百分比。
earliestTaskStart	datetime	最早的任务开始日期。
latestTaskFinish	datetime	最新任务完成日期。

工作分配属性

引用 /project/assignments/fields。它们是任务记录的一部分。

属性名称	类型	说明
单位	double	资源分配给任务的单位数（以百分比表示），假定资源的 MaxUnits 值为 100%。
工时	double	资源计划对任务执行的工时总量（以秒为单位）。
actualWork	double	资源已对任务完成的工时数（以秒为单位）。
remainingWork	double	分配给任务的资源完成分配所需的时间（以秒为单位）。
start	datetime	分配的资源计划开始处理任务的日期和时间。
完成	datetime	计划完成此分配的日期和时间。
actualStart	datetime	作业实际开始的日期和时间。
actualFinish	datetime	实际完成作业的日期和时间。
resume	datetime	恢复工作分配的日期。
延迟	duration	资源在任务开始日期之后等待的时间，然后开始处理工作分配（以秒为单位）。
percentWorkComplete	百分号	作业的当前状态，以已完成的工作分配工时百分比表示。
remainingWorkContour	轮廓	指示如何在工作分配期间分配剩余工时。表示为每个段的开始日期和偏移量、持续时间和工时数组。有关详细信息，请参阅有关轮廓结构的详细信息。
actualWorkContour	轮廓	指示如何在工作分配期间分配实际工时。表示为每个段的开始日期和偏移量、持续时间和工时数组。有关详细信息，请参阅有关轮廓结构的详细信息。
过度分配	布尔值	指示是否为资源分配特定任务的工作量大于在资源的正常工作能力中所能完成的工作量。
stop	datetime	工作分配停止的日期。
taskId	guid	此分配的 Dataverse 项目任务 ID。
resourceId	guid	Dataverse 项目团队成员 ID。
totalWorkContour	轮廓	指示工作分配期间总工时的方式。表示为每个段的开始日期和偏移量、持续时间和工时数组。有关详细信息，请参阅有关轮廓结构的详细信息。

轮廓结构

属性名称	类型	说明
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（以秒为单位）
Duration = 段 X 的持续时间（秒）
工时 = 段 X 的工时（以秒为单位）

轮廓开始于 2023-02-13T09：00：00Z

段 1：
- Start = 2022-12-08T09：00：00Z + 0 秒 -> 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 项目任务 ID。
name	string	附件的别名。
Uri	string	附件的存储位置。
type	枚举	链接的类型。	Word、Excel、PowerPoint、OneNote、Project、Visio、Pdf、ExternalLink、其他
showOnCard	布尔值	指示链接是否显示在开发板视图中的卡上。

存储桶属性

引用 /project/buckets/fields

属性名称	类型	说明
以	integer	显示 Project 中存储桶的顺序。
name	string	存储桶的名称。
color	integer	分配给存储桶的颜色索引。

日历属性

引用 /project/calendar/fields

属性名称	类型	说明
name	string	日历的名称。
data	calendarData	通过定义资源可以工作的时间来描述日历。 defaultWorkWeek 具有一周中每一天的默认工作时间。 overrideWorkWeeks 是工作周定义的集合，在重写生效时重写 defaultWorkWeek。异常是一组日级替代，以及该异常生效时。 exceptions 优先于 overrideWorkWeeks，后者优先于 defaultWorkWeek。
baseCalendarId	guid	基准日历的 Dataverse 日历 ID。空 guid 表示没有基准日历。
timezoneOffset	timezoneOffset	时区的偏移量（采用 +/-HH：MM：SS 格式）。
timezoneName	string	时区的名称。

清单属性

参考 /project/checklistItems/fields

属性名称	类型	说明
taskId	guid	Dataverse 项目任务 ID。
name	string	核对清单项的名称。
完成	布尔值	指示该项是否已关闭。
以	double	在名称任务中显示清单项的顺序。

条件着色规则属性

引用 /project/conditionalColoringRules/fields

属性名称	类型	说明
以	integer	规则顺序。
表达式	conditionalRules	用于为字段单元格着色的规则的正式说明。
color	integer	如果此规则的计算结果为 true，则针对任务网格颜色属性的此字段设置的颜色索引。
columnId	column	表达式为 true 时，将应用于颜色的列。

Conversations 属性

引用 /project/conversations/fields

属性名称	类型	说明
teamsChannelId	string	包含对话的 Teams 频道 ID。
teamsConversationId	string	Teams 对话 ID。

目标关联属性

引用 /project/goalAssociations/fields

属性名称	类型	说明
taskId	guid	项目任务 ID。
goalId	guid	项目目标 ID。
taskOrder	string	任务排序的目标关联顺序

Goals 属性

参考 /project/goals/fields

属性名称	类型	说明
name	string	项目目标的名称。
color	integer	目标的颜色索引。
priority	integer	目标的优先级。
status	integer	目标的状态。
startDate	datetime	目标的开始日期。
finishDate	datetime	目标的完成日期。
notes	HTML	以 HTML 格式设置的目标注释。
unformattednotes	HTML	去除所有 HTML 的目标注释。
以	string	目标顺序

标签关联属性

引用 /project/labelassociations/fields

属性名称	类型	说明
taskId	guid	Dataverse 项目任务 ID。
labelId	guid	Dataverse 项目标签 ID。

标签属性

引用 /project/labels/fields

属性名称	类型	说明
text	string	项目标签的名称。
index	integer	标签的颜色索引。

链接属性

引用 /project/links/fields

属性名称	类型	说明	枚举值
linkType	枚举	依赖项的类型。	FinishToFinish、FinishToStart、StartToFinish、StartToStart
延迟	duration	任务应开始前多久。
delayUnits	枚举	延迟的单位。	分钟、小时、天、周、月
predecessorId	guid	前置任务的 Dataverse Project 任务 ID。
successorId	guid	后续任务的 Dataverse Project 任务 ID。
司机	布尔值	指示链接是否驱动关键路径。

资源属性

引用 /project/resources/fields

属性名称	类型	说明	枚举值
name	string	团队成员的名称。
过度分配	布尔值	如果此项目上过度分配了团队成员。
userPrincipalName	string	Microsoft Entra用户主体名称。
bookableResourceId	guid	此团队成员的可预订资源 ID。
aadId	guid	Microsoft Entra可预订资源的用户 ID。
通用	布尔值	指示这是通用资源。
type	枚举	可预订资源类型。	XrmUser、XrmContact、XrmAccount、XrmEquipment、XrmGeneric、AadUser、AadUserTypeNull、AadUserTypeMember、XrmBookableResource
jobTitle	string	可预订资源的职务。
aadUserType	枚举	如果可预订资源是Microsoft Entra成员或来宾。	成员、来宾

Sprint 属性

引用 /project/sprints/fields

属性名称	类型	说明
name	string	冲刺的名称。
start	datetime	冲刺开始的日期。
完成	datetime	冲刺结束的日期。

任务属性

引用 /project/tasks/fields

属性名称	类型	说明	枚举值
工时	double	计划由所有分配的资源对任务执行的工时总数。
actualWork	double	分配给任务的资源已完成的工时量。
remainingWork	double	分配给任务的所有资源计划执行的非加班工时总数。
name	string	任务的名称。
constraintType	枚举	任务开始日期或完成日期的约束。	AsSoonAsPossible、AsLateAsPossible、MustStartOn、MustFinishOn、StartNoEarlierThan、StartNoLaterThan、FinishNoEarlierThan、FinishNoLaterThan
constraintDate	datetime	指示任务 ConstraintType 中定义的受约束的开始日期或完成日期。必需，除非将约束类型设置为“尽可能晚”或“尽快”。
关键	布尔值	指示任务是否在计划中具有要滑行的空间，或者它是否位于关键路径上。
freeSlack	duration	可以在不延迟任何后续任务的情况下延迟任务的实际时间量。如果任务没有后续任务，则可用松弛时间是任务可以延迟的时间量，而不会延迟整个项目。
totalSlack	duration	任务可以在不延迟项目完成日期的情况下延迟的时间量。
index	integer	任务的整数顺序。
里程碑	布尔值	指示任务是否为里程碑。
actualDuration	duration	到目前为止，基于计划的工期和当前剩余工时或完成百分比，任务的实际工作时间范围。实际工期可通过两种方式计算，一种是基于完成百分比或剩余工期。
scheduledDuration	duration	活动工作时间的总跨度。
remainingDuration	duration	完成任务未完成部分所需的时间。
percentComplete	百分号	任务工期已完成的百分比。
scheduledStart	datetime	由 Project 计算的开始日期和时间。
scheduledFinish	datetime	按 Project 计算的完成日期和时间。
earlyStart	datetime	基于前置任务和后续任务的早期开始日期和其他约束，任务可以开始的最早日期。
earlyFinish	datetime	任务可以完成的最早日期，具体取决于前置任务和后续任务的提前完成日期、其他约束以及任何调配延迟。
lateStart	datetime	任务可以在不延迟项目完成的情况下开始的最新日期。
lateFinish	datetime	任务可以在不延迟项目完成的情况下完成的最新日期。
actualStart	datetime	任务的实际开始日期和时间。
actualFinish	datetime	任务实际完成的日期和时间。
outlineLevel	integer	指示项目大纲层次结构中任务级别的数字。
cdsEffortCompleted	double	项目操作时间表中报告的此任务完成的工时量。
cdsEffortRemaining	double	项目操作时间表中报告的此任务剩余工时量。
cdsEffortEstimateAtComplete	double	预测完成项目操作时间表中报告的任务的总工作量。
cdsPercentComplete	double	项目运营时间表中报告的已完成工时的百分比。
cdsScheduleVariance	double	根据项目操作时间表中报告的完成估计值，估计工时与预测工时之间的差异。
摘要	布尔值	指示任务是否是摘要任务。
resume	datetime	计划任务剩余部分恢复的日期。
stop	datetime	表示任务实际部分结束的日期。
outlineNumber	string	指示任务在大纲中的确切位置。例如，“7.2”指示任务是第七个顶级摘要任务下的第二个子任务。
completeThrough	datetime	实际持续时间结束的日期和时间。
type	枚举	任务类型。	FixedUnits、FixedDuration、FixedWork
durationDisplayFormat	枚举	显示持续时间的显示格式。	分钟、小时、天、周、月
倒塌	布尔值	指示任务是否在视图中折叠。
最后期限	datetime	作为任务截止时间输入的日期。
startSlack	duration	earlyStart 和 lateStart 日期之间的差异。
finishSlack	duration	earlyFinish 和 lateFinish 日期之间的差异。
以	double	以双精度表示的任务顺序。
parentId	guid	父任务的 Dataverse Project 任务 ID。
scheduleDrivers	stringArray	描述任务计划在其开始日期开始的原因。可以包含任何 Actual、LevelingDelay、Constraint、前置任务、ProjectStart、日历、子级、父级、截止时间、链接。
start	datetime	计划任务开始的日期和时间。
完成	datetime	计划完成任务的日期和时间。
duration	duration	活动工作时间的总跨度。
bucketId	guid	任务所属的 Dataverse 项目存储桶 ID。
bucketOrder	string	存储桶中任务的顺序。
sprintOrder	string	冲刺中任务的顺序。
notes	HTML	输入的关于以 HTML 格式设置的任务的注释。
unformattednotes	HTML	删除了所有 HTML 的笔记。
手动	布尔值	此任务是否为空或包含日期。
showNotesOnCard	布尔值	指示注释是否将显示在板视图中的卡上。
showChecklistOnCard	布尔值	指示清单项是否将显示在板视图中的卡上。
priority	integer	指示分配给任务的重要性级别，其中 5 为标准优先级;数字越少，任务越紧急。
sprintId	guid	任务分配到的冲刺的属性名称。
gridColor	gridColor	此任务中 conditionalColoringRule 的计算结果为 true 的每个字段的颜色索引。有关颜色索引映射，请参阅。
[guid]	枚举	任务自定义域定义。有关定义，请参阅任务自定义域属性。	stringOption， datetime， double， bool， string

任务自定义域属性

属性名称	类型	说明	枚举值
id	guid	任务自定义域的唯一 ID。
type	枚举	自定义域的类型	stringOption， datetime， double， bool， string
自定义	布尔值	如果它是本地自定义字段，则为 true
name	string	自定义字段的名称
汇总	枚举	如果 type=double，则汇总类型	max、min、sum、average
值	JSONArray	如果 type=stringOption，则为选项的值。请参阅选项类型

自定义字段类型

自定义字段类型	枚举类型
Text	string
日期	datetime
数字	double
是/否	布尔值
选项	stringOption

选项类型

对于类型为“stringOption”的自定义字段

属性名称	类型	说明
ID	guid	选择的唯一 ID
值	string	选择的显示值
以	double	选项的显示顺序
color	integer	分配给值的颜色索引。

查看属性

引用 /project/views/grid/fields

属性名称	类型	说明
name	string	网格视图的名称。
columns	columns	视图中显示的列及其宽度的数组。

通过