DocumentaciónAPI del sistema de producción de imágenes Dynamic Media

createAssetSet createassetset

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Desarrollador
  • Administrador

Crea un conjunto de recursos genérico con una cadena de definición de conjunto sin procesar para publicarlo en un servidor de imágenes.

Sintaxis

Tipos de usuarios autorizados section-d670d3af552147199b65c7eb847544a3

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

Parámetros section-3580b586296e42a5b21426085b1bb72d

Entrada (createAssetSet)

Nombre
Tipo
Obligatorio
Descripción
companyHandle
xsd:string
Sí
El identificador de la compañía que contiene el conjunto de recursos.
folderHandle
xsd:string
Sí
El identificador de la carpeta en la que se crea el nuevo conjunto de recursos.
nombre
xsd:string
Sí
Nombre del recurso.
subtipo
xsd:string
Sí
Un identificador único creado por el cliente para el tipo de conjunto de recursos.
setDefinition
xsd:string
No

Los parámetros de la cadena de definición del conjunto.

Estos parámetros deben resolverse en el formato especificado por el visor de destino.

thumbAssetHandle
xsd:string
No
Controlador del recurso que actúa como miniatura para el nuevo conjunto de imágenes. Si no se especifica, IPS intenta utilizar el primer recurso de imagen al que hace referencia el conjunto.

Funciones de sustitución para setDefinition

Puede especificar funciones de sustitución en línea que se resuelven durante la búsqueda o publicación del catálogo. Las cadenas de sustitución tienen el formato ${<substitution_func>}. Las funciones disponibles se describen a continuación.

NOTE
Los literales de identificador de las listas de parámetros deben estar entre corchetes ([]). Todo el texto que esté fuera de una cadena de sustitución se copia literalmente en la cadena de salida durante la resolución.
Función de sustitución
Devuelve
getFilePath([asset_handle>])
Ruta del archivo de origen principal del recurso.
getCatalogId([<asset_handle>])
El ID de catálogo del recurso.
getMetaData([<asset_handle>], [<metadata_field_handle>])
Valores de metadatos para el recurso.
getThumbCatalogId([<asset_handle>])
El ID de catálogo del recurso (solo para recursos basados en imágenes). El ID de catálogo del recurso de la miniatura asociado (para otros recursos). Si un recurso de miniatura asociado no está disponible, la función devuelve una cadena vacía.

Cadena setDefinition de medios de muestra

${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])}

En la búsqueda del catálogo o en el momento de la publicación, este proceso se resuelve en una cadena similar a la siguiente:

jcompany/myRenderSet;jcompany/myRenderSet;1,jcompany/Videos/Somebodys_N08275_flv.flv;jcomp any/myimg-1;2;20090703 10:05:53

Salida (createAssetSet)

Nombre
Tipo
Obligatorio
Descripción
assetHandle
xsd:string
Sí
El identificador del conjunto de recursos.

Ejemplos section-fed53089de824d67ab96cd9103d384b4

Solicitud

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

Respuesta

<createAssetSetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
   <assetHandle>a|1801|44|1801</assetHandle>
</createAssetSetReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681