# Workflow

## Criar um novo diagrama <a href="#passo-a-passo-para-criar-um-fluxo" id="passo-a-passo-para-criar-um-fluxo"></a>

Vamos descrever o passo a passo para criar um fluxo bem simples no módulo de workflow do SIGA, utilizando recursos básicos do módulo.

Para esse passo a passo, vamos utilizar o fluxo abaixo como exemplo:

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FD1KFTgep8oJfMiCAPOwI%2Fimage.png?alt=media\&token=4fc5a9eb-3a9e-488b-85c1-a0a4ce1a9692)

**1 – Entre no módulo de workflow (Menu / Módulos / Workflow):**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FynqgvQr3RAvLMWBOIdGA%2Fimage.png?alt=media\&token=1e352639-0689-4f22-bd64-ea565b047d4a)

**2 – Selecione a opção Cadastro de diagramas (Ferramentas / Cadastro de diagramas):**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FraPoZXq8f2dRSjdcLgaE%2Fimage.png?alt=media\&token=42a25f5f-2ce4-4523-a051-90d9080529d6)

**3 – Será a apresentada a lista de diagramas que já foram criados. Clique no botão “Novo Diagrama”**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2F9U0IglmqdYR0C0xJRTlY%2Fimage.png?alt=media\&token=29ab7a0e-be27-43b0-9a7b-1de256641818)

**4 – Preencha os dados básicos do diagrama, incluindo as respectivas permissões de acesso.**

<figure><img src="https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FAI5Fc3LcjKnQSDReOgPo%2FScreenshot%202022-09-01%20110947.png?alt=media&#x26;token=cec15551-26db-4506-bafe-08fbbab5a08b" alt=""><figcaption></figcaption></figure>

**Nome**: Denominação do diagrama; **Descrição**: Breve descrição do diagrama;

**Acesso para editar**: Define quem poderá realizar mudanças no diagrama. Já vem pré-defindo como todas as pessoas da lotação responsável pelo diagrama. Altere se necessário;

**Acesso para iniciar**: Define quem poderá iniciar a execução do fluxos baseados no diagrama. Já vem pré-definido como Público (qualquer pessoa). Altere se necessário;

**Lotação responsável**: Lotação da unidade responsável pelo diagrama;&#x20;

**Pessoa Responsável**: Lotação da pessoa responsável pelo diagrama;

**Tipo de Principal**: Indica se o procedimento estará orquestrando o trâmite de um documento, solicitação, conhecimento ou outro tipo de entidade dentro do Siga. Utilize a opção 'Nenhum' para gerar um procedimento apenas de workflow;

**Vínculo com o Principal**: Quando o workflow é relacionado a um principal, indica se o relacionamento é opcional ou obrigatório e também se o principal pode estar relacionado a outros fluxos, ou se é exclusivo deste procedimento. No caso do disparo de procedimentos filhos, o diagrama do filho não pode ter vínculo exclusivo;

**5- Para fins de criação do novo diagrama no sistema, podemos ignorar os eventos de decisão, conforme abaixo e considerar somente as tarefas e setas remanescentes.**

No sistema, cada caixa do fluxo é representada por uma "**tarefa"** e cada seta é representada por um "**desvio"**.

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2F3Nz72PN0VzA7JlApv8Lb%2Fimage.png?alt=media\&token=f210161d-c588-45fb-9b29-a6025dac0f9d)

Então, nesse exemplo, a criação do diagrama se resume a criar as tarefas do fluxo e seus respectivos desvios, conforme identificação abaixo:

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FIZvjkB51SqXftxD3XG11%2Fimage.png?alt=media\&token=8308d45c-e644-4c1e-b0a2-305089cf7520)

Tarefas: 1, 2, 3, 4, 5 e 6

Desvios: 1.1, 2.1, 2.2, 2.3, 3.1, 4.1, 5.1, 6.1

**6 - Vamos inicialmente criar as 6 tarefas do fluxo. Para isso, basta clicar 6 vezes no botão de adicionar tarefa (+Tarefa) e depois preencher os respectivos títulos de cada uma, conforme abaixo**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FJYuS3k7CmQVSlWNk5v4N%2Fimage.png?alt=media\&token=27e60530-de41-4aa4-aec6-3f86f0c8007a)

Repare que o diagrama do fluxo que está sendo criado é exibido no lado direito. O sistema já insere automaticamente os eventos de Inicio de Fim. Não sendo definido um desvio para cada tarefa, o sistema automaticamente considera que a tarefa seguinte é a próxima da lista, o que vamos ajustar posteriormente.

Se preferir, crie apenas uma tarefa de cada vez, seguindo a sequência do fluxo desejado, realizando a parametrização de cada uma, conforme passos seguintes, antes de criar a tarefa seguinte.

**7 - Para esse fluxo de exemplo, vamos trabalhar apenas com tarefas do tipo "Tarefa de usuário" (denominada como "Formulário" em versões anteriores do sistema), que representam uma tarefa a ser executada pelo usuário. Selecione então o tipo "Tarefa de usuário" em todas as tarefas, preenchendo também a respectiva unidade responsável pela execução tarefa, conforme abaixo**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FQcqudolp49dAv1nxttiH%2Fimage.png?alt=media\&token=c79837f7-1756-444c-9081-b91acf26d080)



**8 - Agora que todas as tarefas já foram criadas, vamos criar os respectivos desvios. Adicione 3 desvios na tarefa 2, utilizando o botão "+Desvio", informando os respectivos títulos e a tarefa de destino do desvio, conforme abaixo.**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2Fqra2uIeVdYsl6h7dVd93%2Fimage.png?alt=media\&token=855f97c0-99f6-4ee3-805f-48e879eecd90)

Com isso foram criados os desvios 2.1, 2.2 e 2.3 previstos no fluxo.

**9 - Para finalizar, vamos inserir os desvios 3.1, 4.1 e 5.1 nas respectivas tarefas, conforme abaixo:**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2F0NHigI1aahGvDfmxbfAC%2Fimage.png?alt=media\&token=a2291b45-7ca0-4acb-8510-d38dc254ad8a)

**10 - Pronto, o diagrama do nosso fluxo de exemplo está finalizado. Não foi necessário criar os desvios 1.1 e 6.1, pois a próxima tarefa desses desvios já é a tarefa seguinte constante da lista de tarefas**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FA1zpEq29oWrp3GZS9vSm%2Fimage.png?alt=media\&token=b96a2d20-d60e-4870-a668-ba5921e294fd)

Para esse exemplo, utilizamos apenas um tipo de tarefa (Tarefa de usuário) e um tipo de responsável pela tarefa (Lotação), mas o sistema oferece diversas opções, conforme detalhamento abaixo:

### Tipos de tarefas



Para esse exemplo, utilizamos apenas um tipo de tarefa (Formulário) e um tipo de responsável pela tarefa (Lotação), mas o sistema oferece diversas opções, conforme detalhamento abaixo:

Tipos de tarefas que podem ser utilizadas no diagrama:

<table><thead><tr><th>Tipo de tarefa</th><th width="226.33333333333331">Descrição</th><th>Forma de avançar</th></tr></thead><tbody><tr><td>Tarefa de usuário</td><td>Aguarda o usuário realizar uma tarefa</td><td>Após o usuário clicar no botão de Prosseguir ou nos botões definidos (Desvios definidos no formulário)</td></tr><tr><td>Desvio automático</td><td>Define a próxima tarefa a ser executada com base em regra pré-definida. </td><td>Automática, após aplicação da regra pelo sistema</td></tr><tr><td>Enviar E-mail automático</td><td>Envia um email para o destino previamente informado. </td><td>Automática, após envio do email pelo sistema</td></tr><tr><td>Script</td><td>Tarefa de uso exclusivo da área de TI, visando a execução de rotinas programadas</td><td>Automática, após execução da rotina pelo sistema</td></tr><tr><td>Iniciar Procedimento</td><td>Cria um procedimento filho e aguarda sua conclusão antes de prosseguir</td><td>Automática, após a finalização do procedimento filho</td></tr><tr><td>Criar Documento</td><td>Cria automaticamente um novo documento com base no modelo de texto padrão definido (Preenchimento automático)</td><td>Após o critério definido na parametrização da tarefa</td></tr><tr><td>Principal: Aguardar assinatura</td><td>Aguarda a assinatura do documento principal. Utilizada quando o fluxo é iniciado antes do documento vinculado ao mesmo estar assinado e o fluxo não deve avançãr antes da assinatura.. </td><td>Após o usuário assinar o doc principal</td></tr><tr><td>Principal: Aguardar Juntada</td><td>Aguardar a inclusão de um documento no documento principal (Juntada)</td><td>Após o usuário juntar o documento</td></tr><tr><td>Principal: Incluir cópia</td><td>Junto uma copia de um documento existente no SIGA no documento principal </td><td>Automática, após a juntada realizada pelo sistema</td></tr><tr><td>Principal: Autuar</td><td>Cria um processo e autua o documento corrente nele, depois troca o principal para ser o processo</td><td>Automática. Pode ser escolhido se aguardará a assinatura do processo ou se aguardará a juntada do documento filho</td></tr><tr><td>Principal: Tramitar</td><td>Realiza a tramitação automática do documento principal para o destino definido.</td><td>Automática, após o registro da tramitação pelo sistema</td></tr><tr><td>Principal: Arquivar</td><td>Realiza o arquivamento do documento principal</td><td>Automática, após o registro do arquivamento pelo sistema</td></tr><tr><td>Principal: Incluir Auxiliar</td><td>Aguarda a inclusão de um arquivo auxiliar</td><td>Automática, após a inclusão</td></tr></tbody></table>

