使用绘制或注释外观的图像问题允许用户在空白画布上绘制草图或向图像或地图快照添加注记。 ArcGIS Survey123 外业应用程序提供含八个工具的默认绘制工具选项板，其中包括箭头、常规标记符号和文本标注。 有关默认选项板的详细信息，请参阅绘制模式。
除默认绘制工具外，您还可以创建用于配置绘制和注记工具的自定义选项板。 例如，公共设施组织可能具有与电气或天然气工程相关的特定符号和线样式。
注：
自定义选项板不适用于 ArcGIS Survey123 Web 应用程序。
要创建自定义选项板，请完成以下步骤：
- 在 ArcGIS Survey123 Connect 中配置 Python 环境，以运行新建 XLSPalette 模板和转换 XLSPalette 工具。
- 使用 XLSPalette 规范准备自定义选项板。
- 确保 XLSPalette 模板和所有关联文件均位于调查的媒体文件夹中。
- 要将 XLSPalette 模板转换为 .palette 文件，在 Survey123 Connect 的媒体选项卡中运行转换 XLSPalette 工具。
- 在调查的 XLSForm 中，对于使用绘制或注记外观的图像问题，将其 body::esri:style 列设置为使用自定义选项板而非默认选项板，方法是指定 palette=<palette_name>。
首先需在 XLSPalette 模板中配置自定义选项板。 然后，必须将 XLSPalette 模板转换为 .palette 文件，才能将其添加到调查。 XLSPalette 模板通过 Survey123 Connect 的媒体选项卡中的工具进行转换。
准备自定义选项板
自定义选项板在 XLSPalette 中配置，这一包含工作表的 .xlsx 文件将转换为 .palette 文件，以便在调查中使用。
要开始设计自定义选项板，需要使用 XLSPalette 模板。 Survey123 Connect 包含新建 XLSPalette 模板工具，用于创建空白模板。 要运行该工具，必须在 Survey123 Connect 中配置 Python 环境。 有关详细信息，请参阅配置 Python。
在 Survey123 Connect 中打开调查。 要创建 XLSPalette 模板，单击工具，然后单击新建 XLSPalette 模板。 随即在媒体文件夹中创建名为 myXLSPalette1.xlsx 的模板文件。 或者，可以从 ArcGIS Online 下载 Survey123 XLSPalette 模板副本。
XLSPalette模板中的每个工作表都是一个工具集：自定义选项板中的一组工具。 每个工具集工作表中的行可定义工具集中的注记工具。 以下示例显示了用于燃气管道检查的三个注记工具的 XLSPalette 配置，其中包含两个线工具和一个标记工具：
| 类型 | label | 工具 | 符号 | textSymbol |
|---|---|---|---|---|
线 | 天然气管线（新） | 线 | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
线 | 天然气管线（现有） | 线 | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
标记 | 仪表（新） | meter.svg |
有关用于设计自定义选项板的语法和参数的详细信息，请参阅 XLSPalette 规范。 在 XLSPalette 模板的 Reference 工作表中，也对完整语法进行了介绍。
确保选项板使用的 XLSPalette 模板和任何图像文件（例如 SVG 标记符号或工具集图标）均位于调查的媒体文件夹中。 现在，必须将 XLSPalette 模板转换为 .palette 文件，才能将其添加到调查。
转换选项板
要运行转换 XLSPalette 工具，必须在 Survey123 Connect 中配置 Python 环境。 有关详细信息，请参阅配置 Python。
在 Survey123 Connect 中打开调查，然后浏览至媒体选项卡。 媒体选项卡列出调查的媒体文件夹中的内容。 .xlsx 文件旁有一个转换按钮。 单击该转换按钮可运行转换 XLSPalette 工具，以将 XLSPalette 模板转换为可用于调查的 .palette 文件。
转换完成后，.palette 文件将保存到媒体文件夹，并显示在媒体选项卡上。
提示：
.palette 文件的名称与源 .xlsx 文件的名称相同。 由于此名称将用作 XLSForm 参数，请确保文件名中没有空格。
向调查添加选项板
创建并转换自定义选项板后，您可以将其添加到 XLSForm。 您可以在调查中添加任意数量的自定义选项板，但是，在每个绘制或注记问题中，仅可使用一个选项板。
对于使用绘制或注记外观的图像问题，在 body::esri:style 列中输入 palette=<palette_name>，其中 <palette_name> 是不带 .palette 扩展名的选项板文件名，例如：palette=Electrical。
现在，图像问题将使用自定义调色板，而不是默认调色板。
要更新自定义选项板，对 .xlsx 文件执行必要的更改，然后再次在媒体选项卡中运行转换 XLSPalette 工具。 此操作将替换媒体文件夹中的 .palette 文件，且在表单预览更新后，这些更改在 Survey123 Connect 中可见。 重新发布调查，以在 Survey123 外业应用程序中查看变化。
XLSPalette 规范
XLSPalette 规范专门为在 Survey123 中创建绘制和注记工具而设计。 可以使用 XLSPalette 语法在 .xlsx 文件中配置自定义选项板。 XLSPalette 模板由以下内容组成：
- 一个或多个工具集工作表，其中包含 type、tool、symbol 和 textSymbol 列。 工具集是选项板中的一组工具。 一个选项板可以包含您需要的任意数量的工具集。 每个工具集工作表的名称将在 Survey123 外业应用程序中可见，显示为自定义选项板中每个工具集选项卡的名称。
- 参考工作表，提供用于设计选项板的语法和参数指南。
- 版本工作表提供有关 XLSPalette 模板上次更新时间的信息。
- 列表工作表包含用于工具集工作表数据验证的查找表。 请勿修改此工作表中的内容。
您可以根据需要添加或移除工具集工作表。 要添加新的工具集工作表，可复制现有工具集工作表以确保保留格式和数据验证。 将 XLSPalette 转换为 .palette 文件时，除了标题行之外不包含任何其他行的工具集工具表将被忽略。
使用工具属性时，应考虑以下因素：
- 大多数符号属性都以 name=value 对的形式指定，并使用与号分隔。
- 可以通过标准 HTML 颜色名称或十六进制代码指定颜色。 您可以使用八个字符的十六进制代码设置不透明度。
- 宽度和大小以像素为单位。
- 线符号支持自定义虚线图案。
- 如果工具类型为文本，则必须使用 textSymbol 列中的条目。 对于所有其他类型，textSymbol 值时可选的。
类型和工具
选项板可以包含任意工具类型的组合。 支持的类型为线、区域、标记和文本，必须在每个工具集工作表的 type 列中提供这些类型。
线、区域和文本类型支持多种用于确定该类型绘制样式的工具。 您可以在每个工具集工作表的 tool 列中指定工具。 无需为标记和文本类型指定工具。
有关受支持工具的完整列表，请参阅 XLSPalette 模板中的 Reference 工作表。
符号系统
每个工具支持多种符号属性，这些属性可以在每个工具集工作表的 symbol 列中指定。
对于线，您可以采用 [n,n...] 格式使用一个或多个实线-空格对来指定自定义虚线图案，其中 n 是相对线段长度，例如 [4,3,2,3]。
对于标记符号，第一个值可以是 Esri 简单标记符号的名称或包含文件扩展名的图像文件名称。 支持的图像格式为 SVG、PNG 和 JPG。 简单标记符号为圆形、十字形、菱形、方形、三角形和 x。
有关受支持的符号和属性的完整列表，请参阅 XLSPalette 模板中的 Reference 工作表。
文本
每个工具都可以附加一个文本标注。 您也可以使用文本类型本身指定标注。 可以在每个工具集工具表的 textSymbol 列中指定文本的格式。
对于 alignment 属性，您可以指定以逗号分隔的多个对齐值，例如 alignment=left,middle。
anchor属性仅应用于线、区域和标记类型，用于指定放置的文本标注相对于图形元素的位置。
有关受支持的样式和属性的完整列表，请参阅 XLSPalette 模板中的 Reference 工作表。
工具集图标
工具集图标与工具集名称一起显示在选项板中。 默认情况下，如果工具集中的所有工具都使用同一工具，则图标自动设置为与该工具匹配。 要指定工具集的图标，将 &icon= 追加到工作表名称，后跟 Esri Calcite UI 图标库中图标的名称或媒体文件夹中保存的图像文件的名称。 支持的图像格式为 SVG、PNG 和 JPG。
提示：
为了获得最佳结果，设置工具集图标时请在透明背景上使用单个颜色。 工具集图标在选项板中使用灰度渲染。
工作表名称的最大长度限制为 31 个字符，并且可以包含空格，例如 New Works&icon=electric.svg。