Eventos

Eventos do sistema

JEX - Executar função

Evento de sistema utilizado para que em determinado momento (configurado ao entrar ou sair do evento) o procedimento BPM execute uma função JEX criada no sistema. 

image-1703784334967.png

Abaixo mais detalhes do evento: 

Assim que selecionada uma função, todo o script dessa função aparecerá no campo abaixo 'Chamada da função' como Somente Leitura para que o usuário verifique o seu código.

Exemplo de utilização simples 
function somar(valor1, valor2){
  return valor1 + valor2;}

Em seguida acessar o cadastro de BPM e criar um processo com duas atividades 

Na atividade 1, criar dois formulários do tipo dissertativos que recebam valores inteiros: 

image-1703784597791.png

Em seguida, na aba 'Eventos', acessar o agrupador 'JEX' e criar o evento 'Executar função'

image-1703784922594.png

Salvar o procedimento e executar o processo

 

Comunicação

Comunicação - Mensagem

Este evento é responsável por enviar uma notificação tanto em Estúdio quando em Portal DOX. Pode-se ser utilizado juntamente com validações do processo BPM. Abaixo mostraremos os campos do evento e em seguida um pequeno exemplo de como utilizá-lo. 

Acesse a aba "Eventos", no agrupador "Comunicação". 

image-1643380567695.png

Campos do evento: 

Veja o exemplo abaixo: 

Faremos um processo simples, onde o usuário irá apenas informar a justificativa da mensagem e ela será enviada para um grupo de pessoas definidas em um conector do tipo "Lista personalizada".

Em conectores (Módulo Processos > Conectores), ao criar um novo, coloque o tipo como  “Lista personalizada” e informe na descrição o USERNAME dos usuários para quem a mensagem será enviada. É importante que seja o username, pois este evento não envia para ID de usuário.

image-1643380783750.png

Em seguida crie um processo com apenas uma atividade com um formulário dissertativo para informar a justificativa/descrição da mensagem com uma variável do tipo texto vinculada.

image-1643380886129.png

Agora, vamos criar o evento.

No agrupador Comunicação - Mensagem, crie um novo evento ao sair.

No assistente de variáveis ao lado do campo, selecione  a aba “sistema”, lá estarão as variáveis do sistema, o que cada uma faz e seu valor padrão.

image-1643380937156.png

image-1643380958179.png

Utilize essas variáveis à vontade no texto da sua mensagem, assim como as variáveis que você mesmo criou no seu processo.
Basta clicar em cima duas vezes ou clicar em “OK” e eles estarão no texto.

Processo no portal: 

image-1643381060387.png

Mensagem recebida no Dox Portal:

image-1643381101248.png

Mensagem recebida no DOX Estúdio:

image-1643381126370.png

Comunicação - SMS

Agora falaremos um pouco sobre o evento "Comunicação - SMS", para envio de mensagens para um dispositivo móvel. 

image-1643629759419.png

Comunicação - E-mail

Os eventos do tipo e-mail podem ser utilizados em casos onde qualquer pessoa precisa ser comunicada de determinada ação da qual está envolvida. Ele enviará no e-mail do usuário (previamente configurado tanto remetente quanto destinatário) as informações configuradas no processo BPM, descrições, anexos, modelo de correspondência, e até destinatário de cópia. 

Exemplo: Depois de uma aprovação de uma compra acima de 500, o setor do financeiro deve receber um e-mail com as informações da compra, usuário que está solicitando, valor, etc.  Pensando na forma técnica de criar o BPM, depois da atividade onde é aprovado, ao sair seriam utilizados os eventos de condicional. Se a variável /*APROVACAO*/ for SIM, então o e-mail é enviado. 

image-1643630711996.png

SELECT IDARQUIVO 
  FROM GED_ARQUIVO 
 WHERE ORIGEM = 7 AND IDORIGEM = 0/*IDPROCESSO*/

Ou até mesmo passando o ID do arquivo diretamente: 

SELECT IDARQUIVO 
  FROM GED_ARQUIVO 
 WHERE IDARQUIVO = 49 

No lugar do idarquivo que está fixo "49", pode ser informado uma variável por exemplo, que receba no processo o ID do arquivo específico. Caso o SQL retornado tenha mais de uma linha ele enviará mais de um anexo no e-mail, correspondente as quantidades de linhas.

Gostaria de um exemplo prático? Clique no link abaixo.

Salvar protocolo - Enviando anexo e protocolo por e-mail

Comunicação - E-mail limpa pasta

Os eventos do tipo E-mail limpar pasta podem ser utilizados em casos onde determinada(s) pasta(s) estão com muitos e-mails armazenados e tornam-se lentas ou desorganizadas em sua visualização. Este evento irá limpar as pastas selecionadas de acordo com as informações que são repassadas pelo usuário. 

image-1643631653990.png

Social

Criar publicação

Eventos do tipo "Criar publicação" são utilizados em casos onde determinado conteúdo, assunto ou treinamento originados de um processo precisa ser divulgado no menu Social da empresa no DOX Portal. 

image-1643633033483.png

Como exemplo, utilizaremos um processo simples para reserva e agendamento de eventos, onde, ao ser agendado o evento, uma mensagem será inserida no Blog de acordo com o que foi configurado.

Após a interação com o processo e agendado o evento, a mensagem irá aparecer da seguinte maneira no menu Social do DOX Portal:

image-1643634798483.png

Registro banco dados

SQL - Executar

Eventos do tipo "SQL - Executar" trabalham em conjunto com conectores do tipo SQL. Imagine que você tem um processo de "Cadastro de Clientes", nele você precisa que após a colaboração com o processo as informações sejam cadastradas no banco de dados de acordo com as informações repassadas pelo usuário. É a partir deste evento que podem ser executados comandos do tipo INSERT, UPDATE, entre outros.

*** Lembre-se: Para executar um comando SQL na base de dados que fará alterações, seja inserindo, atualizando ou deletando dados de uma tabela, basta utilizar este mesmo evento "SQL - Executar", já as CONSULTAS em tabelas, view's seriam no evento "SQL - Selecionar".

image-1643636267164.png

*** Importa frisar: Nos conectores dessa evento, que fazem uma ação no banco (CREATE, UPDATE, DELETE, INSERT) o botão "comando" tem que estar marcado para o sistema execute o que está configurado,

 
SQL - Selecionar

Os eventos do tipo "SQL - Selecionar" trabalham em conjunto com conectores do tipo SQL. Por exemplo, imagine que você tem um processo de "Solicitação de Compras" e você precisa que o departamento do solicitante (usuário logado) seja trazido para determinado campo.

Para isso, você utiliza o evento SQL - Selecionar trazendo o departamento baseado na variável USERID (código usuário logado) e retornando esse departamento para uma variável de sua preferência.

image-1643638307326.png

Variáveis

Variáveis - Definir valor variável

O evento definir valor de variável serve para casos onde você precisa que um valor específico seja definido em uma variável, seja substituindo-a com o valor de outra variável existente (seja ela de processo, sistema, ou global) ou então definindo um valor fixo para a mesma.

