¶ Como configurar o leiaute?
Esta rotina é utilizada para configurar leiautes de importação de dados de outros sistemas para o Analista Contábil Digital. É possível montar leiautes em formato texto, com arquivos de tamanho fixo ou variável.
Cada leiaute é salvo em arquivo com extensão nli, utilizada pelo Analista Contábil Digital para este propósito.
A janela do configurador é composta por três partes, como mostra a figura abaixo.
1 - Apresenta o nome da tabela e, abaixo, cada um de seus campos.
2 - É utilizada nos leiautes para visualizar os dados em cada campo. Auxilia o usuário durante o desenvolvimento.
3 - Exibe as informações da tabela ou do campo no qual o usuário está posicionado à esquerda. Abaixo da opção Configurações, ficam os itens necessários para configurar um leiaute.
Para definir as regras do arquivo como um todo, utilize as seguintes ferramentas.
- DMClassName: Nome da rotina utilizada internamente pelo Questor para realizar a importação e/ou exportação.
- EhVariavel: Identifica se o leiaute será de tamanho variável. Nesse caso, o arquivo obrigatoriamente deve ter separador de campos.
- FormatoData: Indica o formato da data no arquivo. Exemplo: DDMMYYYY, em que D = dia, M = mês e Y = ano. Também é possível utilizar barras, como DD/MM/YYYY, ou inverter para YYMMDD.
- IdentificadorRegistro: Utilizado quando um mesmo arquivo possui dados referentes a mais de uma tabela.
- IdentificadorValorNulo: Permite diferenciar valores nulos de zero. Por padrão, o Questor utiliza o caractere ~ como identificador de nulo. Em situações em que a informação venha com zeros, é possível configurar o próprio campo para que zeros sejam assumidos como nulo. Veja mais em ConverterValores.
- SeparadorDecimal: Indica o caractere que separa cada campo no leiaute. Só é utilizado quando a opção EhVariavel estiver marcada.
- Tamanho do Registro: Caracter que inicializa e finaliza os campos do tipo texto. Em alguns leiautes, além do separador de campo, existem caracteres delimitadores de início e fim do campo texto, como aspas em "Nome do Cliente". Esse recurso só é utilizado quando a opção EhVariavel estiver marcada.
- TamanhoRegistro: Identifica o tamanho de cada linha no arquivo texto. Só é utilizado em leiautes de tamanho fixo, ou seja, quando a opção EhVariavel estiver desmarcada.
- UsarFlagImportado: Evita importar as mesmas linhas de um arquivo mais de uma vez. Quando a opção é marcada, o Questor altera a primeira posição das linhas importadas com sucesso para #. Assim, ao importar novamente o mesmo arquivo, os registros com # na primeira posição serão ignorados. Essa opção é mais utilizada em arquivos de tamanho fixo.
As configurações por coluna dos arquivos têm as seguintes opções de ferramenta.
- PosicaoInicio: Quando o leiaute for fixo, deve informar a posição inicial da coluna.
- Tamanho: Quando o leiaute for fixo, deve informar a quantidade de caracteres que a coluna terá.
- Final: Quando o leiaute for fixo, deve informar a posição final da coluna.
- Coluna: Quando o leiaute for variável, deve informar em qual coluna do arquivo estará a informação.
As ferramentas do configurador auxiliam na configuração do leiaute.
: Exibe todas as tabelas que receberam importação de dados. Selecione a que deseja configurar.
: Abre o leiaute já configurado para edição.
: Salva as configurações realizadas.
: Salva as configurações permitindo renomear o arquivo e gravá-lo em novo local.
: Fecha a configuração do leiaute.
: Duplica o campo do leiaute que está selecionado.
: Exclui somente os campos que foram duplicados.
: Utilizado quando o leiaute possui um espaço no arquivo e ele foge do padrão fixo ou variável.
: Realiza a ordenação dos campos no leiaute, podendo ser por índice do campo, nome do campo, coluna posição início ou tipo de coluna posição início.
: Abre o arquivo gerado no sistema de origem de dados, com o mesmo formato do leiaute em criação, para visualização nesta parte da janela.
: Atualiza os campos configurados no leiaute conforme o arquivo modelo importado.