Проекты Teamwork (предварительная версия)
Сохраняйте все задачи вашей команды в одном месте. Совместная работа и работа в режиме реального времени для реальных результатов. Teamwork Projects — это мощный и простой способ совместной работы с командой.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://www.teamwork.com/ |
| Политика конфиденциальности | https://www.teamwork.com/legal/privacy-policy/ |
Чтобы использовать триггеры в этой интеграции, сначала необходимо включить веб-перехватчики для учетной записи Teamwork Projects. Чтобы включить веб-перехватчики, щелкните "Параметры" в правом верхнем углу учетной записи "Проекты Teamwork", щелкните "Параметры сайта" и перейдите на вкладку "Веб-перехватчики". После включения параметра в учетной записи триггер автоматически зарегистрирует веб-перехватчик.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Имя пользователя | струна | Имя пользователя для этого API | True |
| Пароль | securestring | Пароль для этого API | True |
| URL-адрес сайта | струна | URL-адрес корневого сайта (пример: https://my.teamwork.com ) | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
| Частота опросов триггеров | 1 | 1 секунды |
Действия
| Вывод задачи |
Эта операция возвращает все свойства, асосциированные с определенной задачей, учитывая его идентификатор. |
| Обновление задачи |
Эта операция используется для обновления свойств конкретной задачи. |
| Перечисление задач |
Эта операция используется для возврата списка задач для данного проекта. |
| Перечисление пользователей |
Эта операция возвращает список всех пользователей, оснасченных определенным проектом. |
| Получение пользователя |
Эта операция используется для получения всех сведений о пользователе. |
| Получение проекта |
Эта операция возвращает все свойства, асосциированные с определенным проектом, с учетом его идентификатора. |
| Создание задачи |
Эта операция используется для создания новой задачи. |
| Создание пользователя |
Эта операция используется для создания нового пользователя. |
| Создание проекта |
Эта операция используется для создания нового проекта Teamwork. |
| Список проектов |
Эта операция возвращает список всех проектов, связанных с вашей учетной записью. |
| Удаление задачи |
Эта операция используется для удаления задачи. |
Вывод задачи
Эта операция возвращает все свойства, асосциированные с определенной задачей, учитывая его идентификатор.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
taskId | True | string |
Уникальный идентификатор задачи. |
Возвращаемое значение
Сведения, связанные с определенной задачей.
- Тело
- GetTask_Response
Обновление задачи
Эта операция используется для обновления свойств конкретной задачи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
taskId | True | string |
Уникальный идентификатор задачи. |
|
Имя
|
content | string |
Имя задачи. |
|
|
Description
|
description | string |
Описание задачи. |
|
|
Progress
|
progress | string |
Целое число от 0 до 90. |
|
|
Назначить пользователю
|
responsible-party-id | string |
Выберите человека. |
|
|
Дата начала
|
start-date | string |
yyyy-MM-dd |
|
|
Срок
|
due-date | string |
yyyy-MM-dd |
|
|
Предполагаемое время
|
estimated-minutes | string |
Минуты выполнения задачи. |
|
|
Priority
|
priority | string |
Выберите приоритет. |
|
|
Уведомление пользователей
|
notify | boolean |
True, чтобы уведомить людей, назначенных этой задаче по электронной почте. |
|
|
Является частным
|
private | boolean |
Значение true, чтобы сделать задачу закрытой. |
|
|
Метки
|
tags | string |
Разделенный запятыми список тегов для задачи. |
Возвращаемое значение
- Тело
- UpsertTask_Response
Перечисление задач
Эта операция используется для возврата списка задач для данного проекта.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | string |
Выберите проект. |
|
Идентификатор списка задач
|
taskListId | True | string |
Выберите список задач. |
Возвращаемое значение
- Тело
- ListTasks_Response
Перечисление пользователей
Эта операция возвращает список всех пользователей, оснасченных определенным проектом.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | string |
Выберите проект. |
Возвращаемое значение
- Тело
- ListUsers_Response
Получение пользователя
Эта операция используется для получения всех сведений о пользователе.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор пользователя
|
personId | True | string |
Уникальный идентификатор пользователя. |
Возвращаемое значение
- Тело
- GetUser_Response
Получение проекта
Эта операция возвращает все свойства, асосциированные с определенным проектом, с учетом его идентификатора.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | string |
Уникальный идентификатор проекта. |
Возвращаемое значение
- Тело
- GetProject_Response
Создание задачи
Эта операция используется для создания новой задачи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор проекта
|
projectId | True | string |
Выберите проект. |
|
Идентификатор списка задач
|
taskListId | True | string |
Выберите список задач. |
|
Имя
|
content | True | string |
Заголовок задачи. |
|
Description
|
description | string |
Сведения о задаче. |
|
|
Progress
|
progress | string |
Задайте ход выполнения от 0 до 90. |
|
|
Назначение
|
responsible-party-id | string |
Выберите пользователя. |
|
|
Дата начала
|
start-date | string |
yyyy-MM-dd |
|
|
Срок
|
due-date | string |
yyyy-MM-dd |
|
|
Предполагаемые минуты
|
estimated-minutes | string |
Для завершения задачи. |
|
|
Priority
|
priority | string |
Выберите приоритет. |
|
|
Уведомление пользователей
|
notify | boolean |
True, чтобы уведомить людей, назначенных этой задаче по электронной почте. |
|
|
Является частным
|
private | boolean |
Значение true, чтобы сделать задачу закрытой. |
|
|
Метки
|
tags | string |
Разделенный запятыми список тегов для задачи. |
Возвращаемое значение
- Тело
- UpsertTask_Response
Создание пользователя
Эта операция используется для создания нового пользователя.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Электронная почта
|
email-address | True | string |
Электронная почта пользователя. |
|
Имя (Первое имя)
|
first-name | True | string |
Имя пользователя. |
|
Фамилия
|
last-name | True | string |
Фамилия пользователя. |
|
Идентификатор компании
|
company-id | string |
Компания пользователя. |
|
|
Должность
|
title | string |
Заголовок пользователя. |
|
|
Дом
|
phone-number-home | string |
Домашний телефон пользователя. |
|
|
мобильное устройство
|
phone-number-mobile | string |
Мобильный телефон пользователя. |
|
|
Офис
|
phone-number-office | string |
Офисный телефон пользователя. |
|
|
Расширение Office
|
phone-number-office-ext | string |
Расширение телефона для офиса пользователя. |
|
|
Факс
|
phone-number-fax | string |
Номер факса пользователя. |
|
|
Имя пользователя
|
user-name | True | string |
Отображаемое имя пользователя. |
Возвращаемое значение
- Тело
- CreateUser_Response
Создание проекта
Эта операция используется для создания нового проекта Teamwork.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя
|
name | True | string |
Имя проекта. |
|
Description
|
description | string |
Дополнительные сведения о проекте. |
|
|
Идентификатор категории
|
category-id | string |
Выбор категории |
|
|
Идентификатор компании
|
companyId | string |
Выберите существующую компанию. |
|
|
Новая компания
|
newCompany | string |
Введите имя новой внешней компании. |
|
|
Дата начала
|
startDate | string |
yyyy-MM-dd |
|
|
Дата окончания
|
endDate | string |
yyyy-MM-dd |
|
|
Метки
|
tags | string |
Разделенный запятыми список тегов для проекта. |
Возвращаемое значение
Список проектов
Эта операция возвращает список всех проектов, связанных с вашей учетной записью.
Возвращаемое значение
Удаление задачи
Эта операция используется для удаления задачи.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор задачи
|
taskId | True | string |
Уникальный идентификатор задачи. |
Возвращаемое значение
- Тело
- DeleteTask_Response
Триггеры
| При создании задачи |
Эта операция активируется при создании новой задачи. |
| При создании пользователя |
Эта операция активируется при создании нового пользователя. |
| При создании проекта |
Эта операция активируется при создании нового проекта. |
При создании задачи
При создании пользователя
При создании проекта
Определения
ProjectResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор проекта
|
objectId | string |
Уникальный идентификатор проекта. |
TaskResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор задачи
|
objectId | string |
Уникальный идентификатор задачи. |
UserResponse
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор пользователя
|
objectId | string |
Уникальный идентификатор пользователя. |
CreateProject_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор проекта
|
id | string |
Уникальный идентификатор проекта. |
ListProjects_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Список проектов
|
projects | array of Project_Response |
Массив всех проектов, оснасченных вашей учетной записью. |
GetProject_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
project
|
project | Project_Response |
Project_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
category.id | string |
Уникальный идентификатор категории проекта. |
|
Имя
|
category.name | string |
Имя категории проекта. |
|
Идентификатор
|
company.id | string |
Уникальный идентификатор компании. |
|
Имя
|
company.name | string |
Имя компании. |
|
Создан Date-Time
|
created-on | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Description
|
description | string |
Дополнительные сведения о проекте. |
|
Завершение Date-Time
|
endDate | string |
yyyy-MM-dd |
|
Таймер включен
|
harvest-timers-enabled | boolean |
Значение true, если таймер сбора включен. |
|
Идентификатор проекта
|
id | string |
Уникальный идентификатор проекта. |
|
Обновленные Date-Time
|
last-changed-on | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Logo
|
logo | string |
Логотип проекта. |
|
Имя
|
name | string |
Имя проекта. |
|
Страница обзора
|
overview-start-page | string |
Url-адрес страницы обзора-начальной страницы. |
|
Конфиденциальность включена
|
privacyEnabled | boolean |
Значение True, если конфиденциальность включена. |
|
Усеянный
|
starred | boolean |
Значение true, если проект снялся. |
|
Запуск Date-Time
|
startDate | string |
yyyy-MM-dd |
|
Начальная страница
|
start-page | string |
URL-адрес начальной страницы. |
|
Состояние
|
status | string |
Состояние проекта. |
|
Подсостояние
|
subStatus | string |
Подстатус проекта. |
|
Начальная страница задач
|
tasks-start-page | string |
URL-адрес начальной страницы задач. |
|
Тип
|
type | string |
Тип проекта. |
UpsertTask_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор задачи
|
id | string |
Уникальный идентификатор задачи. |
ListTasks_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
todo-items
|
todo-items | array of Task_Response |
Список задач вместе со своими свойствами. |
GetTask_Response
Сведения, связанные с определенной задачей.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
todo-item
|
todo-item | Task_Response |
Task_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Может завершиться
|
canComplete | boolean |
Значение True, если задача может быть завершена. |
|
Может изменяться
|
canEdit | boolean |
Значение true, если задачу можно изменить. |
|
Может ли время журнала
|
canLogTime | boolean |
Значение True, если время может быть зарегистрировано в задаче. |
|
Идентификатор компании
|
company-id | integer |
Уникальный идентификатор компании. |
|
Название компании
|
company-name | string |
Имя компании. |
|
Завершено
|
completed | boolean |
True — задача завершена. |
|
Имя
|
content | string |
Заголовок задачи. |
|
Создан Date-Time
|
created-on | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
URL-адрес аватара создателя
|
creator-avatar-url | string |
URL-адрес аватара создателя задачи. |
|
Имя создателя
|
creator-firstname | string |
Имя создателя задачи. |
|
Идентификатор создателя
|
creator-id | integer |
Уникальный идентификатор создателя. |
|
Фамилия создателя
|
creator-lastname | string |
Фамилия создателя задачи. |
|
Description
|
description | string |
Описание задачи. |
|
Срок
|
due-date | string |
yyyy-MM-dd |
|
Предполагаемые минуты
|
estimated-minutes | integer |
Оценка времени для задачи. |
|
Урожай включен.
|
harvest-enabled | boolean |
Значение True, если урожай включен. |
|
Число зависимостей
|
has-dependencies | integer |
Количество зависимостей задачи. |
|
Имеет предшественники
|
has-predecessors | integer |
Число предшественников задачи. |
|
Имеет напоминания
|
has-reminders | boolean |
Значение True, если существуют напоминания. |
|
Есть билеты
|
hasTickets | boolean |
Значение True, если билеты существуют. |
|
has-unread-comments
|
has-unread-comments | boolean |
Значение true, если существуют непрочитанные комментарии. |
|
Идентификатор задачи
|
id | integer |
Уникальный идентификатор задачи. |
|
Обновленные Date-Time
|
last-changed-on | date-time |
гггг-ММ-ддTHH:мм:ss.fffZ |
|
Идентификатор блокировки
|
lockdownId | string |
Уникальный идентификатор блокировки. |
|
Идентификатор родительской задачи
|
parentTaskId | string |
Уникальный идентификатор родительской задачи. |
|
Priority
|
priority | string |
Приоритет задачи. |
|
Частный
|
private | integer |
1, если задача является частной. |
|
Progress
|
progress | integer |
Целое число от 0 до 90. |
|
Идентификатор проекта
|
project-id | integer |
Уникальный идентификатор проекта. |
|
Имя проекта
|
project-name | string |
Имя проекта. |
|
Дата начала
|
start-date | string |
yyyy-MM-dd |
|
Состояние
|
status | string |
Удалены, завершены, вновь открыты или новые. |
|
Идентификатор списка todo
|
todo-list-id | integer |
Уникальный идентификатор списка todo. |
|
Имя списка todo
|
todo-list-name | string |
Имя списка todo. |
|
Следующие изменения
|
userFollowingChanges | boolean |
Значение true, если пользователь выполняет следующие изменения. |
|
Следующие комментарии
|
userFollowingComments | boolean |
Значение true, если пользователь следует за комментариями. |
DeleteTask_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор задачи
|
affectedTaskIds | string |
Уникальный идентификатор задачи. |
CreateUser_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор пользователя
|
id | string |
Уникальный идентификатор пользователя. |
ListUsers_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Users
|
people | array of User_Response |
Список пользователей. |
GetUser_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Человек
|
person | User_Response |
User_Response
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
URL-адрес аватара
|
avatar-url | string |
URL-адрес аватара пользователя. |
|
Идентификатор компании
|
company-id | string |
Уникальный идентификатор компании. |
|
Название компании
|
company-name | string |
Имя компании. |
|
Электронная почта
|
email-address | string |
Электронная почта пользователя. |
|
Альтернативный адрес электронной почты 1
|
email-alt-1 | string |
Альтернативный адрес электронной почты пользователя. |
|
Имя (Первое имя)
|
first-name | string |
Имя пользователя. |
|
Идентификатор пользователя
|
id | string |
Уникальный идентификатор пользователя. |
|
Фамилия
|
last-name | string |
Фамилия пользователя, |
|
Примечания.
|
notes | string |
Заметки о пользователе. |
|
Открытый идентификатор
|
openId | string |
Открытый идентификатор пользователя. |
|
номер факса;
|
phone-number-fax | string |
Номер факса пользователя. |
|
Дом
|
phone-number-home | string |
Домашний телефон пользователя. |
|
мобильное устройство
|
phone-number-mobile | string |
Мобильный номер пользователя. |
|
Код страны
|
phone-number-mobile-parts.countryCode | string |
Мобильный номер пользователя. |
|
Телефон
|
phone-number-mobile-parts.phone | string |
Мобильный номер пользователя. |
|
Приставка
|
phone-number-mobile-parts.prefix | string |
Мобильный номер пользователя. |
|
Офис
|
phone-number-office | string |
Номер телефона офиса пользователя. |
|
Расширение Office
|
phone-number-office-ext | string |
Номер телефона офиса пользователя. |
|
Pid
|
pid | string |
Pid пользователя. |
|
Название
|
title | string |
Заголовок пользователя. |
|
Твиттер
|
string |
Дескриптор twitter пользователя. |
|
|
Имя пользователя
|
user-name | string |
Отображаемое имя пользователя. |
|
Тип
|
user-type | string |
Тип пользователя. |
|
UUID (Универсальный уникальный идентификатор)
|
userUUID | string |
UUID пользователя. |