Turbinfri variabel
Objektet turbine
är en"kostnadsfri variabel" inom omfånget för tilläggets biblioteksmoduler. Den innehåller information och verktyg som är specifika för tagghanteringen i Adobe Experience Platform och är alltid tillgänglig för biblioteksmoduler utan att använda require()
.
buildInfo
console.log(turbine.buildInfo.turbineBuildDate);
turbine.buildInfo
är ett objekt som innehåller bygginformation om det aktuella biblioteket för tagg-körning.
{
turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z"
}
turbineVersion
turbineBuildDate
buildDate
environment
console.log(turbine.environment.stage);
turbine.environment
är ett objekt som innehåller information om miljön som biblioteket distribueras på.
{
id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
stage: "development"
}
id
stage
development
, staging
och production
.debugEnabled
Ett booleskt värde som anger om taggfelsökning är aktiverat.
Om du bara försöker logga meddelanden är det osannolikt att du kommer att behöva använda detta. I stället loggar du alltid meddelanden med turbine.logger
för att försäkra dig om att dina meddelanden bara skrivs ut till konsolen när taggfelsökning är aktiverat.
getDataElementValue
console.log(turbine.getDataElementValue(dataElementName));
Returnerar värdet för ett dataelement.
getExtensionSettings
get-extension-settings
var extensionSettings = turbine.getExtensionSettings();
Returnerar inställningsobjektet som senast sparades från vyn tilläggskonfiguration.
Observera att värden inom de returnerade inställningsobjekten kan komma från dataelement. Därför kan anrop av getExtensionSettings()
vid olika tillfällen ge olika resultat om dataelementens värden har ändrats. Om du vill hämta de senaste värdena väntar du så länge som möjligt innan du anropar getExtensionSettings()
.
getHostedLibFileUrl
get-hosted-lib-file
var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
// Do something ...
})
Egenskapen hostedLibFiles kan definieras inuti tilläggsmanifestet för att kunna lagra olika filer tillsammans med taggens körningsbibliotek. Den här modulen returnerar den URL där den angivna biblioteksfilen finns.
getSharedModule
shared
var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');
Hämtar en modul som har delats från ett annat tillägg. Om ingen matchande modul hittas returneras undefined
. Mer information om delade moduler finns i Implementera delade moduler.
logger
turbine.logger.error('Error!');
Loggningsverktyget används för att logga meddelanden till konsolen. Meddelanden visas bara i konsolen om användaren har aktiverat felsökning. Det rekommenderade sättet att aktivera felsökning är att använda Adobe Experience Platform Debugger. Som ett alternativ kan användaren köra följande kommando _satellite.setDebug(true)
i webbläsarens utvecklarkonsol. Loggaren har följande metoder:
logger.log(message: string)
: Loggar ett meddelande till konsolen.logger.info(message: string)
: Loggar ett informationsmeddelande till konsolen.logger.warn(message: string)
: Loggar ett varningsmeddelande till konsolen.logger.error(message: string)
: Loggar ett felmeddelande till konsolen.logger.debug(message: string)
: Loggar ett felsökningsmeddelande till konsolen. (Synligt bara närverbose
-loggning är aktiverad i webbläsarkonsolen.)logger.deprecation(message: string)
: Loggar ett varningsmeddelande till konsolen oavsett om taggfelsfunktionen är aktiverad av användaren eller inte.
onDebugChanged
Genom att skicka en återanropsfunktion till turbine.onDebugChanged
kommer taggarna att anropa återanropet när felsökningen är aktiverad. Taggar skickar ett booleskt värde till återanropsfunktionen som är true om felsökning var aktiverat eller false om felsökning var inaktiverad.
Om du bara försöker logga meddelanden är det osannolikt att du kommer att behöva använda detta. I stället loggar du alltid meddelanden med turbine.logger
och taggar så att dina meddelanden bara skrivs ut till konsolen när taggfelsfunktionen är aktiverad.
propertySettings
property-settings
console.log(turbine.propertySettings.domains);
Ett objekt som innehåller följande inställningar som definieras av användaren för egenskapen i det aktuella taggredigeringsbiblioteket:
-
propertySettings.domains: Array<String>
En array med domäner som egenskapen omfattar.
-
propertySettings.undefinedVarsReturnEmpty: boolean
Tilläggsutvecklare bör inte bry sig om den här inställningen.