Wenn Sie ein benutzerdefiniertes Formular erstellen, können Sie Elemente hinzufügen, bei denen der Benutzer einen Wert aus einer Suchergebnisliste auswählt. Bei Verwendung der Wertauswahl wählt der Benutzer einen einzelnen Wert aus. Mithilfe der Mehrwertauswahl wählt der Benutzer einen oder mehr Werte aus.
Die Wertauswahl und die Mehrwertauswahl funktionieren mit den Referenztyp, der auf der Registerkarte „Benutzerdefinierte Formulardarstellung“ definiert ist. Der Referenztyp ist eine VMware Aria Automation Orchestrator-Ressource. Beispiel: AD:UserGroup oder VC:Datastore. Durch die Definition des Referenztyps werden bei Eingabe einer Suchzeichenfolge die Ergebnisse auf die Ressourcen begrenzt, die über die passenden Parameter verfügen.
Für die Auswahlen können Sie mögliche Werte durch Konfigurieren einer externen Quelle weiter einschränken.
Arbeiten mit der Wertauswahl
Die Wertauswahl wird im Formular als Suchoption angezeigt, wenn Benutzer das Element im Katalog anfordern. Der Benutzer gibt eine Zeichenfolge ein und die Auswahl stellt eine auf Ihrer Konfiguration basierende Liste zur Verfügung.
Sie können die Auswahl basierend auf folgenden Anwendungsfällen verwenden. Am sinnvollsten lässt sich die Wertauswahl gekoppelt mit einem externen Quellwert nutzen.
- Wertauswahl mit einer konstanten Wertequelle.
Verwenden Sie diese Methode, wenn der anfordernde Benutzer eine Auswahl aus einer vordefinierten, feststehenden Liste von Werten treffen soll. Ähnlich den Combobox-, Dropdown-, Mehrfachauswahl- oder Optionsfeldgruppen-Elementen bietet diese Methode Suchergebnisse in einer Liste an, die auf definierten, konstanten Werten und Bezeichnungen basiert.
- Wertauswahl ohne definierte Wertequelle.
Verwenden Sie diese Methode, wenn der anfordernde Benutzer die VMware Aria Automation Orchestrator-Bestandsliste nach einem bestimmten Objekt mit dem konfigurierten Referenztyp durchsuchen soll. Beispiel: Der Referenztyp lautet VC:Datastore und Sie möchten, dass Benutzer den Datenspeicher aus der abgerufenen Liste auswählen.
- Wertauswahl mit einer externen Wertquelle.
Verwenden Sie diese Methode, wenn der anfordernde Benutzer aus Ergebnissen auswählen soll, die auf einer VMware Aria Automation Orchestrator-Aktion basieren. Für eine Wertauswahl, die auf einer externen Quelle basiert, muss die Aktion ein Eigenschaften-Array und kein Zeichenfolgen-Array zurückgeben. Das folgende Skript bietet ein Beispiel für eine grundlegende VMware Aria Automation Orchestrator-Aktion, die mit der Wertauswahl ausgeführt wird.
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;
Hinweis: Die Eigenschaften können nicht in einen Workflow eingegeben werden, sondern nur einen Zwischenwert im benutzerdefinierten Formular darstellen.
Arbeiten mit der Wertauswahl
Die Mehrwertauswahl wird im Anforderungsformular als Suchoption angezeigt, ähnlich wie die Wertauswahl. Hier können Sie jedoch einen oder mehrere Werte auswählen. Der Benutzer gibt eine Zeichenfolge ein und die Auswahl stellt eine Liste zur Verfügung, die darauf basiert, wie Sie die Elementeigenschaften konfiguriert haben.
Sie können die Mehrwertauswahl basierend auf den folgenden Anwendungsfällen zusätzlich zu den für die Wertauswahl beschriebenen Anwendungsfällen verwenden. Am sinnvollsten wird die Mehrwertauswahl mit einem Referenzdatentyp und einer VMware Aria Automation Orchestrator-Referenz verwendet.
- Mehrwertauswahl mit einem komplexen Datentyp und einer konstanten Wertequelle.
Verwenden Sie diese Methode, wenn der anfordernden Benutzer einen oder mehr Werte aus einer vordefinierten statischen Werteliste auswählen soll. Ähnlich den Datenraster stellt diese Methode Suchergebnisse in einer Liste zur Verfügung, die auf definierten, konstanten Werten und Bezeichnungen basiert.
- Mehrwertauswahl mit einem komplexen Datentyp und einer externen Quelle.
Verwenden Sie diese Methode, wenn der anfordernde Benutzer einen oder mehrere Werte aus einer Liste von Werten basierend auf einer VMware Aria Automation Orchestrator-Aktion auswählen soll. Diese Methode können Sie mit VMware Aria Automation Orchestrator-Verbundtypen verwenden.
- Mehrwertauswahl mit einem Referenzdatentyp und einem VMware Aria Automation Orchestrator-Referenztyp. Verwenden Sie diese Methode, wenn der anfordernde Benutzer die VMware Aria Automation Orchestrator-Bestandsliste nach einem bestimmten Objekt mit dem konfigurierten Referenztyp durchsuchen soll. Beispiel: Der Referenztyp lautet VC:Datastore und Sie möchten, dass Benutzer den Datenspeicher aus der abgerufenen Liste auswählen. Wenn Sie einen Workflow-Filter konfiguriert haben, können Sie den Workflow als Referenz verwenden. Um abgerufen zu werden, muss der Filter Werte in einem Eigenschaften-Array und nicht in einem Zeichenfolgen-Array zurückgeben. Im nächsten Abschnitt wird ein Beispiel für einen Workflowfilter bereitgestellt. In diesem Beispiel erfolgt die Filterung auf der Benutzeroberfläche, wenn der Benutzer einen Suchbegriff eingibt.
- Mehrwertauswahl mit einem Referenzdatentyp, einem VMware Aria Automation Orchestrator-Referenztyp und einer externen Quelle.
Verwenden Sie diese Methode, wenn der anfordernde Benutzer aus Ergebnissen auswählen soll, die zuerst anhand des Referenztyps und dann basierend auf einer VMware Aria Automation Orchestrator-Aktion gefiltert werden. Bei dieser Kombination werden die Ergebnisse sorgfältiger optimiert, und das Anforderungsformular wird schneller mit Daten gefüllt. Genauso wie die Ergebnisse des Referenztyps ein Eigenschaften-Array zurückgeben müssen, muss dies auch durch die Aktion der externen Quelle erfolgen. Bei diesem Beispiel erfolgt die Filterung in VMware Aria Automation Orchestrator. Dadurch kann die Liste ggf. schneller mit Daten gefüllt werden, insbesondere wenn Sie über eine große Anzahl von VMware Aria Automation Orchestrator-Aktionen verfügen.
Begrenzen der VMware Aria Automation Orchestrator-Ergebnisse für eine Ergebnisliste mit Elementen der Mehrwertauswahl
Um die Anzahl der Aktionen zu begrenzen, die zurückgegeben werden, wenn der Benutzer nach einer Aktion sucht, können Sie eine Filteraktion erstellen und die Filterergebnisse an den Suchbegriff binden.
- Erstellen Sie in VMware Aria Automation Orchestrator eine Aktion namens „filterWorkflow“.
- Wählen Sie Neue Aktion. aus und klicken Sie auf
- Geben Sie auf der Registerkarte Allgemein die folgenden Werte ein oder wählen Sie sie aus.
Option Wert Name filterWorkflow Modul com.vmware.library.workflow - Klicken Sie auf die Registerkarte Skript und fügen Sie das folgende Skript hinzu.
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;
- Konfigurieren Sie die folgenden Eigenschaften.
Eigenschaftsoption Wert Rückgabetyp Geben Sie Workflow ein und wählen Sie Array aus. Sie können einen der zurückgegebenen Typen verwenden, wenn Sie die Suche durchführen. Der ausgewählte Referenztyp im benutzerdefinierten Formular muss mit diesem übereinstimmen.
Bei diesem Verfahren verwenden Sie den Workflow weiterhin.
Eingaben Geben Sie searchTerm ein. Beachten Sie, dass die Eingabe von searchTerm der im Skript verwendeten Zeichenfolge entspricht.
- Klicken Sie auf Erstellen.
- Konfigurieren Sie die Eigenschaften für die Mehrwertauswahl im Designer für benutzerdefinierte Formulare in Automation Service Broker.
- Wählen Sie im Automation Service Broker aus und klicken Sie auf die vertikalen Punkte links neben der Vorlage, die Sie ändern. Klicken Sie dann auf Formular anpassen.
- Fügen Sie das Element der Mehrwertauswahl in der Design-Arbeitsfläche hinzu oder wählen Sie es aus.
- Klicken Sie im Bereich „Eigenschaften“ auf Darstellung und konfigurieren Sie die folgenden Werte.
Eigenschaft Wert Datentyp Verweis Referenztyp Geben Sie Workflow ein. Beachten Sie, dass dieser Wert der Rückgabetyp ist, der für die Aktion „filterWorkflow“ in VMware Aria Automation Orchestrator ausgewählt wurde. Außerdem muss es sich dabei um ein Array handeln.
Anzeigetyp Mehrwertauswahl - Klicken Sie auf die Registerkarte Werte und konfigurieren Sie die folgenden Werte.
Eigenschaft Wert Wertoptionen > Wertquelle Externe Quelle Aktion auswählen Wählen Sie die Filteraktion aus. Wählen Sie in diesem Beispiel filterWorkflows aus. Aktionseingaben – searchTerm Wählen Sie Feld und Suchbegriff aus.
- Testen Sie den Filter, indem Sie das Katalogelement anfordern.
Sie müssen sicherstellen, dass der Filter die erwarteten Werte in der Liste der Mehrwertauswahl zurückgibt und dass das Katalogelement ordnungsgemäß bereitgestellt wird.