x

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

où :

filename

Est le nom du fichier à utiliser dans la requête FML. Si l'hiérarchie pour cette requête ne peut pas être chargée automatiquement, il faut qu'elle ait été chargée auparavant en lançant la commande LOAD CHART.

hierarchyfld

Est le nom de champ d'hiérarchie. Si la requête fait référence à une structure jointe, le nom doit être le nom de champ du fichier hôte. L'alias n'est pas supporté.

parentvalue

est la valeur parent pour laquelle les données enfant sont à récupérer.

GET CHILDREN

affiche la hiérarchie à partir du premier enfant de la première parentvalue (valeur parent) spécifiée. Le parent n'est pas compris dans l'affichage. (Cela correspond à la syntaxe FML CHILD1 OVER CHILD2 OVER...).

WITH CHILDREN

affiche la hiérarchie à partir de la parentvalue (valeur parent) spécifiée. Le parent est compris dans l'affichage. (Cela correspond à la syntaxe parentvalue OVER CHILD1 OVER CHILD2 OVER ...)

n|ALL

est un nombre entier positif entre 1 et 99, qui spécifie le nombre de niveaux de l'hiérarchie à afficher. Si un nombre supérieur à 99 est spécifié, un message d'avertissement s'affiche et n est mis à 99. La valeur par défaut est 1. Par conséquent, si n est omis, seuls les enfants directs s'affichent. GET ou WITH CHILDREN 2 affiche des enfants et petits-enfants directs. GET ou WITH CHILDREN 99 affiche des enfants jusqu'à quatre-vingt dix-neuf niveaux. ALL est synonyme de 99. Chaque instance enfant s'affiche au-dessus de celle qui la suit. Des niveaux successifs du champ d'hiérarchie sont indentés deux espaces du niveau précédent.

LEGENDE

indique que les valeurs de légende à afficher doivent être prises du champ défini comme étant la légende (CAPTION) dans le fichier Master.

