Implementare le variabili per la modifica delle informazioni

È possibile utilizzare le variabili di sostituzione di Essbase come segnaposto per modificare regolarmente le informazioni. Poiché le modifiche a un valore variabile si riflettono ovunque venga utilizzata la variabile, la necessità di effettuare aggiornamenti manuali viene ridotta al minimo.

Ad esempio, molti report dipendono dai periodi di generazione report; se si genera un report in base al mese corrente, è necessario aggiornare manualmente lo script del report ogni mese. Se nel server Essbase si imposta una variabile, ad esempio CurMnth, è possibile modificare il valore assegnato ogni mese al periodo del tempo appropriato. Quando si utilizza il nome della variabile in uno script di report, le informazioni vengono aggiornate in modo dinamico quando si esegue il report finale.

È possibile utilizzare variabili di sostituzione sia con applicazioni di memorizzazione di aggregazione (ASO) che di memorizzazione a blocchi (BSO) (salvo diversamente indicato) nelle seguenti aree:

  • Formule struttura di memorizzazione aggregata

  • Formule del profilo di memorizzazione a blocchi

  • Script di calcolo (solo database di storage a blocchi)

    Le variabili di sostituzione e le variabili di sostituzione runtime sono supportate negli script di calcolo.

  • Definizioni dell'intestazione del file delle regole di caricamento dati e definizioni dei campi. È possibile immettere i nomi delle variabili per i nomi dimensione e membro.

  • Specifiche del nome dell'origine dati (DSN) nei file delle regole per le origini dati SQL

  • clausole SELECT, FROM o WHERE nei file di regole per le origini dati SQL

  • Filtri di sicurezza

  • Query MDX

  • Smart View

  • Script di report

È possibile impostare le variabili di sostituzione a questi livelli:

  • Globalmente: fornisce l'accesso alla variabile da tutte le applicazioni e i database nel server Essbase.

  • Applicazione: fornisce l'accesso alla variabile da tutti i database all'interno dell'applicazione.

  • Database: consente di accedere alla variabile all'interno del database specificato.

Nomi e valori delle variabile di sostituzione consentiti

Quando si utilizzano variabili di sostituzione in Essbase, seguire le linee guida relative ai caratteri e ai tipi di dati che è possibile utilizzare nei nomi e nei valori delle variabili di sostituzione.

Le limitazioni riportate di seguito si applicano ai nomi e ai valori delle variabili di sostituzione.

Caratteri consentiti nel nome della variabile

Sono consentiti caratteri alfanumerici e caratteri di sottolineatura, ma non caratteri speciali o spazi. Limite di caratteri: vedere Limiti.

Caratteri consentiti nel valore della variabile

È consentito qualsiasi carattere, ad eccezione di una E commerciale iniziale (&). Limite di caratteri: vedere Limiti.

Nomi dei membri Essbase utilizzati come valori di variabile

Racchiudere i nomi dei membri che iniziano con un numero o contengono eventuali caratteri speciali tra virgolette (" ") per i database di storage a blocchi e tra parentesi ([ ]) per i database di storage di aggregazione. Per ulteriori dettagli, vedere Convenzioni di denominazione negli script di calcolo, script di report, formule, filtri, valori delle variabili di sostituzione e di ambiente.

Per impostare un valore di variabile di sostituzione come nome membro duplicato, utilizzare il nome membro qualificato racchiuso tra virgolette doppie; ad esempio, un valore per &Period può essere "[2022].[Qtr1]".

Non utilizzare un nome di variabile di sostituzione come parte di un nome membro qualificato. Ad esempio, non è valido specificare "[2022].[&CurrentQtr]".

Numeri utilizzati come valori variabili

Racchiudere i valori numerici tra virgolette (" ") per i database di storage a blocchi (BSO) e tra parentesi ([ ]) per i database di storage di aggregazione (ASO).

Ad esempio, se il nome della variabile è Mese e il relativo valore è 01, per lo storage a blocchi impostare il valore su "01". Per la memorizzazione di aggregazione, impostare il valore su [01].

Più variabili con lo stesso nome

Le variabili possono avere lo stesso nome purché siano definite in ambiti diversi. La precedenza della risoluzione variabile funziona come segue: la variabile del database viene risolta prima della variabile dell'applicazione. La variabile dell'applicazione viene risolta prima della variabile globale.

Crea o imposta variabili sostitutive

Prima di impostare una variabile di sostituzione, vedere Nomi e valori delle variabili di sostituzione consentiti.

È possibile creare o impostare variabili di sostituzione a livello di server Essbase, applicazione o database.

Per assicurarsi che un nuovo valore della variabile di sostituzione sia disponibile nelle formule, nelle definizioni delle partizioni e nei filtri di sicurezza, arrestare e riavviare l'applicazione. Tutti gli altri usi delle variabili di sostituzione vengono risolti dinamicamente quando vengono utilizzati.

Quando si aggiungono o si aggiornano variabili di sostituzione, queste vengono inviate all'applicazione e risolte in modo dinamico.

Per impostare una variabile di sostituzione utilizzando l'interfaccia Web Essbase, fare riferimento a Usa variabili di sostituzione. È inoltre possibile utilizzare una cartella di lavoro di applicazione per impostare le variabili a livello di applicazione oppure utilizzare le istruzioni MaxL riportate di seguito.

Rimuovi variabili sostitutive

È possibile eliminare una variabile di sostituzione Essbase che non è più necessaria.

Per eliminare una variabile di sostituzione, è possibile rimuoverla dalla cartella di lavoro dell'applicazione e creare il cubo, eliminarla utilizzando l'interfaccia Web Essbase oppure utilizzare le istruzioni MaxL riportate di seguito.

Aggiorna variabili sostitutive

Poiché le variabili di sostituzione sono segnaposto per la modifica delle informazioni, potrebbe essere necessario aggiornarne frequentemente i valori. È possibile modificare le variabili di sostituzione esistenti utilizzando MaxL o l'interfaccia Web Essbase.

Per aggiornare una variabile di sostituzione, è possibile utilizzare una di queste istruzioni MaxL (da utilizzare dipende dal contesto della variabile):

Se si preferisce utilizzare l'interfaccia Web Essbase per aggiornare una variabile, fare riferimento a Usa variabili di sostituzione per istruzioni.