Använd ersättningsvariabler

Använd ersättningsvariabler i Essbase-beräkningsskript för att lagra värden som kan förändras. Använd exekveringsersättningsvariabler när du måste ha flera användare som anger olika värden för samma skript.

Om till exempel alla dina olika beräkningsskript, formler, filter, rapportskript och MDX-skript måste referera till den aktuella månaden vill du inte söka och ersätta månaden ungefär var 30:e dag i ditt bibliotek av kubartefakter. Du kan i stället definiera ersättningsvariabeln CurrMonth och ändra dess tilldelade värde varje månad till rätt månad. Alla kubartefakter som refererar till variabeln refererar sedan till rätt månad.

Här är ett exempel på en enkel ersättningsvariabel för som motsvarar den aktuella månaden:

Variabelnamn: CurrMonth

Värde: Jan

Ersättningsvariabelvärden gäller för alla användare som kör ett beräkningsskript som innehåller variabeln. Exempel: Om CurrMonth har värdet Jan så kommer alla skript som innehåller &CurrMonth att exekveras för Jan. En ersättningsvariabels omfattning kan vara:

  • global (för alla applikationer och kuber på servern)
  • applikation (för alla kuber i applikationen)
  • kub (för en enstaka kub)

Definiera eller uppdatera en ersättningsvariabel för en specifik kub:

  1. På sidan Applikationer öppnar du applikationen och därefter databasen (kuben).
  2. Klicka på Anpassning och på Variabler.
  3. Du skapar en ny variabel genom att klicka på Skapa, ange variabelns namn och värde och sedan klicka på SparaBild på ikonen Spara (bockmarkering) i dialogrutan Variabler..
  4. Om du redigerar värdet för en befintlig variabel, dubbelklickar du på värdet (eller klickar på Redigera), anger det uppdaterade värdet och trycker på Enter (eller klickar på Spara).
  1. I webbgränssnittet för Essbase går du till sidan Applikationer och utökar applikationen för att visa den kub du vill ändra.
  2. Starta inspektionen via menyn Åtgärder till höger om kuben.
  3. Välj fliken Variabler.
  4. Skapa en ny variabel genom att klicka på Lägg tillBild av ikonen Lägg till., ange variabelns namn och värde och klicka på Spara.
  5. Om du redigerar värdet för en befintlig variabel, dubbelklickar du i fältet Värde, anger det uppdaterade värdet och trycker på Enter.
  6. Klicka på Stäng.

Definiera eller uppdatera en ersättningsvariabel för en specifik applikation

  1. Öppna applikationen på sidan Applikationer.
  2. Klicka på Anpassning och på Variabler.
  3. Skapa en ny variabel genom att klicka på Skapa, ange variabelns namn och värde och klicka på SparaBild på ikonen Spara (bockmarkering) i dialogrutan Variabler..
  4. Om du redigerar värdet för en befintlig variabel, dubbelklickar du på värdet (eller klickar på Redigera), anger det uppdaterade värdet och trycker på Enter (eller klickar på Spara).
  1. Starta inspektionen på sidan Applikationer, via menyn Åtgärder till höger om applikationen.
  2. Välj fliken Variabler.
  3. Skapa en ny variabel genom att klicka på Lägg tillBild av ikonen Lägg till., ange variabelns namn och värde och klicka på Spara.
  4. Om du redigerar värdet för en befintlig variabel, dubbelklickar du i fältet Värde, anger det uppdaterade värdet och trycker på Enter.
  5. Klicka på Stäng.

Definiera eller uppdatera en ersättningsvariabel globalt

  1. På sidan Applikationer klickar du på Konsol.
  2. Klicka på panelen Variabler.
  3. Skapa en ny variabel genom att klicka på Skapa, ange variabelns namn och värde och klicka på SparaBild på ikonen Spara (bockmarkering) i dialogrutan Variabler..
  4. Om du redigerar värdet för en befintlig variabel, dubbelklickar du på värdet (eller klickar på Redigera), anger det uppdaterade värdet och trycker på Enter (eller klickar på Spara).
  1. Klicka på Konsol i Webbgränssnittet för Essbase.
  2. Klicka på fliken Variabler.
  3. Skapa en ny variabel genom att klicka på Lägg till, ange variabelns namn och värde och klicka på Spara.
  4. Om du redigerar värdet för en befintlig variabel, dubbelklickar du i fältet Värde, anger det uppdaterade värdet och trycker på Enter.

När ersättningsvariabeln har definierats kan du använda den i beräkningsskript, formler, filter, MDX-skript, laddningsregler och rapporter. Om du vill referera till variabeln anger du tecknet & som prefix.

Här är ett exempel på ett beräkningsskript som refererar till en ersättningsvariabel:

FIX(&CurrMonth)
   CALC DIM (Measures, Product);
ENDFIX

Här är ett exempel på en formel som refererar till en ersättningsvariabel:

@ISMBR(&CurrMonth)

Med exekveringsersättningsvariabler kan du deklarera variabler och deras värden i kontexten för en exekveringsåtgärd, som beräkningsskript, MaxL-skript eller MDX-fråga. Exekveringsersättningsvariabler kan tilldelas att ha numeriska värden eller referera till medlemsnamn. Ett standardvärde kan tilldelas om en användare inte ändrar ett indatavärde. Och för beräkningsskript kan variabelvärdet även fyllas i vid exekvering från medlemmarna i en dimension som visas i ett Smart View-rutnät. För beräkningsskript med variabelvärden som fylls i vid exekvering måste du starta beräkningsskripten via Smart View, eftersom variabeln inte har någon definition utanför rutnätets kontext.

Exekveringsersättningsvariabler kan definieras i beräkningsskriptet med nyckel/värde-par:

SET RUNTIMESUBVARS
{
   myMarket = "New York";
   salesNum = 100;
   pointD = "Actual"->"Final";
}

Om du vill definiera exekveringsersättningsvariabler med värden som ändras dynamiskt beroende på synvinkeln tilldelar du definitionen till synvinkeln och använder XML-syntax för att aktivera Smart View-kontextfrågor.

Mer information finns även i