Вопрос Изображение с оформлением рисования и аннотаций позволяет пользователям рисовать скетч в пустом окне или подписывать изображение либо снимок карты. Приложение для полевых работ ArcGIS Survey123 содержит палитру инструментов рисования по умолчанию, состоящую из восьми инструментов, включая стрелки, основные символы-маркеры и текстовые надписи. Для получения дополнительной информации о палитре по умолчанию см. раздел Режим рисования.
Помимо инструментов рисования по умолчанию вы можете создавать пользовательские палитры для настройки инструментов рисования и надписывания. Например, у коммунальных служб могут быть специальные символы и стили линий, относящиеся к электро- или газоснабжению.
Примечание:
Пользовательские палитры не поддерживаются веб-приложением ArcGIS Survey123.
Чтобы создать пользовательские проекты, выполните следующие действия:
- Настройте среду Python в ArcGIS Survey123 Connect, чтобы можно было запускать инструменты Новый шаблон XLSPalette и Конвертировать XLSPalette.
- Подготовьте пользовательскую палитру с помощью спецификации XLSPalette.
- Убедитесь, что шаблон XLSPalette и все связанные с ним файлы находятся в папке медиафайлов опроса.
- Конвертируйте XLSPalette в файл .palette, запустив инструмент Конвертировать XLSPalette на вкладке Медиа в Survey123 Connect.
- В форме XLSForm опроса задайте в столбце body::esri:style для вопроса Изображения с рисунком или надписями используйте пользовательскую палитру вместо палитры по умолчанию, указав palette=<palette_name>.
Пользовательская палитра сначала настраивается в шаблоне XLSPalette. Шаблон XLSPalette должен быть конвертирован в файл .palette, чтобы его можно было добавить в опрос. Шаблоны XLSPalette конвертируются инструментом на вкладке Медиа в Survey123 Connect.
Подготовка пользовательской палитры
Пользовательская палитра настраивается в XLPalette, файле .xlsx, содержащем рабочие листы, которые будут преобразованы в файл .palette, который можно использовать в опросе.
Чтобы начать работу с пользовательским дизайном палитры, загрузите шаблон XLSPalette . Survey123 Connect содержит инструмент Новый шаблон XLSPalette, предназначенный для создания пустого шаблона. Чтобы запустить инструмент, настройте среду Python в Survey123 Connect. Дополнительные сведения смотрите в разделе Настройка Python.
Откройте опрос в Survey123 Connect. Чтобы создать шаблон XLSPalette, щелкните Инструменты, а затем выберите Новый шаблон XLSPalette. Файл шаблона myXLSPalette1.xlsx создан в папке для медиафайлов Либо можно загрузить копию шаблона Survey123 с ArcGIS Online.
Каждый лист в шаблоне XLSPalette - это группа инструментов: группа инструментов в пользовательской палитре. Строки каждого листа группы инструментов задают инструменты аннотаций в группе инструментов. В следующем примере показана конфигурация XLSPalette для трех инструментов аннотации проверок газопровода, содержащая два инструмента линий и инструмент маркеров:
| тип | label | инструмент | символ | textSymbol |
|---|---|---|---|---|
line | Линия газопровода (новая) | line | color=Blue&size=5&style=dash | color=MediumBlue&size=14&anchor=bottom&italic |
line | Линия газопровода (существующая) | line | color=Yellow&size=5&outline.color=Black&outline.size=1 | color=#FFFFE0&size=14&anchor=bottom |
marker | Счетчик (новый) | meter.svg |
Дополнительные сведения о синтаксисе и параметрах, которые можно использовать для разработки пользовательской палитры, см. в спецификации XLSPalette. Полный синтаксис также описывается в листе Ссылка шаблона XLSPalette.
Скопируйте шаблон XLSPalette и любые файлы изображений, которые использует палитра, например символы-маркеры SVG и значки группы инструментов, в папку медиафайлов опроса. Шаблон XLSPalette теперь должен быть конвертирован в файл .palette, чтобы его можно было добавить в опрос.
Конвертировать палитру
Чтобы запустить инструмент Конвертировать XLSPalette, настройте среду Python в Survey123 Connect. Дополнительные сведения смотрите в разделе Настройка Python.
Открыть опрос в Survey123 Connect и выберите вкладку Медиа. Во вкладке Медиа содержится содержание папки с медиафайлами опроса. Кнопка конвертации находится рядом с файлами .xlsx. Нажмите кнопку преобразования, чтобы запустить инструмент Конвертировать XLSPalette, чтобы преобразовать шаблон XLSPalette в файл .palette, который можно использовать в опросе.
Когда преобразование завершится, файл .palette будет сохранен в папке медиафайлов и появится на вкладке Медиа.
Подсказка:
Имя файла .palette совпадает с именем исходного файла .xlsx. Поскольку это имя будет использоваться в качестве параметра XLSForm, убедитесь, что в нем нет пробелов.
Добавление палитры в опрос
После создания и конвертации пользовательской палитры можно добавить ее в XLSForm. Вы можете добавить в опрос столько пользовательских палитр, сколько вам необходимо. Но для каждого вопроса с рисованием и аннотацией можно применять только одну палитру.
Для вопроса Изображение с рисунком или аннотацией введите в столбец body::esri:style palette=<имя_палитры>, где <имя_палитры> — это имя файла палитры без расширения .palette, например: palette=Electrical
Пользовательская палитра теперь будет использоваться для вопроса Изображение вместо палитры по умолчанию.
Чтобы обновить пользовательскую палитру, внесите необходимые изменения в файл .xlsx и еще раз запустите инструмент Конвертировать XLSPalette на вкладке Медиа. Это заменит файл .palette в папке медиаресурсов и изменения становятся видимыми в Survey123 Connect при обновлении просмотра формы. Снова опубликуйте опрос, чтобы изучить изменения в полевом приложении Survey123.
Спецификация XLSPalette
Спецификация XLSPalette разработана специально для создания инструментов аннотаций в Survey123. Пользовательские палитры настроены в файле .xlsx с помощью синтаксиса XLSPalette. Шаблон XLSPalette состоит из следующего:
- Один или несколько листов группы инструментов, содержащих столбцы type, tool, symbol и textSymbol. Группа инструментов - эта группа инструментов в палитре. Палитра может содержать столько групп инструментов, сколько необходимо. Имя каждого листа группы инструментов будет отображаться в полевом приложении Survey123 как имя каждой вкладки группы инструментов в пользовательской палитре.
- Лист Ссылка, содержащий руководство по синтаксису и параметрам, которые можно использовать для разработки палитры.
- Лист Версия, содержащий информацию о том, когда последний раз обновлялся шаблон XLSPalette.
- Лист Списки, содержащий таблицы подстановки для проверки данных в листах групп инструментов. Не меняйте содержимое этого листа.
При необходимости вы можете добавлять и удалять рабочие листы группы инструментов. Чтобы добавить новый лист группы инструментов, создайте копию текущего листа группы инструментов, чтобы убедиться в том, что сохранены форматирование и проверка данных. Рабочие листы группы инструментов, которые не содержат никаких строк, кроме строки заголовка, игнорируются при преобразовании XLSPalette в файл .palette.
При работе со свойствами инструмента учитывайте следующее:
- Большая часть свойств символов задаются в виде пар name=value, разделенных амперсандом.
- Цвета могут быть заданы стандартными названиями цветов HTML или шестнадцатеричными цветовыми кодами. Для задания непрозрачности можете использовать восьмизначный шестнадцатеричный код цвета.
- Единицами измерения ширины и размера являются пикселы.
- Линейные символы поддерживают пользовательские штриховки.
- Если тип инструмента - текст, необходима запись в столбце textSymbol. Для остальных типов значение textSymbol не является обязательным.
Типы и инструменты
Палитра может содержать любые комбинации типов инструментов. Поддерживаются типы линия, площадь, маркер и текст, и они должны быть введены в столбец type в каждом листе группы инструментов.
Линии, области и текст поддерживают различные инструменты, определяющие стиль прорисовки для соответствующего типа объектов. В столбце tool каждого листа группы инструментов можно задать инструмент. Вам не следует задавать инструмент для типов "маркер" и "текст".
Для получения полного списка поддерживаемых инструментов см. лист Ссылка шаблона XLSPalette.
Символы
Каждый из инструментов поддерживает ряд свойств символа, которые можно задать в столбце symbol каждого листа группы инструментов.
Для линий можно задать пользовательский шаблон штриховки, используя одну или несколько пар "пробел-черточка" в формате [n,n...], где n — относительная длина сегмента, например, [4,3,2,3].
Для символов-маркеров первым значением может быть название Простого символа-маркера Esri либо имя файла изображения с расширением. Поддерживаемые форматы изображений - SVG, PNG и JPG. Простые символы-маркеры - это круг, крест, ромб, квадрат, треугольник и x.
Для получения полного списка поддерживаемых символов и свойств см. лист Ссылка в шаблоне XLSPalette.
Текст
К каждому инструменту может быть прикреплена текстовая подпись. Вы можете также задать подпись с помощью текстового типа. Форматирование текста задано в столбце textSymbol в каждом листе группы инструмента.
Для свойства alignment можно задать несколько значений выравнивания, разделенных запятой, например, alignment=left,middle.
Свойство anchor применяется только к линейному, площадному типам и типу маркеров и определяет место позиционирования текстовой подписи относительно графического элемента.
Для получения полного списка поддерживаемых стилей и свойств см. лист Ссылка в шаблоне XLSPalette.
Значок Группа инструментов
Значки Группы инструментов отображаются в палитре с именами группы инструментов. По умолчанию если все инструменты группы используют один и тот же инструмент, автоматически задается значок, соответствующий инструменту. Чтобы задать для группы инструментов значок, добавьте к имени листа &icon= и либо имя значка из библиотеки значки Esri Calcite UI, либо файл изображения, сохраненный в папке медиафайлов. Поддерживаемые форматы изображений - SVG, PNG и JPG.
Подсказка:
Для получения наилучших результатов воспользуйтесь одним цветом с прозрачным фоном для значков группы инструментов. Значки группы инструментов отображаются в серой шкале палитры.
Длины имен листов ограничены 31 символом и могут содержать пробелы, например, New Works&icon=electric.svg.