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 au runtime Adobe Experience Platform Launch 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 du runtime Platform Launch.

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z",
    environment: "development"
}
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 Environnement pour lequel cette bibliothèque a été créée. Les valeurs acceptées sont development, staging et production.

debugEnabled

Indique si le débogage de Platform Launch est 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 et de Platform Launch afin de vous assurer qu’ils ne sont imprimés sur la console que lorsque le débogage de Platform Launch 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, veuillez patienter autant 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 Platform Launch. 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!');

Utilitaire de journalisation 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 l’extension Chrome Adobe Experience Cloud Debugger ou Platform Launch et DTM Switch. L’utilisateur peut également exécuter la commande suivante _satellite.setDebug(true) dans la console de développement 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.)

onDebugChanged

En transmettant une fonction de rappel dans turbine.onDebugChanged, Platform Launch appelle votre rappel chaque fois que le débogage est activé/désactivé. Platform Launch transmet 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, enregistrez toujours les messages à l’aide de turbine.logger et Platform Launch fera en sorte que vos messages ne soient imprimés sur la console que lorsque le débogage de Platform Launch 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 du runtime Platform Launch 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

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now