Configurar formulários para edição de atributos (Map Viewer)

Se o seu mapa tiver camadas de feição (camadas de feição hospedadas, visualizações da camada de feição hospedada, camadas de tabela hospedadas, camadas de grupo de subtipo ou camadas de feição do ArcGIS Server), você poderá definir formulários que os editores podem usar quando atualizam valores de campo para as camadas de feição no mapa da web. Você pode definir um formulário para cada camada de feição no mapa ou apenas aquelas camadas que você sabe que os usuários do mapa precisarão editar.

Dica:

Se você possuir a camada de feição que estiver no mapa ou você for um administrador da organização, você poderá configurar formulários para a camada de feição antes de habilitar a edição na camada.

Ao configurar um formulário, você especifica quais elementos de formulário o formulário 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 pode ser salvo como parte do mapa ou da camada. Quando você compartilha o mapa ou a camada, outras pessoas podem usar os formulários que você define para editar as camadas de feições ou registros relacionados no mapa. Para saber mais, consulte Salvar o formulário.

Anotação:

Atualmente, você pode configurar formulários no Map Viewer no ArcGIS Online e ArcGIS Enterprise e no Field Maps Designer.

Antes de configurar um formulário

Antes de configurar um formulário para uma camada de feição em seu mapa, familiarize-se com o conteúdo da camada e 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 fossem permitidos, se um valor padrão for definido e se o proprietário da camada definiu listas para o campo—afetam como você formata os elementos do campo no formulário.

Configurar um formulário

Você pode configurar um formulário de entrada para cada camada de feição 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 configurar um formulário para uma camada de feição:

  1. Confirme se você está conectado e se tem privilégios para criar conteúdo.
  2. Na barra de ferramentas (escura) Conteúdo , clique em Camadas para abrir o painel Camadas .
  3. Adicione uma camada de feição ao mapa.
  4. Com a camada de feição selecionada, clique em Formulários Formulários barra de ferramentas Configurações (clara).

    A janela Configurar formulário aparece.

  5. 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.
    • 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.
    • Adicionar texto descritivo—Você pode adicionar texto descritivo ao formulário para fornecer informações contextuais que descrevam a finalidade de um elemento do 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.
    • Adicionar elementos de registro relacionados—Você pode adicionar elementos de registro relacionados ao formulário quando a camada de feição tiver uma tabela relacionada ou camada de feição.
    • Adicionar grupos de campos de valor contingente—Se os dados na camada de feição tiverem valores contingentes definidos, a lista Grupos de campo está presente no Construtor de formulários. Isso permite adicionar grupos de campos logicamente relacionados à tela do formulário em uma única etapa.
  6. Após adicionar campos e grupos como elementos à tela do formulário, formate cada elemento.
  7. Opcionalmente, escreva expressões Arcade que definam as condições que afetam um elemento.
  8. Ao terminar de adicionar, formatar e configurar expressões condicionais para os elementos do formulário, clique em OK.
  9. Salvar o formulário.

    Anotação:

    Se você fechar o mapa sem salvá-lo, perderá o formulário.

Se precisar alterar o formulário, repita as etapas acima. Não se esqueça de salvar o formulário depois de editá-lo.

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 texto descritivo

Você pode adicionar texto descritivo ao formulário para fornecer informações contextuais ou detalhes adicionais sobre os elementos do formulário. O texto descritivo é somente leitura e não pode ser alterado pelos editores de formulários.

