O arquivo de script para o utilitário de conversão do arquivo UMF define como os dados em um arquivo de origem de dados são convertidos em UMF. O arquivo de script inclui
várias seções e parâmetros dentro dessas seções. As quatro primeiras seções, GLOBAL, RECORD, IMPORT e EXPORT, são configuradas durante sua implementação inicial e provavelmente não serão alteradas. A última seção, TRANSFORM, contém os parâmetros que você pode querer customizar.
Parâmetros da Seção [GLOBAL]
A seção GLOBAL inclui parâmetros que se aplicam ao utilitário de conversão do arquivo UMF global.
- STARTWITH
- Indica com qual registro o utilitário de conversão do arquivo UMF começa o processamento.
O valor padrão para este parâmetro é 1. Se você estiver importando um conjunto de registros que contém um conjunto de nomes de campo como primeiro registro, talvez você queira ignorar esse registro e começar com o segundo registro no conjunto.
Por exemplo, para que o utilitário
de conversão do arquivo UMF ignore o primeiro registro, especifique um valor de 2:
STARTWITH=2
Parâmetros da Seção [RECORD]
A seção RECORD inclui parâmetros que definem a estrutura do arquivo de definição para o arquivo de origem de dados de entrada ou arquivo UMF de saída. Você pode incluir várias seções RECORD, cada uma delas numerada; normalmente, RECORD1 é utilizado para arquivos de origem de dados de entrada e RECORD2
é utilizado para os arquivos UMF de saída.
- DEF
- Especifica o arquivo que contém a estrutura de dados do arquivo de entrada ou arquivo de saída. Você deve especificar o caminho completo e o nome do arquivo.
Não há valor padrão.
Por exemplo, se a seção [RECORD] que contém este parâmetro se referir a um arquivo UMF de saída, ele define o caminho e o nome do arquivo para o nome do arquivo de saída:
DEF=path\outputvariables.def
- NAME
- Especifica um alias para o arquivo de definição que é referido nesta seção [RECORD].
Como você digita esse valor muitas vezes quando cria esse arquivo de script, talvez você queira especificar uma cadeia curta.
O valor padrão para um arquivo de entrada é In; o valor padrão para um arquivo de saída é Out. Qualquer valor de cadeia é válido. Para especificar que o arquivo de definição é um arquivo de entrada, digite o seguinte nesta seção:
NAME=In
Parâmetros da Seção [IMPORT]
A seção IMPORT diz ao Utilitário de Conversão
do Arquivo UMF qual seção RECORD utilizar e qual tipo de dados esperar. Você pode incluir várias seções [IMPORT], cada uma delas exclusivamente numerada, por exemplo, [IMPORT1]. Chaves subseqüentes podem utilizar o número exclusivo para se referir a essa seção [IMPORT].
- RECORD
- Especifica a seção [RECORD] do arquivo de script para utilizar durante a importação dos dados.
Não há valor padrão.
Para especificar a seção [RECORD1], digite:
RECORD=1
- TYPE
- Especifica a estrutura dos dados de entrada.
Como o utilitário de conversão do arquivo UMF trabalha somente com arquivos de largura fixa, o único valor válido para este parâmetro é FW.
Para indicar um arquivo de entrada de largura fixa, digite:
TYPE=FW
Parâmetros da Seção [TRANSFORM]
A seção TRANSFORM define como o utilitário de conversão transforma dados de entrada antes de enviá-los. Os parâmetros da seção TRANSFORM são divididos em um parâmetro de configurações e parâmetros de transformação. O parâmetro IMPORTER define as configurações da transformação. Os parâmetros beginseg, tagvalue e endseg definem o formato da transformação de dados e o restante das transformações define como os dados são transformados. A modificação dos parâmetros de transformação afeta cada registro de entrada.
- IMPORTER
- Esse parâmetro de configuração especifica qual seção IMPORT transformar.
Não há valor padrão.
Para especificar a seção [IMPORT1], digite:
IMPORTER=1
- beginseg
- Indica o início de um novo segmento UMF.
Todas as chamadas para tagvalue colocam valores dentro da seção TRANSFORM.
Você pode utilizar essa chave para incluir somente segmentos de registro de entrada que contêm tags específicas.
Por exemplo, para especificar que uma tag LAST_NAME é necessária para criar um segmento UMF_ENTITIY, digite:
beginseg UMF_ENTITY, Requires(LAST_NAME)
- tagvalue
- Especifica o nome e os valores correspondentes das novas tags UMF.
Para criar uma tag UMF chamada NUM_VALUE que contém o valor do número da seguridade social contido no arquivo de entrada, digite:
tagvalue ’NUM_VALUE’,In.SocialSecNum
- endseg
- Especifica o fim de um segmento UMF
Para encerrar um segmento UMF, digite:
endseg
- append
- Inclui dados do texto ou do campo no fim de um campo.
Para colocar o conteúdo do campo StreetName dos dados de entrada no final do campo Addr1 onde você está combinando todas as informações de endereço da rua, digite:
append In.StreetName,Out.Addr1
- atrim
- Exclui todos os espaços do início e do fim do campo.
Essa chave executa a função das chaves ltrim e rtrim.
Para excluir espaços do início e do fim de um campo, digite:
atrim
- autoinc
- Incrementa automaticamente em 1 um valor em um campo.
Você pode utilizar essa chave para criar números exclusivos para cada registro. Também é possível especificar um valor para indicar o número com o qual você quer começar.
Por padrão, a numeração começa com 0.
Para criar um campo chamado docref que contém um valor automaticamente incrementado que começa com 35, digite:
autoinc Out.docref, 35
- copy
- Copia caracteres de um campo em outro.
Você deve especificar o campo de entrada do qual deseja copiar e o campo de saída no qual deseja copiar.
Para copiar o conteúdo de um campo chamado StreetName em um campo chamado Addr1, digite:
copy In.StreetName, Out.Addr1
- ctrim
- Substitui dois ou mais espaços contíguos por um espaço simples em qualquer lugar na cadeia.
Para excluir espaços adicionais de dentro do campo Name, digite:
ctrim In.Name
- ifeq
- Executa o próximo comando em uma seqüência, se o valor especificado for o mesmo que o conteúdo do campo de entrada.
Para verificar um valor Y no campo Office de cada registro, e se um Y estiver presente para substituir o Y por um P, digite:
ifeq In.Office,Y
replacechar In.Office,Y,P
- ifneq
- Executa o próximo comando em uma seqüência, se o valor especificado não for o mesmo que o conteúdo do campo de entrada.
É o oposto da chave ifeq.
Para atualizar atuais registros de funcionários com novos códigos de local indicando se eles estão ativos, de licença ou de férias, mas não atualizar registros de funcionários aposentados (status=R), digite:
ifneq In.Status,R
copy In.LocCode, Out.LocCode
- left
- Extrai uma subcadeia da esquerda de um campo.
Você pode especificar quantos caracteres deseja extrair.
Para transformar um número de telefone para incluir somente os 3 primeiros dígitos, digite:
left In.Phone,3
- lower
- Converte uma cadeia em letras minúsculas.
Para converter todas as letras maiúsculas em minúsculas no campo Name, digite:
lower In.Name
- lpad
- Inclui espaços na extremidade esquerda do campo para garantir que ele contenha pelo menos o número especificado de caracteres.
Para incluir espaços no lado esquerdo de um valor do campo Name que contém menos de 5 caracteres, digite:
lpad In.Name,5
- ltrim
- Exclui todos os espaços do início (extremidade esquerda) de um campo.
Para remover todos os espaços do lado esquerdo dos valores no campo Name, digite:
ltrim In.Name
- prepend
- Inclui dados do texto ou do campo no início de um campo.
Para incluir (702) em cada valor no campo PhoneNumber, digite:
prepend '(702) ' In.PhoneNumber
- removechar
- Remove todas as ocorrências de uma cadeia dentro de um campo para limpar caracteres indesejados.
Para remover o caractere / dos valores no campo Date, digite:
removechar In.Date,/
- replacechar
- Substitui todas as ocorrências de uma cadeia por outra cadeia.
Você pode utilizar essa chave para criar ou alterar dados de maneira consistente.
Para substituir o caractere / pelo caractere - nos valores no campo Date, digite:replacechar In.Date,/,-
- right
- Extrai uma subcadeia da direita de um campo.
Você pode especificar quantos caracteres deseja extrair.
Para extrair os últimos quatro dígitos do campo SocialSecurity, digite:
right In.SocialSecurity,4
- rpad
- Inclui espaços no lado direito do campo para garantir que ele contenha pelo menos o número especificado de caracteres.
Para incluir espaços no lado direito de um valor do campo nome que contém menos de 5 caracteres, digite:
rpad In.Name,5
- rtrim
- Exclui todos os espaços do fim (extremidade direita) de um campo.
Para remover todos os espaços do lado direito dos valores no campo Name, digite:
rtrim In.Name
- skip
- Ignora o registro se a condição especificada por verdadeira para o campo.
Você pode especificar as seguintes condições:
- blank
- !blank (not blank)
- =
- <=
- >=
- != (not equal)
Para ignorar registros cujo valor do campo State não seja CA, digite:
skip In.State,!=,CA
- substr
- Extrai uma subcadeia de um campo e sobrescreve o antigo valor nesse campo com a subcadeia especificada.
Para extrair os dois primeiros caracteres do campo Status e substituir o conteúdo atual desse campo pela subcadeia extraída, digite:
substr In.State,!=,CA
- upper
- Converte uma cadeia em letras maiúsculas.
Para converter todas as letras minúsculas em maiúsculas no campo State, digite:
upper In.State