getAssetsByName

Retorna ativos com base em uma matriz de nomes de ativos.

Sintaxe

Tipos de usuário autorizados

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
OBSERVAÇÃO

Somente retorna ativos aos quais o usuário tem acesso de leitura.

Parâmetros

Entrada (getAssetsByNameParam)

Nome Tipo Obrigatório Descrição
companyHandle xsd:string Sim A alça da empresa.
accessUserHandle xsd:string Não Fornece acesso como outro usuário. Disponível somente para administradores.
accessGroupHandle xsd:string Não Usado para filtrar por um grupo específico.
nameArray tipos:StringArray Sim Matriz de nomes de ativos a serem recuperados.
assetTypeArray tipos:StringArray Não Matriz de tipos de ativos permitidos para ativos recuperados.
excludeAssetTypeArray tipos:StringArray Não Matriz de tipos de ativos excluídos para ativos recuperados.
assetSubTypeArray tipos:StringArray Não Matriz de subtipos de ativos permitidos para ativos recuperados.
hardSubTypeCheck xsd:booleano Não

Se true e assetSubTypeArray não estiverem vazios, apenas os ativos cujos subtipos estão em assetSubTypeArray serão devolvidos.

Se false, ativos sem subtipo definido serão incluídos.

O valor padrão é false.

responseFieldArray tipos:StringArray Não Contém uma lista de campos e subcampos incluídos na resposta.
excludeFieldArray tipos:StringArray Não Contém uma lista de campos e subcampos excluídos da resposta.

Saída (getAssetsByNameReturn)

Nome Tipo Obrigatório Descrição
*assetArray* types:AssetArray Não Matriz de ativos que correspondem aos critérios de filtragem.

Exemplos

Essa amostra de código retorna dois ativos de tipo de imagem.

Solicitação

<getAssetsByNameParam xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <companyHandle>c|3</companyHandle>
   <nameArray>
      <items>B010</items>
      <items>IMG_0103</items>
   </nameArray>
   <assetTypeArray>
      <items>Image</items>
   </assetTypeArray>
</getAssetsByNameParam>

Resposta

<getAssetsByNameReturn xmlns="http://www.scene7.com/IpsApi/xsd/2010-01-31">
   <assetArray>
      <items>
         <assetHandle>a|210</assetHandle>
         <type>Image</type>
         <name>B010</name>
         ...</items>
      <items>
         <assetHandle>a|189</assetHandle>
         <type>Image</type>
         <name>IMG_0103</name>
         ...
      </items>
   </assetArray>
</getAssetsByNameReturn>

Nesta página