Histórico da Página
Desenvolvimento de Novas Funcionalidades ao Processo Auditoria Pós na ferramenta ECM
Produto: | Gestão de Planos de Saúde |
Módulo: | HAT - Atendimento ao Público |
| Versão: | 12.1.x |
| Assuntos: | 1. Qual a Visão do Processo? |
...
Porém, esses grupos podem ser modificados conforme a regra de triagem informada.
Quando o usuário entra na tarefa para a realização da auditoria, o formulário por meio dos Datasets, chamado o serviço do appserver cadastrado e executa a procedure desejada da fachada fchsauecmposauditory.p para obter as informações desejadas.
2. Como é realizado o cadastro de Serviço?
O cadastro de Serviço acessado no menu Painel de Controle/Serviço permite a configuração dos dados de conexão com o AppServer utilizado. No caso desse projeto, esse serviço deve ser cadastrado obrigatoriamente com o nome "Auditoria" pois esse nome é utilizado em todos os Datasets do projeto.
Esse cadastro utiliza-se do cadastro de Ambientes para associar as bibliotecas Java que devem ser utilizadas para a conexão com o AppServer correspondente. Além disso, nesse cadastro, deve-se realizar o upload do jar contendo as classes do Proxygen que comunicará com o programa progress desejado, no caso o arquivo datasul-healthcare-integration-ecmauditory-proxygen-11.5.7-SNAPSHOT.jar disponível em "<Diretório Programas>\ecm\Auditorias\public_html\proxygen\".
No campo URL deverá ser informado a url de conexão com o AppServer seguindo o seguinte modelo "Appserver://<servidor>:<porta>/<serviço>".
No campo Objeto Remoto deverá ser informado o valor "com.datasul.ems.healthcare.integration.ecmauditory. ECMPosAuditory".
Maiores detalhes podem ser obtidos no documento Guia de Integração "ECM.pdf" disponível na pasta de instalação do TOTVS ECM.
Importante: Quando ocorrer uma alteração nas tabelas temporárias ou alterada a assinatura de uma procedure do programa Fchsauecmposauditory.p. Será necessário gerar novamente o Proxygen dessa fachada e realizado o upload do mesmo nesse cadastro.
3. Como é realizado o cadastro de Datasets?
O cadastro de Datasets acessado através do menu Painel de Controle / Dataset é responsável por fornecer o acesso as funções disponibilizadas por meio dos Serviços. Os processos e os formulários para obter acesso as informações utilizam-se dos Datasets para chamar as rotinas progress via AppServer.
...
Observação: Toda a vez que um ocorre uma mudança de proxygen, os Datasets que utilizam a temporária ou função alterada necessitam ser modificados pra que possa contemplar as alterações.
4. Como criar o Formulário para armazenamento das informações?
Processo acessado através do menu Documentos/Navegação de Documentos.
Todo o Processo de Workflow necessita de um formulário base para a sua execução e armazenamento das informações. Um formulário é uma página html que utiliza-se de recursos de javascript, css e imagens para fornecer uma melhor experiência aos usuários.
No ECM um formulário é um fichário que contém em seu interior todos os componentes html (página html, scripts javascripts, css e imagens) utilizados pelo formulário.
Para fins de organização, recomendamos que no diretório raiz seja criada uma pasta "Formulários" e dentro dela seja criada uma pasta "Auditoria". No interior da pasta "Auditoria" deve-se criar um fichário com o nome "Formulário Processo Auditoria".
Deve ser realizado o upload dos seguintes arquivos existentes na pasta "<Diretorio Programas>\ecm\Auditorias\public_html\":
- auditorycontroller.js
- auditorias_v2.html
- ajax-loader.gif
- jquery.js
- knockout-3.0.0.js
- html5.js
- json2.js
- html5.js
- bootstrap-tooltip.js
- accounting.min.js
- bootstrap.css
- docs.css
- bootstrap-affix.js
- bootstrap-alert.js
- bootstrap-button.js
- bootstrap-carousel.js
- bootstrap-collapse.js
- bootstrap-dropdown.js
- bootstrap-modal.js
- bootstrap-popover.js
- bootstrap-responsive.css
- bootstrap-scrollspy.js
- bootstrap-tab.js
- bootstrap-transition.js
- bootstrap-typeahead.js
- respond.min.js
- Deverá realizar o upload das imagens contidas no diretório "<Diretorio Programas>\ecm\Auditorias\public_html\imgs\":
- message.png
- treatment.png
- undo.png
- trash.png
- money_add.png
- package_medical.png
- via_acesso_diferente.png
- via_acesso_mesma.png
- via_acesso_principal.png
- anestesista_not.png
- anestesista.png
- auxiliar.png
- demais.png
- insumo.png
- principal.png
- procedimento.png
- apply.png
- glyphicons-halflings.png
- glyphicons_367_expand.png
- glyphicons_369_collapse_top.png
- up.png
- down.png
- 1378257226_list-error.png
- Gnome-Document-Open-Recent-32.png
- Dialog-Apply-32.png
- Gnome-Dialog-Warning-32.png
- clock_32.png
- clock_down_48.png
- contract_clock_48_hot.png
- diagnostic.png
- info_24.png
- ok_24.png
- warning.png
- Add-Files-To-Archive-32.png
- Add-Files-To-Archive-Blue-32.png
- Add-Files-To-Archive-Yellow-32.png
Após realizado o upload o arquivo auditorias_v2.html deve ser marcado como Principal. Apenas esse arquivo deve estar marcado como Principal os demais devem estar marcados como Anexo.
Na etapa 3 | Descrição Principal das Fichas, deve-se selecionar o campo "ds_anexo_principal". O conteúdo desse campo será apresentado como o valor de uma coluna na lista de tarefas.
Na etapa 6 | Eventos, deve-se adicionar o evento "displayFields". O conteúdo desse evento está no arquivo "displayFields.js". Esse evento é importante, pois atribui ao formulário o um indicador para que o mesmo saiba se está sendo apenas consultado ou se deve abrir em modo de edição, ou seja, para que a auditoria seja realizada. Isso é utilizado para bloquear as ações que podem ser realizadas no formulário quando o mesmo é apenas visualizado.
Exemplo: Quando um usuário consulta a tarefa sem assumi-la, o formulário não deve permitir que seja feita qualquer alteração.
5. Qual a Arquitetura do Formulário HTML Auditorias v2?
O formulário HTML é composto por:
...
Quando é realizado o upload de um formulário html ao ECM, o mesmo analisa todos os campos do tipo input que existam no mesmo e, caso seja adicionado novos ou a ordem dos mesmos for alterada ou ainda algum campo seja removido o ECM detecta que ocorreu uma alteração e gera uma nova versão desse formulário. Desta forma, as solicitações já existentes não irão sofrer nenhuma alteração. Apenas as próximas solicitações é que receberão os campos novos.
As pequenas alterações realizadas no formulário como, por exemplo, modificar cores, adicionar chamadas a funções js, data-binding a campos já existentes não fazem com que uma nova versão do formulário seja gerada.
As alterações realizadas no arquivo "auditorycontroller.js" não fazem com que uma nova versão do formulário seja gerada. Apenas alterações no arquivo "auditorias_v2.html" podem a vir gerar uma nova versão interna do formulário no ECM.
6. Como é realizada a importação de Processos?
A Importação de Processos é acessada através do menu Processos / Importação de Processos.
Esse processo possibilita importar o processo configurado e que fora exportado. Por meio desse cadastro é possível importar o processo disponibilizado na pasta "<Diretorio Programas>\ecm\Auditorias\public_html\processo\ auditoriapos.xml"
Esse processo permite importar novos processos assim como sobrepor processos já existentes pelo que deseja importar.
7. Como funciona a configuração de Processos?
Nesse processo acessado através do menu Processos / Configuração de Processos podemos modificar os processos já cadastrados ou ainda criar novos processos.
Itens Importantes:
Aba Informações Gerais
- Código: Código único do processo.
- Descrição: Descrição do processo.
- Ativo?: Indicador que habilita o processo.
- Categoria: Permite informar a categoria do processo a fim de determinar um agrupador na tela.
Aba Versão
Versão: Esse campo indica qual a versão do processo que está sendo alterada. Para alterar a versão corrente de um processo, clique em "Nova Versão", no qual possibilitará editar o processo. Para que as alterações realizadas estejam disponíveis clique em "Liberar Versão". Quando uma solicitação é aberta ela surge numa versão de processo e encerra-se nessa mesma versão. Então, quando gerada uma nova versão do processo, apenas as próximas solicitações sofrerão as alterações realizadas.
Fichário: Código do Fichário (formulário) a ser utilizado pelo processo.
Aba Workflow Graphical Designer
Essa tela permite o desenho do processo seguindo o padrão BPM. Constitui-se o processo como um conjunto de atividades interligadas conforme a necessidade. Cada atividade possibilita informar as Instruções e que aparecerão ao usuário quando a solicitação estiver nessa atividade.
O campo Mecanismo de Atribuição permite informar a forma em que a atividade será atribuída, ou seja, pode ser atribuída a um usuário específico, a um grupo de usuários, a um papel de usuário.
Aba Avançado
Essa aba adicionará os eventos de formulários que possibilita a realização de controles e validações sobre o fluxo conforme a necessidade.
Na sub-aba Propriedades deve existir a propriedade AutomaticTasks informando o código de sequência das atividades que deverão ser automáticas, ou seja, que não necessitam de ação do usuário no formulário.
A sub-aba Eventos possibilita o cadastro dos eventos de controle do processo. No processo auditoriapos, os eventos utilizados são "afterStateEntry" e "beforeStateEntry". Os conteúdos desses eventos já são preenchidos quando o processo é importado/sobreposto. Mas está disponibilizado na pasta "<Diretorio Programas>\ecm\Auditorias\public_html\eventos\". Os arquivos javascripts desse diretório estão nomeados de acordo com o nome do evento utilizado.
Maiores detalhes podem ser obtidos no documento "Guia de Referência Customização de Workflow.pdf" disponível na pasta de instalação do TOTVS ECM.
Após ter importado o processo "auditoriapos.xml" e verificado se os eventos foram importados, devemos liberar a versão do processo para que o mesmo fique disponível para uso.
Esse processo jamais poderá ser inicializado diretamente pelo TOTVS ECM. A solicitação é gerada pelo ERP TOTVS devido a ação de uma das regras de auditoria sobre algum documento/movimento.
Por padrão o processo de Auditoria Pós utiliza os seguintes grupos de auditorias:
...
Os grupos de reanálise somente é utilizado quando a atividade do processo é encaminhada para uma tarefa de Reanálise.
A partir desse momento o ECM está configurado para receber e gerenciar as tarefas de auditoria.
As solicitações geradas a partir do ERP TOTVS 11 serão apresentadas na Central de Tarefas do usuário acessada através do menu Documentos/Central de Tarefas.
A lista de Tarefas a concluir agrupa as tarefas assumidas pelo usuário logado e estão pendentes de seu parecer.
A lista Tarefas em pool apresentam as tarefas conforme os grupos que o usuário participa. Desta forma, o usuário pode encontrar uma tarefa referente ao grupo de auditoria que participa e assume a tarefa. Quando um usuário assume a tarefa, a mesma é enviada para a lista de Tarefas a concluir do mesmo.
Observações: Para que o cliente possa customizar os grupos de usuários de auditoria criando grupos específicos de usuários para auditar determinados prestadores deve-se então criar uma parametrização de Regra de Direcionamento das Auditorias.
8. O que é o Formulário Regras de Triagem?
Processo acessado através do menu Documentos/Navegação de Documentos.
O controle das regras de direcionamento das auditorias se dá por meio de regras cadastradas nas fichas. As fichas são registros de parametrização oriundos de um formulário. Um formulário é uma página html que utiliza-se de recursos de javascript, css e imagens para fornecer uma melhor experiência aos usuários.
No ECM um formulário é um fichário que contém em seu interior todos os componentes html (página html, scripts javascripts, css e imagens) utilizados pelo formulário.
Para fins de organização, recomendamos que no diretório raiz seja criada uma pasta "Formulários" e dentro dela seja criada uma pasta "Auditoria". No interior da pasta "Auditoria" deve-se criar um fichário com o nome "Regras de Configuração de Triagem para Auditoria", deverá ser realizado o upload dos seguintes arquivos existentes na pasta "<Diretorio Programas>\ecm\Auditorias\public_html\":
...
- message.png
- treatment.png
- undo.png
- trash.png
- money_add.png
- package_medical.png
- via_acesso_diferente.png
- via_acesso_mesma.png
- via_acesso_principal.png
- anestesista_not.png
- anestesista.png
- auxiliar.png
- demais.png
- insumo.png
- principal.png
- procedimento.png
- apply.png
- glyphicons-halflings.png
- glyphicons_367_expand.png
- glyphicons_369_collapse_top.png
- up.png
- down.png
- 1378257226_list-error.png
- Gnome-Document-Open-Recent-32.png
- Dialog-Apply-32.png
- Gnome-Dialog-Warning-32.png
- clock_32.png
- clock_down_48.png
- contract_clock_48_hot.png
- diagnostic.png
- info_24.png
- ok_24.png
- warning.png
- Add-Files-To-Archive-32.png
- Add-Files-To-Archive-Blue-32.png
- Add-Files-To-Archive-Yellow-32.png
Após realizado o upload, o arquivo config_auditorias.html deverá ser marcado como Principal. Apenas esse arquivo deve estar marcado como Principal os demais devem estar marcados como Anexo.
Para o campo Descrição recomendamos que seja utilizado o nome "Regras de Configuração de Triagem para Auditoria".
No campo Nome do Serviço de Dados deverá ser atribuído obrigatoriamente o valor "config_auditorias_modelo" como nome do serviço.
Recomendamos que o campo cd_prestador_principal seja utilizado para descrição das fichas. Após isso clique em "Confirmar" para concluir o processo de inclusão do formulário. Nesse ponto teremos a seguinte estrutura:
Clique sobre a pasta Regras de Configuração de Triagem para Auditoria em seu interior adicione uma nova ficha. O sistema apresentará a seguinte tela para inclusão de regra de Triagem:
A regra permite especificação do grupo de auditoria que deseja ser utilizado conforme o Prestador Principal e o Prestador Executante.
Ou seja, quando o Prestador Principal for o informado e o Prestador Executante for o informado a regra será aplicada e irá sobrepor os grupos padrões pelos informados nessa parametrização.
Marque a opção Ativar para habilitar a regra.
Para salvar a regra deve-se concluir clicando no "V" existente no canto superior direito.
9. Pelo que é composta a Arquitetura do Formulário HTML Config. Auditorias?
O formulário HTML é composto por:
- Framework Visual Bootstrap na versão 2.3.2 (http://getbootstrap.com/2.3.2/) - Esse framework disponibiliza recursos visuais que "embelezam" o formulário e facilitam o desenvolvimento das telas.
- Biblioteca Javascript jQuery 1.9.1 (http://jquery.com/) - Essa biblioteca é rica em recursos que facilitam a manipulação dos componentes HTMLs.
- Biblioteca ecm_datasets.js ou vcXMLRPC.js – Bibliotecas fornecidas pelo ECM que possibilitam realizar chamadas aos Datasets por meio do formulário javascript. A biblioteca vcXMLRPC.js foi depreciada devido a bugs e por orientação da Equipe do ECM devemos utilizar a biblioteca ecm_datasets.js.
- Script config_auditorias_controller.js – Esse script contém todas as funções javascripts necessárias para controlar os zooms para os grupos disponíveis no ECM.
10. Como cadastrar Colaborador?
Esse cadastro acessado em Painel de controle/ Colaboradores possibilita gerenciar as informações de um usuário além de permitir associá-lo aos grupos o qual o mesmo irá pertencer.
11. Como é realizado o cadastro de Grupos de Usuários?
Esse cadastro é acessado em Painel de Controle / Grupos de Usuários possibilita o cadastro dos grupos pelos quais os usuários irão pertencer. Os grupos podem ser utilizados nos processos como um mecanismo de atribuição.
Por padrão o processo de Auditoria Pós utiliza os seguintes grupos de auditorias:
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas