Fonctions des composants

Les fonctions des composants incluent notamment :

IsAssetExist

La fonction IsAssetExist vérifie si le composant existe. Renvoie le résultat « True » (Vrai) s’il existe ; « False » (Faux) dans le cas contraire.

Syntaxe :

IsAssetExist(AssetIdAsString, mediaTypeNumber)

Le paramètre mediaTypeNumber est facultatif. La valeur par défaut est 8.

Types (support) de composants possibles :

  • 3 - pour les éléments graphiques sur le Web (éléments graphiques valides pour le Web, comme les fichiers .jpg)

  • 6 - pour le texte sur le Web

  • 7 - pour le texte imprimé

  • 8 - pour les éléments graphiques imprimés comme les fichiers .pdf (valeur par défaut)

Exemple :

IsAssetExist("Pic1", 3) = True (Vrai)

GetAssetPath

La fonction GetAssetPath renvoie le chemin d’accès du fichier du composant. En l’absence de résultat, renvoie un résultat Null.

Syntaxe :

GetAssetPath(AssetIdAsString, mediaTypeNumber)

Types (support) de composants possibles :

  • 3 - pour les éléments graphiques sur le Web (éléments graphiques valides pour le Web, comme les fichiers .jpg)

  • 6 - pour le texte sur le Web

  • 7 - pour le texte imprimé

  • 8 - pour les éléments graphiques imprimés (comme les fichiers .pdf)

Exemple :

GetAssetPath("Pic1", 3) = C:\\Pic1.png

GetAssetPath("Pic1", 8) = C:\\Pic1.pdf

GetAssetWebURL

La fonction GetAssetWebURLrenvoie l’URL du composant. En l’absence de résultat, renvoie un résultat Null.

Syntaxe :

GetAssetWebURL(AssetIdAsString, mediaTypeNumber)

Types (support) de composants possibles :

  • 3 - pour les éléments graphiques sur le Web (éléments graphiques valides pour le Web, comme les fichiers .jpg)

  • 6 - pour le texte sur le Web

  • 7 - pour le texte imprimé

  • 8 - pour les éléments graphiques imprimés (comme les fichiers .pdf)

Exemple :

GetAssetWebURL("Pic1", 3) = https://www.xmpie.com/wp-content/Pic1.png

GetAssetWebURL("Pic1", 8) = https://www.xmpie.com/wp-content/Pic1.pdf

GetPDFAssetPageCount

La fonction GetPDFAssetPageCountrenvoie le nombre de pages du PDF. En l’absence de PDF, renvoie un résultat de 0.

Syntaxe :

GetPDFAssetPageCount(assetIdAsString)

Exemple :

GetPDFAssetPageCount("Doc1") = 6

Rectangle

Cette fonction peut servir à remplir n'importe quelle forme créée dans InDesign (par exemple, un cercle, un polygone, etc.).

La fonction Rectangle génère à la volée un rectangle dynamique (image graphique) à la couleur requise (CMJN).

Cette fonction vous permet de définir les couleurs des objets dynamiques par le biais de variables et de dials de campagne ; objets susceptibles d’être utilisés dans les produits uStore.

Cliquez ici pour apprendre à créer un sélecteur de couleurs dynamique dans uStore avec la fonction Rectangle.

Syntaxe

Rectangle(cyanPercentage, magentaPercentage, yellowPercentage, blackPercentage)

Exemple

Rectangle(12, 87, 71, 3) = Flame Scarlet

Rectangle(88, 67, 20, 5) = Classic Blue

Web.URLContentAsFile

La fonction Web.URLContentAsFile permet de récupérer une image à partir d’Internet via son URL.

Voir Formation vidéo

Syntaxe

Call Web.URLContentAsFile(URL, timeout, defaultAssetName, contentType)

  • URL : Requise. L’URL vers une image, par ex. : http://imagesdomain/imagesfolder/imagename.jpg

  • timeout (délai d’expiration) - (Facultatif) La valeur par défaut est de 30 secondes, après quoi la requête expire.

  • defaultAssetName - (facultatif) Ressource par défaut en cas d'erreur (y compris dépassement du délai d’expiration). Si aucune ressource n'est définie, l’erreur est assimilée à une ressource manquante.

  • contentType - (facultatif) Par défaut , le contentType (type de contenu) est automatiquement détecté. Vous pouvez définir, de manière explicite, un standard de type Mime IANA.

Exemple

Web.URLContentAsFile("http://imagesdomain/imagesfolder/imagename.jpg")