DocumentationAPI du système d’exploitation d’images Dynamic Media

Créer un jeu de ressources createassetset

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
  • Administration

Crée un ensemble de ressources générique avec une chaîne de définition d’ensemble brute à 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 :chaîne
Oui
Poignée de l’entreprise qui contient le jeu de ressources.
folderHandle
xsd:string
Oui
La poignée du dossier dans lequel le nouveau jeu de ressources est créé.
name
xsd:string
Oui
Nom de la ressource.
Sous-type
xsd :chaîne
Oui
Identifiant unique créé par le client pour le type d’ensemble de ressources.
setDefinition
xsd:string
Non

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

Ces paramètres doivent être résolus au format spécifié par la visionneuse cible.

Poignée de ressource miniature
xsd :chaîne
Non
Poignée de la ressource qui sert de miniature pour la nouvelle visionneuse d’images. Si cette valeur n’est pas spécifiée, 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 du catalogue. Les chaînes de substitution ont le format ${<substitution_func>}. Les fonctions disponibles sont décrites ci-dessous.

NOTE
Les littéraux de handle des listes de paramètres doivent être entourés de crochets ([]). Tout le texte qui se trouve en dehors d’une chaîne de substitution est copié mot pour mot 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 de métadonnées de la ressource.
getThumbCatalogId([<asset_handle>])
ID de catalogue de la ressource (pour les ressources basées sur des images uniquement). ID de catalogue de la ressource miniature associée (pour les autres ressources). Si aucune ressource miniature associée n’est disponible, la fonction renvoie une chaîne vide.

Exemple de chaîne Media setDefinition

${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 catalogue ou de la publication, ce processus est résolu en une chaîne similaire à ce qui suit :

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

Output (createAssetSet)

Nom
Type
Obligatoire
Description
assetHandle
xsd:string
Oui
Poignée du jeu de ressources.

Exemples section-fed53089de824d67ab96cd9103d384b4

Requête

<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