Por padrão, ao publicar uma pesquisa no ArcGIS Survey123 Connect, uma camada de feição é criada utilizando o esquema de sua pesquisa. Alternativamente, você pode optar por associar sua pesquisa a uma camada de feição existente.
Preparar uma camada de feição
Para usar uma camada de feição com Survey123, ela deve ser um item no ArcGIS Enterprise ou ArcGIS Online. Isso inclui camadas de feição hospedadas e camadas de feição publicadas em servidores federados e não federados.
Anotação:
Para trabalhar com serviços da feição não federados, é necessário configuração adicional, pois você deve criar manualmente um item da camada de feição em sua organização do ArcGIS que representa o serviço. Para detalhes, consulte este artigo da Base de Conhecimento sobre como conectar aos serviços do ArcGIS Server não federados.
O proprietário e usuários da pesquisa devem ter acesso à camada de feição e ela deve ser editável. Considere também o seguinte:
- Se os usuários forem coletar novas pesquisas, o recurso Create será exigido.
- Se os usuários forem editar pesquisas existentes, o recurso Update na camada será exigido.
- Se usuários forem capturar imagens, áudio ou arquivos, hasAttachments deverá ser configurado para true.
Ao ativar anexos em uma camada de feição, as colunas KEYWORD e EXIFINFO não são incluídas no esquema por padrão. Esta coluna é necessária para poder associar anexos ao registro correto. Depois de habilitar os anexos, execute a Ferramenta de geoprocessamento Atualizar Anexos para ativar palavras-chave.
Anotação:
Recomenda-se que as colunas KEYWORD e EXIFINFO sejam adicionadas antes de coletar registros com Survey123 para que todos os anexos enviados tenham palavras-chave. Se as colunas KEYWORD e EXIFINFO não existirem antes do envio dos anexos, o notebook Atualizar palavras-chave de anexo do Python pode ser usado para atualizar anexos.As repetições não podem referenciar as camadas ou tabelas relacionadas, a menos que a camada ou tabela dependente utilize um campo GUID para o relacionamento.
Se você planeja editar suas pesquisas, garanta que a camada de feição permita valores nulos ou a pesquisa utilize campos exigidos. O Survey123 utiliza valores nulos na edição quando uma resposta é excluída e não é substituída; consequentemente, o Survey123 não enviará uma pesquisa de uma camada de feição que não permite valores nulos.
Os seguintes recursos adicionais devem ser configurados como verdadeiros para a camada de feição:
- supportsAttachmentsByUploadId—Este recurso é ativado automaticamente quando anexos são habilitados na camada de feição. Ele permite que o aplicativo carregue todos os anexos associados a uma pesquisa antes de enviá-la. Se algum dos anexos falhar, todo o envio da pesquisa será revertido, evitando a perda de dados.
- supportsApplyEditsWithGlobalIds—A camada de feição deve suportar a aplicação de edições com IDs globais. Isto permite que o aplicativo crie e gerencie IDs globais em feições criadas (ao contrário do servidor criar um novo ID global para as feições criadas).
Para que uma camada de feição possa suportar a aplicação de edições com IDs globais, os seguintes requisitos devem ser atendidos:
- As camadas na camada de feição devem ter uma coluna GlobalId com um índice único. A melhor maneira de fazer isso é habilitar a sincronização ao publicar a camada de feição.
- Se estiver usando um geodatabase multiusuário, as camadas podem usar versionamento de ramificação, mas não versionamento tradicional. O Survey123 terá como destino a versão padrão ao usar um geodatabase versionado da ramificação. Para mais informações, consulte Tipos de versionamento.
- IDs Globais devem existir em uma camada de feição ou tabela, antes de habilitar anexos.
- Se a camada de feição tiver camadas habilitadas para m, a edição sem valores m deverá ser habilitada.
Para mais informações sobre suporte à edição em uma camada de feição, consulte supportsApplyEditsWithGlobalIds em Camda (Serviço de Feição) na documentação do ArcGIS REST API.
Anotação:
O Survey123 somente suporta relacionamentos de GUID de um-para-muitos ao trabalhar com camadas de feição existentes e tabelas relacionadas. Os relacionamentos individuais não são suportados.
Criar uma pesquisa a partir da camada de feição
Você pode criar uma pesquisa a partir de uma camada de feição existente no Survey123 Connect. A camada de feição deve serpreparada para uso com Survey123. Entre na sua organização do ArcGIS, e clique em Nova pesquisa. Escolha a categoria Serviço da feição. Procure e selecione a camada de feição e clique em Criar Pesquisa. Um XLSForm é gerado a partir da camada de feição. Você pode então publicar esta pesquisa imediatamente ou personalizá-la ainda mais. Por exemplo, você pode adicionar mais rótulos descritivos às perguntas ou organizá-los em grupos.
Se a camada de feição escolhida tiver mais de uma camada, a pesquisa será gerada com base na primeira camada. Para basear uma pesquisa em outra camada da camada de feição, você deve criar a pesquisa manualmente e atualizar as propriedades form_id e submission_url na guia configurações da planilha. Para mais informações, consulte Criar uma pesquisa que corresponda a uma camada de feição.
Se a camada de feição que você escolheu tiver anexos, uma única pergunta de imagem será criada na pesquisa com o nome <layer_name>_image. Este nome não corresponderá a uma palavra-chave na tabela de anexos e deve ser atualizado. Se os anexos existentes representarem mais de uma pergunta, você deverá adicionar perguntas de imagem à pesquisa para corresponder a cada uma das palavras-chaves na tabela de anexos.
Anotação:
Se a pesquisa que você está criando exigir perguntas de áudio ou arquivo, você deverá adicioná-las à pesquisa manualmente. Após gerar a pesquisa, abra a planilha e adicione as perguntas. Para mais informações, consulte Perguntas de mídia. A camada de feição também deve ter anexos habilitados.
Criar uma pesquisa que corresponda a uma camada de feição
Você pode criar manualmente uma nova pesquisa que corresponda a uma camada de feição existente, mas você deve atualizar as propriedades form_id e submission_url na guia configurações da planilha para definir um link entre a pesquisa e o item da camada de feição em seu portal ou ArcGIS Online.
A propriedade form_id define explicitamente o nome da camada na camada de feição que é utilizada pela pesquisa. Para mais informações, consulte o artigo da Base de Conhecimento sobre como criar uma pesquisa que corresponda a um serviço da feição.
A propriedade submission_url é a URL de item da camada de feição.
Dica:
Você deve fornecer a URL do item da camada de feição, conforme mostrado acima. Um erro comum é utilizar a URL da camada de feição, que não é suportada.
Para criar esta URL, você deve concatenar o ID do Item com o Conteúdo Raiz do portal. O exemplo na imagem acima mostra um link para um item do ArcGIS Online; o link para o mesmo item em um portal se parece com o seguinte:https://<host>:<port>/arcgis/sharing/rest/content/items/21a6c530b31a4523bdff7gg94c9c5d9a
Se você precisar de uma pesquisa que exija alguns, mas não todos os campos de uma camada de feição existente, é recomendado que você gere uma pesquisa a partir da camada de feição (conforme descrito na seção acima) e exclua as perguntas que não são necessárias antes publicar a pesquisa. Desta forma, as propriedades form_id e submission_url são criadas automaticamente.
Modificar esquema
Após uma pesquisa ser criada a partir de uma camada de feição existente, novas perguntas e valores da lista de opções poderão ser adicionados à pesquisa somente após o campo ou domínio correspondente ser adicionado à camada de feição. Quando uma pesquisa é criada a partir de uma visualização da camada de feição, novas perguntas e valores da lista de opções podem ser adicionados à pesquisa somente após o campo ou domínio correspondente ser adicionado à camada de feição subjacente e ter sido propagado para a visualização da camada de feição.