通过

Teamflect （预览版）

使用 Teamflect 提高工作流效率。 将 Teamflect 的可靠性能管理功能（包括目标、反馈和评审）无缝集成到现有生态系统中。 自动执行日常任务，跨平台同步数据，并创建动态的数据驱动工作流，以提高整个组织的工作效率和参与度。

此连接器在以下产品和区域中可用：

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部（DoD）
Power Apps 高级 除以下各项外的所有 Power Apps 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
Power Automate 高级 除以下各项外的所有 Power Automate 区域 ：
     - 美国政府 （GCC）
     - 美国政府 （GCC High）
     - 由世纪互联运营的中国云
     - 美国国防部（DoD）
联系人​​
Name Bora Unlu
URL https://teamflect.com/contact-us
Email support@teamflect.com
连接器元数据
发布者 Teamflect
网站 https://teamflect.com
隐私策略 https://teamflect.com/privacy
类别 商业管理

Teamflect Power Automate 连接器

注意：这是一个自定义连接器，用于将 Teamflect 的广泛 API 集成到 Power Automate 和 Power Apps 中的自动化工作流中。

Teamflect Power Automate 连接器允许直接从自动化工作流管理和与目标、反馈、识别和任务进行交互。 利用此连接器，用户可以通过将性能管理流程与 Microsoft Power Automate 无缝集成来简化其性能管理过程。

先决条件

若要使用此连接器，需要满足以下条件：

  1. Microsoft Power Apps 或 Power Automate Plan ，其中包括对自定义连接器的支持。

  2. 具有访问相关数据所需的 API 权限的 Teamflect 帐户。

  3. 用于生成和部署连接器的 Power Platform CLI 工具。

生成连接器

Teamflect API 通过 API 密钥进行保护。 若要通过此连接器访问 API，需要获取 Teamflect API 密钥并在 Power Automate 中安全地对其进行配置。

生成和配置连接器的步骤：

  1. 获取 API 密钥：

    • 登录到 Teamflect 帐户并导航到 API 设置页。

    • 生成 API 密钥并使其安全保存。 配置连接器时，需要使用此密钥。

  2. 下载连接器文件：

    • 确保具有 Teamflect API 的 API 定义（OpenAPI/Swagger 文件）。 此文件定义连接器支持的作和数据结构。

  3. 部署连接器：

    • 使用 Power Platform CLI 部署连接器。

    • 运行以下命令以创建连接器：

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

  4. 测试连接器：

    • 部署后，使用任何受支持的作创建 Power Automate 流来测试连接器。

支持的作

Teamflect 连接器支持以下作：

反馈管理

  • 发送反馈请求：为指定用户启动反馈请求。

  • 发送外部反馈请求：向外部电子邮件地址发送反馈请求。

目标管理

  • 按 ID 获取目标：检索特定目标的详细信息。

  • 获取目标：根据搜索条件列出多个目标。

  • 创建新目标：为用户创建新目标。

  • 更新目标进度：更新目标的进度或状态。

  • 目标注释：向目标添加注释。

认识

  • 创建识别：为一个或多个用户创建新的识别。

  • 按 ID 获取识别：检索特定识别的详细信息。

  • 获取识别：列出多个识别。

任务管理

  • 按 ID 获取任务：按其唯一标识符检索任务。

  • 获取任务：根据搜索条件列出任务。

部署说明

  • 确保 API 密钥安全存储且不公开共享。

  • 使用连接器负责避免达到 API 速率限制。

  • 有关 API 的详细信息，请参阅 Teamflect API 文档，包括错误代码和其他参数。

其他信息

有关 Teamflect 平台的更多详细信息，请访问 我们的网站。 如果遇到任何问题或需要帮助，请联系我们的支持团队。support@teamflect.com

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
API 密钥 securestring 此 API 的 API 密钥 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

使用所选属性更新用户

更新用户的属性
创建新的识别

创建新的识别
创建新目标

创建新目标
发送新的反馈请求

发送新的反馈请求。
发送新的外部反馈请求

发送新的外部反馈请求
向目标添加注释

向目标添加新注释
基于应用的筛选器返回任务

基于应用的筛选器返回任务
基于应用的筛选器返回目标

基于应用的筛选器返回目标
基于应用的筛选器返回识别

基于应用的筛选器返回识别
按 ID 获取任务

按 ID 获取任务
按 ID 获取目标

按 ID 获取目标
按 ID 获取识别

按 ID 获取识别
按邮件获取用户

按邮件获取用户
更新目标进度

更新目标进度

使用所选属性更新用户

操作 ID:
Update_user

更新用户的属性

参数