Exemplo: Em um processo BPM, ao sair da primeira atividade, você precisa registrar que a variável /*DATAABERTURA*/ receba a data atual. Você precisa desse controle pois usará essa data em painéis de indicadores, relatórios etc. 

Bom, pode-se utilizar este evento de definir + a variável de sistema /*DATAATUAL*/ para realizar essa atribuição. 

image-1643740326859.png

Variáveis - Pegar valor de conector

Diferente do "Definir valor variável", neste evento podemos buscar o valor em uma tabela, view e ai sim atribuir a uma variavel do processo. 

Exemplo: Ao entrar no processo, é necessário que a variável /*DEPARTAMENTO_USUARIO*/ receba o departamento do usuario que está logado, abrindo o processo. Talvez nem seja necessário mostrar ao usuário essa informação de departamento, mas é importante ter pois posteriormente essa informação esteja em um relatório por exemplo. Poderia ser feito um SQL como: 

SELECT DESCRICAO
  FROM DEPARTAMENTOS
 WHERE IDDEPARTAMENTO = (SELECT IDDEPARTAMENTO 
                           FROM CLIFOREMP 
                          WHERE IDCLIFOREMP = 0/*USERID*/)

A variável /*USERID*/ utilizada acima refere-se ao IDCLIFOREMP. Essa variável é uma variável de sistema que traz o ID do usuário logado automaticamente.

image-1643824623473.png

Variáveis - Operações matemáticas

Eventos do tipo "Operações Matemáticas" podem ser utilizados em processos de Solicitação de Compras para que some/multiplique/divida etc, os valores de todos os itens selecionados, sejam eles informados em campos dentro de uma Grade de Dados, ou campos independentes no formulário de processo.

Para criar um evento de Operações Matemáticas, é necessário que tenhamos no nosso processo dois campos numéricos, que servirão como base para que o evento realize os cálculos. No caso da imagem estão sendo utilizadas variáveis do tipo Inteiro, porém podem ser utilizadas variáveis do tipo Valor, se necessário.

image-1643827408372.png

Agora, na aba Eventos, iremos criar quatro eventos de Operações Matemáticas, sendo que o primeiro será de Adição, e os seguintes de SubtraçãoDivisão e Multiplicação.

image-1643827742884.png

Em casos onde utiliza-se este evento para cálculos de grade, o mesmo deve encontrar-se entre uma estrutura de repetição que retorna os valores da grade. Na imagem abaixo encontra-se um exemplo da utilização deste evento em conjunto com uma estrutura de repetição.

image-1643827912790.png

Variáveis - Manipulação de Texto

Eventos do tipo "Manipulação de Texto" podem ser utilizados em casos onde se faz necessário que determinado texto seja alterado para que mantenha-se uma nomenclatura padrão em alguns termos, por exemplo.

image-1643830247803.png

Variáveis - Criptografar texto

Esse tipo de evento pode ser utilizado caso em algum momento você precise por motivos de segurança criptografar uma informação fornecida pelo usuário.

Sua configuração é bem simples, como veremos na explicação dos campos abaixo, e esse tipo de criptografia permite que possa ser descriptografado.

image-1643887427028.png

Variáveis - Descriptografar Texto

Assim como no evento acima, esse evento de descriptografar tem como objetivo e função descriptografar uma informação passada em uma variável do processo. 

image-1643888504094.png

Variáveis - Criptografar senha

Evento utilizado em casos onde faz-se necessário criptografar as credenciais de acesso de determinado usuário. O vínculo entre a senha e o usuário é realizado através do campo "Variável usuário" que se encontra acima do campo de senha na configuração do evento.

image-1643890751301.png

Variáveis - Criptografia MD5

Evento utilizado em casos onde deve-se criptografar dados pessoais e sigilosos de pessoas que estejam utilizando determinados processos, como um processo de compras, por exemplo, onde podem ser informados dados como número ou senha de cartões de crédito.

image-1643891079948.png

Sincronização

Sincronização - Importar dados de um banco para outro

O evento “Importar dados de um banco para outro”, dentro do agrupador de sincronização, é utilizado para quando são necessárias a busca e importação de informações de determinado banco de dados, para outro.

image-1643892363776.png

SELECT cod_cidade, 
       nome 
  FROM cad_cidades
SELECT 1 
  FROM cidade 
 WHERE idcidade = :cod_cidade

Considerando que os dados carregados do banco de origem possuem um campo chamado "cod_cidade", o qual irá alimentar o parâmetro ":cod_cidade" do SQL de verificação;

INSERT INTO cidade (idcidade, descricao) 
VALUES  (:cod_cidade, :nome)

Considerando que os dados carregados do banco de origem possuem um campo chamado "cod_cidade" e outro chamado "nome", os quais irão alimentar os parâmetros ":cod_cidade" e ":nome" do SQL de inserção;

UPDATE cidade 
   SET descricao = :nome 
 WHERE idcidade = :cod_cidade

Considerando que os dados carregados do banco de origem possuem um campo chamado "cod_cidade" e outro chamado "nome", os quais irão alimentar os parâmetros ":cod_cidade" e ":nome" do SQL de atualização;

Após processar a sincronização de todos os registros, confirma a transação no banco de dados de destino (commit) ou reverte todas as alterações em caso de falha (rollback).

Sincronização - Importar dados Excel

Caso você tenha uma planilha Excel de onde deseja extrair informações para o DOX, poderá utilizar o evento Importar Dados Excel para trazer essas informações. Depois de importado para o BPM o usuário pode utilizar essas informações em sua gestão juntamente com a ferramenta. 

Aba 1: 

image-1643893397736.png

Aba 2: 

image-1643893435625.png

Em um processo BPM por exemplo:

image-1644411277551.png

Evento configurado: 

image-1644411318149.png

Campo "Tipo de importação": Neste campo você pode informar se quer importar células especificas ou o planilha inteira, caso selecione a planilha inteira vale ressaltar que o evento irá criar uma tabela no banco como por exemplo EXL_ por padrão é o nome informado na aba de Importar planilha inteira.

Caso opte por essa opção a primeira linha do arquivo corresponde ao nome das colunas e a segunda para baixo os dados. Caso deixe a opção de células específica você deve informar o numero da linha e qual coluna está o dado, como na imagem abaixo, o tipo que essa informação será salva, casas decimais caso seja um dado do tipo valor e para qual variável ele irá colocar a informação do arquivo

Formulários do BPM mostrado na primeira imagem:

image-1644416499661.png

Ao entrar na atividade o evento irá importar os dados para as variáveis que foi configurada, desse modo, quando o usuário abrir o processo os formulários já estarão com os valores da planilha Excel. Se o Excel tiver vários dados e você precisar importar todos eles, o correto seria para uma variável do tipo grade de dados ao selecionar o tipo de importar a planilha inteira.

EXEMPLO: 

Ao  entrar na primeira atividade é importada a planilha inteira e o sistema irá criar uma tabela com os dados no banco, EXL_TESTE por exemplo, na segunda atividade criada você usaria o seguinte evento:

Neste evento teria um SQL que consultaria tabela para retornar os dados e armazenar em uma variável do tipo grade de dados e está estar vinculada a um formulário do tipo grade de dados com os campos criados correspondente aos nomes da coluna da tabela de cada campo.

Sincronização - Importar dados arquivo texto

Eventos deste tipo são utilizados em casos onde determinados dados de um arquivo de texto precisam ser importados para o sistema. Por exemplo, você tem uma lista de itens que deve ser baixada como um arquivo texto. Este evento irá realizar a importação desta lista para o sistema de acordo com o delimitador utilizado no arquivo de texto.

image-1643893722350.png

 

NF-e

Baixar XML NF-e do e-mail

Se você tem na sua caixa de entrada vários XML de notas fiscais eletrônicas, pode utilizar este evento para que esses XMLs sejam baixados e enviados para determinada pasta do seu e-mail e também computador.

image-1643973149722.png

Consultar nota fiscal eletrônica

Evento utilizado para que determinada nota fiscal seja consultada para que seu status atual seja retornado ao usuário. Com esse status no processo BPM, é possível fazer diversas tratativas.

image-1643974418027.png

Importar arquivo XML NF-e 

Evento utilizado para que determinada nota XML seja importada de um local do computador para outro. Além disso, ao utilizar este evento, o XML é importado diretamente para o sistema, sendo possível consultar na tabela CRM_PROCESSO_XML ou no módulo "Processo" > "XML". 

Com o arquivo no sistema, pode ser feito sua manifestação, gerar a DANFE, etc.

image-1650892601526.png

Utilizando qualquer um desses campos, o sistema já entende e importa os dados ao executar o processo. 

 

Manifestação

Evento utilizado para fazer a manifestação de notas fiscais. Neste evento, pode-se escolher o tipo de manifestação e o caminho para salvar o XML. É um evento importante e pensado em facilitar o manifesto de diversas notas de uma vez só.

image-1643974971365.png

** OBS: O campo "Motivo" é obrigatório para a manifestação do tipo "Não realização da operação". O campo do SQL de consulta que retornar a chave deve ser identificado como "CHAVE"

Consulta notas destinadas

Evento utilizado para fazer a consulta das notas fiscais destinadas. 

image-1643975452654.png

Baixar XML NF-e do SEFAZ

Evento utilizado para que o download de um XML de nota fiscal eletrônica seja feito diretamente do Portal do SEFAZ e trazido para o computador local. 

image-1643976414053.png

OBS: O campo do SQL de consulta que retorna a chave deve ser identificado como "CHAVE"

Gerar DANFE XML

Evento utilizado para que seja gerado o DANFE do XML de determinada nota fiscal eletrônica, de acordo com o código do XML na tabela CRM_PROCESSO_XML. 

image-1643979126899.png

PEX - Executar função

Evento utilizado para que em determinado momento um processo execute uma função PEX criada no sistema. 

image-1643900145958.png

Assim que selecionada uma função, todo o script dessa função aparecerá no campo abaixo como Somente Leitura para que o usuário verifique o seu código.
**Funções PEX só podem ser criadas por pessoas certificadas ou que tenham permissão em nosso banco de dados. Geralmente é o desenvolvimento quem pode acessar/criar/validar/liberar funções PEX como essas que vão no evento.

 

Arquivos

Arquivos - Manipular arquivos 

Evento responsável pela manipulação de arquivos por um processo BPM. Neste evento é possível realizar diversas ações com os arquivos diretamente no computador local (onde o sistema está instalado). Pense em um processo de backup de arquivos por exemplo, onde seja necessário copiar, deletar ou mover os documentos, com este evento seria possível realizar tal procedimento,

image-1643983181394.png

Conforme for selecionada uma das opções acima, os campos Caminho origem e Caminho destino sofrerão alterações, porém, sempre será solicitado o caminho do(s) arquivo(s) que sofrerá(ão) alteração(ões).

Exemplos: 

Neste exemplo trataremos do evento de manipular arquivo, o qual pode manipular dentro do servidor de aplicação arquivos em diversos formatos, neste exemplo, executaremos um arquivo BAT ou seja, uma arquivo baseado em MS-DOS/Comandos em lotes.

Precisamos criar um variável do tipo texto ou texto longa a qual terá o endereço completo de nosso arquivo a ser manipulado/executado, este pode ser informado no valor padrão da variável ou informado via formulário conforme o exemplo abaixo:

image-1643982896381.png

image-1643982932364.png

Após informarmos o caminho onde o arquivo se encontra, vamos vincular o mesmo ao nosso evento.

image-1643982977544.png

No exemplo acima o arquivo bat executará os seguintes comandos:

cd C:\                                 
mkdir TESTE                             
move forum.txt  TESTE/forum.txt       

Ou seja, vai criar um pasta chamada TESTE no C:\ do servidor, e irá mover um arquivo existente chamados forum.txt do C:\ para essa nova pasta;

**LEMBRETE! **
O arquivo bat e os arquivos que estou movendo através dele, estão todos no servidor onde a aplicação está sendo executada, para acesso dos usuários os arquivos devem ser manipulados para dentro de pastas compartilhadas ou alguma outra locação do gênero.

Arquivos - Carregar arquivo

image-1643983321676.png

Exemplo: 

Aqui será abordado um exemplo de como trazer os anexos de um e-mail (IMAP) e popular estes anexos em uma variável para que possam ser usados no processo BPM e posteriormente ser utilizado validações.
Eventos utilizados: 

Pode ser criado formulários para guardar outras informações, nesse caso vamos focar apenas nos eventos. Assim que fizer todas as configurações desejadas,  vá a aba eventos para começarmos a configurar os eventos necessários.

Isso fará com que ele percorra todos os arquivos anexados na instância. Em seguida crie o evento "Estrutura condicional - Inicio"

image-1643985944866.png

Assim que configurado como a imagem acima, vamos criar o evento que carrega os anexos para uma variável.

No campo "Arquivo" será informado o ID do anexo do processo e basta utilizar uma variável do sistema para pegar o id do anexo. /*ANEXOIDANEXO*/, depois crie uma variável do tipo Anexo - Arquivo e vincule no campo "Variável armazenar".

Feche a estrutura com o evento de "Estrutura condicional - Fim". Agora você tem os anexos do e-mail no processo e pode utiliza-los no que for preciso. Por exemplo, a cada e-mail que é buscado pelo IMAP é criado um card com as informações. E esses anexos tem que ir para esse card no kanban. 

Enfim, as possibilidades são inúmeras. 

Arquivos - Carregar lista de arquivos e pastas

Ele é responsável por carregar pasta e arquivos de determinado local do seu computador por meio de um processo BPM. Nele você coloca também o local de destino, ou seja, o local onde ele será importado, podendo ser uma pasta cadastrada do GED ou algum local padrão do sistema.

image-1643986595115.png

Entrada: 

Saída:

Na tela de cadastro dos campos da grade, foi disponibilizado o assistente "Carregar campos da lista de arquivos e pastas". Quando deseja-se exibir no formulário de colaboração a grade alimentada pelo evento "Arquivos - Carregar lista de arquivos e pastas", esse assistente irá criar os campos automaticamente.