Siga estas etapas para adicionar um elemento de texto descritivo ao formulário:

  1. Arraste o elemento Info da lista Elementos de formulário para a tela do formulário.

    O painel Propriedades aparece, permitindo editar o elemento de texto descritivo.

  2. Na seção Formatação, no editor de texto, siga um destes procedimentos:
    • Insira texto simples no editor de texto.
    • Use as ferramentas de formatação de texto para formatar o texto.
    • Clique em Selecionar campo ou expressão Selecionar campo ou expressão ou digite { e selecione um campo ou expressão. Utilize esta opção se você desejar um único texto para cada campo.
  3. Na seção Visibilidade, adicione uma expressão de atributo Arcade para aplicar regras de quando o texto deve aparecer no formulário. Consulte Configurar visibilidade condicional para detalhes.
  4. Saia do painelPropriedades para confirmar suas alterações e retornar ao painel Construtor de formulários.
  5. Opcionalmente, após adicionar um elemento de texto descritivo ao formulário, continue adicionando elementos de campo.

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.

  1. 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.

  2. Opcionalmente, depois de adicionar campos como elementos ao formulário, crie grupos ou prossiga com a formatação dos elementos de campo.

Adicionar elementos de registro relacionados

Se você criou uma classe de relacionamento no geodatabase no ArcGIS Pro antes de publicar uma camada de feição hospedada, se a camada de feição hospedada foi criada usando um modelo que inclui uma classe de relacionamento, ou a camada de feição hospedada foi criada para um formulário contendo uma seção repetida no ArcGIS Survey123 Connect, você pode adicionar um elemento de registro relacionado ao formulário. Isso permite que os usuários visualizem e adicionem registros relacionados associados à camada de feição hospedada, como uma tabela, enquanto preenchem o formulário.

Dica:

Para obter instruções sobre como criar uma classe de relacionamento no ArcGIS Pro, consulte as seguintes páginas de ajuda:

Por exemplo, em um formulário usado para monitorar a saúde das árvores urbanas, uma tabela relacionada pode incluir inspeções de cada árvore. Por exemplo, em um formulário usado para monitorar a saúde das árvores urbanas, uma tabela relacionada pode incluir inspeções de cada árvore.

Anotação:

  • Deve existir uma classe de relacionamento para os dados antes que um elemento de registro relacionado possa ser adicionado ao formulário.
  • Para editar registros relacionados, a camada e suas tabelas ou camadas de feição relacionadas devem estar no mapa, e cada tabela ou camada relacionada deve ter a edição habilitada.
  • As cardinalidades de relacionamento de um-para-um e um-para-muitos entre uma classe de feição (origem) e uma tabela (destino) ou classe de feição destino) nos dados de origem são suportadas atualmente.
  • A adição de elementos de registro relacionados ao formulário é atualmente suportada para camadas de feição hospedadas e visualizações da camada de feição hospedada. As tabelas hospedadas também são suportadas se participarem de um relacionamento com uma tabela ou camada de feição de destino.

Siga estas etapas para adicionar um elemento de registro relacionado ao formulário:

  1. Na lista Registro relacionado, clique duas vezes em um elemento de registro relacionado ou arraste-o para a tela do formulário.

    O elemento de registro relacionado é adicionado à tela do formulário.

  2. Formate as propriedades do elemento de registro relacionado.

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:

  1. 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.

  2. 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.

  3. 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 uma 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.

Adicionar grupos de campos contingentes ao formulário

Se o proprietário dos dados criou grupos de campos no ArcGIS Pro contingentes para os dados, os grupos de campos contingentes aparecerão na lista Grupos de campos ao lado da tela do formulário.

Como os campos estão relacionados—os valores de um campo determinam ou limitam quais valores você pode definir para os outros campos—os campos contingentes são adicionados ao formulário em um elemento de grupo quando você os adiciona da lista Grupos de campos. Os campos contingentes devem ficar agrupados para que os editores possam preenchê-los posteriormente no Map Viewer. Se você remover um campo de seu grupo de campos, um aviso será exibido.

Os grupos de campos contingentes que compartilham um ou mais campos são listados juntos. Eles são adicionados ao formulário como um grupo de campos.

Os grupos de campos que você deve adicionar ao formulário aparecem na seção Exigido da lista. Os grupos de campos são exigidos se foram configurados como restritivos no ArcGIS Pro, o que significa que os valores de atributo que os editores fornecem ao editar os campos neste grupo de campos devem estar em conformidade com as definições de valores contingentes.

Aviso:

Se você não adicionar grupos de campos contingentes exigidos à tela do formulário, os editores não poderão usar o formulário para editar a camada de feição.

Para aprender como criar grupos de campos contingentes no ArcGIS Pro, consulte Criar e gerenciar valores contingentes.

