Variabili nei flussi di lavoro AEM Forms

Una variabile in un modello di flusso di lavoro è un modo per memorizzare un valore in base al suo 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 prendere decisioni di indirizzamento.

Nei modelli AEM flusso di lavoro puoi:

• Creare una variabile di un tipo di dati in base al tipo di informazioni che si desidera memorizzare in esso.
• Imposta un valore per la variabile mediante il passaggio del flusso di lavoro Imposta variabile .
• Utilizza la variabile in tutti i passaggi del flusso di lavoro di AEM Forms per recuperare il valore memorizzato e nei passaggi di divisione e visita OR per definire un'espressione di indirizzamento.

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

Le variabili sono un'estensione dell'esistente MetaDataMap interfaccia. È 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. AEM variabili del flusso di lavoro supportano i seguenti tipi di dati:

• Tipi di dati principali: Long, Double, Boolean, Date e String
• Tipi di dati complessi: Documento, XML, JSON, e l’istanza del modello dati del modulo.

Richiedi Pacchetto aggiuntivo di AEM Forms per i tipi di dati Document e Form Data Model. 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 .

Esegui i seguenti passaggi per creare una variabile:

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

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

3. Tocca l’icona delle variabili disponibile nella barra laterale del modello di flusso di lavoro e tocca Aggiungi variabile.

   

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

5. Seleziona il tipo di dati dal Tipo elenco a discesa e specifica i seguenti valori:

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

6. Specifica una descrizione facoltativa per la variabile e tocca per salvare le modifiche. La variabile viene visualizzata nell’elenco disponibile nel riquadro a sinistra.

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

• 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 riutilizza le variabili quando possibile.
• Le variabili sono sensibili all’uso di maiuscole e minuscole. Assicurati di fare riferimento alle variabili utilizzando lo stesso caso nel flusso di lavoro.
• Evita di usare caratteri speciali nel nome della variabile

Imposta una variabile

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

Le modifiche ai valori delle variabili influiscono solo sull'istanza del processo in cui avviene la modifica. Ad esempio, quando un flusso di lavoro viene avviato e i dati delle variabili cambiano, le modifiche influiscono solo sull’istanza del flusso di lavoro. Le modifiche non influiscono su altre istanze del flusso di lavoro che sono state avviate in precedenza o che sono state avviate successivamente.

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

• Letterale: Utilizza l’opzione quando conosci il valore esatto da specificare.

• Espressione: Utilizza l’opzione quando il valore da utilizzare viene calcolato in base a un’espressione. L’espressione viene creata nell’editor di espressioni fornito.

• Notazione punto JSON: Utilizza 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: Utilizza l’opzione quando il valore da salvare nella variabile è disponibile in un percorso relativo al payload.

• Percorso assoluto: Utilizza 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 DOT JSON o XPATH.

Aggiungi mappatura tra variabili

Esegui i seguenti passaggi per aggiungere la mappatura tra le variabili:

1. Nella pagina di modifica del flusso di lavoro, tocca l’icona Passaggi disponibile nella barra laterale del modello di flusso di lavoro.
2. Trascina e rilascia la Imposta variabile passa all’editor del flusso di lavoro, tocca il passaggio e seleziona (Configura).
3. Nella finestra di dialogo Imposta variabile, seleziona Mappatura > Aggiungi mappatura.
4. In Variabile mappa , seleziona la variabile da memorizzare i dati, seleziona la modalità di mappatura e specifica un valore da memorizzare nella variabile . Le modalità di mappatura variano in base al tipo di variabile.
5. Mappa più variabili per creare un’espressione significativa. Tocca per salvare le modifiche.

Esempio 1: Eseguire una query su una variabile XML per impostare il valore di una variabile stringa

Selezionare una variabile di tipo XML per memorizzare un file XML. Eseguire una query sulla variabile XML per impostare il valore di una variabile stringa per la proprietà disponibile nel file XML. Utilizzo Specifica XPATH per la variabile XML per definire la proprietà da memorizzare nella variabile stringa.

In questo esempio, seleziona una formdata Variabile XML in cui memorizzare cc-app.xml file. Eseguire una query formdata per impostare il valore per indirizzo email variabile stringa per memorizzare il valore per emailAddress disponibile nella cc-app.xml file.

Esempio 2: Utilizza un’espressione per memorizzare un valore basato su altre variabili

Utilizza un'espressione per calcolare la somma delle variabili e memorizzare il risultato in una variabile.

In questo esempio, utilizza l’editor di espressioni per definire un’espressione per calcolare la somma di assetscost e saldo e memorizza il risultato in total value variabile.

Utilizza editor di espressioni

