Hilfskomponenten
Die primäre Verwendung des Komponentenabschnitts in einem StyleBook besteht darin, Konfigurationsobjekte über NITRO-integrierte Typen oder ein anderes StyleBook zu generieren, das die tatsächlichen Konfigurationsobjek Die Hilfskomponenten erstellen Konfigurationsobjekte nicht selbst. Hilfskomponenten nehmen die Eingaben aus anderen Abschnitten wie Parameterobjekte, Eigenschaften anderer Komponenten oder Ausgaben anderer Komponenten und transformieren sie in andere Formen. Dies kann später von anderen Komponenten verwendet werden, um die tatsächlichen Konfigurationsobjekte zu generieren. Eine Hilfskomponente kann von zwei Typen sein: Objekttyp oder ein anderes StyleBook, das keinen Komponentenabschnitt enthält.
Das folgende Beispiel zeigt ein Snippet eines StyleBook, das verwendet wird, um einen Load Balancing-Server mit monitor (lb-mon-comp) auf einer Citrix ADC-Instanz zu erstellen.
parameters:-name:appnametype:string-name:ipstype:ipaddress[]-name:viptype:ipaddresscomponents:-name:help-comptype:cmtypes::server-ip-port-paramsrepeat:repeat-list:$parameters.ipsrepeat-item:server-ipproperties:ip:$server-ipport:80-name:lb-mon-comptype:stlb::lb-monproperties:lb-appname:$parameters.appnamelb-virtual-ip:$parameters.viplb-virtual-port:80lb-service-type:HTTPsvc-service-type:HTTPsvc-servers:$components.help-comp.propertiesIm Parameterbereich können Sie den Namen der Anwendung und die IP-Adressen der Load Balancing Server eingeben. Im Abschnitt “lb-mon-compKomponente“erwartet dersvc-serversParameter vonlb-monStyleBook eine Liste von Objekten, bei denen jedes Element zwei Unterparameteripund einen Port hat.
Der Parameterabschnitt dieses StyleBook akzeptiert jedoch nur die Server-IPs über $parameters.ips. Das StyleBook geht davon aus, dass alle Server auf Port 80 ausgeführt werden. Um die Load Balancing-Konfiguration mitlb-monStyleBook zu erstellen, müssen Sie die $ parameters.ips in eine Liste von Objekten umwandeln. Dies wird mit der Helferkomponente help-comp im obigen Beispiel erreicht. Die help-comp-Komponente ist vom Typserver-ip-port-paramsStyleBook. Dieses StyleBook hat keine Komponenten. Daher werden keine Konfigurationsobjekte erstellt. Der help-comp erstellt eine Wiederholungsliste über $parameters.ips und konstruiert ein Objekt, das ausipund portiert (das auf eine statische 80 festgelegt ist) für jedes Element von $parameters.ips. Daher transformiert help-comp eine Liste von IP-Adressen in eine Liste von Objekten, die späterlb-mon-compzum Zuweisen vonsvc-serversEigenschaften verwendet werden können. Das Ergebnis des Hilfe-Comp wird dersvc-serversEigenschaft von zugeordnetlb-mon-comp.