Como Fazer: Conceito utilizando operação Conversão

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito utilizando operação Conversão

Ao criar um conceito no TOTVS Business Conector, é possível inserir operações para manipular os dados da origem antes de enviá-los ao destino.

Neste como fazer será demonstrado como configurar uma operação do tipo Conversão

A operação Conversão permite que um dado de entrada seja transformado para o tipo de dado escolhido.

1º - Após criar e configurar um conceito, clique na aba Correspondências e crie uma nova operação do tipo Conversão.

2º - Configure os campos referentes à conexão.

Alimentação

· Entrada: Informe a entrada da operação.

Neste exemplo, será o campo (PK) qry_Cli.IDCFO

Identificação

· Nome: Nome da operação.

· Nome: Campo somente leitura, tem como valor o tipo da operação.

Parâmetros

• Tipo de Dados: Informe o tipo de dados resultante da operação, que pode ser:

   o Texto (converte para String)

   o Inteiro (converte para int64)

   o Decimal (converte para Double)

   o Data (converte para DateTime)

Neste exemplo, o resultado será do tipo Texto.

3º - Selecione o campo destino que deve receber o retorno da operação.

Exemplo: CLIENTE.INFORMACOES

4º - Após realizar os procedimentos anteriores, a operação Conversão está configurada.

Com base nos exemplos, a operação Conversão irá receber como entrada o valor do campo “qry_Cli.IDCFO” que é do tipo inteiro, converter este valor para o tipo texto e enviar para o campo “CLIENTE.INFORMACOES”.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito utilizando Operação Concatenação

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito utilizando operação Concatenação

Ao criar um conceito no TOTVS Business Conector, é possível inserir operações para manipular os dados da origem antes de enviá-los ao destino.

Neste como fazer será demonstrado como configurar uma operação do tipo Concatenação

A operação Concatenação pode receber duas entradas e resultar em uma saída com os dados concatenados.

1º - Após criar e configurar um conceito, clique na aba Correspondências e crie uma nova operação do tipo Concatenação.

2º - Configure os campos referentes à conexão.

Alimentação

· Entrada: Informe o valor de entrada da operação.

Exemplo: (PK) qry_Cli.CODCFO

· Entrada Secundária: Informe o valor a ser concatenado à entrada principal.

Exemplo: qry_Cli.Nome

Identificação

· Nome: Nome da operação.

· Nome: Campo somente leitura, tem como valor o tipo da operação.

Parâmetros

· Concatenador: Informe o caractere(s) que será(ão) incluído(s) entre as entradas principal e secundária, funcionando como um separador de dados.

Exemplo: -

· Tipo de Dados: Informe qual o tipo de dados resultante da operação. O tipo pode ser Texto, Inteiro, Decimal ou Data.

Exemplo: Texto

Observação

Se o campo "Tipo de Dados" estiver definido como texto os dados serão concatenados.

Entretanto, a operação Concatenação também pode executar funções de soma de valores do tipo Inteiro e Decimal.

Caso esse campo esteja definido como Inteiro, as entradas serão convertidas para inteiro e então será realizada a soma dos valores. Sendo que o mesmo procedimento vale para o tipo Decimal.

Neste caso, o campo Concatenador deve ser deixado em branco ou preenchido com um valor numérico que será acrescentado ao total da soma das duas entradas.

Por exemplo, supondo que:

Entrada = 2 (valor do campo fornecido como Entrada)

Entrada Secundária = 3 (valor do campo fornecido como Entrada Secundária)

Concatenador = 5

Tipo de Dado = Inteiro

O resultado da operação irá retornar o valor 10, que é a soma dos campos Entrada, Entrada Secundária e Concatenador.

3º - Selecione o campo destino que deve receber o retorno da operação.

Exemplo: CLIENTE.CODNOME

4º - Após realizar os procedimentos anteriores, a operação Concatenação está configurada.

Com base nos valores fornecidos nos exemplos, a operação Concatenação irá receber como entrada o valor do campo “(PK) qry_Cli.CODCFO” e concatenar o mesmo com o valor do campo “qry_Cli.NOME”.

Os dados serão separando através do caractere ( – ), e o resultado será armazenado no campo CLIENTE.CODNOME.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito utilizando Operação Arredondamento

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito utilizando operação Arredondamento

Ao criar um conceito no TOTVS Business Conector, é possível inserir operações para manipular os dados da origem antes de enviá-los ao destino.

Neste como fazer será demonstrado como configurar uma operação do tipo Arredondamento.

A operação Arredondamento recebe um valor como entrada que é convertido para um decimal (Double) e então são aplicadas as operações definidas na configuração da operação.

1º - Após criar e configurar um conceito, clique na aba Correspondências e crie uma nova operação do tipo Arredondamento.

