Conectores

Conteúdos relacionados aos tipos de conectores no sistema DOX.

Tipos de conectores

Para cadastrar um conector deve-se acessar o menu de Processos e clicar em Conectores. Depois de acessar a tela de conectores, deve-se clicar em Novo para abrir a tela de Cadastro de conector.

image-1645130508008.png

Abaixo iremos listar os tipos de conectores que existem no sistema DOX. É interessante observar que, todos os conectores são utilizados nos processos BPM de diferentes formas. Eles são importantes para o funcionamento do procedimento pois fazem consulta no banco, configuram e-mail, insere informações...

E-mail

Conector utilizado para que sejam configuradas contas de e-mail que farão o disparo automático de e-mails configurados por eventos de comunicação através de processos dentro do DOX.

image-1645184477106.png

 

** Observação importante: DOX só trabalha com serviços de e-mail que permitem o acesso a apps menos seguros. No caso do gmail, clique aqui para saber como ativar / desativar esse recurso.

Banco de dados

Esse tipo de conector é utilizado para que conexões com bancos de dados externos sejam feitas a partir do DOX. Alguns campos de configuração são padrões para todos os tipos de bancos de dados disponíveis, sendo eles:

image-1645186891623.png

Botão "Mais opções": 

Entre os tipos de bancos de dados disponíveis para integração com o DOX, estão:

Ex: Microsoft SQL Server

image-1645187064668.png

No servidor do DOX Estúdio deve estar instalado o mesmo “Client” do SQL Server instalado no servidor do SQL Server.

*** O SQL Server só irá funcionar quando a Authentication for o metodo SQL Server Authentication.

Você também pode descobrir o ServerName rodando o comando SQL abaixo no SQL Server:

SELECT SERVERPROPERTY('Edition') AS EDICAO, 
       SERVERPROPERTY('ProductLevel') AS NIVELPRODUTO, 
       SERVERPROPERTY('ProductVersion') AS VERSAO, 
       SERVERPROPERTY('ServerName') AS ServerName
SQL

Esse conector é utilizado para que as mais variadas instruções SQL sejam montadas, podendo ser um SELECT simples, um UPDATE em algum campo, um INSERT em alguma tabela, entre outros. É juntamente utilizado em eventos de sistema para busca, alteração ou inserção de informações nos processos BPM: 

EXEMPLO:

image-1645187743462.png

Comando: Essa opção deve ser selecionada se for colocado na instrução SQL um comando que vai ser gravado no banco, como um CREATE, INSERT, UPDATE etc.

image-1645187867237.png

Webservice

Esse tipo de conector é utilizado quando determinada informação precisa ser trazida por meio de um serviço web. A partir desse conector é possível utilizar o evento BPM para leitura de webservices.

image-1645190044983.png

SMS

Com esse conector é possível configurar um dispositivo ou webservice para que sejam feitos envios de mensagens de texto.

image-1645190250678.png

Tipo: duas opções, sendo elas:

Web: utilizado caso as mensagens de texto sejam enviadas através de um serviço contratado da web.

Modem GSM: esse tipo é utilizado quando as mensagens são enviadas a partir de um modem físico.

Lista Personalizada 

Conector comumente utilizado para informar nomes de usuário ou e-mails. Serve para montar uma lista pré-definida que pode ser utilizada posteriormente em processos nos eventos BPM, como os de comunicação por mensagem Dox ou E-mail;

image-1645191315844.png

IMAP

Esse tipo de conector utiliza o protocolo IMAP para recebimento de e-mails. Pode ser utilizado dentro de processos em eventos como os de ler E-mails, servindo como um meio de comunicação entre o DOX e a conta configurada, para que possa ser feita a leitura da caixa de entrada em busca de determinadas informações.

image-1645191478853.png

Foreign Key

Conectores de Foreign Key (FK) são utilizados comumente para trazer uma lista de informações para um formulário BPM. Essas informações da lista são buscadas do banco, pode ser uma tabela, uma view etc... 

image-1645192542567.png

Proxy

Conector utilizado para configurar um proxy para acessar determinado serviço ou funcionalidade web. Esse conector está presente nos cadastros de EmpresasGrupos de Usuário e Colaborador.

image-1645192773820.png

Utilização de VIEW em conector FK

Quando for necessário criar um conector FK para incluir em um formulário para campo de seleção, onde a descrição terá valores concatenados, precisamos criar um VIEW para incluir neste conector.

Abaixo, este código representa um exemplo de como precisaríamos concatenar a informação da descrição. Deste modo, inserindo exatamente essa sintaxe no conector FK, não funcionará.

SELECT	IDCIDADE,
	    DESCRICAO || ' - ' || UF AS DESCRICAO
  FROM	CIDADE

É necessário a criação da VIEW, neste caso, vamos criá-la direto no banco com o código abaixo.

CREATE OR REPLACE VIEW VW_CIDADES AS
SELECT IDCIDADE,
       DESCRICAO||' - '||UF AS DESCRICAO,
       UF,
       INATIVO
  FROM CIDADE;

Para saber mais sobre criação de view:

Na configuração do conector, inserir as informações e condicionais conforme a necessidade:

image-1649705077005.jpg