Eingabe-Eigenschaftsgruppen in Cloud Assembly enthalten normalerweise zugehörige Einstellungen, die der Benutzer eingeben oder auswählen kann. Sie können auch schreibgeschützte Werte enthalten, die vom Cloud-Vorlagendesign benötigt werden.
Erstellen der Eingabe-Eigenschaftsgruppe
- Navigieren Sie zu Neue Eigenschaftsgruppe. und klicken Sie dann auf
- Wählen Sie Eingabewerte aus.
- Benennen und beschreiben Sie die neue Eigenschaftsgruppe.
Name Eigenschaftsgruppennamen müssen innerhalb einer bestimmten Organisation eindeutig sein. Es sind nur Buchstaben, Ziffern und Unterstriche zulässig. Anzeigename Fügen Sie eine Überschrift für die gesamte Gruppe der Eigenschaften hinzu, die im Anforderungsformular angezeigt wird. Beschreibung Erklären Sie, wofür diese Gruppen von Eigenschaften vorgesehen ist. Scope Legen Sie fest, ob ein Administrator die Eigenschaftsgruppe mit der gesamten Organisation gemeinsam nutzen kann. Andernfalls kann nur ein Projekt auf die Eigenschaftsgruppe zugreifen.
Obwohl Sie immer Eigenschaften in der Gruppe hinzufügen oder ändern können, ist der Geltungsbereich dauerhaft und kann nicht zu einem späteren Zeitpunkt geändert werden.
Projekt Wenn sich der Geltungsbereich nur auf Projekte bezieht, kann dieses Projekt auf die Eigenschaftsgruppe zugreifen. - Um der Gruppe eine Eigenschaft hinzuzufügen, klicken Sie auf Neue Eigenschaft.
Der Bereich für das Hinzufügen einer neuen Eigenschaft ist der Registerkarte „Eingaben“ des Code-Editors der Cloud Assembly-Designseite sehr ähnlich.
Name Frei formulierter Name für die einzelne Eigenschaft. Es sind nur Buchstaben, Ziffern und Unterstriche zulässig. Anzeigename Fügen Sie den Namen einer einzelnen Eigenschaft hinzu, die im Anforderungsformular angezeigt werden soll. Typ Zeichenfolge, Ganzzahl, Zahl, boolescher Wert (T/F), Objekt oder Array. Standardwert Voreingestellter Werteintrag, der im Anforderungsformular angezeigt wird.
Für alle Typen außer Boolesch ist der Benutzereintrag standardmäßig optional. Um sicherzustellen, dass alle Eingabefelder Einträge aufweisen, führen Sie einen der folgenden Schritte aus:- Legen Sie einen Standardwert fest.
-
Machen Sie eine Benutzereingabe durch Hinzufügen der folgenden Cloud-Vorlageneigenschaft zum abgeschlossenen Code verpflichtend.
populateRequiredOnNonDefaultProperties: true
Verschlüsselt Wenn diese Option ausgewählt ist, wird der Wert bei der Eingabe in das Anforderungsformular und in der nachfolgenden Bereitstellung verdeckt. Verschlüsselte Eigenschaften können nicht über einen Standardwert verfügen. Schreibgeschützt Ein nicht bearbeitbarer, aber sichtbarer Wert im Anforderungsformular. Erfordert einen Standardwert. Weitere Optionen Optionen, die je nach Eigenschaftstyp variieren. Erweitern Sie das Dropdown-Menü, fügen Sie zusätzliche Einstellungen hinzu und klicken Sie auf Erstellen. Im folgenden Beispiel stellt die hinzugefügte Eigenschaft das Betriebssystem-Image dar, und der anfordernde Benutzer kann aus zwei Optionen auswählen.
Hinweis: Die in der Beispielabbildung angezeigten Betriebssysteme müssen bereits Teil der konfigurierten Cloud Assembly-Infrastruktur sein. - Fügen Sie der Gruppe weitere Eigenschaften hinzu und klicken Sie auf Speichern, wenn Sie fertig sind.
Hinzufügen der Eigenschaftsgruppe zu Cloud-Vorlageneingaben
Selbst bei einer langen Liste von Eigenschaftseingaben müssen Sie nur die Eigenschaftsgruppe hinzufügen, um alle Eingaben zum Bestandteil des Anforderungsformulars zu machen.
- Klicken Sie auf der Cloud-Vorlagendesignseite über dem Bearbeitungsbereich auf der rechten Seite auf die Registerkarte Eingaben.
- Klicken Sie auf Neue Cloud-Vorlageneingabe.
- Benennen und beschreiben Sie die Eigenschaftsgruppe.
Name Geben Sie einen Namen ein, der dem zuvor erstellten Namen der Eigenschaftsgruppe ähnelt. Anzeigename Geben Sie dieselbe Überschrift ein, die Sie zuvor für die gesamte Gruppe von Eigenschaften erstellt haben, die im Anforderungsformular angezeigt wird. Typ Wählen Sie Objekt aus. Objekttyp Wählen Sie Eigenschaftsgruppe aus. Liste der Eigenschaftsgruppen Wählen Sie die gewünschte Eigenschaftsgruppe aus. Es werden nur Eigenschaftsgruppen angezeigt, die erstellt wurden und für Ihr Projekt verfügbar sind. Beachten Sie, dass keine Konstanten-Eigenschaftsgruppen angezeigt werden. - Klicken Sie auf Erstellen.
Mit dem Vorgang wird Cloud-Vorlagencode für Eingaben erstellt, die dem folgenden Beispiel ähneln.
inputs: pgmachine: type: object title: Machine Properties $ref: /ref/property-groups/machine pgrequester: type: object title: Requester Details $ref: /ref/property-groups/requesterDetails
Sie können den Code auch direkt in die Cloud Assembly-Designseite eingeben und die automatische Eingabe nutzen, während Sie $ref: /ref/p...
in den Code-Editor eingeben.
Binden von Cloud-Vorlagenressourcen an die Eigenschaftsgruppe
Um die Eingabewerte der Eigenschaftsgruppe zu nutzen, fügen Sie Bindungen unter der Ressource hinzu.
Je nachdem, welche Art von Werten in einer Eigenschaftsgruppe angezeigt werden, können Sie einzeln auf diese verweisen. Sie können sie getrennt, nach Eigenschaftsgruppenname und Eigenschaftsname, eingeben.
resources: Cloud_Machine_1: type: Cloud.Machine properties: image: '${input.pgmachine.image}' flavor: '${input.pgmachine.flavor}'
Sie können einer Ressource auch schnell einen vollständigen Satz von Werten hinzufügen, indem Sie auf eine ganze Eigenschaftsgruppe verweisen.
resources: Cloud_Machine_1: type: Cloud.Machine properties: requester: '${input.pgrequester}'
Vollständiger Code
Wenn Sie die Eingaben und die Angabe der Ressourcen abgeschlossen haben, ähnelt der fertige Code dem folgenden Beispiel.
![Vollständiger Code für die Eigenschaftsgruppen](images/GUID-3E8ACC9E-0F66-4E42-910B-FA61B1286E3D-low.png)
Bei der Bereitstellungsanforderung werden Ihre Eigenschaftsgruppen dem anfordernden Benutzer zur Vervollständigung angezeigt.
![Eingabeformular für Anforderungen](images/GUID-30CB3F2F-B74E-49FD-AA50-8548C3480C1D-low.png)
Eigenschaftsgruppen im benutzerdefinierten Service Broker-Formular-Editor
Eingabe-Eigenschaftsgruppen werden innerhalb der benutzerdefinierten Service Broker-Formularoberfläche angezeigt und stehen dort zur Anpassung zur Verfügung. Bei der Anpassung von Eigenschaftsgruppen gibt es keine speziellen Überlegungen, die nur für diese gelten. Service Broker-Benutzer müssen nicht einmal wissen, dass es sich bei der Quelle der Einträge um eine Eigenschaftsgruppe anstelle von separat erstellten Eigenschaften handelt.
![Benutzerdefinierter Service Broker-Formular-Editor](images/GUID-F44FC706-9D76-4660-8E4E-0663E15095A6-low.png)
Weitere Informationen finden Sie unter Anpassen eines Symbols und eines Anforderungsformulars für Service Broker.