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

Teamflect (предварительная версия)

Повышение эффективности рабочего процесса с помощью Teamflect. Легко интегрируйте надежные функции управления производительностью Teamflect, включая цели, отзывы и отзывы, в существующую экосистему. Автоматизация стандартных задач, синхронизация данных на разных платформах и создание динамических, управляемых данными рабочих процессов для повышения производительности и участия в организации.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга 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)
Контакт
Имя Бора Unlu
URL https://teamflect.com/contact-us
Адрес электронной почты support@teamflect.com
Метаданные соединителя
Publisher Teamflect
Веб-сайт https://teamflect.com
Политика конфиденциальности https://teamflect.com/privacy
Категории Управление бизнесом

Соединитель Teamflect Power Automate

Примечание. Это настраиваемый соединитель, предоставляемый для интеграции обширных API Teamflect в автоматизированные рабочие процессы в Power Automate и Power Apps.

Соединитель Teamflect Power Automate позволяет управлять целями, отзывами, распознаваниями и задачами непосредственно из автоматизированных рабочих процессов. Используя этот соединитель, пользователи могут упростить процессы управления производительностью, интегрируя их с Microsoft Power Automate.

Предпосылки

Чтобы использовать этот соединитель, вам потребуется следующее:

  1. План Microsoft Power Apps или Power Automate , включающий поддержку пользовательских соединителей.

  2. Учетная запись Teamflect с необходимыми разрешениями API для доступа к соответствующим данным.

  3. Средства командной строки Power Platform для создания и развертывания соединителя.

Создание соединителя

API Teamflect защищены с помощью ключей API. Чтобы получить доступ к API через этот соединитель, необходимо получить ключ API Teamflect и настроить его безопасно в Power Automate.

Действия по сборке и настройке соединителя:

  1. Получите ключ API:

    • Войдите в учетную запись Teamflect и перейдите на страницу параметров API.

    • Создайте ключ API и сохраните его безопасно. Этот ключ потребуется использовать при настройке соединителя.

  2. Скачивание файлов соединителя:

    • Убедитесь, что у вас есть определение API (файл OpenAPI/Swagger) для API Teamflect. Этот файл определяет операции и структуру данных, поддерживаемые соединителем.

  3. Разверните соединитель:

    • Используйте интерфейс командной строки Power Platform для развертывания соединителя.

    • Выполните следующую команду, чтобы создать соединитель:

      paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <api_key>

  4. Проверьте соединитель:

    • После развертывания проверьте соединитель, создав поток Power Automate с помощью любой из поддерживаемых операций.

Поддерживаемые операции

Соединитель Teamflect поддерживает следующие операции:

Управление отзывами

  • Отправить запрос обратной связи: инициируйте запрос обратной связи для указанного пользователя.

  • Отправка запроса на внешний отзыв: отправка запроса обратной связи на внешний адрес электронной почты.

Управление целями

  • Получение цели по идентификатору: получение сведений о конкретной цели.

  • Получение целей. Вывод списка нескольких целей на основе критериев поиска.

  • Создание новой цели: создание новой цели для пользователя.

  • Обновление хода выполнения цели: обновите ход выполнения или состояние цели.

  • Комментарий к цели: добавьте комментарий к цели.

Признания

  • Создание распознавания: создание нового распознавания для одного или нескольких пользователей.

  • Получение распознавания по идентификатору: получение сведений о конкретном распознавании.

  • Получение распознаваний: перечисление нескольких распознаваний.

Управление задачами

  • Получение задачи по идентификатору: получение задачи по уникальному идентификатору.

  • Получение задач: вывод списка задач на основе критериев поиска.

Заметки о развертывании

  • Убедитесь, что ключ API хранится безопасно и не является общедоступным.

  • Используйте соединитель ответственно, чтобы избежать ограничения скорости API.

  • Дополнительные сведения об API см. в документации по API Teamflect, включая коды ошибок и дополнительные параметры.

Дополнительные сведения

Дополнительные сведения о платформе Teamflect см. на нашем веб-сайте. Если у вас возникли проблемы или нужна помощь, обратитесь в нашу службу support@teamflect.comподдержки.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
Ключ API securestring Ключ API для этого API True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Возвращает задачи на основе примененных фильтров

Возвращает задачи на основе примененных фильтров
Возвращает распознавания на основе примененных фильтров

Возвращает распознавания на основе примененных фильтров
Возвращает цели на основе примененных фильтров

Возвращает цели на основе примененных фильтров
Добавляет комментарий к цели

Добавляет новый комментарий к цели
Обновление хода выполнения цели

Обновление хода выполнения цели
Обновляет пользователя с выбранными атрибутами

