Zeichenfolgen formatieren

Mit Formatzeichenfolgen können Sie die Werte von Essbase-Elementen in numerischen Kennzahlen formatieren, sodass sie für Abfragezwecke als Text, Datumsangaben oder andere vordefinierte Wertetypen angezeigt werden. Sie können Formatzeichenfolgen für alle Elemente in der Kennzahlendimension und für Formelelemente in anderen Dimensionen definieren.

Der angezeigte Wert, wenn Sie Formatzeichenfolgen verwenden, ist der formatierte Wert der Zelle (Eigenschaft FORMATTED_VALUE in MDX).

Der zugrunde liegende reale Wert ist numerisch, und dieser Wert ist vom zugeordneten formatierten Wert nicht betroffen. Mit Formatzeichenfolgen können Sie aussagekräftigere Werte anstelle von numerischen Rohwerten anzeigen. Beispiel: Wenn Sie einen textbasierten formatierten Wert verwenden, können Sie Datenzellen als "Hoch", "Mittel" und "Niedrig" anzeigen.

Text- und Datumstypwerte werden zusätzlich mit den integrierten Text- und Datumskennzahlentypen unterstützt. Formatzeichenfolgen erhöhen die Flexibilität bei der Implementierung, da Sie Formatzeichenfolgen auf Elemente in mehreren Dimensionen anwenden können. Bei Text- und Datumskennzahlen können Sie jedoch nur eine oder die andere Dimension auf eine einzelne Kennzahlendimension anwenden. Sie können Formatzeichenfolgen auf numerische Dimensionen anwenden. Sie müssen die Dimension nicht als Text oder Datum eingeben.

Formatzeichenfolgen können entweder auf Aggregate Storage-(ASO-) oder Block Storage-(BSO-)Datenbanken angewendet werden.

Themen:

Formatzeichenfolgen implementieren

Formatzeichenfolgen werden für Aggregate Storage-(ASO-) und Block Storage-(BSO-)Datenbanken unterstützt. Sie implementieren Formatzeichenfolgen auf Datenbankebene. Mit dem folgenden Workflow können Sie Formatzeichenfolgen in Essbase aktivieren und verwenden.

  1. Aktivieren Sie in den Outline-Eigenschaften eingegebene Kennzahlen.

  2. Erstellen Sie in der Dimension "Accounts" eine Kennzahl, deren Elemente Sie formatieren möchten. Bearbeiten Sie in den zugehörigen Elementeigenschaften das Feld "Formatzeichenfolge zuordnen", um eine MDX-Formatanweisung zu erstellen. Die Syntax zum Erstellen einer MDX-Formatanweisung finden Sie unter MDX-Formatanweisung.

Einschränkungen bei Formatzeichenfolgen

Formatzeichenfolgen werden für mehrere Partitionen nicht unterstützt.

Eine Formatzeichenfolge darf maximal 256 Zeichen lang sein.

Gemeinsame Elemente (einschließlich implizierter Shares) dürfen keine separaten Formatzeichenfolgen aufweisen. Gemeinsame Elemente erben die Formatzeichenfolge des Prototyp-Elements.

MDX-Formatanweisung

Sie definieren eine Essbase-Formatzeichenfolge mit einem MDX-Ausdruck sowohl in ASO- als auch in BSO-Cubes.

Die MDX-Syntax zum Anwenden einer Formatzeichenfolge lautet:

format_string_expression = MdxFormat (string_value_expression)

wobei string_value_expression ein gültiger MDX-Zeichenfolgenwertausdruck ist, wie in der MDX-Spezifikation beschrieben (siehe MDX-Grammatikregeln).

Die meisten MDX-Ausdrücke können zur Angabe von Formatzeichenfolgen verwendet werden. Formatzeichenfolgen können jedoch keine Verweise auf Werte von Datenzellen enthalten, die nicht der aktuelle Zellenwert sind, der formatiert wird. Der aktuelle Zellenwert kann mit der MDX-Funktion CellValue referenziert werden.

Essbase behandelt Elemente mit ungültigen Formatzeichenfolgen, als ob keine Formatzeichenfolge definiert ist. Gliederungen können mit ungültigen Formatzeichenfolgen gespeichert werden. Essbase generiert eine Warnung, wenn eine Abfrage aus einem Element mit einer ungültigen Formatzeichenfolge besteht.

Wenn ein Element keiner Formatzeichenfolge zugeordnet ist, werden Standardformatregeln angewendet. Die Standardformatregeln formatieren eine Zelle basierend darauf, ob die Kennzahl numerisch, Text oder Datumstyp ist. Bei numerischen Kennzahlen ist der formatierte Standardwert die Textversion dieser Zahl. Bei Textkennzahlen ist der formatierte Standardwert der Textwert, der auf dem zugeordneten Textlistenobjekt basiert. Bei Datumswerten ist das Standardformat eine Datumszeichenfolge, die entsprechend der in den Gliederungseigenschaften definierten Datumsformatzeichenfolge formatiert ist.

Funktionen, die Formatzeichenfolgen unterstützen

Es gibt einige MDX-Funktionen, die nützlich sind, wenn Formatzeichenfolgen auf Essbase-Kennzahlen angewendet werden.

Formatzeichenfolgen werden sowohl in ASO- als auch in BSO-Cubes als MDX-Ausdrücke angewendet.

  • EnumText gibt das Textlistenlabel zurück, das mit dem internen numerischen Wert verknüpft ist.

  • EnumValue gibt den internen numerischen Wert für ein Textwert in einer Textliste wieder.

  • CellValue gibt den internen numerischen Wert der aktuellen Zelle zurück.

  • NumToStr konvertiert einen Wert in eine Dezimalzeichenfolge.

Die Berechnungsfunktion @ENUMVALUE kann nützlich sein, wenn Berechnungsskripte für eine Block Storage-Datenbank geschrieben werden, die Textkennzahlen oder Formatzeichenfolgen enthält. Diese Funktion gibt das Textlistenlabel zurück, das mit dem internen numerischen Wert verknüpft ist.

Die MaxL-Anweisung alter session set dml_output enthält die Klausel set formatted_value on | off. Standardmäßig werden formatierte Werte in Abfragen angezeigt. Mit dieser Anweisung können Sie jedoch die Anzeige formatierter Werte deaktivieren.

Der Befehl OUTFORMATTEDVALUES Report Writer gibt formatierte Zellenwerte in einem Bericht zurück.