changeAsset

Cambia el nombre de un recurso.

NOTA

El parámetro renameFiles ha quedado obsoleto para versiones anteriores y se ha eliminado de renameAsset. La ruta del archivo virtual se cambia para que coincida con el nuevo nombre del recurso (conservando la extensión del archivo), mientras que las rutas de archivo físicas no se ven afectadas. Los clientes de API deben eliminar las referencias a este parámetro al actualizar a la nueva versión de API.

Tipos de usuarios autorizados

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImpagePortalContribUser
NOTA

El usuario debe tener acceso de lectura y escritura al recurso.

Parámetros

Entrada (cambiar nombre de AssetParam)

Nombre Tipo Obligatorio Descripción
*companyHandle* xsd:string El identificador de la empresa a la que pertenece el recurso.
*assetHandle* xsd:string El identificador del recurso cuyo nombre desea cambiar.
*newName* xsd:string Nombre nuevo del recurso.
*validateName* xsd:boolean Si el validateName es true y el tipo de recurso requiere un ID de IPS único, se comprueba si el nuevo nombre es único global y renameAsset genera un error si no es único.

Salida (changeAssetReturn)

La API IPS no devuelve una respuesta para esta operación. Consulte la descripción del elemento <ns1:validateName> para obtener advertencias sobre este elemento.

Ejemplos

Este ejemplo de código cambia el nombre de un recurso

Solicitar

<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>

Respuesta

Ninguno.

En esta página