Comando DEFINE COLUMN

Crea y agrega una o más columnas a una vista existente.

Sintaxis

DEFINE COLUMN nombre_vista nombre_campo <AS nombre_visible> <POSITION n> <WIDTH caracteres> <PIC formato> <SORT|SORT D> <KEY> <PAGE> <NODUPS> <NOZEROS> <LINE n>

Parámetros

Nombre	Descripción
nombre_vista	La vista a la que se debe agregar la columna.
nombre_campo	El campo para el que se debe crear la columna. Para utilizar un campo de una tabla relacionada, especifique el nombre del campo como nombre_de_tabla.nombre_de_campo.
AS nombre_visible opcional	El nombre visible (título de columna alternativo) para el campo en la vista. Si desea que el nombre visible sea el mismo que el nombre del campo, no use AS. Especifique nombre_visible como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna.
POSITION n opcional	La posición de la columna en la vista en forma numérica de izquierda a derecha: si se omite, la columna se coloca en el último lugar de la derecha en el momento en que se agrega la columna si falta un número de posición, las posiciones de las columnas se ajustan para que sean ubicadas en forma secuencial si ya está en uso un número de posición, la nueva columna se coloca a la izquierda de la columna que ya cuenta con ese número de posición
WIDTH caracteres opcional	El ancho visible del campo en caracteres. El valor que se especifica controla el ancho visible del campo en las vistas y reportes de Analytics. El ancho visible nunca altera los datos; sin embargo, si es más pequeño que la longitud del campo, es posible que oculte datos. Si omite WIDTH, el ancho visible se ajusta al ancho de caracteres que se especificó para el campo en el formato de tabla. Nota Los caracteres especificados por WIDTH son caracteres de ancho fijo. A cada carácter se le asigna la misma cantidad de espacio, sin importar el ancho del carácter real. Por valor predeterminado, las vistas de Analytics utilizan una fuente de ancho proporcional que no coincide con el espaciado de caracteres de ancho fijo. Si desea que exista una correspondencia de uno a uno entre el valor WIDTH y los caracteres de la vista, puede cambiar el ajuste Fuente proporcional en el cuadro de diálogo Opciones a una fuente de ancho fijo, como Courier New.
PIC formato opcional	Nota Se aplica solo a campos numéricos o de fechahora. campos numéricos el formato de visualización de los valores numéricos en las vistas y los reportes de Analytics campos de fechahora el formato físico de los valores de fechahora en los datos de origen (orden de los caracteres de fecha y hora, los separadores, etc.) Nota Para los campos de fechahora, el formato debe coincidir exactamente con el formato físico de los datos de origen. Por ejemplo, si los datos de origen son 12/31/2014, debe ingresar el formato como MM/DD/AAAA. formato debe estar encerrado entre comillas.
SORT \| SORT D opcional	Ordena la columna: orden ascendente SORT orden descendente SORT D
KEY opcional	La columna está designada como un campo de corte en los registros. Los registros se subtotalizan y subdividen cuando el valor de la columna cambia. Se aplican las siguientes restricciones a los campos de salto: debe ser una expresión o un campo de caracteres si un campo de salto se ajusta en la vista, debe ser la columna ubicada en el extremo izquierdo la última columna de la vista no puede ser un campo de salto si tiene más de un campo de salto, todas las columnas ubicadas a la izquierda de cualquier otro campo de salto también deben ser campos de salto
PAGE opcional	Inserta un salto de página cada vez que cambia el valor del campo de salto.
NODUPS opcional	Reemplaza los valores repetidos por valores en blanco en el campo. Por ejemplo, si el nombre del cliente figura en cada registro de factura, el reporte es más fácil de leer si solo se muestra la primera instancia de cada nombre de cliente.
NOZEROS opcional	Reemplaza los valores de cero por valores en blanco en el campo. Por ejemplo, si un reporte incluye una gran cantidad de valores cero en un campo, es más fácil leer el reporte si solo se muestran los valores que no son ceros.
LINE n opcional	El número de líneas en la columna. Si no se especifica ningún valor, la columna tiene, por defecto, una sola línea. El valor de n debe estar entre 2 y 60.

Nombre

Descripción

nombre_vista

La vista a la que se debe agregar la columna.

nombre_campo

El campo para el que se debe crear la columna.

Para utilizar un campo de una tabla relacionada, especifique el nombre del campo como nombre_de_tabla.nombre_de_campo.

AS nombre_visible

opcional

El nombre visible (título de columna alternativo) para el campo en la vista. Si desea que el nombre visible sea el mismo que el nombre del campo, no use AS.

