Procedimentos
O Importador/Exportador de Arquivos Texto possui uma série de procedimentos que são executados durante os processos de importação e exportação. Para cada procedimento é disponibilizado um ponto de regra em que é possível realizar customizações.
Para editar a regra de determinado Layout, deve-se acessar a guia Procedimentos, onde é possível editar cada procedimento com o editor de regras, que é aberto pelo botão Editar ao lado dos campos de regras.
A ordem de compilação das regras é Início da execução > Fim da execução.
Procedimentos de Importação
A ordem dos procedimentos é Definição da operação > Geração de Chave > A Cada Leitura.
No Início da Execução
É executado no início da importação, logo após a execução da tela de entrada.
É executado após ler uma linha do arquivo texto. Se a variável OperacaoRegistro estiver declarada nesta regra, ela armazenará as operações que podem ser executadas com o registro atual.
Nota
É possível alterar o valor da variável OperacaoRegistro, alterando assim, a operação que será realizada com o registro. No caso de layouts que atualizam dados em campos de usuário, por padrão, sempre será enviado o valor nulo para o campo de usuário (caso não seja enviado valor para o campo no layout). Para que isso não ocorra, ou seja, campos de usuário já preenchidos não sejam atualizados e recebam o valor nulo quando uma atualização for realizada pelo layout, será necessário definir o que será realizado com o registro que já existe na base, dentro da opção Definição da Operação do layout, ou seja, verificar se o registro para o campo de usuário já existe na base (por meio de select), caso existir, deve-se indicar que nenhum operação será executada, e que o campo de usuário deve receber o próprio valor que já existe no campo de usuário atualmente.
Geração de Chave
É executado no momento da geração da chave. Os valores dos campos podem ser lidos ou definidos via regra, pois cada campo do Layout é transformado em uma variável de regra. Na variável CodigoRegistro será carregado o código do registro que foi lido do arquivo texto, identificando qual seção está sendo lida.
Os campos chave da tabela, se necessário, devem ser alterados neste evento.
A Cada Leitura
É executado antes do registro ser Inserido, Alterado ou Excluído da base, conforme operação definida anteriormente. Nesta regra é possível ler ou alterar valores do registro. Com exceção dos atributos chaves de uma tabela, os demais atributos, se necessário, devem ser alterados neste evento.
No Término da Execução
É executado após o término da importação.
Procedimentos de Exportação
A ordem dos procedimentos é Na Seleção > A Cada Gravação.
Na Seleção
É executada antes de ser aberta a conexão com o banco de dados e buscar os registros a serem exportados. Pode ser usado, por exemplo, para guardar valor em uma variável global e que pode ser lida nos outros métodos ou para validar se o processo pode ou não ser executado naquele momento, cancelando-o antes mesmo de realizar a busca de registros no banco de dados.
No Início da Execução
É executado no início da exportação, logo após a abertura da tela de entrada.
A Cada Gravação
É executada antes de cada linha ser gravada no arquivo de texto (.txt).
No Término da Execução
É executado após o término da exportação.
English
Español