image-1643986639778.png

Arquivos - Criar arquivo

Com este evento pode-se criar um arquivo de texto direto no seu computador através de um processo BPM. Veja o exemplo de criação abaixo:

Uma atividade manual com um campo dissertativo e uma variável /*ARQUIVO*/ do tipo texto longo. Em seguida, crie o evento no agrupador "Arquivos", conforme imagem abaixo.

image-1644417761636.png

E-mail

Buscar E-mail 

Esse evento é utilizado para que seja feita a leitura da caixa de entrada de determinado e-mail em busca de informações específicas da sua necessidade. 

image-1643898304264.png

image-1643899317029.png

Agendamento / Temporizador

Temporizador de espera

Esse evento é utilizado quando uma atividade precisa ficar escondida de colaboração por determinado tempo antes que o usuário possa colaborar com ela.

Pode ser utilizado, por exemplo, em processos de Produção, onde um produto foi enviado para fabricação e seu processo foi passado para frente na atividade de Embalagem, porém o responsável por essa atividade não pode colaborar imediatamente com o processo. Desse modo, configura-se um temporizador de espera de acordo com o tempo estimado de fabricação do produto para que a atividade "Embalagem" possa ser executada.

** ATENÇÃO: Aguarda 'x' horas e minutos antes de liberar o processo para colaboração.

image-1644585916417.png

Caso a instância com o temporizador configurado ainda esteja "escondida" da colaboração e seja tentado acessar para continuar, o sistema dará o seguinte erro: "A instância do processo ainda não está liberada para colaboração".

image-1644586932077.png

 

Criar agendamento / Remover agendamento

Esses eventos são em sua maioria utilizados em conjunto. São utilizados caso você queira que uma instância de processo mude sua atividade de acordo com um limite de tempo pré-definido no evento. É importante citar que aqui chegamos a uma parte importante de processos BPM, o motor DOX. 

image-1644587963688.png

Depois de ser criado um evento de CRIAÇÃO de agendamento, precisa criar um evento de REMOÇÃO desse agendamento. Pois ele precisa sumir da fila depois de executado sua ação. 

image-1644588390530.png

*** ATENÇÃO: É interessante utilizar da seguinte estrutura: 

Um exemplo de uso destes eventos em um processo seria com um processo de solicitação de investimento. Caso uma solicitação de investimento foi aberta e não houve colaboração na primeira atividade deste processo durante um período de 8 horas, o agendamento encaminha o processo para o fim.

Deste modo, pode-se dizer que a atividade destino dessa atividade será o Fim, pois entende-se que a mesma foi aberta por engano.

Exemplo: 

Vamos criar um exemplo com um procedimento, visando mostrar na prática a utilização desses dois eventos de sistema. Porém, antes de criar o BPM, é importa verificar duas questões:

Acesse o ema configurador > Serviços > Marque o ema Motor DOX: 

image-1644588734517.png

No exemplo mais a frente iremos criar um processo simples de registro de despesas. Ele funcionará da seguinte forma: caso o usuário fique parado na primeira atividade por 1h hora, o processo irá ser cancelado automaticamente. Se o usuário prosseguir, a despesa informada por ele será cadastrada em uma tabela do banco de dados. 

Antes da criação do BPM, vamos criar a nossa tabela de despesas: 

CREATE TABLE X_DESPESA (
IDPROCESSO INTEGER NOT NULL PRIMARY KEY, 
IDUSUARIO  INTEGER NOT NULL,
DESCRICAO  VARCHAR (250),
NUMERONOTA INTEGER,
VALOR      NUMERIC (15,2))

Agora, vamos criar o nosso BPM. Estamos disponibilizando o BPM Clicando aqui ou em anexo deste tópico. Porém é interessante ler todo o tópico de criação para melhor entendimento.

A principio teremos as seguintes atividades

Atividade 1: Inicio Padrão 
Atividade 2: Manual "Preenchimento da Despesa" Onde o usuário colocará as informações de descrição, nota e valor da despesa.
Atividade 3: Automática "Registra Despesa" Onde será registrado a despesa no banco de dados.
Atividade 4: Automática "Cancela processo" Caso o processo aberto fique sem interação por 1h será encaminhado para a atividade "Cancela processo" e a colaboração se encerará.
Atividade 9999: Fim Padrão

Veja a imagem:

image-1645018269001.png

Atividade 2 - Preenchimento da Despesa:

Nesta atividade terá 3 formulários obrigatórios para que o usuário coloque as informações sem falta. Faça conforme a imagem: 

image-1645018605424.png

** Configure o tamanho dos formulários da forma que achar melhor.

Depois de criado os formulários, vamos para os eventos: 

image-1645018630309.png

Neste evento vamos definir o valor da variável de sistema /*IDPROCESSO*/ para uma variável que criamos no processo /*CODPROCESSO*/

image-1645018709551.png

Vamos pegar o IDUSUARIO que está atualmente colaborando com o processo, passando como parâmetro a variável de sistema /*USERID*/. 

image-1645018872137.png

SQL de consulta: 

SELECT IDUSUARIO
  FROM USUARIO
 WHERE IDCLIFOREMP = 0/*USERID*/

Chegamos no evento mais importante, no campo "Atividade destino" é necessário colocar a atividade "Cancela processo", ou seja. o agendamento irá mover a colaboração para essa atividade depois de 1h. Outra observação é que o campo de min, deve ter o zero como valor caso nada seja colocado nele. Este evento está AO ENTRAR.

Faça como na imagem abaixo:

image-1645019052878.png

image-1645019204592.png

Atividade 3 - Registra Despesa:

Nesta atividade automática só iremos criar um evento de executar SQL para que os dados informados pelo usuário sejam cadastrados no banco de dados. Vale ressaltar que isso só ira ocorrer se o processo for colaborador, caso sua colaboração seja abandonada, o processo irá ser cancelado. 

image-1645019448028.png

SQL de execução: 

INSERT INTO X_DESPESA
VALUES (0/*CODPROCESSO*/, 
        0/*IDUSUARIO*/,
        '/*DESCRICAO*/',
        '/*NUMERONOTA*/',
        CAST(REPLACE('0/*VALOR*/', ',', '.') AS NUMERIC (15,2)))

** Variáveis do tipo texto devem ir entre aspas, enquanto as do tipo inteiro devem ter um zero na frente.

Atividade 4 - Cancela processo

É aqui que o sistema irá encaminhar a colaboração caso haja inatividade. Vamos apenas configurar um evento simples de cancelamento.

image-1645019618123.png

O campo "Motivo" irá preencher o campo "motivocancelamento" da tabela CRM_PROCESSO.

Exceção

Eventos do tipo Gerar e Tratar exceção são, geralmente, utilizados em conjunto para verificar se determinada situação está de acordo com o que deveria ser executado.

Imagine que você tem um processo onde determinado valor informado pelo usuário deve ser verificado de acordo com uma norma padrão da empresa.

