Crea e utilizza variabili

Una variabile è un oggetto che memorizza un singolo valore, che può essere una stringa, un numero o una data.

Argomenti

Creazione di una variabile

È possibile specificare il valore delle variabili quando si crea la variabile o si imposta il valore utilizzando un'espressione di query.

La pagina Variabili elenca tutte le variabili esistenti. Fare clic sull'icona Azioni (Icona Azioni) di una variabile per modificarla, aggiornarla o eliminarla. Tutte le variabili disponibili sono inoltre elencate nel pannello sinistro della pagina Dettagli workflow. È possibile utilizzare le variabili come passi nei flussi di dati e nei flussi di lavoro.

Per creare una variabile, effettuare le operazioni riportate di seguito.

  1. Nella pagina Home, fare clic sul titolo del progetto richiesto. Si è passati alla pagina Dettagli progetto.
  2. Nel riquadro sinistro, fare clic su Variabili. Viene visualizzata la pagina Crea variabile.
  3. Immettere un nome per la variabile.
  4. Nell'elenco Tipo di dati, selezionare una delle opzioni riportate di seguito.
    • Testo breve: il valore può essere alfanumerico, può contenere caratteri speciali e non può superare i 255 caratteri.
    • Testo lungo: il valore può essere alfanumerico, può contenere caratteri speciali e non può superare i 64000 caratteri.
    • Numerico: il valore può essere un valore numerico e può essere preceduto da un segno meno (-). Il valore non può superare le 10 cifre. L'intervallo di valori possibile è compreso tra -999999999 e 999999999.
    • Data: il valore è un formato di data.
  5. Nel campo Valore predefinito immettere il valore che si desidera assegnare alla variabile. Il valore consentito dipende dal Tipo di dati selezionato.
  6. Per le variabili modificate, è possibile fare clic sul menu Azioni accanto alla variabile per aprire la pagina Aggiorna variabile per aggiornare il valore. Nell'elenco a discesa Conserva cronologia selezionare la modalità di visualizzazione del valore della variabile nella pagina Aggiorna variabile.
    • Tutti i valori: è possibile visualizzare la cronologia di tutti i valori contenuti nella variabile.
    • Valore più recente: è possibile visualizzare solo il valore più recente specificato per la variabile.
    • Nessuna cronologia: le trasformazioni dati non conservano la cronologia dei valori contenuti in questa variabile.
    • Valore sicuro: questo è utile quando la variabile contiene password o altri dati riservati. Il valore non viene visualizzato nella pagina Aggiorna variabile.
  7. Immettere una descrizione per la variabile.
  8. Se si desidera che il valore della variabile venga impostato da una query, fare clic sulla scheda Aggiorna. Selezionare il tipo di connessione e lo schema in cui si desidera eseguire il comando. Immettere la query e fare clic su Convalida per controllare la sintassi dell'espressione.
  9. Fare clic su Salva.

    La variabile appena creata viene elencata nella pagina Variabili e nel nodo Variabili nel pannello sinistro della pagina Dettagli workflow.

Usa variabili in un flusso dati

È possibile utilizzare le variabili in un flusso di dati utilizzandole come definizione di filtro. È possibile fare riferimento alle variabili in un flusso di dati utilizzando il formato #<variable_name>. Durante l'esecuzione la variabile viene sostituita dal valore.

Quando si esegue il flusso di dati, viene visualizzata la pagina Valori variabili che visualizza l'elenco delle variabili aggiunte al flusso di dati. È possibile scegliere di utilizzare il valore corrente, il valore predefinito o impostare un valore personalizzato per ogni variabile. Si noti che il valore personalizzato viene applicato solo all'esecuzione corrente del flusso di dati. Il valore personalizzato non è persistente per le sessioni successive.

Di seguito è riportato un esempio dell'uso di una variabile in un flusso di dati.



In questo esempio, il flusso di dati utilizza la variabile DEVICE_TYPE come passo con la condizione di filtro impostata come indicato di seguito.

MOVIESALES_CA.DEVICE = '#DEVICE_TYPE'

La variabile è quotata perché il valore sostituito deve essere quotato. Poiché il valore della variabile viene sostituito durante l'esecuzione, è possibile utilizzarlo per molti casi d'uso, ad esempio nell'espressione di trasformazione nel mapping.

Usa variabili in un workflow

Nel pannello sinistro della pagina Dettagli workflow sono elencate le variabili che è possibile utilizzare come passi all'interno di un workflow.

È possibile trascinare le variabili che si desidera utilizzare nel workflow nello sfondo di progettazione. Il pannello Proprietà disponibile sul lato destro dello sfondo di progettazione visualizza vari dettagli sul passo, ad esempio il seguente.
  • Nome, Tipo e il numero di sequenza Passo. Si tratta di valori non modificabili.
  • Fare clic sul collegamento in Oggetto collegato per visualizzare e aggiornare i dettagli sulla variabile.
  • Operazione: selezionare una delle seguenti operazioni:
    • Impostazione della variabile: le funzioni per questo passo sono due.

      Aggiorna imposta il valore corrente di una variabile.

      Aumenta: aumenta o diminuisce un valore numerico in base alla quantità specificata.

    • Aggiorna variabile: questo passo della variabile aggiorna la variabile mediante l'esecuzione della query specificata nella definizione della variabile.
    • Valuta variabile: questo tipo di passo della variabile confronta il valore della variabile con un determinato valore in base a un operatore. Se la condizione viene rispettata, la configurazione della valutazione è true, altrimenti è false.
  • Numero di tentativi in caso di errore
  • Tempo tra i tentativi in secondi
  • Passi di log nel giornale: è possibile selezionare Sempre, Mai o Errore.

Quando si esegue il flusso di lavoro, viene visualizzata la pagina Valori variabili che visualizza l'elenco delle variabili aggiunte al flusso di lavoro. È possibile scegliere di utilizzare il valore corrente, il valore predefinito o impostare un valore personalizzato per ogni variabile. Si noti che il valore personalizzato viene applicato solo all'esecuzione corrente del workflow. Il valore personalizzato non è persistente per le sessioni successive.

Di seguito è riportato un esempio di utilizzo di una variabile in un workflow.



In questo esempio, come passo del flusso di lavoro viene utilizzata una variabile denominata DEVICE _TYPE con il valore "iphone". Il workflow esegue le azioni riportate di seguito.

  1. Eseguire il flusso di dati "REFRESH_DEVICE.
  2. Se l'esecuzione del flusso di dati "REFRESH_DEVICE" riesce, eseguire il flusso di dati "Load_movies_for_device".
  3. Se l'esecuzione del flusso di dati "Load_movies_for_device" riesce, eseguire il passo di valutazione della variabile "IF_IPHONE".
  4. Se il valore della variabile è uguale a 'iphone', eseguire il percorso per "true".
  5. Se il valore della variabile non è uguale a 'iphone', eseguire il percorso per "false".