IM Centro de Informações do Relationship Resolution, Versão 4.2

Seções do Arquivo de Script do Utilitário de Conversão de Arquivo UMF

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
Conceitos relacionados
Arquivo de Script para o Arquivo de Script do Utilitário de Conversão de Arquivo UMF


Feedback

Última atualização: 2007