Renomeia um ativo.
O parâmetro renameFiles
foi preterido para versões anteriores e removido de renameAsset
. O caminho do arquivo virtual é alterado para corresponder ao novo nome do ativo (preservando a extensão do arquivo), enquanto os caminhos do arquivo físico não são afetados. Os clientes da API precisam remover referências a esse parâmetro ao atualizar para a nova versão da API.
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImpagePortalContribUser
O usuário deve ter acesso de leitura e gravação ao ativo.
Entrada (renameAssetParam)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
* companyHandle* |
xsd:string |
Sim | O identificador da empresa à qual o ativo pertence. |
* assetHandle* |
xsd:string |
Sim | O identificador do ativo que você deseja renomear. |
* newName* |
xsd:string |
Sim | O novo nome do ativo. |
* validateName* |
xsd:boolean |
Sim | Se validateName for true e o tipo de ativo exigir uma ID IPS exclusiva, o novo nome será verificado quanto à exclusividade global e renameAsset emitirá uma falha se não for exclusiva. |
Saída (renameAssetReturn)
A API IPS não retorna uma resposta para esta operação. Consulte a descrição do elemento <ns1:validateName>
para obter avisos sobre esse elemento.
Essa amostra de código renomeia um ativo
Solicitação
<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>
Resposta
Nenhum.