Í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) 
 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
- 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 e 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.
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 |
Processo: Conexão Data Server (N Tabelas) |
|