x

TABLE FILE filename{PRINT|SUM} ...
FOR hierarchyfld 
parentvalue {GET|WITH} CHILD[REN] [n|ALL]
 [AS CAPTION|'text'] [LABEL label]
.
.
.
END

Hierbei gilt:

filename

Ist der Name der Datei, die in der FML-Anfrage verwendet werden soll. Falls die Hierachie für diese Anfrage nicht automatisch geladen werden kann, muss sie zuvor mit dem LOAD CHART-Befehl geladen worden sein.

hierarchyfld

Ist der Name des Hierarchiefeldes. Falls die Anfrage auf eine verbundene Struktur verweist, muss der Name der Feldname aus der Hostdatei sein. Der Aliasname wird nicht unterstützt.

parentvalue

Ist der übergeordnete Wert, für den die untergeordneten Elemente abgerufen werden sollen.

GET CHILDREN

Zeigt die Hierarchie an, beginnend mit dem ersten untergeordneten Element des angegebenen parentvalue. Hierbei wird das übergeordnete Element nicht angezeigt. (Dies entspricht der FML-Syntax CHILD1 OVER CHILD2 OVER ...)

WITH CHILDREN

Zeigt die Hierarchie an, beginnend mit dem angegebenen parentvalue. Das übergeordnete Element ist in der Anzeige enthalten. (Dies entspricht der FML-Syntax parentvalue OVER CHILD1 OVER CHILD2 OVER ...).

n|ALL

Ist eine positive ganze Zahl zwischen 1 und 99, die die Anzahl der Ebenen in der Hierarchie, die angezeigt werden sollen, angibt. Falls eine Zahl, die größer als 99 ist, angegeben wurde, wird eine Warnmeldung angezeigt und n auf 99 gestellt. Der Defaultwert ist 1. Somit werden, wenn n nicht angegeben wird, nur direkt untergeordnete Elemente angezeigt. GET oder WITH CHILDREN 2 zeigt direkt untergeordneten Element und diesen direkt untergeordnete Elemente an. GET oder WITH CHILDREN 99 zeigt untergeordnete Elemente bis zu 99 Ebenen an. ALL ist ein Synonym für 99. Jede untergeordnete Instanz wird über die darauffolgende gedruckt. Aufeinanderfolgende Ebenen des Hierarchiefeldes werden um jeweils zwei Leerstellen eingerückt.

CAPTION

Gibt an, dass die Beschriftungswerte, die angezeigt werden sollen, aus dem Feld stammen sollen, das in der Masterdatei als CAPTION definiert ist.

Beachten Sie, dass die AS CAPTION-Phrase für Tag-Zeilen unterstützt wird, einschließlich der Tag-Zeilen, die nicht die GET/WITH CHILDREN- oder ADD-Syntax verwenden. Es muss jedoch die Hierarchie definiert werden (durch Angabe des PARENT_OF-Attributs), um die Beschreibungswerte zu laden und anzuzeigen. Falls die Hierarchie nicht definiert wurde, wird die AS CAPTION-Phrase ignoriert.

'Text'

Ist eine Textfolge, die als Zeilentitel für die Hierarchie-Feldwerte verwendet werden soll. Das CAPTION-Feld, das in der Masterdatei definiert wurde, wird in der Reportausgabe nicht als Beschreibung verwendet.

Label

Ist ein explizites Zeilenlabel. Alle erzeugten Zeilen werden mit dem angegebenen Labeltext beschriftet.

Hinweis: Die Hierarchie wird nach dem übergeordneten Feld sortiert und, innerhalb des übergeordneten Feldes, nach dem Hierarchiefeld.

Informationen zu den Funktionen FMLFOR, FMLLIST, FMLCAP und FMLINFO, die die Tag-Werte und Beschreibungen zurückgeben, die in einer FML-Anfrage verwendet werden, finden Sie im Handbuch Funktionen verwenden .

Nach oben

Beispiel: Eine FML-Hierarchie anzeigen

Die folgende Anfrage zeigt zwei Ebenen von Kontonummern an, beginnend mit dem Konto 3000:

SET BLANKINDENT=ON
TABLE FILE CENTGL
PRINT GL_ACCOUNT_PARENT
FOR GL_ACCOUNT 
3000 WITH CHILDREN 2 
END

Die Ausgabe wird wie folgt angezeigt.

             Parent
             ------
