<< Fare clic per visualizzazione il sommario >> Percorso: Il linguaggio OEL > Funzioni > Reference |
Restituisce un collegamento ad una risorsa, ad un allegato o ad un TrackingMessage.
Funzione
IReference Reference(object obj, params string[ ] parameters)
La funzione può essere utilizzata nelle seguenti modalità:
1) Reference(url)
2) Reference(name, url)
3) Reference(resource)
4) Reference(resource, [ ] fields)
5) Reference(attachmentInfo)
Output |
||
Nome |
Descrizione |
Tipo |
returnValue |
Collegamento ad una risorsa o ad un allegato. |
Modalità 1)
Reference(url)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
url |
Testo che rappresenta l'indirizzo di una Risorsa Jamio openwork o link esterno a Jamio. |
String |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Collegamento alla risorsa. |
|
Commenti
La funzione restituisce un collegamento le cui proprietà Name ed URL sono impostate uguali al parametro in input url.
Se url è l'indirizzo di una Risorsa Jamio openwork, la proprietà Type del collegamento restituito viene impostata uguale a quella della risorsa referenziata.
Se url non è l'indirizzo di una Risorsa Jamio openwork, la proprietà Type del collegamento restituito viene impostata uguale ad undefined.
Modalità 2)
Reference(name, url)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
name |
Nome da assegnare al collegamento. |
String |
|
url |
Testo che rappresenta l'indirizzo di una Risorsa Jamio openwork o link esterno a Jamio. |
String |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Collegamento alla risorsa. |
|
Commenti
La funzione restituisce un collegamento in cui la proprietà Name è impostato uguale al valore del parametro name e la proprietà URL è impostata uguale al valore del parametro url.
Se url è l'indirizzo di una Risorsa Jamio openwork, la proprietà Type del collegamento restituito viene impostata uguale a quella della risorsa referenziata.
Se url è l'indirizzo di una Risorsa Jamio openwork, la proprietà Type del collegamento restituito viene impostata uguale ad undefined.
Se url è pari a valore vuoto, la proprietà Type del collegamento restituito viene impostata uguale ad undefined e viene valorizzata solo la proprietà Name.
Modalità 3)
Reference(resource)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
resource |
Object |
|
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Collegamento alla risorsa. |
|
Commenti
La funzione restituisce un collegamento con le seguenti proprietà:
•Name uguale alla proprietà Name di resource; se resource ha la proprietà Name nulla o vuota, il Name del collegamento restituito viene posto uguale all’URL di resource;
•Type uguale alla proprietà Type di resource;
•URL uguale alla proprietà URL di resource.
Modalità 4)
Reference(resource, [ ] fields)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
resource |
Object |
|
|
fields |
Nome dei campi, separati da virgola ('campo1', 'campo2', 'campo3'..), da copiare dalla risorsa al collegamento esteso. |
Comma separated Strings |
Y |
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Collegamento esteso alla risorsa. |
|
Commenti
La funzione restituisce un collegamento esteso con le seguenti proprietà:
•Name uguale alla proprietà Name di resource; se resource ha la proprietà Name nulla o vuota, il Name del collegamento esteso restituito viene posto uguale all’URL di resource;
•Type uguale alla proprietà Type di resource;
•URL uguale alla proprietà URL di resource.
•campi aggiuntivi (Fields) con nome e valore pari a quelli dei campi indicati in fields. Se uno dei nomi di campo riportati in fields non è presente tra i campi aggiuntivi di resource, esso non viene riportato nel collegamento esteso restituito: il collegamento esteso restituito ha tutti e solo i campi presenti nella risorsa e che sono anche specificati nell'elenco dei parametri. Per esempio: se la risorsa resource contiene i campi aggiuntivi Campo1, Campo2 e Campo3, e la funzione viene invocata con Reference(resource, 'Campo1', 'Campo3', 'Campo4'), viene restituito un collegamento esteso che contiene i campi aggiuntivi Campo1 e Campo3 di resource; se la risorsa resource non ha campi viene restituito un collegamento esteso senza alcun campo.
Modalità 5)
Reference(attachmentInfo)
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
attachmentInfo |
Informazioni relative ad un allegato. |
|
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Collegamento ad un allegato. |
|
Commenti
La funzione restituisce un collegamento esteso con le seguenti proprietà:
•Name uguale al nome del file allegato;
•Type uguale al valore Attachment;
•URL uguale all'indirizzo dell'allegato rappresentato nelle attachmentInfo. La struttura di un URL di un allegato è la seguente:
/RepositoryID/ReourceType/ResourceID/Attachment/AttachmentID