Predispone l'aggiunta di un allegato alla lista degli allegati (AttachmentInfoList) di una risorsa e di un campo alla risorsa che riporta il suo collegamento.
Metodo
JamioResource/AddAttachmentReferenceToResource
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 a cui allegare un file. |
•Dati |
|
fieldName |
Nome del campo collegamento che deve riportare il nuovo allegato. Il campo collegamento deve essere al primo livello e non può essere contenuto in un dato strutturato o in un collegamento esteso. |
String |
|
attachmentReference |
Collegamento all'allegato da aggiungere alla risorsa. |
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 |
|
Output |
|||
Nome |
Descrizione |
Tipo |
Opzionale |
returnValue |
Risorsa restituita con un AttachmentInfoList aggiornato e un campo collegamento aggiornato. |
•Dati |
|
Commenti
Questo metodo è concepito per interagire con altri metodi in un'orchestrazione più complessa che si pone l'obiettivo di aggiungere un allegato nella lista degli allegati di una risorsa. A tal fine è necessario modellare un processo che, data la risorsa:
•predisponga il caricamento temporaneo dell'allegato tramite il metodo UploadTemporaryAttachment;
•predisponga l'aggiunta dell'allegato alla risorsa, richiamando il metodo AddAttachmentReferenceToResource;
•aggiorni la risorsa tramite il metodo UpdateResource per finalizzare l'operazione di aggiunta dell'allegato.
Esempio di modello di processo che utilizza il metodo AddAttachmentReferenceToResource
Il metodo può essere richiamato per le risorse personalizzate con il tipo:
•Dati;
•Identità;