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. A variável AdjustedView
o tipo derivado 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 proprietária. As alterações na imagem do proprietário modificam os ativos derivados associados. A exclusão da imagem do proprietário excluirá todas as imagens derivadas associadas.
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
Entrada (createDerivedAssetParam)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
companyHandle | xsd:string |
Sim | O identificador da empresa que contém o ativo do qual você derivará 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 disponibilização de imagens ou de renderização de imagens aplicados antes o pedido ou urlPostApplyModifier comandos. |
urlPostApplyModifier | xsd:string |
Não | Comandos de protocolo de disponibilização de imagens ou de renderização de imagens aplicados após ao pedido ou urlPostApplyModifier comandos. |
Saída (createDerivedAssetParam)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
assetHandle | xsd:string |
Sim | O identificador do ativo derivado. |
O código de amostra 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>