De elementen van de waardekiezer en de kiezer met meerdere waarden gebruiken in de Service Broker-ontwerper voor aangepaste formulieren

Wanneer u een custom formulier maakt, kunt u elementen toevoegen waarbij de gebruiker een waarde selecteert in een lijst met zoekresultaten. Met de waardekiezer kan de gebruiker één waarde selecteren. Met de kiezer met meerdere waarden kan de gebruiker een of meer waarden selecteren.

De waardekiezer en de kiezer met meerdere waarden werken met het verwijzingstype dat is gedefinieerd op het tabblad Vormgeving van het aangepaste formulier. Het Referentietype is een resource van vRealize Orchestrator. Bijvoorbeeld: AD:UserGroup of VC:Datastore. Door het verwijzingstype te definiëren wanneer de gebruiker een zoekreeks invoert, zijn de resultaten beperkt tot de resources die de overeenkomende parameter hebben.

Voor de kiezers kunt u de mogelijke waarden vervolgens verder beperken door een externe bron te configureren.

Werken met het waardeselectieveld

Het waardeselectieveld wordt in het formulier weergegeven als een zoekoptie wanneer gebruikers het item in de catalogus aanvragen. De gebruiker voert een tekenreeks in en de kiezer biedt opties op basis van de manier waarop u deze hebt geconfigureerd.

U kunt het selectieveld op basis van de volgende gebruikssituaties gebruiken. Het meest waardevolle gebruik van het waardeselectieveld is het koppelen aan een externe bronwaarde.

• Waardeselectieveld met een constante waardebron.

  Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker een waarde selecteert uit een vooraf gedefinieerde statische lijst met waarden. Net als bij de combobox-, dropdown-, multiselect- en radiogroepselementen biedt deze methode zoekresultaten in een lijst op basis van de gedefinieerde constante waarden en labels.

• Een waardeselectieveld zonder een gedefinieerde waardebron.

  Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker in de vRealize Orchestrator-inventaris zoekt naar een specifiek object met het geconfigureerde verwijzingstype. Het referentietype is bijvoorbeeld VC:Datastore en u wilt dat de gebruikers de gegevensopslag uit de opgehaalde lijst selecteren.

• Een waardeselectieveld met een externe waardebron.

  Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker een keuze maakt uit resultaten die zijn gebaseerd op een vRealize Orchestrator-actie. Voor een waardekiezer op basis van een externe bron moet de actie een array met eigenschappen retourneren, geen tekenreeksarray. Het volgende script biedt een voorbeeld van een vRealize Orchestrator-basisactie die werkt met de waardekiezer.

  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;

  Opmerking: De invoer van eigenschappen kan niet worden ingevoerd in een werkstroom. Er kan alleen een tussenwaarde in het aangepaste formulier worden ingevoerd.

Werken met de kiezer met meerdere waarden

De kiezer met meerdere waarden wordt in het aanvraagformulier weergegeven als zoekoptie, vergelijkbaar met de waardekiezer, maar waarin u een of meer waarden kunt selecteren. De gebruiker voert een tekenreeks in en de kiezer biedt de lijst op basis van de manier waarop u de elementeigenschappen hebt geconfigureerd.

U kunt de kiezer met meerdere waarden gebruiken op basis van de volgende gebruiksscenario's naast de gebruiksscenario's die voor de waardekiezer zijn beschreven. Het meest waardevolle gebruik van de kiezer met meerdere waarden is het gebruik ervan met het gegevenstype verwijzing en een vRealize Orchestrator-verwijzing.

• Kiezer met meerdere waarden met een complex gegevenstype en constante waardebron.

  Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker een of meer waarden selecteert uit een vooraf gedefinieerde statische lijst met waarden. Net als bij het gegevensraster biedt deze methode zoekresultaten in een lijst op basis van de gedefinieerde constante waarden en labels.

• Kiezer met meerdere waarden met een complex gegevenstype en externe bron.

  Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker een of meer waarden selecteert uit een lijst met waarden op basis van een vRealize Orchestrator-actie. U kunt deze methode gebruiken met samengestelde vRealize Orchestrator-typen.

