Настройки администратора

Администратор может настроить параметры в ArcGIS Online и ArcGIS Enterprise, либо через файл конфигурации, чтобы ArcGIS Earth соответствовала требованиям использования в организации. Вы можете перейти на страницу Пример файла конфигурации ArcGIS Earth и загрузить типовой файл. После установки файл конфигурации будет находиться в директории установки приложения, обычно в папке C:\Program Files\ArcGIS\ArcGIS Earth\bin.

Чтобы настроить параметры приложения с помощью файла конфигурации, имейте в виду следующее:

• Можно задать параметры конфигурации и импортировать измененный файл config.xml во время установки.
• Файл конфигурации представляет собой файл .xml, который можно корректировать по мере необходимости. Например, когда вы редактируете файл, используйте & вместо &, чтобы указать символ выхода. Убедитесь, что после редактирования файл конфигурации остается в кодировке UTF-8.
• Конфигурации, заданные администратором, автоматически загружаются при первом запуске приложения.
• Вы можете принять параметры, настроенные администратором в папке bin, нажав кнопку Сброс в Настройках приложения.
• Для индивидуальной установки ArcGIS Earth можно также изменить файл конфигурации в директории установки приложения, например, в C:\Users\username\AppData\Roaming\ESRI\ArcGISEarth.

Конфигурации организации

Некоторые настройки в ArcGIS Earth используют конфигурации организации вашей учетной записи ArcGIS Online или портала ArcGIS Enterprise. Эти настройки включают в себя базовую карту, сервис высот и сервис геокодирования, используемый ArcGIS Earth. См. разделы Настройка галереи базовых карт и базовая карта по умолчанию , Служебные сервисы и Геокодирование для получения подробной информации, если вы подключены к ArcGIS Enterprise. См. Ознакомление с работой по администрированию для получения подробной информации, если вы подключены к ArcGIS Online.

Настраиваемые параметры приложения

Администраторы могут использовать файл конфигурации для изменения параметров без перекомпиляции приложения. Вы также можете установить правила, влияющие на работу ArcGIS Earth на вашем компьютере. Администраторы могут получить доступ к файлу config.xml в каталоге установки и указать значения соответствующих атрибутов для настройки предпочтительного параметра запуска путем изменения настраиваемых параметров.

Настраиваемые параметры приложения описаны в таблицах ниже.

Общие параметры приложения

Параметр	Описание
workspace	Указывает директорию рабочей области и сохранять ли автоматически текущую рабочую область при выходе.
startupView	Позволяет настроить (Custom) начальный вид или начать с того места, на котором вы остановились (History).
spatialReference	Задает пространственную привязку, которая используется ArcGIS Earth, например Web Mercator или WGS84. По умолчанию – Web Mercator. Примечание: В ArcGIS Earth по умолчанию использовался механизм проецирования GDAL, который обычно находится в папке установки приложения C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\pedata. Загружаемый пакет расширения данных механизма проецирования можно найти в ArcGIS Developer Projection Engine Data. Извлеките загруженные ресурсы в директорию projection engine ArcGIS Earth и перезапустите ArcGIS Earth. Когда вы это сделаете, будет использоваться соответствующий механизм проецирования. Если вы видите предупреждение о дублировании файлов, можно пропустить или заменить их. Данные механизма проецирования недоступны, если ArcGIS Earth установлен напрямую из Microsoft Store.
isAutoFitWindow	Установите значение True, если хотите, чтобы размер всплывающего окна автоматически подстраивался под размер содержания. По умолчанию – False.
isShowInExternalBrowser	Отображает ссылки HTML в всплывающем окне во внешнем браузере. По умолчанию – False.
isShowStartupTips	Отображает советы при загрузке, когда запускается приложение. По умолчанию – True. Подсказка: Администраторы могут настраивать ресурсы для стартовых подсказок, обновляя файлы HTML в папке подсказок на основе установочной директории приложения.
language	Устанавливает язык отображения для текста пользовательского интерфейса ArcGIS Earth. Значение по умолчанию равно System. Если это значение - System, то ArcGIS Earth будет соответствовать настройкам языка отображения Windows.
flyto	Задает скорость полета от 0 до 100. Значение по умолчанию - 50. Включает автоматическое приближение к новому слою. По умолчанию – True. Задает угол Приблизить к слою, равный Default или None. По умолчанию – Default.
mouseWheel	Устанавливает скорость колесика мыши от 0 до 100 и направление масштабирования колесика Forward или Backward. По умолчанию – Forward.
navigatorMode	Задает режим работы экранного навигатора: Default, Expanded или Collapsed. По умолчанию – Default.
continuousPanning	Включает (True) или выключает (False) непрерывное перемещение. По умолчанию – True.
nonMouseController	Включает навигацию в ArcGIS Earth с использованием альтернативного контроллера (не мышь).
atmosphere	Переключает атмосферу на None, Horizon Only, или Realistic. По умолчанию – Horizon Only.
elevationExaggeration	Задает значение преувеличения высот для рельефа. Значение по умолчанию равно 1.
elevationExaggerationMin	Задает минимально допустимое значение преувеличения высот. Значение по умолчанию равно 0.
elevationExaggerationMax	Задает максимально допустимое значение преувеличения высот. По умолчанию используется 100. Значение, большее 1000, будет считаться равным 1000. Примечание: Максимальное значение преувеличения высот будет обновлено в пользовательском интерфейсе после применения нового значения elevationExaggerationMax.
undergroundNavigation	Включает навигацию по подземным данным. По умолчанию – Off.
groundTransparency	Регулирует прозрачность поверхности земли. Значение по умолчанию равно 0.
grid	Указывает тип сетки, символ для ее линий и стиль подписей.
location	Указывает единицы измерения местоположения. По умолчанию – DMS.
distance	Указывает единицы измерения расстояния. По умолчанию – Meters.
elevation	Указывает единицы измерения высоты по умолчанию. По умолчанию – Meters.
area	Указывает единицы измерения площади. По умолчанию – SquareMeters.
heading	Задает тип курсового угла, углы 0-360 или -180-+180. Значение по умолчанию равно 360.
isLongitudeFront	Меняет местами широту – долготу координат для поиска и отображения. По умолчанию – True.
proxy	Задает использование прокси (Boolean; дополнительно). По умолчанию – False.
historicalImagery	Задает URL-адреса пользовательских источников изображений для обозревателя Исторические изображения. Если выбранному атрибуту присвоено значение True, то источник выбирается в списке и используется в инструменте Исторические изображения. Пример: <historicalImagery> <customImagerySources> <source selected="True">yourImageServerURL</source> </customImagerySources> </historicalImagery

