Использование проектов 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.

Для создания первого файла экспорта, а именно, файла дизайна объекта:

  1. Запустите компонент перемещения дизайна на исходной системе и перейдите в папку Бизнес-объекты.
  2. Разверните папку модуля, в которой создан объект REST.
  3. Разверните папку объекта верхнего уровня - Атрибуты.
  4. Выберите коллекцию, относящуюся к объекту REST, и включите зависимые объекты.
    Это действие также выберет объект REST.
  5. Разверните папку Атрибуты для объекта REST и убедитесь в выборе оставшихся атрибутов.
  6. В списке Действия нажмите Экспорт выбранных элементов и сохраните файл.

Для создания второго файла экспорта, а именно, файла данных окна и текста REST:

  1. Перезапустите компонент перемещения дизайна и перейдите в папку Ссылки.
  2. Разверните Список ссылок и папку модулей, содержащую объект REST.
  3. Нажмите правой кнопкой мыши папку объекта и щелкните Выбрать.
    Будут выбраны все определения текста запроса. Иначе разверните папку и выберите необходимые определения.
  4. Перемещение выполняется только для имен определений текста запросов. Необходимо добавить определения текста запроса после импорта файлов перемещения дизайна.

  5. Перейдитеи в папку Окна и разверните папку модулей, содержащую объект REST.
  6. Разверните папку объекта REST, а затем выберите нужное окно. Не включайте зависимые объекты.
  7. В списке Действия нажмите Экспорт выбранных элементов и сохраните файл.

Теперь после создания двух файлов перемещения дизайна можно импортировать дизайн в целевую систему.

Для импорта дизайна в целевую систему:

  1. На целевой системе откройте компонент перемещения дизайна и выберите параметр Импорт.
  2. В списке Действия нажмите Открыть файл импорта и выберите созданный ранее первый файл.
  3. После появления предупреждения Указанный объект отсутствует выберите Не устанавливать значение и нажмите Импорт.
    Файл будет загружен, а объект информации REST создан.
  4. Нажмите OK.
  5. В списке Действия нажмите Открыть файл импорта и выберите созданный ранее второй файл.
    После загрузки файла отобразится несколько предупреждений.
  6. Для всех предупреждений Конфликт объектов в системе нужно выбрать вариант Не создавать новый....
  7. После появления предупреждения Указанный объект отсутствует выберите Не устанавливать значение.
  8. Нажмите Импорт.
    Для основного объекта REST будет создано выбранное окно, а также заполнен список выбранных записей информации REST.
  9. Нажмите OK.

Файловая часть импорта завершена. Теперь нужно выполнить обновления целевой системы вручную.

Для выполнения обновления вручную и перемещения дизайна:

  1. В Дизайнере объектов откройте объект REST.
  2. Отобразите настройки Веб-службы REST для объекта, добавьте информацию подключения и сохраните изменения.
  3. В Диспетчере окон перейдите: модуль > объект REST, нажмите окно правой кнопкой мыши и выберите Сделать доступным в Web Access.
  4. Нажмите правой кнопкой мыши объект текста запроса и создайте подходящее окно для списка ссылок.
  5. В компоненте Администрирование разверните дерево Справочные списки.
  6. Разверните модуль, содержащий объект REST, и, если необходимо, обновите определения текста запроса. Вы также можете добавить новые определения.
    Объект REST и связанные с ним данные готовы к использованию.