Получение значений свойств из внешних файлов

Свойство может получат значение из файла XML или JSON по каналу HTTP. Во время выполнения процесса сервер запросит список значений из этого файла.

Прежде чем начать

Разместите файл XML или JSON, содержащий значения свойства, на сервере, который доступен в IBM® UrbanCode Deploy. Формат этого файла может быть различным. Также необходимо указать путь к значениям, используя три параметра. Варианты параметров пути можно найти в примерах файлов.
Самый простой формат файла содержит список значений свойства, как показано ниже:
<company>
  <employee>Alice</employee>
  <employee>Bob</employee>
  <employee>Chris</employee>
<company>
Для файлов XML путь к значениям можно указать с помощью выражения XPath. В предыдущем примере файла XML параметр Базовый путь содержит выражение XPath //company/employee, а параметры Путь к значениям и Путь метки пустые.
Ниже показан пример аналогичного файла JSON:
{
  company: {
    employee: [
      "Alice",
      "Bob",
      "Chris"
    ]
  }
}
В предыдущем примере файла JSON параметр Базовый путь содержит company.employee, а параметры Путь к значениям и Путь метки пустые.
В файле можно отдельно указать информацию для меток и значений. Например, следующий файл XML содержит имена и значения ИД.
<company>
  <employee>
    <name>Alice</name>
    <id>1</id>
  </employee>
  <employee>
    <name>Bob</name>
    <id>2</id>
  </employee>
  <employee>
    <name>Chris</name>
    <id>3</id>
  </employee>
</company>
В данном примере параметр Базовый путь является выражением XPath //company/employee. Параметр Путь к значениям содержит выражение XPath, указывающее путь к значению относительно базового пути; в данном примере используется выражение ./id. Аналогично, параметр Путь метки содержит выражение XPath, указывающее путь к метке относительно базового пути; в данном примере используется выражение ./name.
Следующий файл JSON аналогичен файлу XML из предыдущего примера:
{
  company: {
    employees: [
      { name: "Alice", employee.id: 1 },
      { name: "Bob", employee.id: 2 },
      { name: "Chris", employee.id: 3}
    ]
  }
} 
В данном примере параметр Базовый путь содержит значение company.employees. Параметр Путь к значениям содержит employee\.id, а параметр Путь метки - name.
Прим.: При определении пути в файле JSON следует обозначить точки в именах атрибутов символом обратной косой черты (см. параметр Путь к значениям в предыдущем примере).
Для определения атрибутов в файле XML используйте символ @ в выражении XPath. Например, следующий файл XML содержит значения атрибутов:
<company>
  <employee id="1">Alice</employee>
  <employee id="2">Bob</employee>
  <employee id="3">Chris</employee>
<company>
В данном примере параметр Базовый путь является выражением XPath //company/employee. Параметр Путь к значениям содержит ./@id, а параметр Путь метки - точку (.).

Об этой задаче

Эти удаленные значения свойств можно использовать в определениях свойств, в частности свойств среды компонентов, но не в общих свойствах, таких как системные свойства, свойства приложений или компонентов.

Процедура

  1. Создайте определение свойства. Например, щелкните на компоненте, перейдите на вкладку Конфигурация, выберите Определения свойств среды и нажмите кнопку Добавить свойство.
  2. Заполните следующие поля: Имя, Описание, Метка, Шаблон и Обязательный.
  3. В списке Тип выберите HTTP Select, если свойство содержит одно значение, или HTTP Multi Select, если свойство может содержать несколько значений. Будет показано несколько новых полей.
  4. Заполните следующие поля. Эти поля определяются параметрами во внешних файлах.
    URL
    Укажите URL внешнего файла XML или JSON.
    Имя пользователя
    Здесь можно указать имя пользователя для URL, если он обязателен.
    Пароль
    Здесь можно указать пароль для URL, если он обязателен.
    Формат данных
    Укажите тип файла: JSON или XML.
    Базовый путь
    Для файлов XML укажите выражение XPath к данным. Для файлов JSON укажите путь на основе атрибутов JSON к данным через точку (.). Примеры значений приведены в начале страницы.
    Путь к значениям
    Укажите путь к значениям параметра относительно базового пути.
    Путь метки
    Укажите путь к меткам параметров относительно базового пути.
    Значение по умолчанию
    Укажите значение по умолчанию для параметра.
  5. Нажмите кнопку Сохранить.

Результаты

Во время выполнения процесса в окне Выполнить процесс будет указан параметр, который получает значения из внешнего файла.

Комментарии