Cria um conjunto de ativos genérico com uma cadeia de caracteres de definição de conjunto bruto a ser publicada em um Servidor de imagens.
Sintaxe
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
Entrada (createAssetSet)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
companyHandle | xsd:string | Sim | O identificador da empresa que conterá o conjunto de ativos. |
folderHandle | xsd:string | Sim | O identificador da pasta na qual o novo conjunto de ativos é criado. |
name | xsd:string | Sim | Nome do ativo. |
subType | xsd:string | Sim | Um identificador exclusivo criado pelo cliente para o tipo de conjunto de ativos. |
setDefinition | xsd:string | Não | Os parâmetros na cadeia de caracteres de definição do conjunto. Eles devem ser resolvidos no formato especificado pelo visualizador de destino. |
thumbAssetHandle | xsd:string | Não | Identificador do ativo que atua como a miniatura do novo conjunto de imagens. Se não for especificado, o IPS tentará usar o primeiro ativo de imagem referenciado pelo conjunto. |
Funções de substituição para setDefinition
Você pode especificar funções de substituição em linha que são resolvidas durante a pesquisa de catálogo ou publicação. Cadeias de caracteres de substituição têm o formato ${<substitution_func>}
. As funções disponíveis são enumeradas abaixo.
Os literais de identificador em listas de parâmetros devem estar entre colchetes ([])
. Todo o texto que está fora de uma cadeia de caracteres de substituição é copiado textualmente para a cadeia de caracteres de saída durante a resolução.
Função de substituição | Devoluções |
---|---|
getFilePath([asset_handle>]) |
O caminho do arquivo de origem principal do ativo. |
getCatalogId([<asset_handle>]) |
A ID do catálogo do ativo. |
getMetaData([<asset_handle>], [<metadata_field_handle>]) |
Valores de metadados para o ativo. |
getThumbCatalogId([<asset_handle>]) |
A ID do catálogo do ativo (somente para ativos baseados em imagem). A ID do catálogo do ativo de miniatura associado (para outros ativos). Se um ativo de miniatura associado não estiver disponível, a função retornará uma cadeia de caracteres vazia. |
Exemplo de cadeia de caracteres de definição de conjunto de mídia
${getCatalogId([a|1664|22|1664])};${getCatalogId([a|1664|22|1664])};1,${getFilePath([a|103
6|19|144])};${getCatalogId([a|452|1|433])};2;${getMetadata([a|1036|19|144], [m|1|ASSET|SharedDateField])}
No momento da pesquisa ou publicação do catálogo, isso é resolvido como uma string semelhante ao seguinte:
jcompany/myRenderSet;jcompany/myRenderSet;1,jcompany/Videos/Somebodys_N08275_flv.flv;jcomp any/myimg-1;2;20090703 10:05:53
Saída (createAssetSet)
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
assetHandle | xsd:string |
Sim | O identificador do conjunto de ativos. |
Solicitação
<createAssetSetParam xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
<companyHandle>c|1</companyHandle>
<folderHandle>f|jcompany/AssetSets/</folderHandle>
<name>testAssetSet</name>
<subType>MediaSet</subType>
</createAssetSetParam>
Resposta
<createAssetSetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
<assetHandle>a|1801|44|1801</assetHandle>
</createAssetSetReturn>