Templates Globais
Nível de acesso requerido
Super Admin
O módulo de Templates Globais permite que o Super Admin configure elementos que serão compartilhados e reutilizados por todos os Tenants da plataforma.
Isso garante a padronização e escalabilidade do sistema. Ao alterar um template global, as atualizações são refletidas em processos correspondentes em todos os ambientes.
Elementos Globais
A plataforma atualmente suporta os seguintes elementos no nível global:
1. Definições de Processos Globais
Processos BPMN e Casos CMMN que não pertencem a um tenant específico. Estes modelos de processos servem como base e podem ser instanciados dentro do contexto de qualquer tenant.
TIP
Ao criar um novo template global, o upload do arquivo XML (.bpmn ou .cmmn) é opcional. Se nenhum arquivo for fornecido, a plataforma gera automaticamente um esquema padrão válido baseado no tipo selecionado.
2. Tipos Documentais Globais
Para formulários e processos que exigem upload de documentos, você pode criar Tipos Documentais globais (ex: "RG", "Comprovante de Residência", "Contrato de Prestação de Serviço"). Ao gerenciar tipos documentais nesta área:
- O sistema vincula o tipo ao processo global.
- O Tipo Documental fica disponível para os formulários que usam esse template.
3. Anexos Globais
Os modelos de documentos (arquivos físicos, templates de contratos e relatórios) atrelados a processos globais não ficam amarrados ao tenant tenantId. Em vez disso, o sistema utiliza uma flag is_global e armazena os arquivos fisicamente na pasta global/ no provedor de armazenamento (S3, disco local, etc). Isso garante isolamento e evita vazamento de dados de tenants para diretórios públicos.
4. Variáveis e Formulários Globais
As variáveis configuradas no contexto dos Templates Globais formam o vocabulário base de dados para formulários (ex: SmartDocs e FlowableForms) usados através da plataforma para um processo específico.
5. Documentação Global do Processo
Cada template global carrega sua própria documentação em Markdown — o texto que explica o processo para quem vai operá-lo. Ela é escrita aqui, na aba Documentação, com editor Escrever | Pré-visualizar.
Todo tenant inscrito no template lê esse mesmo texto na aba Documentação da definição, sem poder editá-lo, com uma faixa indicando que veio do template global. É o mesmo princípio dos demais elementos globais: o tenant herda, não bifurca. Alterar o texto aqui alcança todos os inscritos na hora, sem republicar o processo.
Inscrevendo um tenant no template
Um template global é um pacote: além do BPMN/CMMN, ele carrega tabelas de decisão (DMN), formulários, papéis e documentação. Inscrever um tenant instala o pacote inteiro no ambiente dele.
A instalação é tudo ou nada
Se qualquer tabela de decisão vinculada não puder ser implantada — XML inválido, chave duplicada, hit policy incorreta —, a inscrição é recusada e a mensagem de erro nomeia cada tabela que ficou de fora. Nenhuma assinatura é gravada: o tenant não aparece como inscrito na versão do template.
Isso é proposital. Antes, a inscrição respondia sucesso e mostrava o tenant inscrito na versão do template mesmo sem a tabela de decisão existir no motor — e a falha só aparecia semanas depois, quando a primeira instância chegava à tarefa de regra de negócio. Corrija o DMN no template e inscreva o tenant de novo.
Quando a inscrição é aceita, a lista de assinaturas mostra a versão implantada, e essa versão vale para o pacote completo.
Como Gerenciar
- Navegue até Global (Super Admin) → Templates Globais na barra lateral.
- Selecione o Processo desejado.
- Utilize as abas para gerenciar:
- Geral: Definições base do processo.
- BPMN/CMMN: Visualizador do diagrama do modelo (se aplicável).
- Tipos Documentais: Criar, editar, ativar ou suspender tipos de documentos necessários nesse processo.
- Variáveis: Definir os campos de dados e tipagens esperadas pelos formulários globais.
- Documentação: Escrever, em Markdown, o texto que todos os tenants inscritos vão ler sobre esse processo.
TIP
Somente o perfil Super Admin consegue gerenciar recursos globais — o grupo Global (Super Admin) da barra lateral não existe para os demais. Usuários com perfil Admin (tenant) gerenciam apenas seus processos locais, através do menu Modelagem → Catálogo de Processos.