createDerivedAsset createderivedasset

Cria um novo ativo derivado de um ativo de imagem de origem principal existente.

Sintaxe

Os ativos derivados especificam comandos de protocolo do Servidor de imagens que modificam a representação da imagem do proprietário. O tipo derivado AdjustedView ajuda a aplicar modificações simples a uma única imagem (por exemplo, especificando um retângulo de recorte), enquanto o LayerView ajuda a criar uma exibição de várias camadas que pode incluir texto ou imagens adicionais.

Ao contrário de uma cópia de imagem (consulte copyImage), uma imagem derivada é vinculada à sua imagem de proprietário. As alterações na imagem do proprietário modificam os ativos derivados associados. A exclusão da imagem do proprietário exclui todas as imagens derivadas associadas.

Tipos de usuário autorizados authorized-user-types

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser

Parâmetros section-5a0dde01cff6454da3646ea805c2be1e

Entrada (createDerivedAssetParam)

Nome
Tipo
Obrigatório
Descrição
companyHandle
xsd:string
Sim
O identificador da empresa que contém o ativo do qual você deriva o novo ativo.
ownerHandle
xsd:string
Sim
O identificador do ativo de imagem principal do qual a nova imagem é derivada.
folderHandle
xsd:string
Sim
O identificador da pasta na qual o novo ativo derivado é criado.
name
xsd:string
Sim
O nome do ativo derivado.
type
xsd:string
Sim
O tipo do novo ativo derivado: AdjustedView ou LayerView.
urlModifier
xsd:string
Não
Comandos de protocolo de fornecimento de imagens ou de renderização de imagens aplicados antes da solicitação ou dos urlPostApplyModifier comandos.
urlPostApplyModifier
xsd:string
Não
Comandos de protocolo de fornecimento de imagens ou de renderização de imagens aplicados após à solicitação ou aos comandos urlPostApplyModifier.

Saída (createDerivedAssetParam)

Nome
Tipo
Obrigatório
Descrição
assetHandle
xsd:string
Sim
O identificador do ativo derivado.

Exemplos section-5d5ea893a1ef4edc8b3a396f1936e8c9

O código de exemplo cria um ativo derivado com uma exibição ajustada e urlModifier e urlPostApplyModifier com valores arbitrários. A resposta retorna o identificador para o ativo recém-derivado.

Solicitação

<createDerivedAssetParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <ownerHandle>a|943|1|580</ownerHandle>
   <folderHandle>ApiTestCo/</folderHandle>
   <name>ApiDerivedAsset</name>
   <type>AdjustedView</type>
   <urlModifier>modify=this</urlModifier>
   <urlPostApplyModifier>action=awesome</urlPostApplyModifier>
</createDerivedAssetParam>

Resposta

<createDerivedAssetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <assetHandle>a|944|10|2</assetHandle>
</createDerivedAssetReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681