[4.4] – Contexto de Indicadores do Home Care (HC)

IMPORTANTE: Os procedimentos descritos a seguir descrevem o processo de publicação de indicadores “nativos” desenvolvidos e publicados pela Incoway. Esse procedimento deve ser utilizado como método de publicação “de partida” dos indicadores no contexto dos processos de Home Care (HC). Ou seja, nos casos de clientes que já utilizam os indicadores nesse contexto e que podem inclusive terem implementado customizações próprias sobre esses indicadores, os procedimentos descritos nesse tópico não se aplicam pois podem implicar em perda de dados (indicadores previamente calculados) e perda das customizações realizadas pelo Cliente.

Sequência de passos:

[4.4.1] – Copiar as tabelas TD_INDIC_HC e TD_INDIC_HC_DETAIL e tabelas auxiliares para a base do cliente
[4.4.2] – Publicando o template de apresentação dos indicadores do Home Care (HC)
[4.4.3] – Publicar o link de menu de lançamento da interface F01521 no contexto do Home Care (HC) para uso interno
[4.4.4] – Publicar o link de menu de lançamento da interface F01521 no contexto do Home Care (HC) para uso por Operadoras
[4.4.5] - Atualizar o link de acesso à F01521 em painéis de navegação configurados na empresa de atenção domiciliar
[4.4.6] – Copiando as funções de cálculo dos indicadores no contexto HC
[4.4.7] – Publicar os links de chamadas das funções de filtragem de pacientes / relatórios

[4.4.1] – Copiar as tabelas TD_INDIC_HC E TD_INDIC_HC_DETAIL e tabelas auxiliares para a base do cliente

Tabelas : TD_INDIC_HC e TD_INDIC_HC_DETAIL: Tabelas global de controle dos indicadores e armazenamento dos resultados calculados


Antes de copiar essas tabelas necessitamos dropar essas tabelas na base do cliente.

Se a base do cliente for “oracle” execute a seguinte sequência de comandos:

drop table TD_INDIC_HC

drop sequence TD_INDIC_HC_SEQ

delete from ifrtable where name = 'TD_INDIC_HC'

drop table TD_INDIC_HC_DETAIL

drop sequence TD_INDIC_HC_DETAIL_SEQ

delete from ifrtable where name = 'TD_INDIC_HC_DETAIL'

Se a base do cliente for “SqlServer” execute a seguinte sequência de comandos:

drop table TD_INDIC_HC
delete from ifrtable where name = 'TD_INDIC_HC';

drop table TD_INDIC_HC_DETAIL

delete from ifrtable where name = 'TD_INDIC_HC'

Para fazer a cópia da tabela utilize a interface F00043 ilustrada abaixo:

Faça a cópia das tabelas : TD_INDIC_HC e TD_INDIC_HC_DETAIL

Selecione a tabela desejada e clique no botão “Substituir”.

Tabelas Auxiliares Utilizadas nos Cálculos dos Indicadores HC

As seguintes tabelas auxiliares são utilizadas pelas funções de cálculo dos indicadores de desempenho HC:

Execute os mesmos passos indicados anteriormente com relação por exemplo à tabela TD_INDIC_HC para cada uma das tabelas enumeradas acima. Ou seja, execute os comandos de drop da tabela e da sequence e depois faça a cópia da tabela partindo do banco de referência dbIwIncoway.

[4.4.2] – Publicando o template de apresentação dos indicadores do Home Care (HC)

A figura a seguir ilustra a interface de cadastro de templates na base dbIwIncoway:

O template de apresentação dos indicadores do Home Care (HC) no dbIwIncoway é o template de ID=401.

Se na base do cliente ainda não existir o template para exibição dos indicadores do Home Care (HC) cadastre esse template na base do cliente, caso já exista o template copie o fonte do template no dbIwIncoway e cole sobre o fonte desse template na base do cliente.

IMPORTANTE: A tag de endereçamento da logomarca do cliente deverá ser ajustada. A figura a seguir ilustra onde fica essa tag no fonte do html do template. Substitua essa tag no fonte do template para a tag correta na base do template (consulte o fonte de algum template já publicado na base do cliente que já esteja configurado para exibir a logomarca do cliente para e faça a substituição da tag).

