Uma pergunta de imagem com a aparência de desenho ou anotação permite que os usuários desenhem um esboço em uma tela em branco ou anote uma imagem ou captura instantânea de um mapa. O ArcGIS Survey123 field app inclui uma paleta de ferramentas de desenho padrão de oito ferramentas, incluindo setas, símbolos de marcadores genéricos e rótulos de texto. Para mais informações sobre a paleta padrão, consulteModo de desenho.
Além das ferramentas de desenho padrão, você pode criar paletas personalizadas para configurar ferramentas de desenho e anotação. Por exemplo, uma organização de serviços públicos pode ter símbolos específicos e estilos de linha relacionados a trabalhos elétricos ou de gás.
Anotação:
As paletas personalizadas não são suportadas noArcGIS Survey123 web app.
Para criar uma paleta personalizada, faça o seguinte:
- Configure o ambiente Python no ArcGIS Survey123 Connect para que você possa executar as ferramentas Novo modelo XLSPalette e Converter XLSPalette.
- Prepare uma paleta personalizada usando a especificação do XLSPalette.
- Certifique-se que o modelo XLSPalette e todos os arquivos associados estejam na pasta de mídia da pesquisa.
- Converta o modelo XLSPalette em um arquivo .palette executando a ferramenta Converter XLSPalette na guia Mídia no Survey123 Connect.
- No XLSForm da pesquisa, defina a coluna body::esri:style para uma pergunta de imagem com aparência de desenho ou anotação para usar uma paleta personalizada em vez da paleta padrão, especificando palette=<palette_name>.
Uma paleta personalizada é configurada primeiro em um modelo XLSPalette. O modelo XLSPalette deve então ser convertido em um arquivo .palette para que possa ser adicionado à pesquisa. Os modelos XLSPalette são convertidos com uma ferramente na guia Mídia no Survey123 Connect.
Preparar uma paleta personalizada
Uma paleta personalizada é configurada no XLSPalette, um arquivo .xlsx que contém as planilhas que serão convertidas em um arquivo .palette que pode ser usado na pesquisa.
Para começar com o design de paleta personalizado, você precisa de um modelo XLSPalette. O Survey123 Connect inclui uma nova ferramenta Novo modelo XLSPalette para criar um modelo em branco. Para executar a ferramenta, você deve configurar um ambiente Python no Survey123 Connect. Para mais informações, consulte Configurar o Python.
Abra a pesquisa no Survey123 Connect. Para criar um modelo XLSPalette, clique em Ferramentas e, em seguida, clique em Novo modelo XLSPalette. Um arquivo de modelo é criado na pasta de mídia denominadomyXLSPalette1.xlsx. Alternativamente, você pode baixar uma cópia do modelo XLSPalette doSurvey123 do ArcGIS Online.
Cada planilha no modelo XLSPalette é um conjunto de ferramentas: um grupo de ferramentas na paleta personalizada. As linhas em cada planilha do conjunto de ferramentas definem as ferramentas de anotação no conjunto de ferramentas. O seguinte exemplo mostra uma configuração XLSPalette para três ferramentas de anotação para uma inspeção de gasoduto, contendo duas ferramentas de linha e uma ferramenta de marcador:
| tipo | rótulo | ferramenta | símbolo | textSymbol |
|---|---|---|---|---|
linha | Linha de Gás (Novo) | linha | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
linha | Linha de Gás (Existente) | linha | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
marcador | Metro (Novo) | meter.svg |
Para mais informações sobre a sintaxe e os parâmetros que você pode usar para criar uma paleta personalizada, consulte a especificação do XLSPalette. A sintaxe completa também é descrita na planilha Referência no modelo XLSPalette.
Certifique-se que o modelo XLSPalette e todos os arquivos de imagem usados pela paleta, como símbolos de marcador SVG ou ícones do conjunto de ferramentas, estejam na pasta de mídia da pesquisa. O modelo XLSPalette agora deve ser convertido em um arquivo .palette para que possa ser adicionado à pesquisa.
Converter paleta
Para executar a ferramenta Converter XLSPalette, você deve configurar um ambiente Python no Survey123 Connect. Para mais informações, consulte Configurar o Python.
Abra a pesquisa no Survey123 Connect e navegue até a guia Mídia. A guia Mídia lista o conteúdo da pasta de mídia da pesquisa. Um botão de conversão está ao lado dos arquivos .xlsx. Clique no botão de conversão para executar a ferramenta Converter XLSPalette para converter o modelo XLSPalette em um arquivo .palette que pode ser usado na pesquisa.
Quando a conversão for concluída, o arquivo .palette será salvo na pasta de mídia e aparecerá na guia Mídia.
Dica:
O nome do arquivo .palette é o mesmo do arquivo de origem .xlsx. Como esse nome será usado como um parâmetro XLSForm, certifique-se que não haja espaços no nome do arquivo.
Adicionar uma paleta na pesquisa
Após criar e converter uma paleta personalizada, você poderá adicioná-la ao XLSForm. Você pode adicionar quantas paletas personalizadas à pesquisa desejar; no entanto, apenas uma paleta pode ser usada em cada pergunta de desenho ou anotação.
Para uma pergunta de imagem com a aparência de desenho ou anotação, digite palette=<palette_name> na coluna body::esri:style, onde <palette_name> é o nome do arquivo de paleta sem a extensão .palette, por exemplo: palette=Electrical.
A paleta personalizada agora será usada para a pergunta de imagem, em vez da paleta padrão.
Para atualizar uma paleta personalizada, faça as alterações necessárias no arquivo .xlsx e execute a ferramenta Converter XLSPalette novamente na guia Mídia. Isso substitui o arquivo .palette na pasta de mídia e as alterações ficam visíveis no Survey123 Connect quando a visualização do formulário é atualizada. Republique a pesquisa para visualizar as alterações noSurvey123 field app.
Especificação do XLSPalette
A especificação do XLSPalette é projetada especificamente para criar ferramentas de desenho e anotação noSurvey123. As paletas personalizadas são configuradas em um arquivo .xlsx usando a sintaxe XLSPalette. O modelo XLSPalette consiste do seguinte:
- Uma ou mais planilhas do conjunto de ferramentas, contendo as colunas tipo, ferramenta, símbolo e textSymbol. Um conjunto de ferramentas é um grupo de ferramentas em uma paleta. Uma paleta pode conter quantos conjuntos de ferramentas forem necessários. O nome de cada planilha do conjunto de ferramentas ficará visível no Survey123 field app como o nome de cada guia do conjunto de ferramentas em uma paleta personalizada.
- Uma planilha de Referência que fornece um guia para a sintaxe e os parâmetros que você pode usar para criar uma paleta.
- Uma planilha de Versão que fornece informações sobre quando o modelo XLSPalette foi atualizado pela última vez.
- Uma planilha de Listas que contém tabelas de pesquisa para a validação de dados nas planilhas de conjuntos de ferramentas. Não modifique o conteúdo desta planilha.
Você pode adicionar ou remover planilhas do conjunto de ferramentas conforme necessário. Para adicionar uma nova planilha do conjunto de ferramentas, faça uma cópia de uma planilha do conjunto de ferramentas existente para garantir que a formatação e a validação de dados sejam preservadas. As planilhas do conjunto de ferramentas que não contêm nenhuma linha além da linha de cabeçalho são ignoradas quando o XLSPalette é convertido em um arquivo .palette.
Ao trabalhar com propriedades da ferramenta, considere o seguinte:
- A maioria das propriedades dos símbolos são especificadas como pares name=value e separadas por um e comercial.
- As cores podem ser especificadas por nomes de cores HTML padrão ou códigos de cores hexadecimais. Você pode usar códigos de cores hexadecimais de oito caracteres para definir a opacidade.
- As unidades de largura e tamanho estão em pixels.
- Os símbolos de linha suportam padrões de traço personalizados.
- Se o tipo de ferramenta for texto, uma entrada na coluna textSymbol será necessária. Para todos os outros tipos, um valor textSymbol é opcional.
Tipos e ferramentas
Uma paleta pode conter qualquer combinação de tipos de ferramentas. Os tipos suportados são linha, área, marcador e texto, e devem ser fornecidos na coluna tipo em cada planilha do conjunto de ferramentas.
Os tipos de linha, área e texto suportam várias ferramentas que determinam o estilo de desenho para esse tipo. Você pode especificar a ferramenta na coluna ferramentas em cada planilha do conjunto de ferramentas. Você não precisa especificar uma ferramenta para o marcador e os tipos de texto.
Para obter uma lista completa de ferramentas suportadas, consulte a planilha de Referência no modelo XLSPalette.
Simbologia
Cada ferramenta suporta várias propriedades de símbolo que podem ser especificadas na coluna símbolo em cada planilha do conjunto de ferramentas.
Para linhas, você pode especificar um padrão de traço personalizado usando um ou mais pares de espaço sólido no formato [n,n...], onde n é o comprimento relativo do segmento, por exemplo, [4,3,2,3]
Para símbolos de marcador, o primeiro valor pode ser o nome de um símbolo de marcador simples da Esri ou um nome do arquivo de imagem com uma extensão de arquivo. Os formatos de imagem suportados são SVG, PNG e JPG. Os símbolos de marcador simples são círculo, cruz, diamante, quadrado, triângulo e x.
Para uma lista completa de símbolos e propriedades suportadas, consulte a planilha Referência no modelo XLSPalette.
Texto
Cada ferramenta pode ter um rótulo de texto anexada a ele. Você também pode especificar um rótulo por conta própria usando o tipo de texto. A formatação do texto é especificada na coluna textSymbol em cada planilha do conjunto de ferramentas.
Para a propriedade alignment, você pode especificar vários valores de alinhamento separados por uma vírgula, por exemplo, alignment=left,middle.
A propriedade anchor se aplica apenas aos tipos de linha, área e marcador e especifica onde o rótulo de texto será posicionado em relação ao elemento gráfico..
Para uma lista completa de estilos e propriedades suportadas, consulte a planilha Referência no modelo XLSPalette.
Ícone do Conjunto de Ferramentas
Os ícones do conjunto de ferramentas são mostrados com os nomes do conjunto de ferramentas na paleta. Por padrão, se todas as ferramentas em um conjunto de ferramentas usarem a mesma ferramenta, o ícone será definido automaticamente para corresponder a essa ferramenta. Para especificar um ícone para um conjunto de ferramentas, anexe &icon= ao nome da planilha, seguido pelo nome de um ícone da biblioteca de ícones de UI Calcite da Esri ou um arquivo de imagem salvo na pasta de mídia. Os formatos de imagem suportados são SVG, PNG e JPG.
Dica:
Para melhores resultados, use uma única cor em um plano de fundo transparente para ícones do conjunto de ferramentas. Os ícones do conjunto de ferramentas são renderizados em escala de cinza na paleta.
Os nomes das planilhas são limitados a 31 caracteres e podem incluir espaços, por exemplo, New Works&icon=electric.svg.