AddTrackingAttachment

<< 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.