Teams-Spirit (предварительная версия)
Соединитель Teams-Spirit позволяет подключить подписку Teams-Spirit к потокам.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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) |
| Контакт | |
|---|---|
| Имя | Иммануэль Фукс |
| URL | https://teams-spirit.de/#kontakt |
| Адрес электронной почты | info@digitalteamwork.de |
| Метаданные соединителя | |
|---|---|
| Publisher | D.F.K. Digitalteamwork GmbH |
| Веб-сайт | https://teams-spirit.de |
| Политика конфиденциальности | https://teams-spirit.de/datenschutz/ |
| Категории | Коммуникация; Продуктивность |
Соединитель Teams-Spirit
Teams-Spirit предоставляет обширный REST API. С помощью этого API вы можете управлять утверждениями, командами и пользователями с помощью Teams-Spirit.
Издатель: D.F.K. Digital Teamwork GmbH
Предпосылки
Для продолжения вам потребуется следующее:
- План Microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
- Teams-Spirit корпоративное приложение Azure AD (обычно это будет присутствовать при использовании Teams-Spirit)
- Подписка Teams-Spirit
- Средства командной строки Power Platform
Поддерживаемые операции
Соединитель предоставляет следующие триггеры:
Action-Trigger
Можно активировать с помощью Teams-Spirit действия Соединитель поддерживает следующие операции:
Получение всех утверждений
Список всех утверждений
Утверждает
Утверждает утверждение
Отклонение
Отклонение утверждения
Команда архивирования
Архивирует команду и при необходимости помечает сайт SharePoint как доступный только для чтения
Удаление команды
Удаляет команду
Изменение роли на член
Изменение роли пользователей на участника
Изменение роли на владельца
Изменение роли пользователей на владельца
Удаление всех гостей
Удаляет всех гостей из команды
Удаление всех пользователей, кроме владельца
Удаляет всех участников команды, кроме заданного владельца
Удаление пользователя из команды
Удаляет пользователя из команды
Изменение значения тега
Изменяет значение тега Teams-Spirit
Получение значения тега
Возвращает значение тега Teams-Spirit
Продление срока действия
Продление срока действия команд
Получение учетных данных
Соединитель Teams-Spirit использует OAuth2 для Azure Active Directory (AD). Это тот же метод проверки подлинности, используемый самим приложением Teams-Spirit, поэтому у пользователя будут одинаковые разрешения как в соединителе, так и в приложении.
Начало работы
Если требуется, чтобы поток активировался правилом Teams-Spirit, можно создать новый поток с помощью триггера действия. Получив имя, оно зарегистрирует себя в Teams-Spirit и будет доступно в обработчике правил. Каждый параметр, доступный в правиле Teams-Spirit, можно отправить в поток и использовать его для дальнейшего автоматизации рабочих процессов.
Инструкции по развертыванию
Так как API Teams-Spirit защищены Azure Active Directory (AD) через OAuth2, сначала необходимо настроить несколько элементов в Azure AD, чтобы наши соединители могли безопасно получить доступ к API. После завершения работы можно создать и проверить соединитель.
Настройка приложения Azure AD для пользовательского соединителя
Сначала необходимо зарегистрировать соединитель в качестве приложения в Azure AD. Это позволит соединителю идентифицировать себя в Azure AD, чтобы он смог запросить разрешения на доступ к данным Teams-Spirit от имени конечного пользователя. Чтобы выполнить следующие действия, выполните следующие действия.
Создайте приложение Azure AD, которое будет использоваться для идентификации соединителя с Teams-Spirit. Это можно сделать с помощью [портала Azure] (https://portal.azure.com), выполнив действия, описанные здесь. После создания запишите значение идентификатора приложения (клиента). Вам потребуется это позже.
Настройте (обновите) приложение Azure AD для доступа к API Teams-Spirit Этот шаг обеспечит успешное получение маркера доступа для вызова Teams-Spirit от имени пользователей. Для этого выполните действия, описанные здесь.
- Для URI перенаправления используйте "https://global.consent.azure-apim.net/redirect"
- Для учетных данных используйте секрет клиента (а не сертификаты). Не забудьте заметить секрет вниз, вам потребуется это позже, и оно отображается только один раз.
- Для разрешений API добавьте разрешение Teams-Spirit
access_as_user. Чтобы сделать этоAdd a permission, перейдитеAPIs my organization usesк, найдите Teams-Spirit и добавьтеaccess_as_userразрешение.
На этом этапе у нас есть допустимое приложение Azure AD, которое можно использовать для получения разрешений от конечных пользователей и доступа к Teams-Spirit.
Развертывание соединителя
Сначала замените {clientId}apiProperties.json идентификатор клиента приложений Azure AD.
Он {resourceId} должен быть заменен api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user на случай развертывания пользовательского соединителя.
Затем выполните следующие команды и следуйте указаниям:
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Изменение значения тега |
Изменение значения тега в заданной команде |
| Изменение роли на владельца |
Продвижение пользователя в команде владельцу |
| Изменение роли на член |
Изменение роли пользователей на участника в команде |
| Команда архивирования |
Архивирует команду |
| Отклонение |
Отклонение |
| Получение всех утверждений |
Получение всех утверждений |
| Получение значения тега |
Возвращает значение тегов для группы |
| Продление срока действия |
Расширяет дату окончания срока действия групп |
| Удаление всех гостей |
Удаляет всех гостей из команды |
| Удаление всех невладельцев из команды |
Удаляет все элементы, эксплипты для владельцев из команды |
| Удаление всех пользователей, кроме владельца |
Удаляет всех пользователей, кроме одного выбранного владельца |
| Удаление команды |
Удаляет команду |
| Удаление пользователя из команды |
Удаляет пользователя из команды |
| Утвердить |
Утверждает данное утверждение |
Изменение значения тега
Изменение значения тега в заданной команде
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Тег
|
id | string |
id |
|
|
Ценность
|
value | string |
value |
Изменение роли на владельца
Продвижение пользователя в команде владельцу
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Идентификатор пользователя
|
userId | string |
userId |
Изменение роли на член
Изменение роли пользователей на участника в команде
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Идентификатор пользователя
|
userId | string |
userId |
Команда архивирования
Архивирует команду
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Создание сайта SharePoint только для чтения для участников команды
|
sharePointReadOnly | True | boolean |
sharePointReadOnly |
Отклонение
Отклонение
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор утверждения
|
Approval-ID | True | string |
Идентификатор утверждения |
Получение всех утверждений
Получение всех утверждений
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of object | ||
|
id
|
id | string |
id |
|
userName
|
userName | string |
userName |
|
userId
|
userId | string |
userId |
|
createForExternalUser
|
createForExternalUser | boolean |
createForExternalUser |
|
externalUserId
|
externalUserId | string |
externalUserId |
|
reactingUserId
|
reactingUserId | string |
reactingUserId |
|
reactingUserName
|
reactingUserName | string |
reactingUserName |
|
requestTime
|
requestTime | string |
requestTime |
|
expirationDateTime
|
expirationDateTime | string |
expirationDateTime |
|
статус
|
status | integer |
статус |
|
groupName
|
groupName | string |
groupName |
|
groupDescription
|
groupDescription | string |
groupDescription |
|
причина
|
reason | string |
причина |
|
rejectReason
|
rejectReason | string |
rejectReason |
|
доступ
|
access | boolean |
доступ |
|
reactionTime
|
reactionTime | string |
reactionTime |
|
type
|
type | string |
type |
|
время
|
tid | string |
время |
|
идентификатор шаблона
|
templateId | string |
идентификатор шаблона |
|
attributeSettings
|
attributeSettings | array of object |
attributeSettings |
|
attributeId
|
attributeSettings.attributeId | string |
attributeId |
|
value
|
attributeSettings.value | string |
value |
|
type
|
attributeSettings.type | integer |
type |
Получение значения тега
Возвращает значение тегов для группы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Идентификатор тега
|
Tag-ID | True | string |
Идентификатор тега |
Возвращаемое значение
- Значение тега
- string
Продление срока действия
Расширяет дату окончания срока действия групп
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Недели
|
weeks | string |
Недель |
Удаление всех гостей
Удаляет всех гостей из команды
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
Удаление всех невладельцев из команды
Удаляет все элементы, эксплипты для владельцев из команды
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
Удаление всех пользователей, кроме владельца
Удаляет всех пользователей, кроме одного выбранного владельца
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Идентификатор владельца
|
ownerId | string |
ownerId |
Удаление команды
Удаляет команду
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
Удаление пользователя из команды
Удаляет пользователя из команды
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор группы
|
Group-ID | True | string |
Идентификатор группы |
|
Идентификатор пользователя
|
userId | string |
userId |
Утвердить
Утверждает данное утверждение
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор утверждения
|
Approval-ID | True | string |
Идентификатор утверждения |
Триггеры
| Action-Trigger |
Action-Trigger |
Action-Trigger
Action-Trigger
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Имя
|
name | True | string |
Имя |
Возвращаемое значение
- response
- object
Определения
объект
Это тип object.
струна
Это базовый тип данных string.