Imposta la sostituzione del collegamento di un allegato nella lista degli allegati (AttachmentInfoList) di una risorsa.
Metodo
JamioResource/ChangeResourceAttachment
Input |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
serverAddress |
Indirizzo server da un Dominio esterno (per il Dominio della sessione corrente, utilizzare nullo o vuoto). |
String |
Y |
token |
Il token di sessione (per la sessione corrente, nel Dominio corrente, potrebbe essere nullo o vuoto). |
String |
Y |
resource |
Risorsa proprietaria dell'allegato. |
•Dati |
|
attachmentReference |
Collegamento all'allegato da sostituire. |
Reference |
|
newFileName |
Il nuovo nome che deve essere assegnato 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 |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Risorsa restituita con un AttachmentInfoList aggiornato. |
•Dati |
|
Commenti
Questo metodo è concepito per interagire con altri metodi, in particolare con il metodo UploadUpdatedAttachment, in un'orchestrazione più complessa, che si pone l'obiettivo di sostituire un allegato nella lista degli allegati di una risorsa. A tal fine è necessario modellare un processo che, data una risorsa:
•predisponga il caricamento temporaneo del file, tramite il metodo UploadUpdatedAttachment;
•predisponga la sostituzione dell'allegato ed eventuale cambio del nome del file, tramite il metodo ChangeResourceAttachment;
•aggiorni la risorsa destinataria, tramite il metodo UpdateResource, per finalizzare l'operazione di sostituzione.
Esempio di modello di processo che utilizza il metodo ChangeResourceAttachment
Il metodo può essere richiamato per le risorse personalizzate con il tipo:
•Dati;
•Identità;
Il metodo richiede:
•prima dell'operazione, il caricamento dell'allegato tramite il metodo UploadTemporaryAttachment;
•dopo l'operazione, l'aggiornamento della risorsa tramite il metodo UpdateResource per implementare l'operazione richiesta.