Variable sans Turbine

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 de balise 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"
}

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

debugEnabled

Valeur booléenne 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 get-extension-settings

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 get-hosted-lib-file

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 shared

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 la variable Adobe Experience Platform 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 :

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

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 :