Cadastro de Interações Medicamentosas

O IW realiza o processamento de interações medicamentosas no momento da “liberação de prescrições médicas” no prontuário do paciente. Para isso as interações medicamentosas entre “fármacos” (sal) devem ser previamente cadastradas ou importadas (mediante aquisição no mercado de um cadastro de interações medicamentosas).

O cadastramento / visualização das interações medicamentosas cadastradas no IW se dá através da interface F01567 que ilustramos abaixo:


A figura a seguir ilustra a mesma interface no modo de exibição em “fichário” para facilitar a visualização dos atributos que fazem parte do cadastro das interações medicamentosas:


Descrição dos Atributos

Sal 1, Sal 2, Sal 3 e Sal 4: Esses atributos devem ser valorados com nomes de fármacos(sais) puros. Ou seja, não devemos ter “combinações de sais” nesse atributo. Tipicamente esses atributos são configurados como caixas de seleção (combo box) que são automaticamente populados com a “extração da relação de todos os fármacos cadastrados no SCC do IW” no tipo “Medicamentos”. Apenas o campo “Sal 1” é obrigatório. Nos casos em que formos cadastrar a interação medicamentosa entre “dois fármacos” vamos preencher somente os campos “Sal 1” e “Sal 2” (nesse caso a ordem dos fármacos é irrelevante: ex.: cadastrar interação medicamentosas entre “Acido Acetilsalicilico” e “Digoxina” poderá ser cadastrado tanto como: Sal 1 = Acido Acetilsalicilico e Sal 2 = Digoxina ou, Sal 1 = Digoxina e Sal 2 = Acido Acetilsalicilico. Em ambas as formas de cadastramento o IW irá reconhecer e tratar corretamente a detecção e exibição da interação medicamentosa). Analogamente: pode-se cadastrar interações medicamentosas entre combinações de 3 fármacos (nesse caso serão valorados os atributos Sal 1, Sal 2 e Sal 3) ou até combinações de 4 fármacos (nesses casos serão valorados todos os atributos de sal: Sal 1, Sal 2, Sal 3 e Sal 4). Nota: Tipicamente para efetivar o cadastramento de interações de um fármaco com “alimentos” realiza-se um cadastramento valorando somente o atributo “Sal 1” e cita(m)-se o(s) alimento(s) que deve(m) ser evitado(s) textualmente nos campos “Orientações” e “Descrição da Interação”. 

Nota Técnica: O IW irá popular as respectivas caixas de seleção com a relação dos fármacos distintos cadastrados no SCC no momento do lançamento da interface. Portanto, para que novos fármacos que venham a ser cadastrados no SCC após o lançamento da interface F01567 na sua sessão de trabalho sejam vistos nas respectivas caixas de seleção será necessário fechar e relançar a tela F01567 no IW.


IMPORTANTE:

[a] A valoração dos nomes dos fármacos (sais) no cadastramento dos medicamentos no SCC do IW segue uma padronização na qual medicamentos compostos por mais de um sal terão os nomes dos mesmos cadastrados utilizando-se um dígito separador (configurado no parâmetro global “SCC_MEDICAMENT_SEPARATOR”). Para popular as caixas de seleção dos atributos Sal1, Sal2, Sal3 e Sal4 o IW fará a decomposição dos nomes dos fármacos referenciados em todo o universo de medicamentos cadastrados. Exemplo: Um medicamento que faz a combinação de “Clavulanato de Potassio \ Amoxicilina” será decomposto em dois fármacos separados “Clavulanato de Potassio” e “Amoxicilina”.

[b] - Notem que deve haver identidade na forma como o fármaco foi cadastrado no SCC do IW e a forma como o fármaco está digitado no cadastro das interações medicamentosas. Nos casos em que ocorrer o cadastramento das interações medicamentosas diretamente através da interface F01567, no momento do cadastramento essa garantia será automática, posto que a edição desse campo e realizada através da seleção entre lista de opções capturadas diretamente do SCC do IW. Já nos casos em que a empresa adquirir um cadastro de interações medicamentosas no mercado deve-se tomar o cuidado de compatibilizar o cadastro dos fármacos no SCC com a forma como os fármacos estarão dispostos no cadastro de interações adquirido do mercado.

