IM Centro de información de Relationship Resolution, Versión 4.2

Secciones del archivo de script del programa de utilidad de conversión de archivos UMF

El archivo de script para el programa de utilidad de conversión de archivos UMF define cómo se convierten los datos de un archivo de fuente de datos a UMF. El archivo de script contiene varias secciones y parámetros dentro de esas secciones. Las primeras cuatro secciones, GLOBAL, RECORD, IMPORT y EXPORT, se configuran durante el despliegue inicial y no es probable que cambien. La última sección, TRANSFORM, contiene los parámetros que puede que desee personalizar.

Parámetros de la sección [GLOBAL]

La sección GLOBAL incluye parámetros que se aplican a todo el programa de utilidad de conversión de archivos UMF.

STARTWITH
Indica el registro por el que el programa de utilidad de conversión de archivos UMF empieza el proceso.

El valor por omisión para este parámetro es 1. Si importa un conjunto de registros que contiene un conjunto de nombres de campo como primer registro, es aconsejable que se salte ese registro y empezar por el segundo registro del conjunto.

Por ejemplo, para que el programa de utilidad de conversión de archivos UMF se salte el primer registro, especifique el valor 2:
STARTWITH=2

Parámetros de la sección [RECORD]

La sección RECORD incluye parámetros que definen la estructura del archivo de definición para el archivo de fuente de datos de entrada o el archivo UMF de salida. Puede añadir múltiples secciones RECORD, cada una de ellas numerada; normalmente, RECORD1 se utiliza para los archivos de fuente de datos de entrada y RECORD2 se utiliza para los archivos UMF de salida.

DEF
Especifica el archivo que contiene la estructura de datos del archivo de entrada o el archivo de salida. Debe especificar la vía de acceso completa y el nombre de archivo.

No hay ningún valor por omisión.

Por ejemplo, si la sección [RECORD] que contiene este parámetro hace referencia a un archivo UMF de salida, define la vía de acceso y el nombre de archivo para el nombre de archivo de salida:
DEF=path\outputvariables.def
NAME
Especifica un alias para el archivo de definición al que se hace referencia en esta sección [RECORD].

Puesto que este valor se escribe muchas veces al crear este archivo de script, es aconsejable especificar una serie corta.

El valor por omisión para un archivo de entrada es In; el valor por omisión para un archivo de salida es Out. Es válida cualquier valor de serie. Para especificar que el archivo de definición es un archivo de entrada, escriba lo siguiente en esta sección:
NAME=In

Parámetros de la sección [IMPORT]

La sección IMPORT indica al programa de utilidad de conversión de archivos UMF la sección que RECORD debe utilizar y el tipo de datos que debe esperar. Puede añadir múltiples secciones [IMPORT], cada una de ellas numerada de forma exclusiva, por ejemplo, [IMPORT1]. Las claves subsiguientes pueden utilizar el número exclusivo para hacer referencia a esta sección [IMPORT].
RECORD
Especifica la sección [RECORD] del archivo de script que se debe utilizar al importar datos.

No hay ningún valor por omisión.

Para especificar la sección [RECORD1], escriba:
RECORD=1
TYPE
Especifica la estructura de los datos de entrada.

Puesto que el programa de utilidad de conversión de archivos UMF sólo funciona con archivos de ancho fijo, el único valor válido para este parámetro es FW.

Para indicar un archivo de entrada de ancho fijo, escriba:

TYPE=FW

Parámetros de la sección [TRANSFORM]

La sección TRANSFORM define la forma en que el programa de utilidad de conversión transforma los datos de entrada antes de enviarlos de salida. Los parámetros de la sección TRANSFORM se dividen en un parámetro de valores y parámetros de transformación. El parámetro IMPORTER define los valores de transformación. Los parámetros beginseg, tagvalue y endseg, definen el formato de la transformación de datos y el resto de las transformaciones definen cómo se transforman los datos. Los parámetros de transformación modifican cada registro de entrada.
IMPORTER
Este parámetro de valor especifica la sección IMPORT que se debe transformar.

No hay ningún valor por omisión.

Para especificar la sección [IMPORT1], escriba:
IMPORTER=1
beginseg
Indica el principio de un nuevo segmento UMF.

Todas las llamadas a tagvalue colocan valores en la sección TRANSFORM.

Puede utilizar esta clave para incluir sólo segmentos de registro de entrada que contengan códigos específicos.

Por ejemplo, para especificar que es necesario un código LAST_NAME para crear un segmento UMF_ENTITIY, escriba:
beginseg UMF_ENTITY, Requires(LAST_NAME)
tagvalue
Especifica el nombre y los valores correspondientes de códigos UMF nuevos.
Para crear un código UMF denominado NUM_VALUE que contenga el valor de número de seguridad social contenido en el archivo de entrada, escriba:
tagvalue ’NUM_VALUE’,In.SocialSecNum
endseg
Especifica el final de un segmento UMF
Para finalizar un segmento UMF, escriba:
endseg
append
Añade datos de texto o de campo al final de un campo.
Para colocar el contenido del campo StreetName de los datos de entrada al final del campo Addr1 donde combina toda la información de dirección de calle, escriba:
append In.StreetName,Out.Addr1
atrim
Suprime todos los espacios del principio y final del campo.

Esta clave realiza la función de las claves ltrim y rtrim.

Para suprimir espacios del principio y final de un campo, escriba:
atrim
autoinc
Incrementa automáticamente en 1 el valor de un campo.

Puede utilizar esta clave para crear números exclusivos para cada registro. También puede especificar un valor para indicar el número con el que desea empezar.

Por omisión, la numeración empieza por 0.

Para crear un campo denominado docref que contenga un valor incrementado automáticamente que empiece por 35, escriba:

autoinc Out.docref, 35 
copy
Copia caracteres de un campo en otro.

Debe especificar el campo de entrada del que desea copiar y el campo de salida en el que desea copiar.

Para copiar el contenido de un campo denominado StreetName en un campo denominado Addr1, escriba:
copy In.StreetName, Out.Addr1
ctrim
Sustituye dos o más espacios contiguos por un solo espacio en cualquier lugar de una serie.
Para suprimir los espacios adicionales del campo Name, escriba:
ctrim In.Name
ifeq
Ejecuta el siguiente mandato de una secuencia, si el valor especificado es igual al contenido del campo de entrada.

Para comprobar el valor Y del campo Office de cada registro, y si Y está presente para sustituir la Y por una P, escriba:

ifeq In.Office,Y 
replacechar In.Office,Y,P
ifneq
Ejecuta el siguiente mandato de una secuencia, si el valor especificado no es igual al contenido del campo de entrada.

Es opuesto a la clave ifeq.

Para actualizar los registros de los empleados actuales con nuevos códigos de ubicación que indiquen si están en activo, de baja o de vacaciones, pero no actualizar los registros de empleados retirados (status=R), escriba:
ifneq In.Status,R 
copy In.LocCode, Out.LocCode
left
Extrae una subserie de la izquierda de un campo.

Puede especificar el número de caracteres que desea extraer.

Para transformar un número de teléfono para que sólo incluya los 3 primeros dígitos, escriba:
left In.Phone,3 
lower
Convierte una serie a minúsculas.
Para convertir todas las letras mayúsculas a minúsculas en el campo Name, escriba:
lower In.Name
lpad
Añade espacios en el extremo izquierdo del campo para asegurarse de que el campo contiene como mínimo el número de caracteres especificado.
Para añadir espacios a la izquierda de un valor del campo Name que contiene menos de 5 caracteres, escriba:
lpad In.Name,5
ltrim
Suprime todos los espacios del principio (extremo izquierdo) de un campo.

Para eliminar todos los espacios del lado izquierdo de valores del campo Name, escriba:

ltrim In.Name
prepend
Añade datos de texto o de campo al principio de un campo.
Para añadir (702) a cada valor del campo PhoneNumber, escriba:
prepend '(702) ' In.PhoneNumber
removechar
Elimina todas las ocurrencias de una serie de un campo para limpiar todos los caracteres no deseados.
Para eliminar el carácter / de los valores del campo Date, escriba:
removechar In.Date,/
replacechar
Sustituye todas las ocurrencias de una serie por otra serie.

Puede utilizar esta clave para crear datos estándar o cambiar datos de manera coherente.

Para sustituir el carácter / por el carácter - en los valores del campo Date, escriba:
replacechar In.Date,/,-
right
Extrae una subserie de la derecha de un campo.

Puede especificar el número de caracteres que desea extraer.

Para extraer los cuatro últimos dígitos del campo SocialSecurity, escriba:
right In.SocialSecurity,4 
rpad
Añade espacios en el extremo derecho de un campo para asegurarse de que el campo contiene como mínimo el número especificado de caracteres.
Para añadir espacios a la derecha de un valor de campo de nombre que contiene menos de 5 caracteres, escriba:
rpad In.Name,5
rtrim
Suprime todos los espacios del final (extremo derecho) de un campo.

Para eliminar todos los espacios del lado derecho de los valores en el campo Name, escriba:

rtrim In.Name
skip
Se salta el registro si la condición especificada es verdadera para el campo.
Puede especificar las siguientes condiciones:
  • blank
  • !blank (sin espacio en blanco)
  • =
  • <=
  • >=
  • != (no equivalente)

Para saltarse registros cuyo valor del campo State no sea CA, escriba:

skip In.State,!=,CA
substr
Extrae una subserie de un campo y sobregraba el valor anterior de ese campo con la subserie especificada.

Para extraer los dos primeros caracteres del campo Status y sustituir el contenido actual de ese campo por la subserie extraída, escriba:

substr In.State,!=,CA
upper
Convierte una serie a mayúsculas.
Para convertir todas las letras minúsculas a mayúsculas en el campo State, escriba:
upper In.State
Conceptos relacionados
Archivo script para el programa de utilidad de conversión de archivos UMF


Comentarios

Última actualización: 2007