Puoi inoltre utilizzare le espressioni per calcolare il valore di una variabile in fase di runtime. Le variabili forniscono un editor di espressioni per definire le espressioni.

Utilizza l’editor di espressioni per:

• Imposta il valore delle variabili utilizzando altre variabili del flusso di lavoro, numeri o espressioni matematiche.
• Utilizzare variabili di flusso di lavoro, stringa, numero o espressione all’interno di un’espressione matematica
• Aggiungi condizioni per impostare valori di variabili.
• Aggiungi operatori tra condizioni.

Si basa sull’editor di regole dei moduli adattivi con le seguenti modifiche. Editor di regole nelle variabili:

• Non supporta le funzioni.
• Non fornisce un'interfaccia utente per visualizzare il riepilogo delle regole
• Non dispone di editor di codice.
• Non supporta l'abilitazione e la disattivazione del valore di un oggetto.
• Non supporta l'impostazione della proprietà di un oggetto.
• Non supporta la chiamata di un servizio Web.

Per ulteriori informazioni, consulta editor di regole per moduli adattivi.

Utilizzare una variabile

È possibile utilizzare le variabili per recuperare gli input e l’output o salvare il risultato di un passaggio. L’editor del flusso di lavoro fornisce due tipi di passaggi del flusso di lavoro:

• Passaggi del flusso di lavoro con supporto per le variabili
• Passaggi del flusso di lavoro senza supporto per le variabili

Passaggi del flusso di lavoro con supporto per le variabili

Il passaggio Vai a, O Dividi e tutti i passaggi del flusso di lavoro AEM Forms supportano le variabili.

Passaggio a divisione OR

La divisione OR crea una suddivisione nel flusso di lavoro, dopodiché è attivo un solo ramo. Questo passaggio ti consente di introdurre i percorsi di elaborazione condizionale nel flusso di lavoro. Puoi aggiungere i passaggi del flusso di lavoro a ogni ramo in base alle tue esigenze.

È possibile definire l'espressione di indirizzamento per un ramo utilizzando una definizione di regola, uno script ECMA o uno script esterno.

Puoi utilizzare le variabili per definire l’espressione di indirizzamento utilizzando l’editor di espressioni. Per ulteriori informazioni sull'utilizzo delle espressioni di indirizzamento per il passaggio Divisione OR, vedere Passaggio a divisione OR.

In questo esempio, prima di definire l'espressione di indirizzamento, utilizza esempio 2 per impostare il valore per total value variabile. La diramazione 1 è attiva se il valore della total value è maggiore di 50000. Allo stesso modo, è possibile definire una regola per rendere attivo il ramo 2 se il valore del total value è inferiore a 50000.

Analogamente, selezionare un percorso di script esterno o specificare lo script ECMA per le espressioni di routing per valutare il ramo attivo. Tocca Rinomina ramo per specificare un nome alternativo per il ramo.

Per ulteriori esempi, consulta Creare un modello di flusso di lavoro.

Vai al passaggio

La Passaggio Vai a consente di specificare il passaggio successivo nel modello di flusso di lavoro da eseguire, in base al risultato di un'espressione di indirizzamento.

Simile al passaggio di divisione OR, è possibile definire l'espressione di indirizzamento per il passaggio Goto utilizzando una definizione di regola, uno script ECMA o uno script esterno.

Puoi utilizzare le variabili per definire l’espressione di indirizzamento utilizzando l’editor di espressioni. Per ulteriori informazioni sull'utilizzo delle espressioni di indirizzamento per il passaggio Passaggio , vedi Passaggio Vai a.

In questo esempio, il passaggio Passaggio specifica l'applicazione con carta di credito di revisione come passaggio successivo se il valore per azioni intraprese è uguale a Ulteriori informazioni.

Per ulteriori esempi sull’utilizzo della definizione della regola nel passaggio Passaggio , vedi Simulazione di un ciclo For.

Passaggi del flusso di lavoro incentrati sul flusso di lavoro Forms

Tutti i passaggi del flusso di lavoro di AEM Forms supportano le variabili. Per ulteriori informazioni, consulta Flusso di lavoro incentrato su Forms su OSGi.

Passaggi del flusso di lavoro senza supporto per le variabili

È possibile utilizzare MetaDataMap per accedere alle variabili nei passaggi del flusso di lavoro che non supportano le variabili.

Recupera il valore della variabile

Utilizza le seguenti API nello script ECMA per recuperare i valori per le variabili esistenti in base al tipo di dati:

Richiedi Pacchetto aggiuntivo di AEM Forms per i tipi di dati variabili del modello dati documento e modulo.

Esempio

Recupera il valore del tipo di dati stringa utilizzando la seguente API:

