Per fare riferimento alle proprietà di branding, è necessario utilizzare le espressioni.
Durante la valutazione di un'espressione da sinistra a destra, ogni proprietà a sinistra di un punto deve restituire un elemento contenente una proprietà con il nome a destra del punto. Nell'esempio seguente "author" è una proprietà nell'elemento di contenuto corrente che fa riferimento a un elemento di contenuto contenente la proprietà "bio", che a sua volta fa riferimento a un altro elemento di contenuto contenente una proprietà "hometown".
<pcs:tag property="author.bio.hometown">
IMPORTANTE: se si modifica un nome di proprietà in un modello di proprietà del portlet, sarà necessario modificare anche i riferimenti a esso nel modello di presentazione del portlet associato.
Gli unici caratteri del nome di una proprietà che vengono considerati univoci sono i caratteri alfabetici (a-z) e i caratteri numerici (0-9). Tutti gli altri caratteri (punteggiatura, spazi) vengono sostituiti da un carattere di sottolineatura ("_"). La presenza di maiuscole o minuscole nei nomi è irrilevante. Ad esempio, i seguenti nomi di proprietà sono tutti equivalenti.
Don't
say"never"
don't-say!NEVER!
DON T SAY+never
don_t_say_never_
I valori degli attributi devono essere racchiusi tra virgolette semplici o doppie, come nel formato HTML o XML.
<pcs:value
property="dog"> (legal)
<pcs:value property='dog'> (legal)
<pcs:value property=dog> (NOT legal)
Le uniche funzioni disponibili per l'utilizzo all'interno delle espressioni sono le funzioni predefinite del sistema.
|
Funzione |
Parametri |
Valore restituito |
|
itemByPath(percorso) |
percorso
: stringa |
Elemento di contenuto identificato dal percorso. |
|
folderByPath(percorso) |
percorso
: stringa |
Cartella identificata dalla stringa del percorso. |
|
objectByUid(uid) |
uid : stringa |
Oggetto identificato dall'UID. |
Il percorso che inizia con una barra è relativo della cartella radice Branding. Senza una barra iniziale il percorso è relativo alla cartella passata. Se non si specifica alcun parametro cartella, il percorso è relativo alla cartella contenente il modello in fase di valutazione.
Il parametro uid è la stringa UID ottenuta dal motore di branding.
Le funzioni possono utilizzare proprietà definite dal sistemacome illustrato di seguito.
|
Esempi |
<pcs:value expr='itemByPath("/News/Headlines")'>**Espressione non riuscita**</pcs:value> <pcs:value expr='itemByPath("/News/Headlines").modified'>**Espressione non riuscita**</pcs:value> |