Обновляет атрибуты пользователя
Отправляет новый внешний запрос обратной связи

Отправляет новый внешний запрос обратной связи
Отправляет новый запрос на отзыв

Отправляет новый запрос обратной связи.
Получает задачу по идентификатору

Получает задачу по идентификатору
Получает пользователя по почте

Получает пользователя по почте
Получает распознавание по идентификатору

Получает распознавание по идентификатору
Получает цель по идентификатору

Получает цель по идентификатору
Создает новое распознавание

Создает новое распознавание
Создает новую цель

Создает новую цель

Возвращает задачи на основе примененных фильтров

Идентификатор операции:
Get_tasks

Возвращает задачи на основе примененных фильтров

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор объекта пользователя
 userOID string

Идентификатор объекта пользователя, задачи которого необходимо получить
Электронная почта пользователя
 userUPN string

Имя участника-пользователя (электронная почта), задачи которого необходимо извлечь
Поиск текста
 search string

Текст для поиска в заголовках и описаниях задач
Ограничение результатов
 limit number

Максимальное количество возвращаемых задач
Пропустить число
 skip number

Количество задач, которые нужно пропустить для разбиения на страницы
Дата начала
 startDate string

Дата начала для задач фильтрации
Дата окончания
 endDate string

Дата окончания задач фильтрации

Возвращаемое значение

Товары
Tasks

Возвращает распознавания на основе примененных фильтров

Идентификатор операции:
Get_recognitions

Возвращает распознавания на основе примененных фильтров

Параметры

Имя Ключ Обязательно Тип Описание
Получатели для поиска
 recipientsIdsOrUPNS True array of string

Список сообщений электронной почты или идентификаторов получателей для поиска
Заголовок распознавания
 title True string

Заголовок распознавания для поиска
Дата обновления
 updated True string

Дата последнего обновления для фильтрации по
Дата создания
 created True string

Дата создания для фильтрации по

Возвращаемое значение

Товары
RecognitionResponses

Возвращает цели на основе примененных фильтров

Идентификатор операции:
Get_goals

Возвращает цели на основе примененных фильтров

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор объекта пользователя
 userOID string

Идентификатор объекта пользователя, цели которого необходимо получить
Электронная почта пользователя
 userUPN string

Имя участника-пользователя (электронная почта), цель которого получить
Поиск текста
 search string

Текст для поиска в заголовках и описаниях целей
Метки цели
 selectedLabels string

Метки для фильтрации целей по
Ограничение результатов
 limit string

Максимальное количество возвращаемых целей
Пропустить число
 skip string

Количество целей, которые следует пропустить для разбиения на страницы
Дата начала
 startDate string

Дата начала фильтрации целей
Дата окончания
 endDate string

Дата окончания для целей фильтрации

Возвращаемое значение

Товары
Goals

Добавляет комментарий к цели

Идентификатор операции:
Add_comment_goal

Добавляет новый комментарий к цели

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор цели
 goalId True string

Идентификатор цели
Идентификатор объекта или имя участника-пользователя комментатора
 commenterIdOrUPN True string

Идентификатор объекта или имя участника-пользователя комментатора
Примечания
 commentText True string

Примечания

Возвращаемое значение

Тело
Goal

Обновление хода выполнения цели

Идентификатор операции:
Update_goal

Обновление хода выполнения цели

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор цели
 goalId True string

Уникальный идентификатор цели для обновления
Новое значение хода выполнения
 newValue True string

Новое значение хода выполнения для цели
Обновление примечания
 comment string

Комментарий об обновлении хода выполнения
Новое состояние
 status string

Новое состояние цели
Тип updater
 goalUpdater True string

Кто обновляет цель (владелец или система)
Имя системы
 goalUpdaterSystemName True string

Имя системы обновления цели

Возвращаемое значение

Тело
Goal

Обновляет пользователя с выбранными атрибутами

Идентификатор операции:
Update_user

Обновляет атрибуты пользователя

Параметры

Имя Ключ Обязательно Тип Описание
Электронная почта пользователя
 userMail string

Адрес электронной почты пользователя для обновления.
Метка атрибута
 label string

Имя атрибута для обновления.
Значение атрибута
 value string

Значение атрибута для обновления.

Отправляет новый внешний запрос обратной связи

Идентификатор операции:
Send_external_feedback_Request

Отправляет новый внешний запрос обратной связи

Параметры

Имя Ключ Обязательно Тип Описание
Тема отзывов
 feedbackAboutUPNorId True string

Электронная почта или идентификатор пользователя, получающего отзыв
Внешняя электронная почта
 externalEmail True string

Адрес электронной почты внешнего поставщика отзывов
Имя поставщика
 onBehalfName True string