Siga estas etapas para adicionar grupos de campos de valor contingente ao formulário:

  1. Use um dos seguintes métodos para adicionar grupos de campos ao formulário:
    • Adicionar campos um por um—Para adicionar um único grupo de campos ao formulário, clique duas vezes nele ou arraste-o para a tela do formulário.
    • Adicionar uma seleção de grupos de campos ao formulário—Para adicionar uma seleção específica de grupos de campos ao formulário, pressione a tecla Ctrl, clique nos grupos de campos a serem incluídos e arraste-os para a tela do formulário.
    • Adicionar todos os grupos de campos ao formulário—Clique em Adicionar todos na lista Grupos de campos para incluir todos os campos da camada no formulário.

    Dica:

    Se a camada ou tabela contiver um grande número de grupos de campos, você poderá usar a barra de pesquisa Localizar grupos de campos na lista Grupos de campos para localizar um grupo de campos específico.

  2. Depois de adicionar grupos de campos como elementos ao formulário, formate os elementos do grupo e formate os elementos do campo.

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 a configuraçã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:

  1. Selecione um elemento do formulário de texto para abrir o painel Propriedades.
  2. 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.
  3. 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.

  4. 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.

  5. 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.

  6. Marque a caixa de seleção ao lado de Exigido para definir que os editores devem inserir um valor no campo.

    Consulte Definir os elementos conforme necessário para obter mais informações.

  7. Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque a caixa de seleção Editável.

    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 e hora

Siga estas etapas para formatar os elementos que fazem referência aos campos de data e hora:

  1. Selecione um elemento do formulário de data e hora para abrir seu painel Propriedades.
  2. Se o campo for do tipo data, 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.
  3. 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.

  4. Para elementos somente de hora ou deslocamento do carimbo de data/hora, escolha a precisão de hora que o formulário permitirá que os editores insiram.
    • hh—Permite que os editores insiram horas.
    • hh:mm—Permite que os editores insiram horas e minutos.
    • hh:mm:ss—Permite que os editores insiram horas, minutos e segundos.
      Anotação:

      Os segundos podem ser armazenados no campo, embora não sejam exibidos no ArcGIS Online.

  5. 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.

  6. 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.

  7. Para permitir que os editores especifiquem um fuso horário ao editar elementos de deslocamento do carimbo de data/hora, marque a caixa de seleção Permitir que os usuários definam o fuso horário.
  8. Marque a caixa de seleção ao lado de Exigido para definir que os editores devem inserir um valor no campo.

    Consulte Definir os elementos conforme necessário para obter mais informações.

  9. Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque a caixa de seleção Editável.

    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, inteiro ou inteiro grande, siga estas etapas para formatar o elemento do formulário:

  1. Selecione um elemento do formulário de texto para abrir o painel Propriedades.
  2. 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 deverão inserir números decimais, escolha Número - Duplo.
    • Número - Inteiro—Se o campo na camada for definido como um número inteiro, um número inteiro grande ou um 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 poderão inserir números decimais, escolha Número - Inteiro.
  3. 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.

  4. 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.

  5. Marque a caixa de seleção ao lado de Exigido para definir que os editores devem inserir um valor no campo.

    Consulte Definir os elementos conforme necessário para obter mais informações.

  6. Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque a caixa de seleção Editável.

    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 opção.

  1. Selecione um elemento de formulário que faz referência a um campo com uma lista de valores definida para abrir seu painel Propriedades.
  2. 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 apropriado.

    Se a lista tiver muitos valores (por exemplo, sete ou mais valores), uma caixa de combinação economizará espaço no formulário.

  3. 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.

  4. Marque a caixa de seleção ao lado de Exigido para definir que os editores devem inserir um valor no campo.

    Consulte Definir os elementos conforme necessário para obter mais informações.

  5. Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque a caixa de seleção Editável.

    Se o elemento do formulário não for editável, a configuração do botão ou da opção de 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, 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.

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 no formulário.

  1. 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.
  2. 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 duas aparecem no formulário com botões ao lado delas. Os usuários do formulário clicam no botã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.

  3. 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.

  4. Marque a caixa de seleção ao lado de Exigido para definir que os editores devem inserir um valor no campo.

    Consulte Definir os elementos conforme necessário para obter mais informações.

  5. Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque a caixa de seleção Editável.

    Se o elemento do formulário não for editável, o botã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. Para trocar os elementos, a configuração padrão é exibida no formulário.

Formatar elementos de registro relacionados

Você pode personalizar como os elementos de registro relacionados aparecem no formulário formatando sua descrição, ordem de classificação e o número que pode ser visualizado. Siga estas etapas para formatar elementos de registro relacionados:

  1. Escolha um elemento de registro relacionado para abrir o painel Propriedades.
  2. 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.

  3. Clique no menu suspenso Classificar por e escolha o campo usado para classificar os registros relacionados.
  4. Clique no menu suspenso Ordem de classificação e escolha como os registros relacionados devem ser classificados.

    Se você classificar por um campo de string, duplo ou inteiro, poderá classificar por valor crescente ou decrescente. Se você classificar por um campo de data, poderá classificar pelo valor mais recente ou menos recente.

  5. Clique no menu suspenso Contagem de visualização e escolha o número de registros relacionados que podem ser visualizados no formulário.

    Escolher um valor maior que três pode exigir rolagem adicional no formulário e não é recomendado.

Anotação:

Você pode criar um formulário separado para a tabela relacionada e escolher quais campos da tabela relacionada exibir e como formatá-los.

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.

  1. Clique em um elemento do formulário de campo para abrir o painel Propriedades.
  2. Na seção Lógica, marque a caixa de seleção Exigido.

    Um chip * Exigido aparece no elemento do formulário, indicando que os editores devem fornecer um valor para este campo.

Adicionar lógica para tornar o formulário condicionalmente dinâmico

Você pode tornar o formulário dinâmico com base nas seguintes condições lógicas que você define usando as expressões ArcGIS Arcade :

Após definido, você pode reutilizar expressões para outros elementos do formulário.

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:

  1. Clique em um elemento do formulário de campo para abrir o painel Propriedades.
  2. Na seção Lógica, clique no botão Expressões Expressões ao lado da caixa de seleção Visível.

    O pop-up Expressões aparece, exibindo as expressões criadas anteriormente para o formulário.

  3. Clique em Nova expressão.

    A janela Construtor de expressões aparece. O construtor permite escrever e visualizar sua expressão no Arcade antes de salvá-la no elemento do formulário selecionado.

  4. Na caixa de texto Título, adicione um título para sua expressão.
  5. Defina uma expressão.

    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 Formulário 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.

  6. Clique em Concluir para fechar o construtor de expressão.

    Um chip </> Visibilidade aparece no elemento do formulário, indicando que a expressão de visibilidade condicional foi aplicada ao grupo ou campo.

Agora que você criou a expressão, você pode aplicá-la a qualquer elemento do formulário. Você pode visualizar quais elementos estão usando a expressão clicando no número ao lado da expressão no pop-up Expressões. Consulte Reutilizar expressões para saber mais.

Anotação:

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 Arcade neste menu.

Configurar elementos obrigatórios condicionalmente

Você pode exigir elementos do formulário condicionalmente com base em valores anteriores inseridos no formulário. Por exemplo, um campo de descrição de detritos deve ser necessário somente se o comprimento dos detritos da tempestade for superior a 3 metros.

  1. Clique em um elemento do formulário de campo para abrir o painel Propriedades.
  2. Na seção Lógica, clique no botão Expressões Expressões ao lado da caixa de seleção Exigido.

    O pop-up Expressões aparece, exibindo as expressões criadas anteriormente para o formulário.

  3. Clique em Nova expressão.

    A janela Construtor de expressões aparece. O construtor permite escrever uma expressão e visualizá-la no Arcade antes de salvá-la no campo ou grupo selecionado.

  4. Na caixa de texto Título, adicione um título para sua expressão.
  5. Defina uma expressão.

    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 campo de descrição de detritos precisar ser solicitado somente se os detritos forem maiores que 3 metros, a seguinte condição poderá ser usada para construir a expressão:

    • Nome do campo—debris_length
    • Operador—é maior que
    • Valor—3

    A seguir está a mesma expressão na sintaxe Arcade:

    ($feature, "debris_length") > 3

    Anotação:

    Para criar expressões mais complexas, clique em Iniciar editor do Arcade.

    Ao aplicar várias condições ao mesmo elemento, você pode escolher se todas as condições devem ser verdadeiras ou apenas uma condição deve ser verdadeira para que o elemento do formulário seja obrigatório.

    O ArcGIS Online aplica o perfil Restrição do Formulário do Arcade para avaliar se uma feição atende os critérios definidos na expressão. Se um valor menor que 3 for inserido no campo de comprimento de detritos, o campo de descrição de detritos não será necessário no formulário.

  6. Clique em Concluir para fechar o construtor de expressão.

    Um chip </> Exigido aparece no elemento do formulário, indicando que a expressão necessária foi aplicada.