Параметры администрирования приложения

Параметр	Описание
autoUpdate	Если для него установлено значение False, пользователь не увидит ничего, связанного с программой обновления в ArcGIS Earth. CheckOnStartup с этим параметром используется для проверки наличия обновлений ArcGIS Earth при запуске приложения. По умолчанию – True. Пример: <autoUpdate enable="True"> <checkOnStartup>True</checkOnStartup> </autoUpdate>
isDefaultKmlViewer	Задает ArcGIS Earth как вьюер KML по умолчанию. По умолчанию – False.
isDefaultMspkViewer	Задает ArcGIS Earth как вьюер пакета слоев мобильной сцены по умолчанию. По умолчанию – True.
enableHtmlWindow	Включает окно HTML. Значение по умолчанию - False.
enableTableDataExport	Позволяет экспортировать данные векторного слоя в виде данных KMZ в таблице атрибутов. По умолчанию – True.
blockArcGISOnline	Блокирует запрос и подключение к порталам ArcGIS Online к при запуске ArcGIS Earth. По умолчанию – False.
findInTOC	Включает переключатель, позволяющий контролировать, будет ли выбранный KML на сцене автоматически подсвечиваться в Таблице содержания.
survey123APIUrl	По умолчанию приоритет ArcGIS Earth отдается использованию URL-адреса опроса, настроенного на портале. Если на портале не установлен конкретный URL-адрес, по умолчанию ArcGIS Earth использует URL-адрес https://survey123.arcgis.com/api/jsapi. Пользователь, развернувший собственный Survey123 API или использующий бета-версию Survey123, может задать собственный URL-адрес API в ArcGIS Earth, в файле конфигурации. Если в файле конфигурации указан пользовательский URL-адрес опроса, то настройки по умолчанию ArcGIS Earth будут перезаписаны, и вместо них будет использоваться заданный пользователем URL-адрес.
portals	Задает URL порталов, к которым будет подключаться ArcGIS Earth. Подсказка: Если администратор перечисляет несколько URL-адресов портала в файле конфигурации, после установки ArcGIS Earth будет использовать первый портал в качестве активного портала.
disableAddPortal	Запрещает пользователям добавлять новый портал или подключения онлайн в Portal Manager. По умолчанию – False. Подсказка: Если задано True, кнопка Добавить портал на панели Portal Manager будет недоступна, и пользователь не сможет добавить новое подключение к порталу или онлайн через Portal Manager. Пользователь может переключатся между подключениями порталов предварительной настройки, отображаемыми в Portal Manager.
fonts	Определяет шрифт для надписей отображаемых элементов. Примечание: Используйте в качестве значения элемента имя шрифта из файла шрифтов, и убедитесь в том, что этот шрифт установлен в вашей операционной системе.
log	Записывает информацию журнала в папке ESRI\ArcGISEarth\logs из пользовательской директории AppData, например, C:\Users\username\AppData\Roaming. Максимальное значение размера каждого журнала равно 10000, а максимальное количество хранящихся файлов журнала - 1000.
startupLayers	Задает начальные слои в таблице содержания и настраивает их имя, URL, тип и видимость, а также организовывает начальные слои в иерархические группы. Подсказка: Начальные слои поддерживают такие типы данных, как сервисы ArcGIS, KML и KMZ, WMS и его подслои, WFS и его подслои, GeoJSON, шейп-файлы, растры, пакеты листов, пакеты слоев сцены, пакеты мобильных сцен, веб-сцены и веб-карты. Файл конфигурации представляет собой файл .xml, который можно настраивать по мере необходимости. Он должен соответствовать спецификации XML. Например, при задании URL-адресов в теге URL, специальные символы, такие как &, должны быть надлежащим образом экранированы как &amp; в соответствии с правилами синтаксиса XML. После внесения каких-либо изменений убедитесь, что файл сохранен в кодировке UTF-8. При настройке подслоев WMS значения имени и заголовка должны в точности соответствовать названию и заголовку соответствующего слоя, заданным в документе Возможности сервиса WMS. Эти значения действуют как уникальные идентификаторы и должны соответствовать конфигурации сервиса. Подслои должны ссылаться на реальные слои, а не на узлы папок. Другими словами, они должны указывать на конечные узлы, представляющие доступные для рисования слои, а не на контейнеры, содержащие дополнительные слои. Значок предупреждения указывает на то, что путь отсутствует, данные повреждены или недоступны. Начальные слои, которые являются невидимыми, не будут загружаться, пока их видимость не будет включена в таблице содержания.
organizationalBasemaps	Задает базовую карту для вашей организации. Подсказка: Слои базовых карт организации поддерживают различные типы данных, включая KML и KMZ, WMS, растры, пакеты листов, пакеты слоев сцен, а также сервисы ArcGIS. Внутри каждого элемента <basemap> вы можете задать один или несколько слоев, используя узлы <baseLayers> или <referenceLayers>. Пример: <basemap name="basemap_wms_with_desired_layers"> <baseLayers> <layer type="WMS" url="http://myservername.esri.com/someservice/servicename/MapServer/WMSServer"> <layer name="wms_layer_name_1(required)" title="wms_layer_title_1(required)"/> <layer name="wms_layer_name_2(required)" title="wms_layer_title_2(required)"/> </layer> </baseLayers> </basemap>
organizationalTerrains	Задает поверхности рельефа для вашей организации. Подсказка: Слои поверхности организации могут включать локальные растры и сервис изображения высот. См. Базовая карта и поверхность для дополнительной информации.
positionServiceUrl	Позволяет администратору ввести URL с кодированными значениями, которые будут распознаны ArcGIS Earth и заполнены информацией о местоположении. При использовании Ctrl + щелчок правой кнопкой мыши на глобусе, будет вызван URL-адрес, в этот URL будут переданы широта, долгота и высота точки. Пока URL-адрес возвращает допустимый файл .kml, файл .kml будет отображаться в окне просмотра. Ознакомьтесь с примером из Блога ArcGIS: Point Based Service access with ArcGIS Earth. urlwithpos — Задает ключевой атрибут для элемента add под элементом ServiceURL, для включения этой функциональности. urlwithoutpos - Задает информацию для считывания ArcGIS Earth. Этой информацией является файл .kml, который возвращается от запроса сервиса без сохранения его она диск.
localKmlIcons	Включает доступ к собственной папке значков KML или указывает на настроенную папку значков. Подсказка: Если задано False, ArcGIS Earth будет использовать значки KML из google.com. Если задано True, ArcGIS Earth будет использовать локальные значки KML. Если значение для directory оставлено пустым, ArcGIS Earth будет использовать значки KML из папки \resources\symbols\kml в директории установки, обычно в C:\Program Files\ArcGIS\ArcGIS Earth\bin\ArcGISRuntime\. Если вам нужно указать на пользовательскую папку значков KML, например, пользовательские значки KML находятся в папке C:\myIcons\kml, значение для directory должно быть установлено как C:\myIcons, чтобы включить папку kml.
directoryStyleLink	Включает URL-адрес для файлов стиля словаря Esri или настраивает URL-адрес и отображает текст в пользовательском интерфейсе. По умолчанию гиперссылка URL отключена. Подсказка: Для пользователей, защищенных брандмауэром, администратор может загрузить файлы словаря из Esri Styles и сохранить их в общей директории, включить гиперссылку и обновить URL-адрес до локальной директории, чтобы пользователи могли получить доступ к ней внутри организации.
acknowledgement	Задает отображаемый текст и URL адрес для уведомлений.
help	Задает отображаемый текст и URL-адрес для справки.
submitFeedback	Задает отображаемый текст и URL адрес для отправки сообщений.
bannerSettings	Задает отображаемый текст, стиль текста, стиль шрифта и выравнивание для баннера.
automationAPI	Определяет настройки Automation API в ArcGIS Earth. autoStart - включает ArcGIS Earth Automation API при запуске ArcGIS Earth. По умолчанию – False.

Примечание:

• Формат файла конфигурации обновляется, начиная с версии 1.10. Предыдущая версия config.xml является совместимой напрямую, но она больше не поддерживается и не обновляется версиями продукта.
• При изменении пользовательских параметров через пользовательский интерфейс ArcGIS Earth в разделе Настройки приложение будет считывать эти параметры из файла конфигурации в C:\Users\<username>\AppData\Roaming\Esri\ArcGISEarth. До тех пор, пока параметры администрирования будут храниться в директории установки или в специальной директории, заданной в Менеджере конфигураций в разделе Расширенные настройки, приложение по-прежнему будет считывать параметры администрирования в этих местоположениях.