Além de enviar novos dados para uma camada de feição através de uma pesquisa, talvez seja necessário editar dados de pesquisa que você enviou recentemente, que foram coletados há algum tempo ou que foram coletados por outros usuários da pesquisa.
Habilitar edição
As respostas da pesquisa podem ser editadas na pasta Enviado e Caixa de Entrada. Para habilitar a edição de uma pesquisa, a edição também deve ser habilitada para a camada de feição subjacente.
Você pode editar pesquisas enviadas anteriormente que existam na pasta Enviado do Survey123 field app. Para mais informações sobre como configurar opções para pesquisas enviadas, consulte pasta Enviados.
Para editar os dados de pesquisa existentes armazenados na camada de feição da pesquisa (por exemplo, dados coletados por outro usuário), você deve habilitar a caixa de entrada.
Aviso:
Ativar a caixa de entrada permite o acesso de leitura aos dados da pesquisa, o que irá expor as respostas da pesquisa. Para obter mais informações e práticas recomendadas para proteger seus dados, consulte Compartilhar uma pesquisa.
Para habilitar a caixa de entrada, vá para a guia Opções da sua pesquisa no Survey123 Connect e clique na pasta Habilitar Caixa de Entrada. Uma série de opções aparece, permitindo a você controlar como os usuários interagem com as pesquisas na caixa de entrada. Quaisquer alterações nessas opções terão efeito quando a pesquisa for publicada.
Escolha se as pesquisas na caixa de entrada podem ser editadas, visualizadas (somente leitura) ou copiadas para uma nova pesquisa. Você pode digitar uma expressão de consulta para limitar as pesquisas que são retornadas na caixa de entrada. Você também pode aplicar um filtro espacial.
Anotação:
A Caixa de Entrada pode conter no máximo 5.000 respostas da pesquisa. Este limite se aplica apenas aos principais registros da pesquisa (não se aplica a repetições).
Quanto mais registros houver para retornar, mais tempo levará para atualizar a Caixa de Entrada. Para uma pesquisa que contém repetições, esteja ciente que o número total de registros que a Caixa de Entrada recupera quando é atualizada pode ser muito maior do que o número dos principais registros. Por exemplo, se uma camada de feição tiver 2.000 principais registros e cada registro pai tiver 10 registros repetidos, a Caixa de Entrada recuperará um total de 22.000 registros. Você pode limitar o número de principais registros aplicando uma expressão de consulta ou filtro espacial. Você pode limitar o número de registros repetidos definindo uma consulta na coluna bind::esri:parameters.
Aviso:
Uma resposta de pesquisa pode existir somente em um dispositivo em uma pasta por vez. Quando a pasta Enviado e Caixa de Entrada estão habilitadas para uma pesquisa, a atualização da caixa de entrada não baixa as respostas que já estão na pasta Enviado. Isso significa que se uma resposta que está na pasta Enviados for atualizada por um usuário em outro dispositivo, a resposta atualizada não será baixada para a caixa de entrada.
Por esse motivo, é recomendado que você não habilite a pasta Enviado e Caixa de Entrada para a mesma pesquisa se a sua intenção for que vários usuários editem e atualizem continuamente as respostas existentes.
Expressões WHERE
As pesquisas disponíveis para edição na caixa de entrada doSurvey123 field app são determinadas pela expressão de consulta especificada na guia Opções da sua pesquisa noSurvey123 Connect. A pesquisa deve ser publicada cada vez que esta consulta for modificada para que as alterações tenham efeito.
As expressões de consulta devem usar sintaxe SQL comum e funções suportadas pelo ArcGIS. Todas as consultas são executadas na camada de feição da pesquisa, para que você possa construir e testar sua expressão usando a operação de consulta no parâmetro REST da camada de feição. Para mais informações sobre este processo e exemplos da sintaxe de consulta, consulte Consultar (Serviço da Feição). Para mais informações sobre funções suportadas, consulte Funções SQL padronizadas no ArcGIS Online.
Os seguintes são exemplos de casos de uso e sintaxe:
- Este exemplo retorna pesquisas nas quais o número no campo rating é grande ou igual a dois:
rating>=2
- Este exemplo retorna pesquisas nas quais a data no campo EditDate for em ou após 13 de abril de 2017:
EditDate>='2017-4-13'
- Este exemplo retorna pesquisas nas quais o campo Editor é igual a 'BKlauser':
Editor='BKlauser'
- Este exemplo retorna pesquisas nas quais o campo status é igual a 'for_review':
status='for_review'
- Este exemplo retorna pesquisas cuja data no campo inspection_date é dos últimos sete dias:
inspection_date>CURRENT_DATE-7 AND inspection_date<=CURRENT_DATE
- Este exemplo retorna pesquisas nas quais o campo project_status não é igual a 'complete':
project_status<>'complete'
- Este exemplo retorna pesquisas cujo campo final_approval está em branco (nulo):
final_approval IS NULL
- Este exemplo retorna pesquisas cujo campo final_approval não está em branco (nulo):
final_approval IS NOT NULL
As consultas da caixa de entrada também suportam a variável username. Esta variável deve ser especificada no mesmo formato que as expressões XLSForm. Por exemplo, a consulta Creator=${username} retornaria todos os registros da pesquisa criados pelo usuário atualmente registrado.
Anotação:
A variável username é o único caso em que a sintaxe XLSForm pode ser usada em uma expressão de consulta de caixa de entrada. Mesmo que a variável username deva ser escrita como ${username}, seu valor é derivado da conta ArcGIS do usuário conectado, não de uma pergunta na pesquisa.
Para retornar registros do usuário conectado de um campo que contém uma lista de vários usuários, a função POSITION() deve ser usada na consulta. Por exemplo, a consulta POSITION(${username} IN assigned_to) > 0 retornaria todos os registros de pesquisa que incluem o usuário conectado, onde os valores no campoassigned_to poderiam ser uma lista separada por vírgulas de todos os possíveis responsáveis, como 'George_Smith, Nick_Jones'.
Filtro espacial
Na caixa de entrada, a seleção de Atualizar atualiza a lista de pesquisas mostradas na guia Lista . A ação de atualização geralmente retorna todas as pesquisas que atendem a expressão de consulta da caixa de entrada (se definida) e que ainda não estão armazenadas em outras pastas no dispositivo. Ao selecionar Atualizar na guia Mapa , um filtro espacial pode ser aplicado para atualizar a lista para mostrar somente as pesquisas que estão dentro da extensão do mapa atual.
Para habilitar o filtro espacial, selecione Aplicar filtro espacial quando a guia do mapa estiver visível na guia Opções no Survey123 Connect. No exemplo seguinte, quando Atualizar estiver selecionado, a lista de pesquisas será atualizada para mostrar somente as quatro respostas da pesquisa visíveis na extensão do mapa atual. Se a sua pesquisa tiver um nome de instância definido, cada feição no mapa será rotulado com seu nome de instância.
Repetições
O Survey123 permite a edição de feições que possuem registros relacionados tanto da pasta Caixa de entrada ou Enviados. Novos registros podem ser adicionados e registros existentes podem ser editados, embora a exclusão de registros existentes não seja suportada. A edição de registros existentes é desativado por padrão a menos que allowUpdates=true seja habilitado por um parâmetro de consulta.
A coluna bind::esri:parameters pode ser utilizado para fornecer parâmetros opcionais para uma repetição. Estes parâmetros são formatados como pares de valores-chaves, com valores que contêm espaços entre aspas.
Por padrão, nenhum registro relacionado está disponível com as respostas da pesquisa da pasta Caixa de Entrada ou Enviado. Para acessar registros relacionados a uma resposta, defina uma consulta na coluna bind::esri:parameters do tipo de questãoiniciar repetição . A propriedade de consulta suporta os mesmos parâmetros que as expressões WHERE acima, por exemplo, query="Editor='BKlauser'", para baixar somente os registros relacionados com 'BKlauser' no campo Editor.
Para baixar todos os registros em uma tabela relacionada, especifique uma consulta sem nenhum parâmetro (query).
Os parâmetros que podem ser aplicados para repetições através da coluna bind::esri:parameters em um tipo de pergunta iniciar repetição incluem o seguinte:
- query—Permite que os registros sejam consultados e baixados na tabela relacionada, por exemplo, query="severity='high'".
- allowAdds—Permite que novos registros sejam adicionados a uma repetição ao editar. O padrão é verdadeiro. Pode ser definido como falso utilizando allowAdds=false.
- allowUpdates—Permite que os registros existentes em uma repetição sejam atualizados ao editar. O padrão é falso. Pode ser definido como verdadeiro utilizando allowUpdates=true.
Múltiplos pares de valores-chaves podem ser utilizados em conjunto, separados por espaços, por exemplo, allowUpdates=true query="Editor='BKlauser'". Se estes valores tiverem espaços, eles poderão estar entre aspas.
Imagens
O Survey123 permite ao usuário adicionar imagens aos registros de pesquisa existentes. Embora a edição de imagens existentes não seja suportada, cada pergunta de imagem fornece um botão Duplicar ao editar uma pesquisa para copiar uma imagem existente que pode ser editada por rotação, renomeação ou edição com aparências draw e annotate.
O fornecimento de novas imagens está habilitado por padrão. Para desabilitar esta funcionalidade, digite allowAdds=false na coluna bind::esri:parameters.
Há algumas limitações conhecidas para a edição de imagens:
- Fluxos de trabalho offline não são suportados.
- A aparência signature não suporta a função Duplicar.
- Os anexos de imagem usam propriedades de palavra-chave para associar uma imagem à pergunta para a qual foi enviada. As propriedades de palavra-chave não são suportadas pelo ArcGIS Enterprise antes da versão 10.8.1, portanto, uma imagem enviada para uma pesquisa publicada no portal ArcGIS Enterprise antes da versão 10.8.1 não será associada a uma pergunta. Da mesma forma, as imagens anexadas a um elemento por meio de um método diferente de uma pesquisa (por exemplo, em um mapa da web ArcGIS Pro ou ArcGIS Online) podem não ter palavras-chave.
- Quando uma pesquisa existente é baixada para um dispositivo para uso na Caixa de Entrada, as imagens existentes não são baixadas. A função count-selected contará apenas as imagens que estão no dispositivo e retornará 0 quando a pesquisa for aberta pela primeira vez. Quaisquer novas imagens capturadas serão contadas.