specifor-saas

Recebe um formulário raso (apenas o nome ou poucos campos) e devolve uma versão completada com campos típicos, dicas, larguras e ordem natural, já no formato importável do Specifor Workflow (arquivos_para_importar com o JSON do formulário). Os campos informados são preservados e complementados.

enriquecer_formulario

Devolve o catálogo de referência do formato que o importador do Specifor Workflow aceita: estrutura do formulário (IForm/FormField) e enums oficiais (controlType, FieldState, FieldAction), formato do processo (BPMN 2.0 com namespace wkf, atributos suportados e exemplo), eventos de automação e o mapa de termos em português usados pelas demais ferramentas. O parâmetro `area` filtra o retorno: tudo (padrão) | formulario | condicional | processo | automacao | mapas_ptbr.

consultar_schema

Gera um formulário do Specifor Workflow pronto para importar em "Administração → Formulários → Importar formulário": arquivo .json com os campos e as regras condicionais embutidas. Entrada em português: nome (até 60 caracteres), campos (rotulo, tipo — texto, texto_longo, numero, moeda, data, data_hora, selecao, multi_selecao, radio, checkbox, tabela com colunas, anexo, titulo, paragrafo… —, obrigatorio, opcoes, texto_ajuda, largura) e regras ("se campo X operador valor então ação em campos Y, senão …"), referenciando campos pelo rótulo e opções pelo nome. Quando campos vem vazio ou com menos de 3 itens, o servidor completa com campos típicos inferidos do nome e da descrição. Saída: arquivos_para_importar[0] com {nome_arquivo, conteudo} no formato exato do importador — o conteúdo é para ser salvo sem alterações —, além de resumo, regras aplicadas, observações, erros e o resultado da validação.

criar_formulario

Gera um processo completo do Specifor Workflow pronto para importar: o arquivo .bpmn do processo (etapas, decisões com caminhos rotulados, junções onde caminhos convergem e o desenho do diagrama) e um arquivo .json por formulário, com as regras condicionais já embutidas. Entrada em português: etapas (tipos inicio | tarefa | decisao | fim; decisões com 2 ou mais caminhos {rotulo, para}, que podem voltar a etapas anteriores; proximo opcional), formularios (campos e regras) e condicionais (atalho para regras simples). Saída: arquivos_para_importar[] com {nome_arquivo, tipo_mime, conteudo, destino, instrucao} no formato exato do importador — o conteúdo é para ser salvo sem alterações —, além de resumo, como_importar, avisos, erros e o resultado da validação. Responsável e formulário de cada tarefa são vinculados no editor do produto após a importação (o arquivo traz a sugestão). Automações não têm importação por arquivo; aparecem em configurar_na_ui.

criar_processo

Descreve uma automação de processo do Specifor Workflow no vocabulário de configuração do produto: nome, evento (criar_processo, entrar_etapa, sair_etapa, data_monitorada, data_monitorada_registro, iniciar_automacao, finalizar, email), direção (entrada, saida, webhook), etapa de origem, URL de destino e método HTTP quando for webhook. Automações não têm importação por arquivo; a saída serve como roteiro para configurá-la na tela (Automações → Nova), com observações e validação.

criar_automacao

Explica em linguagem simples conceitos do Specifor Workflow: Processo, Etapa, Formulário, Campo, Tabela, Condicional, Decisão, Automação, Webhook, Responsável, Tipo de campo, Instância, Subprocesso e BPMN. Sem o parâmetro termo, lista todos os conceitos disponíveis com uma definição curta.

explicar_conceito

Monta uma regra condicional no formato FormCondition do Specifor Workflow (uid, enabled, scenarios[], actions[], elseActions[]) a partir de um campo gatilho, um operador (igual, diferente, contem, nao_contem, inicia_com, termina_com, vazio, preenchido, menor_que, maior_que, antes, depois, entre outros), um valor, uma ação (exibir, ocultar, obrigar, desobrigar, habilitar, desabilitar, definir_valor, limpar, preencher, calcular, concatenar) e os campos-alvo. Regras não têm importação separada no produto: o objeto retornado é inserido em settings.conditions[] do formulário-alvo. criar_formulario e criar_processo fazem essa inserção automaticamente quando recebem regras ou condicionais.

criar_condicional

Dado o nome de um formulário (e, opcionalmente, o processo ou domínio em que ele se insere), devolve de 8 a 12 campos típicos já no vocabulário de entrada de criar_formulario e criar_processo: rotulo, tipo, alias, obrigatorio, opcoes, texto_ajuda, placeholder e largura. Domínio-agnóstico.

sugerir_campos

A partir de uma descrição livre de um processo (ex.: "aprovação de despesas com alçada da diretoria acima de 50 mil"), devolve uma proposta completa no mesmo vocabulário de entrada de criar_processo: etapas, formulários com 8 a 12 campos típicos cada, regras condicionais sugeridas e automações. Domínio-agnóstico. A proposta pode ser revisada e passada a criar_processo para gerar os arquivos.

sugerir_arquetipo

Valida o JSON de um formulário antes da importação no Specifor Workflow: chaves obrigatórias (name, elements, formType), controlType dentro do enum oficial, name e alias únicos e no padrão exigido (alias com letras maiúsculas e sublinhado), tabelas com colunas, campos de escolha com opções no formato {id, name, color} e regras em settings.conditions[] apontando para campos existentes e, nos campos de escolha, para o id da opção. Também aponta formatos legados (chaves em português, opções {label, value}). Devolve {valid, errors[], warnings[]}.

validar_formulario