Variabili di sostituzione di runtime in Script di calcolo eseguite in Smart View

È possibile utilizzare le variabili di sostituzione runtime (RTSV) negli script di calcolo di Essbase progettati per l'esecuzione in Smart View. Gli RTSV consentono alla regione di focalizzazione del calcolo di essere dinamica, a seconda del contesto della griglia attiva (POV).

Per utilizzare uno script di calcolo che include variabili di sostituzione runtime in Smart View, la dichiarazione della variabile di sostituzione runtime nel comando di calcolo SET RUNTIMESUBVARS deve includere il tag <RTSV_HINT>. Inoltre, il tag <RTSV_HINT> deve includere il tag <svLaunch>. In genere, la tag <svLaunch> include tag XML aggiuntive che forniscono metadati per l'esecuzione dello script di calcolo in Smart View.

Utilizzare la sintassi seguente per definire una definizione di variabile di sostituzione runtime da utilizzare in Smart View:

SET RUNTIMESUBVARS
{
   rtsvName = POV
   <RTSV_HINT>
      <svLaunch>
         <description>rtsv_description</description>
         <type>member | string | number</type>
         <dimension>dimName</dimension>
         <choice>single | multiple</choice>
         <allowMissing>true | false</allowMissing>
      </svLaunch>
   </RTSV_HINT>
};

Nella definizione precedente, il nome della variabile di sostituzione runtime è rtsvName, ma è possibile utilizzare qualsiasi nome. Il valore della variabile deve essere impostato su POV, per indicare che deve essere calcolata solo la porzione di dati corrente presente nella griglia del foglio di calcolo.

Anche l'elemento <RTSV_HINT> deve far parte della dichiarazione variabile. I suoi contenuti includono:

• <description>: un descrittore che consente agli utenti di Smart View di comprendere la selezione dei membri
• <type>: specifica se la variabile è per un membro, una stringa o un numero
• <allowMissing>: true se i dati mancanti devono essere inclusi; false altrimenti
• <dimension>: il nome della dimensione da cui questa variabile estrae le informazioni
• <choice>: single se solo una selezione può essere passata alla variabile di sostituzione runtime; altrimenti, multiple.

Per una descrizione completa dei tag XML elencati in precedenza, fare riferimento a Riferimento tag XML: Script di calcolo con variabili di sostituzione runtime per Smart View.

In Smart View, quando si seleziona uno script di calcolo che include variabili di sostituzione runtime nella finestra di dialogo Script di calcolo, l'area Prompt runtime viene popolata con campi basati sulla modalità di definizione delle variabili di sostituzione runtime nel comando di calcolo SET RUNTIMESUBVARS. È possibile eseguire lo script di calcolo come definito oppure utilizzare i prompt runtime per immettere informazioni variabili diverse in base al tipo di dati.

Nota

In Smart View non è possibile eseguire uno script di calcolo che includa variabili di sostituzione runtime se il comando SET RUNTIMESUBVARS non include le tag <RTSV_HINT><svLaunch>...</svLaunch></RTSV_HINT>.

Esempio: variabile di sostituzione runtime impostata su POV

Per impostare la variabile di sostituzione runtime di uno script di calcolo Essbase sul contesto griglia attivo (POV) di Smart View, il valore della variabile di sostituzione runtime deve essere impostato su POV e il tipo di dati deve essere impostato su member, come mostrato in questo esempio.

Per impostazione predefinita, lo script di calcolo utilizza il membro attivo nel POV in runtime a meno che l'utente di Smart View non specifichi un membro diverso nel prompt runtime.

In questo esempio, si supponga che il database abbia le seguenti dimensioni: Conto, Entità, Periodo e Scenario. Sono definite tre variabili di sostituzione runtime (denominate rtsvEntity, rtsvScenario e rtsvPeriod) e il valore di ogni variabile è impostato su POV. Nell'istruzione FIX si fa riferimento alle variabili di sostituzione runtime come &rtsvEntity, &rtsvScenario e &rtsvPeriod.

SET RUNTIMESUBVARS {
   rtsvEntity = POV
      <RTSV_HINT>
         <svLaunch>
            <description>Entities to Copy</description>
            <type>member</type>
            <dimension>Entity</dimension>
            <allowMissing>false</allowMissing>
            <choice>multiple</choice>
         </svLaunch>
      </RTSV_HINT>;
   rtsvScenario = POV
      <RTSV_HINT>
         <svLaunch>
            <description>Scenarios to Copy</description>
            <type>member</type> 
            <allowMissing>false</allowMissing>
            <dimension>Scenario</dimension>
            <choice>multiple</choice>
         </svLaunch>
      </RTSV_HINT>;
   rtsvPeriod   = POV
      <RTSV_HINT>
         <svLaunch>
            <description>Period to Copy</description>
            <type>member</type>
            <allowMissing>false</allowMissing>
            <dimension>Period</dimension>
            <choice>single</choice>
         </svLaunch>
      </RTSV_HINT>;
}
FIX(&rtsvEntity, &rtsvScenario, &rtsvPeriod)
"Opening Balance" (
@PREV("Closing Balance");
)

