Variabili nei flussi di lavoro AEM

Ultimo aggiornamento: 4 febbraio 2025

Creato per:

  • Sviluppatore

Una variabile in un modello di flusso di lavoro è un modo per memorizzare un valore in base al relativo tipo di dati. Puoi quindi utilizzare il nome della variabile in qualsiasi passaggio del flusso di lavoro per recuperare il valore memorizzato nella variabile. È inoltre possibile utilizzare i nomi delle variabili per definire le espressioni per l'adozione delle decisioni di instradamento.

Nei modelli di flusso di lavoro dell’AEM puoi effettuare le seguenti operazioni:

  • Creare una variabile di un tipo di dati in base al tipo di informazioni che si desidera memorizzare.
  • Impostare un valore per la variabile utilizzando il passaggio del flusso di lavoro Imposta variabile.
  • Utilizzare la variabile nei passaggi del flusso di lavoro OR Split e Goto AEM in modo da poter definire un'espressione per prendere decisioni di indirizzamento. Puoi anche utilizzare le variabili in tutti i passaggi del flusso di lavoro di AEM Forms.

Il video seguente illustra come creare, impostare e utilizzare le variabili nei modelli di flusso di lavoro AEM:

Le variabili sono un'estensione dell'interfaccia MetaDataMap. È possibile utilizzare MetaDataMap in ECMAScript per accedere ai metadati salvati utilizzando le variabili.

Creare una variabile

Puoi creare le variabili utilizzando la sezione Variabili disponibile nella barra laterale del modello di flusso di lavoro. Le variabili del flusso di lavoro AEM supportano i seguenti tipi di dati:

  • Tipi di dati di base: Long, Double, Boolean, Date e String
  • Tipi di dati complessi: XML e JSON
NOTE
I flussi di lavoro supportano solo il formato ISO8601 per le variabili di tipo Data.

Per ulteriori tipi di dati complessi disponibili nei flussi di lavoro AEM Forms, vedi Variabili nei flussi di lavoro AEM Forms. Utilizzare il tipo di dati ArrayList per creare raccolte di variabili. È possibile creare una variabile ArrayList per tutti i tipi di dati primitivi e complessi. Ad esempio, creare una variabile ArrayList e selezionare Stringa come sottotipo per memorizzare più valori stringa utilizzando la variabile.

Per creare una variabile:

  1. In un’istanza AEM, passa a Strumenti > Flusso di lavoro > Modelli.

  2. Seleziona Crea e specifica il titolo e un nome facoltativo per il modello di flusso di lavoro. Selezionare il modello e selezionare Modifica.

  3. Seleziona l'icona delle variabili disponibile nella barra laterale del modello di flusso di lavoro e seleziona Aggiungi variabile.

    Aggiungi variabile

  4. Nella finestra di dialogo Aggiungi variabile, specifica il nome e seleziona il tipo di variabile.

  5. Selezionare il tipo di dati dall'elenco a discesa Tipo e specificare i valori seguenti:

    • Tipo di dati primitivo: specifica un valore predefinito facoltativo per la variabile.
    • JSON o XML: specifica un percorso JSON o schema XML facoltativo. Il sistema convalida il percorso dello schema durante la mappatura e l'archiviazione delle proprietà disponibili in questo schema in un'altra variabile.
    • Modello dati modulo: specifica un percorso per il modello dati modulo.
    • ArrayList - Specificare un sottotipo per la raccolta.

  6. Specificare una descrizione facoltativa per la variabile e selezionare Icona Salva indicata da un segno di spunta allinterno di una casella. per salvare le modifiche. La variabile viene visualizzata nell’elenco disponibile nel riquadro a sinistra.

Quando crei delle variabili, prendi in considerazione le seguenti procedure:

  • Crea tutte le variabili necessarie per un flusso di lavoro. Tuttavia, per conservare le risorse del database, utilizza il numero minimo di variabili richieste e, se possibile, riutilizza le variabili.
  • Per le variabili viene fatta distinzione tra maiuscole e minuscole. Assicurati di fare riferimento alle variabili utilizzando la stessa maiuscola/minuscola nel flusso di lavoro.
  • Evita di usare caratteri speciali nel nome della variabile

Imposta una variabile

È possibile utilizzare il passo Imposta variabile per impostare il valore di una variabile e definire l'ordine in cui i valori vengono impostati. La variabile viene impostata nell’ordine in cui le mappature delle variabili sono elencate nel passaggio Imposta variabile.

Le modifiche ai valori delle variabili influiscono solo sull'istanza del processo in cui si verifica la modifica. Ad esempio, quando viene avviato un flusso di lavoro e i dati delle variabili cambiano, le modifiche influiscono solo su tale istanza del flusso di lavoro. Le modifiche non influiscono su altre istanze del flusso di lavoro avviate in precedenza o in un secondo momento.

A seconda del tipo di dati della variabile, puoi utilizzare le seguenti opzioni per impostare il valore di una variabile:

  • Valore letterale: Utilizzare l'opzione quando si conosce il valore esatto da specificare.
  • Espressione: Utilizzare l'opzione quando il valore da utilizzare viene calcolato in base a un'espressione. L’espressione viene creata nell’editor di espressioni fornito.
  • Notazione punti JSON: Utilizzare l'opzione per recuperare un valore da una variabile di tipo JSON o FDM.
  • XPATH: Utilizzare l'opzione per recuperare un valore da una variabile di tipo XML.
  • Relativo al payload: Utilizzare l'opzione quando il valore da salvare nella variabile è disponibile in un percorso relativo al payload.
  • Percorso assoluto: Utilizzare l'opzione quando il valore da salvare nella variabile è disponibile in un percorso assoluto.

È inoltre possibile aggiornare elementi specifici di una variabile di tipo JSON o XML utilizzando la notazione JSON DOT o XPATH.