O objeto turbine
é uma "variável livre" no escopo dos módulos de biblioteca da extensão. Ela fornece informações e utilitários específicos ao tempo de execução do Adobe Experience Platform Launch e está sempre disponível para módulos de biblioteca sem usar require()
.
console.log(turbine.buildInfo.turbineBuildDate);
turbine.buildInfo
é um objeto que contém informações de build sobre a biblioteca de tempo de execução atual do Platform Launch.
{
turbineVersion: "14.0.0",
turbineBuildDate: "2016-07-01T18:10:34Z",
buildDate: "2016-03-30T16:27:10Z",
environment: "development"
}
Propriedade | Descrição |
---|---|
turbineVersion |
A versão Turbine usada dentro da biblioteca atual. |
turbineBuildDate |
A data da ISO 8601 quando a versão de Turbine usada no container foi criada. |
buildDate |
A data da ISO 8601 quando a biblioteca atual foi criada. |
environment |
O ambiente para o qual essa biblioteca foi criada. Os valores aceitos são development , staging e production . |
Se a depuração do Platform Launch está ativada no momento.
Se você está apenas tentando registrar mensagens, é improvável que precise usar isso. Em vez disso, sempre registre mensagens usando turbine.logger
e o Platform Launch garantirá que suas mensagens sejam impressas somente no console quando a depuração do Platform Launch estiver ativada.
console.log(turbine.getDataElementValue(dataElementName));
Retorna o valor de um elemento de dados.
var extensionSettings = turbine.getExtensionSettings();
Retorna o objeto de configurações salvo pela última vez na visualização de configuração de extensão.
Observe que os valores nas configurações retornadas podem ser provenientes de elementos de dados. Por isso, chamar getExtensionSettings()
em momentos diferentes poderá gerar resultados diferentes se os valores dos elementos de dados tiverem sido alterados. Para obter os valores mais atualizados, aguarde o máximo possível antes de chamar getExtensionSettings()
.
var loadScript = require('@adobe/reactor-load-script');
loadScript(turbine.getHostedLibFileUrl('AppMeasurement.js')).then(function() {
// Do something ...
})
A propriedade hostedLibFiles pode ser definida no manifesto da extensão para hospedar vários arquivos junto com a biblioteca de tempo de execução do Platform Launch. Este módulo retorna o URL no qual o arquivo de biblioteca especificado está hospedado.
var mcidInstance = turbine.getSharedModule('adobe-mcid', 'mcid-instance');
Recupera um módulo que foi compartilhado de outra extensão. Se nenhum módulo correspondente for encontrado, undefined
será retornado. Consulte Implementação de módulos compartilhados para obter mais informações sobre módulos compartilhados.
turbine.logger.error('Error!');
Utilitário de registro usado para registrar mensagens no console. As mensagens serão exibidas somente no console se a depuração for ativada pelo usuário. A maneira recomendada de ativar a depuração é usar o Adobe Experience Cloud Debugger ou a extensão Platform Launch e DTM Switch do Chrome. Como alternativa, o usuário pode executar o comando a seguir _satellite.setDebug(true)
no console de desenvolvimento do navegador. O agente de log tem os seguintes métodos:
logger.log(message: string)
: registra uma mensagem no console.logger.info(message: string)
: registra uma mensagem informativa no console.logger.warn(message: string)
: registra uma mensagem de aviso no console.logger.error(message: string)
: registra uma mensagem de erro no console.logger.debug(message: string)
: registra uma mensagem de depuração no console. (Visível somente quando o registro verbose
estiver ativado no console do navegador.)Se for passada uma função de retorno de chamada para turbine.onDebugChanged
, o Platform Launch chamará seu retorno de chamada sempre que a depuração for alternada. O Platform Launch passará um booliano para a função de retorno de chamada que será verdadeira se a depuração estiver ativada ou falsa se a depuração estiver desativada.
Se você está apenas tentando registrar mensagens, é improvável que precise usar isso. Em vez disso, sempre registre mensagens usando turbine.logger
e o Platform Launch garantirá que suas mensagens sejam impressas somente no console quando a depuração do Platform Launch estiver ativada.
console.log(turbine.propertySettings.domains);
Um objeto que contém as seguintes configurações definidas pelo usuário para a propriedade da biblioteca atual do tempo de execução do Platform Launch:
propertySettings.domains: Array<String>
Uma variedade de domínios que a propriedade abrange.
propertySettings.undefinedVarsReturnEmpty: boolean
Os desenvolvedores de extensões não devem se preocupar com esse cenário.