Caso o valor não esteja de acordo com a norma, uma exceção será gerada e uma mensagem aparecerá para o usuário informando a inconsistência. A opção de "Tratar exceção" serve para caso seja necessário enviar o usuário para uma atividade específica quando a exceção for gerada.

Gera exceção

O agrupador "Exceção" serve para que sejam geradas exceções no log do processo caso qualquer inconsistência seja encontrada no decorrer da execução.

image-1644500479420.png

Mensagem de erro no portal: 

image-1644501406916.jpg

Esse é o evento que irá gerar a exceção dentro do log do processo e também na tela de colaboração. Nele, é possível que seja configurada uma mensagem de erro para melhor identificação da inconsistência.

Trata exceção

Esse evento será o responsável por tratar a exceção que foi encontrada. De acordo com a necessidade, deverá ser configurada a atividade que será executada quando exceções forem encontradas

image-1644501596416.png

Exemplo 1:

Neste exemplo serão mostradas duas formas de tratamento utilizando esses dois eventos. Em um processo com apenas uma atividade, foi criado dois formulários do tipo dissertativo com suas respectivas variáveis:

image-1644501781096.jpg

Neste processo, ao preencher os campos "Nome" e "Endereço", os mesmos serão inseridos na tabela registro_endereco onde ao ser executado o evento Conta os registro - Selecionar será contado o numero de linhas da tabela de acordo com o processo atual para verificar se o registro foi realmente inserido.

Caso o número de linhas seja igual a 0, ou seja, o SQL não inseriu os valores por algum motivo, vai ser gerado uma exceção, onde será mostrado uma mensagem de erro para o usuário configurado no evento.

Ao ser preenchido o CHECKBOX ao lado do evento "Gera Exceção", é criado um evento de "Trata Exceção", onde no campo "Atividade destino" é configurado para onde é direcionado o processo ao ser gerada a exceção.

Essa forma de tratamento serve para além de personalizar a mensagem mostrada, validar um erro operacional do processo.

image-1644502227358.jpg

No portal, a mensagem configurada no evento:

image-1644502244894.jpg

Exemplo 2: 

Com os mesmos formulários criados acima, na aba eventos vamos apenas manter o evento Insere na tabela - Executar, clicar no CHECKBOX ao lado deste evento e criar o evento Trata Exceção.

Desse modo, caso ocorra algum erro no INSERT o processo apenas mostrará o erro do banco de dados, e o "Trata exceção" direcionará  processo para a atividade configurada no evento.

image-1644502448967.jpg

No portal, a mensagem que será mostrada na exceção:

image-1644502474538.jpg

Processo

Processo - Iniciar novo processo 

Eventos deste tipo devem ser utilizados quando existe a necessidade de que um processo já existente no DOX seja iniciado a partir da colaboração com um outro processo.

Imagine que você tenha um processo de Contratação, e que após a efetivação da contratação, é necessário que as credenciais deste novo colaborador sejam criadas, mas você não possui acesso para criar tais credenciais. Deste modo, deve-se utilizar um evento Iniciar novo processo, trazendo por meio de variáveis globais os dados conforme foram repassados no processo de Contratação, para que o responsável possa, portanto, gerar as credenciais.

Ou seja, em determinada etapa do processo, um outro processo à parte será iniciado. Esse evento serve para quando há casos onde essa necessidade exista. 

image-1644491820543.png

Processo - Finalizar processo atual

Evento utilizado para finalizar o processo atual em colaboração. Com este evento, a instância será direcionada para a atividade fim (atividade 9999) e o status da instância mudará para 2 (finalizado).

image-1644495439221.png

Processo - Cancelar processo atual

Evento utilizado para cancelar o processo em colaboração. Com este evento, a colaboração será cancelada e o status da instância mudará para 3. O procedimento irá parar exatamente onde está e seu status será mudado apenas. Não aparecerá mais para a colaboração, nem em telas de processo, etc.

image-1644493108859.png

Processo - Alterar informações do processo

Evento utilizado para que algumas informações do processo, como ObjetivoExpectativaMotivo para iniciar, etc. sejam alteradas de acordo com a necessidade do modelador. Essas alterações serão inseridas nos campos da tabela CRM_PROCESSO, que geralmente são usadas para auxiliar na colaboração dos processos no portal. 

image-1644493362676.png

Processo - Gerar link do processo 

Evento utilizado para gerar um link externo de colaboração com o processo, eventos deste tipo são utilizados geralmente em casos onde pessoas externas à empresa precisam colaborar com o processo em questão. A partir desse evento, gera-se o link do processo, que posteriormente será enviado por e-mail a pessoa que deverá realizar a colaboração.

image-1644495738125.png

Processo - Exibir mensagem para o usuário

Evento utilizado quando é necessário dar um retorno ao usuário sobre as operações realizadas por ele e pelo processo, podendo ser exibida uma mensagem de Erro ou Informação.

image-1644496089735.png

Processo - Criar lembrete 

Evento responsável por criar um lembrete para o usuário. Quando este evento é utilizado, ele mostra na portal uma tela de notificação de acordo com os dados informados no evento (Data, Hora, Usuário, Descrição).

Antes de tudo, verifique se no ema_configurador o seguinte serviço está sendo executado, caso não esteja, marque-o e suba os serviços novamente, senão o evento de lembrete não vai ser executado.

image-1644497125176.png

Evento: 

image-1644496796200.png

Exemplo de sua utilização em um BPM: 

Vamos criar uma FK para que o usuário possa escolher o usuário destino que receberá o lembrete na tela. É importante esse detalhe, pois o evento só funciona se o valor do destino ser o USERNAME do usuário. Em conectores, crie um tipo Foreign key que busque dados da tabela USUARIO de acordo com a imagem abaixo:

image-1644497382426.png

Agora, vamos criar uma atividade para informar esses dados.
Neste atividade faça quatro formulários. 

— Um formulário do tipo dissertativo com a Fk que criamos vinculada para escolher o usuário, sem variável vinculada.

image-1644497402991.png

**OBS: Vamos criar um evento PEX ao sair desse formulário para atribuir o valor do campo da FK USERNAME para a variável de processo DESTINO, pois quando salvamos o processo, o formulário de FK salva automaticamente o ID do usuário, não a descrição.

Vá até a tela de programação PEX deste formulário e faça como na imagem:

image-1644497435781.png— Um formulário dissertativo para colocar a descrição do lembrete com uma variável do tipo texto vinculada
— Um formulário dissertativo para colocar a data do lembrete com uma variável do tipo data vinculada
— Um formulário dissertativo para colocar a hora que o lembrete vai ser disparado com uma variável do tipo hora vinculada.

image-1644497452938.png

Em seguida, ao sair da atividade, procure o evento de lembrete (Processo - Criar lembrete) e informe:

image-1644497472424.png

No portal, o processo aparecerá assim:

image-1644497486496.png

Ao clicar em "Confirmar" e finalizar o processo, quando o evento ser executado na data e hora informadas, ele aparecerá na tela, assim no portal:

image-1644497509733.png

Note que a descrição ali da notificação é aquela que informamos no campo do processo "Descrição".