3000         1000
  3100       3000
    3110     3100
    3120     3100
    3130     3100
    3140     3100
    3200     3000
    3300     3200
    3400     3200
    3500     3200
    3600     3200
    3700     3200
    3800     3200
    3900     3200

Hinweis: Wenn die Anfrage GET CHILDREN anstatt WITH CHILDREN vorgibt, wird die Zeile für den übergeordneten Wert (3000) in der Reportausgabe nicht angezeigt.

Nach oben

Beispiel: Eine FML-Hierarchie mit Beschriftungen anzeigen

Die folgende Anfrage zeigt zwei Ebenen einer Kontodiagramm-Hierarchie, beginnend mit dem Konto 1000 (dem Anfang der Hierarchie) und zeigt die Beschriftungs-Feldwerte anstelle der Kontonummern.

SET BLANKINDENT=ON 
TABLE FILE CENTGL
PRINT GL_ACCOUNT_PARENT
FOR GL_ACCOUNT 
1000 WITH CHILDREN 2 AS CAPTION 
END

Die Ausgabe wird wie folgt angezeigt.

                                    Parent
                                    ------
Profit Before Tax                         
  Gross Margin                      1000  
    Sales Revenue                   2000  
    Cost Of Goods Sold              2000  
  Total Operating Expenses          1000  
    Selling Expenses                3000  
    General + Admin Expenses        3000  
  Total R+D Costs                   1000  
    Salaries                        5000  
    Misc. Equipment                 5000  

Hinweis: Wenn die Anfrage GET CHILDREN anstatt WITH CHILDREN vorgibt, wird die Zeile für den übergeordneten Wert (1000, Gewinn vor Steuern) in der Reportausgabe nicht angezeigt.

SET FORMULTIPLE=ON

x

TABLE FILE filenameSUM ...
FOR hierarchyfld 
parentvalue ADD [n|ALL]
 [AS CAPTION|'text'] [LABEL label]
.
.
.
END

Hierbei gilt:

filename

Ist der Name der Datei, die in der FML-Anfrage verwendet werden soll. Falls die Hierachie für diese Anfrage nicht automatisch geladen werden kann, muss sie zuvor mit dem LOAD CHART-Befehl geladen worden sein.

hierarchyfld

Ist der Name des Hierarchiefeldes. Falls die Anfrage auf eine verbundene Struktur verweist, muss der Name der Feldname aus der Hostdatei sein. Der Aliasname wird nicht unterstützt.

parentvalue

Ist der übergeordnete Wert, der den Anfangspunkt der Aggregation in der Hierarchie bestimmt.

ADD

Zeigt das übergeordnete Element und n Ebenen untergeordneter Elemente in einer Zeile an, und summiert die numerischen Datenwerte, die in der Zeile angezeigt werden. Dies entspricht der FML-Syntax parentvalue oder CHILD1 OR CHILD2 OR CHILD3 und mehr, falls zutreffend.

Um nur die Summe der untergeordneten Elemente anzuzeigen, müssen Sie sowohl die übergeordnete Zeile als auch die Summenzeile anzeigen und ein RECAP verwenden, um die übergeordnete Zeile von der Summe abzuziehen. Beispiel:

FOR ... 
parentvalue                 OVER 
parentvalue ADD 1           OVER
RECAP CHILDSUM = R2-R1;

n|ALL

Ist eine positive ganze Zahl zwischen 1 und 99, die die Anzahl der Ebenen in der Hierarchie angibt, die aggregiert werden sollen. ALL ist der Defaultwert. Somit werden, wenn n nicht angegeben wird, alle untergeordneten Elemente in die Summe aufgenommen. Wenn n 1 ist, werden nur direkt untergeordnete Elemente aufgenommen. Wenn n 2 ist, werden direkt untergeordnete Elemente und ihnen direkt untergeordnete Elemente aufgenommen. ADD 99 enthält bis zu 99 Ebenen untergeordneter Elemente. ALL ist ein Synonym für 99.

CAPTION

Gibt an, dass die Beschriftung des übergeordneten Werts für die gesamte Zeile angezeigt wird.

Beachten Sie, dass die AS CAPTION-Phrase für alle Tag-Zeilen unterstützt wird, einschließlich der Zeilen, die die GET CHILDREN- oder ADD-Syntax nicht verwenden. Es muss jedoch die Hierarchie definiert werden (durch Angabe des PARENT_OF-Attributs), um die Beschreibungswerte zu laden und anzuzeigen. Falls die Hierarchie nicht definiert wurde, wird die AS CAPTION-Phrase ignoriert.

'text'

Ist eine Textfolge, die als Zeilentitel für die Gesamtzeile verwendet werden soll. Das CAPTION-Feld, das in der Masterdatei definiert wurde, wird in der Reportausgabe nicht als Beschreibung verwendet.

Label

Ist ein explizites Zeilenlabel. Alle erzeugten Zeilen werden mit dem angegebenen Labeltext beschriftet.

Nach oben

Beispiel: Eine Summenzeile für eine FML-Hierachie anzeigen

Die CENTSYSF-Datenquelle enthält detaillierte finanzielle Daten. Um die Kontenhierarchie in der CENTGL-Datenquelle mit diesen finanziellen Daten zu verwenden, werden die zwei Datenquellen verbunden. Die Daten in CENTSYSF werden mit natürlichen Zeichen gespeichert, was bedeutet, dass Einnahmen und Verbindlichkeiten als negative Zahlen gespeichert werden. Der Teil der Hierarchie, der in der Anfrage verwendet wird, enthält nur positive Daten.

Beachten Sie, dass der Join nicht eindeutig sein muss, da die Hierachie im Hostsegment definiert wird.

Zuerst zeigt der WITH CHILDREN-Befehl die Zeilen der Hierachie an, beginnend mit dem Konto Absatzkosten (3100). Beachten Sie, dass nur Konten ohne untergeordnete Elemente in dieser detaillierten Datenquelle aufgefüllt werden. Der ADD-Befehlt erstellt dann eine Zeile, die die Summe des Kontos 3100 und aller ihm untergeordneten Elemente ist.

SET BLANKINDENT=ON 
SET FORMULTIPLE=ON
JOIN SYS_ACCOUNT IN CENTGL TO ALL SYS_ACCOUNT IN CENTSYSF
TABLE FILE CENTGL
SUM NAT_AMOUNT/D10.0 NAT_YTDAMT/D10.0
FOR GL_ACCOUNT 
3100 WITH CHILDREN ALL AS CAPTION OVER 
BAR                               OVER 
3100 ADD AS CAPTION 
IF PERIOD EQ '2002/03'
END

Die Ausgabe wird wie folgt angezeigt.

x

TABLE FILE filename 
SUM ...
FOR hierarchyfld 
parentvalue {GET|WITH} CHILD[REN] [n|ALL] ADD [m|ALL]
 [AS CAPTION|'text'] [LABEL label]
.
.
.
END

Hierbei gilt:

filename

Ist der Name der Datei, die in der FML-Anfrage verwendet wird. Falls die Hierachie für diese Anfrage nicht automatisch geladen werden kann, muss sie zuvor mit dem LOAD CHART-Befehl geladen worden sein.

hierarchyfld

Ist der Name des Hierarchiefeldes. Falls die Anfrage auf eine verbundene Struktur verweist, muss der Name der Feldname aus der Hostdatei sein. Der Aliasname wird nicht unterstützt.

parentvalue

Ist der übergeordnete Wert, der den Anfangspunkt der Aggregation in der Hierarchie bestimmt.

GET|WITH

GET legt fest, dass die erste Zeile, die im Report erzeugt wird, die konsolidierte Zeile für das erste untergeordnete Element des übergeordneten Werts ist. WITH legt fest, dass die erste Zeile, die im Report erzeugt wird, die konsolidierte Zeile für den übergeordneten Wert ist, gefolgt von den konsolidierten Zeilen für jedes ihm untergeordnete Element, bis zu der durch n angegebenen Ebene.

n|ALL

Ist eine positive ganze Zahl zwischen 1 und 99, die die Anzahl der Ebenen untergeordneter Elemente, die angezeigt werden sollen, angibt. Die Ausgabezeile für jedes untergeordnete Element ist die Summe des untergeordneten Elements und aller ihm untergeordneten Elemente bis zu der Tiefe, die für die ADD-Option angegeben wurde. Der Defaultwert ist 1. Somit hat, wenn n nicht angegeben wird, jedes direkt untergeordnete Element eine Zeile im Report. Wenn n 2 ist, haben sowohl direkt untergeordnete Element als auch die ihnen direkt untergeordneten Elemente eine Zeile in der Reportausgabe. ALL ist ein Synonym für 99.

ADD

Summiert die Hierarchie bis zur über m angegebenen Tiefe für jede Zeile, die mit den Befehlen GET oder WITH CHILDREN erzeugt wurde.

mALL

