Использование проектов REST в рабочих средах
Во время проектирования новых элементов системы рекомендуется создавать их в экземпляре разработки, тщательно тестировать, а затем перемещать в рабочую среду и сразу не применять любые новые данные в рабочей среде. Это особенно важно во время разработки функций, использующих действия REST.
Для получения информации о создании действий веб-службы REST см. раздел Связь объектов с веб-службами REST. Для получения информации об использовании проектов REST в рабочих средах см. информацию в Сообществе пользователей Ivanti.
Во время проектирования с помощью веб-службы REST с добавлением действия объекта создается набор новых объектов. Затем необходимо переместить эти объекты в ваши рабочие среды. В этом разделе представлены действия, необходимые для перемещения проекта из тестовой среды в рабочую. Вы можете использовать функции перемещения тестовых систем или перемещения дизайна в рабочую среду.
Тест на работоспособность
Тест перемещения тестовых данных используется для переноса проекта целиком, включая объекты, окна, настройки подключения REST и определения текста запросов с помощью приложения Test to Live.
Часть информации REST хранится в списке ссылок в объекте списка ссылок ObjectBody. Приложение Test to Live выполняет перенос только новых списков ссылок, поэтому, если вы обновите или удалите какие-либо из этих элементов, вам придется вручную обновить их в рабочей системе. Для получения дополнительной информации об использовании приложения Test to Live см. раздел Test to Live.
Перемещение дизайна
В этом разделе представлено использование функции перемещения дизайна для применения дизайна REST в рабочей среде. Для получения дополнительной информации о перемещении дизайна см. разделы Экспорт дизайна из базы данных с помощью функции передачи дизайна и Импорт элементов в базу данных.
Функция перемещения дизайна не выполняет пересылку учетных данных веб-службы REST или определений, поэтому нужно подготовить следующую информацию для ввода после завершения импорта данных перемещения дизайна:
- URI-адрес конечной системы
- Информация аутентификации, если будет выбрано: Общая или API-ключ (поставщик)
- Информация назначения ответа, если она необходима
- Текст запроса
Не добавляйте дизайн объекта или окна для объекта текста запроса в файл перемещения дизайна. Это приведет к ошибке во время запуска импорта.
Вы должны создать два файла экспорта: один для дизайна объекта, а второй для данных окна и текста REST.
Для создания первого файла экспорта, а именно, файла дизайна объекта:
- Запустите компонент перемещения дизайна на исходной системе и перейдите в папку Бизнес-объекты.
- Разверните папку модуля, в которой создан объект REST.
- Разверните папку объекта верхнего уровня - Атрибуты.
- Выберите коллекцию, относящуюся к объекту REST, и включите зависимые объекты.
Это действие также выберет объект REST. - Разверните папку Атрибуты для объекта REST и убедитесь в выборе оставшихся атрибутов.
- В списке Действия нажмите Экспорт выбранных элементов и сохраните файл.
Для создания второго файла экспорта, а именно, файла данных окна и текста REST:
- Перезапустите компонент перемещения дизайна и перейдите в папку Ссылки.
- Разверните Список ссылок и папку модулей, содержащую объект REST.
- Нажмите правой кнопкой мыши папку объекта и щелкните Выбрать.
Будут выбраны все определения текста запроса. Иначе разверните папку и выберите необходимые определения. - Перейдитеи в папку Окна и разверните папку модулей, содержащую объект REST.
- Разверните папку объекта REST, а затем выберите нужное окно. Не включайте зависимые объекты.
- В списке Действия нажмите Экспорт выбранных элементов и сохраните файл.
Перемещение выполняется только для имен определений текста запросов. Необходимо добавить определения текста запроса после импорта файлов перемещения дизайна.
Теперь после создания двух файлов перемещения дизайна можно импортировать дизайн в целевую систему.
Для импорта дизайна в целевую систему:
- На целевой системе откройте компонент перемещения дизайна и выберите параметр Импорт.
- В списке Действия нажмите Открыть файл импорта и выберите созданный ранее первый файл.
- После появления предупреждения Указанный объект отсутствует выберите Не устанавливать значение и нажмите Импорт.
Файл будет загружен, а объект информации REST создан. - Нажмите OK.
- В списке Действия нажмите Открыть файл импорта и выберите созданный ранее второй файл.
После загрузки файла отобразится несколько предупреждений. - Для всех предупреждений Конфликт объектов в системе нужно выбрать вариант Не создавать новый....
- После появления предупреждения Указанный объект отсутствует выберите Не устанавливать значение.
- Нажмите Импорт.
Для основного объекта REST будет создано выбранное окно, а также заполнен список выбранных записей информации REST. - Нажмите OK.
Файловая часть импорта завершена. Теперь нужно выполнить обновления целевой системы вручную.
Для выполнения обновления вручную и перемещения дизайна:
- В Дизайнере объектов откройте объект REST.
- Отобразите настройки Веб-службы REST для объекта, добавьте информацию подключения и сохраните изменения.
- В Диспетчере окон перейдите: модуль > объект REST, нажмите окно правой кнопкой мыши и выберите Сделать доступным в Web Access.
- Нажмите правой кнопкой мыши объект текста запроса и создайте подходящее окно для списка ссылок.
- В компоненте Администрирование разверните дерево Справочные списки.
- Разверните модуль, содержащий объект REST, и, если необходимо, обновите определения текста запроса. Вы также можете добавить новые определения.
Объект REST и связанные с ним данные готовы к использованию.