Notez que la phrase AS CAPTION est supportée pour les lignes balisées, y compris celles qui n'utilisent pas la syntaxe GET/WITH CHILDREN ou ADD. Cependant, l'hiérarchie doit être définie (en spécifiant l'attribut PARENT_OF) afin de charger et afficher les valeurs de légende. Si l'hiérarchie n'est pas définie, la phrase AS CAPTION est ignorée.

'text'

Est une chaîne de texte à utiliser comme titre de ligne pour les valeurs de champ d'hiérarchie. Le champ CAPTION défini dans le fichier Master n'est pas utilisé comme légende dans la sortie de rapport.

étiquette

Est un label de ligne explicite. Chaque ligne générée est labelée avec le texte de label spécifié.

Remarque : la hiérarchie s'affiche triée par le champ parent et, au sein du parent, triée par le champ de hiérachie.

Pour plus d'informations sur les fonctions FMLFOR, FMLLIST, FMLCAP, et FMLINFO, qui renvoient les valeurs de balises et les légendes utilisées dans une requête FML, consultez Utiliser les fonctions .

Haut de page

Exemple : Afficher une hiérarchie FML

La requête suivante affiche deux niveaux de numéros de compte, en commençant par le compte 3000 :

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

La sortie est montrée comme ce qui suit :

             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

Remarque : Notez que si la requête spécifie GET CHILDREN au lieu de WITH CHILDREN, la ligne de la valeur parent (3000) ne s'affiche pas dans la sortie de rapport.

Haut de page

Exemple : Affichage d'une hiérarchie FML avec des légendes

La requête suivante affiche deux niveaux d'un graphique d'une hiérarchie de comptes, en commençant par le compte 1000 (le haut de la hiérarchie), et affiche les valeurs du champ de légende au lieu des numéros de compte.

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

La sortie est montrée comme ce qui suit :

                                    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  

Remarque : notez que si la requête spécifie la commande GET CHILDREN au lieu de WITH CHILDREN, la ligne de la valeur parent (1000, Profit Before Tax) ne s'affiche pas dans la sortie de rapport.

SET FORMULTIPLE=ON

x

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

où :

filename

Est le nom du fichier à utiliser dans la requête FML. Si l'hiérarchie pour cette requête ne peut pas être chargée automatiquement, il faut qu'elle ait été chargée auparavant en lançant la commande LOAD CHART.

hierarchyfld

Est le nom de champ d'hiérarchie. Si la requête fait référence à une structure jointe, le nom doit être le nom de champ du fichier hôte. L'alias n'est pas supporté.

parentvalue

est la valeur parent qui détermine le point de début dans la hiérarchie pour l'agrégation.

AJOUTER

affiche les niveaux parent et les niveaux n de ses enfants sur une ligne, totalisant les valeurs de données numériques qui s'affichent sur la ligne. Ceci correspond à la syntaxe FML parentvalue ou CHILD1 OR CHILD2 OR CHILD3 et plus, si applicable.

Pour afficher uniquement la somme des enfants, vous devez afficher la ligne parent, afficher la ligne récapitulative et utiliser l'attribut RECAP pour soustrayer la ligne parent de la somme. Par exemple :

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

n|ALL

Est un nombre entier positif entre 1 et 99, qui spécifie le nombre de niveaux de l'hiérarchie à afficher. ALL est la valeur par défaut. Par conséquent, si n est omis, seuls les enfants directs s'affichent. Si n est 1, seuls les enfants directs sont compris. Si n est 2, les enfants et petits-enfants directs sont compris. ADD 99 inclut jusqu'à 99 niveaux d'enfants. ALL est synonyme de 99.

LEGENDE

Indique que la légende de la valeur parent s'affiche pour la ligne de total.

Notez que la phrase AS CAPTION est supportée pour les lignes balisées, y compris celles qui n'utilisent pas la syntaxe GET CHILDREN ou ADD. Cependant, l'hiérarchie doit être définie (en spécifiant l'attribut PARENT_OF) afin de charger et afficher les valeurs de légende. Si l'hiérarchie n'est pas définie, la phrase AS CAPTION est ignorée.

'text'

est une chaîne de texte à utiliser comme titre de ligne pour la ligne agrégée. Le champ CAPTION défini dans le fichier Master n'est pas utilisé comme légende dans la sortie de rapport.

étiquette

Est un label de ligne explicite. Chaque ligne générée est labelée avec le texte de label spécifié.

Haut de page

Exemple : Affichage d'une ligne de synthèse pour une hiérarchie FML

La source de données CENTSYSF contient des données financières au niveau de détails. Pour utiliser l'hiérarchie de compte dans la source de données CENTGL avec ces données financières, les deux sources de données sont jointes. Les données dans CENTSYSF sont stockées avec des signes naturels, qui veut dire, du point de vue financier, que les revenus et dettes sont stockés comme numéros négatifs. La partie de l'hiérarchie utilisée dans cette requête ne contient que des données positives.

Notez que la jointure ne doit pas être unique, parce que l'hiérarchie est définie dans le segment hôte.

Premièrement la commande WITH CHILDREN affiche les lignes de la hiérarchie en commençant par le compte (Selling Expenses). Notez que seulement les comptes sans enfants sont remplis dans cette source de données au niveau de détails. Ensuite, la commande ADD crée une ligne qui est la somme du compte 3100 et tous ses enfants :

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

La sortie est montrée comme ce qui suit :

x

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

où :

filename

est le nom du fichier à utiliser dans la requête FML. Si la hiérarchie pour cette requête ne peut pas être chargée automatiquement, il faut qu'elle ait été chargée auparavant en lançant la commande LOAD CHART.

hierarchyfld

Est le nom de champ d'hiérarchie. Si la requête fait référence à une structure jointe, le nom doit être le nom de champ du fichier hôte. L'alias n'est pas supporté.

parentvalue

est la valeur parent qui détermine le point de début dans la hiérarchie pour l'agrégation.

GET|WITH

GET spécifie que la première ligne dans le rapport est la ligne consolidée du premier enfant de la valeur parent. WITH spécifie que la première ligne générée dans le rapport est la ligne liée de la valeur parent, suivie des lignes liées de chacun de ses enfants, jusqu'au niveau spécifié par n.

n|ALL

Est un nombre entier positif entre 1 et 99, qui spécifie le nombre de niveaux d'enfants à afficher. La ligne de sortie de chaque enfant est la somme de cet enfant et de ses enfants jusqu'au niveau spécifié pour l'option ADD. La valeur par défaut est 1. Par conséquent, si n est omis, chaque enfant direct a une ligne dans le rapport. Si n est 2, les enfants et petits-enfants directs ont chacun une ligne dans la sortie de rapport. ALL est synonyme de 99.

AJOUTER

totalise la hiérarchie jusqu'au niveau spécifié par m pour chaque ligne générée par les commandes GET ou WITH CHILDREN.

m|ALL

est un nombre entier positif entre 1 et 99, qui spécifie le nombre d'enfants à consolider sur chaque ligne de la sortie de rapport. Si un nombre supérieur à 99 est spécifié, un message d'avertissement s'affiche et m est mis à 99. ALL est la valeur par défaut. Par conséquent, si m est omis, la ligne liée totalise tous les enfants. Si m est 2, seuls les enfants et petits-enfants directs sont liés pour chaque ligne dans la sortie de rapport. ADD 99 regroupe les enfants jusqu'à 99 niveaux. ALL est synonyme de 99.

LEGENDE

Indique que la légende de la valeur parent s'affiche pour la ligne de total.

Notez que la phrase AS CAPTION est supportée pour les lignes balisées, y compris celles qui n'utilisent pas la syntaxe GET CHILDREN ou ADD. Cependant, l'hiérarchie doit être définie (en spécifiant l'attribut PARENT_OF) afin de charger et afficher les valeurs de légende. Si l'hiérarchie n'est pas définie, la phrase AS CAPTION est ignorée.

'text'

est une chaîne de texte à utiliser comme titre de ligne pour la ligne agrégée. Le champ CAPTION défini dans le fichier Master n'est pas utilisé comme légende dans la sortie de rapport.

étiquette

Est un label de ligne explicite. Chaque ligne générée est labelée avec le texte de label spécifié.

Haut de page

Exemple : Unification de données de hiérarchie FML

Dans la requête suivante, la première commande WITH CHILD affiche les données de détail pour l'hiérarchie en commençant par le compte 3100. La prochaine commande WITH CHILD crée une ligne consolidée pour le compte parent (3100) et pour chaque enfant direct :

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

Notez que la jointure ne doit pas être unique, parce que l'hiérarchie est définie dans le segment hôte.

Dans la sortie suivante, la partie supérieure affiche les données au niveau de détails. La partie inférieure affiche les données consolidées. Dans la partie consolidée du rapport :

• Il y a une ligne pour le parent qui est la somme d'elle-même et tous ses enfants à tous les niveaux.
• Il existe une ligne pour chaque enfant direct du compte Selling Expenses(3000) : Advertising, Promotional Expenses, Joint Marketing et Bonuses/Commissions.
• La ligne « Advertising » est la somme d'elle-même et tous ses enfants. Si la ligne a des niveaux d'enfants multiples, ils sont tous ajoutés à la somme. Comme les autres enfants directs du compte 3100 n'ont pas d'enfants, la somme de ces lignes-là se compose uniquement de la valeur parent.

L'utilisation de GET CHILDREN au lieu de WITH CHILDREN élimine la première ligne de chaque partie de la sortie. Les lignes restantes ne changent pas.

La requête suivante affiche une ligne unifiée pour le compte 2000 et chacun de ses enfants et petits-enfants directs.

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

La sortie est montrée comme ce qui suit :

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

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

x

Il vous est possible de charger manuellement les données d'hiérarchie si vous avez besoin d'utiliser une hiérarchie définie dans un fichier Master contre une source de données qui n'est pas jointe au ficher d'hiérarchie mais qui contient le même champ d'hiérarchie.

La mémoire disponible dicte le nombre de diagrammes pouvant être chargés. Les diagrammes sont automatiquement déchargés lorsque WebFOCUS s'interrompt.

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

où :

chartfile

est le nom du fichier Master qui contient les informations de hiérarchie.

sega

Est le nom du segment qui contient le champ d'hiérarchie. Le nom de segment n'est requis qui si un champ dans un autre segment de la structure a le même nom de champ que le champ d'hiérarchie.

hierarchyfld

est le champ de hiérarchie. Il est requis parce qu'un ficher Master peut définir des hiérarchies multiples.

FOR

Charge une hiérarchie définie dans un fichier Master qui n'est pas utilisée dans la requête de rapport FML. Par exemple, si le fichier Master B comprend les informations d'hiérarchie mais que le fichier Master B est utilisée dans la requête (sans jointure entre les fichiers Master A et B), lancez la commande LOAD CHART suivante avant la requête FML :

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

requestfile

est le nom du fichier Master à utiliser dans la requête FML.

segb

est le nom du segment qui contient les valeurs de champ de hiérarchie dans le fichier Master utilisé dans la requête FML. Il n'est pas requis s'il a le même nom que sega.

fieldb

Est le champ dans le fichier Master spécifié dans la requête FML qui contient les valeurs du champ d'hiérarchie. Il n'est pas requis s'il a le même nom que le champ d'hiérarchie.

Remarque :

• Si vous lancez la commande LOAD CHART plusieurs fois pour une même hiérarchie, la nouvelle hiérarchie recouvre la version précédente en mémoire.
• Si vous lancez la commande LOAD CHART pour une source de données qui est jointe dynamiquement au fichier d'hiérarchie, vous devez lancer la commande JOIN avant de lancer la commande LOAD CHART.

x

• PROPERTY et REFERENCE sont propagés aux fichiers Master HOLD lorsque HOLDATTR est mis à ON.
• Le paramètre suivant est requis afin d'utiliser un enregistrement de données dans plus d'une ligne d'une requête FML (par exemple, la ligne de détail et récapitulative) :

  SET FORMULTIPLE=ON

• En faisant un rapport contre une source de données enroulée telle que ESSBASE, les valeurs de données stockées pour l'instance parent sont un agrégat de tous ses enfants. Vous ne devez pas utiliser la fonctionnalité ADD avec les données consolidées.
• En faisant un rapport contre une source de données avec des membres partagés (tels que ESSBASE), dans laquelle les mêmes données peuvent être définies plusieurs fois avec différentes valeurs d'hiérarchie, les données partagées par deux parents différents sont comptées deux fois dans l'opération d'agrégation. Pour éviter cette agrégation double, utilisez l'opérateur FST dans la commande SUM pour les champs partagés.