Имя для внешнего поставщика отзывов
Заметка о запросе
 feedbackNote True string

Примечание для включения в запрос обратной связи
Заголовок шаблона
 templateTitle True string

Заголовок шаблона обратной связи для использования
Срок выполнения дней
 dueDateInDays True number

Количество дней до тех пор, пока обратная связь не будет вызвана
Является частным
 isPrivate True boolean

Должна ли обратная связь быть частной
Анонимный
 isAnonymous True boolean

Должна ли обратная связь быть анонимной

Возвращаемое значение

Тело
Feedback

Отправляет новый запрос на отзыв

Идентификатор операции:
Send_feedback_request

Отправляет новый запрос обратной связи.

Параметры

Имя Ключ Обязательно Тип Описание
Тема отзывов
 feedbackAboutUPNorId True string

Электронная почта или идентификатор пользователя, получающего отзыв
Поставщик отзывов
 feedbackRequestReceiverUPNorId True string

Электронная почта или идентификатор пользователя, который предоставит отзыв
Заметка о запросе
 feedbackNote True string

Примечание для включения в запрос обратной связи
Заголовок шаблона
 templateTitle True string

Заголовок шаблона обратной связи для использования
Срок выполнения дней
 dueDateInDays True number

Количество дней до тех пор, пока обратная связь не будет вызвана
Является частным
 isPrivate True boolean

Должна ли обратная связь быть частной

Возвращаемое значение

Тело
Feedback

Получает задачу по идентификатору

Идентификатор операции:
Get_task

Получает задачу по идентификатору

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор задачи
 taskId True string

Уникальный идентификатор задачи для получения

Возвращаемое значение

Тело
Task

Получает пользователя по почте

Идентификатор операции:
Get_user

Получает пользователя по почте

Параметры

Имя Ключ Обязательно Тип Описание
Электронная почта пользователя
 userMail True string

Адрес электронной почты пользователя для получения

Возвращаемое значение

Тело
User

Получает распознавание по идентификатору

Идентификатор операции:
Get_recognition

Получает распознавание по идентификатору

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор распознавания
 recognitionId True string

Уникальный идентификатор распознавания для получения

Возвращаемое значение

Тело
RecognitionResponse

Получает цель по идентификатору

Идентификатор операции:
Get_goal

Получает цель по идентификатору

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор цели
 goalId True string

Уникальный идентификатор цели для получения

Возвращаемое значение

Тело
Goal

Создает новое распознавание

Идентификатор операции:
Create_recognition

Создает новое распознавание

Параметры

Имя Ключ Обязательно Тип Описание
Отправитель распознавания
 senderIdOrUPN True string

Электронная почта или идентификатор пользователя, отправляющего распознавание
Получатели распознавания
 recipientsIdsOrUPNS True array of string

Список электронных писем или идентификаторов пользователей, получающих признание
Заголовок значка
 badgeTitle True string

Заголовок значка распознавания
Является частным
 isPrivate True boolean

Является ли распознавание частным
Сообщение распознавания
 description True string

Сообщение, включенное в распознавание

Возвращаемое значение

Тело
RecognitionCreateResponse

Создает новую цель

Идентификатор операции:
Create_goal

Создает новую цель

Параметры

Имя Ключ Обязательно Тип Описание
Заголовок цели
 title True string

Название новой цели
Description
 description True string

Подробное описание новой цели
Дата начала
 startDate True string

Дата начала цели
Срок
 dueDate True string

Дата завершения цели
Тип цели
 goalType True string

Тип цели
Владелец цели
 goalOwnerUPNorId True

Электронная почта или идентификатор владельца цели
Создатель цели
 goalCreatorUPNorId True string

Электронная почта или идентификатор создателя цели
Является частным
 isPrivate True boolean

Должна ли цель быть частной
Формат хода выполнения
 progressFormatType True string

Тип формата для отслеживания хода выполнения
Код Валюты
 currencyCode True string

Код валюты для денежных целей
Начальное значение
 initialValue True number

Начальное значение хода выполнения
Целевое значение
 targetValue True number

Целевое значение хода выполнения
Идентификатор родительской цели
 parentGoalId True string

Идентификатор родительской цели, если это подцель
Уведомление владельца
 sendNotificationToOwner True boolean

Уведомлять владельца цели

Возвращаемое значение

Тело
Goal

Определения

Feedback

Имя Путь Тип Описание
Идентификатор обратной связи
 id string

Уникальный идентификатор обратной связи
Дата создания
 createdAt string

Дата и время создания обратной связи
oid
 createdBy.oid string
отображаемое имя
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
oid
 feedbackAboutUser.oid string
