PPM Express (предварительная версия)
PPM Express — это программное обеспечение для управления портфелями проектов в Интернете. Соединитель в PPM Express позволяет получать сведения о сущностях (Project, Idea, Task, Key Date, Resource) из клиента PPM Express, а также создавать новые или обновлять существующие.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка PPM Express |
| URL | https://ppm.express/contact-us/ |
| Адрес электронной почты | support@ppm.express |
| Метаданные соединителя | |
|---|---|
| Publisher | PPM Express Corporation |
| Веб-сайт | https://ppm.express |
| Политика конфиденциальности | https://ppm.express/privacy-policy |
| Категории | Управление бизнесом; Бизнес-аналитика |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Ключ API | securestring | Личный маркер доступа для PPM Express | True |
| Регион клиента | струна | Регион, в котором размещен клиент PPM Express | True |
| Имя клиента. | струна | Имя клиента | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Обновление даты ключа |
Обновление даты ключа |
| Обновление задачи |
Обновляет существующую задачу |
| Обновление задачи |
Обновление задачи |
| Обновление идеи |
Обновляет существующую идею |
| Обновление проекта |
Обновляет указанные поля project |
| Обновление ресурса |
Обновление ресурса |
| Обновление этапа идеи |
Обновляет этап идеи |
| Получение даты ключа |
Возвращает сведения о дате ключа по идентификатору |
| Получение задачи |
Возвращает существующую задачу по идентификатору |
| Получение задачи |
Получает задачу по идентификатору и по проекту |
| Получение идеи |
Возвращает существующую идею по идентификатору |
| Получение полей |
Возвращает сведения о полях для указанной сущности (например, Project, Idea, Resource и т. д.) |
| Получение проекта |
Возвращает сведения о проекте по идентификатору |
| Получение ресурса |
Возвращает ресурс по идентификатору |
| Получение списка задач |
Возвращает список всех задач для указанного проекта |
| Получение списка идей |
Возвращает все идеи или указанную задачу |
| Получение списка ключевых дат |
Возвращает список всех ключевых дат для указанного проекта |
| Получение списка проблем |
Возвращает все проблемы |
| Получение списка проектов |
Возвращает список всех проектов |
| Получение списка ресурсов |
Возвращает список всех ресурсов |
| Получение текущего пользователя |
Возвращает текущие сведения о пользователе и маркере |
| Создание даты ключа |
Создает новую дату ключа |
| Создание задачи |
Создает новую задачу |
| Создание задачи |
Создает задачу для указанного проекта |
| Создание идеи |
Создает новую идею для указанной задачи |
| Создание проекта |
Создание нового проекта |
| Создание ресурса |
Создание ресурса |
Обновление даты ключа
Обновление даты ключа
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
|
Идентификатор keyDate
|
keyDateId | True | uuid |
Уникальный идентификатор KeyDate |
Возвращаемое значение
Обновление задачи
Обновляет существующую задачу
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
id | True | uuid |
Уникальный идентификатор задачи |
Возвращаемое значение
Обновление задачи
Обновление задачи
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
|
Идентификатор задачи
|
taskId | True | uuid |
Уникальный идентификатор задачи |
Возвращаемое значение
- Тело
- TaskResponseResponse
Обновление идеи
Обновляет существующую идею
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор идеи
|
id | True | uuid |
Уникальный идентификатор идеи |
Возвращаемое значение
- Тело
- IdeaResponseResponse
Обновление проекта
Обновляет указанные поля project
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
Возвращаемое значение
Обновление ресурса
Обновление ресурса
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор ресурса
|
id | True | uuid |
Уникальный идентификатор ресурса |
Возвращаемое значение
Обновление этапа идеи
Обновляет этап идеи
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор идеи
|
id | True | uuid |
Уникальный идентификатор идеи |
|
Этап идеи
|
stage | string |
Этап идеи |
Возвращаемое значение
- Тело
- IdeaResponseResponse
Получение даты ключа
Возвращает сведения о дате ключа по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
|
Идентификатор keyDate
|
keyDateId | True | uuid |
Уникальный идентификатор KeyDate |
Возвращаемое значение
Получение задачи
Возвращает существующую задачу по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
id | True | uuid |
Уникальный идентификатор задачи |
Возвращаемое значение
Получение задачи
Получает задачу по идентификатору и по проекту
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
|
Идентификатор задачи
|
taskId | True | uuid |
Уникальный идентификатор задачи |
Возвращаемое значение
- Тело
- TaskResponseResponse
Получение идеи
Возвращает существующую идею по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор идеи
|
id | True | uuid |
Уникальный идентификатор идеи |
Возвращаемое значение
- Тело
- IdeaResponseResponse
Получение полей
Возвращает сведения о полях для указанной сущности (например, Project, Idea, Resource и т. д.)
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Объект
|
entity | True | string |
имя сущности, |
Возвращаемое значение
- Тело
- FieldResponseList
Получение проекта
Возвращает сведения о проекте по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
Возвращаемое значение
Получение ресурса
Возвращает ресурс по идентификатору
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор ресурса
|
id | True | uuid |
Уникальный идентификатор ресурса |
Возвращаемое значение
Получение списка задач
Возвращает список всех задач для указанного проекта
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
Возвращаемое значение
- Тело
- TaskResponseListTask
Получение списка идей
Возвращает все идеи или указанную задачу
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
challengeId | uuid |
Укажите идентификатор задачи |
Возвращаемое значение
Получение списка ключевых дат
Возвращает список всех ключевых дат для указанного проекта
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
Возвращаемое значение
Получение списка проблем
Получение списка проектов
Возвращает список всех проектов
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
|
object |
Возвращаемое значение
Получение списка ресурсов
Возвращает список всех ресурсов
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
|
object |
Возвращаемое значение
Получение текущего пользователя
Возвращает текущие сведения о пользователе и маркере
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
|
object |
Возвращаемое значение
- Тело
- MeResponseResponse
Создание даты ключа
Создает новую дату ключа
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
Возвращаемое значение
Создание задачи
Создание задачи
Создает задачу для указанного проекта
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
id | True | uuid |
Уникальный идентификатор проекта |
Возвращаемое значение
- Тело
- TaskResponseResponse
Создание идеи
Создает новую идею для указанной задачи
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
challengeId | uuid |
Идентификатор задачи, к какой идее относится |
Возвращаемое значение
- Тело
- IdeaResponseResponse
Создание проекта
Создание ресурса
Триггеры
| Триггер веб-перехватчика |
При выполнении операции в сущности в PPM Express |
Триггер веб-перехватчика
При выполнении операции в сущности в PPM Express
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Типы событий
|
eventTypes | True | array of string |
Выбор событий для прослушивания |
|
Имя
|
name | string |
Имя пользовательского заголовка |
|
|
Ценность
|
value | string |
Настраиваемое значение заголовка |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
WebhookId
|
WebhookId | string | |
|
MessageId
|
MessageId | string | |
|
Данные
|
Data | object |
Определения
ChallengeAttributes
Поля вызовов (например, {"Имя": "Мое имя", "Описание": "TBD"})
ChallengeResponse
Сведения об испытании
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
id
|
id | uuid |
Идентификатор задачи |
|
Attributes
|
attributes | ChallengeAttributes |
Поля вызовов (например, {"Имя": "Мое имя", "Описание": "TBD"}) |
ChallengeResponseListResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | array of ChallengeResponse |
ChallengeResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | ChallengeResponse |
Сведения об испытании |
FieldResponse
Сведения о поле
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Key
|
key | string |
Ключ поля |
|
Название поля
|
label | string |
Метка поля |
|
Тип поля
|
type | string |
Тип поля |
|
Is MultiChoice
|
isMultiChoice | boolean |
Многочойное поле |
|
Is ReadOnly
|
isReadonly | boolean |
Является ли поле чтением |
|
Параметры поля
|
settings | object |
Настраиваемые параметры для поля |
FieldResponseList
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Fields
|
data | array of FieldResponse |
Список полей для выбранной сущности |
IdeaAttributes
Поля идеи (например, {"Имя": "Мое имя", "Описание": "TBD"})
IdeaResponse
Сведения о идее
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор идеи
|
id | uuid |
Уникальный идентификатор Idea |
|
Attributes
|
attributes | IdeaAttributes |
Поля идеи (например, {"Имя": "Мое имя", "Описание": "TBD"}) |
|
Голоса
|
votes | integer |
Количество голосов за идею |
IdeaResponseListResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идеи
|
data | array of IdeaResponse |
Список идей |
IdeaResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | IdeaResponse |
Сведения о идее |
KeyDateAttributes
Поля key Date (например, {"Name": "My Name", "Description": "TBD"})
KeyDateResponse
Сведения о ключевой дате
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор keyDate
|
id | uuid |
Уникальный идентификатор даты ключа |
|
Поля KeyDate
|
attributes | KeyDateAttributes |
Поля key Date (например, {"Name": "My Name", "Description": "TBD"}) |
|
Тип источника
|
sourceType | SourceType |
Тип источника данных |
KeyDateResponseListResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | array of KeyDateResponse |
KeyDateResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | KeyDateResponse |
Сведения о ключевой дате |
MeResponse
Сведения о пользователе
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор пользователя
|
id | uuid |
Уникальный идентификатор пользователя |
|
Учетная запись входа
|
logonAccount | string |
Учетная запись входа пользователя |
|
Адрес электронной почты
|
string |
Электронная почта пользователя |
|
|
token
|
token | TokenInfo |
MeResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | MeResponse |
Сведения о пользователе |
ProjectAttributes
Поля проекта (например, {"Имя": "Мое имя", "Описание": "TBD"})
ProjectResponse
Сведения о проекте
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор проекта
|
id | uuid |
Уникальный идентификатор проекта |
|
Поля проекта
|
attributes | ProjectAttributes |
Поля проекта (например, {"Имя": "Мое имя", "Описание": "TBD"}) |
ProjectResponseListResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Проекты
|
data | array of ProjectResponse |
Список проектов |
ProjectResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | ProjectResponse |
Сведения о проекте |
ResourceAttributes
Поля ресурсов (например, {"Name": "My Name", "Description": "TBD"})
ResourceResponse
Сведения о ресурсах
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Уникальный идентификатор ресурса
|
id | uuid |
Идентификатор ресурса |
|
Поля ресурсов
|
attributes | ResourceAttributes |
Поля ресурсов (например, {"Name": "My Name", "Description": "TBD"}) |
ResourceResponseListResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Ресурсы
|
data | array of ResourceResponse |
Список ресурсов |
ResourceResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | ResourceResponse |
Сведения о ресурсах |
Тип источника
Базовые данные
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
date
|
date | date-time | |
|
startDate
|
startDate | date-time | |
|
dueDate
|
dueDate | date-time | |
|
duration
|
duration | integer | |
|
effort
|
effort | double | |
|
originalEstimate
|
originalEstimate | double |
TaskAttributes
Поля задач (например, {"Name": "My Name", "Description": "TBD"})
TaskResponse
Сведения о задаче
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор задачи
|
id | uuid |
Уникальный идентификатор задачи |
|
Поля задач
|
attributes | TaskAttributes |
Поля задач (например, {"Name": "My Name", "Description": "TBD"}) |
|
Тип источника
|
sourceType | SourceType |
Тип источника данных |
|
базис
|
baseline | BaselineData |
TaskResponseListTask
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Tasks
|
data | array of TaskResponse |
Список задач |
TaskResponseResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
данные
|
data | TaskResponse |
Сведения о задаче |
TokenInfo
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор маркера
|
id | uuid |
Уникальный идентификатор токена |
|
Имя токена
|
name | string |
Имя маркера API |
|
Дата окончания срока действия маркера
|
expirationDate | date-time |
Дата окончания срока действия маркера API |
|
Scopes
|
scopes | array of string |
Массив разрешенных действий |