名称 密钥 必需 类型 说明
用户电子邮件
 userMail string

要更新的用户的电子邮件地址。
属性标签
 label string

要更新的属性的名称。
属性值
 value string

要更新的属性的值。

创建新的识别

操作 ID:
Create_recognition

创建新的识别

参数

名称 密钥 必需 类型 说明
识别发件人
 senderIdOrUPN True string

发送识别的人员的电子邮件或 ID
识别收件人
 recipientsIdsOrUPNS True array of string

接收识别的人员的电子邮件或 ID 列表
锁屏提醒标题
 badgeTitle True string

识别锁屏提醒的标题
专用
 isPrivate True boolean

识别是否为专用
识别消息
 description True string

识别中包含的消息

返回

Body
RecognitionCreateResponse

创建新目标

操作 ID:
Create_goal

创建新目标

参数

名称 密钥 必需 类型 说明
目标标题
 title True string

新目标的标题
Description
 description True string

新目标的详细说明
开始日期
 startDate True string

目标应开始的日期
截止日期
 dueDate True string

完成目标时的日期
目标类型
 goalType True string

目标类型
目标所有者
 goalOwnerUPNorId True

目标所有者的电子邮件或 ID
目标创建者
 goalCreatorUPNorId True string

目标创建者的电子邮件或 ID
专用
 isPrivate True boolean

目标是否应为专用目标
进度格式
 progressFormatType True string

跟踪进度的格式类型
货币代码
 currencyCode True string

货币目标货币代码
初始值
 initialValue True number

初始进度值
目标值
 targetValue True number

目标进度值
父目标 ID
 parentGoalId True string

如果这是子目标，则父目标的 ID
通知所有者
 sendNotificationToOwner True boolean

是否通知目标所有者

返回

Body
Goal

发送新的反馈请求

操作 ID:
Send_feedback_request

发送新的反馈请求。

参数

名称 密钥 必需 类型 说明
反馈主题
 feedbackAboutUPNorId True string

接收反馈的人员的电子邮件或 ID
反馈提供程序
 feedbackRequestReceiverUPNorId True string

将提供反馈的人员的电子邮件或 ID
请求说明
 feedbackNote True string

要包含在反馈请求中的注释
模板标题
 templateTitle True string

要使用的反馈模板的标题
截止日期
 dueDateInDays True number

反馈到期前的天数
专用
 isPrivate True boolean

反馈是否应为专用反馈

返回

Body
Feedback

发送新的外部反馈请求

操作 ID:
Send_external_feedback_Request

发送新的外部反馈请求

参数

名称 密钥 必需 类型 说明
反馈主题
 feedbackAboutUPNorId True string

接收反馈的人员的电子邮件或 ID
外部电子邮件
 externalEmail True string

外部反馈提供商的电子邮件地址
提供程序名称
 onBehalfName True string

要为外部反馈提供程序显示的名称
请求说明
 feedbackNote True string

要包含在反馈请求中的注释
模板标题
 templateTitle True string

要使用的反馈模板的标题
截止日期
 dueDateInDays True number

反馈到期前的天数
专用
 isPrivate True boolean

反馈是否应为专用反馈
是匿名的
 isAnonymous True boolean

反馈是否应是匿名的

返回

Body
Feedback

向目标添加注释

操作 ID:
Add_comment_goal

向目标添加新注释

参数

名称 密钥 必需 类型 说明
目标 ID
 goalId True string

目标 ID
注释者的对象 ID 或用户主体名称
 commenterIdOrUPN True string

注释者的对象 ID 或用户主体名称
注释本身
 commentText True string

注释本身

返回

Body
Goal

基于应用的筛选器返回任务

操作 ID:
Get_tasks

基于应用的筛选器返回任务

参数

名称 密钥 必需 类型 说明
用户对象 ID
 userOID string

要检索其任务的用户的对象 ID
用户电子邮件
 userUPN string

要检索其任务的用户的用户主体名称（电子邮件）
搜索文本
 search string

在任务标题和说明中搜索的文本
结果限制
 limit number

要返回的最大任务数
跳过计数
 skip number

要跳过分页的任务数
开始日期
 startDate string

筛选任务的开始日期
结束日期
 endDate string

筛选任务的结束日期

返回

物品
Tasks

基于应用的筛选器返回目标

操作 ID:
Get_goals

基于应用的筛选器返回目标

参数

名称 密钥 必需 类型 说明
用户对象 ID
 userOID string

要检索其目标的用户的对象 ID
用户电子邮件
 userUPN string

要检索其目标的用户的用户主体名称（电子邮件）
搜索文本
 search string

在目标标题和说明中搜索的文本
目标标签
 selectedLabels string

