При создании настраиваемой формы можно добавить элементы, в которых пользователь выбирает значение в списке результатов поиска. С помощью средства выбора значений пользователь выбирает единственное значение. С помощью средства выбора нескольких значений пользователь выбирает одно значение или несколько.

Средства выбора значений и выбора нескольких значений используют тип ссылки, который определяется на вкладке «Вид» данной настраиваемой формы. Тип ссылки представляет собой ресурс vRealize Orchestrator. Например, AD:UserGroup или VC:Datastore. Если определен тип ссылки, то, когда пользователь вводит данные в строку поиска, результаты поиска будут ограничены теми ресурсами, у которых есть соответствующий параметр.

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

Использование средства выбора значений

Когда пользователи запрашивают элемент в каталоге, средство выбора значений отображается в форме в виде параметра поиска. Пользователь вводит строку, и средство выбора значений предоставляет соответствующие варианты в зависимости от настроек.

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

Средство выбора можно использовать в следующих ситуациях. Самый эффективный способ использования средства выбора значений — связать его с внешним источником значений.

  • Средство выбора значений с фиксированным источником значений.

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

  • Средство выбора значений без источника значений.

    Используйте этот метод, если нужно, чтобы пользователь выполнял поиск в иерархии vRealize Orchestrator для конкретного объекта с настроенным типом ссылки. Например, тип ссылки — VC:Datastore, и необходимо, чтобы пользователи могли выбирать хранилище данных из полученного списка.

  • Средство выбора значений с внешним источником значений.

    Используйте этот метод, чтобы пользователь мог выбирать из результатов, основанных на действии vRealize Orchestrator. При использовании средства выбора значений из внешнего источника это действие должно возвращать массив свойств, а не массив строк. Тип входных данных рабочего процесса должен быть Properties. Следующий сценарий представляет собой пример базового действия vRealize Orchestrator, которое используется в сочетании со средством выбора значений.

    var res = [];
    res.push(new Properties({key: 'key1',value: 'value1'}));
    res.push(new Properties({key: 'key2',value: 'value2'}));
    res.push(new Properties({key: 'key3',value: 'value3'}));
    return res;

Использование средства выбора нескольких значений

Средство выбора нескольких значений отображается в форме запроса как параметр поиска аналогично средству выбора значений, но в этом случае можно выбрать одно значение или несколько. Пользователь вводит строку, и средство выбора значений предоставляет соответствующие варианты в зависимости от настроек элемента.

Средство выбора нескольких значений в форме запроса со списком, диалоговое окно выбора нескольких значений, пример выбранных значений в форме.

В дополнение к примерам, описанным для средства выбора значения, вы можете использовать средство выбора нескольких значений в следующих примерах использования. Самый полезный вариант использования средства выбора нескольких значений — с ссылочным типом данных и ссылкой vRealize Orchestrator.

  • Средство выбора нескольких значений с составным типом данных и источником постоянных значений.

    Используйте этот метод, чтобы пользователь мог выбирать одно или несколько значений из предварительно определенного статического списка. Как и в случае с сеткой данных, этот метод предоставляет список результатов поиска на основе определенных постоянных значений и меток.

  • Средство выбора нескольких значений с составным типом данных и внешним источником.

    Используйте этот метод, чтобы пользователь мог выбирать одно или несколько значений из списка значений на основе действия vRealize Orchestrator. Этот метод можно использовать с составными типами vRealize Orchestrator.

  • Средство выбора нескольких значений с ссылочным типом данных и типом ссылки vRealize Orchestrator. Используйте этот метод, если нужно, чтобы пользователь выполнял поиск в иерархии vRealize Orchestrator для конкретного объекта с настроенным типом ссылки. Например, тип ссылки — VC:Datastore, и необходимо, чтобы пользователи могли выбирать хранилище данных из полученного списка. Если у вас настроен фильтр рабочих процессов, то в качестве ссылки можно использовать рабочий процесс. Чтобы можно было воспользоваться значениями, фильтр должен возвращать их в массиве свойств, а не в массиве строк. Пример фильтра рабочих процессов представлен в следующем разделе. В этом примере фильтрация выполняется в пользовательском интерфейсе, когда пользователь вводит условия поиска.
  • Средство выбора нескольких значений со ссылочным типом данных, типом ссылки vRealize Orchestrator и внешним источником.

    Используйте этот метод, чтобы пользователь мог выбирать из результатов на основе действия vRealize Orchestrator, предварительно отфильтрованных по типу ссылки. Эта комбинация позволяет получить более точные результаты и быстрее заполнить форму запроса. Как и результаты по типу ссылки, результаты по действию внешнего источника должны возвращаться в виде массива свойств. В этом примере фильтрация выполняется в vRealize Orchestrator и может повысить скорость заполнения списка, в частности при большом количестве действий vRealize Orchestrator.

Ограничение количества результатов vRealize Orchestrator для средства выбора нескольких значений

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

  1. Создайте в vRealize Orchestrator действие с именем filterWorkflow.
    1. а.Выберите Библиотека > Действия и щелкните Создать действие.
    2. б.На вкладке Общие введите или выберите следующие значения.
      Параметр Значение
      Имя filterWorkflow
      Модуль com.vmware.library.workflow
    3. в.Перейдите на вкладку Сценарий и добавьте следующий сценарий.
      var workflows = System.getModule("com.vmware.library.workflow").getAllWorkflows();
      
      var result = [];
      
      for(var i = 0; i < workflows.length; i++) {
          if(workflows[i].name.indexOf(searchTerm) !== -1) {
              result.push(workflows[i]);
          }
      }
      
      return result;
      
    4. г.Настройте следующие свойства.
      Снимок экрана действия vRealize Orchestrator с примером сценария из предыдущего шага и конфигурация свойств, настроенная в данном шаге.
      Параметр свойств Значение
      Тип возвращаемых значений Введите Рабочий процесс и выберите Массив.

      При поиске можно использовать любой тип возвращаемых значений. Выбранный тип ссылки в настраиваемой форме должен ему соответствовать.

      Если это условие выполняется, продолжайте использовать рабочий процесс.

      Входные данные Введите значение searchTerm.

      Обратите внимание, что searchTerm соответствует строке, используемой в сценарии.

    5. д.Щелкните Создать.
  2. В конструкторе настраиваемых форм в vRealize Automation Service Broker настройте свойства средства выбора нескольких значений.
    Составной снимок экрана, на котором показаны тип данных «Ссылка», тип ссылки «Рабочий процесс» и вкладка «Значения». На вкладке «Значения» показан внешний источник с действием и привязкой поля.
    1. а.В vRealize Automation Service Broker выберите Содержимое и политики > Содержимое, а затем щелкните вертикальные точки слева от шаблона, который требуется изменить, и нажмите Настройка формы.
    2. б.На холсте проекта добавьте или выберите элемент средства выбора нескольких значений.
    3. в.На панели свойств щелкните Вид и настройте следующие значения.
      Свойство Значение
      Тип данных Справка
      Тип ссылки Введите Рабочий процесс.

      Помните, что это значение относится к типу возвращаемого значения, выбранному для действия filterWorkflow в vRealize Orchestrator, и должно быть массивом.

      Тип отображения Средство выбора нескольких значений
    4. г.Перейдите на вкладку Значения и настройте следующие значения.
      Свойство Значение
      Параметры значения > Источник значения Внешний источник
      Выберите действие Выберите действие фильтра. В этом примере выберите filterWorkflows.
      Условия поиска для действия Выберите Поле и Условие поиска.
  3. Проверьте фильтр, запросив элемент каталога.

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