Variable sans Turbine

REMARQUE

Adobe Experience Platform Launch est désormais une suite de technologies destinées à la collecte de données dans Adobe Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

L’objet turbine est une « variable libre » dans la portée des modules de bibliothèque de votre extension. Il fournit des informations et des utilitaires spécifiques à lʼexécution des balises Adobe Experience Platform et est toujours disponible pour les modules de bibliothèque sans utiliser require().

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo est un objet contenant des informations de version sur la bibliothèque actuelle dʼexécution des balises.

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z"
}
Propriété Description
turbineVersion Version de Turbine utilisée dans la bibliothèque actuelle.
turbineBuildDate Date ISO 8601 de création de la version de Turbine utilisée dans le conteneur.
buildDate Date ISO 8601 de la création de la bibliothèque actuelle.

environment

console.log(turbine.environment.stage);

turbine.environment est un objet contenant des informations sur l’environnement sur lequel la bibliothèque est déployée.

{
    id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
    stage: "development"
}
Propriété Description
id L’identifiant de l’environnement.
stage Environnement pour lequel cette bibliothèque a été créée. Les valeurs possibles sont development, staging et production.

debugEnabled

Valeur boolean indiquant si le débogage des balises est actuellement activé.

Si vous essayez simplement de consigner des messages, il est peu probable que vous ayez besoin d’utiliser cette fonctionnalité. Au lieu de cela, consignez toujours les messages à lʼaide de turbine.logger afin de vous assurer quʼils ne sont imprimés sur la console que lorsque le débogage des balises est activé.

getDataElementValue

console.log(turbine.getDataElementValue(dataElementName));

Renvoie la valeur d’un élément de données.

getExtensionSettings

var extensionSettings = turbine.getExtensionSettings();

Renvoie l’objet settings qui a été enregistré pour la dernière fois à partir de la vue configuration de l’extension.

Veuillez noter que les valeurs des objets settings renvoyés peuvent provenir d’éléments de données. Par conséquent, l’appel de getExtensionSettings() à des moments différents peut donner des résultats différents si les valeurs des éléments de données ont changé. Pour obtenir les valeurs les plus récentes, patientez aussi longtemps que possible avant dʼappeler getExtensionSettings().

getHostedLibFileUrl

var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
  // Do something ...
})

La propriété hostedLibFiles peut être définie dans le manifeste dʼextension afin dʼhéberger divers fichiers avec la bibliothèque dʼexécution des balises. Ce module renvoie l’URL d’hébergement du fichier de bibliothèque donné.

getSharedModule

var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');

Récupère un module qui a été partagé depuis une autre extension. Si aucun module correspondant n’est trouvé, undefined est renvoyé. Voir Implémentation de modules partagés pour plus d’informations sur les modules partagés.

logger

turbine.logger.error('Error!');

Lʼutilitaire de journalisation est utilisé pour consigner les messages dans la console. Les messages s’affichent uniquement dans la console si le débogage est activé par l’utilisateur. La méthode recommandée pour activer le débogage consiste à utiliser Adobe Experience Cloud Debugger. Lʼutilisateur peut également exécuter la commande suivante _satellite.setDebug(true) dans la console de développeur du navigateur. La journalisation utilise les méthodes suivantes :

  • logger.log(message: string) : consigne un message sur la console.
  • logger.info(message: string) : consigne un message d’information dans la console.
  • logger.warn(message: string) : consigne un message d’avertissement dans la console.
  • logger.error(message: string) : consigne un message d’erreur dans la console.
  • logger.debug(message: string) : consigne un message de débogage dans la console. (Visible uniquement lorsque la journalisation verbose est activée dans la console du navigateur.)
  • logger.deprecation(message: string): Consigne un message d’avertissement dans la console, que le débogage des balises soit activé ou non par l’utilisateur.

onDebugChanged

En transmettant une fonction de rappel dans turbine.onDebugChanged, les balises appellent votre rappel chaque fois que le débogage est activé/désactivé. Les balises transmettent une valeur booléenne à la fonction de rappel, qui est vraie si le débogage a été activé ou fausse si le débogage a été désactivé.

Si vous essayez simplement de consigner des messages, il est peu probable que vous ayez besoin d’utiliser cette fonctionnalité. Au lieu de cela, consignez toujours les messages à lʼaide de turbine.logger et les balises feront en sorte que vos messages ne soient imprimés sur la console que lorsque le débogage des balises sera activé.

propertySettings

console.log(turbine.propertySettings.domains);

Un objet contenant les paramètres suivants définis par lʼutilisateur pour la propriété de la bibliothèque dʼexécution des balises actuelle :

  • propertySettings.domains: Array<String>

    Tableau de domaines couverts par la propriété.

  • propertySettings.undefinedVarsReturnEmpty: boolean

    Les développeurs d’extensions ne doivent pas se préoccuper de ce paramètre.

Sur cette page