DocumentazioneAPI di Dynamic Media Image Production System

createAssetSet createassetset

Last update: Fri Sep 01 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
  • Admin

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

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

Parametri section-3580b586296e42a5b21426085b1bb72d

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

NOTE
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 section-fed53089de824d67ab96cd9103d384b4

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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681