2º - Configure os campos referentes à conexão.

Alimentação

· Entrada: Informe a entrada da operação.

Exemplo: DIARIOPROFESSOR.NOTA

Identificação

· Nome: Nome da operação criada.

· Nome: Campo somente leitura, tem como valor o tipo da operação.

Parâmetros

· Tipo: Informe o tipo do arredondamento que será feito na operação. Este parâmetro pode ter como valor:

   o Arredondar

   o ParaCima

   o ParaBaixo

   o TruncarDecimais

Neste exemplo, utilizaremos a opção ParaCima.

3º - Selecione o campo destino que deve receber o retorno da operação.

Exemplo: DIARIOALUNO.NOTA

4º - Após realizar os procedimentos anteriores, a operação Arredondamento está configurada.

Com base nos exemplos, a operação irá receber como entrada o campo DIARIOPROFESSOR.NOTA e aplicar o tipo de arredondamento ParaCima.

Supondo que o valor do campo seja 6.3, a operação irá arredondar o valor para 7 e enviar o mesmo para o campo DIARIOALUNO.NOTA.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito com Conexão do Tipo MS CRM

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito com Conexão do tipo MS CRM

No TOTVS Business Conector, o Conceito é a estrutura responsável por armazenar os dados de conexões dos sistemas de origem e destino.

Uma Conexão Origem ou Destino pode ser de vários tipos. Neste como fazer será demonstrado como configurar uma Conexão do tipo MS CRM.

Observação: Embora o exemplo seja de uma Conexão Destino, a configuração funcionará da mesma forma em uma Conexão Origem.

1º - Após criar um novo conceito e preencher os campos da aba Identificação, crie uma nova conexão do tipo MS CRM na aba Conexão Destino.

2º - Configure os campos referentes à conexão.

Conexão

· Server URL: Informe o endereço da conexão.

Exemplo: http://10.31.0.220:5555

· Domínio: Informe o nome do domínio.

Exemplo: bh01

· Usuário: Informe o nome do usuário do CRM.

Exemplo: deivid.silva

· Senha: Informe a senha do usuário CRM.

· Organização: Informe o nome da organização para integração.

Exemplo: TOTVS

· Entidade CRM: Informe o nome da entidade CRM.

Exemplo: account

· ID CRM: Informe o nome do identificador de registro da entidade do CRM.

Exemplo: accountid

Identificação

· Nome: Informe o nome da conexão.

3º - Após realizar os procedimentos anteriores, a Conexão do tipo MS CRM está configurada.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito com Conexão do Tipo Data Server

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito com Conexão do tipo Data Server

No TOTVS Business Conector, o Conceito é a estrutura responsável por armazenar os dados de conexões dos sistemas de origem e destino.

Uma Conexão Origem ou Destino pode ser de vários tipos. Neste como fazer será demonstrado como configurar uma Conexão do tipo Data Server.

Observação: Embora o exemplo seja de uma Conexão Destino, a configuração funcionará da mesma forma em uma Conexão Origem.

 

1º - Após criar um novo conceito e preencher os campos da aba Identificação, crie uma nova conexão do tipo Data Server na aba Conexão Destino.

2º - Configure os campos referentes à conexão.

Conexão

· Conexão Default: Informe se o Data Server irá utilizar a conexão corrente. Caso contrário, os campos Usuário CORPORE, Senha do CORPORE e Alias CORPORE devem ser preenchidos.

Exemplo: False.

· Usuário CORPORE: Informe nome do usuário do CORPORE que deve representar o processo de importação.

Exemplo: mestre.

· Senha do CORPORE: Informe a senha de autenticação ao CORPORE.

· Data Server: Informe o nome do Data Server a ser utilizado pela conexão.

Exemplo: FinLanDataBR

· Tabela Principal: Informe o nome da tabela do Data Server que servirá de base para a importação.

Exemplo: FLAN

· Alias CORPORE: Informe o alias do CORPORE que deve representar o processo de importação.

Exemplo: TBC1140W

· Coligada: Informe a coligada que deve representar o processo de importação.

Exemplo: 1

· Coligada do contexto: Informe a coligada do contexto.

É possível relacionar a coligada do contexto a um determinado conceito, como por exemplo, o conceito que trabalha rotinas financeiras pode ser relacionado a coligada referente ao financeiro.

Exemplo: False.

· Owner Data: Informe o owner data.

Exemplo: 8

Identificação

· Nome: Nome atribuído a conexão que está sendo criada.

3º - Após realizar os procedimentos anteriores, a Conexão do tipo Data Server está configurada.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito com Conexão do Tipo Banco de Dados

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito com Conexão do tipo Banco de Dados

No TOTVS Business Conector, o Conceito é a estrutura responsável por armazenar os dados de conexões dos sistemas de origem e destino.

