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 conseguirão usar ao atualizar os 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 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 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.
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 emFormulários
na barra de ferramentas Configurações (clara).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.
- 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.
- Após adicionar campos e grupos como elementos à tela do formulário, formate cada elemento.
- Opcionalmente, defina expressões Arcade que determinam 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.
- Opcionalmente, após adicionar campos como elementos ao formulário, crie grupos (conforme descrito na próxima seção) ou prossiga 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 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:
- 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.
- 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:
- 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.
- 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.
- 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.
- 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.
- 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 deverã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.
- 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.
- 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 opção.
- 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 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.
- 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.
- Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque Permitir edição.
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.
- 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 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.
- 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.
- 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.
- Para evitar que os editores usem o formulário para atualizar valores neste campo, desmarque Permitir edição.
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.
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.
- Marque a caixa ao lado de Exigido e defina se a camada de feição permite valores nulos:
- Sim—Selecione esta opção se o campo na camada de feição permitir valores nulos, mas, ao editar através do formulário, os editores são obrigados a fornecer uma entrada para o elemento do campo.
- Não—Selecione esta opção quando o campo na camada de feição estiver configurado como um campo não anulável.
Definir expressões
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 :
- Visível condicionalmente—Mostra ou oculta elementos de formulário condicionalmente.
- Valores calculados—Calcula dados automaticamente com base em atributos, geometria e informações da conta.
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.
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:
- 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.
- Na seção Expressões calculadas, clique em + Adicionar expressão.
O editor do Arcade aparece. O editor do Arcade permite que você escreva e teste sua expressão antes de salvá-la no elemento de formulário selecionado.
- Clique em Editar ao lado do título e forneça um título para a expressão.
- 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 obter uma lista de todas as funções oferecidas no Arcade, consulte o Índice de Função do Arcade .
- Clique em Testar para garantir que a expressão não resulte em erro.
- Clique em OK para fechar o editor Arcade.
A expressão calculada é aplicada ao elemento de formulário.
- Clique em Salvar para salvar a expressão e o formulário.
Agora que você salvou a expressão, você pode aplicá-la a qualquer elemento de formulário selecionando o elemento de 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(); - 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 obter uma lista de todas as funções oferecidas no Arcade, consulte o Índice de Função do Arcade .