[c] – Em algumas empresas ocorrerá a contratação de uma empresa especializada para elaborar o cadastramento das interações medicamentosas. Algumas empresas fornecem o cadastro em formatos eletrônicos a serem carregados no IW ou mesmo em formato de Script de banco de dados para alimentação direta da tabela.

Risco: Classificação do risco da interação medicamentosas. Esse atributo é uma caixa de seleção cujo domínio de valores é ditado pela constante denominada “K_MAT_MED_INTERACT_RISK”. Para usuários administradores no IW ou usuários que tenham direito à edição sobre essa constante o IW irá exibir uma opção <edit> na caixa de seleção. Se clicarmos nessa opção <edit> o IW irá lançar a caixa de diálogo F00128 através da qual será possível editar o domínio de valores da “classificação do risco da interação medicamentosa”.


Conforme pode ser visualizado na figura acima o IW no seu modo default parte configurado com três alternativas para a classificação do risco da interação medicamentosa: “Menor”, “Moderado” ou “Severo”.

Orientações: Trata-se de um campo texto (descritivo) contendo orientações para o médico prescritor sobre a interação medicamentosa.

Descrição da Interação Medicamentosa: Trata-se de campo texto (descritivo) contendo informações de cunho mais técnico sobre a interação entre os fármacos.




Processando as Interações Medicamentosas no Contexto de Edição de Prescrições Médicas

O IW está preparado para processar as interações medicamentosas de forma automatizada no contexto de “liberação de prescrições médicas”. Para que o processamento das interações medicamentosas seja ativado deve comutar o parâmetro global (acessível através da interface 151) denominado CAP_ACTIVATE_INTER_MEDIC para o valor 1 . Quando ativamos esse parâmetro, a partir do próximo login realizado no sistema por qualquer usuário o IW passará a efetivar o processamento automatizado das interações medicamentosas sempre que for realizada a transação de “liberação de qualquer prescrição médica”.

A figura a seguir ilustra o painel de prescrição médica do prontuário eletrônico onde se dá o contexto de edição e liberação de prescrições médicas:

 

Uma imagem contendo Linha do tempo

Descrição gerada automaticamente

Uma vez que se tenha editado uma prescrição médica a liberação da mesma deverá ser feita através do botão “Liberar” ilustrado acima. Quando clicarmos nesse botão o sistema fará a análise da prescrição médica procurando pela presença das combinações de fármacos declarados no banco de regras de interações medicamentosas. Todas as combinações de fármacos para as quais exista documentação de relato de interação medicamentosa será exibida para o profissional que estiver operando o sistema (tipicamente a liberação da prescrição médica no prontuário eletrônico é realizada on-line pelo próprio médico responsável pelo paciente no atendimento domiciliar).

A figura a seguir a caixa de diálogo emitida pelo sistema:

Interface gráfica do usuário

Descrição gerada automaticamente com confiança média