[4.4.3] Publicar o link de menu de lançamento da interface F01521 no contexto de indicadores do HC para uso interno

A figura a seguir ilustra o posicionamento desse link:

Selecione o link e cllique no botão “Editar”. O IW irá abrir a caixa de diálogo ilustrada abaixo:

Descritivo da valoração dos atributos:

Classe: com.iw.visualLayer.contract.IwFormExeCtrDpcConsolidateV2

Parâmetros: TD_INDIC_HC|401|TD_INDIC_HC_DETAIL|EVOLUTION:3672|STATUS:3673|EXCEPTION:3674|

Onde:

TD_INDIC_HC : Trata-se do nome da tabela “cabeça” para registro dos indicadores no contexto HC (Home Care)

401: corresponde ao ID do template de indicadores HC. Verifique qual é o ID de fato desse template na base do cliente e valore corretamente esse atributo.

TD_INDIC_HC_DETAIL: Trata-se do nome da tabela onde ficarão armazenados os detalhes dos indicadores no contexto HC.

EVOLUTION:3672 ==> O número situado logo após a expressão “EVOLUTION:” (nesse exemplo : 3672) trata-se do valor do KEYINDEX do comando SQL (cadastrado na tabela IFRSQLCOMMAND sob o FORMID 1521) que será executado pelo IW ao se realizar a pesquisa na aba denominada “Evolução Clínica” da interface F01521 no contexto dos indicadores do HC. Ou seja, antes de valorar esse atributo deve-se cadastrar esse comando SQL na base de dados do cliente.

A figura a seguir ilustra os comandos cadastrados na tabela IFRSQLCOMMAND sob o FORMID=1521 na base de referência (dbIwIncoway): Basicamente acessamos a interface Sql & Debug na base de referência e executamos o seguinte comando:

select * from ifrsqlcommand where formid = 1521 order by id asc

A figura a seguir mostra o resultado da execução desse comando:

Execute um duplo clique com o botão direito do mouse sobre a célula da coluna SQLCOMMAND para visualizar o comando SQL completo. A figura a seguir ilustra essa navegação:

Para cadastrar o comando na base de dados do cliente utilize a própria interface F00129 - Sql & Debug. Clique no botão “Novo”, o IW irá abrir uma linha nova editável no gride. Valore os seguintes atributos: FORMID = 1521 ; KEYINDEX=3672; e SQLCOMMAND igual a uma cópia do comando SQL com KEYINDEX = 3672 do banco matriz de referência (dbIwIncoway). IMPORTANTE: Valore a coluna SYSTEM = 0 (para evitar que em atualizações de versão futuras esse comando seja sobreposto na base do cliente).

STATUS: 3673 ==> O número situado logo após a expressão “STATUS:” (nesse exemplo : 3673) trata-se do KEYINDEX do comando SQL (cadastrado na tabela IFRSQLCOMMAND sob o FORMID 1521) que será executado pelo IW ao se realizar a pesquisa na aba denominada “Quadro Clínico” da interface F01521 no contexto dos indicadores HC. IMPORTANTE: Valore a coluna SYSTEM = 0 (para evitar que em atualizações de versão futuras esse comando seja sobreposto na base do cliente).

Cadastre o comando SQL na base de dados do cliente (utilize a interface F00129). Valore os seguintes atributos: FORMID = 1521 ; KEYINDEX=3673; e SQLCOMMAND igual a uma cópia do comando SQL com KEYINDEX = 3673 do banco matriz de referência. (dbIwIncoway).

EXCEPTION: 3674 ==> O número situado logo após a expressão “STATUS:” (nesse exemplo : 3674) trata-se do KEYINDEX do comando SQL (cadastrado na tabela IFRSQLCOMMAND sob o FORMID 1521) que será executado pelo IW ao se realizar a pesquisa na aba denominada “Chamadas Recebidas” da interface F01521 no contexto dos indicadores HC. IMPORTANTE: Valore a coluna SYSTEM = 0 (para evitar que em atualizações de versão futuras esse comando seja sobreposto na base do cliente).

