Eingabeparameter für Ressourcenblöcke konfigurieren

Sie können Vorgänge für jede Schnittstelle eines Ressourcenblocks konfigurieren, indem Sie Eingabeparameter, Schritte und Ausgabeattribute angeben. Eingabeparameter enthalten Werte, die das System zum Identifizieren und Verwalten einer virtuellen Ressource benötigt, z. B. das Rechenzentrum und die Ressourcengruppe, in der sich die Ressource befindet.

Vorbereitungen

Erforderliche Rolle: sn_cmp.cloud_service_designer

Warum und wann dieser Vorgang ausgeführt wird

Das System ordnet dem Ressourcenblock automatisch Standardvorgänge aus der Cloud API (CAPI) zu, wenn Sie ihm Schnittstellen hinzufügen. Es stellt auch Standardeingabeparameter für die einzelnen Vorgänge bereit.

Prozedur

1. Öffnen Sie einen Ressourcenblock, und klicken Sie dann auf die Registerkarte Vorgänge.

   

   Die Unterregisterkarte Eingabeparameter wird standardmäßig angezeigt.

2. Wählen Sie die Schnittstelle aus der Auswahlliste Schnittstelle aus.

   Die Schnittstellen in dieser Auswahlliste sind von der Liste Gastschnittstelle der Ressource auf der Registerkarte Allgemeine Informationen abgeleitet, die Sie bereits beim Erstellen eines Ressourcenblocks konfiguriert haben.

   

3. Wählen Sie den Vorgang aus, für den Sie die Eingabeparameter ändern möchten.
   Sie können auch einen neuen Vorgang erstellen.
   1. Klicken Sie auf das Symbol Vorgang hinzufügen.

      

   2. Füllen Sie das Formular aus (siehe Tabelle):

      Feld	Beschreibung
      Name	Geben Sie einen beschreibenden Namen ein.
      Vorgangstyp	Wählen Sie den Vorgangstyp aus der Auswahlliste aus.
      Zugriffstyp	Wählen Sie Öffentlich aus, um den Ressourcenblockvorgang über das Katalogbestellformular verfügbar zu machen, wenn ein Benutzer einen Stapel verwaltet, dessen Besitzer er ist. Die tatsächlichen Vorgänge werden in einer Liste auf dem Katalogbestellformular angezeigt: Wählen Sie Privat aus, um zu verhindern, dass der Vorgang verwendet wird, wenn ein Benutzer einen Stapel startet. Diese Einstellung gilt auf Katalogelementebene und nicht auf der Ebene des gesamten Stapel. Sie können den Zugriffstyp für den gesamten Stapel beim Konfigurieren von Blaupausen steuern. Beispiel: Sie möchten den Vorgang Bereitstellung aufheben für eine einzelne VM als privat markieren, aber nicht für den gesamten Stapel. Dies ermöglicht dem Benutzer, die Bereitstellung aller Elemente auf einmal aufzuheben, und verhindert, dass der Benutzer nur die Bereitstellung der VM aufhebt.

   3. Klicken Sie auf Absenden.
4. Konfigurieren Sie die Eingabeparameter, um eine Möglichkeit zur Eingabe der Elemente bereitzustellen, die Sie zum Ausführen des ausgewählten Vorgangs benötigen.

   Wenn Sie beispielsweise einen Bereitstellungsvorgang für eine AWS-Ressource hinzufügen, benötigen Sie mindestens den Parameter „CloudAccount“ und den Parameter „Standort“, um den Vorgang auszuführen. Sie müssen die Provider API kennen, um zu wissen, was an sie übergeben werden soll. Wenn Sie beispielsweise einen Bereitstellungsvorgang für einen S3-Bucket in AWS hinzufügen möchten, müssen Sie die zulässigen AWS-Vorgänge für Buckets und die Anforderungselemente für Dinge wie das Erstellen eines Bucket (den PUT-Bucket-Vorgang) kennen. Sie finden diese Ressourcen normalerweise in der AWS- und der Azure-Dokumentation.

   1. Klicken Sie auf das Symbol Eingabeparameter hinzufügen.

      

   2. Fügen Sie den Namen des Parameters hinzu, den Sie von der Cloud-Provider API erhalten haben.
      In diesem Beispiel können Sie CreateBucketConfiguration für einen AWS S3-Bucket hinzufügen.
   3. Wählen Sie in der Spalte Datenquelle den Typ des Eingabeparameters aus, den Sie konfigurieren.
      Dieser Wert gibt die Quelle oder den Standort an, aus dem der Parameterwert stammt:

      • Text: Ein Textwert, den der Benutzer übergibt.
      • Pools: Die Abfrage, die für einen Pool ausgeführt werden soll, um einen Wert zu erhalten. Der Pool Datenquellenwert muss der folgenden Konvention entsprechen: ServiceNow::Pools::PoolName.Pool-Filter-Name. Weitere Informationen zu Pools finden Sie unter Pools und Filter für Cloud Provisioning.
      • CSVList: Werte aus einer kommagetrennten Werteliste, die Sie in den Datenquellenwert eingeben.
      • Array: Ein Array von Werten. Sie können ihm programmgesteuert ein Array in JavaScript senden. Das Format ist wie folgt: ['abc','def'].
      • FormData: Daten, die von dem in der Blaupause konfigurierten Formular übermittelt wurden.
      • ResourceScript: Ein Ausdruck, der einen Wert übergibt. Der Ausdruck muss im Feld Zuordnung dieser Konvention entsprechen:

        $(Script:script-name.function[arg1=${Übergabewert},arg2=${Übergabewert}])

      • TLR: Der Wert, der vom Ressourcencontainer der obersten Ebene über diesem Ressourcenblock in der Blaupause geerbt wurde.
   4. Klicken Sie auf Speichern.
   5. In der Spalte Zuordnung können Sie sich die automatisch generierten Zuordnungswerte ansehen.
      Zuordnungen geben an, wo die Informationen im System abgerufen werden. Sie müssen die Zuordnungswerte nur für Parameter des Typs ResourceScript ändern, wo Sie den Ausdruck eingeben müssen.
   6. Geben Sie in der Spalte Standardwert einen Wert ein, den das System verwenden soll, wenn der Benutzer keinen Wert übergibt oder wenn Sie nichts in den Datenquellenwert eingegeben haben.
   7. Wählen Sie Formular erstellen aus, um dieses Attribut im Bestellformular verfügbar zu machen, das dem Benutzer beim Bereitstellen des Stapelelements angezeigt wird.
      Sie können auch Obligatorisch auswählen, um die Eingabe des Benutzers zu erzwingen.
   8. Klicken Sie in der Spalte Eingeschränkt auf auf das Eingeschränkt-Symbol ( ), und wählen Sie dann einen Ressourcenblock aus, um das Attribut einzuschränken, das an einen bestimmten Host übergeben werden soll.

      In diesem Beispiel konfigurieren Sie einen Ressourcenblock für einen virtuellen Server in vSphere, für den der Name des VM-Ordners (dargestellt durch das Attribut VmFolderName) erforderlich ist. Für andere Rechenzentrumstypen ist der Name des VM-Ordners nicht erforderlich. Daher können Sie VmFolderName auf den Ressourcenblock des vSphere-Rechenzentrums beschränken.

      Dieses Bild zeigt, wie das Attribut „VMFolderName“ auf das vSphere-Rechenzentrum beschränkt ist.