Pesquisa123
O ArcGIS Survey123 é uma solução simples e intuitiva de coleta de dados centrada em formulários que possibilita criar, compartilhar e analisar pesquisas em apenas três etapas fáceis: 1) Fazer perguntas; 2) Obter as respostas; 3) Tome as melhores decisões.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Standard | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Standard | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Pesquisa123 |
| URL | https://www.esri.com/survey123 |
| survey123@esri.com |
| Metadados do conector | |
|---|---|
| Publicador | ArcGIS Survey123 |
| Site | https://www.esri.com/survey123 |
| Política de privacidade | https://www.esri.com/en-us/privacy/overview |
| Categorias | Site; Produtividade |
O ArcGIS Survey123 permite criar formulários inteligentes com reconhecimento de localização para sua organização e para o público, permitindo que as pessoas enviem dados na Web ou com o aplicativo de campo Survey123. A Pesquisa123 faz parte do ArcGIS, trazendo o poder da inteligência de localização para os dados da pesquisa. Para obter mais informações, consulte a Visão geral do ArcGIS Survey123.
Pré-requisitos
- Uma conta organizacional do ArcGIS é necessária. Para obter mais informações, consulte Criar conta.
- O conector Survey123 foi projetado para ajudá-lo a trabalhar com pesquisas survey123 hospedadas no ArcGIS Online. Se você quiser usar esse conector com pesquisas hospedadas no ArcGIS Enterprise, entre em contato com seu representante do Esri para discutir como o Esri pode ajudá-lo a configurar seu próprio conector Survey123 personalizado.
- Você deve ser o proprietário de uma pesquisa do ArcGIS Survey123 .
Introdução
Depois de publicar sua pesquisa, você pode se familiarizar com esse conector usando modelos da galeria. Todos os dados enviados por meio do formulário estarão disponíveis no Microsoft Power Automate como conteúdo dinâmico. Você pode até mesmo trabalhar com fotos e assinaturas!
Considerações
Você só pode acessar pesquisas que possui.
Por padrão, um fluxo é disparado quando uma resposta de pesquisa é enviada. Para disparar um fluxo quando uma resposta de pesquisa for editada, vá para as configurações de webhook para sua pesquisa no site da Survey123. Na seção Desacionar eventos , habilite a opção Existente editada pelo registro . Para obter mais informações sobre configurações de webhook, consulte Configurar um webhook no site da Survey123.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Criar relatório |
Criar relatório |
| Obter pesquisas |
Esta ação recupera uma lista de pesquisas pertencentes ao usuário conectado |
Criar relatório
Criar relatório
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Survey
|
surveyItemId | True | string |
Survey |
|
Camada de recursos
|
featureLayerUrl | True | string |
Camada de recursos |
|
Modelo de relatório
|
templateItemId | True | string |
Modelo de relatório |
|
ID do objeto de recurso
|
objectIds | string |
Recursos a serem incluídos no relatório. Usar vírgula para separar vários ObjectIDs |
|
|
Cláusula FEATURE WHERE
|
where | string |
Recursos a serem incluídos no relatório. Uma cláusula SQL WHERE para filtrar registros |
|
|
diferença UTC
|
utcOffset | string |
Aplicar um deslocamento para o fuso horário, por exemplo, +02:00 ou -09:00 |
|
|
Nome do relatório
|
outputReportName | string |
Nome do relatório |
|
|
Formato
|
outputFormat | string |
Formato |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
jobId
|
jobId | string |
jobId |
|
jobStatus
|
jobStatus | string |
jobStatus |
|
submetido
|
submitted | integer |
submetido |
|
concluído
|
completed | integer |
concluído |
|
title
|
resultInfo.title | string |
title |
|
totalCount
|
resultInfo.totalCount | integer |
totalCount |
|
succeededObjectIds
|
resultInfo.succeededObjectIds | array of integer |
succeededObjectIds |
|
failedObjectIds
|
resultInfo.failedObjectIds | array of |
failedObjectIds |
|
details
|
resultInfo.details | array of |
details |
|
resultFiles
|
resultInfo.resultFiles | array of object |
resultFiles |
|
objectIds
|
resultInfo.resultFiles.objectIds | array of integer |
objectIds |
|
nome
|
resultInfo.resultFiles.name | string |
nome |
|
size
|
resultInfo.resultFiles.size | integer |
size |
|
status
|
resultInfo.resultFiles.status | string |
status |
|
url
|
resultInfo.resultFiles.url | string |
url |
|
objectIds
|
resultInfo.resultFile.objectIds | array of integer |
objectIds no primeiro arquivo de resultado |
|
nome
|
resultInfo.resultFile.name | string |
nome do primeiro arquivo de resultado |
|
size
|
resultInfo.resultFile.size | integer |
tamanho do primeiro arquivo de resultado |
|
status
|
resultInfo.resultFile.status | string |
status do primeiro arquivo de resultado |
|
url
|
resultInfo.resultFile.url | string |
url do primeiro arquivo de resultado |
|
jobType
|
inputInfo.jobType | string |
jobType |
|
featureLayerUrl
|
inputInfo.parameters.featureLayerUrl | string |
featureLayerUrl |
|
objectIds
|
inputInfo.parameters.queryParameters.objectIds | string |
objectIds |
|
templateItemId
|
inputInfo.parameters.templateItemId | string |
templateItemId |
|
surveyItemId
|
inputInfo.parameters.surveyItemId | string |
surveyItemId |
|
portalUrl
|
inputInfo.parameters.portalUrl | string |
portalUrl |
|
formato de saída
|
inputInfo.parameters.outputFormat | string |
formato de saída |
Obter pesquisas
Esta ação recupera uma lista de pesquisas pertencentes ao usuário conectado
Gatilhos
| Quando uma resposta de pesquisa é enviada |
Dispara um novo fluxo quando uma resposta de pesquisa é enviada por um usuário |
Quando uma resposta de pesquisa é enviada
Dispara um novo fluxo quando uma resposta de pesquisa é enviada por um usuário
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Survey
|
surveyId | True | string |
Survey |
|
events
|
events | True | array of string |
events |
|
Incluir informações do portal
|
includePortalInfo | True | boolean |
Inclua as informações do portal no conteúdo, como a URL do portal. |
|
Incluir informações do usuário
|
includeUserInfo | True | boolean |
Inclua as informações do usuário no conteúdo, como o nome de usuário, o endereço de email, o nome e o sobrenome. |
|
Incluir informações da pesquisa
|
includeSurveyInfo | True | boolean |
Inclua as informações da pesquisa no conteúdo, como o título da pesquisa e a ID do item da pesquisa. |
|
Incluir registro enviado
|
includeServiceRequest | True | boolean |
Inclua as informações de registro enviadas no conteúdo, como atributos e geometria do recurso. |
|
Incluir resposta do servidor
|
includeServiceResponse | True | boolean |
Inclua a resposta bruta do servidor no conteúdo. |