Comando DEFINE FIELD

Información de concepto

Definir campos físicos

Define un campo de datos físicos en un formato de tabla de Analytics.

Sintaxis

DEFINE FIELD nombre_campo tipo_datos posición_inicial longitud <decimales|formato_fecha> <NDATETIME> <PIC formato> <AS nombre_visible> <WIDTH caracteres> <SUPPRESSS> <nota_campo>

Parámetros

Nombre Descripción
nombre_campo

El nombre del campo.

Nota

Los nombres de los campos están limitados a 256 caracteres en mayúsculas y minúsculas. El nombre puede incluir un guión bajo ( _ ), pero no puede incluir ningún otro carácter especial ni espacios. El nombre no puede comenzar con un número.

Analytics tiene un número de palabras clave reservadas que no se pueden utilizar como nombres de campo. Para obtener una lista completa, consulte Palabras clave reservadas.
tipo_datos

El tipo de datos que se debe usar al interpretar los datos. Para ver una lista de los tipos de datos admitidos, consulte Tipos de datos admitidos.

Por ejemplo, los números de factura podrían estar almacenados como valores numéricos en el origen de datos. Para tratar estos valores como cadenas en lugar de números, puede definir el campo como datos de caracteres.
posición_inicial

La posición del byte de inicio para el campo en el archivo de datos de Analytics.

Nota

Analytics no Unicode 1 byte = 1 carácter
Analytics Unicode, datos ASCII (ANSI) extendido 1 byte = 1 carácter
Analytics Unicode, datos Unicode 2 bytes = 1 carácter

En general, para los datos Unicode, debe especificar una posición de byte de inicio impar. Si especifica una posición de inicio par, es posible que los caracteres no se vean correctamente.
longitud

La longitud del campo en bytes.

Nota

Analytics no Unicode 1 byte = 1 carácter
Analytics Unicode, datos ASCII (ANSI) extendido 1 byte = 1 carácter
Analytics Unicode, datos Unicode 2 bytes = 1 carácter

Para los datos Unicode, especifique solo un número par de bytes. Si especifica un número de bytes impar, es posible que los caracteres no se vean correctamente.
decimales

opcional

La cantidad de lugares decimales para los campos numéricos.
formato_fecha

opcional

El formato de fecha en los campos de fecha de origen.

Para los campos de fechahora o de hora, utilice PIC formato en su lugar. También puede utilizar PIC formato para campos de fecha.

Si los datos de origen incluyen separadores, tales como barras inclinadas, el usuario debe incluir los separadores en el parámetro formato_fecha. Por ejemplo, si los datos de origen son 12/31/2014, debe ingresar el formato como MM/DD/AAAA. No encierre formato_fecha entre comillas.

NDATETIME

opcional

Los valores de fecha, fechahora u hora almacenados en un campo numérico se tratan como datos de fechahora.

NDATETIME requiere que también especifique el formato de fechahora de origen mediante PIC formato.
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 AnalyticsAnalytics
  • 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.

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.
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.

El ancho visible no puede ser inferior a la longitud de nombre_campo o de nombre_visible.

Si omite WIDTH, el ancho visible se ajusta a la longitud del campo en caracteres.

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.

SUPPRESS

opcional

Sólo se aplica a campos numéricos.

Suprime el cálculo automático del total de un campo numérico en los reportes de Analytics.

El cálculo del total de algunos campos numéricos no es adecuado. Por ejemplo, un campo de costo unitario, o un campo de tasa de descuento.

nota_campo

opcional

El texto de una nota de campo que se agrega a la definición del campo en el formato de tabla.

nota_campo debe ser el último, después de cualquier otro parámetro obligatorio u opcional. El texto no puede ser de varias líneas. No es necesario usar comillas.

Ejemplos

Definición de un campo de caracteres

Define un campo de caracteres denominado Desc_del_prod. El título de la columna en la vista es Descripción del producto.

Analytics no Unicode

  • Comienza en: byte 12 (posición 12 de caracteres)
  • Longitud: 24 bytes (24 caracteres)
DEFINE FIELD Desc_del_prod ASCII 12 24 AS "Descripción del producto"

Analytics Unicode, datos ASCII (ANSI) extendido

  • Comienza en: byte 12
  • Longitud: 24 bytes (24 caracteres)
DEFINE FIELD Desc_del_prod ASCII 12 24 AS "Descripción del producto"

Analytics Unicode, datos Unicode

  • Comienza en: byte 13
  • Longitud: 48 bytes (24 caracteres)
