x

Les commandes RECAP et COMPUTE ont les deux une syntaxe similaire à celle d'autres commandes de sous-total.

{BY|ON} fieldname1 {RECAP|COMPUTE} fieldname2[/format] = expression;
                                      [WHEN expression;]

où :

fieldname1

Est le champ dans la phrase BY. Chaque fois que le champ BY change de valeur, une nouvelle valeur RECAP est calculée.

fieldname2

Est le nom de champ comprenant le résultat de l'expression.

/format

Peut être tout format valable. Le format par défaut est D12.2.

expression

peut être une expression valable, comme le décrit Utilisation d'expressions. L'expression doit terminer par un point virgule.

WHEN expression

Ne peut être utilisée qu'avec RECAP. Elle spécifie l'affichage conditionnel des lignes RECAP, comme le spécifie une expression booléenne (consultez Affichage conditionnel de lignes et de texte récapitulatifs. L'expression doit terminer par un point virgule.

x

• La commande RECAP utilise la valeur actuelle du critère de tri donné, les valeurs de sous-total actuelles de tout champ quantificatif qui s'affiche sous forme de champ d'affichage, ou la dernière valeur des champs alphanumériques.
• RECAP réserve un espace en bas de la page pour assurer que RECAP ne sera pas seul en haut de la page suivante alors que la donnée qu'il présente se trouve sur la page précédente. La même technique est utilisée pour les sous-totaux et les totaux généraux, mais pas pour les sous-pieds de page ou pour les COMPUTEs.
• Les noms de champ dans l'expression doivent être des champs qui s'affichent dans le rapport. C'est-à-dire, ils doivent être des champs d'affichage ou des champs de contrôle de tri.
• Chaque valeur RECAP s'affiche sur une ligne différente. Toutefois, si la requête comprend une commande RECAP et un texte SUBFOOT (pied de page secondaire), la valeur RECAP ne s'affiche que dans le texte SUBFOOT et doit être spécifiée dans le texte à l'aide d'un signe de localisation. (Pour plus d'informations, consultez Utilisation d'en-têtes, pieds de page, titres et étiquettes).
• Les calculs dans une commande RECAP ou COMPUTE peuvent s'afficher partout sous le saut de contrôle, accompagnés de tout texte. (Pour plus d'informations, consultez Utilisation d'en-têtes, pieds de page, titres et étiquettes.)
• Dans une phrase ON, une commande COMPUTE est synonyme de la commande RECAP.
• Le mot RECAP ne peut être spécifié plus de sept fois. Cependant, plus de sept calculs RECAP sont autorisés. Utilisez la syntaxe suivante :

  ON fieldname RECAP field1/format= ... ;field2/format= ... ;
  .
  .
  .

Haut de page

Exemple : Utilisation de RECAP

La requête suivante illustre l'utilisation de la commande RECAP (DEPT_NET) pour déterminer les profits nets de chaque service :

TABLE FILE EMPLOYEE
SUM DED_AMT AND GROSS
BY DEPARTMENT BY PAY_DATE
ON DEPARTMENT RECAP DEPT_NET/D8.2M = GROSS-DED_AMT;
WHEN PAY_DATE GT 820101
END

La sortie est :

DEPARTMENT  PAY_DATE          DED_AMT            GROSS
----------  --------          -------            -----
MIS         81/11/30        $1,406.79        $2,147.75
            81/12/31        $1,406.79        $2,147.75
            82/01/29        $1,740.89        $3,247.75
            82/02/26        $1,740.89        $3,247.75
            82/03/31        $1,740.89        $3,247.75
            82/04/30        $3,386.73        $5,890.84
            82/05/28        $3,954.35        $6,649.50
            82/06/30        $4,117.03        $7,460.00
            82/07/30        $4,117.03        $7,460.00
            82/08/31        $4,575.72        $9,000.00
                                                      
** DEPT_NET           $22,311.98                      
                                                      
PRODUCTION  81/11/30          $141.66          $833.33
            81/12/31          $141.66          $833.33
            82/01/29        $1,560.09        $3,705.84
            82/02/26        $2,061.69        $4,959.84
            82/03/31        $2,061.69        $4,959.84
            82/04/30        $2,061.69        $4,959.84
            82/05/28        $3,483.88        $7,048.84
            82/06/30        $3,483.88        $7,048.84
            82/07/30        $3,483.88        $7,048.84
            82/08/31        $4,911.12        $9,523.84
                                                      
** DEPT_NET           $27,531.14

Haut de page

Exemple : Utilisation de commandes RECAP multiples

Vous pouvez inclure des commandes RECAP ou COMPUTE multiples dans une requête. Cette option vous permet d'effectuer différents calculs à différents ruptures de contrôle.

La requête suivante illustre l'utilisation de commandes RECAP multiples.

TABLE FILE SALES
SUM UNIT_SOLD AND RETURNS
WHERE AREA EQ 'U' 
BY DATE BY AREA BY PROD_CODE
ON DATE RECAP
DATE_RATIO=RETURNS/UNIT_SOLD;
ON AREA UNDER-LINE RECAP
AREA_RATIO=RETURNS/UNIT_SOLD;
END

La sortie est :

DATE   AREA  PROD_CODE  UNIT_SOLD  RETURNS
----   ----  ---------  ---------  -------
10/17  U     B10               30        2
             B17               20        2
             B20               15        0
             C17               12        0
             D12               20        3
             E1                30        4
             E3                35        4
                                          
** AREA_RATIO                      .09    
                                          
** DATE_RATIO                      .09    
                                          
------------------------------------------
10/18  U     B10               13        1
                                          
** AREA_RATIO                      .08    
                                          
** DATE_RATIO                      .08    
                                          
------------------------------------------
10/19  U     B12               29        1
                                          
** AREA_RATIO                      .03    
                                          
** DATE_RATIO                      .03    
                                          
------------------------------------------