Agora que você criou a expressão, você pode aplicá-la a qualquer elemento do formulário. Você pode visualizar quais elementos estão usando a expressão clicando no número ao lado da expressão no pop-up Expressões. Consulte Reutilizar expressões para saber mais.

Anotação:

Você pode duplicar, editar ou excluir a expressão a qualquer momento usando o menu flutuante no pop-up Expressões. Para editar a expressão usando Arcade, clique em Editar Arcade neste menu.

Configurar edição condicional

Você pode habilitar condicionalmente a edição de elementos do formulário com base nos valores anteriores inseridos no formulário. Por exemplo, os editores devem editar somente valores em um campo date_pipe_replaced se o valor do campo pipe_replaced for definido como yes.

  1. Clique em um elemento do formulário de campo para abrir o painel Propriedades.
  2. Na seção Lógica, clique no botão Expressões Expressões ao lado da caixa de seleção Editável.

    O pop-up Expressões aparece, exibindo as expressões criadas anteriormente para o formulário.

  3. Clique em Nova expressão.

    A janela Construtor de expressões aparece. O construtor permite escrever uma expressão e visualizá-la no Arcade antes de salvá-la no campo ou grupo selecionado.

  4. Na caixa de texto Título, adicione um título para sua expressão.
  5. Defina uma expressão.

    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 a data para a substituição de um tubo puder ser editada somente se o valor do campo pipe_replaced for yes, a seguinte condição poderá ser usada para criar a expressão:

    • Nome do campo—pipe_replaced
    • Operador—is
    • Valor—yes

    Aqui está a aparência da mesma expressão n sintaxeArcade :

    ($feature, "pipe_replaced") == "yes"
    Anotação:

    Para criar expressões mais complexas, clique em Iniciar editor do Arcade.

    Se você usar várias condições, poderá escolher se todas as condições devem ser verdadeiras ou apenas uma condição deve ser verdadeira para que o elemento do formulário seja editável.

    O ArcGIS Online aplica o perfil Restrição do Formulário do Arcade para avaliar se uma feição atende os critérios definidos na expressão. O Se um valor diferente de 4367 for inserido no campo ID do inspetor, o campo ID do tubo não será editável no formulário.

  6. Clique em Concluir.

    Um chip </> Editável aparece no elemento do formulário, indicando que a expressão necessária foi aplicada.

Agora que você criou a expressão, você pode aplicá-la a qualquer elemento do formulário. Você pode visualizar quais elementos estão usando a expressão clicando no número ao lado da expressão no pop-up Expressões. Consulte Reutilizar expressões para saber mais.

Anotação:

Você pode duplicar, editar ou excluir a expressão a qualquer momento usando o menu flutuante no pop-up Expressões. Para editar a expressão usando Arcade, clique em Editar Arcade neste menu.

Adicionar expressões para calcular valores de campo

Você pode adicionar uma expressão calculada ao formulário para calcular e preencher dados automaticamente. Isso economiza tempo para os editores e reforça a integridade dos dados automatizando o cálculo do valor do campo.

Use o Arcade para construir expressões calculadas com base em atributos de feição e geometria. Por exemplo, você pode adicionar uma expressão calculada a um campo que armazena datas para uma programação de inspeção de ponte. Quando o editor define o valor do campo de condição da ponte como damaged, por exemplo, a expressão definida no campo de data da inspeção pode agendar automaticamente a próxima inspeção para ocorrer em uma semana, preenchendo o campo de inspeção da ponte com essa data.

As expressões calculadas são dinâmicas, o que significa que atualizam automaticamente o formulário à medida que as informações mudam. Como resultado, os editores podem visualizar o cálculo atualizado antes de enviar o formulário. Como o valor no campo de expressão calculado é preenchido pela expressão, os editores não podem digitar um valor para esse campo no formulário.