Caso queira que o USERNAME já seja setado quando entrar na atividade por um usuário fixo, pode-se utilizar o evento de Variáveis - Definir valor variável.

Processo - Adicionar comentário 

Novo evento do sistema, disponível na versão 12.10+ no agrupador "Processo".
Este evento permite, por meio de um processo BPM, que seja vinculado na instância de um processo (atual ou informado na variável) um comentário, tendo o usuário logado, executando o processo, como criador do comentário. Ele contém os seguintes campos:

image-1644497681390.png

Sendo possível definir:

Caso for usando a opção "Conforme variável", a variável deverá conter um dos seguintes valores: "S" ou "N".
OBS: Como citado inicialmente, o criador do comentário é sempre o usuário logado que está executando o processo.

Exemplo do evento em um processo:

image-1644497734412.png

Em um kanban por exemplo:

image-1644497759014.png

Estrutura condicional

Estrutura condicional - Inicio 

Neste tópico será abordado o evento de Estrutura condicional, este evento é muito importante para validações de formulários, dentre outras funções que podem ser realizadas. 

Estrutura condicional é semelhante a um IF em uma programação, ele irá iniciar uma validação e então, se a validação for verdadeira, executar uma ação especifica.

Entre o Inicio e Fim, podemos adicionar um outro evento que irá realizar uma ação, ou seja, se entrar na condição, esse evento será executado. 

image-1643908926509.png

Estrutura condicional - Fim 

Neste evento ele apenas encerra as validações iniciadas no evento de estrutura condicional: Inicio

image-1643914990926.png

Estrutura de repetição

Aqui falaremos sobre os eventos que estão mais envolvidos com o formulário do tipo grade de dados. Iremos demonstrar a funcionalidade de cada um em sequência.  

Estrutura de repetição - Carregar

Este evento irá percorrer uma consulta SQL de um conector vinculado ao evento até encontrar todos os registros trazidos e armazená-los em uma variável do tipo grade. 

Qual a diferença deste evento para o evento de registro banco dados - SQL - Selecionar? Bom, como citado acima, este evento serve especificamente para buscar valores e preenche-los em uma grade de dados. O evento de SELECIONAR serve para consultar e atribuir valor a outros tipos de variáveis. 

Exemplo: Você tem um processo de registro de treinamento com uma grade de dados de participantes. Utilizando este evento, você poderá retornar a lista de colaboradores da sua empresa para que selecione os participantes do treinamento realizado.

image-1644503135137.png

*** Não esqueça de, além de criar a variável e vincular ao evento, criar o formulário grade com seus respectivos campos. É importante que as colunas no SQL sejam as mesmas colunas no formulário. 

Conector SQL: 

image-1644503229822.png

Formulário do tipo GRADE: 

image-1644503258334.png

Estrutura de repetição - Descarregar

Evento utilizado para limpar o valor de uma variável específica do processo para que a mesma após ter sido utilizada não continue consumindo espaço na memória. 

Exemplo: Um processo que mostre os dados dos colaboradores em uma grade ao entrar na primeira atividade. Como é uma lista meramente visual, onde o usuário não irá interagir e nem editar / inserir nada, não há motivo para salvar esses dados. Dessa forma, utilizamos o evento de descarregar. 

image-1644503556562.png

Estrutura de repetição - Retorna valor

Evento utilizado para que sejam retornados valores de uma variável de grade de dados. Neste evento, informaríamos a coluna do formulário da grade, e a variável que receberia o valor dessa coluna. Caso a grade tenha mais de uma linha, é importante utilizar uma estrutura condicional com origem "conjunto de dados" e em seguida o evento de retorna valor. 

image-1644503885915.png

Exemplo: 

Vamos realizar um exemplo onde utilizamos uma estrutura para carregar os dados para uma grade, retornar o valor desses dados para as variáveis e em seguida inserir em uma tabela personalizada. 

Eventos utilizados: 

Inicialmente vamos começar a criar nossa tabela personalizada.

Pode ser mudado o nome ou os campos posteriormente, mas para nosso exemplo vamos utilizar dessa forma. Crie um conector do tipo "SQL" e marque a opção "comando" para poder criar a tabela conforme instrução SQL abaixo, ou acesse uma ferramenta de banco de dados.

  CREATE TABLE PEX_USUARIO (
               IDUSUARIO INTEGER,
               USERNAME VARCHAR (150),
               INATIVO VARCHAR (1));

Agora, Iremos criar o nosso processo BPM. Vamos começar com a criação das variáveis que iremos precisar para vincular aos eventos. Acesse a aba "Variáveis" e crie conforme tabela abaixo:

Descrição:  Tipo: 
/*G_DADOS*/ Grade de dados
/*IDUSUARIO*/ Inteiro
/*INATIVO*/ Texto
/*USER*/ Texto

Depois de criada as variáveis acima, crie uma atividade manual com um formulário de grade, vinculando nossa variável criada mais cedo. 

image-1644580864165.png

É importa a criação das colunas da grade. Elas deve ter o NOME igual ao que será carregado pelo evento de carregar grade. Faça como na imagem: 

image-1644581093964.png

Salve o que já foi criado e agora iremos para os eventos, a parte mais importante deste exemplo: 

image-1644581154894.png

Evento 1: 

Este evento é o responsável por buscar os dados da tabela de usuários e carregar a nossa grade. Note que ele está com o momento da execução ao entrar, ou seja, quando o usuário abrir o processo para colaboração já estará populado na grade os usuários. 

image-1644581269344.png

No SQL de consulta: 

SELECT IDUSUARIO,
       USERNAME,
       INATIVO
  FROM USUARIO

Evento 2: 

Este evento é responsável por percorrer todos os registros da grade (quando há mais de um). É de extrema importância que este evento esteja com a origem "conjunto de dados" pois é um recurso especifico para grade de dados. Ele irá percorrer todos os dados que estiverem populados na variável de grade vinculada no campo "Variável origem". 

Neste caso, estamos deixando ao sair pois nossa grade é editável, ou seja, o usuário pode mudar os dados apresentados.

image-1644581444073.png

Evento 3: 

Existe uma razão para qual este evento está abaixo do evento de percorrer a grade, pois depois de percorrer um registro, ele irá passar para o evento de retorna valor, onde esse valor atual será populado em uma variável. Ou seja, a variável destino do evento irá receber o valor atual daquela linha em especifico. 

** Atenção: A variável que guarda o USERNAME não pode ser nomeada como /*USERNAME*/ pois esta é a descrição de uma outra variável do sistema e pode ocorrer conflito. Por este motivo, deixamos como /*USER*/

image-1644581649567.png

Evento 4: 

Logo depois que o registro atual é retornado para a variável, nós inserimos esse valor na tabela. Depois que esse INSERT é feito e a estrutura terminar para o registro, ela irá começar novamente, onde o sistema passará para o registro posterior, linha por linha. É de fato uma estrutura de repetição, onde cada linha da grade é lida, passada para a variável e incrementada na nossa tabela personalizada. 