Ist eine positive ganze Zahl zwischen 1 und 99, die die Anzahl der Ebenen untergeordneter Elemente, die in jeder Zeile des Reports konsolidiert werden sollen, angibt. Falls eine Zahl, die größer als 99 ist, angegeben wurde, wird eine Warnmeldung angezeigt und m auf 99 gestellt. Der Defaultwert ist ALL. Somit summiert, wenn m nicht angegeben wird, die konsolidierte Zeile alle untergeordneten Elemente. Wenn m 2 ist, werden nur direkt untergeordnete Elemente und die ihnen direkt untergeordneten Elemente für jede Zeile in der Reportausgabe konsolidiert. ADD 99 aggregiert untergeordnete Elemente bis zu 99 Ebenen. ALL ist ein Synonym für 99.

CAPTION

Gibt an, dass die Beschriftung des übergeordneten Werts für die gesamte Zeile angezeigt wird.

Beachten Sie, dass die AS CAPTION-Phrase für alle Tag-Zeilen unterstützt wird, einschließlich der Zeilen, die die GET CHILDREN- oder ADD-Syntax nicht verwenden. Es muss jedoch die Hierarchie definiert werden (durch Angabe des PARENT_OF-Attributs), um die Beschreibungswerte zu laden und anzuzeigen. Falls die Hierarchie nicht definiert wurde, wird die AS CAPTION-Phrase ignoriert.

'text'

Ist eine Textfolge, die als Zeilentitel für die Gesamtzeile verwendet werden soll. Das CAPTION-Feld, das in der Masterdatei definiert wurde, wird in der Reportausgabe nicht als Beschreibung verwendet.

Label

Ist ein explizites Zeilenlabel. Alle erzeugten Zeilen werden mit dem angegebenen Labeltext beschriftet.

Nach oben

Beispiel: FML-Hierarchiedaten konsolidieren

In der folgenden Anfrage zeigt der erste WITH CHILD-Befehl die Detaildaten für die Hierarchie an, beginnend mit dem Konto 3100. Der nächste WITH CHILD-Befehl erstellt eine konsolidierte Zeile für das übergeordnete Konto (3100) und für jedes direkt untergeordnete Element.

SET BLANKINDENT=ONSET FORMULTIPLE=ON
JOIN SYS_ACCOUNT IN CENTGL TO ALL SYS_ACCOUNT IN CENTSYSF
TABLE FILE CENTGL
SUM NAT_AMOUNT/D10.0 NAT_YTDAMT/D10.0
FOR GL_ACCOUNT 
3100 WITH CHILDREN ALL AS CAPTION      OVER 
" "                                    OVER
BAR AS =                               OVER
" "                                    OVER 
3100 WITH CHILDREN ADD AS CAPTION 
IF PERIOD EQ '2002/03'
END

Beachten Sie, dass der Join nicht eindeutig sein muss, da die Hierachie im Hostsegment definiert wird.

In der folgenden Ausgabe zeigt der obere Teil die detaillierten Daten an. Der untere Teil zeigt die konsolidierten Daten an. Im konsolidierten Teil des Reports:

• Gibt es eine Zeile für das übergeordnete Element, die die Summe dieses Elements sowie aller ihm untergeordneten Elemente aller Ebenen ist.
• Gibt es eine Zeile für jedes direkt untergeordnete Element des Kontos Absatzkosten (3100): Werbung, Werbungsausgaben, Gesamtmarketing und Boni/Provisionen.
• Die Zeile für Werbung ist die Summe dieser Zeile und aller untergeordneten Elemente. Falls mehrere Ebenen untergeordneter Elemente vorhanden sind, werden sie alle der Summe hinzugefügt. Die anderen 3100 untergeordneten Elemente haben keine ihnen untergeordneten Elemente. Die Summe in jeder dieser Zeilen besteht somit nur aus dem übergeordneten Element.

Wenn Sie GET CHILDREN anstelle von WITH CHILDREN verwenden, wird die jeweils oberste Zeile in allen Teilen der Ausgabe eliminiert. Die verbleibenden Zeilen bleiben gleich.

Die folgende Anfrage zeigt eine konsolidierte Zeile für das Konto 2000 und für alle ihm direkt untergeordneten Elemente und diesen direkt untergeordneten Elementen an.