Para criar uma expressão calculada, conclua as seguintes etapas:

  1. Clique em um elemento do formulário de campo para abrir o painel Propriedades.
    Aviso:

    Se a edição estiver habilitada para o elemento do formulário, a expressão não será executada.

  2. Na seção Lógica, clique no botão Expressões Expressões na seção Valor calculado.
  3. Clique em Nova expressão.

    A janela Editor do Arcade aparece. O editor permite escrever e testar sua expressão antes de salvá-la no elemento do formulário selecionado.

  4. Na caixa de texto Título, adicione um título para sua expressão.
  5. Escreva a expressão calculada.

    Por exemplo, a expressão a seguir verifica se a geometria da feição de polígono é nula antes de calcular a área em metros quadrados. Exemplos adicionais são fornecidos na próxima seção.

    if (IsEmpty(Geometry($feature))){
        return;
    }
    else{
        Area($feature, 'square-meters')
    }
    Para saber mais sobre cálculo de área com Arcade, consulte Área (Funções de Geometria).

    Para obter uma lista de todas as funções oferecidas no Arcade, consulte o Índice de Função do Arcade .

  6. Clique em Executar para testar a expressão e garantir que não resulte em erro.
  7. Clique em Concluir para fechar o editor Arcade.

    Um chip </> Calculado aparece no elemento do formulário, indicando que a expressão calculada foi aplicada.

Agora que você criou a expressão, pode aplicá-la a qualquer elemento do formulário selecionando o elemento do formulário e clicando na expressão criada. Você pode ver quais elementos estão usando a expressão do Arcade clicando no número ao lado da expressão no painel Propriedades em Expressões calculadas.

Anotação:

Você pode duplicar, editar ou excluir a expressão a qualquer momento no menu Expressões calculadas.

Exemplos de expressão calculada

Veja a seguir exemplos de expressões calculadas:

  • Fornecer informações de data—A expressão a seguir fornece a data atual para um campo de data:
    return Today();
    Para saber mais sobre as informações de data que você pode acessar com Arcade, consulte Funções de Data.
  • Extrair informações de camadas de intersecção—A seguinte expressão é aplicada a um campo de CEP no formulário e extrai um valor de CEP de uma camada de lote de intersecção:
    if (IsEmpty(Geometry($feature))){
        return;
    }
    else{
        var parcels_FS = Intersects($feature, FeatureSetByName($map,"Redlands parcels")); 
         if (Count(parcels_FS) == 1){ 
           return Text(First(parcels_FS).ZIP_CODE);
         }
    }
    Para saber mais sobre como extrair informações de camadas de interseção com Arcade, consulte Intersecções (Funções de Geometria).

Para obter uma lista de todas as funções oferecidas no Arcade, consulte o Índice de Função do Arcade .

Reutilizar expressões

Após criar uma expressão, você poderá reutilizá-la em elementos do formulário. Por exemplo, você pode exibir condicionalmente um elemento do formulário com base na mesma expressão usada para exigir outro e pode usar o mesmo cálculo para preencher vários campos.

Siga estas etapas para usar expressões existentes para elementos do formulário:

  1. Ao configurar o formulário, clique em um elemento de formulário para abrir o painel Propriedades.
  2. Na seção Lógica, clique no botão Expressões Expressões ao lado do tipo de expressão que deseja adicionar.

    O pop-up Expressões ou Calcular expressões aparece, exibindo as expressões criadas anteriormente para o formulário.

    Dica:

    O número ao lado da expressão indica o número de elementos do formulário aos quais a expressão está aplicada no momento. Clicar nesse número abre outro pop-up que exibe os elementos do formulário e suas propriedades que estão usando a expressão no momento.

    Você pode remover a expressão de qualquer propriedade de elemento do formulário clicando no X no chip que exibe o tipo de expressão.

  3. Selecione a expressão que deseja aplicar.

    Um chip aparece no elemento do formulário, indicando que a expressão foi aplicada.

Salvar o formulário

Quando terminar de editar, salve o formulário. Clique em OK para fechar a janela Configurar formulário e salve o formulário no mapa ou na camada:

  • Salvar no mapa—Se o formulário for exclusivo de um mapa específico e você não quiser reutilizá-lo em outros mapas, salve as alterações no mapa. O formulário é salvo no mapa e não aparecerá em outros mapas que contenham a camada.
  • Salvar na camada—Para reutilizar o formulário em mapas que contêm a camada, salve as alterações na camada. O formulário é salvo na camada e pode ser reutilizado em outros mapas.
Anotação:

As alterações de formulário salvas no mapa substituem as alterações de formulário salvas na camada.

Para salvar alterações na camada, você deve ser o proprietário dela, ser um administrador padrão da sua organização ou ter os seguintes privilégios:

  • Privilégios administrativos: Membros: Visualizar todos
  • Privilégios administrativos: Conteúdo: Visualizar todos
  • Privilégios administrativos: Conteúdo: Atualizar