getAssetsByName

Devuelve recursos en función de una matriz de nombres de recursos.

Sintaxis

Tipos de usuarios autorizados

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • TrialSiteUser
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser
NOTA

Solo devuelve recursos a los que el usuario tiene acceso de lectura.

Parámetros

Entrada (getAssetsByNameParam)

Nombre Tipo Obligatorio Descripción
companyHandle xsd:string El identificador de la empresa.
accessUserHandle xsd:string No Proporciona acceso como otro usuario. Disponible solo para administradores.
accessGroupHandle xsd:string No Se utiliza para filtrar por un grupo específico.
nameArray tipos:StringArray Matriz de nombres de recursos que se van a recuperar.
assetTypeArray tipos:StringArray No Matriz de tipos de recurso permitidos para los recursos recuperados.
excludeAssetTypeArray tipos:StringArray No Matriz de tipos de recurso excluidos para los recursos recuperados.
assetSubTypeArray tipos:StringArray No Matriz de subtipos de recursos permitidos para los recursos recuperados.
strictoSubTypeCheck xsd:boolean No

Si true y assetSubTypeArray no están vacíos, solo se devuelven los activos cuyos subtipos se encuentran en assetSubTypeArray.

Si es false, se incluyen los activos sin ningún subtipo definido.

El valor predeterminado es false.

responseFieldArray tipos:StringArray No Contiene una lista de campos y subcampos incluidos en la respuesta.
excludeFieldArray tipos:StringArray No Contiene una lista de campos y subcampos excluidos de la respuesta.

Salida (getAssetsByNameReturn)

Nombre Tipo Obligatorio Descripción
*assetArray* types:AssetArray No Matriz de recursos que coinciden con los criterios del filtro.

Ejemplos

Este ejemplo de código devuelve dos recursos de tipo imagen.

Solicitar

<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>

Respuesta

<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>

En esta página