Para executar uma leitura sistematizada das interações medicamentosas recomenda-se utilizar o modo fichário (execute um duplo clique com o botão esquerdo do mouse sobre a linha de cabeçalho do gride) e com extensão dos campos descritivos (aperte a tecla shift (esquerda no teclado) e execute um clique simples com o botão esquerdo do mouse sobre o cabeçalho do gride. A figura a seguir o resultado dessas operações sobre o gride:

Interface gráfica do usuário, Aplicativo, Email

Descrição gerada automaticamente

Clique nos botões situados à esquerda do gride vertical ilustrado acima para navegar pelos registros das interações medicamentosas capturadas entre os fármacos prescritos para o paciente .

Botão: “<<”: recuar para a primeira interação medicamentosa

Botão: “<”: recuar para a interação medicamentosa anterior

Botão: “>”: avançar para a próxima interação medicamentosa

Botão: “>>”: avançar para última interação medicamentosas

 

Conforme pode ser observado na ilustração acima cada registro de interação medicamentosa irá exibir para o médico prescritor as seguintes informações:

(a) A relação dos fármacos que apresentam a interação medicamentosa.

(b) A classificação do risco da interação medicamentosa.

(c) As orientações para o profissional responsável pela prescrição a respeito da interação medicamentosa.

(d) A descrição técnica do mecanismo da interação medicamentosa.

Diante das informações referentes às interações medicamentosas o médico prescritor terá duas alternativas possíveis:

·         [1]: Clicar no botão “Estou ciente das recomendações apresentadas” e dar prosseguimento na transação de liberação da prescrição médica ou

·         [2]: Cancelar a liberação da prescrição e retornar para a edição da mesma procedendo eventuais ajustes que julgar apropriados.

As interações medicamentosas exibidas para o profissional que executou a liberação da prescrição médica ficam gravadas (anexadas) ao prontuário eletrônico do paciente vinculadas a “cada prescrição médica” que venha a ser liberada. Observem que no painel de prescrições médicas, na segunda aba (ilustrada mais acima) existe um botão denominado “Interações”. Clique nesse botão para fazer uma pesquisa do conteúdo das interações medicamentosas exatamente como elas foram apresentadas para o profissional no momento da liberação da prescrição médica.

Ou seja: ser o cadastro das interações medicamentosas venha a ser atualizado recebendo relatos de novas interações medicamentosas esses novos registros não influenciam o conteúdo das informações que ficaram anexadas ao prontuário eletrônico de cada paciente “antes do seu cadastro no banco de interações medicamentosas”. As próximas prescrições médicas que venham a ser liberadas no sistema futuramente, estas sim , passarão a receber a citação do novo relato de interação medicamentosa.

 



Importando um Cadastro de Interações Medicamentosas

O IW possui driver´s de leitura nativos para leitura de cadastros de interações medicamentosas dispostos em arquivos .txt com o seguinte layout:

Nome do Campos

Tipo dado

Obrigatório

Nro max caracteres

Comentário

1

Sal 1

texto

Sim

150

Vide regras sugeridas de padronização para grafia de nomes de fármacos (**)

2

Sal 2

texto

não

150

Vide regras sugeridas de padronização para grafia de nomes de fármacos (**)

3

Sal 3

texto

não

150

Vide regras sugeridas de padronização para grafia de nomes de fármacos (**)

4

Sal 4

texto

não

150

Vide regras sugeridas de padronização para grafia de nomes de fármacos (**)

5

Risco

integer

Sim

-

Convenção de valores (***):
0 Menor
1 Moderado
2 Severo

(***) Essa convenção de valores poderá ser alterada pela empresa de atenção domiciliar

6

Orientações

texto

Sim

4000

Campo texto livre

IMPORTANTE: Não deve haver caracteres de quebra de linhas dentro desse texto

7

Descrição da Interação

texto

Sim

4000

Campo texto livre

IMPORTANTE: Não deve haver caracteres de quebra de linhas dentro desse texto

 

Nota: Comumente solicite ao fornecedor do arquivo que coloque na primeira linha do arquivo os “nomes das colunas” para deixar o arquivo documentado e auto explicativo.


IMPORTANTE
: Cada registro de interação medicamentosa deve estar contido em uma única linha no arquivo .txt.

(**) Sugestão de Regras para Cadastramento de Nomes de Fármacos no SCC

1.      Cadastrar os fármacos no idioma português utilizando padrão tipicamente observado em embalagens de medicamentos: Exemplo: “Cloridrato de Cefepima”. Utilizar primeira letra de cada palavra maiúscula e demais minúsculas
Evitar notação científica como: “Cefepima, cloridrato”

2.      Nos casos de cadastramentos de medicamentos que são na verdade associações de fármacos: Utilizar os nomes dos fármacos separados por “/”. Exemplo: “Dipropionato de Betametasona / Sulfato de Gentamicina” , “Amoxicilina / Clavulanato de Potassioetc Importante O dígito separador entre nomes de fármacos é determinado pelo parâmetro global denominado SCC_MEDICAMENT_SEPARATOR. Nesses exemplos o parâmetro SCC_MEDICAMENT_SEPARATOR deverá estar valorado com “/”.

3.      Cadastramento de vitaminas apresentadas em forma isolada: Cadastrar o nome do sal seguido da abreviatura da vitamina. Exemplo: Acido Ascorbico (Vit C) , Cianocobalamina (Vit B12) etc.

4.      Cadastramento de medicamentos com associações de diversas vitaminas: Utilizar forma abreviada separada por “/”. Exemplo: Vit A / Vit D / Vit B2 / Vit C / Niacinamida / Vit B6 / Pantenol / Vit E

(**) No cadastro das interações medicamentosas cada fármaco deverá estar isolado, ou seja, nos atributos Sal1 a Sal4 não deveremos ter combinações de fármacos.

IMPORTANTE: As regras sugeridas acima são somente recomendações padronizadas pela Incoway. Essas regras são seguidas pelo cadastro default de medicamentos que é utilizado como ponto de referência de partida nas instalações do IW. Contudo, cada empresa de atenção domiciliar possui o seu padrão próprio formalizado que poderá convergir ou divergir das premissas adotadas pela Incoway. Fundamentalmente, ao adquirir um cadastro de interações medicamentosas no mercado a empresa de Atenção Domiciliar (que utiliza o IW) deverá interagir com o fornecedor desse cadastro no sentido de compatibilizar o padrão de grafia dos nomes dos fármacos para que o processamento da análise combinatória das interações medicamentosas possa funcionar corretamente.

 

Configurando o Driver de Leitura do Cadastro de Interações Medicamentosas (arquivo .txt)

Para configurar o driver de leitura do arquivo .txt no la/ yout padronizado detalhado acima, acesse a interface F00161 (menu- Administrador – (12 ) Importar / Exportar – (1) Importar de Arquivo). A figura a seguir ilustra essa interface:


Clique na caixa de seleção denominada “Driver – Leitura Arquivo” situada no canto superior esquerdo da interface e acione a opção <edit>. O IW irá lançar a interface F01049 que permite consultar e inserir novos driver´s de leitura. Clique no botão “Novo” e valore as colunas no gride conforme ilustrado abaixo:


Nome : Informe um nome para o driver de leitura a seu critério. Ex.: Cad_Interacoes_Medic
Nome Tabela: Selecione a tabela
GLBMATRISKINTERACT
Diretório: Informe um nome para o diretório que será criado no servidor de aplicações do IW. Nota: Esse diretório será criado automaticamente pelo próprio IW no momento que esse driver for acionado pela primeira vez. Ex.:
Cad_Interacoes_Medic
Descrição: Informe uma descrição textual sobre a funcionalidade do driver (a seu critério)
Tipo Importação: Selecione a opção “
Arquivo
Connection String: Deixe esse campo em brando (esse campo é usado somente para driver´s de leitura de banco)
Comando SQL: Deixe esse campo em brando (esse campo é usado somente para driver´s de leitura de banco)

Valore as colunas conforme descrito acima e clique no botão “Salvar”. Em seguida feche a interface F00161 e lance-a novamente. A figura a seguir ilustra o resultado dessa operação:


Notem que agora nas opções de driver´s de leitura previamente cadastrados irá aparecer o novo driver que acabamos de cadastrar “Cad_Interacoes_Medic”. Selecione esse driver e clique no botão “Pesquisar” (nesse momento o iw irá criar o diretório no qual o arquivo deverá ser posicionado no servidor de aplicação do IW.

Navegue para a aba denominada “Arquivo de Configuração” e copie e cole os seguintes comandos de configuração do driver (grafados em fonte itálico apenas para melhor distinção dos comandos):

StartLine=2
FileName=*.txt
SkipError=True
Trace=On
# ATENCAO: O comando a seguir irá deletar (limpar) o cadastro previamente existente de interações medicamentosas.
# Caso seja desejado preservar os cadastros previamente existentes comente esse comando
SqlBefore=delete from GLBMATRISKINTERACT
#
#
MATERIALNAME1|MATERIALNAME1|150|<DefaultValue>|<Format>|<ListValue>
MATERIALNAME2|MATERIALNAME2|150|<DefaultValue>|<Format>|<ListValue>
MATERIALNAME3|MATERIALNAME3|150|<DefaultValue>|<Format>|<ListValue>
MATERIALNAME4|MATERIALNAME4|150|<DefaultValue>|<Format>|<ListValue>
Risco|RISK|<ColumnSize>|<DefaultValue>|<Format>|<ListValue>
Descrição|DESCRIPTION|4000|<DefaultValue>|<Format>|<ListValue>
Instruções|INSTRUCTIONS|4000|<DefaultValue>|<Format>|<ListValue>

Em seguida clique no botão “Salvar”. A figura a seguir ilustra o resultado dessa operação:


Nota: O comando startline=2 instrui o IW a começar o processamento do arquivo a partir da segunda linha (considerando que na primeira linha estarão os nomes das colunas).

Nesse momento o driver já está pronto para ser utilizado. Para realizar a carga propriamente dita do cadastro de interações medicamentosas siga os seguintes passos:

(a) Posicione o arquivo .txt contendo o cadastro das interações medicamentosas no diretório :

D:\iw\import\Cad_Interacoes_Medic\GLBMATRISKINTERACT

Nota: Em algumas instalações do IW é possível que o diretório de origem do path do arquivo seja C ao invés de D.

(b) Após posicionar o arquivo corretamente no diretório indicado, lance novamente a interface F00161 e selecione o driver “Cad_Interacoes_Medic” e clique no botão “Pesquisar”. Nesse momento o IW deverá apresentar no gride da primeira aba da F00161 uma amostragem do arquivo (algumas linhas devidamente posicionadas nas suas respectivas colunas). Importante: Inspecione essa amostragem para certificar de que os campos estão corretamente posicionados nas suas respectivas colunas.

(c) Clique no botão “Importar” : Nesse momento o sistema irá lançar a caixa de diálogo F00159 que ilustramos abaixo:


Para iniciar o processamento da carga do arquivo ative a opção “Aguardar o fim da execução” e clique no botão “Executar”.

IMPORTANTE: Dependendo do tamanho do arquivo a ser carregado essa operação poderá ser demorada. Tempos típicos giram em torno de poucos minutos (10 a 20) mas esse tempo irá depender de velocidade dos servidores, carregamento no uso do sistema como um todo etc. É recomendável executar esse tipo de processamento em horários que de baixa utilização para não comprometer a responsividade para os usuários que estiverem utilizando o IW em regime de produção. Nos casos de empresas que possuem servidores de contingência pode ser uma boa alternativa configurar o driver para rodar no servidor de contingência (para isso faça todos os passos descritos para a configuração do driver acessando o IW na URL do servidor de contingência: agindo dessa forma o diretório para posicionamento do arquivo para carga será criado no servidor de contingência).




Modelo de Dados

 

Tabela: GLBMATRISKINTERACT

Coluna

Descrição

Tipo

ID

Identificador unívoco gerado automaticamente pelo IW

Number (9,0)

MATERIALNAME1

Corresponde ao atributo Sal1

VARCHAR2(150)

MATERIALNAME2

Corresponde ao atributo Sal2

VARCHAR2(150)

MATERIALNAME3

Corresponde ao atributo Sal3

VARCHAR2(150)

MATERIALNAME4

Corresponde ao atributo Sal4

VARCHAR2(150)

RISK

Classificação do risco associado à contante IW: K_MAT_MED_INTERACT_RISK
0        Menor
1        Moderado
2        Severo

NUMBER(5,0)

DESCRIPTION

Descrição da interação

VARCHAR2(4000)

INSTRUCTIONS

Orientações sobre a interação

VARCHAR2(4000)