### Tipos de responsável por tarefa

Para esse exemplo, utilizamos apenas um tipo de tarefa (Formulário) e um tipo de responsável pela tarefa (Lotação), mas o sistema oferece diversas opções, conforme detalhamento abaixo:

Tipos de tarefas que podem ser utilizadas no diagrama:

\


| Tipo de responsável                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Descrição                                                                                                                                                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Pessoa                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Quando a tarefa deve ser executada por uma pessoa pré-determinada (pessoa fixa)                                                                                                                                          |
| Lotação                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Quando a tarefa deve ser executada por qualquer pessoa de uma unidade pré-determinada (lotação fixa)                                                                                                                     |
| Tabelado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Quando um mesmo diagrama é utilizado por diferentes Órgãos e cada Órgão tem um executor específico para a tarefa (Criar previamente a relação de executores de cada Órgão pelo menu Ferramenta/Cadastro de responsáveis. |
| Procedimento: Titular                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Quando a tarefa deve ser executada pela pessoa que iniciou o procedimento                                                                                                                                                |
| Procedimento: Lotação do Titular                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Quando a tarefa deve ser executada por qualquer pessoa da mesma unidade da pessoa que iniciou o procedimento.                                                                                                            |
| <p>Principal: Cadastrante<br>Principal: Lotação do Cadastrante<br>Principal: Titular<br>Principal: Lotação do Titular<br>Principal: Subscritor<br>Principal: Lotação do Subscritor<br>Principal: Destinatário<br>Principal: Lotação do Destinatário<br>Principal: Gestor<br>Principal: Lotação do Gestor<br>Principal: Fiscal Técnico<br>Principal: Lotação do Fiscal Técnico<br>Principal: Fiscal Administrativo<br>Principal: Lotação do Fiscal Administrativo<br>Principal: Interessado<br>Principal: Lotação do Interessado<br>Principal: Interessado<br>Principal: Lotação do Autorizador<br>Principal: Interessado<br>Principal: Lotação do Revisor<br>Principal: Interessado<br>Principal: Lotação do Liquidante</p> | Define o responsável a partir das informações e perfis que constam do documento principal vinculado ao procedimento.                                                                                                     |

&#x20;

&#x20;

## Iniciar a execução de um Procedimento

**- Para iniciar a execução de um diagrama previamente criado, entre no menu "Procedimentos/Iniciar" do módulo de workflow e clique no fluxo desejado.**

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2Fnjaept848T7KnL9VDcra%2Fimage.png?alt=media\&token=7e7c1492-434b-424c-a296-d212cfd9d23d)

Para iniciar um fluxo vinculado a um documento, digite o número do documento desejado. Caso o fluxo precise ser iniciado a partir de uma tarefa diferente da primeira, selecione a tarefa desejada

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FWhWHjNrLtOLt51khCjJA%2Fimage.png?alt=media\&token=34e12395-2261-4e3b-9485-40b1130900af)

**Um diagrama também pode ser iniciado automaticamente a partir da criação de um documento** específico. Basta que o modelo do documento tenha sido criado prevendo essa possibilidade, acrescentando o trecho de código de exemplo abaixo:&#x20;

