Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. O que é TOTVS Connector
    1. TOTVS Connector Server
    2. TOTVS Connector Client
      1. Requisitos Mínimos de Instalação
      2. Requisitos de Ambiente / Infraestrutura (Citar as permissões do usuário do banco de dados e as liberações whitelist das urls)
    3. Diagrama da arquitetura do TOTVS Connector (Tentar generalizar para atender o da Carol, se não, criar 2 diagramas e colocar nos respectivos tópicos abaixo)
  2. Integração com aplicações TOTVS e de terceiros
    1. Introdução (explicar um pouco mais sobre as integrações de produtos internos e externos, pensar em um diagrama para ilustrar)
    2. Funcionalidades Entidades (Cadastros ?)
      1. TOTVS Connector Server
        1. Client Environment 
        2. SchemaDefinition
      2. TOTVS Connector Client
        1. Product Connection (citar que o usuário do banco cadastrado no product connection, precisa de permissão para inserir, alterar e deletar, criar e alterar triggers e tabelas)
        2. Product Connection Schema (citar que irá criar triggers no momento desse cadastro) 
        3. Modo Standalone
        4. External Event
    3. Mensagens
      1. Fluxo das mensagens
      2. Estrutura
      3. Como enviar? (rabbit + api do External Event)
  3. Integração com TOTVS Carol (Cadastros ?)
    1. Introdução Entidades (explicar um pouco mais sobre a integração com a Carol e pensar em um diagrama para ilustrar)
    2. Autenticação
    3. Funcionalidades
      1. Client Environment
      2. CarolUser
      3. CarolConnector
      4. CarolStagingTable
      5. EventDataCarol
    4. Mensagens
      1. Fluxo
      2. Estrutura das mensagens (EventDataCarolRequest)
      3. Como enviar? (rabbit + endpoint)
  4. Observações importantes
    1. Tempo de envio das mensagens (explciar que pode demorar por conta da conexão / processamento)

...

02. Integração com aplicações TOTVS e de terceiros

Introdução

...

Entidades

TOTVS Connector Server

Client Environment

Para o funcionamento do TOTVS Connector Client é necessário realizar um cadastro de ambiente do cliente. Este cadastro é feito no TOTVS Connector Server e irá gerar um token.
Esse token deve ser informado no momento da instalação do TOTVS Connector Client, por que no momento de iniciar o software ele irá validar se o token é válido.
Com um token válido, o TOTVS Connector Client pode sincronizar Schema Definition, buscar novos dados e enviar informações ao TOTVS Connector Server. Outra funcionalidade importante do token é a identificação do cliente, ou seja, todo dado trafegado deve possuir um token válido, só assim é possível separar os dados dos clientes.

Os produtos Cloud devem ter o token de cada cliente para conseguirem diferenciar os dados enviados e recebidos.

SchemaDefitinion

TOTVS Connector Client

Product Connection

Product Connection Schema

Modo Standalone

External Event

Mensagens

Fluxo de Mensagens

...

03. Integração com TOTVS Carol

Introdução

Autenticação

...

A TOTVS Carol é uma plataforma de dados com inteligência artificial, podendo aplicar todas as funcionalidades do MDM (Master Data Management, ou Gestão de Dados Mestre, em Português), como por exemplo: capacidade de receber dados de qualquer fonte,  garantir a qualidade dos dados e centralizar os dados de sua aplicação. Além disso, também possui a capacidade de desenvolver aplicativos e implantá-los na plataforma e utilizar a Assistente Carol. Para saber mais sobre a plataforma, você pode acessar a sua documentação.

O TOTVS Connector possui integração com a TOTVS Carol, podendo levar seus dados de aplicações On Premise ou SaaS para dentro da plataforma, podendo aumentar a qualidade de seus dados e gerar gráficos a partir deles. Nesse tópico, será explicado como configurar o TOTVS Connector Server para enviar dados à TOTVS Carol.

Autenticação

Para enviar dados à TOTVS Carol é preciso realizar a autenticação do usuário, que pode ser feita de duas formas: pelo accessToken ou pelo connectorToken. Para o TOTVS Connector Server, a autenticação será feita pelo connectorToken. Portanto, é preciso gerar o connectorToken na plataforma. Após gerado o connectorToken, será utilizado no cadastro da entidade CarolConnector, explicado nos tópicos a seguir.

Entidades

Client Envrionment

Carol User

...

Estrutura das mensagens

Como enviar?

04. 

...

Observações

Tempo de

...

processamento das mensagens