# Processos

# Bloco de Correspondência

Para enviar uma lista dinâmica (basicamente uma tabela/grade de dados) por e-mail, é necessário utilizar o bloco de correspondência vinculado ao modelo de correspondência, que por sua vez estará vinculado ao processo.

Neste exemplo, criamos um processo simples com uma atividade que, quando o usuário confirmar e clicar em "próximo", as informações da grade preenchidas serão enviadas para o e-mail configurado.

Criação do processo

Crie os requisitos informados abaixo:

- 1 Atividade;
- 1 Formulário de grade de dados, com colunas:
    - Nome (Texto)
    - Sobrenome (Texto)
    - Idade (Inteiro)
- 1 Evento de "Definir valor variável" ao entrar na atividade;
- 1 Evento de "Comunicação - E-mail"

Ao sair da atividade. Este evento vai enviar as informações do processo para o e-mail configurado no campo "Destino".

Conforme imagem acima, é necessário vincular um modelo de e-mail no evento para que as informações sejam mostrados no e-mail de forma personalizada.

Criação do modelo / bloco de correspondência

Acesse:

- Módulo processo
- Blocos de correspondência
- Novo \[F2\]

Crie e vincule no campo "conector" um SQL que busca as informações da grade do processo. Não esqueça de utilizar a PKG de seu banco (neste exemplo é postgreSQL).

```sql
SELECT PKG_EMA.RETORNA_COLUNA_GRADE_TEXTO(X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 2, X.IDVALOR) AS NOME,
       PKG_EMA.RETORNA_COLUNA_GRADE_TEXTO(X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 2, X.IDVALOR) AS SOBRENOME,
       PKG_EMA.RETORNA_COLUNA_GRADE_INT (X.IDPROCESSO, X.IDATIVIDADE, X.IDFORMULARIO, 3, X.IDVALOR) AS IDADE
  FROM CRM_PROCESSO_GRADE_VALOR X
 WHERE IDPROCESSO = 0/*IDPROCESSO*/
```

# Ciclo de vida BPM

No DOX Estúdio:

- Processos &gt;
- Ciclo de Vida &gt;

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/dMhsQL4xsxPm8lme-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/dMhsQL4xsxPm8lme-image.png)

Este cadastro se refere ao ciclo de vida de um BPM, relacionado às 6 fases de gestão de processos de uma organização. De acordo com o Guia para Gerenciamento de Processos de Negócio ([CBOK](https://www.abpmp-br.org/educacao/bpm-cbok/)<span style="white-space: pre-wrap;">), as etapas de um ciclo de vida de um BPM são: </span>

1. Planejamento
2. Modelagem
3. Simulação
4. Execução
5. Monitoramento
6. Melhoria

<span style="white-space: pre-wrap;">De qualquer forma, ciclo de vida é um conceito, comumente entendível na criação de BPM. No sistema DOX, é um cadastro que solicita apenas uma descrição obrigatória e uma observação opcional. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/xu7WAObjwOOqY60E-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/xu7WAObjwOOqY60E-image.png)

- <span style="white-space: pre-wrap;">Na criação de um processo &gt; </span>
- <span style="white-space: pre-wrap;">Aba 'Processo' &gt; </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/OE75ZduuxudqvdHw-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/OE75ZduuxudqvdHw-image.png)

<span style="white-space: pre-wrap;">Não é um vinculo que tem muita importância na execução do processo em si, mas pensando em gestão, caso seja criado um relatório envolvendo ciclo de vida, é possível verificar quantos processos ainda estão na fase de 'Planejamento' por exemplo. </span>

<span style="white-space: pre-wrap;">Para mais informações sobre o conceito: </span>[https://www.lecom.com.br/blog/ciclo-de-vida-bpm/](https://www.lecom.com.br/blog/ciclo-de-vida-bpm/)

# Formulários de processo

<span style="white-space: pre-wrap;">Abaixo os tipos de formulários utilizados em processos BPM. Em anexo um procedimento BPM com todos os formulários citados nessa documentação. </span>

##### <span style="white-space: pre-wrap;">Objetiva - Combo / Radio / Botões </span>

<span style="white-space: pre-wrap;">O formulário do tipo 'Objetiva' tem três formas de utilização, combo, rádio e botões, que diferem na forma em que são apresentadas no portal para o usuário mas seu funcionamento no sistema é semelhante. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-05/scaled-1680-/eNQoNGAwR3qtPEpX-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-05/eNQoNGAwR3qtPEpX-image.png)

<span style="white-space: pre-wrap;">Na criação de formulários, selecione um dos tipos. Depois, acesse a aba 'Resposta' e coloque a informação que será exibida para o usuário, e a informação que será salva no processo. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-05/scaled-1680-/bd8s6CwZYMNyPKN5-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-05/bd8s6CwZYMNyPKN5-image.png)

##### <span style="white-space: pre-wrap;">Múltipla escolha </span>