Uma Conexão Origem ou Destino pode ser de vários tipos. Neste como fazer será demonstrado como configurar uma Conexão do tipo Banco de Dados.

Observação: Embora o exemplo seja de uma Conexão Origem, a configuração funcionará da mesma forma em uma Conexão Destino.

 

1º - Após criar o conceito e configurar os campos na aba identificação, crie uma Conexão Origem que seja do tipo Banco de Dados.

2º - Configure os campos referentes à conexão.

Conexão

· Suporta Transações: Informe se o banco de dados suporta transações.

· Queries: Informe o conjunto de queries associado à conexão.

Ao clicar no lookup do campo Queries, uma visão é aberta para que se possa criar o conjunto de queries.

Clique no botão Add para adicionar a querie, e preencha os campos SQL, informando a sentença desejada, e Nome, informando o nome da querie que deve sempre começar com “qry_ ”.

· Provedor: Informe o provedor de aceso ao banco de dados.

Exemplo: SqlClient Data Provider

· String de Conexão: Informe a string de conexão com o banco de dados.

Ao clicar no lookup do campo, uma janela é aberta com vários parâmetros para configuração, de acordo com o provedor escolhido.

Os parâmetros básicos que devem ser preenchidos , no caso do provedor citado no exemplo são:

Origem:

· Data Source: informe o servidor.

· Initial Catalog: informe o nome da fonte de dados.

Segurança:

· Password: informe a senha a ser usada para conectar à fonte de dados.

· User ID: informe o ID do usuário a ser usado para conectar à fonte de dados.

Identificação

· Nome: Informe o nome da conexão que está sendo criada.

3º - Após realizar os procedimentos anteriores, a Conexão do tipo Banco de Dados está configurada.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito com Conexão do Tipo Arquivo XML

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito com Conexão do tipo Arquivo XML

No TOTVS Business Conector, o Conceito é a estrutura responsável por armazenar os dados de conexões dos sistemas de origem e destino.

Uma Conexão Origem ou Destino pode ser de vários tipos. Neste como fazer será demonstrado como configurar uma Conexão do tipo Arquivo XML.

Observação: Embora o exemplo seja de uma Conexão Origem, a configuração funcionará da mesma forma em uma Conexão Destino.

1º - Após criar um novo conceito e preencher os campos da aba Identificação, crie uma nova conexão do tipo Arquivo XML na aba Conexão Origem.

2º - Configure os campos referentes à conexão.

Conexão

· Texto XSD: Informe o texto schema no formato XSD.

Ao clicar no lookup do campo, uma janela na qual é possível digitar o texto ou abrir o arquivo XSD para que o texto seja carregado.

· Arquivo XML: Informe o caminho completo e o nome do arquivo XML.

O diretório deve ser informado contendo IP ou nome da máquina, em uma pasta compartilhada, evitando possíveis erros configuração. Com por exemplo, outro usuário pode tentar processar o conceito e não conseguir devido ao arquivo não existir em sua máquina.

· Tabela Principal: Selecione a tabela principal, apenas para conexão de origem.

· Nó Raiz: Caso a consulta de origem tenha como retorno múltiplo registros, informe neste campo o nó raiz.

Identificação

· Nome: Nome da conexão.

3º - Após realizar os procedimentos anteriores, a Conexão do tipo Arquivo XML está configurada.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Conceito com Conexão do Tipo Arquivo Texto

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito com Conexão do tipo Arquivo Texto

No TOTVS Business Conector, o Conceito é a estrutura responsável por armazenar os dados de conexões dos sistemas de origem e destino.

Uma Conexão Origem ou Destino pode ser de vários tipos. Neste como fazer será demonstrado como configurar uma Conexão do tipo Arquivo Texto.

Observação: Embora o exemplo seja de uma Conexão Origem, a configuração funcionará da mesma forma em uma Conexão Destino.

 

1º - Após criar um novo conceito e preencher os campos da aba Identificação, crie uma nova conexão do tipo Arquivo Texto na aba Conexão Origem.

2º - Configure os campos referentes à conexão.

Conexão

· Tipo: Informe se o tamanho dos campos é fixo ou delimitado.

· Delimitador de campos: Caso o tamanho dos campos seja delimitado, informe o caractere ou conjunto de caracteres que marca o limite entre dois campos.

Neste caso, se o caractere for de tabulação, digite 'TAB' no delimitador de campos.

· Tabelas: Conjunto de tabelas que serão derivadas deste arquivo.

Para informar o conjunto de tabelas que serão utilizadas na conexão é necessário criar a estrutura do arquivo. Neste caso, ao clicar no lookup do campo Tabelas, é aberta uma visão para montar a estrutura.

Clique no botão “Nova” para criar uma nova estrutura e inserir uma tabela. Preencha os parâmetros, informando o nome da tabela e os campos que farão parte da mesma.

Na parte esquerda da visão serão apresentadas as Tabelas que já foram adicionadas. Caso queria excluir uma tabela, selecione a mesma e clique em Excluir.

Ou caso queria realizar uma nova configuração na tabela, selecione a mesma e clique em Limpar. As informações da tabela selecionada serão apagadas para que uma nova configuração seja feita.

Ao clicar no lookup do parâmetro Campos, uma janela é aberta permitindo informar os campos que farão parte da tabela.

Para adicionar os campos clique no botão “Add”, e configure os mesmos preenchendo os parâmetros.

· Arquivo: Informe o diretório mais o nome do arquivo que deve alimentar a conexão.

O diretório deve ser informado contendo IP ou nome da máquina, em uma pasta compartilhada, evitando possíveis erros configuração. Com por exemplo, outro usuário pode tentar processar o conceito e não conseguir devido ao arquivo não existir em sua máquina.

Identificação

· Nome: Nome da conexão que está sendo criada.

3º - Após realizar os procedimentos anteriores, a Conexão do tipo Arquivo Texto está configurada.

Informações Adicionais

Para mais informações referentes ao Conceito, bem como do TOTVS Business Conector acesso o WikiHelp do mesmo. Lá você encontrará informações detalhadas além de outros Como Fazer.

Acesse: WikiHelp

Como Fazer: Criando um Conceito no TOTVS Business Conector

Produto: TOTVS Business Conector Versão: 11.40

Processo: Conceito

Subprocesso: Conceito: Origem Banco de Dados - Destino Arquivo Texto

No TOTVS Business Conector, o Conceito é a estrutura responsável por armazenar os dados de conexões dos sistemas de origem e destino, quais campos de cada sistema estão envolvidos na integração, e quais as correspondências entre os atributos de origem e destino.

Neste como fazer será demonstrado como criar um conceito de forma geral.

1º - Faça login no RM.exe, acesse o segmento Integração, aba Integração | botão Conceito.

2º - Na visão de Conceito, clique para incluir um novo conceito.

3º - A janela de edição do conceito será aberta para realizar as configurações necessárias. Na aba Identificação informe:

• Nome do Conceito
• Descrição/Observações

4º - Na aba Conexões Origem, crie uma conexão informando seu nome e escolhendo o tipo. Lembrando que a Conexão Origem pode ser do tipo:

• Arquivo Texto
• Arquivo XML
• Banco de Dados
• Data Server
• MS CRM

5º - Após criar a conexão, irão surgir os parâmetros correspondentes ao tipo escolhido, para que seja realizada a configuração da Conexão Origem.

6º - Concluída a configuração da Conexão Origem, o próximo passo é criar a Conexão Destino, que irá receber os dados enviados pela de origem.

A configuração da conexão de destino funciona da mesma forma que na conexão de origem. É necessário criar uma conexão, informar seu o nome e escolher o tipo. Após irão surgir os campos referentes ao tipo escolhido para que os mesmos sejam configurados.

A única diferença é que a Conexão Destino, além dos tipos mencionados na Conexão Origem, também esta disponível o tipo Web Service.

7º - Na abas Estrutura Origem e Estrutura Destino devem ser realizadas as configurações das estruturas que estão sendo criadas. Tanto na Estrutura Origem quanto na de Destino a forma de configurar é a mesma.

Estarão disponíveis as Tabelas conforme configurado nas Conexões correspondentes.

Selecione a tabela desejada e clique em Adicionar para que a mesma faça parte da estrutura que esta sendo criada. Ao adicionar, uma janela será aberta permitindo escolher quais os campos da tabela farão parte da estrutura.

Após selecionar os campos e confirmar, a tabela estará disponível no campo Tabelas da Importação.

Ao selecionar a tabela, na parte inferior aparecem os campos para que seja feita a configuração da mesma. O procedimento é igual ao selecionar um campo da tabela.

8º - Após configurar a Estrutura Origem e a Estrutura Destino, é necessário realizar as correspondências entre a Origem e o Destino na aba Correspondências.

Pode-se realizar a correspondência de forma automática, clicando no botão Correspondências Automáticas, ou selecionando o campo no Destino e informando no parâmetro Entrada qual campo da origem será entrada do campo selecionado.

9º - Salve o conceito. Agora basta ir a Processos | Processar Conceito, para que o conceito seja executado.

Informações Adicionais

Para ver como são configurados cada tipo de Conexão (Origem e Destino), bem como as operações que se pode incluir na aba Correspondências, acesso o WikiHelp do TOTVS Business Conector.

Lá você encontrará informações detalhadas sobre o Conceito, além de outros Como Fazer.

Acesse: WikiHelp