<< Fare clic per visualizzazione il sommario >> Percorso: API di piattaforma > Servizi Core > Jamio Sending > AddTrackingAttachment |
Inserisce allegati nella risorsa che traccia la spedizione. Tali allegati sono distinti dagli allegati di una qualsiasi risorsa di tipo Data e caratterizzano gli allegati di sistema di una risorsa Data per la spedizione. Tali allegati possono essere utilizzati dal progettista e associati ad un tracking message.
Metodo
JamioSending/AddTrackingAttachment
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
serverAddress |
Indirizzo del server per domini esterni (o "" per il dominio corrente). |
String |
Y |
token |
Il token di sessione (per la sessione corrente nel dominio corrente potrebbe essere null o vuoto). |
String |
Y |
resourceReference |
Riferimento della risorsa di tipo Dati che traccia la spedizione. |
Reference |
|
fileName |
Nome da assegnare al file allegato. Il nome del file viene verificato, se non è valido viene modificato in accordo con i seguenti criteri: - Se è nullo, vuoto o contenente solo spazi, viene impostato a "No_Name"; - Se contiene caratteri non validi, questi vengono rimpiazzati con il carattere "_"; - Se il nome (senza l'estensione) è un nome riservato ("NUL", "PRN", "COM1", etc.), il carattere "_" viene allegato al nome; - Se l'estensione del nome è più lunga di 253 caratteri, viene automaticamente troncata a 253 caratteri;; - Se la lunghezza totale del nome (estensione inclusa) è più lunga di 255 caratteri, il nome viene troncato, mentre l'estensione resta invariata (255 - lunghezza massima del nome compresi punto ed estensione). |
String |
|
tag |
Tag da assegnare all'allegato. |
String |
Y |
file |
Collegamento al file da allegare. |
Reference |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Riferimento all'allegato creato. |
Reference |
|
Commenti
Il metodo AddTrackingAttachment aggiunge un allegato ad una risorsa che traccia la spedizione contrassegnandolo come allegato di sistema quindi non visibile nel riquadro degli allegati della risorsa e nella lista di AttachmentInfo. Opzionalmente è possibile specificare nel campo tag descrizioni brevi del contenuto dell'allegato.
Il metodo restituisce il collegamento all'allegato creato. Tale riferimento può essere aggiunto alla lista References di ciascun TrackingMessage interessato.
Autorizzazioni
Per eseguire il metodo è necessario possedere il permesso di modifica sulla risorsa a cui deve essere aggiunto il file allegato.