createAssetSet

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

Sintassi

Tipi di utenti autorizzati

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

Parametri

Input (createAssetSet)

Nome Tipo Obbligatorio Descrizione
companyHandle xsd:string L'handle della società che conterrà il set di risorse.
folderHandle xsd:string L’handle della cartella in cui viene creato il nuovo set di risorse.
name xsd:string Nome risorsa.
subType xsd:string Identificatore univoco creato dal client per il tipo di set di risorse.
setDefinition xsd:string No Parametri nella stringa di definizione del set.

Devono essere risolti nel formato specificato dal visualizzatore di destinazione.

thumbAssetHandle xsd:string No Gestione della risorsa che funge da miniatura del nuovo set di immagini. Se non viene specificato, IPS cerca di utilizzare la prima risorsa immagine a cui fa riferimento il set.

Funzioni di sostituzione per setDefinition

È possibile specificare le funzioni di sostituzione in linea risolte durante la ricerca o la pubblicazione del catalogo. Il formato delle stringhe di sostituzione è ${<substitution_func>}. Le funzioni disponibili sono enumerate di seguito.

NOTA

I valori letterali di handle negli elenchi di parametri devono essere racchiusi tra parentesi ([]). Tutto il testo che si trova al di fuori di una stringa di sostituzione viene copiato verbalmente nella stringa di output durante la risoluzione.

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

Esempio di stringa setDefinition di file multimediali

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

In fase di ricerca del catalogo o di pubblicazione, questa viene risolta 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 L'handle del set di risorse.

Esempi

Request Contents (Richiesta contenuto)

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

In questa pagina