Variable gratuita Turbine
El objeto turbine
es una "variable gratuita" que entra en el ámbito de los módulos de biblioteca de su extensión. Esta variable proporciona información y utilidades específicas al tiempo de ejecución de la etiqueta de Adobe Experience Platform y siempre está disponible para los módulos de biblioteca sin utilizar require()
.
buildInfo
console.log(turbine.buildInfo.turbineBuildDate);
turbine.buildInfo
es un objeto que contiene información de compilación sobre la biblioteca actual de tiempo de ejecución de etiquetas.
{
turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z"
}
environment
console.log(turbine.environment.stage);
turbine.environment
es un objeto que contiene información sobre el entorno en el que está implementada la biblioteca.
{
id: "ENbe322acb4fc64dfdb603254ffe98b5d3",
stage: "development"
}
id
stage
development
, staging
y production
.debugEnabled
Un valor booleano que indica si la depuración de etiquetas está habilitada actualmente.
Si simplemente intenta registrar mensajes, es poco probable que tenga que utilizar este recurso. En su lugar, registre siempre los mensajes con turbine.logger
para garantizar que los mensajes se impriman únicamente en la consola cuando la depuración de etiquetas esté habilitada.
getDataElementValue
console.log(turbine.getDataElementValue(dataElementName));
Devuelve el valor de un elemento de datos.
getExtensionSettings
get-extension-settings
var extensionSettings = turbine.getExtensionSettings();
Devuelve el objeto de configuración que se guardó por última vez desde la vista de configuración de la extensión.
Tenga en cuenta que los valores de los objetos de configuración devueltos pueden proceder de elementos de datos. Por esta razón, realizar llamadas a getExtensionSettings()
en diferentes momentos puede generar resultados diferentes si los valores de los elementos de datos han cambiado. Para obtener los valores más actualizados, espere lo más tarde posible antes de llamar a getExtensionSettings()
.
getHostedLibFileUrl
get-hosted-lib-file
var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
// Do something ...
})
La propiedad hostedLibFiles se puede definir dentro del manifiesto de extensión para alojar varios archivos junto con la biblioteca de tiempo de ejecución de etiquetas. Este módulo devuelve la URL donde se aloja el archivo de biblioteca determinado.
getSharedModule
shared
var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');
Recupera un módulo que se ha compartido desde otra extensión. Si no se encuentra ningún módulo coincidente, se devolverá undefined
. Consulte Implementación de módulos compartidos para obtener más información sobre los módulos compartidos.
logger
turbine.logger.error('Error!');
Utilidad de registro utilizada para registrar mensajes en la consola. Los mensajes solo se mostrarán en la consola si el usuario ha activado la depuración. La manera recomendada de activar la depuración es usar el Adobe Experience Platform Debugger. Como alternativa, el usuario puede ejecutar el siguiente comando _satellite.setDebug(true)
en la consola de desarrollo del explorador. El registrador tiene los métodos siguientes:
logger.log(message: string)
: Registra un mensaje en la consola.logger.info(message: string)
: Registra un mensaje informativo en la consola.logger.warn(message: string)
: Registra un mensaje de advertencia en la consola.logger.error(message: string)
: Registra un mensaje de error en la consola.logger.debug(message: string)
: Registra un mensaje de depuración en la consola. (Solo visible cuando el registroverbose
está habilitado en la consola del explorador.)logger.deprecation(message: string)
: Registra un mensaje de advertencia en la consola, independientemente de si el usuario ha habilitado o no la depuración de etiquetas.
onDebugChanged
Al pasar una función de llamada de retorno a turbine.onDebugChanged
, las etiquetas se conectarán con la llamada de retorno siempre que se alterne la depuración. Las etiquetas pasarán un valor booleano a la función de llamada de retorno que será verdadero si la depuración estaba habilitada, o falso si la depuración no estaba habilitada.
Si simplemente intenta registrar mensajes, es poco probable que tenga que utilizar este recurso. En su lugar, registre siempre los mensajes con turbine.logger
y las etiquetas se asegurarán de que los mensajes se impriman únicamente en la consola cuando la depuración de etiquetas esté habilitada.
propertySettings
property-settings
console.log(turbine.propertySettings.domains);
Objeto que contiene la siguiente configuración definida por el usuario para la propiedad de la biblioteca actual de tiempo de ejecución de etiquetas:
-
propertySettings.domains: Array<String>
Matriz de dominios que cubre la propiedad.
-
propertySettings.undefinedVarsReturnEmpty: boolean
Los desarrolladores de extensiones no deben preocuparse por esta configuración.