Se o seu mapa tiver camadas de feição editáveis (camadas de feição hospedadas, visualizações da camada de feição hospedada, camadas de tabela hospedadas ou camadas de feição do ArcGIS Server), você poderá definir formulários que os editores poderão usar ao atualizar os valores de campos para as camadas de feição no mapa da web. Você pode definir um formulário para cada camada de feição editável no mapa ou apenas aquelas camadas que você sabe que os usuários do mapa precisarão editar.
Ao criar um formulário, você especifica quais elementos ele contém e como os elementos aparecem. Ter um formulário ajuda a orientar os editores para os campos corretos e valores de atributo permitidos para cada campo editável.
O formulário é salvo como parte do mapa. Quando você compartilha o mapa, outras pessoas podem usar os formulários que você define para editar as camadas de feição ou camadas de tabela no mapa.
Anotação:
Atualmente, você pode configurar formulários no Map Viewer no ArcGIS Online e ArcGIS Enterprise e no aplicativo da web ArcGIS Field Maps.
Você pode usar formulários para editar camadas de feição doMap Viewer no ArcGIS Online e ArcGIS Enterprise e no ArcGIS Field Maps mobile app.
Antes de criar um formulário
Antes de criar um formulário para uma camada de feição em seu mapa, familiarize-se com o conteúdo da camada e as configurações de campo. O conteúdo de um campo afeta a criação de grupos de elementos para os campos. As configurações aplicadas a um campo, como se valores nulos são permitidos, se um valor padrão é definido e se o proprietário da camada definiu listas para o campo, afetam como você formata os elementos do campo no formulário.
Criar um formulário
Você pode criar um formulário de entrada para cada camada de feição editável no mapa. Você define quais campos (elementos) aparecem no formulário e onde eles são colocados.
Quando um editor seleciona uma feição em uma camada de feição editável, o formulário aparece para que o editor possa inserir valores de atributo para essa camada.
Siga estas etapas para criar um formulário para uma camada de feição editável:
- Confirme se você está conectado e se tem privilégios para criar conteúdo.
- Na barra de ferramentas (escura) Conteúdo , clique em Camadas para abrir o painel Camadas .
- Adicione uma camada de feição editável no mapa.
- Com a camada de feição editável selecionada, clique em Mais na barra de ferramentas (clara) Configurações e clique em Formulários
.A janela Configurar formulário aparece.
- Use as seguintes opções sozinhas ou em combinação para adicionar elementos ao formulário.
Os elementos do formulário são agrupamentos de campos e os campos de entrada que aparecem no formulário. Elementos de campo são baseados em campos existentes na camada de feição.
- Converter o pop-up existente—Se você configurou pop-ups para a camada de feição, poderá usar a configuração de pop-up existente como ponto de partida para configurar o formulário.
- Adicionar campos—Escolha quais campos da camada adicionar ao formulário. Quando um campo é adicionado à tela do formulário, ele se torna um elemento do formulário.
- Criar grupos de elementos—Você pode criar elementos de grupo expansíveis e recolhíveis para manter as informações logicamente relacionadas juntas no formulário.
- Após adicionar campos e grupos como elementos à tela do formulário, formate cada elemento.
- Opcionalmente, defina ou expressões de SQL ou Arcade que definem quando um elemento deve ou não aparecer no formulário.
- Ao terminar de adicionar, formatar e configurar expressões condicionais para os elementos do formulário, clique em OK para criar o formulário.
- Salve o mapa.
Anotação:
Se você fechar o mapa sem salvá-lo, perderá o formulário.
Caso seja necessário alterar o formulário após criá-lo, repita as etapas acima. Certifique-se de salvar o mapa após editar o formulário.
Converter o pop-up existente
Se a camada de feição tiver pop-ups configurados, clique em Converter pop-up para adicionar campos do pop-up à tela do formulário.
Os campos que não fazem parte da configuração de pop-up aparecem na lista Campos no Construtor de formulário. Você pode arrastá-los para a tela do formulário para adicioná-los como elementos ao formulário, conforme descrito na próxima seção.
Após adicionar campos como elementos ao formulário, você poderá criar grupos para agregar campos relacionados ou prosseguir com a formatação dos elementos do campo.
Anotação:
Os campos que contêm metadados de GPS de alta precisão podem aparecer somente no formulário se forem importados de um pop-up existente. Como esses campos devem ser preenchidos apenas com dispositivos GPS, desabilite a edição de elementos do formulário correspondentes.
Adicionar campos
Escolha quais campos da camada apresentar aos editores como elementos do formulário. Na maioria dos casos, você adiciona campos que os editores usarão para atualizar os valores.
Por exemplo, se a camada de feição tiver os seguintes campos—Nome do Local, Tipo de Local, Status da Construção, Paisagismo, Data de Edição, Nome do Editor, Data de Criação, Nome do Criador, ID e Forma—você poderá colocar apenas os campos Nome do Local, Tipo de Local, Status da Construção e Paisagismo no formulário, pois os campos Data de Edição, Nome do Editor, Data de Criação, Nome do Criador e ID serão preenchidos automaticamente, e o campo Forma será preenchido quando os editores adicionarem uma feição à camada.
Você também pode adicionar campos para referência e desabilitar a edição no elemento do formulário. No exemplo anterior, você pode incluir o campo Data de Edição como um elemento não editável no formulário para que os editores possam visualizar quando a feição foi atualizada pela última vez.
- Use um dos seguintes métodos para adicionar campos como elementos ao formulário:
- Adicionar todos os campos no formulário—Clique em Adicionar todos na lista Campos para incluir todos os campos da camada do formulário. Quando você tem muitos campos editáveis na camada, adicionar todos os campos e remover um ou dois sistemas ou campos não editáveis é mais rápido do que adicionar campos individuais.
- Adicionar uma seleção de campos no formulário—Para incluir uma seleção específica de campos no formulário, pressione a tecla Ctrl, clique nos campos a serem incluídos e arraste-os para a tela do formulário.
- Adicionar campos um por um—Para adicionar um único campo de cada vez ao formulário, clique duas vezes nele ou arraste-o para a tela do formulário.
Dica:
Se a camada ou tabela tiver um grande número de campos, você poderá usar a barra de pesquisa Localizar Campos na lista Campos para localizar um campo específico.
- Após adicionar campos como elementos ao formulário, você poderá criar grupos (conforme descrito na próxima seção) ou prosseguir com a formatação de elementos do campo.
Criar grupos e elementos
Para agrupar campos relacionados no mesmo local físico no formulário, crie um elemento de grupo. Agrupar elementos é semelhante a colocar perguntas na mesma seção em um formulário de papel. Os grupos em formulários digitais têm a vantagem adicional de poderem ser contratados para mostrar apenas o cabeçalho do grupo até que o usuário do formulário expanda o grupo.
Por exemplo, em um formulário para atualizar o conteúdo em uma camada de feição de trilhas, crie um grupo para todos os campos relacionados às propriedades da trilha, como nome, tipo e dificuldade da trilha. Você pode criar um grupo separado para os campos que registram informações de manutenção da trilha, como o nome da equipe de manutenção, a data da última execução da manutenção e a descrição da manutenção realizada. Se você optar por abrir o formulário com os grupos recolhidos, os editores visualiarão apenas os nomes dos dois grupos até que os expandam.
Siga estas etapas para agrupar elementos relacionados no formulário em uma seção recolhível:
- Arraste o elemento Grupo da lista Elementos do Formulário para a tela do formulário.
Um elemento do formulário é adicionado à tela do formulário.
- Arraste os campos relacionados para o grupo.
Você pode arrastar campos da lista Campos no painel Construtor de formulários ou da tela do formulário.
- Selecione o elemento do grupo para editar suas propriedades.
O painel Propriedades aparece, permitindo que você edite as seguintes informações:
- Nome de visualização—Forneça um nome que descreva os campos contidos no grupo. Isso é semelhante a um cabeçalho de seção em um formulário de papel. Este valor é exigido.
- Descrição—Forneça uma descrição para o grupo.
- Estado inicial—Por padrão, os grupos são expandidos quando o formulário é aberto, o que significa que todos os campos são visíveis automaticamente. Desmarque a caixa de seleção Expandido se desejar que o estado inicial do grupo seja contraído. Os usuários do formulário clicarão no grupo para expandi-lo e visualizar os campos que ele contém.
- Visibilidade Condicional— Adicione um SQL ou expressão de atributo Arcade para aplicar regras de quando o grupo deve aparecer no formulário. Consulte Configurar visibilidade condicional para detalhes.
Dica:
Você pode remover todos os elementos do formulário a partir de um grupo selecionando Desagrupar na barra de ferramentas do grupo. Você pode remover múltiplos elementos do grupo pressionando Ctrl, selecionando cada elemento que deseja remover e arrastando-os para fora do grupo.
Aplicar formatação aos elementos do formulário
Quando você seleciona um elemento do formulário na tela do formulário, o painel Propriedades aparece.
A seção anterior descreveu as propriedades de configuração para os elementos do grupo.
Para elementos de campo, a seção Formatação do painel Propriedades mostra as propriedades que você pode definir para o elemento no formulário e aquelas que são herdadas da camada e não podem ser alteradas para o formulário. As seguintes seções descrevem as propriedades que você pode definir para elementos de campo no formulário.
Definir um nome de exibição
Cada elemento do formulário exige um valor para o Nome de exibição. O nome de exibição é o rótulo que acompanha o elemento no formulário.
Para campos, o nome de exibição padrão é igual ao nome do campo. Aceite o padrão ou digite um nome de exibição mais amigável ou descritivo para cada campo.
Formatar elementos de texto
Se um elemento de formulário fizer referência a um campo de string, siga estas etapas para formatar o elemento:
- Selecione um elemento do formulário de texto para abrir o painel Propriedades.
- Clique no menu suspenso Tipo de Entrada e selecione uma das opções.
- Código de Barras—Isso pode ser usado apenas em aplicativos que têm um leitor de código de barras. Se você escolher este tipo de entrada, o elemento reverterá para uma única linha de texto em aplicativos que não podem ler códigos de barras como entrada, como Map Viewer.
- Texto - Única linha—O campo de entrada no formulário mostrará uma única linha de texto.
- Texto - Múltiplas linhas—O campo de entrada no formulário terá várias linhas de altura. Use este tipo de entrada para campos de texto com um comprimento máximo alto para permitir que os editores vejam todo o texto no campo.
- Para exibir o texto no campo que solicita ao editor o valor correto, digite esse texto no campo Espaço reservado.
Por exemplo, você pode escrever Digite o nome do candidato como texto do espaço reservado para um campo que armazena o nome da pessoa que está solicitando um empréstimo.
O texto do espaço reservado aparece dentro do elemento do campo de entrada e é substituído pelo texto fornecido pelo editor.
Você não pode definir o texto do espaço reservado para um campo que tenha um valor padrão definido.
- No campo Descrição, forneça um texto que explique o que os valores no campo representam.
A descrição aparece abaixo do elemento no formulário.
- Defina os valores para Comprimento mín. (comprimento mínimo de caracteres) e Comprimento máx. (comprimento máximo de caracteres) do elemento.
Às vezes, uma camada de feição é publicada com um tamanho do campo de texto padrão, em vez de um comprimento que faz sentido para o campo. Por exemplo, um campo que pode ter apenas um número finito de valores, como sim, não ou desconhecido, pode ter um comprimento de campo na camada de feição de 256 caracteres. Mas você pode definir um mínimo e máximo de 1 se quiser que os editores digitem apenas y, n ou u ao editar valores no campo.
Você não pode definir um comprimento máximo de caracteres maior que o comprimento do campo.
- Use o menu suspenso Exigido para definir se a entrada no campo é obrigatória.
Consulte Definir os elementos conforme necessário para obter mais informações.
- Para evitar que os editores usem o formulário para atualizar os valores neste campo, desmarque Permitir edição.
Por exemplo, você pode incluir um campo para fins de referência, mas não deseja que os editores alterem os valores no campo.
Formatar elementos de data
Você pode configurar elementos de data para usar um selecionador de data ou um selecionador de data e hora. Você também pode definir um intervalo de valores de data aceitáveis, especificando as datas inicial e final.
Siga estas etapas para formatar os elementos que fazem referência aos campos de data:
- Selecione um elemento do formulário de texto para abrir o painel Propriedades.
- Clique no menu suspenso Tipo de Entrada e selecione uma das opções.
- Data—Isso permite que o editor forneça uma data.
- Data e hora—Isso permite que o editor forneça uma data e hora.
- No campo Descrição, forneça um texto que explique o que os valores no campo representam.
A descrição aparece abaixo do elemento no formulário.
- Para elementos de data, opcionalmente, defina valores para os parâmetros Data de inicial e Data final para restringir um intervalo de data que os editores podem usar.
Por exemplo, para um campo de data em uma nova camada que registra as inspeções que serão concluídas no primeiro trimestre do ano, defina a data inicial para o primeiro dia do ano e a data final para 31 de Março do ano apropriado.
- Para elementos de data e hora, opcionalmente, defina valores para os parâmetros Hora inicial e Hora final.
Por exemplo, para formulários usados apenas durante o horário comercial, você pode restringir a hora inicial e final para que não fiquem fora do horário comercial.
- Use o menu suspenso Exigido para definir se a entrada no campo é obrigatória.
Consulte Definir os elementos conforme necessário para obter mais informações.
- Para evitar que os editores usem o formulário para atualizar os valores neste campo, desmarque Permitir edição.
Por exemplo, você pode incluir um campo para fins de referência, mas não deseja que os editores alterem os valores no campo.
Formatar elementos de número
Se o elemento usar um campo da camada de feição que seja um tipo de dados duplo ou inteiro, siga estas etapas para formatar o elemento do formulário:
- Selecione um elemento do formulário de texto para abrir o painel Propriedades.
- Clique no menu suspenso Tipo de Entrada e selecione uma das opções.
- Código de Barras—Isso pode ser usado apenas em aplicativos que têm um leitor de código de barras. Se você escolher este tipo de entrada, o elemento será revertido para o tipo de entrada padrão em aplicativos que não podem ler códigos de barras como entrada, como Map Viewer.
- Número - Duplo— Se o campo na camada for definido como duplo, o aplicativo onde o mapa será usado para edição não aceitará um código de barras como entrada e os editores precisarão inserir números decimais, escolha Número - Duplo.
- Número - Inteiro—Se o campo na camada for definido como um inteiro ou duplo, o aplicativo onde o mapa será usado para edição não aceitará um código de barras como entrada e os editores não deverão inserir números decimais, escolha Número - Inteiro.
- Para exibir o texto no campo que solicita ao editor o valor correto, digite esse texto no campo Espaço reservado.
Por exemplo, você pode escrever Digite o nome do candidato como texto do espaço reservado para um campo que armazena o nome da pessoa que está solicitando um empréstimo.
O texto do espaço reservado aparece dentro do elemento do campo de entrada e é substituído pelo texto fornecido pelo editor.
Você não pode definir o texto do espaço reservado para um campo que tenha um valor padrão definido.
- No campo Descrição, forneça um texto que explique o que os valores no campo representam.
A descrição aparece abaixo do elemento no formulário.
- Use o menu suspenso Exigido para definir se a entrada no campo é obrigatória.
Consulte Definir os elementos conforme necessário para obter mais informações.
- Para evitar que os editores usem o formulário para atualizar os valores neste campo, desmarque Permitir edição.
Por exemplo, você pode incluir um campo para fins de referência, mas não deseja que os editores alterem os valores no campo.
Formatar um elemento que contém uma lista de três ou mais valores
Se o campo na camada de feição tiver uma lista definida para ele contendo três ou mais valores, você poderá configurar o elemento do formulário para aparecer como uma caixa de combinação ou botões de rádio.
- Selecione um elemento de formulário que faz referência a um campo com uma lista de valores definida para abrir seu painel Propriedades.
- Na seção Formatação, clique no menu suspenso Tipo de entrada e selecione uma das seguintes opções:
- Caixa de Combinação—Os usuários do formulário escolhem um valor em uma lista de opções disponíveis.
- Botões de opção—Todas as opções aparecem no formulário com botões de opção ao lado delas. Os usuários do formulário clicam no botão de opção apropriado.
Se a lista tiver muitos valores (por exemplo, sete ou mais valores), uma caixa de combinação economizará espaço no formulário.
- No campo Descrição, forneça um texto que explique o que os valores no campo representam.
A descrição aparece abaixo do elemento no formulário.
- Use o menu suspenso Exigido para definir se a entrada no campo é obrigatória.
Consulte Definir os elementos conforme necessário para obter mais informações.
- Para evitar que os editores usem o formulário para atualizar os valores neste campo, desmarque Permitir edição.
Se o elemento do formulário não for editável, o botão de opção ou a configuração de opção da lista no formulário mostrará o valor existente para o atributo. Se você adicionar uma feição, nenhum valor será mostrado para a caixa de combinação ou para os elementos do botão de opção, a menos que o campo tenha um valor padrão definido.
Formatar elementos com dois possíveis valores
Se o campo na camada de feição tiver uma lista definida para ele contendo apenas dois possíveis valores, e o campo tiver um valor padrão definido na camada, você poderá definir esse elemento para aparecer como um botão de alternância no formulário, ou aparecer como uma caixa de combinação ou botões de opção.
Se o campo na camada não tiver um valor padrão definido, você poderá configurar o elemento para aparecer como uma caixa de combinação ou botões de opção no formulário.
- Selecione um elemento do formulário que faz referência a um campo com uma lista de dois valores definida e um valor padrão definido para abrir seu painel Propriedades.
- Na seção Formatação, clique no menu suspenso Tipo de entrada para escolher como apresentar este elemento:
- Caixa de Combinação—Os usuários do formulário escolhem um valor de uma lista suspensa.
- Botões de opção—As opções aparecem no formulário com botões de opção ao lado delas. Os usuários do formulário clicam no botão de opção apropriado.
- Alternar—Os usuários do formulário habilitam ou desabilitam um botão de alternância.
Você pode alterar qual valor equivale a uma chave habilitada clicando no botão Trocar ordem de valores próximo aos valores da chave.
Se o campo não tiver um valor padrão definido e você escolher Alternar para o tipo de entrada, o elemento será exibido como uma caixa de combinação no formulário.
- No campo Descrição, forneça um texto que explique o que os valores no campo representam.
A descrição aparece abaixo do elemento no formulário.
- Use o menu suspenso Exigido para definir se a entrada no campo é obrigatória.
Consulte Definir os elementos conforme necessário para obter mais informações.
- Para evitar que os editores usem o formulário para atualizar os valores neste campo, desmarque Permitir edição.
Se o elemento do formulário não for editável, o botão de opção ou a configuração de opção da lista no formulário mostrará o valor existente para o atributo. Se você adicionar uma feição, nenhum valor será mostrado para a caixa de combinação ou para os elementos do botão de rádio. Para trocar os elementos, a configuração padrão é exibida no formulário.
Definir elementos como exigidos
Para forçar a entrada de dados para um campo, você pode configurar os elementos do formulário de forma que exijam uma entrada. Por exemplo, se todos os aplicativos exigirem uma data de envio, configure o elemento da data de envio para ser obrigatório.
Quando os editores usam o formulário, eles visualizam um asterisco próximo aos campos que exigem entrada e não podem salvar suas edições até que um valor seja fornecido.
- Clique em um elemento do formulário de campo para abrir o painel Propriedades.
- Clique no menu suspenso Exigido e selecione uma das seguintes opções:
- Não—Selecione esta opção quando o elemento do formulário não precisar ser atualizado usando este formulário e quando o campo na camada de feição for opcional quando outros aplicativos estiverem adicionando ou editando dados.
- Sim, não permitir valores nulos—Selecione esta opção quando os editores forem obrigados a fornecer uma entrada para o elemento de campo e quando o campo na camada de feição estiver configurado como um campo não anulável.
- Sim, permitir valores nulos—Selecione esta opção quando os editores forem obrigados a fornecer uma entrada para o elemento de campo, mas o campo na camada de feição permitir valores nulos.
Configurar visibilidade condicional
Você pode mostrar ou ocultar condicionalmente os elementos do formulário com base nos valores adicionados aos campos anteriores. Por exemplo, um formulário de Avaliação de Construção inclui um campo para indicar se há danos causados pela água. Também inclui um elemento do formulário de grupo contendo campos relacionados a danos causados pela água. Uma expressão de visibilidade condicional pode ser aplicada ao grupo de danos por água, de forma que ela apareça somente se o dano por água for indicado no campo anterior. Para criar uma expressão de visibilidade condicional, conclua as seguintes etapas:
- Clique em um elemento do formulário de campo para abrir o painel Propriedades.
- Na seção Visibilidade Condicional, clique em + Adicionar expressão.
A janela Editar expressão aparece.
- Crie uma expressão usando um dos seguintes métodos:
- Use os menus suspensos para escolher campos, operações e valores para construir a expressão.
- Clique em Iniciar editor Arcade para escrever um expressão Arcade no editor Arcade. Isso é útil para expressões mais complexas.
Cada expressão é definida por uma ou mais condições. Uma condição inclui um nome de campo, um operador e, potencialmente, um valor. A lista de operadores disponíveis é determinada pelo tipo de campo (string, número ou data).
Por exemplo, se um elemento do grupo de danos de água precisar somente aparecer se o dano de água foi indicado em um campo anterior, a seguinte condição poderá ser usada para construir a expressão:
- Nome do campo—Dano de água
- Operador—is
- Valor—Yes
Aqui está a aparência da mesma expressão n sintaxeArcade :
DomainName($feature, "water_damage") == "Yes"O Map Viewer aplica o perfil Restrição do Arcade para avaliar se uma feição atende os critérios definidos na expressão. Se um valor diferente de Yesfor indicado no campo water_damage, o grupo de danos causados pela água não aparecerá no formulário.
- Para aplicar mais de uma condição, clique em Adicionar condição e repita a etapa anterior.
Anotação:
Se você definir várias condições, escolha se todas as condições devem ser verdadeiras (Corresponder a todas as condições) ou apenas uma condição deve ser verdadeira (Corresponder a pelo menos uma condição) para que o elemento do formulário seja exibido.
- Clique em Salvar.
A expressão de visibilidade condicional é aplicada ao grupo ou campo.
Agora que salvou a expressão, você poderá aplicá-la a qualquer elemento do formulário selecionando o elemento do formulário e clicando na expressão criada. Você pode visualizar quais elementos estão usando a expressão clicando no número ao lado da expressão no painel Propriedades em Visibilidade Condicional.
Você pode duplicar, editar ou excluir a expressão a qualquer momento no menu Visibilidade Condicional. Para editar a expressão usando Arcade, clique em Editar (avançado) neste menu.