Cadastre o comando SQL na base de dados do cliente (utilize a interface F00129). Valore os seguintes atributos: FORMID = 1521 ; KEYINDEX=3674; e SQLCOMMAND igual a uma cópia do comando SQL com KEYINDEX = 3674 do banco matriz de referência. (dbIwIncoway).

[4.4.4] Publicar o link de menu de lançamento da interface F01521 no contexto HC para uso por Operadoras

A mesma interface F01521 , ainda no contexto de indicadores de indicadores do HC, também poderá ser instanciada de modo diferenciado para uso diretamente pela “Operadora”. A figura a seguir ilustra a posição “default” no menu padronizado do IW onde se situa um exemplo de configuração de menu para esse tipo de lançamento:

Clique no botão “Editar” para visulaizar a interface de cadastro dos parâmetros de menu que ilustramos abaixo:

Esse link de navegação irá lançar a mesma interface F01521 também no contexto de indicadores HC com a diferença de que a navegação nos dados da interface estarão limitados da seguinte :

(a) Estarão visíveis no resultado da pesquisa na primeira aba apenas linhas (relatórios de indicadores) que já tenham sido “publicados”.

(b) Os filtros para pesquisa estarão limitados a um grupo de operadoras específico.

O objetivo dessa interface é disponibilizar um acesso direto a usuários diretos das Operadoras (clientes da empresa de atenção domiciliar) à interface F01521 no IW para que a própria Operadora possa acompanhar on-line a evolução dos indicadores e das evoluções clínicas dos seus pacientes.

A valoração dos atributos na F00020, nesse caso, são praticamente idênticos aos atributos detalhados no tópico anterior. Basicamente a diferença será a presença de mais dois atributos no conteúdo do campo “Parâmetros”. A valoração do campo parâmetros nesse caso ficaria da seguinte forma:

TD_INDIC_HC|401|TD_INDIC_HC_DETAIL|OPERADORA|IDENTERPGROUP=12|EVOLUTION:3672|STATUS:3673|EXCEPTION:3674|

Notem a presença dos atributos : OPERADORA| e IDENTERPGROUP=12|.

OPERADORA: Esse atributo instrui o IW a limitar o resultado da pesquisa somente a relatórios “publicados”.

IDNTERPGROUP=<ID_GRUPO_OPERADORAS> Esse atributo instrui o IW a limitar os filtros de pesquisa de modo a permitir a visualização somente de indicadores e evoluções clinicas de pacientes de operadoras que pertençam ao grupo de operadora cujo ID = <ID_GRUPO_OPERADORAS>. Nesse exemplo ID_GRUPO_OPERADORAS= 12 que corresponde a um grupo de operadoras de exemplo cadastrado na base de referência (dbIwIncoway).

Nota: Para cadastrar um grupo de operadoras utilize a opção de menu ilustrada abaixo:

A figura a seguir ilustra essa interface :

Na primeira aba dessa interface deve-se cadastrar os grupos de empresas. Na segunda aba devem ser registradas quais empresas farão parte de cada grupo de empresas.

[4.4.5] Atualizar o link de acesso à F01521 em painéis de navegação configurados na empresa de atenção domiciliar no contexto do Home Care (HC)

A figura a seguir ilustra o painel de navegação padronizado da Incoway com os links de acesso aos indicadores de desempenho relacionados aos contextos HC:

Notem abaixo do tópico “Indicadores de Desempenho” dois ícones : “Configurações” e “Indicadores H. Care”.

Ícone Configurações

Quando clicamos sobre o ícone “Configurações” o IW irá abrir um popup menu com as seguintes opções:

[1] Cfg Variáveis p/ Gráficos
[2] Cfg Relat. Avançados
[3] Cfg Faixas de Valores

Esses tópicos são globais a todos os contextos de indicadores abrangidos pelo IW (contas médicas, abordagem inicial, monitoramento e home care). A seguir descrevemos como configurar esses itens de navegação no IW:


[4.4.5.1] Configurando item “[1] Cfg Variáveis p/ Gráficos”

Essa interface oferece as funcionalidades descritas no tópico (Organizador variáveis para apresentação gráfica).

Parâmetros do link de lançamento:

