Una pregunta de imagen con la apariencia draw o annotate permite a los usuarios dibujar un boceto en un lienzo en blanco o anotar una imagen o captura de un mapa. La aplicación de campo ArcGIS Survey123 incluye una paleta de herramientas de dibujo predeterminada con ocho herramientas, incluidas flechas, símbolos de marcador genéricos y etiquetas de texto. Para obtener más información sobre la paleta predeterminada, consulte Modo de dibujo.
Además de las herramientas de dibujo predeterminadas, puede crear paletas personalizadas para configurar herramientas de dibujo y anotación. Por ejemplo, una organización de servicios públicos podría tener símbolos y estilos de línea específicos relacionados con redes de electricidad o gas.
Nota:
No se admiten paletas personalizadas en la aplicación web ArcGIS Survey123.
Para crear una paleta personalizada, complete lo siguiente:
- Configure el entorno de Python en ArcGIS Survey123 Connect para que pueda ejecutar las herramientas Nueva plantilla XLSPalette y Convertir XLSPalette.
- Prepare una paleta personalizada utilizando la especificación XLSPalette.
- Asegúrese de que la plantilla XLSPalette y cualquier archivo asociado estén en carpeta de contenido multimedia de la encuesta.
- Convierta la plantilla XLSPalette en un archivo .palette ejecutando la herramienta Convertir XLSPalette en la pestaña Multimedia de Survey123 Connect.
- En el XLSForm de la encuesta, defina la columna body::esri:style para una pregunta de imagen con apariencia draw o annotate de modo que use una paleta personalizada en lugar de la paleta predeterminada especificando palette=<palette_name>.
Primero se configura una paleta personalizada en una plantilla XLSPalette. A continuación, la plantilla XLSPalette se debe convertir a un archivo .palette para que se pueda agregar a la encuesta. Las plantillas XLSPalette se convierten con una herramienta en la pestaña Multimedia de Survey123 Connect.
Preparar una paleta personalizada
Una paleta personalizada se configura en XLSPalette, un archivo .xlsx que contiene las hojas de cálculo que se convertirán en un archivo .palette que se pueda utilizar en la encuesta.
Para empezar con el diseño de la paleta personalizada, necesita una plantilla XLSPalette. Survey123 Connect incluye la herramienta Nueva plantilla XLSPalette para crear una plantilla en blanco. Para ejecutar la herramienta, debe configurar un entorno de Python en Survey123 Connect. Para obtener más información, consulte Configurar Python.
Abra la encuesta en Survey123 Connect. Para crear una plantilla XLSPalette, haga clic en Herramientas y, a continuación, haga clic en Nueva plantilla XLSPalette. Se crea un archivo de plantilla en la carpeta de contenido multimedia denominado myXLSPalette1.xlsx. Si lo prefiere, puede descargar una copia de la plantilla XLSPalette de Survey123 desde ArcGIS Online.
Cada hoja de cálculo de la plantilla XLSPalette es un conjunto de herramientas: un grupo de herramientas de la paleta personalizada. Las filas de cada hoja de cálculo de conjuntos de herramientas definen las herramientas de anotación del conjunto de herramientas. El siguiente ejemplo muestra una configuración de XLSPalette para tres herramientas de anotación de una inspección de tuberías de gas, que contiene dos herramientas de línea y una herramienta de marcador:
| tipo | etiqueta | herramienta | símbolo | textSymbol |
|---|---|---|---|---|
línea | Línea de gas (nueva) | línea | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
línea | Línea de gas (existente) | línea | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
marcador | Metro (nuevo) | meter.svg |
Para obtener más información sobre la sintaxis y los parámetros que puede utilizar para diseñar una paleta personalizada, consulte Especificación XLSPalette. La sintaxis completa también se describe en la hoja de cálculo Referencia de la plantilla XLSPalette.
Asegúrese de que la plantilla XLSPalette y cualquier archivo de imágenes que utilice la paleta, como los símbolos de marcador SVG o los iconos de conjunto de herramientas, estén en la carpeta de contenido multimedia de la encuesta. Ahora, la plantilla XLSPalette se debe convertir a un archivo .palette para que se pueda agregar a la encuesta.
Convertir paleta
Para ejecutar la herramienta Convertir XLSPalette, debe configurar un entorno de Python en Survey123 Connect. Para obtener más información, consulte Configurar Python.
Abra la encuesta en Survey123 Connect y vaya a la pestaña Multimedia. La pestaña Multimedia muestra el contenido de la carpeta media de la encuesta. Hay un botón de conversión junto a los archivos .xlsx. Haga clic en el botón de conversión para ejecutar la herramienta Convertir XLSPalette y convertir la plantilla XLSPalette en un archivo .palette que se pueda usar en la encuesta.
Cuando se completa la conversión, el archivo .palette se guarda en la carpeta media y aparece en la pestaña Multimedia.
Sugerencia:
El nombre del archivo .palette es el mismo que el del archivo .xlsx de origen. Dado que este nombre se usará como parámetro XLSForm, asegúrese de que no haya espacios en el nombre de archivo.
Agregar una paleta a la encuesta
Después de crear y convertir una paleta personalizada, puede agregarla al XLSForm. Puede agregar a la encuesta tantas paletas personalizadas como desee; sin embargo, solo puede utilizar una paleta en cada pregunta draw o annotate.
Para una pregunta de imagen con la apariencia draw o annotate, escriba palette=<palette_name> en la columna body::esri:style, donde <palette_name> es el nombre del archivo de la paleta sin la extensión .palette, por ejemplo: palette=Electrical.
La paleta personalizada se usará ahora para la pregunta de imagen, en lugar de la paleta predeterminada.
Para actualizar una paleta personalizada, realice los cambios necesarios en el archivo .xlsx y ejecute de nuevo la herramienta Convertir XLSPalette desde la pestaña Multimedia. Esto sustituye al archivo .palette de la carpeta media y los cambios están visibles en Survey123 Connect una vez que se actualiza la vista previa del formulario. Vuelva a publicar la encuesta para ver los cambios en la aplicación de campo Survey123.
Especificación XLSPalette
La especificación XLSPalette está diseñada específicamente para crear herramientas de dibujo y anotación en Survey123. Las paletas personalizadas se configuran en un archivo .xlsx con la sintaxis XLSPalette. La plantilla XLSPalette consta de lo siguiente:
- Una o varias hojas de cálculo de conjuntos de herramientas, que contienen las columnas type, tool, symbol y textSymbol. Un conjunto de herramientas es un grupo de herramientas de una paleta. Una paleta puede contener tantos conjuntos de herramientas como sea necesario. El nombre de cada hoja de cálculo de conjuntos de herramientas estará visible en la aplicación de campo Survey123 como el nombre de cada pestaña de conjunto de herramientas en una paleta personalizada.
- Una hoja de cálculo Reference que proporciona una guía sobre la sintaxis y los parámetros que se pueden usar para diseñar una paleta.
- Una hoja de cálculo Version que proporciona información sobre cuándo se actualizó por última vez la plantilla XLSPalette.
- Una hoja de cálculo Lists que contiene tablas de búsqueda para la validación de datos de las hojas de cálculo de conjuntos de herramientas. No modifique el contenido de esta hoja de cálculo.
Puede agregar o quitar hojas de cálculo de conjuntos de herramientas según sea necesario. Para agregar una nueva hoja de cálculo de un conjunto de herramientas, haga una copia de la hoja de cálculo de un conjunto de herramientas existente para garantizar que se conserve el formato y la validación de datos. Las hojas de cálculo de conjuntos de herramientas que no contienen ninguna fila que no sea la fila de encabezado se ignoran cuando XLSPalette se convierte en un archivo .palette.
Antes de trabajar con propiedades de herramientas, considere lo siguiente:
- La mayoría de las propiedades de símbolos se especifican como pares de name=value y se separan con un símbolo et.
- Los colores se pueden especificar mediante nombres de color HTML estándar o códigos de color hexadecimales. Puede usar códigos de color hexadecimales de ocho caracteres para establecer la opacidad.
- Las unidades de ancho y tamaño están en píxeles.
- Los símbolos de línea admiten patrones de guiones personalizados.
- Si el tipo de herramienta es de texto, se requiere una entrada en la columna textSymbol. Para todos los demás tipos, un valor de textSymbol es opcional.
Tipos y herramientas
Una paleta puede contener cualquier combinación de tipos de herramientas. Los tipos admitidos son línea, área, marcador y texto, y se deben proporcionar en la columna type de cada hoja de cálculo de conjuntos de herramientas.
Los tipos de línea, área y texto admiten varias herramientas que determinan el estilo de dibujo para ese tipo. Puede especificar la herramienta en la columna tool en cada hoja de cálculo de conjuntos de herramientas. No es necesario especificar una herramienta para los tipos de marcador y texto.
Para obtener una lista completa de las herramientas admitidas, consulte la hoja de cálculo Reference de la plantilla XLSPalette.
Simbología
Cada herramienta admite varias propiedades de símbolo que se pueden especificar en la columna symbol de la hoja de cálculo de cada conjunto de herramientas.
Para las líneas, puede especificar un patrón de guiones personalizado utilizando uno o varios pares de espacios sólidos con el formato [n,n...], donde n es la longitud relativa del segmento, por ejemplo, [4,3,2,3].
Para los símbolos de marcador, el primer valor puede ser el nombre de un símbolo de marcador simple de Esri o un nombre de archivo de imagen con una extensión de archivo. Los formatos de imagen admitidos son SVG, PNG y JPG. Los símbolos de marcador simples son: círculo, cruce, rombo, cuadrado, triángulo y x.
Para obtener una lista completa de los símbolos y propiedades admitidos, consulte la hoja de cálculo Reference de la plantilla XLSPalette.
Texto
Cada herramienta puede tener adjunta una etiqueta de texto. También puede especificar una etiqueta por separado utilizando el tipo de texto. El formato para el texto se especifica en la columna textSymbol de la hoja de cálculo de cada conjunto de herramientas.
Para la propiedad alignment, puede especificar varios valores de alineación separados por una coma, por ejemplo, alignment=left,middle.
La propiedad anchor se aplica únicamente a los tipos de línea, área y marcador, y especifica dónde se colocará la etiqueta de texto en relación con el elemento gráfico.
Para obtener una lista completa de los estilos y propiedades admitidos, consulte la hoja de cálculo Reference de la plantilla XLSPalette.
Icono de conjunto de herramientas
Los iconos de conjunto de herramientas se muestran con los nombres de los conjuntos de herramientas de la paleta. De forma predeterminada, si todas las herramientas de un conjunto de herramientas utilizan la misma herramienta, el icono se establece automáticamente para que coincida con esa herramienta. Para especificar un icono para un conjunto de herramientas, incorpore &icon= al nombre de la hoja de cálculo, seguido del nombre de un icono de la biblioteca de iconos de Esri Calcite UI o de un archivo de imagen guardado en la carpeta de contenido multimedia. Los formatos de imagen admitidos son SVG, PNG y JPG.
Sugerencia:
Para obtener los mejores resultados, utilice un único color en un fondo transparente para los iconos de conjunto de herramientas. Los iconos de conjunto de herramientas se representan en escala de grises en la paleta.
Los nombres de las hojas de cálculo están limitados a 31 caracteres y pueden incluir espacios, por ejemplo, New Works&icon=electric.svg.