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
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:
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:
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:
Nº |
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 (***): |
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 Potassio” etc 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 |
NUMBER(5,0) |
DESCRIPTION |
Descrição
da interação |
VARCHAR2(4000) |
INSTRUCTIONS |
Orientações
sobre a interação |
VARCHAR2(4000) |