**Para iniciar o procedimento após a finalização do documento:**\
&#xNAN;_\[@finalizacao]_\
_\[#assign cria = func.criarWorkflow('ÓRGÃO-DP-2022/00010',doc,cadastrante,titular,lotaCadastrante,lotaTitular) /]_ \
_\[/@finalizacao]_

**Para iniciar o procedimento após a assinatura do documento:**\
&#xNAN;_\[@assinatura]_\
_\[#assign cria = func.criarWorkflow('ÓRGÃO-DP-2022/00010',doc,cadastrante,titular,lotaCadastrante,lotaTitular) /]_ \
_\[/@assinatura]_

Substituir, no trecho acima, o número do diagrama do exemplo (ÓRGÃO-DP-2022/00010), pelo número do digrama que deverá ser iniciado automaticamente após assinatura do documento.

Cada inicio de digrama gera um novo Procedimento, identificado no sistema pela sigla WF (Exemplo:  ORGÃO-WF-2022/00001)

### Executando uma tarefa

Quando uma tarefa é atribuída a uma unidade ou pessoa, ao chegar o momento de sua execução, ela é automaticamente exibida no quadro quantitativo, conforme exemplos abaixo.

Para começar a executar uma tarefa, basta clicar no número do documento vinculado ou no nome da tarefa.&#x20;

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FUuWdXVBYj5wFTtcvaZgb%2Fimage.png?alt=media\&token=c3c68324-daea-411f-9c58-fdcb3ed240ed)

Clicando no número do documento, o mesmo será aberto pelo sistema.

Quando a tramitação de um documento está sendo orquestrada pelo módulo de workflow, a tarefa corrente, a ser executada, é exibida acima do documento, conforme exemplo abaixo.

Nesse caso o usuário deve verificar o conteúdo do quadro da tarefa para verificar o que precisa ser feito.

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FZk462A7upEqxglRrJeVY%2Fimage.png?alt=media\&token=857907e5-d48e-4513-80f0-e364ec613d83)

As seguintes informações são exibidos no quadro de tarefas

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2F3zAUc0pdXbTYSDT33Kz2%2Fimage.png?alt=media\&token=5d336eb2-676a-4458-8c47-f54c36db532a)

<mark style="color:red;">1</mark> - Número do procedimento que está em execução. O procedimento é específico do documento que está tramitando. Outro documento em tramitação com base no mesmo diagrama de processo, terá outro número de procedimento vinculado.&#x20;

<mark style="color:red;">2</mark> - Nome do Diagrama que está sendo executado, definido no momento em que o Diagrama foi [criado](#passo-a-passo-para-criar-um-fluxo).

<mark style="color:red;">3</mark> - Nome da Tarefa do diagrama que está em execução.

<mark style="color:red;">4</mark> - Área destinada a informações sobre a execução da tarefa, onde o usuário pode verificar o que que precisa ser feito.

Clicando no nome da tarefa no quadro quantitativo, ao invés de abrir o documento vinculado, o sistema exibirá o procedimento em execução, conforme tela abaixo:

&#x20;

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2Fa8NHGTy4WGFAAaVpGEnu%2Fimage.png?alt=media\&token=8254ba26-1953-4f07-b62e-94a10207bcb1)

O quadro da tarefa em execução é exibido tanto na tela de consulta do procedimento (Item 2 da imagem acima), como na tela de consulta do respectivo documento vinculado.&#x20;

É possível alternar entre a tela de consulta do documento e a tela de consulta do procedimento a qualquer momento, clicando no número do documento ou no número do procedimento, conforme o caso.

A tela de consulta do Procedimento possui os seguintes elementos, conforme indicação numérica na imagem:

<mark style="color:red;">1</mark> - Botões com as operações permitidas para o procedimento.

<mark style="color:red;">2</mark> - Quadro com a tarefa em execução.

<mark style="color:red;">3</mark> - Diagrama do procedimento em execução, com a tarefa atual destacada em azul.

<mark style="color:red;">4</mark> - Conhecimento com o passo a passo para execução da tarefa, podendo ser atualizado pelo executor da tarefa.

<mark style="color:red;">5</mark> - Histórico do andamento do procedimento, exibindo as informações sobre a transição entre tarefas.

<mark style="color:red;">6</mark> - Valor das variáveis geradas ao longo da execução do procedimento. As variáveis podem ser exibidas em tarefas do tipo formulário, para preenchimento ou consulta pelo usuário. Também podem ser inseridas em modelos de texto padrão, a serem gerados automaticamente por tarefas do tipo Criar Doc.

Também estão disponíveis algumas informações gerais sobre o procedimento e o tempo em que a tarefa aguarda para ser executada.



Tarefas do tipo "Tarefa de usuário" só prosseguem após o usuário clicar em um dos botões disponíveis no quadro de tarefas, conforme exemplo abaixo (Botão Prosseguir):

![](https://3976217335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJHNx08dXFZaOnNSrUxgQ%2Fuploads%2FxuCpI7v354fb3akY95v2%2Fimage.png?alt=media\&token=61e12d01-313c-4d6a-900b-a99f60b3784e)

Em geral só devem ser realizadas tramitações manuais de documentos orquestrados pelo workflow em situações de exceção, para destinos diferentes do previsto no diagrama.

Se o próximo destino do documento já é o previsto no diagrama, a tramitação será feita de forma automática pelo sistema, após a conclusão, pelo usuário, da tarefa pendente.

