При создании настраиваемой формы можно добавить элементы, в которых пользователь выбирает значение в списке результатов поиска. С помощью средства выбора значений пользователь выбирает единственное значение. С помощью средства выбора нескольких значений пользователь выбирает одно значение или несколько.
Средства выбора значений и выбора нескольких значений используют тип ссылки, который определяется на вкладке «Вид» данной настраиваемой формы. Тип ссылки представляет собой ресурс VMware Aria Automation Orchestrator. Например, AD:UserGroup или VC:Datastore. Если определен тип ссылки, то, когда пользователь вводит данные в строку поиска, результаты поиска будут ограничены теми ресурсами, у которых есть соответствующий параметр.
Затем в средствах выбора значений можно дополнительно ограничить набор возможных значений, настроив нужный внешний источник.
Использование средства выбора значений
Когда пользователи запрашивают элемент в каталоге, средство выбора значений отображается в форме в виде параметра поиска. Пользователь вводит строку, и средство выбора значений предоставляет соответствующие варианты в зависимости от настроек.
Средство выбора можно использовать в следующих ситуациях. Самый эффективный способ использования средства выбора значений — связать его с внешним источником значений.
- Средство выбора значений с фиксированным источником значений.
Используйте этот метод, чтобы пользователь мог выбирать из предварительно определенного статического списка значений. По аналогии с полем со списком, раскрывающимся списком, множественным выбором и группой переключателей, этот метод предоставляет список результатов поиска на основе определенных постоянных значений и меток.
- Средство выбора значений без источника значений.
Используйте этот метод, если нужно, чтобы пользователь выполнял поиск в иерархии VMware Aria Automation Orchestrator для конкретного объекта с настроенным типом ссылки. Например, тип ссылки — VC:Datastore, и необходимо, чтобы пользователи могли выбирать хранилище данных из полученного списка.
- Средство выбора значений с внешним источником значений.
Используйте этот метод, чтобы пользователь мог выбирать из результатов, основанных на действии VMware Aria Automation Orchestrator. При использовании средства выбора значений из внешнего источника это действие должно возвращать массив свойств, а не массив строк. Следующий сценарий представляет собой пример базового действия VMware Aria Automation Orchestrator, которое используется в сочетании со средством выбора значений.
var res = []; res.push(new Properties({label: 'label1',value: 'value1'})); res.push(new Properties({label: 'label2',value: 'value2'})); res.push(new Properties({label: 'label3',value: 'value3'})); return res;
Примечание: Данные свойств невозможно ввести напрямую в рабочий процесс. Их можно ввести только в качестве промежуточного значения в настраиваемой форме.
Использование средства выбора нескольких значений
Средство выбора нескольких значений отображается в форме запроса как параметр поиска аналогично средству выбора значений, но в этом случае можно выбрать одно значение или несколько. Пользователь вводит строку, и средство выбора значений предоставляет соответствующие варианты в зависимости от настроек элемента.
В дополнение к примерам, описанным для средства выбора значения, вы можете использовать средство выбора нескольких значений в следующих примерах использования. Самый полезный вариант использования средства выбора нескольких значений — с ссылочным типом данных и ссылкой VMware Aria Automation Orchestrator.
- Средство выбора нескольких значений с составным типом данных и источником постоянных значений.
Используйте этот метод, чтобы пользователь мог выбирать одно или несколько значений из предварительно определенного статического списка. Как и в случае с сеткой данных, этот метод предоставляет список результатов поиска на основе определенных постоянных значений и меток.
- Средство выбора нескольких значений с составным типом данных и внешним источником.
Используйте этот метод, чтобы пользователь мог выбирать одно или несколько значений из списка значений на основе действия VMware Aria Automation Orchestrator. Этот метод можно использовать с составными типами VMware Aria Automation Orchestrator.
- Средство выбора нескольких значений с ссылочным типом данных и типом ссылки VMware Aria Automation Orchestrator. Используйте этот метод, если нужно, чтобы пользователь выполнял поиск в иерархии VMware Aria Automation Orchestrator для конкретного объекта с настроенным типом ссылки. Например, тип ссылки — VC:Datastore, и необходимо, чтобы пользователи могли выбирать хранилище данных из полученного списка. Если у вас настроен фильтр рабочих процессов, то в качестве ссылки можно использовать рабочий процесс. Чтобы можно было воспользоваться значениями, фильтр должен возвращать их в массиве свойств, а не в массиве строк. Пример фильтра рабочих процессов представлен в следующем разделе. В этом примере фильтрация выполняется в пользовательском интерфейсе, когда пользователь вводит условия поиска.
- Средство выбора нескольких значений со ссылочным типом данных, типом ссылки VMware Aria Automation Orchestrator и внешним источником.
Используйте этот метод, чтобы пользователь мог выбирать из результатов на основе действия VMware Aria Automation Orchestrator, предварительно отфильтрованных по типу ссылки. Эта комбинация позволяет получить более точные результаты и быстрее заполнить форму запроса. Как и результаты по типу ссылки, результаты по действию внешнего источника должны возвращаться в виде массива свойств. В этом примере фильтрация выполняется в VMware Aria Automation Orchestrator и может повысить скорость заполнения списка, в частности при большом количестве действий VMware Aria Automation Orchestrator.
Ограничение количества результатов VMware Aria Automation Orchestrator для средства выбора нескольких значений
Чтобы ограничить количество действий, возвращаемых при поиске действий пользователем, можно создать действие фильтра и привязать результаты фильтра к условиям поиска.
- Создайте в VMware Aria Automation Orchestrator действие с именем filterWorkflow.
- а.Выберите и щелкните Создать действие.
- б.На вкладке Общие введите или выберите следующие значения.
Параметр Значение Имя filterWorkflow Модуль com.vmware.library.workflow - в.Перейдите на вкладку Сценарий и добавьте следующий сценарий.
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;
- г.Настройте следующие свойства.
Параметр свойств Значение Тип возвращаемых значений Введите Рабочий процесс и выберите Массив. При поиске можно использовать любой тип возвращаемых значений. Выбранный тип ссылки в настраиваемой форме должен ему соответствовать.
Если это условие выполняется, продолжайте использовать рабочий процесс.
Входные данные Введите значение searchTerm. Обратите внимание, что searchTerm соответствует строке, используемой в сценарии.
- д.Щелкните Создать.
- В конструкторе настраиваемых форм в Automation Service Broker настройте свойства средства выбора нескольких значений.
- а.В Automation Service Broker выберите , а затем щелкните вертикальные точки слева от шаблона, который требуется изменить, и нажмите Настройка формы.
- б.На холсте проекта добавьте или выберите элемент средства выбора нескольких значений.
- в.На панели свойств щелкните Вид и настройте следующие значения.
Свойство Значение Тип данных Справка Тип ссылки Введите Рабочий процесс. Помните, что это значение относится к типу возвращаемого значения, выбранному для действия filterWorkflow в VMware Aria Automation Orchestrator, и должно быть массивом.
Тип отображения Средство выбора нескольких значений - г.Перейдите на вкладку Значения и настройте следующие значения.
Свойство Значение Параметры значения > Источник значения Внешний источник Выберите действие Выберите действие фильтра. В этом примере выберите filterWorkflows. Условия поиска для действия Выберите Поле и Условие поиска.
- Проверьте фильтр, запросив элемент каталога.
Необходимо убедиться, что фильтр возвращает ожидаемые значения в списке средства выбора нескольких значений и что элемент каталога развертывается правильно.