Nome Transação: [0] Cfg Variáveis p/ Gráficos
IHM Execução: com.iw.visualLayer.application.IwFormStartEditDialog
Parâmetros: |GLBVARIABLESEQ|TABLENAME,SEQ||||||||||||


IMPORTANTE :

(a) Após realizar essa configuração , lançar a interface na instalação do cliente e copiar a tradução do gride a partir do banco matriz de origem.
(b) Exportar o cadastro do organizador de variáveis para gráficos na base de dados de referência (origem da cópia) e importar na base de dados do cliente (destino da cópia).

[4.4.5.2] Configurando item “[2] Cfg Relat. Avançados”

Parâmetros do link de lançamento:

Nome Transação: [1] Cfg Relat. Avançados
IHM Execução: com.iw.visualLayer.application.IwFormStartEditDialog
Parâmetros : |IFRREPORTINDICATOR|TABLENAME||||||||||||

IMPORTANTE :

(*a) Após realizar essa configuração , lançar a interface na instalação do cliente e copiar a tradução do gride a partir do banco matriz de origem.
(*b) Caso os relatórios avançados não tenham sido publicados na base do clientes : deve-se acessar o servidor de relatórios do IW (dbIwIncoway) e realizar a cópia desses relatórios para base do cliente
(*c) Deve-se cadastrar os relatórios avançados x contexto na base do cliente utilizando a interface esse link de menu ([1] Cfg Relat. Avançados).


Sobre o item (*b) acima: A imagem a seguir ilustra os relatórios avançados na base dbIwIncoway a serem publicados na base do cliente:

IMPORTANTE:

(a) Antes de acessar o servidor de relatórios da Incoway : certifique-se de que a constante denominada K_IFR_REPORT_MODULE esteja corretamente atualizada na base do cliente.
(b) Acesse o servidor de relatórios da Incoway ticando o check box denominado “Servidor Incoway” no canto superior da interface ilustrada acima.
(c) Filtre os relatórios por “Módulo Relatório” = 160 – Indicadores [F01521] conforme ilustrado acima.
(d) Selecione cada um relatório a ser copiado e clique no botão “Copiar do Servidor Incoway” conforme ilustrado acima. Repita esse passo para cada um dos relatórios a serem copiados para a base do cliente.


Sobre o item (*c) acima: Lance a interface [1] Cfg Relat. Avançados e edite os id´s dos relatórios avançados valorando-os com os id´s dos que os respectivos relatórios avançados adquiriram na base do cliente. A imagem a seguir ilustra essa edição:

[4.4.5.3] Configurando item “[3] Cfg Faixas de Valores”

Nome Transação: [1] Cfg Relat. Avançados
IHM Execução: com.iw.visualLayer.application.IwFormStartEditDialog
Parâmetros : |TDWD_FAIXAS_VALOR|||||||||||||


IMPORTANTE :
(a) Após realizar essa configuração , lançar a interface na instalação do cliente e copiar a tradução do gride a partir do banco matriz de origem. Nota: Essa interface faz uso da constante K_TDWD_TIPO_FAIXAS_VALOR. Certifique-se de que essa constante já existe na base do cliente caso contrário , utilize a interface F0043 para realizar a copia dessa tabela para a base do cliente.

(b) Certifique-se se a tabela TDWD_FAIXAS_VALOR já existe na base de dados do cliente. Caso não exista utilize a interface F0043 para realizar a copia dessa tabela para a base do cliente.




Ícone Indicadores H. Care

[4.4.5.4] – Configurando a opção de popup “Indicadores Home Care”


Utilize a mesma parametrização indicada no item [4.4.3].




[4.4.5.5] – Copiando a tradução do gride da interface F01521 para a base do cliente

Após fazer a configuração do links de menu e painéis de lançamento da interface F01521 proceda o lançamento da F01521 na base do cliente e faça a tradução do gride da primeira aba na base do cliente tomando como origem da cópia a base dbIwIncoway.

A figura a seguir ilustra a primeira aba da F01521 no contexto de indicadores HC:

Nesse exemplo clicamos com o botão direito do mouse sobre o cabeçalho do gride para visualizarmos o “índice” do gride da primeira aba da F01521 na base de dados do cliente. Anote o valor exibido no campo “Índice” (nesse exemplo = 4877). Faça a mesma navegação (lance a interface F01521 no contexto HC) no banco de referência (dbIwIncoway) e anote o valor esse “índice” na base de referência (origem da cópia de tradução).

