O ArcGIS Survey123 suporta a configuração instance_name no XLSForm. Com o uso da configuração instance_name, o autor da pesquisa pode controlar quais informações são utilizadas para identificar exclusivamente cada resposta nas pastas Rascunhos, Caixa de Saída, Caixa de Entrada e Enviado do Survey123 field app.
O nome da instância é útil quando se olha para trás no histórico de pesquisas enviadas na pasta Enviado do Survey123 field app para identificar pesquisas individuais na Caixa de Entrada do aplicativo de campo.
Neste exemplo, a seguinte expressão foi aplicada ao nome de instância para as respostas a duas perguntas de texto separadas por um espaço como o identificador para cada registro de pesquisa (neste caso, o nome completo de uma pessoa):
concat(${first_name}, ' ', ${last_name})
O nome de instância é definido na planilha de configurações do seu XLSForm. Quando a coluna instance_name estiver vazia, um nome de instância padrão será aplicado, listando todas as respostas às perguntas da sua pesquisa. Digite uma expressão na coluna instance_name para personalizar o nome de instância. Por exemplo:
${site_name}
format-date(${date_time}, '%Y-%m-%d')
concat(${category}, ' Remarks: ', ${remarks})
concat(${street_number}, ' ', ${street_name}, ' ', ${suburb})
Você pode utilizar cálculos para criar seu nome de instância, por exemplo:
${first_number} + ${second_number}
Você também pode aplicar a formatação de HTML ao nome de instância. Você deve concatenar a sintaxe HTML como parte do nome de instância usando a função concat(). No seguinte exemplo, o nome de instância é formatado em texto azul itálico, com o sobrenome em negrito:
concat('<font color="blue"><i><b>', ${last_name}, '</b>, ', ${first_name}, '</i></font>')
Dica:
Se a sintaxe HTML incluir aspas, você deverá usar aspas simples para colocar uma string de texto que contenha aspas duplas ou vice-versa. Por exemplo: '<font color="yellow">'.
Os nomes de instância exibirão no máximo três linhas de texto.
O seguinte exemplo usa uma declaração if() para aplicar a formatação condicional ao nome de instância. Se a resposta à pergunta approved for yes, o nome de instância será verde; caso contrário, será colorido de vermelho:
if(${approved}='yes', concat('<font color="green"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'), concat('<font color="red"><b>', ${last_name}, '</b>, ', ${first_name}, '</font>'))
