Documentazione API di Dynamic Medie Image Production System

createAssetSet

Ultimo aggiornamento: 20 luglio 2024

Argomenti:

Creato per:

Sviluppatore
Amministratore

Crea un set di risorse generico con una stringa di definizione del set non elaborato da pubblicare su un server immagini.

Sintassi

Tipi di utenti autorizzati

IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser

Parametri

Input (createAssetSet)

Nome	Tipo	Obbligatorio	Descrizione
companyHandle	xsd:stringa	Sì	Handle dell’azienda contenente il set di risorse.
folderHandle	xsd:stringa	Sì	Handle della cartella in cui viene creato il nuovo set di risorse.
nome	xsd:stringa	Sì	Nome risorsa.
sottotipo	xsd:stringa	Sì	Identificatore univoco creato dal client per il tipo di set di risorse.
setDefinition	xsd:stringa	No	Parametri nella stringa di definizione del set. Questi parametri devono essere risolti nel formato specificato dal visualizzatore di destinazione.
thumbAssetHandle	xsd:stringa	No	Handle della risorsa che funge da miniatura per il nuovo set di immagini. Se non viene specificato diversamente, IPS tenta di utilizzare la prima risorsa immagine a cui fa riferimento il set.

Funzioni di sostituzione per setDefinition

È possibile specificare funzioni di sostituzione in linea risolte durante la ricerca o la pubblicazione del catalogo. Le stringhe di sostituzione hanno il formato ${<substitution_func>}. Le funzioni disponibili sono descritte di seguito.

NOTA

I valori letterali degli handle negli elenchi dei parametri devono essere racchiusi tra parentesi quadre ([]). Tutto il testo che si trova all'esterno di una stringa di sostituzione viene copiato letteralmente nella stringa di output durante la risoluzione.

Funzione di sostituzione	Restituisce
`getFilePath([asset_handle>])`	Percorso del file di origine principale della risorsa.
`getCatalogId([<asset_handle>])`	ID catalogo della risorsa.
`getMetaData([<asset_handle>], [<metadata_field_handle>])`	Valori dei metadati della risorsa.
`getThumbCatalogId([<asset_handle>])`	ID catalogo della risorsa (solo per risorse basate su immagini). ID catalogo della risorsa miniatura associata (per altre risorse). Se una risorsa miniatura associata non è disponibile, la funzione restituisce una stringa vuota.

Stringa Media SetDefinition di esempio

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

Al momento della ricerca del catalogo o della pubblicazione, questo processo viene risolto in una stringa simile alla seguente:

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

Output (createAssetSet)

Nome

Tipo

Obbligatorio

Descrizione

assetHandle

xsd:string

Sì

Handle del set di risorse.

Esempi

Richiesta

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

Risposta

<createAssetSetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
   <assetHandle>a|1801|44|1801</assetHandle>
</createAssetSetReturn>

recommendation-more-help