** Atenção: Repare que no INSERT temos a opção "comando" marcada e as variáveis do tipo INTEIRO tem um zero (0) na frente, enquanto que as variáveis do tipo TEXTO estão entre aspas. Siga essas instruções para que o INSERT seja bem sucedido. 

image-1644582017599.png

Evento 5: 

Com isso fechamos nossa estrutura de repetição para a grade. 

Confira todos os dados criados e em seguida feche e salve o processo. Teste no portal e faça a consulta no LOG e banco de dados para verificar se o INSERT foi bem sucedido. 

Lembre-se que este é apenas um exemplo, depois de criado, pode ser mudado/alterado os dados, tabela e eventos da forma que for a sua necessidade. Pode também baixar o processo em anexo deste tópico, só não esqueça da criação da tabela personalizada, ou se necessário, alterar os dados conforme achar melhor. 

Arquivo XML

Ler Tag/Atributo

Evento Ler Tag/Atributo é utilizado para quando é necessário fazer a leitura de informações a partir de um arquivo do tipo XML. É aqui que campos de determinado XML podem ser lidos pelo sistema, retornando seu valor para uma variável.

image-1673529538182.png

image-1645105450464.png

Ler Tag/Atributo - Repetição

Este evento é utilizado para caso onde devem ser lidos tags ou atributos de tags que contenham repetição dentro de um xml.

image-1645109767657.png

Exemplo de uso: 

image-1673527525405.png

No evento do DOX, os campos da repetição devem ser informados em "Tag XML". Lembrando que o que for maiúsculo deve ser informado em maiúsculo no evento, e vice-versa. 

O "campo destino" será criado na tabela e recebido o valor do XML de acordo. 

image-1673529365958.png

No log: 

image-1673529466206.png

Agora, verifique a tabela e veja os valores importados ao XML. 

Arquivo JSON

Ler Par  

Evento utilizado para quando é necessário fazer a leitura de informações a partir de um arquivo do tipo JSON. Utilize este evento quando é necessário que campos de determinado Arquivo JSON sejam lidos pelo sistema, retornando seu valor para uma variável.

image-1645129303261.png

Ler Par - Repetição
Caso o par de dados JSON que precisa ser lido tenha repetição (esteja entre colchetes []), deve-se utilizar esse evento para que esse par de repetição possa ser percorrido e trazido para um campo para que possa ser consultado posteriormente.

image-1645129937118.png

Senhas

Eventos de "Senhas" estão ligadas diretamente ao recurso de telas de atendimento. Em uma empresa que trabalha com atendimento é necessário ter um procedimento para chamar a próxima senha, chamar a ultima senha, reiniciar senha, de forma a manter o controle e deixar organizado. 

Os eventos abaixo geralmente trabalham em conjunto, por isso é interessante ver um exemplo de sua utilização. 

** ATENÇÃO: Clique aqui para entender como funcionar os eventos BPM juntamente com a tela de senha de atendimento. 

Senha - Chamar próxima senha

image-1644499615137.png

Senhas - Chamar última senha

image-1644499780440.png

Senhas - Reiniciar senha

image-1644500019541.png

Senhas - Reservar senha

image-1644500087614.png

Eventos do sistema

Verificar horário disponível 

Trabalha em conjunto com os eventos "Estrutura Condicional" e "Registrar Evento". Este é utilizado para que antes de realizar a inserção seja verificado se existe ou não horário disponível para data, hora e usuário informados, retornando em uma variável de processo a ser criada as seguintes respostas: 

A partir do evento Estrutura Condicional pode ser verificado se registrará o evento ou não com base no retorno da variável.

image-1644418192301.png

Registrar evento

O agrupador Eventos do Sistema serve para que seja verificada a disponibilidade e feito o registro de um evento no sistema.

Registrar Evento é utilizado para inserir um evento no sistema a partir de informações passadas pelo usuário em colaboração com o processo. Depois, esses eventos inseridos podem ser consultadas com telas de processo do tipo calendário. 

Eventos deste tipo são utilizados principalmente em processos comerciais, ou de reserva de sala/carro para que um evento seja registrado/reservado de acordo com os dados de ClienteLocalData/Hora, entre outros que são informados.

image-1644418448840.png

Aba Geral

Aba Outros

Quer ver um exemplo da utilização desses eventos de sistema? clique aqui

Excluir evento 

Evento criado para exclusão de agendamentos da tela de calendário

image-1741957337664.png

GED

GED - Iniciar revisão

Os eventos "Aprovar publicação", "Aprovar revisão" e "Aprovar exclusão" são utilizados em processos para criarem vínculos com os tipos de documentos. Quando um processo (seja ele de aprovação, revisão ou exclusão) for vinculado a um tipo de documento, o mesmo será iniciado sempre que os usuários adicionarem arquivos ao GED relacionados àquele tipo de documento.

Iniciar revisão é um evento utilizado para que seja iniciada a revisão/edição de um arquivo dentro do GED. Pode ser utilizado com o evento GED - Salvar Arquivo para fazer o upload de um novo arquivo após ter sido iniciada a revisão.

Este evento deve ser utilizado junto com o Aprovar revisão pois depois que iniciar ele e colaborar com a mesma ele deve ser aprovado, caso não seja informado ele ficara no limbo.

image-1644323989013.png

Após realizar este processo basta vincular ele ao Tipo de documento que deseja, que se encontra em Organização > Documentos > Tipo de Documentos
Versão homologada: 12.3.0

GED - Salvar Arquivo 

Evento utilizado para fazer o upload de um novo arquivo para um arquivo em edição no GED.

Evento utilizado juntamente com um formulário dissertativo e com variável do tipo Anexo - Arquivo, que irá salvar o mesmo no processo e em GED > Documentos > Anexos > Processos 

image-1644323853899.png

GED - Aprovar revisão 

Quando arquivos anexados ao GED precisam de uma aprovação para ser visualizado, existe no DOX Estúdio um evento a qual realiza essa função, para cria-lo basta seguir os passos-a-passos abaixo:

image-1644324052051.png

Evento utilizado para aprovar a revisão/edição de arquivos.

Após criar o processo, liberar sua versão para uso e criar um Tipo de Documento que será vinculado no GED ao arquivo que deseja importar, em Organização > Documentos > Tipos de documentos.

Pressionando Novo(F2), abrirá Documentos > Tipo de documentos e em Descrição informe o nome do Tipo de Documento e logo após anexe o processo de Aprovar Revisão que foi criado.

GED - Reprovar 

Reprova o arquivo que originou o processo. Utilizado apenas em casos onde o Tipo de Documento do arquivo tenha um processo de exclusão, revisão ou publicação vinculado.

Usado com evento condicionais para fazer as devidas validações e assim executar o evento, normalmente utilizado com um múltipla escolha que seria usado para cair na condições de reprovar;

image-1644324270206.png

Casos de uso: utilize este evento sempre que a validação de determinado documento não seja aprovada, seja ela uma revisão/edição(reprovar revisão), exclusão(reprovar exclusão), ou quaisquer outras aprovações.

GED - Aprovar publicação