• Kiezer met meerdere waarden met het gegevenstype verwijzing en een vRealize Orchestrator-verwijzingstype. Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker in de vRealize Orchestrator-inventaris zoekt naar een specifiek object met het geconfigureerde verwijzingstype. Het referentietype is bijvoorbeeld VC:Datastore en u wilt dat de gebruikers de gegevensopslag uit de opgehaalde lijst selecteren. Als u een werkstroomfilter hebt geconfigureerd, kunt u Werkstroom als de verwijzing gebruiken. Als u het filter wilt ophalen, moet het filter waarden in een array met eigenschappen retourneren, geen tekenreeksarray. In de volgende sectie vindt u een voorbeeld van een werkstroomfilter. In dit voorbeeld wordt gefilterd in de gebruikersinterface wanneer de gebruiker een zoekterm invoert.
• Kiezer met meerdere waarden met het gegevenstype verwijzing, een vRealize Orchestrator-verwijzingstype en een externe bron.

  Gebruik deze methode wanneer u wilt dat de aanvragende gebruiker een keuze maakt uit resultaten die eerst zijn gefilterd op het verwijzingstype en vervolgens op een vRealize Orchestrator-actie. Deze combinatie verfijnt de resultaten nog verder en vult het aanvraagformulier sneller in. Net zoals de resultaten van het verwijzingstype een array met eigenschappen moeten retourneren, moet ook de externe bronactie dit doen. In dit voorbeeld wordt het filteren uitgevoerd in vRealize Orchestrator en kunt u de snelheid voor het invullen van de lijst verbeteren, in het bijzonder als u een groot aantal vRealize Orchestrator-acties hebt.

Beperk de vRealize Orchestrator-resultaten voor een lijst met elementresultaten voor een kiezer met meerdere waarden

Om het aantal acties te beperken dat wordt geretourneerd wanneer de gebruiker naar een actie zoekt, kunt u een filteractie maken en de filterresultaten binden aan de zoekterm.

1. Maak in vRealize Orchestrator een actie met de naam filterWorkflow.
   1. Selecteer Bibliotheek > Acties en klik op Nieuw actie.
   2. Voer op het tabblad Algemeen de volgende waarden in of selecteer de waarden.

      Optie	Waarde
      Naam	filterWorkflow
      Module	com.vmware.library.workflow

   3. Klik op het tabblad Script en voeg het volgende script toe.

      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. Configureer de volgende eigenschappen.
      
      

      Eigenschapsoptie	Waarde
      Retourtype	Voer Werkstroom in en selecteer Array. U kunt elk van de geretourneerde typen gebruiken wanneer u de zoekopdracht uitvoert. Het geselecteerde verwijzingstype in het aangepaste formulier moet overeenkomen. Als deze procedure is uitgevoerd, gaat u door met de werkstroom.
      Invoer	Voer searchTerm in. De invoer searchTerm komt overeen met de tekenreeks die in het script wordt gebruikt.

   5. Klik op Maken.
2. Configureer de eigenschappen voor de kiezer met meerdere waarden in de ontwerper voor aangepaste formulieren in Service Broker.
   
   
   1. Selecteer Inhoud en beleidsregels > Inhoud in Service Broker en klik op de verticale punten links van de sjabloon die u wijzigt en klik op Formulier aanpassen.
   2. Voeg het element kiezer met meerdere waarden toe aan het ontwerpcanvas of selecteer het.
   3. Klik in het deelvenster Eigenschappen op Vormgeving en configureer de volgende waarden.

      Eigenschap	Waarde
      Gegevenstype	Referentie
      Verwijzingstype	Voer Werkstroom in. Onthoud dat deze waarde het retourtype is dat is geselecteerd voor de actie filterWorkflow in vRealize Orchestrator en dit moet een array zijn.
      Weergavetype	Kiezer met meerdere waarden

   4. Klik op het tabblad Waarden en configureer de volgende waarden.

      Eigenschap	Waarde
      Waardeopties > Waardebron	Externe bron
      Actie selecteren	Selecteer de filteractie. Selecteer filterWorkflows in dit voorbeeld.
      Actie voert searchTerm in	Selecteer Veld en Zoekterm.

3. Test het filter door het catalogusitem aan te vragen.

   U moet ervoor zorgen dat het filter de verwachte waarden in de lijst van de kiezer met meerdere waarden retourneert en dat het catalogusitem correct wordt geïmplementeerd.