<< 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 |
|
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 |
|
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
Restituisce errore se il parametro newFileName contiene un nome non valido, ad esempio contente caratteri speciali.