Páginas filhas
  • Exemplo de Utilização de Conceito Utilizando a Conexão de Origem Data Server (N Tabelas)

Índice:


       

Objetivo:


        Esta página tem por objetivo apresentar um exemplo de Conceito utilizando a Conexão de Origem Data Server (N tabelas) e Conexão Destino arquivo texto.

Exemplo Prático:


        Neste exemplo, iremos exportar dados da tabela de produto utilizando a Conexão Origem Data Server e Conexão Destino arquivo texto.

    Cadastre o Conceito utilizando os dados abaixo:

    • Nome: Origem DataServer | Destino TXT - Tabela Produtos
    • Sistema: T
    • Descrição: Origem DataServer | Destino TXT - Tabela Produtos

    Crie uma Conexão Origem do tipo Data Server RM.NET, conforme imagem abaixo:

    Depois de feita a seleção da opção acima, apresentará uma janela para o usuário. Nesta, vamos configurar a conexão.

    Nome: Origem_DataServer
    Servidor: EstPrdDataBR (Produtos)

    Importante/Saiba Mais

    (ideia) Para consultar o nome do DataServer/Action de determinado cadastro no RM, acesse a visão de cadastro e pressione as teclas Ctrl + Alt + F9. Uma janela abrirá contendo a informação do DataServer/Action.

    Depois de criada a Conexão Origem temos acesso a diversas tabelas ligadas ao DataServer.

    Agora, vamos configurar a Conexão Destino. Crie uma conexão do tipo Arquivo Texto, conforme imagem abaixo:

    Na janela que será aberta, preencha os seguintes campos:

    • Nome: Destino_TXT
    • Tipo de Arquivo: Arquivo separado por delimitador
    • Delimitador: |
    • Aquivo: Diretório: C:\TBC\

    Aba Tabelas

    • Adicione uma Tabela
      • Nome: Produtos
    • Adicione as colunas
      • IDPRD
      • CODIGOPRD
      • DESCRICAO
      • TEMPOMAX

    Depois de realizar o cadastro, a Conexão Destino retornará a seguinte estrutura:

    A próxima etapa será realizar a lição entre a Conexão Origem e a Conexão Destino. Acesse a aba Ligações, localizada no lado esquerdo superior do cadastro do conceito.
    Ao acessar a aba, a mensagem “Arraste uma tabela de destino aqui” será apresentada. Clique na tabela de destino, segure e arraste para a mensagem mencionada.

    Para incluir os campos da tabela de origem, primeiramente selecione a tabela TPRODUTO e arraste para a parte superior direita da tabela acima.

    Os campos podem ser associados através do recurso arraste e solte.

    O único campo que não estará presente na tabela TPRODUTO é o TEMPOMAX.

    Para buscarmos a informação deste grupo, vamos utilizar a ferramenta Operações | Lookup, presente no lado direito inferior do conceito.


    Ao selecionar a opção Lookup, uma janela será apresentada.

    Preencha os campos conforme abaixo:

    Com o Lookup devidamente configurado, volte na aba Ligações.

    Arraste o operador Lookup para o campo Origem do TEMPOMAX.


    Ao realizar o procedimento acima, teremos que associar as chaves primárias para que o campo TEMPOMAX seja retornado corretamente.

    Na sequencia, salve o conceito.

    Na visão do cadastro do Conceito, selecione o registro do exemplo criado, clique em Processos | Processar Novo Conceito. Avance no assistente de execução até finalizá-lo.

    Verifique o arquivo criado na pasta TBC

    Nas versões atuais do sistema, é possível configurar a quantidade de registros por transação. Essa configuração interfere na opção de Continuar execução em caso de erros. Para mais informações, consulte: Registros por Transação.

    Na conexão DataServer a configuração para parar ou não a execução do conceito em caso de erros é sobreposta pela configuração feita no conceito.

    Novidades!

    • A partir dos patches mais recentes da versão 12.1.28 estão disponíveis os parâmetros Permitir Paginação Tamanho da página na conexão origem

    Quando estão habilitados, a leitura na base será feita de forma paginada. Ou seja, em vez de fazer a leitura de todos os dados de uma vez, o sistema buscará a quantidade de registros determinado no campo Tamanho da página, podendo ser de 10 em 10, por exemplo.

    O uso do recurso de paginação reduzirá a quantidade de memória usada pelo processo de extração de dados pela conexão de origem.

    Parâmetros e Filtro

    Selecionando a aba de Parâmetros serão apresentadas opções para definição de um Parâmetro relacionado ao Data Server ou definir um Filtro Fixo

    Ao selecionar a opção Fixo, será apresentada a tela padrão de Definição do Filtro, onde pode ser gerada uma expressão.

    Versão 2402

    A partir da versão 12.1.2402, patch 106
    As colunas adicionadas na expressão serão acrescentadas com o Alias da tabela, conforme apresentado no texto exibido ao passar o mouse sobre o campo em negrito em Coligada.
    Isto para evitar erro na execução da query quando em tabelas relacionadas existe mais de uma coluna com o mesmo nome.

    Exemplo:

    Antes desta versão poderia ocorrer um erro na execução do conceito, como: "Ambiguous colunm name 'CODCOLIGADA'", pois na query o filtro estaria sem o Alias, por exemplo:
    Where CODCOLIGADA = 1

    Sendo que o correto deve ser conforme exibido no texto sobre o campo Coligada com o Alias adicionado, por exemplo:
    Where FLAN.CODCOLIGADA = 1




    Produto: Framework

    Versão: 12.1.XX

    Processo: Conexão Data Server (N Tabelas)