Utilizzare i codici JavaScript
Informazioni sui codici JavaScript
I codici JavaScript ti consentono di creare funzioni riutilizzabili che possono essere utilizzate nei vari flussi di lavoro, in modo simile a una libreria. Queste funzioni sono memorizzate nel menu Amministrazione > Codici JavaScript nel riquadro di navigazione a sinistra.
Nell'elenco Codici di JavaScript è possibile:
- Duplicare o eliminare un codice: fare clic sul pulsante con i puntini di sospensione e selezionare l'azione desiderata.
- Modificare un codice: fare clic sul nome di un codice per aprirne le proprietà. Apporta le modifiche e salva.
- Crea un nuovo codice JavaScript: fare clic sul pulsante Crea codice JavaScript.
Creare un codice JavaScript
Per creare un codice JavaScript, effettua le seguenti operazioni:
-
Passare al menu Codici JavaScript e fare clic sul pulsante Crea codice JavaScript.
-
Definisci le proprietà del codice:
- Spazio dei nomi: specifica lo spazio dei nomi relativo alle risorse personalizzate. Per impostazione predefinita, lo spazio dei nomi è "cus", ma può variare a seconda dell’implementazione.
- Nome: identificatore univoco da utilizzare per fare riferimento al codice.
- Etichetta: etichetta descrittiva da visualizzare nell'elenco dei codici di JavaScript.
NOTE
Una volta creati, i campi Spazio dei nomi e Nome non possono essere modificati. Per apportare modifiche, duplica il codice e aggiornalo in base alle esigenze.Nella console Campaign, il nome del codice JavaScript viene visualizzato come una concatenazione di questi due campi. -
Fai clic sul pulsante Crea codice per definire il codice JavaScript. Il riquadro a sinistra include due menu che consentono di utilizzare funzioni predefinite relative alle condizioni e alla formattazione della data.
-
Fai clic su Conferma per salvare il codice.
-
Quando il codice JavaScript è pronto, fai clic su Crea. Il codice JavaScript è ora disponibile per l’utilizzo in tutti i flussi di lavoro.
Utilizzare un codice JavaScript da un flusso di lavoro
Caricare librerie di codice di JavaScript
Puoi fare riferimento ai codici JavaScript nei flussi di lavoro per evitare di riscrivere il codice per attività ripetitive. Per utilizzare questi codici, devi innanzitutto caricare la libreria corrispondente nello script di inizializzazione del flusso di lavoro. Ciò ti consente di caricare tutte le librerie contenenti le funzioni che desideri utilizzare nel flusso di lavoro una sola volta.
Per caricare una libreria, effettua le seguenti operazioni:
-
Apri un flusso di lavoro e fai clic sul pulsante Impostazioni.
-
Passare alla sezione Script di inizializzazione e fare clic su Crea codice.
-
Utilizza la sintassi seguente nel codice per caricare una libreria:
loadLibrary("/<namespace>/<name>")
- Sostituisci
<namespace>
con lo spazio dei nomi specificato durante la creazione del codice JavaScript. - Sostituisci
<name>
con il nome del codice JavaScript.
- Sostituisci
-
Fai clic su Conferma e salva le impostazioni.
Funzioni di riferimento nei flussi di lavoro
Una volta caricata la libreria JavaScript, puoi fare riferimento alle funzioni definite nel codice JavaScript direttamente all'interno del flusso di lavoro, in genere utilizzando un'attività Codice JavaScript.