отображаемое имя
 feedbackAboutUser.displayName string
userPrincipalName
 feedbackAboutUser.userPrincipalName string
oid
 feedbackRequestRecipient.oid string
отображаемое имя
 feedbackRequestRecipient.displayName string
userPrincipalName
 feedbackRequestRecipient.userPrincipalName string
заметка
 note string
isPrivate
 isPrivate boolean

Цель

Имя Путь Тип Описание
oid
 createdBy.oid string
отображаемое имя
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
startDate
 startDate string
dueDate
 dueDate string
owners
 owners array of object
почта
 owners.mail string
отображаемое имя
 owners.displayName string
userPrincipalName
 owners.userPrincipalName string
отдел
 owners.department string
Название должности
 owners.jobTitle string
oid
 owners.oid string
title
 title string
goalType
 goalType string
isPrivate
 isPrivate boolean
createdAt
 createdAt string
связанные группы
 relatedGroups array of object
items
 relatedGroups object
labels
 labels array of object
title
 labels.title string
описание
 labels.description string
id
 id string
описание
 description string
id
 parentGoal.id string
title
 parentGoal.title string
formatType
 progress.formatType string
initialValue
 progress.initialValue number
targetValue
 progress.targetValue number
currentValue
 progress.currentValue number
статус
 status string
результат
 outcome string

Цели

Имя Путь Тип Описание
Товары
 Goal

RecognitionCreateResponse

Имя Путь Тип Описание
successfullyTransactions
 successfullyTransactions array of object
transactionId
 successfullyTransactions.transactionId string
recipients
 successfullyTransactions.recipients array of object
почта
 successfullyTransactions.recipients.mail string
отображаемое имя
 successfullyTransactions.recipients.displayName string
userPrincipalName
 successfullyTransactions.recipients.userPrincipalName string
oid
 successfullyTransactions.recipients.oid string
описание
 successfullyTransactions.badge.description string
title
 successfullyTransactions.badge.title string
imageUrl
 successfullyTransactions.badge.imageUrl string
bgImage
 successfullyTransactions.badge.bgImage string
ранг
 successfullyTransactions.badge.rank number
описание
 successfullyTransactions.description string
comments
 successfullyTransactions.comments array of object
items
 successfullyTransactions.comments object
Любит
 successfullyTransactions.likes array of object
items
 successfullyTransactions.likes object
FailedTransactions
 failedTransactions array of string

RecognitionResponse

Имя Путь Тип Описание
recipients
 recipients array of object
почта
 recipients.mail string
отображаемое имя
 recipients.displayName string
userPrincipalName
 recipients.userPrincipalName string
описание
 badge.description string
title
 badge.title string
imageUrl
 badge.imageUrl string
bgImage
 badge.bgImage string
oid
 badge.updatedBy.oid string
отображаемое имя
 badge.updatedBy.displayName string
userPrincipalName
 badge.updatedBy.userPrincipalName string
почта
 badge.updatedBy.mail string
описание
 description string
comments
 comments array of object
businessPhones
 comments.user.businessPhones array of string
отображаемое имя
 comments.user.displayName string
Имя
 comments.user.givenName string
Название должности
 comments.user.jobTitle string
почта
 comments.user.mail string
officeLocation
 comments.user.officeLocation string
предпочтительный язык
 comments.user.preferredLanguage string
фамилия
 comments.user.surname string
userPrincipalName
 comments.user.userPrincipalName string
id
 comments.user.id string
Комментарий
 comments.comment string
Любит
 likes array of object
items
 likes object

Распознавание адресов

Имя Путь Тип Описание
Товары
 RecognitionResponse

Задача

Имя Путь Тип Описание
title
 title string
описание
 description string
assignedTo
 assignedTo array of object
userPrincipalName
 assignedTo.user.userPrincipalName string
отображаемое имя
 assignedTo.user.displayName string
отдельныеcomments
 assignedTo.individualComments array of object
items
 assignedTo.individualComments object
attachments
 attachments array of object
items
 attachments object
labels
 labels array of string
descriptionAttachments
 descriptionAttachments array of object
items
 descriptionAttachments object

Tasks

Имя Путь Тип Описание
Товары
 Task

User

Имя Путь Тип Описание
userPrincipalName
 userPrincipalName string
createdAt
 createdAt string
lastLoginDate
 lastLoginDate string
отдел
 department string
дата приема на работу сотрудника
 employeeHireDate string
роль
 role string
country
 country string
hasManager
 hasManager boolean
isManager
 isManager boolean
Название должности
 jobTitle string
officeLocation
 officeLocation string
предпочтительный язык
 preferredLanguage string
имя
 name string
attachments
 attachments array of object
items
 attachments object