turbine 自由変数

turbine オブジェクトは、拡張機能のライブラリモジュールの範囲内の「自由変数」です。これは Adobe Experience Platform Launch ランタイム専用の情報とユーティリティを提供し、require() を使用しなくても、常にライブラリモジュールで使用できます。

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo は、現在の Platform Launch ランタイムライブラリに関するビルド情報を含むオブジェクトです。

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z",
    environment: "development"
}
プロパティ 説明
turbineVersion 現在のライブラリ内で使用されている Turbine バージョン。
turbineBuildDate コンテナ内で使用されている Turbine のバージョンが作成された日付(ISO 8601 形式)。
buildDate 現在のライブラリが構築された日付(ISO 8601 形式)。
environment このライブラリが構築された環境。指定できる値は、developmentstagingproduction です。

debugEnabled

Platform Launch のデバッグが現在有効になっているかどうかを示します。

メッセージをログに記録するだけの場合、これを使用する必要はありません。代わりに、常に turbine.logger を使用してメッセージをログに記録します。Platform Launch のデバッグが有効な場合、メッセージはコンソールに表示されるだけです。

getDataElementValue

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

データ要素の値が返されます。

getExtensionSettings

var extensionSettings = turbine.getExtensionSettings();

拡張機能の設定ビューから最後に保存された設定オブジェクトが返されます。

返される設定オブジェクト内の値は、データ要素から取得した値である可能性があることに注意してください。このため、データ要素の値が変更されている場合、異なる時間に getExtensionSettings() を呼び出すと、違う結果が返されることがあります。最新の値を取得するには、できるだけ遅くまで待ってから、getExtensionSettings() を呼び出してください。

getHostedLibFileUrl

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

hostedLibFiles プロパティを拡張機能マニフェスト内で定義して、Platform Launch ランタイムライブラリと共に様々なファイルをホストすることができます。このモジュールによって、指定されたライブラリファイルがホストされている URL が返されます。

getSharedModule

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

別の拡張機能から共有されているモジュールが取得されます。一致するモジュールが見つからない場合は、undefined が返されます。共有モジュールの詳細については、共有モジュールの実装に関するページを参照してください。

logger

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

メッセージをコンソールに記録する際に使用されるログユーティリティ。ユーザーがデバッグを有効にしている場合、メッセージはコンソールのみに表示されます。デバッグを有効にするには、Adobe Experience Cloud Debugger または Platform Launch and DTM Switch Chrome 拡張機能を使用することをお勧めします。別の方法として、ユーザーはブラウザ開発コンソール内でコマンド _satellite.setDebug(true) を実行できます。ロガーには次のメソッドがあります。

  • logger.log(message: string):コンソールにメッセージを記録します。
  • logger.info(message: string):コンソールに情報メッセージを記録します。
  • logger.warn(message: string):コンソールに警告メッセージを記録します。
  • logger.error(message: string):コンソールにエラーメッセージを記録します。
  • logger.debug(message: string):デバッグメッセージをコンソールに記録します。(ブラウザーコンソール内でverbose ログが有効になっている場合にのみ表示されます)

onDebugChanged

コールバック関数を turbine.onDebugChanged に渡すと、Platform Launch は、デバッグが切り替えられるたびにコールバックを呼び出します。Platform Launch は、デバッグが有効な場合は true、デバッグが無効な場合は false のブール値をコールバック関数に渡します。

メッセージをログに記録するだけの場合、これを使用する必要はありません。代わりに、常に turbine.logger を使用してメッセージをログに記録します。Platform Launch のデバッグが有効な場合、メッセージはコンソールにのみ表示されます。

propertySettings

console.log(turbine.propertySettings.domains);

現在の Platform Launch ランタイムライブラリのプロパティに対してユーザーが定義する次の設定を含むオブジェクト:

  • propertySettings.domains: Array<String>

    プロパティの対象となるドメインの配列です。

  • propertySettings.undefinedVarsReturnEmpty: boolean

    拡張機能の開発者は、この設定を気に掛ける必要はありません。

このページ