Modifica delle variabili di runtime

Mostra come selezionare un set di variabili che è possibile utilizzare come parametro runtime per i job pipeline.

Nella pagina Variabili è possibile selezionare un set di variabili utilizzabili come parametro di runtime per i job pipeline. Quando si esegue una pipeline, si riceve un valore di input per tali variabili, un set di valori pronti all'uso o di runtime, i cui valori parametro possono essere utilizzati per i singoli job. Le variabili possono essere tipi predefiniti, ad esempio "Periodo", "Modalità importazione" o "Modalità esportazione".

È anche possibile aggiungere un parametro variabile customizzato come parametro di job. Ad esempio, se si desidera passare valori statici utilizzando una variabile di sostituzione per il periodo di inizio, impostare il tipo di variabile su "Testo", quindi specificare una variabile di sostituzione come parametro (accettato dall'API RESI di integrazione), quale &ThisMonth#&ThisYear. Una variabile di sostituzione è un nome di variabile utente preceduto da una o due e commerciali (&).

Le variabili di runtime predefinite sono elencate di seguito.

Periodo di inizio
Periodo di fine
Modalità importazione
Modalità esportazione
Invia posta
Invia a
Allega log
Esecuzione stadio

Per modificare le variabili di runtime della pipeline, procedere come segue.

Nella home page di Integrazione dati, fare clic su a destra della pipeline e quindi selezionare Dettagli pipeline.
Nella pagina Pipeline, selezionare la scheda Variabili.
Selezionare la variabile da modificare.
In Nome variabile, per aggiungere o modificare un nome di variabile predefinita, specificare il nome desiderato.

È possibile fare riferimento a tale nome come parametro di job. Il nome può avere una lunghezza massima di 20 caratteri e non può contenere spazi.
In Nome visualizzato, specificare il nome del prompt di visualizzazione per la variabile.
In Ordine visualizzazione, specificare l'ordine di visualizzazione della variabile.
Selezionare Obbligatorio se per la variabile è richiesto un valore per eseguire la pipeline.
Dall'elenco a discesa Tipo di convalida selezionare il tipo di valore utilizzato per convalidare la variabile.

I tipi di convalida sono elencati di seguito.
- Elenco: utilizzo di una query LOV e i valori di associazione sono obbligatori.
- Testo: campo di testo in formato libero.
- File: nome file. Per la selezione di un file è disponibile una finestra browser di file.
- Elenco custom: elenco di valori definito dall'utente.
  
  Per utilizzare questo tipo di convalida, specificare un elenco di valori nella finestra Parametri convalida. I valori devono essere specificati in formato Value,Label e ogni riga deve terminare con un carattere di nuova riga, ad esempio:
```
M,Month
Q,Quarter
Y,Year
```
- Ricerca: utilizzo dei valori di ricerca disponibili.
Dall'elenco a discesa Parametri convalida selezionare i parametri predefiniti per la variabile in base al tipo di convalida.

Ad esempio, è possibile selezionare un parametro variabile Periodo di inizio in base a un tipo di convalida elenco, come mostrato di seguito.
- Stato pipeline
- Query LOV modalità esportazione pipeline
- Query LOV nome periodo globale
- Query LOV senza sicurezza posizione
- Query bilancio di verifica convertito per entità/conto target
- Query controllo processo

In Valore predefinito, selezionare il valore predefinito per la variabile.

Il valore predefinito può essere un valore statico o una variabile di sostituzione di Planning.

Nella tabella seguente sono riportate le variabili di runtime predefinite con le relative descrizioni.

Table 12-40 Variabili di runtime predefinite e relative descrizioni

Nome variabile	Valori disponibili
Periodo di inizio	Consente di specificare il primo periodo di tempo incluso nell'ambito di elaborazione importazione/esportazione della pipeline. Imposta l'inizio dell'intervallo di periodi utilizzato dal passo di scambio dati (spesso insieme a Periodo di fine) per determinare i dati dei periodi da elaborare.
Periodo di fine	Consente di specificare l'ultimo periodo di tempo incluso nell'ambito di elaborazione importazione/esportazione della pipeline. Imposta la fine dell'intervallo di periodi (utilizzato con Periodo di inizio) per determinare i dati dei periodi che verranno elaborati dal passo di scambio dati.
Modalità importazione	Specifica il modo in cui la pipeline di scambio dati deve gestire il caricamento dei dati in entrata durante un passo di importazione, ovvero se l'importazione sostituisce i dati esistenti oppure aggiunge dati ai o aggiorna i dati esistenti nel target. Sostituisci: (valore predefinito) sostituisce i dati target esistenti per l'ambito di importazione, quindi carica i nuovi dati. Aggiungi: conserva i dati target esistenti e aggiunge i nuovi record e/o aggiorna i record corrispondenti in base alle regole di importazione. Nessuna importazione: non carica i dati. Mappa e convalida: esegue l'importazione utilizzando i mapping e le regole di convalida definiti per trasformare e convalidare i dati di origine, ma non scrive i dati nel target. Viene utilizzata per confermare il file/formato, la copertura del mapping e le convalide delle regole, nonché per esaminare eventuali errori o avvisi prima di eseguire una modalità di caricamento/commit.
Modalità esportazione	Specifica il modo in cui la pipeline di scambio dati deve esportare i dati. Unisci: (valore predefinito) esporta solo i dati nell'ambito di esecuzione corrente e li combina con qualsiasi output di esportazione esistente per il file o la posizione target. I record esistenti possono essere aggiornati se le chiavi corrispondono; i nuovi record vengono aggiunti. Accumula: aggiunge l'output di esportazione dell'esecuzione corrente all'output esistente come set di record aggiuntivo (solo aggiunta), conservando il contenuto esportato precedente. Sostituisci: genera un nuovo output di esportazione per l'ambito di esecuzione corrente e sovrascrive il file o il contenuto di esportazione esistente nella posizione target. Esecuzione manuale: esegue il processo di esportazione (selezione dell'ambito, formattazione, convalide) senza produrre o scrivere l'output di esportazione finale, consentendo di verificare i risultati e di rilevare i problemi prima di generare i file. Nessuna esportazione: non esporta i dati.
Invia posta	Controlla se la pipeline invia una notifica e-mail per l'esecuzione della pipeline. Sempre: invia una notifica e-mail per ogni esecuzione della pipeline, indipendentemente dal risultato (esito positivo, avviso o errore). No: (valore predefinito) non invia alcuna notifica e-mail per l'esecuzione della pipeline. In caso di errore: invia una notifica e-mail solo quando l'esecuzione della pipeline ha esito negativo (o termina con uno stato di errore). In caso di operazione riuscita: invia una notifica e-mail solo quando l'esecuzione della pipeline viene completata correttamente.
Invia a	Consente di specificare l'elenco dei destinatari e-mail per le notifiche relative all'esecuzione della pipeline quando l'opzione Invia posta è abilitata.
Allega log	Controlla se i log di esecuzione della pipeline vengono inclusi come file allegati con i risultati o le notifiche della pipeline (ad esempio, nell'output del job o in qualsiasi payload di e-mail/notifica configurato). No: (valore predefinito) non allega i log. Sì: allega i log.
Esecuzione stadio	Avvia dall'inizio: (valore predefinito) quando l'esecuzione della pipeline ha esito negativo, riavvia il processo dall'inizio. Avvia dall'errore: quando l'esecuzione della pipeline ha esito negativo, invece di riavviare il processo, avvia il job dall'ultimo stadio non riuscito. Quando una pipeline viene riavviata da uno stadio non riuscito, lo stato dei job dello stadio precedente viene trasferita alla nuova esecuzione della pipeline. Note: Se si seleziona Avvia dall'errore, ma la pipeline è stata completata, la pipeline non verrà eseguita.

Fare clic su Salva.