<span style="white-space: pre-wrap;">Esse formulário permite ao usuário selecionar mais de uma informação. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-05/scaled-1680-/Q3BR1MC3gaIcrRjI-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-05/Q3BR1MC3gaIcrRjI-image.png)

<span style="white-space: pre-wrap;">Na criação de formulário, selecione o tipo 'Múltipla escolha', depois acesse a aba 'Resposta' e configure a lista de respostas que o usuário poderá selecionar. </span>

##### <span style="white-space: pre-wrap;">Dissertativa </span>

<span style="white-space: pre-wrap;">Tipo de formulário com mais possibilidades de uso, é possível manter como um campo dissertativo, onde o usuário informa alguma informação livremente, é possível criar uma consulta FK diretamente do banco de dados local (ou externo), uma consulta FK com mais de uma seleção, </span>

<span style="white-space: pre-wrap;">Informações de data, hora, valor, inteiro, texto longo, são muito usados em formulário tipo dissertativo. Nesses casos, a VARIAVEL informada é que deve ter o tipo de dado especifico. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/2KtfFxTJ824q6bN8-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/2KtfFxTJ824q6bN8-image.png)<span style="white-space: pre-wrap;"> </span>

No portal, os campos serão exibidos com as respectivas máscaras

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/UTDhWpQbNawFtOd1-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/UTDhWpQbNawFtOd1-image.png)

##### <span style="white-space: pre-wrap;">Grade de dados </span>

Formulários do tipo grade recebem variável do tipo 'Grade de dados' e permitem ao usuário criar colunas com varios tipos de dados.

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/cvCukZcSqnzQOmc8-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/cvCukZcSqnzQOmc8-image.png)

Colunas:

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/uMI5zIjt3jI4r8ZU-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/uMI5zIjt3jI4r8ZU-image.png)

No portal:

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/hcA7OVhZ6sGgR3q6-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/hcA7OVhZ6sGgR3q6-image.png)

<span style="white-space: pre-wrap;">O funcionamento desse formulário geralmente é acompanhado de eventos de sistema, pois a variavel do tipo 'Grade de dados' não guarda todas essas informações como em um array, então para extrair o valor da coluna geralmente é necessário </span>

- **Estrutura condicional - Inicio**: Origem Conjunto de dados
- **Estrutura de repetição - Retorna valor**<span style="white-space: pre-wrap;">: Aqui é onde você configura o valor da coluna para a variável de processo, se a coluna tem um texto, você cria uma variável para receber esse texto. </span>
- <span style="white-space: pre-wrap;">Após esses dois eventos, termine sua configuração de eventos de sistema e </span>**finalize a estrutura condicional**

##### Seleção de anexos

<span style="white-space: pre-wrap;">Esse tipo de formulário é utilizado com variável texto. Ele vai puxar e exibir como um check todos os anexos vinculado à instancia. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/hl16Sv9rwmPaEeBV-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/hl16Sv9rwmPaEeBV-image.png)

##### <span style="white-space: pre-wrap;">Assinatura manual </span>

Campo de assinatura manual com variável do tipo 'Assinatura'. Ao incluir em processo, traz novas possibilidades para etapas que necessitam de autorização. No portal, ele é exibido dessa forma:

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/pPNzffvcPqTOUyc2-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/pPNzffvcPqTOUyc2-image.png)

<span style="white-space: pre-wrap;">Ao clicar para colaborar no formulário: </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/U16OykrsjGannDIn-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/U16OykrsjGannDIn-image.png)

##### Mapa

<span style="white-space: pre-wrap;">Formulário do tipo 'Mapa' recebe variável do tipo 'Mapa' com a latitude e longitude do local desejado configurado no valor padrão. </span>

- Exemplo: \[{"latitude":-28.655770919457066, "longitude": -49.348811579751484}\]
- Caso o 'Modo' seja selecionado como 'Área' deve ser incluído o raio da área.

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/RR5Rlts3CDVLpokX-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/RR5Rlts3CDVLpokX-image.png)

No Portal:

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/spqauS6JA3D5QoLo-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/spqauS6JA3D5QoLo-image.png)

##### Link

Formulário do tipo 'Link' que deve ser vinculado o a uma variável do tipo 'Texto' onde no valor padrão é configurado a URL do link

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/qqRYcQBUkhnzZKgD-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/qqRYcQBUkhnzZKgD-image.png)

##### <span style="white-space: pre-wrap;">Botão </span>

Esse formulário não recebe variável. Geralmente é criado em conjunto com um evento ao sair (PEX/JEX) que faça alguma operação. Possui algumas configurações adicionais por se tratar de um formulário que possui certo destaque em colaborações com processos BPM.

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/WckQzC3LV9gQEikj-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/WckQzC3LV9gQEikj-image.png)

##### Bloco HTML

