Integração BPM e GO UP XTended
A integração entre BPM e GO UP XT acontece através da execução de regras em processos agendados no sistema. O processo agendado flexibiliza a frequência com que a integração precisa acontecer e pode ser definida conforme a necessidade e volume do cliente. As regras escolhidas na linguagem LSP é de domínio da Senior, além da flexibilização que elas permitem. A lógica de negócio de cada template irá determinar a integração com o sistema ou não, que pode ser de importação de dados e/ou exportação entre GO UP XT e BPM.
Tanto os templates como as regras, além de serem parte integrante da solução nativa podem ser utilizadas como exemplo para desenvolvimento de novas soluções.
Para que a integração ocorra devidamente é necessário que a senior X Platform esteja configurada e funcionando adequadamente.
Transferência de dados
Exportação
- O processo agendado executa a regra definida para exportação de dados (nativamente distribuída como SARG900.LSP);
- A regra possui a lógica de carregar os dados necessários do GO UP XT (cursores na base) e armazená-los em arquivos .csv. Estes arquivos são gerados na pasta IMPEXP, configurada na Central de Configurações Senior;
- A mesma regra executa uma função que carrega os arquivos .csv para as tabelas do BPM via uma API específica.
- O delimitador de formatação no arquivo .csv está definido como ";" (ponto e vírgula). Desta forma as informações que tramitam entre os produtos não podem conter este caractere sob o risco de quebrar a lógica das rotinas.
- Exportações já pré-configuradas na regra SARG900.LSP:
- BPM - Exportação Cadastro de Filiais (E070FIL): exporta todas as filiais da base de dados.
- BPM - Exportação Centro de Custo (E044CCU): exporta todos os centros de custos da base de dados.
- BPM - Exportação Localização Patrimônio (E674LOR): exporta o cadastro dos locais dos bens cuja a situação da localização seja diferente de inativo (e674lor.sitlor <> 'I').
- BPM - Exportação Famílias (E012FAM): exporta todas as famílias cuja a situação seja diferente de inativa (E012FAM.sitfam <> 'I').
- BPM - Exportação Origens (E083ORI): exporta todas as origens de produto/serviço da base de dados.
- BPM - Exportação Formas de Agrupamento (E013AGP): exporta todas as formas de agrupamento da base de dados.
- BPM - Exportação Unidades de Medida (E015MED): exporta todas as unidades de medidas da base de dados.
- BPM - Exportação Classificação Fiscal (E022CLF): exporta todas as classificações fiscais da base de dados cuja a situação da classificação seja diferente de inativa (E022CLF.sitclf <> 'I').
- BPM - Exportação Situações Tributárias (E027STR): exporta todas as situações tributárias da base de dados.
- BPM - Exportação Plano Contábil (E045PLA): exporta todas as contas do plano contábil cuja a situação da conta seja diferente de inativa (e045pla.sitcta <> 'I').
Importação
- O processo agendado executa a regra definida importação de dados (nativamente distribuída como SARG901.LSP)
- A regra possui a lógica de consumir uma API no BPM que faz a leitura dos dados nas tabelas necessárias do BPM. A mesma regra, a partir dos dados retornados, utiliza web services do GO UP XT para inserir os registros conforme regra de negócio.
No produto padrão liberamos dois templates com o propósito de inserir dados no GO UP XT, são eles: Cadastro de Favorecidos e Cadastro de Produto. A regra SARG901.LSP faz uso de dois web services com este objetivo: com.senior.g5.co.ger.cad.favorecido.gravarfavorecido e com.senior.g5.co.ger.cad.produto.cadastrar.
- GO UP XT on-line;
- Instalação e configuração do Middleware Senior. Somente com este servidor instalado é possível realizar o cadastro dos processos automáticos para execução dos processos automáticos na tela F000AGE, de importação e exportação dos dados para BPM. A sua instalação é feita no Instalador, junto com a instalação do produto ou separadamente;
- Na Central de Configurações Senior, em Sistema > Gestão Empresarial (ERP) > Configurações ERP XT, no campo Arquivo de transferência de arquivos CSV para a plataforma (.jar), deve ser informado o arquivo table-import-csv-{versão}.jar. Este arquivo está atualmente na versão 1.0.9 e é distribuído na mídia do ERP na pasta \delphix\plataform\table_import_csv, denominado table-import-csv-1.0.9.jar;
- Liberação das portas para comunicação da nuvem com o ambiente na senior X Platform.
- É necessário que os web services do GO UP XT estejam disponíveis para uso. Certifique-se que não existe restrição de uso por proprietária ou alguma outra limitação que impeça o consumo de web services via regra.
- Acesse o ERP XT > senior X Platform > BPM > Processos;
- Na lista de processos clique em Criar novo processo e selecione o processo a ser incluso (template padrão);
- Informe o Nome do processo e clique em Salvar;
- Ainda que os templates do BPM sejam entregues prontos, necessitam de ajustes para se tornarem aderentes a estrutura funcional do cliente. Cada etapa de processo de um BPM requer um responsável (usuário ou papel), denominado “Mecanismo de Atribuição”.
Para determinar os responsáveis pelas etapas de um processo:- Inicialmente, temos de entrar em modo de edição do processo, em senior X Platform > BPM > Processo.
- Escolha o processo que deseja editar e em Ações, clique em Editar.
- Após, no quadro Configurações, localize a opção Fluxo e clique para acessar o fluxo do processo escolhido.
- Cada etapa do fluxo é representada por um retângulo, em exceção a primeira, normalmente denominada “Solicitação”. Nas demais é possível definir um usuário como responsável pela execução da etapa. Os templates estão configurados como padrão com “Usuário Solicitante”;
- Para isso, clique na etapa do processo para abrir o Painel de Propriedades na lateral direita. Localize Mecanismo de Atribuição, clique em Configurar e defina o usuário responsável;
- Após finalizar as definições, salve e publique utilizando os botões do cabeçalho.
Observação
Nos processos de Cadastro de Favorecidos e Cadastro de Produto, na etapa de Execução, os mecanismos de atribuição se chamam Usuário Aplicação Externa, estes não podem ser alterados pois é assim que definimos uma etapa que será executada por uma aplicação externa.
- Em seguida, configure as regras para que ocorra a integração dos dados no template escolhido.
A importação e exportação de dados entre o BPM e o sistema acontece através de duas regras, que estão localizadas na mídia do sistema, dentro da pasta \delphix\plataform\regras: SARG900.LSP para exportação e SARG901.LSP importação. - Em seguida, execute as regras manualmente para testar a exportação de dados do BPM para o GO UP XT:
- Para testar a exportação de dados do GO UP XTao BPM, pode ser utilizado o processo Cadastro de Produto (caso você não tenha adicionado este template, crie o novo processo e adicione este template, conforme informado anteriormente);
- Execute a regra SARG900.LSP manualmente;
- Acesse a Central de Tarefas: senior X Platform > BPM > Central de Tarefas;
- Clique em Nova Solicitação e localize o processo Cadastro de Produto. Caso não encontre entre os principais, vá em Ver Todos;
- Ao entrar no processo, no campo Nome Empresa clique na lupa e verifique a lista de empresas do GO UP XT como opções para escolha;
- Pronto, teste de exportação de dados finalizado. Este exemplo é apenas um dentre diversos outros campos em formulários nos templates disponibilizados, onde o propósito é trazer facilidade no preenchimento dos formulários utilizando informações do próprio sistema;
- Para testar a importação de dados do BPM para o GO UP XT:
- Pode ser utilizado o processo Cadastro de Favorecido;
- Acesse novamente a Central de Tarefas: senior X Platform > BPM > Central de Tarefas;
- Clique em Nova Solicitação e localize o processo Cadastro de Favorecido. Caso não encontre entre os principais, vá em Ver Todos;
- Ao entrar no processo, preencha os campos solicitados e clique em Enviar;
- Este fluxo foi desenhado para que a próxima etapa seja realizada por um mecanismo de atribuição de “Usuário Aplicação Externa”, que neste caso será a regra do GO UP XT;
- Execute a regra SARG901.LSP manualmente e na tela F077FAV consulte o registro que foi inserido com os dados originados no fluxo do BPM;
- Pronto, finalizado o teste de importação de dados.
- Por fim, faça o agendamento das regras no cadastro de processos automáticos. O cadastro de processos automáticos para a execução de regras acontece no GO UP XT e é necessário realizar o agendamento de execução informando os campos obrigatórios e o código da regra, na guia regras.
O agendamento tem o objetivo de executar processos pré-programados ou agendados antecipadamente, de uma forma automática, sem nenhuma interação, através de um servidor de aplicações. Verifique as variações de necessidade de fluxos, volumetria de dados, entre outras características para a configuração do processo agendado. Para a regra de exportação de dados do GO UP XT ao BPM (SARG900.LSP) é recomendável que seja feita apenas uma vez por dia, ou mais dias de intervalo, considerando que se tratam de cadastros com baixa frequência de atualização. Já a regra de importação de dados do BPM para o GO UP XT (SARG901.LSP) dependerá da necessidade do processo do workflow utilizado. neste caso, é recomendável iniciar com 30 minutos e, posteriormente, avaliar a necessidade.