Para realizar a cópia da tradução desse gride para a base do cliente utilize a interface F00043 ilustrada abaixo:

No campo “índice de origem valore com valor do “índice” na base de referência (origem da cópia) e no campo “Índice destino” , onde está valorado com <cli> na ilustração acima valore com o “índice” do gride da primeira aba da F01521 na base do cliente (no nosso exemplo : 4877).

A figura a seguir ilustra o gride da primeira aba da F01521 já após a cópia da tradução:

[4.4.5.6] – Configurando a opção “Cfg. Regras Filtro Genérico”

A figura a seguir ilustra a parametrização para esse link:

Nome da transação: Cfg. Regra Filtro Genérico
Classe: com.iw.visualLayer.application.IwFormStartEditDialog
Parâmetros: |TDIND_TRIAG_HC|||||||||||||

Esse link irá lançar a interface que permite configurar critérios de filtragem de pacientes monitorados com base em padrões de valoração das variáveis clínicas armazenadas através dos templates de evolução clínica dos pacientes. A figura a seguir ilustra essa interface:

[4.4.6] – Copiando as funções de cálculo dos indicadores no contexto HC

Para realizar a cópia das funções (java) que realizam os cálculos dos indicadores propriamente ditos acesse novamente a interface F00043 ilustrada abaixo:

IMPORTANTE: Lembre-se de , no campo de cabeçalho dessa interface, se logar na base de referência (origem da cópia : dbIwIncoway). Ative a caixa de checagem denominada “Cbr”. No campo denominado “ID Origem” informe o ID do template de apresentação dos indicadores no contexto HC na base de referência (dbIwIncoway) que corresponde ao id = 401. No campo denominado “ID Destino” (que na ilustração acima está valorado com <id>) informe o ID do template de exibição dos indicadores da Abordagem Inicial na base do cliente.

Em seguida clique no botão “Substituir”. O IW irá transferir os fontes (java) das funções de cálculo dos indicadores da base de origem da cópia (cuja url está sendo apresentada no cabeçalho da tela) para a base de dados do cliente.

Nota Técnica: Se por ventura já existirem funções java de cálculo de indicadores na base do cliente (antes da efetivação da cópia) IW não irá remover verdadeiramente as funções antigas (essas funções continuarão presentes na base do cliente). Na verdade o IW irá desassociar as funções antigas do ID template de apresentação dos indicadores no contexto HC e irá associar as novas funções que acabaram de ser importadas a esse template. Isso fará com que a partir desse momento as novas funções sejam gatilhadas para o cálculo dos indicadores no contexto HC na interface F01521.

[4.4.7] – Publicar os links de chamadas das funções de filtragem de pacientes / relatórios

Estando na interface F01521 no contexto dos indicadores HC na base de dados de referência (dbIwIncoway), navegue para a aba “seleção de pacientes” ilustrada abaixo:

Nessa interface clique no botão denominado “Seleção”. O IW irá abrir a caixa de diálogo F01456 ilustrada abaixo:

Deve-se copiar todos os registros do banco matriz de origem da cópia (dbIwIncoway) para o banco do cliente destino.

A imagem abaixo colocamos o gride na forma vertical para observamos as colunas existentes nesse gride:

IMPORTANTE : Cadastre os valores de todas as colunas exatamente igual aos valores da base de origem da cópia, com exceção da coluna denominada “ID Função”. Para cada linha cadastrada na base do cliente, essa coluna deverá ser valorada com o ID da respectiva função na base de dados do cliente. Para descobrir o ID de cada função na base do cliente acesse a primeira aba da F01521 no contexto de indicadores HC na base do cliente e clique no botão denominado “Editar Funções”. O IW irá lançar a interface F00153 que ilustramos mais a frente.

