DocumentationAPI Système de production dʼimages Dynamic Media

createAssetSet createassetset

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

Créé pour :

  • Developer
  • Admin

Crée un jeu de ressources générique avec une chaîne de définition de jeu brut à publier sur un serveur d’images.

Syntaxe

Types d’utilisateurs autorisés section-d670d3af552147199b65c7eb847544a3

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

Paramètres section-3580b586296e42a5b21426085b1bb72d

Entrée (createAssetSet)

Nom
Type
Obligatoire
Description
companyHandle
xsd:string
Oui
Gestionnaire de la société qui contient le jeu de ressources.
folderHandle
xsd:string
Oui
Gestionnaire du dossier dans lequel le nouveau jeu de ressources est créé.
name
xsd:string
Oui
Nom de la ressource.
subType
xsd:string
Oui
Identifiant unique créé par le client pour le type de jeu de ressources.
setDefinition
xsd:string
Non

Paramètres de la chaîne de définition définie.

Ces paramètres doivent correspondre au format spécifié par la visionneuse cible.

thumbAssetHandle
xsd:string
Non
Gestion de la ressource qui agit comme miniature de la nouvelle visionneuse d’images. S’il n’est pas spécifié, IPS tente d’utiliser la première ressource d’image référencée par la visionneuse.

Fonctions de substitution pour setDefinition

Vous pouvez spécifier des fonctions de substitution en ligne qui sont résolues lors de la recherche ou de la publication de catalogue. Les chaînes de substitution ont le format ${<substitution_func>}. Les fonctions disponibles sont décrites ci-dessous.

NOTE
Les littéraux de poignée dans les listes de paramètres doivent être entourés de crochets. ([]). Tout le texte situé en dehors d’une chaîne de substitution est copié dans la chaîne de sortie lors de la résolution.
Fonction de substitution
Renvoie
getFilePath([asset_handle>])
Chemin d’accès au fichier source principal de la ressource.
getCatalogId([<asset_handle>])
ID de catalogue de la ressource.
getMetaData([<asset_handle>], [<metadata_field_handle>])
Valeurs des métadonnées de la ressource.
getThumbCatalogId([<asset_handle>])
ID de catalogue de la ressource (pour les ressources basées sur une image uniquement). ID de catalogue de la ressource de miniature associée (pour les autres ressources). Si aucune ressource de miniature associée n’est disponible, la fonction renvoie une chaîne vide.

Exemple de chaîne setDefinition pour un média

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

Lors de la recherche de catalogue ou de l’heure de publication, ce processus est résolu sur une chaîne similaire à celle-ci :

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

Sortie (createAssetSet)

Nom
Type
Obligatoire
Description
assetHandle
xsd:string
Oui
Gestionnaire du jeu de ressources.

Exemples section-fed53089de824d67ab96cd9103d384b4

Request

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

Réponse

<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