Экспорт определения содержимого проекта
Страница описывает формат выходных данных и определение JSON при использовании средства ExportProjectContent.
| Имя свойства | Тип | Описание |
|---|---|---|
| /Проекта | 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 | string | Имя проекта. | |
| calendarId | guid | Идентификатор календаря Dataverse, используемый для проекта. | |
| durationInDays | double | Длительность проекта (в днях). | |
| projectManagerId | guid | Идентификатор участника группы проекта Dataverse для руководителя проекта. | |
| workTemplateId | guid | Идентификатор рабочего шаблона Dataverse, используемый для создания календаря проекта. | |
| timezoneOffset | timezoneOffset | Смещение часового пояса проекта в формате +/-HH:MM:SS. | |
| timezoneName | string | Имя часового пояса проекта. | |
| projectManagerResourceId | guid | Dataverse Bookable Resource ID руководителя проекта. | |
| officeGroupId | guid | Microsoft Entra идентификатор группы Microsoft 365, связанный с проектом. | |
| projectState | enum | Состояние проекта. | Активный, неактивный |
| projectManagerAadId | guid | Microsoft Entra идентификатор пользователя руководителя проекта. | |
| hasCustomCalendar | логический | Указывает, имеет ли проект пользовательский календарь. | |
| defaultSprintCreated | логический | Создан спринт по умолчанию. | |
| ignoreResourceCalendars | логический | При планировании используется календарь проекта поверх календарей ресурсов. | |
| work | double | Общее количество трудоемких работ для проекта в секундах. | |
| actualWork | double | Завершенные работы над проектом за считанные секунды. | |
| Оставшаяся работа | double | Оставшиеся трудоемки для проекта в секундах. | |
| duration | duration | Длительность проекта в секундах. | |
| percentComplete | Процент | Процент завершения проекта. | |
| percentWorkComplete | Процент | Процент завершенных работ по проекту. | |
| earliestTaskStart | datetime | Самая ранняя дата начала задачи. | |
| latestTaskFinish | datetime | Дата окончания последней задачи. |
Свойства назначения
Ссылка на /project/assignments/fields. Они входят в запись задачи.
| Имя свойства | Тип | Описание |
|---|---|---|
| Единиц | double | Количество единиц, для которых ресурс назначается задаче, выражается в процентах при условии, что значение MaxUnits ресурса составляет 100 %. |
| work | double | Общий объем работ, запланированных ресурсом для задачи в секундах. |
| actualWork | double | Объем работы, уже выполненный ресурсом для задачи в секундах. |
| Оставшаяся работа | double | Время, необходимое ресурсу, назначенному задаче, для выполнения задания в секундах. |
| start | datetime | Дата и время начала работы над задачей назначенным ресурсом. |
| Закончить | datetime | Дата и время выполнения этого назначения. |
| actualStart | datetime | Дата и время фактического начала назначения. |
| actualFinish | datetime | Дата и время фактического завершения задания. |
| resume | datetime | Дата возобновления назначения. |
| Задержки | duration | Время ожидания ресурса после даты начала задачи перед началом работы над назначением в секундах. |
| percentWorkComplete | Процент | Текущее состояние назначения, выраженное в процентах от выполненной работы. |
| remainingWorkContour | Контур | Указывает, как оставшиеся трудозатраты должны распределяться по продолжительности назначения. Представляется в виде даты начала и массивов смещения, длительности и работы для каждого сегмента. Дополнительные сведения см. в разделе Структура контура. |
| actualWorkContour | Контур | Указывает, как фактические трудозатраты должны распределяться по продолжительности назначения. Представляется в виде даты начала и массивов смещения, длительности и работы для каждого сегмента. Дополнительные сведения см. в разделе Структура контура. |
| в целом | логический | Указывает, назначено ли ресурсу больше работы над определенной задачей, чем можно выполнить в пределах нормальной рабочей емкости ресурса. |
| Остановить | datetime | Дата остановки назначения. |
| Taskid | guid | Идентификатор задачи проекта Dataverse для этого назначения. |
| resourceId | guid | Идентификатор участника группы проекта Dataverse. |
| totalWorkContour | Контур | Указывает, как будет распределено общее количество трудозатрат по продолжительности назначения. Представляется в виде даты начала и массивов смещения, длительности и работы для каждого сегмента. Дополнительные сведения см. в разделе Структура контура. |
Структура контура
| Имя свойства | Тип | Описание |
|---|---|---|
| start | datetime | Дата начала контура. |
| Смещения | JSONArray | Число секунд, добавляемых к началу контура, чтобы указать начало сегмента. |
| Длительности | JSONArray | Длительность каждого сегмента в секундах. |
| work | 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 в секундах
- Work = работа сегмента X в секундах
Контур начинается 2023-02-13T09:00:00Z
- Сегмент 1.
- Start = 2022-12-08T09:00:00Z + 0 секунд -> 2022-12-08T09:00:00Z
- Длительность = 54000 секунд —> 900 минут —> 15 часов — это длина сегмента
- Работа = 27 000 секунд —> 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 | string | Псевдоним для вложения. | |
| Uri | string | Расположение, в котором хранится вложение. | |
| type | enum | Тип ссылки. | Word, Excel, PowerPoint, OneNote, Project, Visio, Pdf, ExternalLink, Other |
| 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 для базового календаря. Пустой guid означает, что нет базового календаря. |
| timezoneOffset | timezoneOffset | Смещение часового пояса в формате +/-HH:MM:SS. |
| timezoneName | string | Имя часового пояса. |
Свойства контрольного списка
Ссылка /project/checklistItems/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| Taskid | guid | Идентификатор задачи проекта Dataverse. |
| name | string | Название элемента контрольного списка. |
| Завершена | логический | Указывает, снят ли элемент. |
| Заказ | double | Отображение порядка элемента контрольного списка в задаче имени. |
Свойства правила условной раскраски
Ссылка /project/conditionalColoringRules/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| Заказ | integer | Порядок правил. |
| выражение | conditionalRules | Формальное описание правила, используемого для цветовых ячеек поля. |
| color | integer | Цветной индекс, заданный в этом поле в сетке задач, свойствоColor, если это правило имеет значение true. |
| columnId | столбец | Столбец, к который будет применен цвет, если выражение имеет значение true. |
Свойства бесед
Ссылка /project/conversations/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| teamsChannelId | string | Идентификатор канала Teams, содержащий беседу. |
| teamsConversationId | string | Идентификатор беседы Teams. |
Свойства связей целей
Ссылка /project/goalAssociations/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| Taskid | guid | Идентификатор задачи проекта. |
| goalId | guid | Идентификатор цели проекта. |
| taskOrder | string | Порядок сопоставления целей для упорядочения задач |
Свойства целей
Ссылка /project/goals/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| name | string | Имя цели проекта. |
| color | integer | Индекс цвета цели. |
| priority | integer | Приоритет цели. |
| status | integer | Состояние цели. |
| startDate | datetime | Дата начала цели. |
| finishDate | datetime | Дата окончания цели. |
| notes | HTML | Заметки о цели, отформатированные в ФОРМАТЕ HTML. |
| неформатированные сноски | HTML | Примечания к цели со всеми html-кодами удалены. |
| Заказ | string | Порядок целей |
Свойства ассоциации меток
Ссылка /project/labelassociations/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| Taskid | guid | Идентификатор задачи проекта Dataverse. |
| labelId | guid | Идентификатор метки проекта Dataverse. |
Свойства метки
Ссылка /project/labels/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| text | string | Имя метки проекта. |
| index | integer | Индекс цвета метки. |
Свойства ссылок
Ссылка /project/links/fields
| Имя свойства | Тип | Описание | Значения перечисления |
|---|---|---|---|
| linkType | enum | Тип зависимости. | FinishToFinish, FinishToStart, StartToFinish, StartToStart |
| Задержки | duration | Каково время до начала задачи. | |
| delayUnits | enum | Единица измерения задержки. | Минуты, часы, дни, недели, месяцы |
| идентификатор предшественника | guid | Идентификатор задачи проекта Dataverse для задачи-предшественника. | |
| successorId | guid | Идентификатор задачи проекта Dataverse для задачи-преемника. | |
| Драйвер | логический | Указывает, управляет ли ссылка критическим путем. |
Свойства ресурса
Ссылка /project/resources/fields
| Имя свойства | Тип | Описание | Значения перечисления |
|---|---|---|---|
| name | string | Имя участника команды. | |
| в целом | логический | Значение , если участник команды работает в этом проекте. | |
| userPrincipalName | string | Microsoft Entra имя участника-пользователя. | |
| bookableResourceId | guid | Идентификатор резервируемого ресурса для этого участника команды. | |
| aadId | guid | Microsoft Entra идентификатор пользователя ресурса, который можно забронировать. | |
| Универсальный | логический | Указывает, что это универсальный ресурс. | |
| type | enum | Тип резервируемых ресурсов. | XrmUser, XrmContact, XrmAccount, XrmEquipment, XrmGeneric, AadUser, AadUserTypeNull, AadUserTypeMember, XrmBookableResource |
| jobTitle; | string | Название должности резервируемого ресурса. | |
| aadUserType | enum | Если резервируемый ресурс является участником или гостем Microsoft Entra. | Участник, гость |
Свойства спринта
Ссылка на /project/sprints/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| name | string | Имя спринта. |
| start | datetime | Дата начала спринта. |
| Закончить | datetime | Дата окончания спринта. |
Свойства задачи
Ссылка /project/tasks/fields
| Имя свойства | Тип | Описание | Значения перечисления |
|---|---|---|---|
| work | double | Общий объем работ, запланированных для выполнения задачи всеми назначенными ресурсами. | |
| actualWork | double | Объем работы, уже выполненный ресурсами, назначенными задаче. | |
| Оставшаяся работа | double | Общий объем работ, не относящихся к сверхурочному времени, запланированный для выполнения всеми ресурсами, назначенными задаче. | |
| name | string | Имя задачи. | |
| constraintType | enum | Ограничение даты начала или окончания задачи. | AsSoonAsPossible, AsLateAsPossible, MustStartOn, MustFinishOn, StartNoEarlierThan, StartNoLaterThan, FinishNoEarlierThan, FinishNoLaterThan |
| constraintDate | datetime | Указывает ограниченную дату начала или окончания, определенную в параметре ConstraintType задачи. Требуется, если для типа ограничения не задано значение Как можно позже или Как можно скорее. | |
| Критических | логический | Указывает, имеет ли задача место в расписании для скольжения, или она находится на критическом пути. | |
| freeSlack | duration | Фактический период времени, в течение времени, в течение времени выполнения задачи можно отложить, не откладывая любые последующие задачи. Если в задаче нет последующих задач, то свободное время — это время, в течение которого задача может быть отложена без задержки всего проекта. | |
| totalSlack | duration | Время выполнения задачи может быть отложено без задержки даты окончания проекта. | |
| index | integer | Целочисленный порядок задачи. | |
| Вехой | логический | Указывает, является ли задача вехой. | |
| actualDuration | duration | Период фактического рабочего времени для задачи на данный момент в зависимости от запланированной продолжительности и текущей оставшейся работы или процента завершения. Фактическую длительность можно вычислить двумя способами: на основе процента завершения или оставшейся длительности. | |
| scheduledDuration | duration | Общий период активного рабочего времени. | |
| оставшаясядурация | duration | Время, необходимое для выполнения незавершенной части задачи. | |
| percentComplete | Процент | Процент от длительности выполнения задачи. | |
| scheduledStart | datetime | Дата и время начала, вычисляемые в Project. | |
| scheduledFinish | datetime | Дата и время окончания, вычисляемые в Project. | |
| earlyStart | datetime | Самая ранняя дата начала задачи на основе ранних дат начала задач-предшественников и преемников, а также других ограничений. | |
| earlyFinish | datetime | Самая ранняя дата завершения задачи, основанная на ранних датах завершения задач-предшественников и преемников, других ограничениях и любой задержке выравнивания. | |
| lateStart | datetime | Последняя дата запуска задачи без задержки завершения проекта. | |
| lateFinish | datetime | Последняя дата завершения задачи без задержки завершения проекта. | |
| actualStart | datetime | Дата и время фактического начала задачи. | |
| actualFinish | datetime | Дата и время фактического завершения задачи. | |
| outlineLevel | integer | Число, указывающее уровень задачи в иерархии структуры проекта. | |
| cdsEffortCompleted | double | Объем работы, проделанной над этой задачей, как указано в расписаниях операций project. | |
| cdsEffortRemaining | double | Объем оставшейся работы над этой задачей, как указано в расписаниях операций project. | |
| cdsEffortEstimateAtComplete | double | Прогноз общих усилий по выполнению задачи, как указано в расписаниях операций project. | |
| cdsPercentComplete | double | Процент выполненных работ, как указано в расписаниях операций project. | |
| cdsScheduleVariance | double | Отклонение между предполагаемой работой и прогнозируемой работой на основе оценки после завершения, как указано в расписаниях операций проекта. | |
| summary | логический | Показывает, является ли задача суммарной. | |
| resume | datetime | Дата возобновления оставшейся части задачи. | |
| Остановить | datetime | Дата, представляющая конец фактической части задачи. | |
| outlineNumber | string | Указывает точное положение задачи в структуре. Например, "7.2" указывает, что задача является второй подзадачей в седьмой сводной задаче верхнего уровня. | |
| completeThrough | datetime | Дата и время окончания фактической длительности. | |
| type | enum | Тип задачи. | FixedUnits, FixedDuration, FixedWork |
| durationDisplayFormat | enum | Формат отображения, в котором отображается длительность. | Минуты, часы, дни, недели, месяцы |
| Рухнул | логический | Указывает, свернута ли задача в представлении. | |
| Срок | datetime | Дата, введенная в качестве крайнего срока для задачи. | |
| startSlack | duration | Разница между датами раннего и позднего начала. | |
| finishSlack | duration | Разница между датами раннего и позднегофина. | |
| Заказ | double | Порядок задачи, представленной в виде двойника. | |
| Parentid | guid | Идентификатор задачи проекта Dataverse родительской задачи. | |
| scheduleDrivers | stringArray | Описывается, почему задача должна начинаться с даты ее начала. Может содержать любое из значений Actual, LevelingDelay, Constraint, Predecessor, ProjectStart, Calendar, Child, Parent, Deadline, Link. | |
| start | datetime | Дата и время начала задачи. | |
| Закончить | datetime | Дата и время запланированного завершения задачи. | |
| duration | duration | Общий период активного рабочего времени. | |
| bucketId | guid | Идентификатор контейнера проекта Dataverse, в который входит задача. | |
| bucketOrder | string | Порядок задачи в контейнере. | |
| sprintOrder | string | Порядок задачи в спринте. | |
| notes | HTML | Примечания, введенные о задаче в формате HTML. | |
| неформатированные сноски | HTML | Заметки со всеми html-кодами. | |
| Вручную | логический | Является ли эта задача пустой или имеет даты. | |
| showNotesOnCard | логический | Указывает, будет ли заметка отображаться на карта в представлении доски. | |
| showChecklistOnCard | логический | Указывает, будут ли элементы контрольного списка отображаться на карта в представлении доски. | |
| priority | integer | Указывает уровень важности, присвоенный задаче, при этом 5 — стандартный приоритет; чем меньше число, тем срочнее задача. | |
| sprintId | guid | Имя свойства спринта, которому назначена задача. | |
| gridColor | gridColor | Цветовые индексы для каждого поля в этой задаче, где параметр conditionalColoringRule имеет значение true. См. сопоставление цветовых индексов. | |
| [guid] | enum | Определение настраиваемого поля задачи. Определение см. в разделе Свойства настраиваемого поля задачи . | stringOption, datetime, double, bool, string |
Свойства настраиваемого поля задачи
| Имя свойства | Тип | Описание | Значения перечисления |
|---|---|---|---|
| id | guid | Уникальный идентификатор настраиваемого поля задачи. | |
| type | enum | Тип настраиваемого поля | stringOption, datetime, double, bool, string |
| Пользовательские | логический | Значение true, если это локальное настраиваемое поле | |
| name | string | имя настраиваемого поля | |
| Свертки | enum | Тип свертки, если type=double | max, min, sum, average |
| values | JSONArray | Значения для параметров, если type=stringOption. См . раздел Тип выбора |
Настраиваемые типы полей.
| Настраиваемый тип поля | Тип перечисления |
|---|---|
| Текст | string |
| Date | datetime |
| Номер | double |
| Да или Нет | логический |
| Выбор | stringOption |
Тип выбора
Для настраиваемых полей типа stringOption
| Имя свойства | Тип | Описание |
|---|---|---|
| ИД | guid | Уникальный идентификатор для выбора |
| значение | string | Отображение значения выбора |
| Заказ | double | Отображение порядка выбора |
| color | integer | Индекс цвета, назначенный значению. |
Просмотр свойств
Ссылка /project/views/grid/fields
| Имя свойства | Тип | Описание |
|---|---|---|
| name | string | Имя представления сетки. |
| columns | columns | Массив столбцов, отображаемых в представлении, и их ширина. |