RenameResourceAttachment

<< Fare clic per visualizzazione il sommario >>

Percorso:  API di piattaforma > Servizi Core > Jamio Resource > Gestione degli allegati alle risorse >

RenameResourceAttachment

Rinomina un allegato dalla lista degli allegati (AttachmentInfoList) della risorsa specificata.

 

Metodo

JamioResource/RenameResourceAttachment

 

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

Token di sessione (per la sessione corrente, nel Dominio corrente, potrebbe essere nullo o vuoto).

String

Y

resource

Risorsa che contiene l'allegato.

Dati

Identità

Fascicolo

Organizzazione

Blocco Organizzativo

Posizione Organizzativa

Unità Organizzativa

Incarico Organizzativo

Attività Utente

 

attachmentReference

Collegamento all'allegato da rinominare.

Reference

 

newFileName

Nuovo 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 iniziale con proprietà AttachmentInfoList aggiornata.

Dati

Identità

Fascicolo

Organizzazione

Blocco Organizzativo

Posizione Organizzativa

Unità Organizzativa

Incarico Organizzativo

Attività Utente

 

 

Commenti

Al parametro file è necessario passare un collegamento ad un allegato, se si vuole utilizzare il collegamento ad un altro tipo di file è necessario leggerlo tramite gli specifici metodi ( ad esempio, nel caso di uno stream va utilizzato il metodo ReadStream ) e utilizzare il collegamento restituito in output.

 

Il metodo predispone il cambio del nome dell'allegato nella lista degli allegati della risorsa, ma è necessario prevedere un successivo aggiornamento della stessa, tramite il metodo UpdateResource, per finalizzare l'operazione richiesta.

 

Il metodo può essere richiamato per le risorse personalizzate con il tipo:

Dati

Identità

Fascicolo

Organizzazione

Blocco Organizzativo

Posizione Organizzativa

Unità Organizzativa

Incarico Organizzativo

Attività Utente

 

Restituisce errore se il parametro newFileName contiene un nome non valido, ad esempio contente caratteri speciali.