Variabile libera “turbine”

NOTA

Adobe Experience Platform Launch viene riclassificato come una suite di tecnologie di raccolta dati nell’Experience Platform. Queste modifiche verranno implementate in tutta la documentazione del prodotto nelle prossime settimane. Fare riferimento al seguente documento per un riferimento consolidato delle modifiche terminologiche.

L’oggetto turbine rappresenta una “variabile libera” nell’ambito dei moduli libreria dell’estensione. Fornisce informazioni e utility specifiche per il runtime di Adobe Experience Platform Launch ed è sempre disponibile per i moduli libreria senza che sia necessario utilizzare require().

buildInfo

console.log(turbine.buildInfo.turbineBuildDate);

turbine.buildInfo è un oggetto che contiene informazioni sulla versione attuale della libreria runtime di Platform Launch.

{
    turbineVersion: "14.0.0",
    turbineBuildDate: "2016-07-01T18:10:34Z",
    buildDate: "2016-03-30T16:27:10Z",
    environment: "development"
}
Proprietà Descrizione
turbineVersion La versione di Turbine utilizzata all'interno della libreria corrente.
turbineBuildDate La data di creazione della versione di Turbine utilizzata all'interno del contenitore in formato ISO 8601.
buildDate La data di creazione della libreria corrente in formato ISO 8601.
environment L'ambiente per il quale è stata generata la libreria. I valori accettati sono development, staging e production.

debugEnabled

Indica se il debug di Platform Launch è attualmente abilitato.

Se intendi semplicemente registrare i messaggi, probabilmente non dovrai utilizzarlo. Piuttosto, per registrare i messaggi utilizza sempre turbine.logger: Platform Launch farà sì che i messaggi vengano riportati nella console solo quando è abilitato il debug di Platfom Launch.

getDataElementValue

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

Restituisce il valore di un elemento dati.

getExtensionSettings

var extensionSettings = turbine.getExtensionSettings();

Restituisce l’ultimo oggetto impostazioni salvato dalla vista di configurazione delle estensioni.

I valori negli oggetti impostazioni restituiti potrebbero provenire da elementi di dati. Per questo motivo, se richiami getExtensionSettings() in momenti diversi potresti ottenere risultati diversi, dovuti all’eventuale cambiamento dei valori degli elementi dati. Per ottenere i valori più aggiornati, attendi il più tardi possibile prima di richiamare getExtensionSettings().

getHostedLibFileUrl

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

La proprietà hostedLibFiles può essere definita nel manifesto dell’estensione in modo da includere vari file oltre alla libreria runtime di Platform Launch. Questo modulo restituisce l’URL in cui è ospitato il file libreria specificato.

getSharedModule

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

Recupera un modulo che è stato condiviso da un’altra estensione. Se non viene trovato alcun modulo corrispondente, verrà restituito undefined. Per ulteriori informazioni sui moduli condivisi, consulta Implementazione di moduli condivisi.

logger

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

Utility di registrazione utilizzata per registrare i messaggi nella console. I messaggi vengono mostrati nella console solo se il debug è attivato dall’utente. Per attivare il debug, si consiglia di utilizzare l’estensione Adobe Experience Cloud Debugger oppure Platform Launch e l’estensione DTM Switch di Chrome. In alternativa, è possibile eseguire il comando seguente nella console di sviluppo del browser: _satellite.setDebug(true). Il logger dispone dei seguenti metodi:

  • logger.log(message: string): registra un messaggio nella console.
  • logger.info(message: string): registra un messaggio informativo nella console.
  • logger.warn(message: string): registra un messaggio di avvertenza nella console.
  • logger.error(message: string): registra un messaggio di errore nella console.
  • logger.debug(message: string): registra un messaggio di debug nella console. (Visibile solo se la registrazione verbose è abilitata nella console del browser.)

onDebugChanged

Quando si trasmette una funzione di callback in turbine.onDebugChanged, Platform Launch richiamerà il callback ogni volta che viene attivato il debug. Platform Launch trasmette un valore booleano alla funzione di callback che sarà true se il debug è abilitato o false se è disabilitato.

Se intendi semplicemente registrare i messaggi, probabilmente non dovrai utilizzarlo. Piuttosto, per registrare i messaggi utilizza sempre turbine.logger: Platform Launch farà sì che i messaggi vengano riportati nella console solo quando è abilitato il debug di Platfom Launch.

propertySettings

console.log(turbine.propertySettings.domains);

Oggetto contenente le seguenti impostazioni definite dall’utente per la proprietà della libreria runtime attuale di Platform Launch:

  • propertySettings.domains: Array<String>

    Array di domini coperti dalla proprietà.

  • propertySettings.undefinedVarsReturnEmpty: boolean

    Questa impostazione non dovrebbe interessare gli sviluppatori di estensioni.

In questa pagina