Turbinfri variabel

NOTE
Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. I följande dokument finns en konsoliderad referens till de ändrade terminologin.

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"
}
Egenskap
Beskrivning
turbineVersion
Den turbinversion som används i det aktuella biblioteket.
turbineBuildDate
ISO 8601-datumet när versionen av turbin som används i behållaren skapades.
buildDate
ISO 8601-datumet när det aktuella biblioteket skapades.

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"
}
Egenskap
Beskrivning
id
Miljöns ID.
stage
Den miljö som det här biblioteket skapades för. Möjliga värden är 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är verbose-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.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743