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