PAGE / PÁGINA

English (Español a continuación)

The following commands allow to control the length of the pages and the introduction of page breaks, as well as their centering and margin.

  • PAGELENGTH
  • NEWPAGE
  • PAGEONDIMENSION
  • SUPFEED / FEEDON
  • SETCENTER
  • LMARGIN

1.- PAGELENGTH

Set the number of lines per page. Its structure is:

  • {PAGELENGTH [Number]}

The number is optional and indicates the number of lines on the page; If this number is not indicated or this command is not used, Essbase applies the default value of 66 lines per page.

After the number of lines indicated, Essbase enters a page break (unless the {SUPFEED} command has been activated.

Example:

  • {PAGELENGTH 48}

This command is placed at the top of the Report Script (before the Page / Columns / Rows description).

This command is not compatible with other commands, such as:

  • TABDELIMIT

2.- NEWPAGE

Starts a new page regardless of the number of lines on the current page. Its structure is:

  • {NEWPAGE}

This command is placed in the Report Script block corresponding to the definition of the rows, following the member after which you want to include a new page.

For example:

  • <PAGE(…)
  • …
  • <ROW(“Markets”,”Products”,”Sellers”)
  • Germany
  • {NEWPAGE}
  • Spain
  • {NEWPAGE}
  • France
  • {NEWPAGE}
  • …

This Report Script includes a page break after the data for Germany, Spain, France…

This command is not compatible with other commands, such as:

  • SUPEMPTYROWS
  • TABDELIMIT

3.- PAGEONDIMENSION

Starts a new page each time the member of the dimension to which the indicated member belongs changes. Its structure is:

  • {PAGEONDIMENSION “member”}

Some considerations:

  • “Member”: any member of the dimension that you want to use to introduce new pages:
    • Every time the member of that dimension changes, a new page is included with its corresponding headers.
  • Several PAGEONDIMENSION commands can be included, selecting different dimensions. A change in the Report of any element of the indicated dimensions starts a new page.

To later override the effect of this command, use the {NOPAGEONDIMENSION} command. Its syntax is:

  • {NOPAGEONDIMENSION “member”}

Member: member of the same dimension as the one declared in the {PAGEONDIMENSION} command whose effect is to be overridden.

When the {PAGEONDIMENSION} command is used in conjunction with the {UNAMEONDIMENSION} or {SKIPONDIMENSION} commands, they are executed in the following order:

  • {UNAMEONDIMENSION}
    • Inserts an underlined line each time the member of the dimension to which the indicated member belongs changes. Its structure is: {UNAMEONDIMENSION “member”}.
  • {SKIPONDIMENSION}
    • Inserts a blank line each time the member of the dimension to which the indicated member belongs changes. Its structure is: {SKIPONSIMENSION “member”}
  • {PAGEONDIMENSION}

This command is placed at the top of the Report Script (before the Page / Columns / Rows description).

4.- SUPFEED / FEEDON

In a Report Script, Essbase introduces a new page by default when the established page length is exceeded (by default it is 66 lines but it can be modified with the {PAGELENGHT} command).

The {SUPFEED} command suppresses the introduction of a new page when the established limit is exceeded.

Its syntax is:

  • {SUPFEED}

This command can be placed in the Report Script block corresponding to the definition of the rows, following the member after which you want to cancel the effect of the {PAGELENGHT} command.

Also, if the Report Script consists of different Reports (each of them ending with the corresponding sign !) and you want it not to affect a certain Report, put it at the beginning of it:

  • {PAGELENGTH 50}
  • <PAGE(…)
  • …
  • <ROW(…)
  • …
  • <COLUMN(…)
  • …
  • !
  • {SUPFEED}
  • <PAGE(…)
  • …
  • <ROW(…)
  • …
  • <COLUMN(…)
  • …
  • !

The {FEEDON} command removes the effect of the previous command by re-introducing page breaks when the set limit is exceeded.

Its syntax is:

• {FEEDON}

5.- SETCENTER

This command allows to set the central position of the page that will be used for all the centered texts.

Its structure is:

  • {SETCENTER Number}

The number indicates the position of the center character on the page, counting from the left (regardless of whether a left margin has been set).

If this command is not used, Essbase calculates a default center position based on the default width of the page (which is based on the number of columns included in the Report Script) and the position of the left margin.

  • Except in the column names area where the default center position is calculated relative to the area of ​​the columns with data.

6.- LMARGIN

This command sets the width of the left margin.

Its structure is:

  • {LMARGIN Number}

The number is optional and indicates the number of spaces in the left margin; If no number is indicated or this command is not used, Essbase applies the default value, which is 0.

Example:

  • {LMARGIN 8}

Sets the left margin of the Report Script to 8 characters.

Español

Los siguientes comandos permiten controlar la longitud de las páginas y la introducción de cortes de páginas, así como su centrado y el margen.

  • PAGELENGTH
  • NEWPAGE
  • PAGEONDIMENSION
  • SUPFEED / FEEDON       
  • SETCENTER
  • LMARGIN

1.- PAGELENGTH

Fija el número de líneas por página. Su estructura es:

  • {PAGELENGTH [Número]}

El número es opcional e indica el número de líneas de la página; si no se indica o no se utiliza este comando Essbase aplica el valor por defecto que son 66 líneas por página.

Tras el número de líneas indicando Essbase introduce un corte de página (salvo que se haya activado el comando {SUPFEED}.

Ejemplo:

  • {PAGELENGTH 48}

Este comando se sitúa en la parte superior del Report Script (antes de la descripción de Página / Columnas / Filas).

No es compatible con algunos comandos, como:

  • TABDELIMIT

2.- NEWPAGE

Inicia una nueva página con independencia del número de líneas de la página actual. Su estructura es:

  • {NEWPAGE}

Este comando se sitúa en el bloque del Report Script correspondiente a la definición de las filas, después del miembro a continuación del cual se quiere incluir una nueva página.

Por ejemplo:

  • <PAGE( … )
  • …
  • <ROW(“Mercados”,”Productos”,”Vendedores”)
  • Alemania
  • {NEWPAGE}
  • España
  • {NEWPAGE}
  • Francia
  • {NEWPAGE}
  • …

Este Report Script incluye un corte de página después de los datos de Alemania, España, Francia…

No es compatible con algunos comandos, como:

  • SUPEMPTYROWS
  • TABDELIMIT

3.- PAGEONDIMENSION

Comienza una nueva página cada vez que cambia el miembro de la dimensión a la que pertenece el miembro indicado. Su estructura es:

  • {PAGEONDIMENSION “miembro”}

Algunas consideraciones:

  • “Miembro”: cualquier miembro de la dimensión que se quiere utilizar para introducir nuevas páginas:
    • Cada vez que cambia el miembro de esa dimensión se incluye una nueva página con sus correspondientes cabeceras.
  • Se pueden incluir diversos comandos PAGEONDIMENSION recogiendo diferentes dimensiones. Un cambio en el Report de cualquier elemento de las dimensiones indicadas inicia una nueva página.

Para anular más adelante el efecto de este comando se utiliza el comando {NOPAGEONDIMENSION}. Su sintaxis es:

  • {NOPAGEONDIMENSION “miembro”}

Miembro: miembro de la misma dimensión que la declarada en el comando {PAGEONDIMENSION} cuyo efecto va a anular.

Cuando el comando {PAGEONDIMENSION} se utiliza conjuntamente con los comandos {UNAMEONDIMENSION} o {SKIPONDIMENSION} se ejecutan en el siguiente orden:

  • {UNAMEONDIMENSION}
    • Inserta una línea subrayada cada vez que cambia el miembro de la dimensión a la que pertenece el miembro indicado. Su estructura es: {UNAMEONDIMENSION “miembro”}.
  • {SKIPONDIMENSION}
    • Inserta una línea en blanco cada vez que cambia el miembro de la dimensión a la que pertenece el miembro indicado. Su estructura es: {SKIPONSIMENSION “miembro”}
  • {PAGEONDIMENSION}

Este comando se sitúa en la parte superior del Report Script (antes de la descripción de Página / Columnas / Filas).

4.- SUPFEED / FEEDON

En un Report Script Essbase introduce por defecto una nueva página cuando se supera la longitud establecida de la página (por defecto son 66 líneas pero se puede modificar con el comando {PAGELENGHT}).

El comando {SUPFEED} elimina la introducción de una nueva página cuando se supera el límite establecido.

Su sintaxis es:

  • {SUPFEED}

Este comando se puede colocar en el bloque del Report Script correspondiente a la definición de las filas, después del miembro a continuación del cual se quiere anular el efecto del comando {PAGELENGHT}.

También si el Report Script consta de diferentes Reports (cada uno de ellos finalizado con el correspondiente signo !) y se quiere que no afecta a un determinado Report se pone al principio del mismo:

  • {PAGELENGTH 50}
  • <PAGE( … )
  • …
  • <ROW( … )
  • …
  • <COLUMN( … )
  • …
  • !
  • {SUPFEED}
  • <PAGE( … )
  • …
  • <ROW( … )
  • …
  • <COLUMN( … )
  • …
  • !

El comando {FEEDON} elimina el efecto del comando anterior volviendo a introducir cortes de página cuando se supera el límite establecido.

Su sintaxis es:

  • {FEEDON}

5.- SETCENTER

Este comando permite fijar la posición central de la página que será utilizada por todos los textos centrados.

Su estructura es:

  • {SETCENTER Número}

El número indica la posición del carácter central en la página, comenzando a contar desde la izquierda (sin considerar si se ha fijado un margen izquierdo).

Si no se utiliza este comando Essbase calcula una posición central por defecto basada en la anchura por defecto de la página (que va en función del número de columnas que incluye el Report Script) y la posición del margen izquierdo.

  • Salvo en el área de los nombres de columnas en los que la posición central por defecto se calcula en relación al área de las columnas con datos.

6.- LMARGIN

Este comando fija la anchura del margen de la izquierda.

Su estructura es:

  • {LMARGIN Número}

El número es opcional e indica el número de espacios del margen izquierdo; si no se indica ningún número o no se utiliza este comando Essbase aplica el valor por defecto que es 0.

Ejemplo:

  • {LMARGIN 8}

Fija el margen izquierdo del Report Script en 8 caracteres.

Anuncio publicitario