Faça uma pesquisa filtrando por “Nome” (trata-se do nome da função). O nome da função é o texto que aparece entre colchetes no conteúdo do campo “Descrição”. No exemplo ilustrado acima o nome da função é “FILT_HC”. Nota: Ao realizar a filtragem pelo nome da função na F00153 lembre-se de limpar o campo “Tipo CBR” para não ter interferência no filtro. IMPORTANTE: O campo IDREFERENCE deverá estar valorado para termos certeza que estamos pesquisando funções cadastradas somente no contexto correto).

A figura a seguir ilustra o resultado desa operação : IMPORTANTE: Navegação realizada na base de dados do cliente (para obtenção do ID da função nessa base).

Anote o ID da função exibido na primeira coluna do gride na F00153 (nesse exemplo = 479) e lance esse valor na coluna denominada “ID Função” para cada linha cadastrada na base do cliente através da interface F001456. Após essa edição no nosso exemplo o cadastro na F01456 na base do cliente ficaria sendo : >

[4.4.7.1] - Copiar as traduções dos grides de prompt e grides de retorno das funções relatórios e publicação dos relatórios de grides de retorno

(a) Para efetivar a tradução dos grides de prompt de execução das funções de filtragem/relatórios.

Para efetivar a tradução do Gride de prompt : Utilize a interface F00043 fazendo a cópia da tradução do gride prompt da seguinte forma :

Formid = 1456 com keyindex de origem = ao -ID (sinal de menos seguido do ID) no registro no gride da base matriz de origem e keyindex de destino = -ID (sinal de menos seguido do ID) da linha no gride da base do cliente.

A figura abaixo exemplifica essa operação: Lembre-se de logar na url da base de referência (dbiwIncoway) no cabeçalho da F00043. Valore Formid = 1456, Índice (origem) = -ID na base de referência (no nosso exemplo = -5796) e valore o campo “Índice destino” = -ID do registro que foi inserido na base de dados do cliente na F01456, ou seja, substitua expressão <id> na figura abaixo pelo ID correto na base do cliente e clique no botão “Substituir” (nosso exemplo = -1429).

(b) Tradução dos grides de retorno das funções tipo “relatórios”

IMPORTANTE: Aplicável somente a funções de “Relatórios”, ou seja, para funções de filtragem essa tradução não necessita ser realizada).

Para efetivar a tradução do Gride de retorno : Utilize a interface F00043 fazendo a cópia da tradução do gride prompt da seguinte forma :

Formid = 1456 com keyindex de origem = ao ID no registro no gride da base matriz de origem e keyindex de destino = ID da linha no gride da base do cliente.

Ou seja, o processo para copiar a tradução dos grides de retorno dos dados dos relatório é basicamente o mesmo descrito no tópico (a) anterior bastando “retirar o sinal de menos” antes dos valores dos ID´s nos campos “Índice (origem)” e “Índice destino”.

(c) Publicando os relatórios configurados sobre os grides de retorno

IMPORTANTE: Aplicável somente a funções de “Relatórios”, ou seja, para funções de filtragem essa comfiguração não necessita ser realizada).

Nota técnica: Para executar essa atividade devemos ter em mente que : o gride de retorno no qual o IW irá exibir os dados do relatório estarão posicionados debaixo do formid = 1456 e terão “índice do gride” igual ao ID do gride que aparece na pesquisa na interface F01456. A figura a seguir ilustra novamente a interface F01456:

Na figura acima a informação que aparece na coluna ID (nessa imagem = 3985) seria igual ao “Índice” do gride de retorno de dados para relatório.

Publicando o relatório propriamente dito:

(I) Tendo em mente o conceito explicado na nota técnica acima, para publicar os relatórios desejados na base de dados do cliente vamos utilizar as funcionalidades da interface F00044 – Configurar relatórios SQL. Vamos acessar a base de referência “dbIwIncoway” localizar o relatório a ser copiado (formid = 1456 e key index = ao ID da função do relatório no gride da F01456 na base dbiwIncoway). Vamos exportar esse relatório para um arquivo (extensão .xml).

(II) Em seguida vamos acessar a base de dados do cliente, lançar a interface F00044 e vamos cadastrar um novo relatório sob o formid = 1456 e key index = ao ID da função do relatório no gride da F01456 na base de dados do cliente. Em seguida vamos utilizar a transação “importar” e informando o arquivo .xml gerado no passo (I).