Versões comparadas

Chave

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

...

O usuário do banco de dados deve ter ter permissão de criar, alterar remover registros, colunas e triggers nas tabelas.


ProductConnection com o banco de dados SQL Server:

...

Informações
titleExemplo de Product Connection (PostgreSQL)
{
    "id": "68eaa1a2-aedb-4ba9-9015-a01a31bead89",
    "productName": "PIMS",
    "productVersion": "12.1.27",
    "url": "jdbc:postgresql://localhost:5432/PIMS",
    "username": "PIMS",
    "password": "PIMS",
    "dataBaseType": "POSTGRESQL",
    "enabled": true
}


Product Connection Schema

...

A entidade ProducConnectionSchema representa a relação entre as entidades ProductConnection e SchemaDefinition. Essa relação significa que uma determinada conexão integrará determinados SchemaDefinition. Por exemplo: a conexão A possui integração com os schemas Schema_A e Schema_B, e a conexão B, com os schemas Schema_B e Schema_C. Portanto, é possível possuir duas conexões com diferentes SchemaDefinition. A entidade SchemaDefinition é cadastrada no TOTVS Connector Server e a própria aplicação TOTVS Connector Client se encarrega de sincronizar, automaticamente, essa entidade. 

Após realizar o relacionamento, o TOTVS Connector Client

...

iniciará o monitoramento das tabelas definidas no

...

SchemaDefinition. Assim que houver qualquer alteração em qualquer registro das tabela integradas, o TOTVS Connector Client será notificado e

...

processará esse

...

registro e

...

enviarã para o TOTVS Connector Server.


Atributos

  • O atributo id é o identificador do registro;
  • O atributo idProductConnection é o id do registro da entidade ProducConnection;
  • O atributo idSchemaDefinition é o id do registro da entidade SchemaDefinition

Outra informação importante é se esse relacionamento irá habilitar o modo standalone, onde iremos explicar no tópico Modo Standalone .

Modo Standalone

External Event

...

A entidade CarolUser são informações de login da plataforma Carol que deve ser cadastrada no TOTVS Connector Server

Atributos

  • O atributo "organizationSubdomain" corresponde ao atributo "orgDomain" da TOTVS Carol;

  • O atributo "subdomain" corresponde ao atributo "subdomain" da TOTVS Carol, que se refere ao ambiente (tenant) que está se autenticando;

  • Os atributos "username" e "password" são informações do seu login na TOTVS Carol;

...

Portanto, CarolConnector é a relação do connector (connectorId) com o connector token gerado para esse mesmo connector na TOTVS Carol.

Atributos

  • O atributo connectorId é o id do connector na TOTVS Carol;

  • O atributo connectorToken é o identificador gerado para o connectorId na TOTVS Carol;

...

A entidade CarolStagingTable possui dois atributos similares, que representam abstrações diferentes: name e stagingTableName. A diferenciação de cada atributo será explicado a seguir.

Atributos

  • O atributo stagingTableName representa exatamente o nome da StagingTable na TOTVS Carol. Por exemplo, se na TOTVS Carol contém uma StagingTable com o nome "fazenda", o atributo stagingTableName deverá ser, exatamente, "fazenda";

  • O atributo name representa um "apelido" para o TOTVS Connector Server diferenciar dos nomes das StagingTable. Por exemplo, na TOTVS Carol contém uma StagingTable chamada "inspecao" e no TOTVS Connector Server, contém duas CarolStagingTable que apontam para a StagingTable "inspecao" na TOTVS Carol. Para diferenciar as duas CarolStagingTable, utiliza-se o atributo name.

  • O atributo description representa uma descrição sobre a CarolStagingTable;

...

A entidade EventDataCarolRequest é utilizada para encapsular os dados para enviar ao TOTVS Connector Server.

Atributos

  • O atributo environmentToken é o token gerado na entidade Client Environment;

  • O atributo stagingTableName é exatamente o apelido (atributo name) cadastrada na entidade CarolStagingTable;

  • O atributo originApp é o nome do produto que está enviando os dados (produto de origem);

  • O atributo dataList é uma lista de objetos que será enviada para a StagingTable na TOTVS Carol, ou seja, os objetos são as próprias representações da StagingTable;

...

O tipo genérico T é a entidade a ser encapsulada que, no nosso caso, será a EventDataCarolRequest. Portanto, para enviar uma mensagem para o TOTVS Connector Server, destinada à Carol, deverá mandar um objeto TOTVSMessage<EventDataCarolRequest>.

Atributos

  • O atributo header é a classe TOTVSHeader, também da biblioteca TJF, que será enviada no header da mensagem. 
    • O atributo type é o nome da StagingTable a ser enviada.
    • O atributo generatedOn é a data que está enviado os dados
    • O atributo locale é a localização utilizada no cliente.
  • O Atributo content é o tipo genérico T. No nosso caso, será a entidade EventDataCarolRequest.

...