按以下方式筛选目标的标签
结果限制
 limit string

要返回的最大目标数
跳过计数
 skip string

要跳过分页的目标数
开始日期
 startDate string

筛选目标的开始日期
结束日期
 endDate string

筛选目标的结束日期

返回

物品
Goals

基于应用的筛选器返回识别

操作 ID:
Get_recognitions

基于应用的筛选器返回识别

参数

名称 密钥 必需 类型 说明
要搜索的收件人
 recipientsIdsOrUPNS True array of string

要搜索的收件人电子邮件或 ID 的列表
识别标题
 title True string

要搜索的识别标题
更新日期
 updated True string

要筛选依据的上次更新日期
创建日期
 created True string

要筛选依据的创建日期

返回

物品
RecognitionResponses

按 ID 获取任务

操作 ID:
Get_task

按 ID 获取任务

参数

名称 密钥 必需 类型 说明
任务 ID
 taskId True string

要检索的任务的唯一标识符

返回

Body
Task

按 ID 获取目标

操作 ID:
Get_goal

按 ID 获取目标

参数

名称 密钥 必需 类型 说明
目标 ID
 goalId True string

要检索的目标的唯一标识符

返回

Body
Goal

按 ID 获取识别

操作 ID:
Get_recognition

按 ID 获取识别

参数

名称 密钥 必需 类型 说明
识别 ID
 recognitionId True string

要检索的识别的唯一标识符

返回

Body
RecognitionResponse

按邮件获取用户

操作 ID:
Get_user

按邮件获取用户

参数

名称 密钥 必需 类型 说明
用户电子邮件
 userMail True string

要检索的用户的电子邮件地址

返回

Body
User

更新目标进度

操作 ID:
Update_goal

更新目标进度

参数

名称 密钥 必需 类型 说明
目标 ID
 goalId True string

要更新的目标的唯一标识符
新建进度值
 newValue True string

目标的新进度值
更新注释
 comment string

有关进度更新的注释
新建状态
 status string

目标的新状态
Updater 类型
 goalUpdater True string

谁正在更新目标（所有者或系统）
系统名称
 goalUpdaterSystemName True string

更新目标的系统的名称

返回

Body
Goal

定义

Feedback

名称 路径 类型 说明
反馈 ID
 id string

反馈的唯一标识符
创建日期
 createdAt string

创建反馈的日期和时间
oid
 createdBy.oid string
displayName
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
oid
 feedbackAboutUser.oid string
displayName
 feedbackAboutUser.displayName string
userPrincipalName
 feedbackAboutUser.userPrincipalName string
oid
 feedbackRequestRecipient.oid string
displayName
 feedbackRequestRecipient.displayName string
userPrincipalName
 feedbackRequestRecipient.userPrincipalName string
注意
 note string
isPrivate
 isPrivate boolean

目标

名称 路径 类型 说明
oid
 createdBy.oid string
displayName
 createdBy.displayName string
userPrincipalName
 createdBy.userPrincipalName string
startDate
 startDate string
截止日期
 dueDate string
所有者
 owners array of object
邮件
 owners.mail string
displayName
 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
 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
当前值
 progress.currentValue number
状态
 status string
outcome
 outcome string

目标

名称 路径 类型 说明
物品
 Goal

RecognitionCreateResponse

名称 路径 类型 说明
successfullyTransactions
 successfullyTransactions array of object
交易 ID
 successfullyTransactions.transactionId string
recipients
 successfullyTransactions.recipients array of object
邮件
 successfullyTransactions.recipients.mail string
displayName
 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
displayName
 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
displayName
 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
displayName
 comments.user.displayName string
givenName
 comments.user.givenName string
职位名称
 comments.user.jobTitle string
邮件
 comments.user.mail string
officeLocation
 comments.user.officeLocation string
preferredLanguage
 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

RecognitionResponses

名称 路径 类型 说明
物品
 RecognitionResponse

任务

名称 路径 类型 说明
title
 title string
描述
 description string
assignedTo
 assignedTo array of object
userPrincipalName
 assignedTo.user.userPrincipalName string
displayName
 assignedTo.user.displayName string
individualComments
 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

用户

名称 路径 类型 说明
userPrincipalName
 userPrincipalName string
createdAt
 createdAt string
lastLoginDate
 lastLoginDate string
部门
 department string
employeeHireDate
 employeeHireDate string
角色
 role string
country
 country string
hasManager
 hasManager boolean
isManager
 isManager boolean
职位名称
 jobTitle string
officeLocation
 officeLocation string
preferredLanguage
 preferredLanguage string
姓名
 name string
attachments
 attachments array of object
items
 attachments object