DEFINE FIELD Desc_del_prod ASCII 13 48 AS "Descripción del producto"

Definición de un campo numérico

Define un campo numérico denominadoCantDisp. En la vista, la columna utiliza el formato de visualización especificado y el título es Cantidad disponible.

  • Comienza en: byte 61
  • Longitud: 10 bytes
  • Lugares decimales: ninguno
DEFINE FIELD CantDisp NUMERIC 61 10 0 PIC "(9.999.999)" AS "Cantidad disponible"

Definición de un campo de fechahora a partir de datos de caracteres

Desde los datos de caracteres de origen, los primeros dos ejemplos a continuación definen un campo de fechahora denominado Fecha_transacción. En los datos de origen, el formato de la fecha es DD/MM/AAAA. No se especifica ningún título de columna, de manera que el título de la columna utiliza el nombre del campo por valor predeterminado.

  • Comienza en: byte 20
  • Longitud: 10 bytes

Aquí, el formato de fecha se especifica utilizando formato_de_fecha:

DEFINE FIELD Fecha_transacción DATETIME 20 10 DD/MM/AAAA

Aquí, el formato de fecha se especifica utilizando PIC formato:

DEFINE FIELD Fecha_transacción DATETIME 20 10 PIC "DD/MM/AAAA"

Al definir campos de fechahora que incluyen datos de la hora, debe usar PIC formato,

El siguiente ejemplo define un campo de fechahora denominado marca_de_hora_correo_electrónico. En los datos de origen, el formato de fechahora es AAAA/MM/DD hh:mm:ss-hh:mm.

  • Comienza en: byte 1
  • Longitud: 25 bytes
DEFINE FIELD Marca_de_hora_correo_electrónico DATETIME 1 25 PIC "AAAA/MM/DD hh:mm:ss-hh:mm"

Definición de un campo de fechahora a partir de datos numéricos

Desde los datos numéricos de origen, define un campo fechahora denominado Marca_de_hora_recepción que tiene el formato de fechahora especificado en los datos de origen.

  • Comienza en: byte 15
  • Longitud: 15 bytes
DEFINE FIELD Marca_de_hora_recepción DATETIME 15 15 PIC "YYYYMMDD.hhmmss"

Definición de un campo de fechahora "numérico"

A partir de los datos numéricos de origen, define un campo numérico denominado Marca_de_hora_recepción que tiene el formato de fechahora especificado en los datos de origen.

El parámetro NDATETIME permite que Analytics trate los valores de fechahora almacenados en el campo numérico como datos de fechahora.

  • Comienza en: byte 15
  • Longitud: 15 bytes
  • Lugares decimales: 6
DEFINE FIELD Marca_de_hora_recepción PRINT15 15 6 NDATETIME PIC "YYYYMMDD.hhmmss"

Definición de un campo de datos físicos que lea los datos empaquetados en el mainframe

Puede usar la opción NDATETIME para crear un campo de datos físico que lea los valores de fecha desde un campo numérico empaquetado.

Analytics no puede reconocer una fecha en un número que está comprimido en menos bytes que uno por dígito y que no muestra un formato de fecha. Como consecuencia, el usuario debe "descomprimir" el número con NDATETIME para obtener el número completo de dígitos y luego especificar el formato de fecha con PIC.

Para indicar con precisión qué números representan el día, el mes y el año, especifique el mismo formato de fecha que se encuentra en el formato del registro empaquetado:

DEFINE FIELD nombre_campo_fecha NUMERIC 1 8 0 NDATETIME PIC "YYYYMMDD"

Observaciones

Si desea obtener más información sobre la forma en la que funciona este comando, consulte Definir campos físicos.

Sobrescritura de campos en un script

Puede sobrescribir un campo en un formato de tabla definiendo un campo que utiliza el mismo nombre que el campo existente. Si SET SAFETY está ajustado en ON, aparece un cuadro de diálogo de confirmación antes de sobrescribir el campo existente.

Para evitar interrumpir un script, puede ajustar SET SAFETY en OFF. El campo existente se sobrescribe sin confirmación adicional.

Tipos de datos admitidos

Categoría de datos Tipo de datos
Carácter ASCII
CUSTOM
EBCDIC
NOTA
PCASCII
UNICODE
Numérico ACCPAC
ACL
BASIC
BINARY (binario)
FLOAT (flotante)
HALFBYTE
IBMFLOAT
MICRO
NUMERIC (numérico)
PACKED (compactado)
PRINT
UNISYS
UNSIGNED
VAXFLOAT
ZONED (zonado)
Fechahora DATETIME
Lógico LOGICAL