rinominaRisorsa

Rinomina una risorsa.

NOTA

La renameFiles è stato dichiarato obsoleto per le versioni precedenti e rimosso da renameAsset. Il percorso del file virtuale viene modificato in modo che corrisponda al nuovo nome della risorsa (mantenendo l’estensione del file), mentre i percorsi dei file fisici non vengono interessati. I client API devono rimuovere i riferimenti a questo parametro quando si aggiorna alla nuova versione API.

Tipi di utenti autorizzati

IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImpagePortalContribUser

NOTA

L’utente deve disporre dell’accesso in lettura e scrittura alla risorsa.

Parametri

Input (ridenominazioneAssetParam)

Nome	Tipo	Obbligatorio	Descrizione
companyHandle	`xsd:string`	Sì	Il handle della società a cui appartiene il cespite.
assetHandle	`xsd:string`	Sì	Il handle della risorsa da rinominare.
newName	`xsd:string`	Sì	Nuovo nome della risorsa.
validateName	`xsd:boolean`	Sì	Se la `validateName` è `true` e il tipo di risorsa richiede un ID IPS univoco, quindi il nuovo nome viene controllato per verificare l’univocità globale e `renameAsset` genera un errore se non è univoco.

Output (rinominareAssetReturn)

L'API IPS non restituisce una risposta per questa operazione. Vedi la descrizione del <ns1:validateName> elemento per avvertenze su questo elemento.

Esempi

Questo codice di esempio rinomina una risorsa

Request Contents (Richiesta contenuto)

<ns1:renameAssetParam xmlns:ns1="http://www.scene7.com/IpsApi/xsd">
   <ns1:companyHandle>47</ns1:companyHandle>
   <ns1:assetHandle>24265|1|17061</ns1:assetHandle>
   <ns1:newName>My Newly Renamed Image</ns1:newName>
   <ns1:validateName>true</ns1:validateName>
   <ns1:renameFiles>true</ns1:renameFiles>
</ns1:renameAssetParam>

Risposta

Nessuno.