SET FORMULTIPLE=ON
JOIN SYS_ACCOUNT IN CENTGL TO ALL SYS_ACCOUNT IN CENTSYSF
TABLE FILE CENTGL
SUM NAT_AMOUNT/D10.0 NAT_YTDAMT/D10.0
FOR GL_ACCOUNT 
2000 WITH CHILDREN 2 ADD AS CAPTION 
IF PERIOD EQ '2002/03'
END

Die Ausgabe wird wie folgt angezeigt.

TABLE FILE chartfile 
BY parentfield BY hierarchyfield 
[SUM captionfield]
END

parentfield     hierarchyfield 
-----------     -------------- 
parentvalue1    child1 
parentvalue1    child2
parentvalue2    child3 
  .
  .
  .

x

Sie können die Hierarchiedaten manuell laden, wenn Sie eine Hierarchie, die in einer Masterdatei definiert wurde, für eine Datenquelle verwenden müssen, die mit der Hierarchiedatei nicht verbunden ist, aber die das gleiche Hierarchiefeld enthält.

Wie viele Diagramme geladen werden können hängt davon ab, wie viel Speicherplatz verfügbar ist. Diagramme werden automatisch gelöscht, wenn WebFOCUS beendet wird.

LOAD CHART chartfile[.sega].hierarchyfld 
   [FOR requestfile[[.segb].fieldb]]

Hierbei gilt:

chartfile

Ist der Name der Masterdatei, die die Hierachieinformationen enthält.

sega

Ist der Name des Segments, das das Hierarchiefeld enthält. Der Segmentname ist nur dann erforderlich, wenn ein Feld in einem anderen Segment der Struktur den gleichen Feldnamen wie das Hierarchiefeld hat.

hierarchyfld

Ist das Hierarchiefeld. Es ist erforderlich, da eine Masterdatei mehrere Hierarchien definieren kann.

FOR

Lädt eine Hierarchie, die in einer Masterdatei definiert wurde, die in der FML-Reportanfrage nicht verwendet wurde. Wenn beispielsweise die Masterdatei B die Hierarchieinformationen enthält, aber die Masterdatei A in der Anfrage verwendet wurde (und Masterdatei A und B nicht verbunden wurden), geben Sie den folgenden LOAD CHART-Befehl vor der FML-Anfrage aus:

LOAD CHART B.FLDB FOR A.FLDA
TABLE FILE A ...

requestfile

Ist der Name der Masterdatei, die in der FML-Anfrage verwendet wird.

segb

Ist der Name des Segments, das die Hierarchiefeldwerte in der Masterdatei enthält, die in der FML-Anfrage verwendet wird. Ist nicht erforderlich, wenn es denselben Namen wie sega hat.

fieldb

Ist das Feld in der Masterdatei, die in der FML-Anfrage angegeben wurde, das die Werte des Hierarchiefeldes enthält. Ist nicht erforderlich, wenn es denselben Namen wie das Hierarchiefeld hat.

Hinweis:

• Wenn Sie den LOAD CHART-Befehl mehrere Male für dieselbe Hierarchie ausgeben, überlagert die neue Hierarchie die alte Version im Speicher.
• Wenn Sie den LOAD CHART-Befehl für eine Datenquelle ausgeben, die dynamisch mit der Hierarchiedatei verbunden ist, müssen Sie den JOIN-Befehl vor der Ausgabe des LOAD CHART-Befehls ausgeben.

x

• PROPERTY und REFERENCE werden auf die HOLD-Masterdateien übertragen, wenn HOLDATTR auf ON gestellt ist.
• Die folgende Einstellung ist dann erforderlich, wenn Sie einen Datensatz in mehr als einer Zeile einer FML-Anfrage verwenden möchten (z. B. sowohl für eine Detailzeile als auch für eine Summenzeile):

  SET FORMULTIPLE=ON

• Wenn Sie Reports über eine Roll-Up-Datenquelle wie ESSBASE erstellen, sind die Datenwerte, die für die übergeordnete Instanz gespeichert werden, ein Aggregat aller untergeordneter Elemente. Verwenden Sie die ADD-Funktion nicht mit konsolidierten Daten.
• Wenn Sie Reports über eine Datenquelle mit freigegebenen Elementen (wie ESSBASE) erstellen, wobei dieselben Daten mehrere Male mit unterschiedlichen Hierarchiefeldwerten definiert werden können, werden Daten, die zwei unterschiedliche übergeordnete Elemente haben, in einer Summierung zweimal gezählt. Um diese doppelte Aggregation zu verhindern, verwenden Sie den FST-Operator im SUM-Befehl für die geteilten Felder.