SimpleSurvey (预览版)
使用此连接器,可以轻松连接到 SimpleSurvey 项目,以访问调查数据、自动化工作流,并通过事件驱动的触发器保持知情状态。 无论是衡量员工参与度、跟踪客户满意度还是管理注册流程,SimpleSurvey 都有助于集中见解并更快地采取行动。
此连接器在以下产品和区域中可用:
| 服务 | 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 | SimpleSurvey 支持 |
| URL | https://simplesurvey.com/contact |
| support@simplesurvey.com |
| 连接器元数据 | |
|---|---|
| 发布者 | SimpleSurvey |
| 网站 | https://simplesurvey.com/ |
| 隐私策略 | https://form.simplesurvey.com/oss/external/privacypolicy.aspx?lang=EN |
| 类别 | 数据;通信 |
SimpleSurvey 连接器
使用此连接器,可以轻松连接到 SimpleSurvey 项目,以访问调查数据、自动化工作流,并通过事件驱动的触发器保持知情状态。 无论是衡量员工参与度、跟踪客户满意度还是管理注册流程,SimpleSurvey 都有助于集中见解并更快地采取行动。
先决条件
需要满足以下条件才能继续作:
- 具有自定义连接器功能的Microsoft Power Apps 或 Power Automate 计划
- 启用了 Power Apps 集成和共享访问密钥功能的有效 SimpleSurvey 订阅
- 帐户的 Power Apps API 密钥
支持的作
连接器支持以下作:
-
Get surveys:列出所有符合条件的调查。 -
Get survey respondents details in JSON or CSV format:获取所选格式中有关调查受访者的特定详细信息。 -
Schedule a task:在 SimpleSurvey 中计划自动化任务。 -
Get your survey data warehouse report in JSON or CSV format:获取有关调查受访者及其答复的所有数据(采用所选格式)。 -
Get your project's statistics:获取项目的最新见解。
支持的触发器
-
When a response is submitted:对在调查中收到响应时运行的流进行程序。 -
When a response is changed:在调查中修改响应时,将流设置为运行。
已知问题和限制
- 并非所有类型的计划任务都可用于此连接器。
- 此连接器支持的日期/时间格式为:yyyy-MM-dd HH:mm
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API密钥 | securestring 安全字符串 | 此 api 的api_key | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 获取 JSON 或 CSV 格式的调查受访者详细信息 |
获取 JSON 或 CSV 格式调查受访者的详细信息 |
| 获取 JSON 或 CSV 格式的调查数据仓库报告 |
获取 JSON 或 CSV 格式的调查数据仓库报告 |
| 获取调查 |
获取所有符合条件的调查。 |
| 获取项目的统计信息 |
获取项目的统计信息 |
| 计划任务 |
安排调查的自动任务 |
获取 JSON 或 CSV 格式的调查受访者详细信息
获取 JSON 或 CSV 格式调查受访者的详细信息
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
调查
|
idProject | True | string |
选择调查 |
|
获取有关
|
tableCode | True | string |
要获取的详细信息 |
|
返回的数据的格式
|
format | True | string |
必须是 JSON 或 CSV |
|
对调查使用共享访问密钥:
|
X-SAKKey | True | string |
必须与所选调查相同 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
respondentsTable
|
respondentsTable | array of object |
respondentsTable |
|
respondent_id
|
respondentsTable.respondent_id | string |
respondent_id |
|
ip
|
respondentsTable.ip | string |
ip |
|
internal_id
|
respondentsTable.internal_id | integer |
internal_id |
|
info1
|
respondentsTable.info1 | string |
info1 |
|
info2
|
respondentsTable.info2 | string |
info2 |
|
info3
|
respondentsTable.info3 | string |
info3 |
|
info4
|
respondentsTable.info4 | string |
info4 |
|
info5
|
respondentsTable.info5 | string |
info5 |
|
confirmation_number
|
respondentsTable.confirmation_number | string |
confirmation_number |
|
created_date_utc
|
respondentsTable.created_date_utc | string |
created_date_utc |
|
first_answer_date_utc
|
respondentsTable.first_answer_date_utc | string |
first_answer_date_utc |
|
last_answer_date_utc
|
respondentsTable.last_answer_date_utc | string |
last_answer_date_utc |
|
submitted_date_utc
|
respondentsTable.submitted_date_utc | string |
submitted_date_utc |
|
lang_code
|
respondentsTable.lang_code | string |
lang_code |
|
lang_localized
|
respondentsTable.lang_localized | string |
lang_localized |
|
分数
|
respondentsTable.score | integer |
分数 |
|
score_auto
|
respondentsTable.score_auto | integer |
score_auto |
|
completion_time
|
respondentsTable.completion_time | integer |
completion_time |
|
state_code
|
respondentsTable.state_code | string |
state_code |
|
state_localized
|
respondentsTable.state_localized | string |
state_localized |
|
caseTable
|
caseTable | array of object |
caseTable |
|
respondent_id
|
caseTable.respondent_id | string |
respondent_id |
|
element_id
|
caseTable.element_id | string |
element_id |
|
variable_id
|
caseTable.variable_id | string |
variable_id |
|
value
|
caseTable.value | string |
value |
|
variableTable
|
variableTable | array of object |
variableTable |
|
element_id
|
variableTable.element_id | string |
element_id |
|
element_label
|
variableTable.element_label | string |
element_label |
|
描述
|
variableTable.description | string |
描述 |
|
variable_id
|
variableTable.variable_id | string |
variable_id |
|
variable_label
|
variableTable.variable_label | string |
variable_label |
|
variableValueLabelTable
|
variableValueLabelTable | array of object |
variableValueLabelTable |
|
element_id
|
variableValueLabelTable.element_id | string |
element_id |
|
variable_id
|
variableValueLabelTable.variable_id | string |
variable_id |
|
描述
|
variableValueLabelTable.description | string |
描述 |
|
标签
|
variableValueLabelTable.label | string |
标签 |
|
genericFieldHeaderTable
|
genericFieldHeaderTable | array of object |
genericFieldHeaderTable |
|
generic_field_id
|
genericFieldHeaderTable.generic_field_id | integer |
generic_field_id |
|
姓名
|
genericFieldHeaderTable.name | string |
姓名 |
|
代码
|
genericFieldHeaderTable.code | string |
代码 |
|
genericFieldDataTable
|
genericFieldDataTable | array of object |
genericFieldDataTable |
|
generic_field_id
|
genericFieldDataTable.generic_field_id | integer |
generic_field_id |
|
respondent_id
|
genericFieldDataTable.respondent_id | string |
respondent_id |
|
value
|
genericFieldDataTable.value | string |
value |
|
respondentsTable_csv
|
respondentsTable_csv | string |
respondentsTable_csv |
|
caseTable_csv
|
caseTable_csv | string |
caseTable_csv |
|
variableTable_csv
|
variableTable_csv | string |
variableTable_csv |
|
variableValueLabelTable_csv
|
variableValueLabelTable_csv | string |
variableValueLabelTable_csv |
|
genericFieldHeaderTable_csv
|
genericFieldHeaderTable_csv | string |
genericFieldHeaderTable_csv |
|
genericFieldDataTable_csv
|
genericFieldDataTable_csv | string |
genericFieldDataTable_csv |
|
success
|
success | boolean |
success |
获取 JSON 或 CSV 格式的调查数据仓库报告
获取 JSON 或 CSV 格式的调查数据仓库报告
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
调查
|
idProject | True | string |
选择调查 |
|
返回的数据的格式
|
format | True | string |
必须是 JSON 或 CSV |
|
对调查使用共享访问密钥:
|
X-SAKKey | True | string |
必须与所选调查相同 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
DatawarehouseRpt
|
DatawarehouseRpt | array of object |
DatawarehouseRpt |
|
QuestionProgId
|
DatawarehouseRpt.QuestionProgId | string |
QuestionProgId |
|
问题
|
DatawarehouseRpt.Question | string |
问题 |
|
响应
|
DatawarehouseRpt.Response | string |
响应 |
|
SubQuestion
|
DatawarehouseRpt.SubQuestion | string |
SubQuestion |
|
|
DatawarehouseRpt.Score | float |
得分 |
|
Date_Time
|
DatawarehouseRpt.Date_Time | string |
Date_Time |
|
状态
|
DatawarehouseRpt.Status | string |
状态 |
|
InternalID
|
DatawarehouseRpt.InternalID | integer |
InternalID |
|
语言
|
DatawarehouseRpt.Language | string |
语言 |
|
CreatedAt
|
DatawarehouseRpt.CreatedAt | string |
CreatedAt |
|
更新于
|
DatawarehouseRpt.UpdatedAt | string |
更新于 |
|
WeightedScore
|
DatawarehouseRpt.WeightedScore | integer |
WeightedScore |
|
IP地址
|
DatawarehouseRpt.IPAddress | string |
IP地址 |
|
InviteName
|
DatawarehouseRpt.InviteName | string |
InviteName |
|
注释
|
DatawarehouseRpt.Comment | string |
注释 |
|
DatawarehouseRpt_csv
|
DatawarehouseRpt_csv | string |
DatawarehouseRpt_csv |
|
success
|
success | boolean |
success |
获取调查
获取所有符合条件的调查。
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
value
|
value | array of object |
value |
|
display_name
|
value.display_name | string |
display_name |
|
id
|
value.id | string |
id |
|
共享密钥
|
value.sharedKey | string |
共享密钥 |
|
success
|
success | boolean |
success |
|
errormsg
|
errormsg | string |
errormsg |
|
errordetails
|
errordetails | string |
errordetails |
|
errorcode
|
errorcode | string |
errorcode |
|
上下文
|
context | string |
上下文 |
获取项目的统计信息
获取项目的统计信息
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
调查
|
idProject | True | string |
选择调查 |
|
强制重新编译统计信息?
|
f | True | boolean |
设置此值以强制重新编译统计信息 |
|
对调查使用共享访问密钥:
|
X-SAKKey | True | string |
必须与所选调查相同 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
AssignedCount
|
value.AssignedCount | integer |
AssignedCount |
|
AssignedContactCount
|
value.AssignedContactCount | integer |
AssignedContactCount |
|
AssignedDistributionListMemberCount
|
value.AssignedDistributionListMemberCount | integer |
AssignedDistributionListMemberCount |
|
AssignedNoInviteDeliveredCount
|
value.AssignedNoInviteDeliveredCount | integer |
AssignedNoInviteDeliveredCount |
|
EligibleContactCount
|
value.EligibleContactCount | integer |
EligibleContactCount |
|
InviteSentCount
|
value.InviteSentCount | integer |
InviteSentCount |
|
InviteBouncedCount
|
value.InviteBouncedCount | integer |
InviteBouncedCount |
|
InviteBounceRate
|
value.InviteBounceRate | integer |
InviteBounceRate |
|
InviteDeliveredCount
|
value.InviteDeliveredCount | integer |
InviteDeliveredCount |
|
InviteDeliveryRate
|
value.InviteDeliveryRate | integer |
InviteDeliveryRate |
|
InviteOpenedCount
|
value.InviteOpenedCount | integer |
InviteOpenedCount |
|
InviteOpenRate
|
value.InviteOpenRate | integer |
InviteOpenRate |
|
UnsubscribedCount
|
value.UnsubscribedCount | integer |
UnsubscribedCount |
|
UnsubscribeRate
|
value.UnsubscribeRate | integer |
UnsubscribeRate |
|
InviteDeliveredNoAccessCount
|
value.InviteDeliveredNoAccessCount | integer |
InviteDeliveredNoAccessCount |
|
EmptyCount
|
value.EmptyCount | integer |
EmptyCount |
|
EmptyPercentage
|
value.EmptyPercentage | integer |
EmptyPercentage |
|
AccessedCount
|
value.AccessedCount | integer |
AccessedCount |
|
RespondedCount
|
value.RespondedCount | integer |
RespondedCount |
|
InProgressCount
|
value.InProgressCount | integer |
InProgressCount |
|
CompletedCount
|
value.CompletedCount | integer |
CompletedCount |
|
ClosedCount
|
value.ClosedCount | integer |
ClosedCount |
|
InProgressPercentage
|
value.InProgressPercentage | float |
InProgressPercentage |
|
CompletedPercentage
|
value.CompletedPercentage | float |
CompletedPercentage |
|
ClosedPercentage
|
value.ClosedPercentage | float |
ClosedPercentage |
|
CompletionRate_CompletedOverResponded
|
value.CompletionRate_CompletedOverResponded | float |
CompletionRate_CompletedOverResponded |
|
CompletionRate_CompletedOverAccessed
|
value.CompletionRate_CompletedOverAccessed | float |
CompletionRate_CompletedOverAccessed |
|
CompletionTime_Avg
|
value.CompletionTime_Avg | integer |
CompletionTime_Avg |
|
CompletionTime_Med
|
value.CompletionTime_Med | integer |
CompletionTime_Med |
|
OptInConfirmationCount
|
value.OptInConfirmationCount | integer |
OptInConfirmationCount |
|
EmailSentCount
|
value.EmailSentCount | integer |
EmailSentCount |
|
LastCompletedDate
|
value.LastCompletedDate | string |
LastCompletedDate |
|
LastUpdatedDate
|
value.LastUpdatedDate | string |
LastUpdatedDate |
|
CompletedCountPerDayString
|
value.CompletedCountPerDayString | string |
CompletedCountPerDayString |
|
CompletedCountPerDay
|
value.CompletedCountPerDay | array of array |
CompletedCountPerDay |
|
items
|
value.CompletedCountPerDay | array of integer | |
|
CompletedCountPerMonthString
|
value.CompletedCountPerMonthString | string |
CompletedCountPerMonthString |
|
CompletedCountPerMonth
|
value.CompletedCountPerMonth | array of array |
CompletedCountPerMonth |
|
items
|
value.CompletedCountPerMonth | array of integer | |
|
success
|
success | boolean |
success |
计划任务
安排调查的自动任务
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
调查
|
idProject | True | string |
选择调查 |
|
对调查使用共享访问密钥:
|
X-SAKKey | True | string |
必须与所选调查相同 |
|
类型
|
type | True | integer |
任务类型 |
|
描述
|
description | True | string |
任务说明 |
|
date
|
date | True | date-time |
执行日期(格式:yyyy-MM-dd HH:mm) |
|
idOtherSurvey
|
idSurveyFrom | string |
要分配给的项目 (为类型 6 和 7 设置) |
|
|
allParticipants
|
allParticipants | boolean |
发送到(为类型 10X 和 14 设置) |
|
|
communicationMode
|
communicationMode | string |
通信模式(仅适用于“批量提醒”和“初始邀请”任务) |
|
|
idAssignationGroup
|
idAssignationGroup | string |
仅针对以下组的成员(可选为类型 101 到 105 设置) |
|
|
idContactGroup
|
idContactGroup | string |
联系人组名称 (为类型 3 设置) |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
success
|
success | boolean |
success |
|
errormsg
|
errormsg | string |
errormsg |
|
successmsg
|
successmsg | string |
successmsg |
触发器
| 提交响应时 |
提交响应时 |
| 更改响应时 |
更改响应时 |
提交响应时
提交响应时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
调查
|
idProject | True | string |
选择调查 |
|
目标通信工作流
|
automationId | True | integer |
目标通信工作流 |
|
对调查使用共享访问密钥:
|
X-SAKKey | True | string |
必须与所选调查相同 |
|
Name
|
Name | True | string |
Name |
更改响应时
更改响应时
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
调查
|
idProject | True | string |
选择调查 |
|
目标通信工作流
|
automationId | True | integer |
目标通信工作流 |
|
对调查使用共享访问密钥:
|
X-SAKKey | True | string |
必须与所选调查相同 |
|
Name
|
Name | True | string |
Name |