workItem.getWorkflowData().getMetaDataMap().get(accname, Packages.java.lang.String)

Aggiorna il valore della variabile

Utilizza la seguente API nello script ECMA per aggiornare il valore di una variabile:

workItem.getWorkflowData().getMetaDataMap().put(variableName, value)

Esempio

workItem.getWorkflowData().getMetaDataMap().put(salary, 50000)

aggiorna il valore per stipendio a 50000.

Impostare le variabili per richiamare i flussi di lavoro

Puoi utilizzare un’API per impostare le variabili e trasmetterle alle istanze del flusso di lavoro.

workflowSession.startWorkflow utilizza model, wfData e metaData come argomenti. Utilizza MetaDataMap per impostare il valore della variabile.

In questa API, la variableName è impostata su value utilizzando metaData.put(variableName, value);

import com.adobe.granite.workflow.model.WorkflowModel;
import com.adobe.granite.workflow.metadata.MetaDataMap;
import com.adobe.aemfd.docmanager.Document;

/*Assume that you already have a workflowSession and modelId along with the payloadType and payload*/
WorkflowData wfData = workflowSession.newWorkflowData(payloadType, payload);
MetaDataMap metaData = wfData.getMetaDataMap();
metaData.put(variableName, value); //Create a variable "variableName" in your workflow model
WorkflowModel model = workflowSession.getModel(modelId);
workflowSession.startWorkflow(model, wfData, metaData);

Esempio

Inizializza doc oggetto documento su un percorso ("a/b/c") e impostare il valore del docVar nel percorso memorizzato nell'oggetto documento.

import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.WorkflowData;
import com.adobe.granite.workflow.model.WorkflowModel;
import com.adobe.granite.workflow.metadata.MetaDataMap;
import com.adobe.aemfd.docmanager.Document;

/*This example assumes that you already have a workflowSession and modelId along with the payloadType and payload */
WorkflowData wfData = workflowSession.newWorkflowData(payloadType, payload);
MetaDataMap metaData = wfData.getMetaDataMap();
Document doc = new Document("/a/b/c");// initialize a document object
metaData.put("docVar",doc); //Assuming that you have created a variable "docVar" of type Document in your workflow model
WorkflowModel model = workflowSession.getModel(modelId);
workflowSession.startWorkflow(model, wfData, metaData);

Archiviare dati utente sensibili al di fuori di JCR utilizzando variabili di flusso di lavoro

I dati elaborati utilizzando il flusso di lavoro dei moduli possono contenere dati utente sensibili, ad esempio informazioni personali identificabili e informazioni personali riservate. Le aziende possono scegliere di archiviare i dati, elaborati da vari passaggi del flusso di lavoro (e trasmessi utilizzando variabili di flusso di lavoro), dall’archiviazione JCR in un archivio dati esterno di loro proprietà e gestito. Per ulteriori informazioni sulla persistenza dei dati del flusso di lavoro in uno storage esterno, consulta Utilizzo delle variabili di flusso di lavoro per i datastore di proprietà del cliente.
Adobe Experience Manager fornisce API per i flussi di lavoro UserMetaDataPersistenceProvider per memorizzare le variabili del flusso di lavoro negli archivi BLOB di Azure esterni. Per informazioni dettagliate sull’utilizzo dell’API, consulta Utilizza le variabili del flusso di lavoro per parametrizzare i dati sensibili e archiviarli in archivi di dati esterni.

Modificare una variabile

1. Nella pagina modifica flusso di lavoro , tocca l’icona Variabili disponibile nella barra laterale del modello di flusso di lavoro. Nella sezione Variabili del riquadro a sinistra vengono visualizzate tutte le variabili esistenti.
2. Tocca (Modifica) accanto al nome della variabile da modificare.
3. Modifica le informazioni sulla variabile e tocca per salvare le modifiche. Non è possibile modificare il Nome e Tipo campi per una variabile.

Eliminare una variabile

Prima di eliminare la variabile, rimuovi tutti i riferimenti della variabile dal flusso di lavoro. Assicurati che la variabile non sia utilizzata nel flusso di lavoro.

Esegui i seguenti passaggi per eliminare una variabile:

1. Nella pagina modifica flusso di lavoro , tocca l’icona Variabili disponibile nella barra laterale del modello di flusso di lavoro. Nella sezione Variabili del riquadro a sinistra vengono visualizzate tutte le variabili esistenti.
2. Tocca l’icona Elimina accanto al nome della variabile da eliminare.
3. Tocca per confermare ed eliminare la variabile.

Riferimenti

Per ulteriori esempi sull’utilizzo delle variabili nei passaggi del flusso di lavoro di AEM Forms, consulta Variabili nei flussi di lavoro AEM.