Начиная с Portal for ArcGIS 10.5.1 вы сможете добавлять пользовательские виджеты на портал. Это значит, что вы можете выбрать пользовательские виджеты в среде построения при создании приложения. Перед тем как использовать пользовательский виджет, его надо разместить на веб-сервере и зарегистрировать на вашем портале. По соображениям безопасности только администраторы портала могут регистрировать пользовательский виджет, а общие приложения не имеют возможности загружать пользовательский виджет при доступе к ним анонимных пользователей.
Разместите пользовательский виджет на веб-сервере
Размещение пользовательского виджета на веб-сервере не отличается от размещения любого другого веб-приложения. Вам нужно установить и настроить веб-сервер. Обычно веб-серверы включают IIS, OS X Server и Apache.
Для размещения пользовательских виджетов на вашем веб-сервере выполните следующие действия:
- Включите анонимный доступ к вашему веб-серверу.
К местоположению для размещения должен быть анонимный доступ.
- Включите HTTPS.
Включите доступ HTTPS на веб-сервере для предотвращения создания смешанных ресурсов. Web AppBuilder не поддерживает смешанные ресурсы, вызванные загрузкой HTTP по подключению HTTPS. Кроме того, у вашего сервера должен быть допустимый SSL-сертификат, выданный центром сертификации, для установления подключения HTTPS.
- Включите Совместное использование ресурсов между разными источниками (Cross Origin Resource Sharing - CORS).
Web AppBuilder работает под доменом портала, который может отличаться от домена веб-сервера, на котором размещен ваш пользовательский виджет. Вам нужно включить CORS в веб-сервере для активации доступа к нему из домена вашего портала.
- Добавьте JSON-обработчик на свой веб-сервер.
Все виджеты состоят из файла манифеста JSON с описанием свойств. Некоторые веб-серверы не распознают по умолчанию расширение JSON. В таких случаях требуется добавить его на свой сервер, как новый MIME-тип на уровне приложения или более высоком уровне. У MIME-типа должно быть .json расширение файла и application/json MIME-тип.
- Разверните на своем веб-сервере пользовательский виджет.
Вы можете скопировать папку с пользовательским виджетом на свой веб-сервер. После разворачивания нужно получить URL файла манифеста вашего пользовательского виджета. Пример URL файла манифеста - <server.domain.com>/<my widget>/manifest.json.
Зарегистрируйте пользовательский виджет
Вам нужно зарегистрировать каждый виджет на вашем портале. Для этого вам потребуются права доступа администратора.
- В окне браузера войдите на портал.
- Щелкните Мои ресурсы.
- Щелкните Добавить элемент и выберите Приложение.
- Выберите Дополнительный модуль приложения (App Builder) и задайте URL файла манифеста.
Пример URL файла манифеста - <server.domain.com>/<my widget>/manifest.json.
- Щелкните окно Заголовок.
В заголовке вашего элемента автоматически появится файл манифеста. Кроме того, можно вручную отредактировать заголовок.
- В поле Теги добавьте теги.
- Нажмите кнопку Добавить элемент.
Теперь ваш пользовательский виджет доступен в разделе Мои ресурсы, как Дополнительный модуль App Builder.
Опубликуйте пользовательский виджет
Как администратор, вы можете опубликовать пользовательский виджет в группах вашей организации, которым он требуется, либо, при необходимости, во всей организации.
Внимание:
Не советуем вам публиковать элемент пользовательского виджета для общего доступа. По соображениям безопасности публичное приложение не будет загружать пользовательский виджет при доступе к нему анонимного пользователя. Кроме того, приложение будет загружать только пользовательский виджет, зарегистрированный в той же организации, что и пользователи, имеющие права доступа к приложению.
В Моих ресурсах найдите свой пользовательский виджет и опубликуйте его в группах вашей организации. При открытии вами билдера ваш пользовательский виджет появится под вкладкой Пользовательский диалогового окна Выбрать виджет.
Обновите пользовательский виджет
Хотя отсутствует возможность обновления пользовательского виджета на вашем портале, вы можете обновить структуру HTML и код JavaScript размещенного пользовательского виджета на своем веб-сервере.
Примечание:
После развертывания на веб-сервере пользовательского виджета и регистрации его на вашем портале в качестве элемента типа Дополнительный модуль App Builder содержимое файла манифеста сохраняется в элементе дополнительного модуля. Это значит, что все изменения вашего файла манифеста, размещенного на веб-сервере, не будут распознаваться зарегистрированным дополнительным модулем. Рекомендуем вам создать новый дополнительный модуль, а не обновлять файл манифеста.