Um dos principais eventos do GED que é muito utilizado é o GED - Aprovar publicação, ele é muito importante para que uma pessoa que tenha permissão para inserir um novo arquivo em uma pasta seja revisado e aprovado a publicação, como uma forma de controle. A seguir iremos mostrar passo-a-passo de como realizar esse processo.

Primeiramente vamos criar um processo simples de aprovação, com um campo dissertativa para o usuário preencher o motivo. Em seguida crie o evento GED - Aprovar publicação.

image-1644324555300.png

*** Arquivos cujo Tipo de documento não contenham um processo de Aprovar publicação vinculados serão publicados automaticamente no GED após o usuário ter feito upload.

Após ter criado o processo vamos criar o tipo de documento ou vincular a um existente. Neste exemplo vamos criar um novo, para isso vamos em Organização > Documentos > Tipo de documentos, assim que abrir a tela de tipo de documentos, atualize a página (F5), e se preferir pode anexar o processo de aprovação a um tipo existente ou criar um Novo(F2)

image-1644328136107.png

Assim que executados todos estes passos-a-passos no estúdio vamos ao portal e inserir um novo arquivo. Ao inserir o arquivo,  selecione o tipo de documento que contém o processo de aprovação pois se não for informado ele será aprovado automaticamente.

 

GED - Aprovar exclusão

O GED além de conter a funcionalidade de aprovar e revisar os arquivos antes de serem postado, tem também o evento aprovar exclusão após ter o arquivo já inserido. Para realizar este procedimento basta seguir os passos-a-passos que será mostrado.

Para utilizar o evento primeiramente iremos criar um processo simples contendo uma atividade do tipo dissertativa e iremos usar o evento GED > Aprovar Exclusão ( ao Sair);

image-1644407828785.png

Configurado o evento vamos vincular ele ao Tipo de Documento que se encontra em Organização >Documentos >Tipo de Documentos, após abrir a tela de Tipo de documentos vincule ou criei um Novo(F2).

image-1644408352480.png

Logo em seguida, no GED no portal, insira um novo arquivo com o tipo de documento criado ou editado contendo o BPM com o evento de Aprovar Exclusão

Assim que criado, exclua o mesmo clicando sobre ele e ir em excluir e confirme a exclusão.

Assim que confirmar a situação do arquivo, será mudada para Aguardando Exclusão. Logo após basta ir em Processos > Colaborar e colaborar com a instancia em aberto que o BPM enviará o arquivo para lixeira.

image-1644408834618.png

 

GED - Salvar protocolo

O evento GED - Salvar protocolo serve para pegar o protocolo anexado ao processo e salvar na instância. Com isso, além de ser salvo o protocolo no próprio processo ele também ira ser salvo na pasta padrão do Portal : Documentos > Anexos > Processo.

Para utilizar este evento basta ir na aba eventos da atividade que precisa utilizar, o evento se encontra em GED > Salvar Protocolo

image-1708520122616.png

Casos de uso: Utilize este evento quando determinado protocolo de processo precisa ser salvo e adicionado aos anexos de processo para que fique registrado na instância caso seja necessário realizar uma consulta posteriormente.

GED - Criar pasta

Para criar novas pastas o GED via BPM, pode ser utilizado o evento GED - Criar pasta, para isso basta criar o evento que se encontra na aba Eventos de uma atividade, GED > Criar Pasta:

image-1644409188249.png

GED - Exportar documentos

Evento usado para baixar arquivos do GED, salvar como um .ZIP / .RAR e  anexar ao processo quando necessário, para realizar este processo basta configurar o evento conforme a imagem abaixo:

image-1644409386135.png

Quando o processo for executado ele irá salvar um .zip /.rar ao anexos da instancia executada.

image-1644409639875.png

 

GED - Compartilhar 

Disponível na versão 12.12.+

Foi criado um evento de sistema "Compartilhar" no agrupamento GED, é utilizando quando deseja-se compartilhar um ou mais arquivos por meio de um processo BPM. Esse evento consiste nos seguintes campos:image-1644409781720.png

Para ver um exemplo da utilização deste evento do GED, clique aqui. 

GED - Importar arquivo

Evento do sistema disponibilizado no agrupador "GED". 
Este evento é responsável por importar um ou mais arquivos do seu computador, e importá-lo em uma pasta cadastrada no GED ou algum local padrão do sistema. Tudo isso por meio de um processo BPM.

Este evento consiste nos seguintes campos:

image-1644410382296.png

Entrada:

Saída:

Na tela de cadastro de eventos do processo, foi disponibilizado o modelo "Importar arquivos". Ao usar esse modelo, será sugerida uma sequência de eventos para aplicação de dois eventos do sistema (Carregar lista de arquivos e pastas e importar arquivo ), onde carrega uma lista de arquivos e a percorre, fazendo a importação dos mesmos.

image-1644410465999.png

Para ver um exemplo da utilização deste evento do GED, clique aqui. 

 

Web Service

Web Service - Requisição

Evento utilizado para quando é necessário trazer informações de determinados serviços na web.

image-1643919626725.png

image-1643920283189.png

Marcadores

Marcadores - Adicionar marcador

O agrupador "Marcadores" é utilizado para que sejam adicionados marcadores (tags) aos processos para que possam ser identificados mais facilmente na tela de colaboração. O evento "Adicionar marcador" é utilizado para adicionar determinado marcador a um processo.

image-1643896717600.png

Para um cadastro prévio dos marcadores pelo estúdio, acesse Processo> Marcadores

image-1643896791017.png

Ali você pode adicionar a descrição do marcador e a cor desejada. 

image-1643897267992.png

 

Marcadores - Remover marcador

Evento utilizado para remover determinado marcador de um processo.

image-1643897494739.png

Momento da execução

No sistema DOX, os eventos de sistema são executados em quatro momentos: 

image-1706012659266.png

Ao entrar 

Os eventos configurados 'Ao entrar na atividade' serão executados antes do usuário acessar a tela com formulários. É a primeira coisa executada (sem não houver PEX / JEX ao entrar na atividade) ao acessar a atividade. 

image-1706012794044.png

No portal o usuário só verá o resultado da execução do evento

image-1706012871157.png

No LOG: 

image-1706012913439.png

Ao sair 

Ao contrário do momento 'Ao entrar', os eventos 'Ao sair' são executados quando o usuário clica em 'Próximo' para sair da atividade atual e prosseguir com o processo. Também são execuções que o usuário não acessa. 

Em caso de atividades automáticas, assim como os eventos ao entrar, os eventos ao sair são executados rapidamente. 

image-1706013542100.png

Ao anexar 

Em desenvolvimento 

Ao comentar

Na versão 18.2.0.626 foi disponibilizado a opção 'Ao comentar'. Esse evento será iniciado quando o usuário incluir um comentário no processo em execução.

Primeiramente, deve-se estar parametrizado para permitir incluir comentário em Atividades > Aba 'Opções de colaboração'

image-1706016941811.png

E ao criar o evento, levar em consideração que existem alguns eventos que não executam 'Ao comentar':

image-1706017008831.png