Sotto le dichiarazioni variabili è presente un blocco FIX, che seleziona l'area di focalizzazione del calcolo ed esegue un comando per impostare il saldo di apertura del periodo. Le variabili di sostituzione runtime vengono passate nel blocco FIX utilizzando la seguente sintassi: &varname. L'area di focalizzazione del calcolo è pertanto dinamica, a seconda del punto di vista in Smart View.

Nota

Quando si utilizza l'interfaccia job di Essbase, l'istruzione MaxL esegui calcolo o le API (ad esempio l'endpoint Esegui job dell'API REST), non è possibile eseguire uno script di calcolo che includa una variabile di sostituzione runtime impostata su POV. Poiché dipendono dal contesto griglia corrente di Smart View, devono essere eseguiti da Smart View.

Riferimento tag XML: script di calcolo con variabili di sostituzione runtime per Smart View

Quando si progettano script di calcolo Essbase con variabili di sostituzione runtime progettate per l'esecuzione in base al contesto POV/griglia di Smart View, è necessario utilizzare alcuni tag XML spiegati qui.

• <RTSV_HINT>

  Tag obbligatorio per la definizione delle variabili di sostituzione runtime da utilizzare in Smart View.

• <svLaunch>

  Tag obbligatorio che indica che la variabile di sostituzione runtime è definita per l'uso in Smart View.

  Questo tag è il tag padre per questi tag: <description>, <type>, <dimension>, <choice> e <allowMissing>.

• <description>rtsv_description</description>

  rtsv_description è una stringa che descrive la variabile di sostituzione runtime. La stringa non viene utilizzata nel calcolo.

• <type>value</type>

  Di seguito sono riportati i valori validi per il tipo di dati.

  • membro: il valore della variabile di sostituzione runtime deve essere definito come membro (un singolo nome membro o una lista separata da virgole di nomi membro) o POV.

    Nota

    I nomi dei membri devono essere racchiusi tra virgolette, ad esempio "New York" (membro singolo) o "New York","Florida" (elenco separato da virgole dei nomi dei membri).

    Se il valore della variabile di sostituzione runtime è impostato su POV, il valore <type> deve essere membro. Vedere anche il tag <choice>.

    Utilizzando job Essbase o MaxL, non è possibile eseguire uno script di calcolo che includa una variabile di sostituzione runtime impostata sul POV. Questi script di calcolo devono essere eseguiti da Smart View, poiché il POV dipende dal contesto della griglia corrente per determinare la porzione.

  • stringa - Il valore della variabile di sostituzione runtime può essere definito come un singolo nome membro, un elenco separato da virgole di nomi membro (ad esempio, "New York", "Florida") o una data.

    Quando si utilizza il tipo di dati stringa, la finestra di dialogo Selezione membri non è disponibile; pertanto, l'utente di Smart View deve assicurarsi di utilizzare la sintassi corretta (includendo un nome membro tra virgolette, la separazione di più nomi di membri con una virgola oppure, per una data, la corrispondenza del formato della stringa di data con il formato definito nello script di calcolo, ovvero mm-dd-yyyy o dd-mm-yyyy.

  • numero: il valore della variabile di sostituzione runtime deve essere definito come un numero

• <dimension>dimName</dimension>

  Nome della dimensione.

  Nota

  Questo tag XML è supportato solo se il valore <type> è membro.

• <choice>value</choice>

  I valori di scelta validi sono:

  • single:

    • Se nella griglia o nel POV è presente un singolo membro, tale membro viene utilizzato.

    • Se una dimensione si trova nel POV, viene utilizzato il membro attivo.

    • Se una dimensione si trova nel POV e sono presenti più membri, si verifica un errore.

  • multiplo: vengono utilizzati tutti i membri della dimensione nella griglia o nel POV.

  Nota

  Questo tag XML è supportato solo se il valore <type> è membro.

• <allowMissing>boolean</allowMissing>

  Specifica se consentire o eliminare le celle dati per le quali non esistono dati nel database.

  Valori validi: vero e falso.