SimpleSurvey (предварительная версия)
С помощью этого соединителя можно легко подключиться к проектам SimpleSurvey для доступа к данным опроса, автоматизации рабочих процессов и информирования с помощью триггеров на основе событий. Независимо от того, измеряете ли вы участие сотрудников, отслеживаете удовлетворенность клиентов или управляете процессами регистрации, SimpleSurvey помогает централизировать аналитические сведения и принимать меры быстрее.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: - Azure Government регионы - Azure регионы Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate за исключением следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Поддержка SimpleSurvey |
| URL | https://simplesurvey.com/contact |
| Адрес электронной почты | support@simplesurvey.com |
| Метаданные соединителя | |
|---|---|
| Publisher | SimpleSurvey |
| Веб-узел | https://simplesurvey.com/ |
| Политика конфиденциальности | https://form.simplesurvey.com/oss/external/privacypolicy.aspx?lang=EN |
| Категории | Данные; Коммуникация |
SimpleSurvey Connector
С помощью этого соединителя можно легко подключиться к проектам SimpleSurvey для доступа к данным опроса, автоматизации рабочих процессов и информирования с помощью триггеров на основе событий. Независимо от того, измеряете ли вы участие сотрудников, отслеживаете удовлетворенность клиентов или управляете процессами регистрации, SimpleSurvey помогает централизировать аналитические сведения и принимать меры быстрее.
Предпосылки
Для продолжения вам потребуется следующее:
- План microsoft Power Apps или Power Automate с пользовательским компонентом соединителя
- Допустимая подписка SimpleSurvey с включенными функциями интеграции Power Apps и общим ключом доступа
- Ключ API Power Apps учетной записи
Поддерживаемые операции
Соединитель поддерживает следующие операции:
-
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: программируйте поток для запуска при изменении ответа в опросе.
Известные проблемы и ограничения
- Для этого соединителя доступны не все типы запланированных задач.
- Формат даты и времени, поддерживаемый этим соединителем: гггг-ММ-дд HH:mm
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| ключ API | securestring | Api_key для этого API | True |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Планирование задачи |
Планирование автоматической задачи для опроса |
| Получение опросов |
Получите все подходящие опросы. |
| Получение отчета опроса Datawarehouse в формате JSON или CSV |
Получение отчета опроса Datawarehouse в формате JSON или CSV |
| Получение сведений о респондентах опроса в формате JSON или CSV |
Получение сведений о респондентах опроса в формате JSON или CSV |
| Получение статистики проекта |
Получение статистики проекта |
Планирование задачи
Планирование автоматической задачи для опроса
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Опрос
|
idProject | True | string |
Выбор опроса |
|
Введите общий ключ доступа для этого опроса
|
X-SAKKey | True | string |
Должен ли ключ для выбранного опроса |
|
type
|
type | True | integer |
Тип задачи |
|
описание
|
description | True | string |
Описание задачи |
|
date
|
date | True | date-time |
Дата выполнения (формат: гггг-ММ-дд ЧЧ:мм) |
|
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 |
Получение опросов
Получите все подходящие опросы.
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
value
|
value | array of object |
value |
|
display_name
|
value.display_name | string |
display_name |
|
id
|
value.id | string |
id |
|
sharedKey
|
value.sharedKey | string |
sharedKey |
|
success
|
success | boolean |
success |
|
errormsg
|
errormsg | string |
errormsg |
|
errordetails
|
errordetails | string |
errordetails |
|
код ошибки
|
errorcode | string |
код ошибки |
|
context
|
context | string |
context |
Получение отчета опроса Datawarehouse в формате JSON или CSV
Получение отчета опроса Datawarehouse в формате JSON или CSV
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Опрос
|
idProject | True | string |
Выбор опроса |
|
Формат возвращаемых данных
|
format | True | string |
Должен быть JSON или CSV |
|
Введите общий ключ доступа для этого опроса
|
X-SAKKey | True | string |
Должен ли ключ для выбранного опроса |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
DatawarehouseRpt
|
DatawarehouseRpt | array of object |
DatawarehouseRpt |
|
ВопросProgId
|
DatawarehouseRpt.QuestionProgId | string |
ВопросProgId |
|
Question
|
DatawarehouseRpt.Question | string |
Question |
|
Ответ
|
DatawarehouseRpt.Response | string |
Ответ |
|
Комментарий
|
DatawarehouseRpt.Comment | string |
Комментарий |
|
SubQuestion
|
DatawarehouseRpt.SubQuestion | string |
SubQuestion |
|
Балл
|
DatawarehouseRpt.Score | float |
Балл |
|
Date_Time
|
DatawarehouseRpt.Date_Time | string |
Date_Time |
|
Состояние
|
DatawarehouseRpt.Status | string |
Состояние |
|
|
DatawarehouseRpt.InternalID | integer |
InternalID |
|
Language
|
DatawarehouseRpt.Language | string |
Language |
|
ДатаСоздания
|
DatawarehouseRpt.CreatedAt | string |
ДатаСоздания |
|
Обновлено
|
DatawarehouseRpt.UpdatedAt | string |
Обновлено |
|
Местоположение
|
DatawarehouseRpt.Location | string |
Местоположение |
|
GETVariables
|
DatawarehouseRpt.GETVariables | string |
GETVariables |
|
Источник перехода
|
DatawarehouseRpt.Referrer | string |
Источник перехода |
|
WeightedScore
|
DatawarehouseRpt.WeightedScore | float |
WeightedScore |
|
IP-адрес
|
DatawarehouseRpt.IPAddress | string |
IP-адрес |
|
BrowserName
|
DatawarehouseRpt.BrowserName | string |
BrowserName |
|
Операционная система
|
DatawarehouseRpt.OperatingSystem | string |
Операционная система |
|
InviteCode
|
DatawarehouseRpt.InviteCode | string |
InviteCode |
|
InviteEmail
|
DatawarehouseRpt.InviteEmail | string |
InviteEmail |
|
InviteName
|
DatawarehouseRpt.InviteName | string |
InviteName |
|
Collector
|
DatawarehouseRpt.Collector | string |
Collector |
|
DatawarehouseRpt_csv
|
DatawarehouseRpt_csv | string |
DatawarehouseRpt_csv |
Получение сведений о респондентах опроса в формате JSON или CSV
Получение сведений о респондентах опроса в формате JSON или CSV
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Опрос
|
idProject | True | string |
Выбор опроса |
|
Получение сведений о
|
tableCode | True | string |
Сведения для получения |
|
Формат возвращаемых данных
|
format | True | string |
Должен быть JSON или CSV |
|
Введите общий ключ доступа для этого опроса
|
X-SAKKey | True | string |
Должен ли ключ для выбранного опроса |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
респонденты
|
respondentsTable | array of object |
респонденты |
|
respondent_id
|
respondentsTable.respondent_id | string |
respondent_id |
|
протокол IP
|
respondentsTable.ip | string |
протокол IP |
|
|
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 |
|
browser
|
respondentsTable.browser | string |
browser |
|
платформа
|
respondentsTable.platform | string |
платформа |
|
is_mobile
|
respondentsTable.is_mobile | boolean |
is_mobile |
|
referer_url
|
respondentsTable.referer_url | string |
referer_url |
|
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 |
|
last_savecont_date_utc
|
respondentsTable.last_savecont_date_utc | string |
last_savecont_date_utc |
|
lang_code
|
respondentsTable.lang_code | string |
lang_code |
|
lang_localized
|
respondentsTable.lang_localized | string |
lang_localized |
|
|
respondentsTable.score | float |
счёт |
|
|
respondentsTable.score_auto | float |
score_auto |
|
|
respondentsTable.score_manual | float |
score_manual |
|
completion_time
|
respondentsTable.completion_time | integer |
completion_time |
|
title
|
respondentsTable.title | string |
title |
|
mobile
|
respondentsTable.mobile | string |
mobile |
|
организация
|
respondentsTable.organization | string |
организация |
|
сегмент
|
respondentsTable.segment | string |
сегмент |
|
location
|
respondentsTable.location | string |
location |
|
первое имя
|
respondentsTable.first_name | string |
первое имя |
|
Фамилия
|
respondentsTable.last_name | string |
Фамилия |
|
электронная почта
|
respondentsTable.email | string |
электронная почта |
|
state_code
|
respondentsTable.state_code | string |
state_code |
|
state_localized
|
respondentsTable.state_localized | string |
state_localized |
|
group
|
respondentsTable.group | string |
group |
|
workspace
|
respondentsTable.workspace | string |
workspace |
|
collector_code
|
respondentsTable.collector_code | string |
collector_code |
|
штырь
|
respondentsTable.pin | string |
штырь |
|
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 |
|
column_id
|
caseTable.column_id | string |
column_id |
|
sub_element
|
caseTable.sub_element | integer |
sub_element |
|
value
|
caseTable.value | string |
value |
|
переменнаяTable
|
variableTable | array of object |
переменнаяTable |
|
element_id
|
variableTable.element_id | string |
element_id |
|
variable_id
|
variableTable.variable_id | string |
variable_id |
|
column_id
|
variableTable.column_id | string |
column_id |
|
sub_element
|
variableTable.sub_element | integer |
sub_element |
|
element_label
|
variableTable.element_label | string |
element_label |
|
variable_label
|
variableTable.variable_label | string |
variable_label |
|
column_label
|
variableTable.column_label | string |
column_label |
|
sub_element_label
|
variableTable.sub_element_label | string |
sub_element_label |
|
описание
|
variableTable.description | string |
описание |
|
variableValueLabelTable
|
variableValueLabelTable | array of object |
variableValueLabelTable |
|
element_id
|
variableValueLabelTable.element_id | string |
element_id |
|
variable_id
|
variableValueLabelTable.variable_id | string |
variable_id |
|
column_id
|
variableValueLabelTable.column_id | string |
column_id |
|
sub_element
|
variableValueLabelTable.sub_element | integer |
sub_element |
|
описание
|
variableValueLabelTable.description | string |
описание |
|
label
|
variableValueLabelTable.label | string |
label |
|
genericFieldHeaderTable
|
genericFieldHeaderTable | array of object |
genericFieldHeaderTable |
|
generic_field_id
|
genericFieldHeaderTable.generic_field_id | integer |
generic_field_id |
|
код
|
genericFieldHeaderTable.code | string |
код |
|
имя
|
genericFieldHeaderTable.name | 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 |
|
genericFieldDataTable_csv
|
genericFieldDataTable_csv | string |
genericFieldDataTable_csv |
|
genericFieldHeaderTable_csv
|
genericFieldHeaderTable_csv | string |
genericFieldHeaderTable_csv |
|
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 |
Получение статистики проекта
Получение статистики проекта
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Опрос
|
idProject | True | string |
Выбор опроса |
|
Принудительное перекомпиляция статистики?
|
f | True | boolean |
Задайте для этого значения принудительное перекомпилирование статистики |
|
Введите общий ключ доступа для этого опроса
|
X-SAKKey | True | string |
Должен ли ключ для выбранного опроса |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
AssignedCount | integer |
AssignedCount |
|
|
AssignedContactCount | integer |
AssignedContactCount |
|
|
AssignedDistributionListMemberCount | integer |
AssignedDistributionListMemberCount |
|
|
AssignedNoInviteDeliveredCount | integer |
AssignedNoInviteDeliveredCount |
|
|
EligibleContactCount | integer |
EligibleContactCount |
|
InviteSentCount
|
InviteSentCount | integer |
InviteSentCount |
|
InviteBouncedCount
|
InviteBouncedCount | integer |
InviteBouncedCount |
|
InviteBounceRate
|
InviteBounceRate | float |
InviteBounceRate |
|
InviteDeliveredCount
|
InviteDeliveredCount | integer |
InviteDeliveredCount |
|
InviteDeliveryRate
|
InviteDeliveryRate | float |
InviteDeliveryRate |
|
InviteOpenedCount
|
InviteOpenedCount | integer |
InviteOpenedCount |
|
InviteOpenRate
|
InviteOpenRate | float |
InviteOpenRate |
|
Отмена подпискиCount
|
UnsubscribedCount | integer |
Отмена подпискиCount |
|
Отмена подписки
|
UnsubscribeRate | float |
Отмена подписки |
|
InviteDeliveredNoAccessCount
|
InviteDeliveredNoAccessCount | integer |
InviteDeliveredNoAccessCount |
|
EmptyCount
|
EmptyCount | integer |
EmptyCount |
|
EmptyPercentage
|
EmptyPercentage | float |
EmptyPercentage |
|
|
AccessedCount | integer |
AccessedCount |
|
Ответныйcount
|
RespondedCount | integer |
Ответныйcount |
|
InProgressCount
|
InProgressCount | integer |
InProgressCount |
|
|
CompletedCount | integer |
CompletedCount |
|
|
ClosedCount | integer |
ClosedCount |
|
InProgressPercentage
|
InProgressPercentage | float |
InProgressPercentage |
|
CompletedPercentage
|
CompletedPercentage | float |
CompletedPercentage |
|
ClosedPercentage
|
ClosedPercentage | float |
ClosedPercentage |
|
CompletionRate_CompletedOverResponded
|
CompletionRate_CompletedOverResponded | float |
CompletionRate_CompletedOverResponded |
|
CompletionRate_CompletedOverAccessed
|
CompletionRate_CompletedOverAccessed | float |
CompletionRate_CompletedOverAccessed |
|
ResponseRate_RespondedOverAssigned
|
ResponseRate_RespondedOverAssigned | float |
ResponseRate_RespondedOverAssigned |
|
ResponseRate_CompletedOverAssigned
|
ResponseRate_CompletedOverAssigned | float |
ResponseRate_CompletedOverAssigned |
|
ResponseRate_RespondedOverInvited
|
ResponseRate_RespondedOverInvited | float |
ResponseRate_RespondedOverInvited |
|
ResponseRate_CompletedOverInvited
|
ResponseRate_CompletedOverInvited | float |
ResponseRate_CompletedOverInvited |
|
CompletionTime_Avg
|
CompletionTime_Avg | integer |
CompletionTime_Avg |
|
CompletionTime_Med
|
CompletionTime_Med | integer |
CompletionTime_Med |
|
OptInConfirmationCount
|
OptInConfirmationCount | integer |
OptInConfirmationCount |
|
EmailSentCount
|
EmailSentCount | integer |
EmailSentCount |
|
SMSSentCount
|
SMSSentCount | integer |
SMSSentCount |
|
LastCompletedDate
|
LastCompletedDate | string |
LastCompletedDate |
|
LastUpdatedDate
|
LastUpdatedDate | string |
LastUpdatedDate |
|
CompletedCountPerDayString
|
CompletedCountPerDayString | string |
CompletedCountPerDayString |
|
CompletedCountPerDay
|
CompletedCountPerDay | array of object |
CompletedCountPerDay |
|
|
CompletedCountPerDay.timestamp | integer |
отметка времени |
|
количество
|
CompletedCountPerDay.count | integer |
количество |
|
CompletedCountPerMonthString
|
CompletedCountPerMonthString | string |
CompletedCountPerMonthString |
|
CompletedCountPerMonth
|
CompletedCountPerMonth | array of object |
CompletedCountPerMonth |
|
|
CompletedCountPerMonth.timestamp | integer |
отметка времени |
|
количество
|
CompletedCountPerMonth.count | integer |
количество |
|
success
|
success | boolean |
success |
Триггеры
| При изменении ответа |
При изменении ответа |
| При отправке ответа |
При отправке ответа |
При изменении ответа
При изменении ответа
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Опрос
|
idProject | True | string |
Выбор опроса |
|
Целевой рабочий процесс обмена данными
|
automationId | True | integer |
Целевой рабочий процесс обмена данными |
|
Введите общий ключ доступа для этого опроса
|
X-SAKKey | True | string |
Должен ли ключ для выбранного опроса |
|
Имя
|
Name | True | string |
Имя |
При отправке ответа
При отправке ответа
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Опрос
|
idProject | True | string |
Выбор опроса |
|
Целевой рабочий процесс обмена данными
|
automationId | True | integer |
Целевой рабочий процесс обмена данными |
|
Введите общий ключ доступа для этого опроса
|
X-SAKKey | True | string |
Должен ли ключ для выбранного опроса |
|
Имя
|
Name | True | string |
Имя |