Freie turbine-Variable

Das turbine-Objekt ist eine „freie Variable“ im Gültigkeitsbereich der Bibliotheksmodule Ihrer Erweiterung. Es stellt Informationen und Dienstprogramme bereit, die für die Tag-Laufzeit von Adobe Experience Platform spezifisch sind, und ist ohne Verwendung von require() für Bibliotheksmodule immer verfügbar.

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo ist ein Objekt, das Build-Informationen zur aktuellen Tag-Laufzeitbibliothek enthält.

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z"
}

environment

console.log(turbine.environment.stage);

turbine.environment ist ein Objekt, das Informationen über die Umgebung enthält, in der die Bibliothek bereitgestellt wird.

{
    id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
    stage: "development"
}

debugEnabled

Ein boolescher Wert, der angibt, ob das Tag-Debugging derzeit aktiviert ist.

Wenn Sie einfach Meldungen protokollieren möchten, ist es unwahrscheinlich, dass Sie dies verwenden müssen. Stattdessen sollten Sie Meldungen immer mit turbine.logger protokollieren, um sicherzustellen, dass Ihre Meldungen nur auf der Konsole ausgegeben werden, wenn Tag-Debugging aktiviert ist.

getDataElementValue

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

Gibt den Wert eines Datenelements zurück.

getExtensionSettings get-extension-settings

var extensionSettings = turbine.getExtensionSettings();

Gibt das Einstellungsobjekt zurück, das zuletzt in der Ansicht für die Erweiterungskonfiguration gespeichert wurde.

Beachten Sie, dass die Werte in den zurückgegebenen Einstellungsobjekten möglicherweise von Datenelementen stammen. Deshalb kann der Aufruf von getExtensionSettings() zu unterschiedlichen Zeitpunkten zu unterschiedlichen Ergebnissen führen, wenn sich die Werte der Datenelemente geändert haben. Um die aktuellsten Werte zu erhalten, warten Sie mit dem Aufruf von getExtensionSettings() so lange wie möglich.

getHostedLibFileUrl get-hosted-lib-file

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

Die Eigenschaft hostedLibFiles kann im Erweiterungsmanifest definiert werden, um verschiedene Dateien zusammen mit der Tag-Laufzeitbibliothek zu hosten. Dieses Modul gibt die URL zurück, unter der die angegebene Bibliotheksdatei gehostet wird.

getSharedModule shared

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

Ruft ein Modul ab, das von einer anderen Erweiterung freigegeben wurde. Wenn kein passendes Modul gefunden wird, wird undefined zurückgegeben. Weitere Informationen zu freigegebenen Modulen finden Sie unter Implementieren freigegebener Module.

logger

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

Das Protokollierungsdienstprogramm wird verwendet, um Meldungen auf der Konsole zu protokollieren. Meldungen werden nur dann auf der Konsole angezeigt, wenn der Benutzer den Debugging-Modus aktiviert hat. Die empfohlene Methode zum Aktivieren des Debuggens besteht in der Verwendung des Adobe Experience Platform Debuggers. Alternativ kann der Benutzer den Befehl _satellite.setDebug(true) in der Browser-Entwicklungskonsole ausführen. Die logger-Funktion verfügt über die folgenden Methoden:

onDebugChanged

Wenn eine Callback-Funktion an turbine.onDebugChanged übergeben wird, ruft Tags diesen Rückruf auf, sobald der Debugging-Modus aktiviert bzw. deaktiviert wird. Tags übergibt der Callback-Funktion einen booleschen Wert. Bei aktiviertem Debugging lautet dieser Wert „true“ und bei deaktiviertem Debugging „false“.

Wenn Sie einfach Meldungen protokollieren möchten, ist es unwahrscheinlich, dass Sie dies verwenden müssen. Stattdessen sollten Sie Meldungen immer mit turbine.logger protokollieren. Tags stellt dann sicher, dass die Meldungen nur dann auf der Konsole ausgegeben werden, wenn der Tag-Debugging-Modus aktiviert ist.

propertySettings property-settings

console.log(turbine.propertySettings.domains);

Ein Objekt, das die folgenden Einstellungen enthält, die vom Benutzer für die Eigenschaft der aktuellen Tag-Laufzeitbibliothek definiert werden: