O que é?
Este documento tem como objetivo apoiar os clientes da CRM Educacional que utilizam a integração do TOTVS RM®, liberando o acesso ao TBC - TOTVS Business Connect® da instituição.
Premissas
Para usar a integração com o TBC®, é necessário liberar o acesso externo por IP público ou DNS e criar um usuário no TOTVS RM® que irá executar as operações necessárias para a integração.
Conhecendo o TBC® e os recursos utilizados pela integração
O TOTVS Business Connect, também conhecido como TBC®, é uma ferramenta da TOTVS® que permite a integração entre diferentes entidades (Cadastros, Formulários, Tabelas, Arquivos) do ERP com bases e sistemas legados. Ele oferece mapeamento em diversos níveis (bases, arquivos, dataservers, Webservices) e permite a transformação de dados entre a origem e o destino através de controles automatizados.
Veja mais detalhes em: TOTVS Business Connect
Nossa integração atualmente utiliza os serviços de DataServer e Process disponibilizados pelo TBC®.
O serviço DataServer oferece acesso direto aos objetos de negócio do TOTVS RM®, sendo usado principalmente para leitura e gravação de registros.
Este documento tem como objetivo apoiar os clientes da CRM Educacional que utilizam a integração do TOTVS RM®, liberando o acesso ao TBC - TOTVS Business Connect® da instituição.
Premissas
Para usar a integração com o TBC®, é necessário liberar o acesso externo por IP público ou DNS e criar um usuário no TOTVS RM® que irá executar as operações necessárias para a integração.
Conhecendo o TBC® e os recursos utilizados pela integração
O TOTVS Business Connect, também conhecido como TBC®, é uma ferramenta da TOTVS® que permite a integração entre diferentes entidades (Cadastros, Formulários, Tabelas, Arquivos) do ERP com bases e sistemas legados. Ele oferece mapeamento em diversos níveis (bases, arquivos, dataservers, Webservices) e permite a transformação de dados entre a origem e o destino através de controles automatizados.
Veja mais detalhes em: TOTVS Business Connect
Nossa integração atualmente utiliza os serviços de DataServer e Process disponibilizados pelo TBC®.
O serviço DataServer oferece acesso direto aos objetos de negócio do TOTVS RM®, sendo usado principalmente para leitura e gravação de registros.
O serviço Process oferece métodos para manipulação de processos no TOTVS RM®.
Como expor os Web Services do TOTVS RM® através do Host
A TOTVS® recomenda o uso dos webservices através do Host, mas nossa integração está preparada para trabalhar tanto com serviços via Host quanto via IIS. Para realizar o procedimento de liberação, siga a documentação da TOTVS® em: Documentação TOTVS.
Atenção à parte 2 do processo, que orienta a inclusão do IP público ou domínio da instituição.
Após as configurações dos arquivos de host, liberações no firewall e outros procedimentos de infraestrutura, acesse a página principal do TBC® utilizando o IP ou domínio público da instituição, conforme exemplo abaixo. 
Acesse também as configurações de WSDL do serviço de DataServer para verificar se a TAG ServicesHostName foi configurada corretamente. Basta comparar o endereço do navegador com o do XML, conforme imagem abaixo.
Como expor os Web Services do TOTVS RM® através do IIS
Esta opção não é a recomendada pela TOTVS® e tem menos recursos disponíveis, mas mantemos compatibilidade com ambas as formas. Para realizar o procedimento de liberação, siga a documentação da TOTVS® em:
Documentação TOTVS.
Após a liberação, basta acessar a página principal dos serviços para verificar o funcionamento.
Esta opção não é a recomendada pela TOTVS® e tem menos recursos disponíveis, mas mantemos compatibilidade com ambas as formas. Para realizar o procedimento de liberação, siga a documentação da TOTVS® em:
Documentação TOTVS.
Após a liberação, basta acessar a página principal dos serviços para verificar o funcionamento.
Configuração para receber requisições grandes (anexos)
No caso do IIS, ele permite por padrão requisições de até 4MB. Se for necessário enviar anexos maiores, ajuste essa configuração. Abra o arquivo C:\totvs\CorporeRM\WS_TBC\web.config e inclua a tag correspondente. No exemplo abaixo, configuramos para 20MB.
No caso do IIS, ele permite por padrão requisições de até 4MB. Se for necessário enviar anexos maiores, ajuste essa configuração. Abra o arquivo C:\totvs\CorporeRM\WS_TBC\web.config e inclua a tag correspondente. No exemplo abaixo, configuramos para 20MB.
Criação de usuário para integração no TOTVS RM®
Para que as operações da integração sejam executadas pelo TBC®, é necessário criar um usuário no TOTVS RM® com permissões específicas nos módulos Educacional, Processo Seletivo, Financeiro e Contábil. Crie perfis específicos com as permissões ilustradas abaixo e atribua ao usuário.
Módulo Educacional
Para que as operações da integração sejam executadas pelo TBC®, é necessário criar um usuário no TOTVS RM® com permissões específicas nos módulos Educacional, Processo Seletivo, Financeiro e Contábil. Crie perfis específicos com as permissões ilustradas abaixo e atribua ao usuário.
Módulo Educacional
Obs.: As permissões com o termo “sem restrição por Webservice” estão disponíveis a partir da versão 12.1.28.
No cadastro do usuário, em Usuário/Filial, libere permissão em todos os contextos que utilizarão a integração.
Módulo Processo Seletivo
Obs.: As permissões com o termo “sem restrição por Webservice” estão disponíveis a partir da versão 12.1.28.
Módulo Financeiro
Módulo Contábil
Não é preciso criar um perfil com permissões para este módulo, apenas liberar o período para manutenção de lançamentos.
Não é preciso criar um perfil com permissões para este módulo, apenas liberar o período para manutenção de lançamentos.
Caso ocorra erro de período não definido ao integrar a matrícula, deve ser criado um usuário chamado “RMProcessoSeletivo” apenas para incluir o período contábil para a contabilização dos lançamentos. Este usuário não precisa ter nenhuma permissão e nem deve ser utilizado na integração, servindo apenas para resolver o problema em questão. Para criar este usuário, siga a documentação da TOTVS®:
Manutenção de lançamentos fora do período.
Manutenção de lançamentos fora do período.
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo