createAssetSet

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 che conterrà 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.
subType 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 devono risolversi 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 che vengono risolte durante la ricerca o la pubblicazione del catalogo. Le stringhe di sostituzione hanno il formato ${<substitution_func>}. Le funzioni disponibili sono elencate 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 o della pubblicazione del catalogo, questa situazione 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 Sì 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