Especifique nombre_visible como una cadena entre comillas. Utilice un punto y coma (;) entre las palabras si desea que haya un salto de línea en el título de la columna.

POSITION n

opcional

La posición de la columna en la vista en forma numérica de izquierda a derecha:

si se omite, la columna se coloca en el último lugar de la derecha en el momento en que se agrega la columna
si falta un número de posición, las posiciones de las columnas se ajustan para que sean ubicadas en forma secuencial
si ya está en uso un número de posición, la nueva columna se coloca a la izquierda de la columna que ya cuenta con ese número de posición

WIDTH caracteres

opcional

El ancho visible del campo en caracteres.

El valor que se especifica controla el ancho visible del campo en las vistas y reportes de Analytics. El ancho visible nunca altera los datos; sin embargo, si es más pequeño que la longitud del campo, es posible que oculte datos.

Si omite WIDTH, el ancho visible se ajusta al ancho de caracteres que se especificó para el campo en el formato de tabla.

Nota

Los caracteres especificados por WIDTH son caracteres de ancho fijo. A cada carácter se le asigna la misma cantidad de espacio, sin importar el ancho del carácter real.

Por valor predeterminado, las vistas de Analytics utilizan una fuente de ancho proporcional que no coincide con el espaciado de caracteres de ancho fijo.

Si desea que exista una correspondencia de uno a uno entre el valor WIDTH y los caracteres de la vista, puede cambiar el ajuste Fuente proporcional en el cuadro de diálogo Opciones a una fuente de ancho fijo, como Courier New.

PIC formato

opcional

Nota

Se aplica solo a campos numéricos o de fechahora.

campos numéricos el formato de visualización de los valores numéricos en las vistas y los reportes de Analytics
campos de fechahora el formato físico de los valores de fechahora en los datos de origen (orden de los caracteres de fecha y hora, los separadores, etc.)
Nota
Para los campos de fechahora, el formato debe coincidir exactamente con el formato físico de los datos de origen. Por ejemplo, si los datos de origen son 12/31/2014, debe ingresar el formato como MM/DD/AAAA.

formato debe estar encerrado entre comillas.

SORT | SORT D

opcional

Ordena la columna:

orden ascendente SORT
orden descendente SORT D

KEY

opcional

La columna está designada como un campo de corte en los registros. Los registros se subtotalizan y subdividen cuando el valor de la columna cambia. Se aplican las siguientes restricciones a los campos de salto:

debe ser una expresión o un campo de caracteres
si un campo de salto se ajusta en la vista, debe ser la columna ubicada en el extremo izquierdo
la última columna de la vista no puede ser un campo de salto
si tiene más de un campo de salto, todas las columnas ubicadas a la izquierda de cualquier otro campo de salto también deben ser campos de salto

PAGE

opcional

Inserta un salto de página cada vez que cambia el valor del campo de salto.

NODUPS

opcional

Reemplaza los valores repetidos por valores en blanco en el campo.

Por ejemplo, si el nombre del cliente figura en cada registro de factura, el reporte es más fácil de leer si solo se muestra la primera instancia de cada nombre de cliente.

NOZEROS

opcional

Reemplaza los valores de cero por valores en blanco en el campo.

Por ejemplo, si un reporte incluye una gran cantidad de valores cero en un campo, es más fácil leer el reporte si solo se muestran los valores que no son ceros.

LINE n

opcional

El número de líneas en la columna. Si no se especifica ningún valor, la columna tiene, por defecto, una sola línea. El valor de n debe estar entre 2 y 60.

Ejemplos

Definición de una vista con seis columnas

Con la tabla AR abierta, usted define una vista denominada Reporte_cuentas_cobrar y define seis columnas. Las columnas se muestran en el orden indicado:

OPEN Cuentas_por_cobrar
DEFINE VIEW Reporte_Cuentas_cobrar OK
DEFINE COLUMN Reporte_Cuentas_cobrar Número AS "Número de cliente" WIDTH 7 KEY
DEFINE COLUMN Reporte_Cuentas_cobrar Date AS "Fecha de factura" WIDTH 10
DEFINE COLUMN Reporte_Cuentas_cobrar Due AS "Fecha de vencimiento" WIDTH 10
DEFINE COLUMN Reporte_Cuentas_cobrar Reference AS "Número de referencia" WIDTH 6
DEFINE COLUMN Reporte_Cuentas_cobrar Type AS "Tipo de transacción" WIDTH 5
DEFINE COLUMN Reporte_Cuentas_cobrar Importe AS "Monto de la transacción" WIDTH 12 PIC "-9999999999.99"

[ Volver al inicio ]

Guía de creación de scripts de ACL 14.1