createAssetSet

Cria um conjunto de ativos genérico com uma string de definição de conjunto bruto a ser publicada em um Servidor de imagens.

Sintaxe

Tipos de usuário autorizados

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

Parâmetros

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 será 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 string de definição do conjunto.

Eles devem resolver no formato especificado pelo visualizador de públicos alvos.

thumbAssetHandle xsd:string Não Manuseie o 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 ou publicação do catálogo. As strings de substituição têm o formato ${<substitution_func>}. As funções disponíveis são enumeradas abaixo.

OBSERVAÇÃO

Os literais de identificador nas listas de parâmetro devem estar entre parênteses ([]). Todo o texto que está fora de uma string de substituição é copiado textualmente para a string de saída durante a resolução.

Função de Substituição Retorna
getFilePath([asset_handle>]) O caminho do arquivo de origem principal do ativo.
getCatalogId([<asset_handle>]) A ID de catálogo do ativo.
getMetaData([<asset_handle>], [<metadata_field_handle>]) Valores de metadados para o ativo.
getThumbCatalogId([<asset_handle>]) A ID de catálogo do ativo (somente para ativos baseados em imagem). A ID de catálogo do ativo thumb associado (para outros ativos). Se um ativo thumb associado não estiver disponível, a função retornará uma string vazia.

Exemplo de string Media setDefinition

${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 de pesquisa ou publicação do catálogo, isso é resolvido para uma sequência de caracteres semelhante à 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.

Exemplos

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>

Nesta página