Configuração Workflow
- Automação do reconhecimento dos documentos (tipificação).
- Conferência dos dados dos documentos contra as informações de entrada do fluxo (proposta).
- Automação das regras de negócio conforme roteiro.
- Consulta a serviços externos e internos, como consulta a processos (tribunais), Serasa, Cadastro de clientes, etc.
- Automação de consultas, reservas e averbações nos convênios.
- Controle on-line da execução das tarefas e status das propostas.
- Personalização do Workflow (roteiro operacional) de acordo com o seu processo.
- É possível a inclusão de API´s externas.
Em seguida, estará disponível a tela abaixo para o desenho do fluxo.
Tarefas do fluxo | Função |
Indica o início do processamento do fluxo. | |
Atividade de fim, podendo ser utilizada como fim normal ou reprovando o processo. | |
Atalho para entrar no fluxo, normalmente utilizado para retornar de alguma pendência. | |
Indica um sub-fluxo, onde processo entra na execução e ao final retorna no mesmo ponto do fluxo principal. | |
São todas as tarefas do fluxo, podendo utilizar de todas as API´s e métodos disponíveis. | |
Indica uma tarefa de decisão, sendo assim utilizadas nas tarefas de decisão automática ou manual. | |
Comentários que podem ser incluídos no fluxo. |
Para incluir uma tarefa, primeiramente devemos saber de que tipo será a tarefa conforme o quadro anterior. Após definir, basta arrastar com o mouse a tarefa para o fluxo. O primeiro a ser incluído obrigatoriamente é: .
Depois podemos incluir uma tarefa, conforme abaixo:
Agora precisamos definir as configurações da tarefa. Ao clicar com o botão direito do mouse sobre a tarefa, serão apresentadas duas opções (editar ou excluir), clicando em editar abrirá a tela de configurações.
Na tela de configuração, alguns campos são padrões, outros irão variar com o tipo de ação a ser executada pela tarefa.
Campos padrões:
- Ordem (é um número único que identifica a tarefa)
- Nome (Define o nome da tarefa).
- Descrição (Campo de texto livre utilizado para descrever a tarefa)
- Assíncrona (quando a tarefa pode ser executada sem ficar aguardando outra, se não for selecionado será síncrona e desta forma existindo uma sincronia com outras tarefas).
- Obrigatória (Define a obrigatoriedade da tarefa)
- Pode ter status forçado (se selecionado o usuário poderá forçar um status para tarefa manualmente).
- Na ação da tarefa (API) será selecionada a API a ser executada pela tarefa, existindo algumas que já fazem parte do S-Works ou de integração com outros serviços fornecidos pela Simply. Também podem executar API´s de outros fornecedores, do próprio cliente e etc., desde que já previamente cadastrada no sistema em “Administração API´s”.
Definição de API : Application Programming Interface (em português: Interface de Programação de Aplicações ou Interface de Programação de Aplicativos)
Cada API terá seus próprios métodos, ao selecioná-la serão abertos novos campos necessários para o método selecionado. No exemplo da figura 2, selecionamos a API principal do S-Works (SWorks.Core.ServerAPI.dll) e o método (TipificaçãoExtração), que vai tipificar / identificar os documentos e extrair os dados conforme definido previamente no FormSet.
Após configurar está tarefa o fluxo ficará assim:
Precisamos agora ligar a tarefa início com a tarefa 10, bastando arrastar a bolinha da direita da tarefa início até a esquerda da tarefa de tipificar documentos.
Vamos incluir agora uma tarefa de decisão, onde será verificado se a tarefa 10 foi executada com sucesso. Para esta tarefa, será selecionado também a API principal (Core) do S-Works e o método “DecisaoAutomatica”. Para este método, vamos ter três campos. O primeiro é a expressão utilizada para validar (no caso estamos colocando obj[10].status == APROVADO). O OBJ identifica que é um objeto do fluxo e entre colchetes o número 10 indica que o objeto é a tarefa de ordem igual a 10. Já o “.status”, é uma propriedade deste objeto, que estamos verificando se a tarefa 10 foi aprovada. Se esta expressão for verdadeira, o fluxo vai seguir para tarefa definida em “Ordem da tarefa (aprovada)”, se não, o fluxo segue para tarefa “Ordem da tarefa (reprovada)”.
Ficando a configuração da tarefa 40 assim:
A configuração da tarefa 45 ficará assim:
Abaixo, está demonstrado o novo fluxo, após a definição das tarefas e ligação das atividades:
Passo |
03 |
Vamos incluir agora, um sub-fluxo para consulta e reserva de margem para empréstimo consignado. Para isso, vamos clicar na seta que está ligando a tarefa “30 – VerificaTipificacao” com a tarefa “40 – Fim” e após selecionada, aperte a tecla “Delete”. Incluiremos uma tarefa de sub-fluxo entre a tarefa 30 e 40. Após arrastar o ícone de sub-fluxo para nosso fluxo, clique com o botão direito do mouse e selecione editar. Para esta tarefa, serão definidos apenas a ordem, o nome e descrição.
Como já existe uma tarefa com o número de ordem 40, o sistema não vai deixar salvar, conforme tela abaixo. Então, antes de configurar estes campos da atividade de sub-fluxo, vamos alterar a atividade FIM de 40 para 50. Depois será possível configurar a atividade.
Veja como ficou o fluxo principal, após a inclusão da tarefa de sub-fluxo.
Passo |
04 |
Para iniciar o desenho do sub-fluxo, clique duas vezes com o botão esquerdo do mouse em cima do ícone do sub-fluxo. O sistema vai abrir uma nova tela, onde será possível definir o sub-fluxo, conforme tela abaixo.
Arraste para o sub-fluxo os ícones de tarefas conforme abaixo.
Na primeira tarefa após o início, vamos configurar a consulta de margem, onde será feita uma consulta no sistema Mining para verificar se existe margem disponível para empréstimo. A tarefa ficará configurada conforme tela abaixo. Os campos obj.XXXXXXX indica que estamos referenciando um dado de entrada do fluxo, neste exemplo o “obj.Orgao” é a referência do dado de entrada nomeado de Órgão.
A tarefa de decisão será configurada para verificar se atividade anterior conseguiu encontrar margem, conforme tela abaixo. A expressão “obj.Dados[42].Margem != 0.0M”, verifica se no retorno da ação de ordem 42 encontrou margem diferente de zero. Sempre que se utiliza obj.Dados[], estamos referenciando um parâmetro interno de retorno do método utilizado na tarefa de ordem indicada entre colchetes. O parâmetro interno utilizado foi Margem. Então, caso a expressão seja verdadeira, o fluxo segue para tarefa 44, se não para tarefa 45.
Obs.: As expressões são “Case sensitive”, devendo ser respeitado o maiúsculo e minúsculo nos nomes dos campos. Para confirmar se for dado de entrada é no fluxo em dados de entrada, se for de Api´s poderá verificar em gerenciar API´s.
A tarefa FIM de ordem 45 será configurada para reprovar o sub-fluxo, por não ter encontrado margem. Segue abaixo a tela de parametrização de como deve ficar esta atividade.
A tarefa de ordem 44 será configurada para efetuar a reserva de margem. Segue abaixo os dados da tarefa, ações da tarefa e parâmetros da tarefa.
A tarefa de decisão será configurada para verificar se atividade anterior conseguiu reservar margem, conforme tela abaixo. Se a expressão “obj[42].Status” for verdadeira, será executada a tarefa 47, se não 45.
Por último, configuramos a tarifa fim com sucesso do sub-fluxo e fazemos as ligações das tarefas com as setas.
Segue o desenho final do fluxo, após fazer todas as configurações e ligações entre as tarefas.
Passo |
05 |
Para definir os dados de entrada do fluxo, clique em “Inserir Dados de Entrada”. Nesta tela, será possível clicar em “+ Novo dado de entrada” para inserir os campos. No grid abaixo será demonstrado os campos já cadastrados.
Na tela de cadastramento de dados de entrada, deverão ser informados os seguintes parâmetros:
- Ordem (Ordem que os dados vão ser disponibilizados)
- Nome do campo (Nome utilizado para referenciar os dados dentro do fluxo)
- Nome de exibição (Nome que será mostrado na tela)
- Tipo (Definição do tipo de dados:
- Numero (Campo numérico com ou sem casas decimais)
- Alfanumérico (Permite textos e números)
- Boolean (Verdadeiro ou falso)
- Datetime (Data e hora)
- Monetário (Mesmo que o número, mas utilizado para valores monetários)
- Imagem (Recebe uma imagem, não se aplica muito a dados de entrada)
- Combobox (Lista de opções)
- Tabela (Utilizada para o tipo combobox, define a lista de opções)
- Mascara (Mascara utiliza para mostrar o dado)
- Obrigatório (Define a obrigatoriedade do dado)
- Invisível (Quando selecionado não será mostrado na tela, será recebido na integração)
Segue abaixo tela de exemplo.
Passo |
06 |
A funcionalidade de configurar ColumnSet é para definir as colunas que vão aparecer na tela de monitorar processos. Para incluir as colunas, basta clicar em “Inserir Coluna”, onde será solicitado informar o número de ordem que a coluna vai aparecer e qual coluna dos parâmetros de entrada.
Passo |
06 |
O FormSet deve ser preparado pela equipe do Grupo Simply, a partir do formulário enviado pelo Cliente. O arquivo do FormSet será sempre gerado com extensão .zip que contenha um arquivo .frs. Basta selecionar o arquivo e clicar carregar o formulário.
Após carregar o FormSet, os formulários serão listados conforme exemplo abaixo.
Clicando em editar, será possível alterar o nome do formulário, indicar as palavras-chave e visualizar o template. Na visualização do formulário, você tem a opção de zoom ou girar a imagem utilizando os botões na parte de baixo da tela.
Passo |
07 |
As API´s são a forma de integração do S-Works com outros sistemas, seja do Grupo Simply, terceiros ou do próprio cliente. Elas são criadas pelo Grupo Simply e importadas no S-Works através da opção Administração – API´s. Existem duas Api´s do S-Works (SWorks.Core.ServerAPI.dll e SWorks.Utils.API.dll). Para adicionar uma nova API, basta clicar em “Atualizar API” e selecionar a DLL. Existe também a opção de atualizar ou excluir.
Visualizar os métodos e dados disponíveis em cada API. Clicando em “+” na frente da linha, o sistema vai mostrar os métodos disponíveis e em detalhar será possível visualizar os campos.
Os métodos não funcionalidades que realizam procedimentos internos (Funções do S-Works) ou externos (Funções de outros sistemas) por exemplo REC, Mining, etc.
Os parâmetros de configuração são as informações da chamada do método, e os parâmetros internos são os campos que ficam disponíveis após a execução do método, podendo ser utilizados nas expressões nas atividades do fluxo.
Passo |
08 |
API: SWorks.Core.Server.API.dll
● Método: CamposExtraidos:
Parâmetros de Configuração
Nome de exibição | Descrição |
Nome do documento | É o nome do documento |
Campos a verificar | Nome do campo que será verificado |
● Método: FinalizarAtividade - Finaliza um sub-fluxo.
Parâmetros de Configuração
Nome de exibição | Descrição |
Reprovar | Parâmetro que quando marcado determina que a atividade foi finalizada com reprovação. |
● Método: FinalizarProcesso - Finaliza o processo inteiro.
Parâmetros de Configuração
Nome de exibição | Descrição |
Reprovar | Parâmetro que quando marcado determina que o processo foi finalizado com reprovação. |
● Método: SuspenderProcesso - Suspende a execução do processo.
Parâmetros de Configuração
Nome de exibição | Descrição |
Ordem da tarefa (positivo) | Qual tarefa o fluxo irá prosseguir caso a suspensão tenha retorno positivo. |
Ordem da tarefa (negativo) | Qual tarefa o fluxo irá prosseguir caso a suspensão tenha retorno negativo. |
● Método: Condicao - Função que realiza questionamento(s) em relação ao processo. Utilizado em uma tarefa.
Parâmetros de Configuração
Nome de exibição | Descrição |
Expressão: | É o local onde deverá ser adicionado o(s) questionamento, descrito em forma de expressão. |
● Método: DecisaoManual - É uma tarefa que depende de intervenção humana.
Parâmetros de Configuração
Nome de exibição | Descrição |
Usuário responsável | Definir para qual usuário a atividade manual será direcionada |
Grupo responsável | Definir para qual grupo a atividade manual será direcionada |
Permite suspensão? | Configurar se a decisão manual permite ou não a suspensão do processo |
Multi-aprovações? | Configurar se a decisão manual permite ou não a múltiplas alterações do processo |
Taxa de aprovação (0 - 100) | É o percentual para a aprovação da tarefa manual. Por exemplo 50%, 100%. De acordo com o percentual será verificado quantas aprovações serão necessárias. |
Ordem da tarefa (est. positivo) | Definir o número da tarefa após o retorno da suspensão caso exista um estímulo positivo. |
Ordem da tarefa (est. negativo) | Definir o número da tarefa após o retorno da suspensão caso exista um estímulo negativo. |
Ordem da tarefa (aprovada) | Definir o número da tarefa quando a decisão manual seja aprovada. |
Ordem da tarefa (reprovada) | Definir o número da tarefa quando a decisão manual seja reprovada. |
● Método: DecisaoAutomatica - É uma tarefa que possui a capacidade de tomar decisão de forma automática.
Parâmetros de Configuração
Nome de exibição | Descrição |
Expressão | Campo onde é descrito a condição necessária para a tomada de decisão automática. |
Ordem da tarefa (aprovada) | Definir o número da tarefa quando a decisão manual seja aprovada. |
Ordem da tarefa (reprovada) | Definir o número da tarefa quando a decisão manual seja reprovada. |
● Método: ImagemPreenchida - Verifica o preenchimento de algum campo de um documento.
Parâmetros de Configuração
Nome de exibição | Descrição |
Nome do documento | Definir o nome do documento |
Campo do documento | Definir o campo do documento a ser analisado |
Aceitação (0 a 100) | Definir o percentual de aceitação. |
● Método: ComparaImagem - Realiza a comparação entre dois documentos
Parâmetros de Configuração
Nome de exibição | Descrição |
Nome do documento 1 | Definir o nome do documento 1. |
Campo do documento 1 | Definir o campo do documento 1 a ser analisado. |
Nome do documento 2 | Definir o nome do documento 2. |
Campo do documento 2 | Definir o campo do documento 2 a ser analisado. |
Aceitação (0 a 100) | Definir o percentual de aceitação. |
● Método: ComparaCampo - Realiza a comparação entre dois documentos
Parâmetros de Configuração
Nome de exibição | Descrição |
Parâmetro de entrada | É o valor do parâmetro a ser comparado com o texto de um determinado documento. Pode ser uma constante, ou um dado de entrada. |
Nome do documento | Definir o nome do documento a ser validado. |
Campo do documento | Definir o nome do campo a ser validado. |
Aceitação (0 a 100) | Definir o percentual de aceitação. |
Caracteres válidos | Definir quais são os caracteres validos na comparação. |
Remover acentos? | Realiza a remoção de acentos para a realização da comparação. |
Tipo de comparação | - Contains: Verifica se o parâmetro de entrada está contido no texto que do documento que se deseja comparar. - Regex: Utiliza uma expressão regular para comparação no parâmetro de entrada. Exemplo: Deseja-se comparar a expressão “Aposetando(a)”. Expressão regular: Aposentad[a|o]. - Levenshtein: Verifica similaridade entre as palavras. |
Reprovação imediata? | Indicador que se marcado reprova a tarefa imediatamente, caso não encontre o texto no documento/campo. |
● Método: ObrigaDocumento - Verificar se um documento de determinado tipo foi anexado ao processo.
Parâmetros de Configuração
Nome de exibição | Descrição |
Nome do documento | Nome do documento a ser anexado ao processo |
● Método: TipificacaoExtracao - Tipifica e extrai dados dos documentos anexados.
Parâmetros de Configuração
Nome de exibição | Descrição |
Aceitação (0 a 100) | Definir o percentual de aceitação. |
OCR Simplificado (sem templates) | Tipificação com utilização de um template padrão. |
OCR Extendido (usando templates) | Tipificação sem utilização de um template padrão. |
SWorks.Rec.API.dll
● Método: ConsultarTribunal: Realiza consultas nos tribunais de justiça à procura de possíveis ações.
Parâmetros de Configuração
Nome de exibição | Descrição |
Nome | Nome da pessoa a ser consultada, parametrizar um campo de entrada. |
CPF | CPF da pessoa a ser consultada, parametrizar um campo de entrada. |
UF | Estado da comarca a ser consultada, parametrizar um campo de entrada. |
Município | Município da comarca a ser consultada, parametrizar um campo de entrada. |
Alertas | Alertas a serem retornados. BANCO AUTOR = 1, BANCO REU = 2, BANCOS DIFERENTES = 3, UF DIFERENTE DO CPF = 4, COMARCA DE RISCO = 5 |
Filtrar Situação | São filtros para a consulta de tribunais. |
Conta | Usuário de acesso ao REC, parametrizado em contas da empresa. |
Parâmetros de Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código da fila | Código da fila da consulta realizada no Tribunal consultado. |
SWorks.Mining.API.dll
● Método: ConsultarInfoBusca: Realiza de consulta pessoas com o intuito de retornar seus possíveis endereços.
Parâmetros de Configuração
Nome de exibição | Descrição |
CPF | CPF da pessoa a ser consultada, parametrizar um campo de entrada. |
Conta | Usuário de acesso ao Mining |
Parâmetros de Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código da fila | Código da fila da consulta realizada no Infobusca. |
Mensagem do Site | Mensagem de retorno do site Infobusca. |
Endereço 1 | Primeiro endereço retornado. |
Endereço 2 | Segundo endereço retornado. |
Endereço 3 | Terceiro endereço retornado. |
● Método: ConsultarMargemEmprestimoGovMG: Realiza de consulta pessoas com o intuito de retornar seus possíveis endereços.
Parâmetros de Configuração
Nome de exibição | Descrição |
Órgão | Órgão da pessoa a ser consultada. |
Matrícula | Matrícula da pessoa a ser consultada. |
CPF | CPF da pessoa a ser consultada. |
Ipsemg | Número do Ipsemg da pessoa a ser consultada. |
Processo Ipsemg | Processo Ipsemg da pessoa a ser consultada. |
Conta | Usuário de acesso ao Mining. |
Parâmetros de Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código da fila | Código da fila da consulta realizada. |
Mensagem do Site | Mensagem de retorno do site do governo de Minas Gerais. |
Margem disponível | Margem disponível para do servidor do governo de Minas Gerais. |
● Método: ConsultarReceita: Realiza de consulta de pessoas no site da Receita Federal.
Parâmetros de Configuração
Nome de exibição | Descrição |
CPF | CPF da pessoa consultada, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao Mining. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código da fila | Código da fila da consulta realizada. |
Mensagem do Site | Mensagem de retorno do site da Receita Federal. |
Situação cadastral | Situação do CPF consultado no site da Receita Federal. |
Nome | Nome da pessoa consultada no site da Receita Federal. |
● Método: ConsultarSerasa: Realiza de consulta de pendências financeiras no site do Serasa.
Parâmetros de Configuração
Nome de exibição | Descrição |
CPF | CPF da pessoa consultada, parametrizar um campo de entrada. |
Registrar Consulta? | Registro de consulta de CPF’s no site do Serasa. |
Conta | Conta (Usuário) de acesso ao Mining. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código da fila | Código da fila da consulta realizada. |
Mensagem do Site | Mensagem de retorno do site da Receita Federal. |
Status do Documento | Situação do CPF consultado. |
Alerta de Óbito | Alerta de existência de óbito no CPF consultado. |
Existe Registro de Inconsistência? | Existência de alguma inconsistência no CPF consultado. |
● Método: ConsultarSiape: Realiza de consulta de informações pessoais, funcionais e financeiras no site do SIAPE - Sistema Integrado de Administração de Recursos Humanos.
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Margem fixa | Valor da margem fixa do servidor público |
Margem variável | Valor da margem variável do servidor público |
Margem consignável | Valor da margem consignável do servidor público |
Margem em uso | Valor da margem em uso do servidor público |
Margem reservada | Valor da margem reservada do servidor público |
Margem disponível | Valor da margem disponível do servidor público |
Nome | Nome do perfil do funcionário |
Cpf | CPF do perfil do funcionário |
Matrícula | Matrícula do perfil do funcionário |
Email | Email do perfil do funcionário |
Empresa | Empresa do perfil do funcionário |
Orgao | Órgão do perfil do funcionário |
Situação | Situação do perfil do funcionário |
Classificação | Classificação do perfil do funcionário |
Data de nascimento | Data de nascimento do perfil do funcionário |
Identificação Única | Identificação do perfil do funcionário |
UF | UF do perfil do funcionário |
Upag | Unidade Pagadora do servidor público |
Logradouro | Logradouro do servidor público |
Bairro | Bairro do servidor público |
UF | UF do endereço residencial do funcionário |
CEP | CEP do endereço residencial do funcionário |
Complemento | Complemento do endereço residencial do funcionário |
Município | Município do endereço residencial do funcionário |
Número | Número do endereço do endereço residencial do funcionário |
Logradouro | Logradouro do endereço residencial do funcionário |
Bairro | Bairro do endereço residencial do funcionário |
UF | UF do endereço comercial do funcionário |
CEP | CEP do endereço comercial do funcionário |
Complemento | Complemento do endereço comercial do funcionário |
Município | Município do endereço comercial do funcionário |
Número | Número do endereço comercial do funcionário |
Data da admissão | Data da admissão do servidor público |
Matrícula Siape | Matrícula Siape do servidor público |
Natureza da pensão | Natureza da pensão do servidor público |
Pensão temporária | Pensão temporária do servidor público |
Data do afastamento | Data do afastamento do servidor público |
Motivo do afastamento | Motivo do afastamento do servidor público |
Situação funcional | Situação funcional do servidor público |
Data do desligamento | Data do desligamento do servidor público |
Matrícula Instituidor | Matrícula Instituidor do servidor público |
Nome Instituidor | Nome Instituidor do servidor público |
Regime jurídico | Regime jurídico do servidor público |
Retorno do afastamento | Retorno do afastamento do servidor público |
Agência | Agência do servidor público |
Conta | Conta do servidor público |
Banco | Banco do servidor público |
● Método: ReservarMargemEmprestimoGovMG: Realiza a reserva de margem de empréstimo para o convênio do Governo de Minas Gerais.
Parâmetros de Configuração
Nome de exibição | Descrição |
Órgão | Órgão do servidor público, parametrizar um campo de entrada |
Matrícula | Matrícula do servidor público, parametrizar um campo de entrada |
CPF | CPF do servidor público, parametrizar um campo de entrada |
Ipsemg | Ipsemg do servidor público, parametrizar um campo de entrada |
Processo Ipsemg | Processo Ipsemg do servidor público, parametrizar um campo de entrada |
Entidade | Entidade do servidor público, parametrizar um campo de entrada |
Contrato | Contrato do servidor público, parametrizar um campo de entrada |
Valor Financiado | Valor Financiado da reserva de empréstimo, parametrizar um campo de entrada |
Valor Solicitado | Valor Solicitado da reserva de empréstimo, parametrizar um campo de entrada |
Taxa de Juros | Taxa de Juros da reserva de empréstimo, parametrizar um campo de entrada |
Valor da Parcela | Valor da Parcela da reserva de empréstimo, parametrizar um campo de entrada |
Quantidade de Parcelas | Quantidade de Parcelas da reserva de empréstimo, parametrizar um campo de entrada |
Banco | Banco do servidor público, parametrizar um campo de entrada |
Agência | Agência do servidor público, parametrizar um campo de entrada |
Conta Corrente | Conta Corrente do servidor público, parametrizar um campo de entrada |
Forma de Contratação | Forma de Contratação do servidor público, parametrizar um campo de entrada |
Conta | Conta (Usuário) de acesso ao Mining. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Código da fila | Código da fila da consulta realizada. |
Mensagem do Site | Mensagem de retorno do site da Receita Federal. |
Tentativa | Número de tentativas de consultas realizadas. |
SWorks.Utils.API.dll
● Método: SimilaridadeTextual: Realiza uma comparação de semelhança entre textos.
Parâmetros de Configuração
Nome de exibição | Descrição |
Texto 1 | Primeiro texto |
Texto 2 | Segundo texto |
Aceitação (0 - 100) | Percentual de aceitação da comparação |
SWorks.SCC.API.dll
● Método: CadastroDeTaxaDeEmprestimos: Destinado ao Consignatário financeiro enviar para o SCC o arquivo com as taxas para o ranking das taxas.
Parâmetros de Configuração
Nome de exibição | Descrição |
CNPJ Base de Órgão pagador do servidor | CNPJ Base de Órgão pagador do servidor, parametrizar um campo de entrada. |
Data Inicial válida para os prazos e taxa | Data Inicial válida para os prazos e taxa, parametrizar um campo de entrada. |
Data Final válida para os prazos e taxas | Data Final válida para os prazos e taxas, parametrizar um campo de entrada. |
Prazo em mês da taxa | Prazo em mês da taxa, parametrizar um campo de entrada. |
Percentual da taxa nominal | Percentual da taxa nominal, parametrizar um campo de entrada. |
Percentual da taxa efetivo | Percentual da taxa efetivo, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
● Método: ConsultaDeMargemRefin: Destinado ao participante Consignatário financeiro consultar a margem disponível para um refinanciamento de averbação.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do CPF do Servidor | Número do CPF do Servidor, parametrizar um campo de entrada. |
Identificação do Serv. (Matrícula ou registro no Ente) | Identificação do Serv. (Matrícula ou registro no Ente) , parametrizar um campo de entrada. |
Identificação do Órgão | Identificação do Órgão, parametrizar um campo de entrada. |
CNPJ do Órgão pagador do Servidor | CNPJ do Órgão pagador do Servidor, parametrizar um campo de entrada. |
Identificação da Espécie | Identificação da Espécie, parametrizar um campo de entrada. |
Número do Contrato gerado pelo SCC | Número do Contrato gerado pelo SCC, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
● Método: CancelamentoDaReservaDeAverbacao: Destinado ao participante Consignatário financeiro enviar o cancelamento da reserva de consignação solicitada para o SCC.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do Contrato gerado pelo SCC | Número do Contrato gerado pelo SCC, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
● Método: FinalizacaoDeReservaDeAverbacaoRefin: Finalização da reserva de averbação do refinanciamento.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do CPF do Servidor | Número do CPF do Servidor, parametrizar um campo de entrada. |
Número do Contrato gerado pelo SCC | Número do Contrato gerado pelo SCC, parametrizar um campo de entrada. |
Número do Contrato da IF | Número do Contrato da IF, parametrizar um campo de entrada. |
Taxa Nominal do Contrato | Taxa Nominal do Contrato, parametrizar um campo de entrada. |
Taxa CET do Contrato | Taxa CET do Contrato, parametrizar um campo de entrada. |
Valor Liberado para Consignação | Valor Liberado para Consignação, parametrizar um campo de entrada. |
Tarifas do Contrato | Tarifas do Contrato, parametrizar um campo de entrada. |
Tributo do Contrato | Tributo do Contrato, parametrizar um campo de entrada. |
Outros encargos do Contrato | Outros encargos do Contrato, parametrizar um campo de entrada. |
Valor Total do Contrato (com todas as taxas inclusas) | Valor Total do Contrato (com todas as taxas inclusas) , parametrizar um campo de entrada. |
Valor da parcela final da averbação | Valor da parcela final da averbação, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
● Método: DesaverbacaoConsignatarioFinanceiro: Destinado ao participante Consignatário financeiro enviar a relação dos contratos de consignações que serão desaverbadas no SCC.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do Contrato gerado pelo SCC | Número do Contrato gerado pelo SCC, parametrizar um campo de entrada. |
Identificação do motivo da desaverbação do Contrato | Identificação do motivo da desaverbação do Contrato, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
● Método: ConsultaDeMargem: Destinado ao participante consignatário consultar a margem disponível para a consignação.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do CPF do Servidor | Número do CPF do Servidor, parametrizar um campo de entrada. |
Identificação do Serv. (Matrícula ou registro no Ente) | Identificação do Serv. (Matrícula ou registro no Ente) , parametrizar um campo de entrada. |
Identificação do Órgão | Identificação do Órgão, parametrizar um campo de entrada. |
CNPJ do Órgão pagador do Servidor | CNPJ do Órgão pagador do Servidor, parametrizar um campo de entrada. |
Identificação da Espécie | Identificação da Espécie, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
Margem Disponível | Margem Disponível |
Tipo de Vínculo do Servidor | Tipo de Vínculo do Servidor |
Situação da Margem | Situação da Margem |
● Método: ReservaDeAverbacaoRefin: Destinado ao participante Consignatário financeiro envia o registro dos contratos consignados no SCC que serão refinanciados.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do CPF do Servidor | Número do CPF do Servidor, parametrizar um campo de entrada. |
Número da Averbação no SCC que será refinanciado | Número da Averbação no SCC que será refinanciado, parametrizar um campo de entrada. |
Data de Início do contrato | Data de Início do contrato, parametrizar um campo de entrada. |
Data final do contrato | Data final do contrato, parametrizar um campo de entrada. |
Identificação da Espécie | Identificação da Espécie, parametrizar um campo de entrada. |
Quantidade Total de Parcelas | Quantidade Total de Parcelas, parametrizar um campo de entrada. |
Vencimento da 1ª parcela ou carência Inicial(Mês e Ano) | Vencimento da 1ª parcela ou carência Inicial(Mês e Ano) , parametrizar um campo de entrada. |
Dia do Vencimento da Parcela | Dia do Vencimento da Parcela, parametrizar um campo de entrada. |
Valor da parcela | Valor da parcela, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
● Método: ReservaDeAverbacaoFinanceira: Destinado ao participante Consignatário financeiro enviar o registro de consignação no SCC para iniciar o processo de consignação do servidor.
Parâmetros de Configuração
Nome de exibição | Descrição |
Número do CPF do Servidor | Número do CPF do Servidor, parametrizar um campo de entrada. |
Identificação do Serv. (Matrícula ou registro no Ente) | Identificação do Serv. (Matrícula ou registro no Ente) , parametrizar um campo de entrada. |
Data de Nascimento do Servidor | Data de Nascimento do Servidor, parametrizar um campo de entrada. |
Identificação do Órgão | Identificação do Órgão, parametrizar um campo de entrada. |
CNPJ do Órgão pagador do Servidor | CNPJ do Órgão pagador do Servidor, parametrizar um campo de entrada. |
Identificação da Espécie | Identificação da Espécie, parametrizar um campo de entrada. |
Quantidade Total de Parcelas | Quantidade Total de Parcelas, parametrizar um campo de entrada. |
Vencimento da 1ª parcela ou carência Inicial(Mês e Ano) | Vencimento da 1ª parcela ou carência Inicial (Mês e Ano) , parametrizar um campo de entrada. |
Dia do Vencimento da Parcela | Dia do Vencimento da Parcela, parametrizar um campo de entrada. |
Valor da parcela | Valor da parcela, parametrizar um campo de entrada. |
Conta | Conta (Usuário) de acesso ao SCC. |
Parâmetros Internos (Retorno)
Nome de exibição | Descrição |
Tentativa | Número de tentativas de consultas realizadas. |
Código Mensagem | Código da mensagem de retorno. |
Códigos de Erro | Códigos de erro |
Número do Contrato gerado pelo SCC | Número do Contrato gerado pelo SCC |
Passo |
09 |
Para a construção de expressões, alguns conceitos são necessários, como por exemplo operadores.
Operadores
Nome do Operador | Operador | Exemplo |
Adição | + | x + y |
Subtração | - | x - y |
Multiplicação | * | x * y |
Divisão | / | x / y |
Igualdade | == | x == y |
Diferença | != | x != y |
Maior | > | x > y |
Menor | < | x < y |
Maior igual | >= | x >= y |
Menor igual | <= | x <= y |
Condicional AND (E) | && | x == 1 && y == 2 (Se x e y são verdadeiros) |
Condicional OR (OU) | || | x == 1 || y == 2 (Se x ou y são verdadeiros) |
Negação | ! | !True (Não verdadeiro) |
Tipos de Campo
No S-Works os tipos de campo possíveis são os descritos abaixo:
- Alfanumérico: Tipo que suporta campos de texto.
- Boolean: Tipo que suporta campos que possuem apenas dois valores possíveis por exemplo “Sim” ou “Não”.
- DateTime: Tipo que suporta campos de data e hora.
- Número: Tipo que suporta campos numéricos inteiros. Exemplo: 1, 20, 500.
- Monetário: Tipo que suporta campos decimais. Exemplo: 500,50.
Obs: Se você quiser que um numérico seja tratado como decimal, use o sufixo m ou M.
Exemplo: obj.ValorParcela == 500,5M
Isso é o mesmo que: obj.ValorParcela == 500,50
- Imagem: Tipo que suporta imagens.
- ComboBox: Tipo que suporta campos do tipo caixa de combinação que contém
uma lista de opções pré-definida.
Exemplo de combobox:
Funções
- Função: Equals
Objetivo: Determina se o conteúdo de um campo e um texto especifico têm o mesmo
valor.
Exemplo: obj.Dados[60].Situacao.Equals("INEXISTENTE")
Esta expressão determina se o conteúdo do campo obj.Dados.Situacao é
igual a INEXISTENTE.
Obs: Toda a comparação com texto deve estar entre aspas dupla. ""
Objetivo: Converte um campo texto para caracteres em caixa alta.
Exemplo: obj.Dados[60].Cidade.ToLower("BELO HORIZONTE")
Resultado: "belo horizonte"
- ToUpper
Objetivo: Converte um campo texto para caracteres em caixa alta.
Exemplo: obj.Dados[60].Cidade.ToUpper("belo horizonte")
Resultado: "BELO HORIZONTE"
- Trim
Objetivo: Remove de um campo texto a cadeia de em branco.
Exemplo: Vamos supor que o campo obj.Dados.Situacao estivesse o conteúdo
(" INEXISTENTE ")
obj.Dados[60].Situacao.Trim()
Resultado: "INEXISTENTE"
- IsNullOrEmpty
Objetivo: Indica se um campo caractere é um nulo ou vazio.
Exemplo: obj.Dados[60].Situacao.IsNullOrEmpty()
- IsNullOrWhiteSpace
Objetivo: Indica se um campo caractere é um nulo ou espaço em branco.
Exemplo: obj.Dados[60].Situacao.IsNullOrEmpty()
- DateTime.Now
Objetivo: Obter a data e hora atual.
Exemplo: DateTime.Now
Resultado: 23/10/2014 17:00
- Day
Objetivo: Obter o dia de um campo data
Exemplo: obj.DataNascimento.Day
- Month
Objetivo: Obter o mês de um campo data
Exemplo: obj.DataNascimento.Month
- Year
Objetivo: Obter o ano de um campo data
Exemplo: obj.DataNascimento.Year
- TotalDays
Objetivo: Calcula o número de dias entre duas datas.
Exemplo: (30/10/2014 - 25/10/2014).TotalDays
Resultado: 5
Criando Expressões no S-Works
As expressões são validações que são criadas para validar alguma condição necessária.
A condição é realizada por uma atividade ou por um gateway.
A API que permite a construção de expressões é a SWorks.Core.ServerAPI.dll
Quando a expressão a ser construída é em uma Tarefa, o método a ser utilizado é a Condição.
Quando a expressão a ser construída é em um gateway o método a ser utilizado é a DecisaoAutomatica.
Ao digitar na expressão obj. será mostrada uma caixa de seleção com os campos de entrada e retornos de tarefas, conforme tela de exemplo abaixo.
Exemplo de construção de expressão na Tarefa
Exemplo de construção de expressão na Tarefa:
Como forma de padronização, o “Sim” da condição é atribuído a cor verde e o “Não” da condição é atribuído a cor vermelha.
Exemplos Expressões no S-Works
- Exemplo 1
obj.Dados[60].Situacao.ToUpper().Equals("INEXISTENTE")
Neste exemplo duas funções são utilizadas.
A primeira função ToUpper está forçando que o conteúdo do campo “Situacao” seja formatado para caixa alta.
A segunda função Equals está afirmando que o conteúdo do campo “Situacao” é igual a "INEXISTENTE".
Obs: Quando comparamos um campo com um texto é necessário que este texto esteja entre aspas duplas "". Exemplo "INEXISTENTE".
O campo “Situacao” é um campo de retorno de uma tarefa, que é representado pelo algarismo entre colchetes [], que no caso é 60.
- Exemplo 2
obj.Data_Nascimento.ToString("dd/MM/yyyy") == obj.Dados[2645].DataNascimento.Substring(0,10)
Neste exemplo estamos comparando duas datas, sendo que uma está no formato string e a outra date.
- Exemplo 3
obj.Dados[50].StatusLocalizacao.Contains("teste1") || obj.Dados[50].StatusLocalizacao.Contains("teste2") || obj.Dados[50].StatusLocalizacao.Contains("teste3")
Neste exemplo estamos verificando a existência de string dentro de outra string.
Se navegarmos pelo menu: Administração → APIs veremos todas as APIs utilizadas pelo S-Works.
Clicando no sinal de + podemos ver os métodos (Funcionalidades) de cada API. E clicando no botão detalhar podemos visualizar os campos de cada método.
- Exemplo 4
obj.Status[30] == APROVADA
Esta expressão pergunta se o status da tarefa 30 (Consultar Ação) é igual a aprovada.
Seguem abaixo os status possíveis de uma tarefa do S-Works:
Status das Tarefas |
PENDENTE |
PENDENTE_MANUAL |
EM_EXECUCAO |
APROVADA |
REPROVADA |
NAO_EXECUTADA |
AGUARDANDO |
FALHA |
SUSPENSA |
- Exemplo 5 (Cálculos de datas)
((date1.Year - date2.Year) * 12) + date1.Month - date2.Month
Calcular o número de meses entre duas datas.
(DateTime.Now - obj.DataProp).TotalDays <= 10
Calculo de dias entre datas e comparação.
obj.Dados[11800].DataNascimento.Substring(0, 10) == obj.Data_Nascimento.ToString("yyyy-MM-dd")
Comparar datas em formato diferente (string / date time).
- Exemplo 6 (Formatar CPF com zeros a esquerda)
obj.CPF.ToString().PadLeft(11, '0') == "00112345678"
- Exemplo 7 para validar um dado em uma lista
new string[4] { "10", "20", "15", "30" }.Contains((string)obj.Especie)
- Exemplo 8 Converter string em decimal
decimal.Parse(obj.Dados[4500].ValorMargemCartao5) >= obj.Valor_RMC
- Exemplo 9 Truncando um valor para comparação
(Math.Truncate(100 * obj.ValorParcela) / 100).ToString() == "1235,45"
- Exemplo 10 arredondando um valor para comparação
Decimal.Round(Decimal.Parse(obj.TaxaCetAA), 2)
Passo |
10 |
Para utilizar expressões regulares para localizar determinado dado no OCR de uma imagem, devemos utilizar o método CampoDocumento da API SWorks.Core. No exemplo abaixo estamos pegando a data de admissão no contracheque.
Outros exemplos de expressões regulares:
Admiss.o\s*(\d{2}/\d{2}/\d{4}) -- Pegar após a palavra Admissão a data 99/99/9999
Agencia:.*?(\d{4}) -- Pegar o número da agência após a palavra “Agencia:”, 4 próximos caracteres numéricos.
Banco.*?:(.*?)Agencia: -- Pegar o nome do Banco entre as palavras “Banco”e “Agencia:”
Related Articles
Importar workflow em versão publicada
Em um workflow Publicado, pode-se importar um novo workflow, sem a necessidade de criar uma versão Rascunho do workflow. Ao criar uma versão de rascunho de um Workflow e posteriormente realizar a importação de um novo workflow, todos os dados antigos ...Configuração de Expurgo
O expurgo do S-Works tem o propósito de limpeza de dados, arquivos, processos e etc. Esta ferramenta, é indicada para que o sistema não fique sobrecarregado, limpando o desnecessário para o seu negócio e aprimorando ainda mais o rendimento dos ...Configuração de relatório no S-Works
O S-Works possibilita que você configure o relatório desejado de um determinado Workflow existente, com alguns dados pré-formatados e outros selecionados, como os dados de entrada para complemento do relatório gerado. Também permite indicar tarefas ...Horário de execução de um Workflow
Caso seja necessário verificar o horário em que o workflow é executado siga o passo a passo: 1. Clique no menu Administração; 2. Clique em Workflows. 3. Selecione o Workflow desejado e clique em editar. 4. Clique no nome do Workflow. Em dados do ...Segmentação de acesso a nível de Workflow
Melhoria implantada a partir da versão 2.6 do S-Works Mudanças realizadas: Na configuração do Workflow agora é possível informar qual o grupo terá acesso as informações referentes aquele Workflow. Maior segurança e confiabilidade, visto que com essa ...