<span style="white-space: pre-wrap;">Formulário que também não recebe variável, em que o usuário pode informar um código HTML para exibir em processos. É possivel criar tabelas, linhas, destaques, etc... Mais exemplos, </span>[clique aqui.](https://kb.emasistemas.com.br/books/html/page/utilizando-bloco-html)

Na criação do formulário Bloco HTML &gt; Aba 'HTML'

##### <span style="white-space: pre-wrap;">Linha Horizontal </span>

Sem variável vinculada, geralmente utilizada para melhor organização visual de formulários no processo.

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/scaled-1680-/2D1IcP2BlzVkHzcp-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-07/2D1IcP2BlzVkHzcp-image.png)

# Processos com acesso público

##### <span style="white-space: pre-wrap;">O que são e para que servem? </span>

Processos com acesso públicos são processos em que não é necessário credenciais válidas para serem colaborados. Por exemplo, um processo de '**Trabalhe conosco**<span style="white-space: pre-wrap;">' onde o usuário não precisa cadastrar usuário e senha, apenas colocar suas informações e finalizar a execução do processo. </span>

<span style="white-space: pre-wrap;">Algumas empresas usam essa forma de acesso para desburocratizar o contato e coletar dados de fora para dentro. Outros exemplos comumente utilizados: </span>

- **Canal de Denúncias / Ouvidoria:**<span style="white-space: pre-wrap;"> Essencial que seja anônimo e público para garantir a segurança de quem está denunciando.</span>
- **Abertura de Chamados / Suporte:**<span style="white-space: pre-wrap;"> O cliente abre um ticket de suporte apenas informando o e-mail, sem precisar criar uma conta em um portal complexo.</span>
- **Solicitação de Cotação / Orçamento:**<span style="white-space: pre-wrap;"> Um lead preenche os dados do que precisa e o processo de vendas é disparado internamente.</span>

##### <span style="white-space: pre-wrap;">Como configurar um processo de acesso publico no DOX? </span>

Após criado o processo, edite e acesse a aba 'Permissões' para selecionar a opção 'Acesso Publico'

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/scaled-1680-/AtieqOUFFQR51ELl-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/AtieqOUFFQR51ELl-image.png)

<span style="white-space: pre-wrap;">Isso em si já deixa o </span>**processo** <span style="white-space: pre-wrap;">publico, mas lembra-se que um processo possui atividades. E essas atividades também pode ter diversos tipos de permissões. </span>

<span style="white-space: pre-wrap;">Na aba 'Atividades', edite uma atividade e acesse a aba 'Atribuição'. Estarão disponíveis as seguintes atribuições 'publicas': </span>

<p class="callout info">**Utilizar permissões configuradas no processo:**<span style="white-space: pre-wrap;"> Com essa opção selecionada, o sistema irá atribuir para a atividade atual a mesma permissão atribuída anteriormente na aba 'Permissões' do processo. Então, se o processo em si já está publico, a atividade irá seguir isso. </span></p>

<p class="callout info">Acesso publico: Autoexplicativo, a atividade não solicita credenciais válidas para ser executada</p>

##### <span style="white-space: pre-wrap;">Como esconder o botão de login? </span>

<span style="white-space: pre-wrap;">Caso seja necessário esconder/exibir o botão de login durante a execução de um processo, ou mesmo na tela geral de processos públicos (imagem abaixo) é necessário que um parâmetro geral seja avaliado. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/scaled-1680-/IQxQs9x21ay5NDol-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/IQxQs9x21ay5NDol-image.png)

<span style="white-space: pre-wrap;">Acesse Configurações &gt; Parâmetros gerais - DOX </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/scaled-1680-/UAFICPvfbuDP4iab-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/UAFICPvfbuDP4iab-image.png)

<span style="white-space: pre-wrap;">Aba 'Geral' &gt; 'Exibe botão fazer login' &gt; Caso marcado será exibido na central de processos públicos </span>**E** <span style="white-space: pre-wrap;">na execução de um processo publico. </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/scaled-1680-/wvGzA0I2rgMX1H4e-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/wvGzA0I2rgMX1H4e-image.png)

##### Mensagem ao finalizar processo publico

<span style="white-space: pre-wrap;">Para uma melhor experiência para usuários que executam processo publico, é possível personalizar uma mensagem para que seja exibida ao final da atividade. Na aba 'Atribuição' da atividade, ao setar para 'Acesso publico' por exemplo, será exibido alguns campos para personalização. </span>

- **Titulo de conclusão para colaboração publica**
- **Mensagem de conclusão para colaboração publica**
    - Caso HTML + CSS seja digitado, a tela virá com esse código renderizado (única coisa que ficara já definido é o botão e a centralização) e caso possua JavaScript, será ignorado;
- **Botão de conclusão para colaboração publica**

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/scaled-1680-/ntIMKeOb86qiFWzj-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/ntIMKeOb86qiFWzj-image.png)

<span style="white-space: pre-wrap;">No portal: </span>

[![image.png](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/scaled-1680-/G70bUTGVRVZCUKDN-image.png)](https://kb.emasistemas.com.br/uploads/images/gallery/2026-06/G70bUTGVRVZCUKDN-image.png)

Caso qualquer um desses campos permaneça em branco, será exibido uma tela e textos padrão na finalização da atividade.