Экспорт определения содержимого проекта

Статья
06/25/2023

Страница описывает формат выходных данных и определение 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	Массив столбцов, отображаемых в представлении, и их ширина.

Поделиться через