Escolar Documentos
Profissional Documentos
Cultura Documentos
Documentos - Versão
02.049
Manual do Editor de Documentos - Versão 02.049
Sumário
O que há de novo?
Este documento apresenta as informações referentes às implementações e melhorias realizadas para
a versão 02.049. Essas informações foram revisadas e, quando adequado, incorporadas a esta nova
versão do manual.
Criada regra que reprocessa as ações dos campos que têm a propriedade "Reprocessar", exceto
para o campo do tipo "ComboBox", marcados no momento de carregar o registro.
Para o tipo de campo "Imagem", é possível buscar as imagens digitalizadas, quando a coluna na
tabela for "long raw".
Na lista de valores do campo "ComboBox", é possível efetuar pesquisa utilizando apenas parte do
texto a ser pesquisado.
Navegação básica
Acessando o sistema
A tela abaixo é apresentada ao acessar o sistema. Para utilizá-lo, é necessário efetuar o login,
informando seu usuário e senha. No rodapé desta tela, pode-se também visualizar a versão em que o
sistema se encontra e um link para o Manual do Usuário.
Legenda
Versão do sistema;
Estrutura do sistema
O sistema é composto pelas abas "Campos" e "Documentos", por meio das quais são criados
campos/metadados e elaborados as telas e os relatórios que serão utilizados no Prontuário Eletrônico
do Paciente a partir da versão 2.0. Abaixo está ilustrada a estrutura básica do sistema, que será
explicada com maior detalhe ao longo do manual.
Botões do sistema
Neste sistema, são apresentados alguns botões comuns os quais serão descritos abaixo:
Este botão, ao ser acionado, recolhe as pastas que estejam abertas nas abas
"Campos" e "Documento". Ressaltando que, serão recolhidas as pastas da aba onde
esse botão for acionado;
Este botão, ao ser acionado, copia os registros realizados em um campo para que
possa ser colado em um grupo;
Este botão, ao ser acionado, possibilita que o usuário importe dados de um cadastro
realizado no Editor de Documentos;
Este botão, ao ser acionado, possibilita que o usuário exporte os dados cadastros
no Editor de Documentos. Dessa forma, possibilita que os parâmetros configurados
para um determinado documento, sejam compartilhados entre os interessados;
Poderão ser liberadas atualizações para a correção de erros encontrados no sistema. Para realizar
essa atualização, o usuário deverá acionar o botão . Dessa forma, será exibido um pop-up com
todas as atualizações disponíveis para aquela versão.
O usuário deverá marcar o check box da atualização que deseja realizar ou marcar o check box o
cabeçalho do pop-up para que todas as atualizações disponíveis sejam marcadas e depois acionar o
Sobre o produto
Esta ferramenta foi especialmente desenvolvida para possibilitar a construção de documentos
eletrônicos que serão utilizados pelos médicos, enfermeiros e técnicos de enfermagem no sistema de
Prontuário Eletrônico do Paciente versão 2.0. Ela propicia que a criação desses documentos seja
realizada de maneira rápida, eficaz e uniforme, já que um único campo criado poderá ser utilizado em
mais de um documento.
Finalidade
Funcionalidades
Para construir documentos dentro da ferramenta Novo Editor, são necessárias algumas ações:
Criar os campos;
Criar o documento;
Sistemas relacionados
Neste sistema, todos os documentos eletrônicos criados poderão ser utilizados na aplicação:
Aba "Campos"
Repositório de campos
Text e TextArea
Comb oBox
Imagem
CheckBox
RadioButton
Data
Botão
Marcação de imagem
Código de b arras
Módulos
N/A
Função da tela
Pré-requisitos
Configurações
Como usar
O repositório de campos está dividido em Repositório Local e Repositório MV. O primeiro serve para
agrupar os campos criados pelo usuário, enquanto o segundo agrupa uma série de campos que é
disponibilizada pela MV na instalação do sistema. Não é possível fazer alterações diretamente nesses
dois repositórios, somente no seu conteúdo. Quando um desses dois repositórios está selecionado,
os ícones existentes na parte superior da tela ficam desabilitados.
Desse modo, na criação de campos, o usuário deve somente utilizar a pasta Repositório Local.
Legenda
Botões desabilitados.
A descrição do grupo é definida automaticamente pelo sistema respeitando uma sequência pré-
estabelecida. Para alterar essa descrição, ir na aba "Propriedades" e modificá-la para uma
descrição de sua preferência.
A descrição do subgrupo é definida automaticamente pelo sistema respeitando uma sequência pré-
estabelecida. Para alterar essa descrição, ir na aba "Propriedades" e modificá-la para uma
descrição de sua preferência.
Cadastro de campos
Depois da criação do grupo e do subgrupo, são criados os campos (metadados). Para tanto,
Antes de criar um novo metadado, é importante verificar se já existe algum criado com as
mesmas características do campo desejado. Uma vez que o mesmo metadado pode ser
utilizado em vários documentos.
Automaticamente é criado um campo com uma descrição padrão, que segue uma sequência pré-
estabelecida;
Na aba "Propriedades", devem ser definidas as propriedades do campo de acordo com o tipo
escolhido. As propriedades para cada tipo escolhido serão detalhados abaixo:
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Usado em: neste campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Valor inicial: o valor inicial que o campo deverá apresentar. Essa opção é preenchida caso o
usuário deseje que o campo venha preenchido com alguma informação;
Ação: Uma ação é utilizada para os casos em que o preenchimento do campo será resultado da
execução de um script no banco de dados. Por exemplo, se o usuário deseja que o campo retorne
o nome do paciente, ao clicar na propriedade "Ação", é apresentada uma janela onde deve ser
inserido o script: SELECT
Fnc_Editor_Retorna_Metadados(&<PAR_CD_ATENDIMENTO>,'NM_PACIENTE') from dual. É
necessário que exista um parâmetro que permita a busca dessas informações através da
execução do script. Os parâmetros estão definidos na pasta "Parâmetros";
Para facilitar a seleção dos parâmetros, todos os existentes são listados na opção "Parâmetros".
Basta clicar no parâmetro desejado e arrastá-lo para a caixa onde deve ser digitada a ação;
Para validar a instrução SQL clicar em . Na aba "Resultado", irá retornar o resultado
Utilizar texto padrão: se o campo em questão utiliza um texto padrão. Caso essa propriedade
seja marcada, é necessário clicar na propriedade "Lista de Valores do Texto Padrão" para indicar
as opções padrão que serão utilizadas nesse campo;
As opções inseridas poderão ser pesquisadas pelo campo "Pesquisar", facilitando quando houver
muitas opções;
Caso deseje restringir alguma informação do texto padrão, é necessário clicar na propriedade
"Parâmetros do Texto Padrão" e escolher o parâmetro de restrição. Por exemplo, caso seja
escolhido o parâmetro do código do usuário, o que for cadastrado como texto padrão, somente
será visualizado pelo usuário em questão;
Ação do texto padrão: caso deseje que o texto padrão seja resultante de uma ação, é
necessário clicar na propriedade "Ação para texto padrão" e digitar o script ou texto desejado. É
necessário que exista um parâmetro que permita a busca dessas informações através da
execução do script. Os parâmetros estão definidos na pasta "Parâmetros".
O padrão de escrita para a propriedade "Ação" nos campos do tipo "Text" e "TextArea" é: select
texto from tabela.
Campo "ComboBox"
O campo do tipo "Combobox" permite selecionar um valor dentre uma lista de valores possíveis, que
pode ser uma lista fixa ou uma lista dinâmica. Ao escolher esse tipo de campo, é necessário
preencher as seguintes informações na aba "Propriedades":
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Usado em: neste campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Lista de valores: a lista de valores que será apresentada quando o usuário acionar o
campo. Nela, é possível inserir caracteres especiais (<, >, +, =, /, \, -). Para acrescentar dados à
lista de valores, será necessário:
Clicar na propriedade "Lista de Valores" para que seja apresentada a janela "Adicionar
Valores";
Indicar o valor e a descrição do valor;
Acionar o botão .
Ação: O preenchimento do campo ComboBox também pode ser feito de forma dinâmica, por meio
de uma instrução SQL. Caso a instrução SQL possua filtros, pode ser usada a opção de
"Parâmetros". Para isso, selecionar um parâmetro da lista e arrastá-lo para a caixa onde a ação é
digitada;
Em seguida, clicar no botão para que o resultado da ação seja exibido na aba
Imagem
O campo do tipo "Imagem" possibilita a exibição de uma imagem no documento para visualização. Ao
escolher o campo do tipo "Imagem", é necessário preencher as seguintes informações na aba
"Propriedades":
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Usado em: neste campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Lista de imagens: clicar nessa propriedade para exibir a janela "Adicionar Valores" e adicionar as
imagens que serão utilizadas. Para isso, clicar no botão para escolher a imagem;
Marcar o check box para indicar a imagem desejada. Caso mais de uma imagem esteja carregada
no sistema, é necessário escolher uma delas, pois somente uma pode ser usada. O próprio
sistema, ao identificar uma segunda marcação, já desmarca automaticamente a primeira;
Ação: o campo do tipo "Imagem" também pode ser usado com uma ação. Por exemplo, é possível
criar uma instrução SQL para buscar na base de dados a logo do hospital ou a foto do paciente e
exibi-la na tela ou no relatório que utiliza esse campo;
Para esses casos, é necessário primeiramente adicionar todas as imagens que serão utilizadas e
em seguida, inserir a ação:
Logo do hospital
select Decode(cd_multi_empresa, 1, cast('Mapa' as varchar2(10)), cast('LogoMV' as varchar2(10))
) from dbamv.atendime
where cd_atendimento = &<PAR_CD_ATENDIMENTO>;
Foto do paciente
select fpe.lo_foto_pessoa from dbamv.foto_paciente fpa, dbamv.foto_pessoa fpe
where fpe.cd_foto_pessoa = fpa.cd_foto_pessoa
and fpa.cd_paciente = &<PAR_CD_PACIENTE>
Para carregamento de imagens diretamente da base, a coluna do banco de dados deve ser do
tipo CLOB ou BLOB.
É necessário que exista um parâmetro que permita a busca dessas informações através da
execução do script. Os parâmetros estão definidos na pasta "Parâmetros";
É possível utilizar desenho com linha livre. Esse recurso permite que o usuário utilize um
lápis para desenhar livremente na imagem, escolhendo a cor e a largura da linha.
Campo "CheckBox"
O campo do tipo "CheckBox" permite a seleção de várias opções simultaneamente. Ao escolher esse
tipo de campo, é necessário preencher as seguintes informações na aba "Propriedades":
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Usado em: neste campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Ação: informar uma ação, caso a marcação do check box seja resultante da execução de um
script. Para isso, é preciso que exista um parâmetro que permita a busca dessas informações
através da execução do script. Os parâmetros estão definidos na pasta "Parâmetros".
O padrão de escrita para a propriedade "Ação" no campo do tipo "CheckBox" é: select S/N from
tabela.
Campo "RadioButton"
O campo do tipo "RadioButton" permite a seleção de apenas uma opção dentre as exibidas. Ao
escolher um campo desse tipo, é necessário preencher as seguintes informações na aba
"Propriedades":
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Usado em: neste campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Ação: pode ser usada uma ação para indicar se o RadioButton irá se apresentar marcado ou
desmarcado. Para isso, o retorno da instrução SQL deve ser true ou false. Se o retorno for true, o
radiobutton fica marcado, se for false, fica desmarcado. Veja o exemplo abaixo de uma ação que
pode ser usada;
Os RadioButoons criados podem ser agrupados, funcionalidade que será detalhada mais na frente.
Ao agrupá-los, somente é possível marcar uma opção, ou seja a marcação de um RadioButton faz
com que os outros sejam desmarcados.
O padrão de escrita para a propriedade "Ação" no campo do tipo "RadioButton" é: select S/N
from tabela.
Campo "Data"
O campo do tipo "Data" possibilita digitar ou selecionar uma data de um calendário exibido ao clicar
no campo. Ao escolher um campo desse tipo, é necessário preencher as seguintes informações na
aba "Propriedades":
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Ação: caso o preenchimento do campo deva ser resultado do preenchimento de algum script,
informá-lo na propriedade "Ação". Essa propriedade não é obrigatória;
Campo "Botão"
O campo do tipo "Botão", ao ser clicado pelo usuário, dispara uma ação a ser efetuada pelo sistema.
Ao escolher um campo desse tipo, na aba "Propriedades", devem ser preenchidas as seguintes
informações:
Metadado: nome interno do campo, o metadado é um identificador único que permite a utilização
do campo em várias telas/relatórios. Verificar informação abaixo;
Essa informação não deve ter caracteres especiais e/ou espaços. Caso seja informado algum
caractere especial ou colocado espaço no campo "Metadado", será exibida a seguinte
mensagem:
Descrição: nome que será definido para o campo cadastrado. Essa informação é de
preenchimento livre e o usuário poderá escolher o nome que achar conveniente. Essa informação
será exibida como hint do campo no sistema Prontuário Eletrônico do Paciente. A propriedade
"Descrição" aceita apenas caracteres alfanuméricos, espaço e "_";
Usado em: neste campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Quando esse botão for utilizado num documento, é necessário criar uma regra para que ele
funcione;
Marcação de imagem
O campo do tipo "Marcação de Imagem" possibilita a exibição de uma imagem editável. Ao escolher
um campo desse tipo, na aba "Propriedades", devem ser preenchidas as mesmas propriedades do
campo do tipo "Imagem". A diferença entre os dois tipos de campo é que no segundo, a imagem
utilizada na tela e no relatório pode sofrer marcações de acordo com a necessidade. Ao escolher um
campo desse tipo, na aba "Propriedades", devem ser preenchidas as seguintes informações:
Usado em: nesse campo é exibida a quantidade de layouts que utilizam o metadado em questão;
Lista de ícones: nesse campo devem ser carregados os ícones personalizados a serem usados
na marcação da imagem. Desse modo, qualquer marcador pode ser usado, desde que seja
previamente carregado;
Código de barras
Os códigos de barras são representações gráficas de um determinado valor ou uma sequência de
dados informativa, e se dividem em dois grupos:
Verificação de paridades;
Cálculo de dígito verificador;
Relação gráfica entre os elementos.
O campo do tipo Código de Barras poderá ser adicionado a qualquer tipo de layout e, na aba
"Propriedades", devem ser preenchidas as seguintes informações:
Tipo do código: nesse campo deve ser informado o componente de código de barras que irá
suportar os principais tipos existentes atualmente no mercado, dentre as opções:
Código 39
Também conhecido como "Código 3 de 9", é adotado pela maioria das empresas automotivas, de
transporte aéreo e de saúde, devido a possibilidade de se codificarem caracteres alfanuméricos
que são essenciais ao controle dessas tarefas. O formato distinto de comprimento variável aceita
os 44 caracteres seguintes: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ.*$/+%. O
asterisco (*) é utilizado como caractere de início/parada, não podendo ser utilizado no corpo da
mensagem. Também permite adicionar um dígito de verificação que ajuda a garantir a segurança
do código de barras. O Código 39 suporta os formatos de dígito de verificação Módulo 43 e
xxxnnnnnnnc utilizados pela alfândega dos E.U.A. para remessas de importação/exportação e
em dezenas de outras aplicações
Código 25 (2 e 5)
Também conhecido como "Código 2 de 5", é um formato de código distinto, de comprimento
variável. O formato Código 25 consiste em duas barras espessas em um total de cinco barras
para cada caractere codificado. É utilizado sobretudo em manuseio de inventários, em fichas de
compensação bancária, na identificação de envelopes de acabamento de fotografias, em
passagens aéreas, no manuseio de bagagens e cargas e em dezenas de outras aplicações.
Código 128B e Código 128C
O código de barras 128 é uma simbologia linear capaz de codificar todos os 128 caracteres
ASCII e uma grande variedade de caracteres especiais. Essa simbologia inclui um dígito
verificador, e o código de barras também pode ser verificado caractere por caractere por meio de
paridades. Essa simbologia é utilizada em uma grande variedade de aplicações, devido a grande
capacidade de dados que pode ser codificado em um espaço pequeno. O código 128B permite
que sejam codificadas letras maiúsculas e minusculas, números, caracteres de pontuação e
caracteres especiais e o código 128C, 100 pares numéricos de 00 a 99 e três caracteres
especiais.
Código EAN 128
É um tipo de código de barras linear alfanumérico que representa Identificadores de Aplicação e
permite a inserção de uma maior quantidade de informação e dados adicionais assim como
números de série, datas de validade, ou medidas e também de algo muito importante como o
número de lote de produção. É um tipo de simbologia de identificação de produtos com maior
necessidade de serem rastreados e que é especialmente de utilização logística e para produtos
hospitalares.
Código EAN 13
O EAN13 é a versão europeia do UPC (A) (Universal Product Code). A diferença entre o EAN13 e
o UPC (A) é que o EAN13 codifica um 13° dígito no padrão de paridade dos seis dígitos da
esquerda de um símbolo UPC (A). Esse 13° dígito, combinado com o 12°, representa um código
de país.
Código UPC-A
Os símbolos UPC (Universal Product Code) são usados em aplicações de varejo nos Estados
Unidos e no Canadá. O UPC (A) é um formato de 12 dígitos. O símbolo consiste em 11 dígitos
de dados e um dígito de verificação. Normalmente, o primeiro dígito representa o tipo de produto
que está sendo identificado. Os cinco dígitos seguintes são um código de fabricante e os outros
cinco seguintes são utilizados para identificar um produto específico.
Exibir Label: esse campo deve ser marcado para indicar se a legenda relativa ao valor do código
deve ser exibida ou não;
Reprocessar parâmetros: essa propriedade deve ser marcada para que a ação seja reexecutada
quando houver mudança de parâmetros, como por exemplo, na cópia de documentos;
Ação: esse campo deve ser preenchido com a instrução SQL que irá alimentar o código de barras.
É possível exportar os campos de uma base de dados para outra, de uma base de simulação para
uma de produção, por exemplo, ou até mesmo de um hospital para o outro;
Ao clicar em , é exibida uma janela do Explorer para que seja escolhido o local onde
o arquivo será salvo. Esse arquivo contém informações sobre a versão corrente do sistema. No
momento que ele for importado, será verificado se a versão corrente do sistema suporta o arquivo,
garantindo a compatibilidade;
Caso o usuário esteja com o perfil MV, é possível escolher o idioma da exportação. Ao selecionar
a opção desejada, a descrição dos campos será automaticamente alterada para a língua
escolhida;
Clicando nele, é exibido o log do campo importado na tela "Histórico de Importação" permitindo
assim, identificar campos que apresentaram erro e viabilizar a correção;
Impactos
Os campos criados serão utilizados na confecção de telas e relatórios, bem como na confecção de
cabeçalhos e rodapés para os relatórios.
Parâmetros
Módulos
N/A
Função da tela
Permitir a visualização dos parâmetros que podem ser utilizados nos documentos (telas e relatórios) a
serem confeccionados. Esses parâmetros funcionam como variáveis que determinam o
comportamento dos campos quando as telas e os relatórios criados pelo Editor de Documentos forem
utilizados no sistema de Prontuário Eletrônico do Paciente a partir da versão 2.0.
Como usar
Ao acessar a aba "Campos" e abrir a pasta "Parâmetros" estarão agrupados todos os parâmetros
enviados pela MV para determinar o funcionamento, no Prontuário Eletrônico do Paciente, das
telas e relatórios criados pelo Editor de Documentos;
Esses parâmetros também são utilizados pelos campos cujo preenchimento dependem de uma
ação resultante da execução de um script no banco de dados;
Para visualizar um parâmetro, basta selecioná-lo com o mouse, que na aba "Propriedades" serão
exibidas as informações desse parâmetro, tais como: metadado, descrição e se ele está ou não
ativo;
É importante que o usuário saiba que esses parâmetros são apenas para visualização, não
sendo possível alterá-los ou criar novos. Essa função é exclusiva da MV.
Exemplo de parâmetro:
SELECT Fnc_Editor_Retorna_Metadados(&<PAR_CD_ATENDIMENTO>,'NM_PACIENTE')
Impactos
Ao criar os campos que irão compor os documentos, pode-se utilizar um dos parâmetros disponíveis
para determinar o comportamento do campo quando ele estiver funcionando nos sistemas que usam
os documentos confeccionados no Editor de Documentos.
Aba "Documentos"
Repositório de documentos
Criação de documento
Adição de campos ao documento
Adição de regras ao documento
Layout de relatório
Pub licação do documento
Módulos
N/A
Função da tela
Pré-requisitos
Movimentações
Como usar
O repositório de documentos é composto pelas pastas "Repositório Local" e "Repositório MV". Nesta
última constam uma série de documentos (tela ou relatório) já montados que são disponibilizados
pela MV. Não é possível fazer alterações diretamente nesses dois repositórios, somente no seu
conteúdo. Quando um desses dois repositórios está selecionado, os ícones existentes na parte
superior da tela ficam desabilidades.
Criação de documento
Para criar um documento (tela ou relatório), é necessário primeiramente cadastrar o grupo e o
subgrupo, aos quais o documento será vinculado;
Para cadastrar o grupo, selecionar no menu a opção "Repositório Local" e acionar o botão ;
Automaticamente o sistema cria uma pasta com uma descrição padrão, respeitando um
sequencial pré-estabelecido. É possível modificar a descrição para o nome a escolha do usuário;
Em seguida, é necessário criar um subgrupo. Para isso, selecionar a pasta do grupo e acionar o
botão ;
O subgrupo é criado com uma descrição padrão, que pode ser modificado para um nome da
escolha do usuário;
O sistema gera um código para o documento, bem como um metadado e uma descrição. O código
serve para que o sistema identifique o documento que será utilizado em determinado sistema;
Ao acionar o campo "Ordem dos Campos", será exibida a janela "Ordenar campos" por meio da
qual poderá ser definida a ordem dos campos exibidas na tela. Caso seja acionado o botão ,
após um metadado se excluído, os campos serão ordenados automaticamente;
As duas últimas informações podem ser modificadas de acordo com a necessidade do usuário,
mas devem ser únicas no sistema;
> Versão 1
>> Layout 1
>>> Campos
>>> Regras
Enquanto a versão não tiver sido publicada, ela ficará sinalizada da seguinte forma .
A versão inicial do documento criado é de teste e pode ser alterada. Após sua publicação para uso
no Prontuário Eletrônico do Paciente, ela não pode mais ser alterada.
O campos que irão compor o documento devem ser arrastados para a aba "Edição";
Caso deseje, o usuário poderá configurar um select no campo "Ação" da aba "Propriedades" para
que as informações preenchidas em um campo com data tenha as suas informações apagadas
quando o botão for acionado. Conforme mostrado na figura abaixo;
A aba de "Edição" apresenta uma barra de ferramentas que facilita a organização do documento
(tela ou relatório). Segue abaixo um detalhamento das funções da barra de ferramentas:
Os objetos permite a inserção de texto, linha vertical, definição da espessura da linha, frame,
linha horizontal e coloração da linha;
Nas fontes, é possível modificar a fonte da letra, o tamanho, definir se ela será negrito, itálico
ou sublinhado, bem como a cor da fonte e do fundo;
Ainda no alinhamento são oferecidas mais opções de distribuição, conforme a figura abaixo:
Em outros, é possível agrupar e desagrupar objetos, configurar uma grid, além de escolher se
grade na aba "Edição" será ou não exibida. A função de agrupar e desagrupar é um muito
importante para campos do tipo RadioButton. Ao agrupar dois ou mais RadioButtons, somente
é possível marcar uma opção, ou seja a marcação de um RadioButton faz com que os outros
sejam desmarcados;
Para adicionar regras ao documento, é necessário clicar na pasta "Regras" e acionar o botão
Automaticamente é criada uma regra com um nome padrão que segue um sequencial pré-
estabelecido e que pode ser modificado para um nome a escolha do usuário;
Em seguida, escolher o tipo da regra que será criada. Para tanto, clicar na propriedade "Tipo da
regra" e escolher uma das opções:
Responder;
Validar;
Habilitar;
Filtrar;
Ao finalizar documento;
Ao salvar documento;
Ao imprimir documento;
Ao criar documento;
Ao copiar documento.
Tipo de regra "Responder"
Os campos que têm esse tipo de regra, terão seu preenchimento de forma automática, após uma
pré-condição ter sido atendida;
Ao escolher esse tipo de regra, é necessário clicar na propriedade "Condições" para que seja
exibida a janela "Adicionar Condições";
Nessa janela, é definido o campo (metadado) para o qual a condição será definida e quando ela
será aplicada (quando igual a, quando maior que, quando maior igual a, quando menor que, quando
menor igual a, quando diferente de);
Depois de informar quando ela será aplicada, é necessário definir o valor para o tipo da operação;
Nem sempre os dois valores precisam ser preenchidos. Por exemplo, pode ser criada a regra:
campo > igual a > valor inicial: true. Ou seja, a condição define que uma resposta será dada caso
o campo em questão esteja preenchido;
Existem ainda casos em que é necessário utilizar a opção "E/OU". Por exemplo, para cálculos de
IMC, é necessário que o campo seja o resultado de um cálculo que envolve peso e altura. É
necessário criar uma regra que defina que os campos de peso e altura sejam diferentes de vazio.
Em seguida, é preciso informar com campo "Ação" a instrução SQL responsável por realizar o
cálculo do IMC;
Em seguida, indicar qual(is) campo(s) que será(ão) respondido(s) quando a condição definida for
atendida. Para isso, clicar na propriedade "Responder os campos" e marcar o check box referente
ao(s) campo(s) desejado(s).
Para definir o valor, clicar na propriedade "Condições", indicar o campo (metadado) que deve ser
validado, escolher o tipo da operação e indicar o valor que deve ser considerado como válido para o
campo. Por exemplo, para a realização do procedimento de parto, é necessário que a paciente
possua mais de dez anos. Nesse caso, o campo de idade deve possuir uma regra para somente
permitir que seja informados valor maiores ou iguais a 10;
O tipo de regra "Validar" também pode utilizar uma ação. Por exemplo, é possível buscar uma
informação no banco de dados e utilizá-la para validar um outro metadado;
Para isso, clicar na propriedade "Ação" e, na janela "Ação da Regra", informar a instrução SQL a
ser executada. Essa janela apresenta todos os campos e todos os parâmetros que podem ser
usados. Basta que eles sejam arrastados para a caixa de texto. O campo "Pesquisar" é um
facilitador para casos em que há muitos campo ou parâmetros;
Para isso, clicar na propriedade "Condições", indicar o campo (metadado) que será utilizado para
aplicação da regra. Ou seja, de acordo com o valor desse metadado, um outro campo poderá ser
habilitado;
Em seguida, escolher o tipo da operação e indicar o valor que irá habilitar ou permitir a modificação
de um outro campo;
Na propriedade "Habilitar campos" indicar os metadados que serão habilitados com base na regra
estabelecida;
Esse tipo de regra serve também para desabilitação. Para isso, é necessário preencher todas as
propriedades já descritas e na propriedade "Ação" escrever o script SELECT 'N' FROM DUAL.
Tipos de regra "Ao finalizar documento", "Ao salvar documento", "Ao imprimir documento", "Ao criar
documento", "Ao copiar documento"
Finalizar documento;
Salvar documento;
Imprimir documento;
Criar documento;
Copiar documento.
Os tipos de regra "Ao finalizar documento", "Ao salvar documento", "Ao imprimir documento", "Ao
criar documento", "Ao copiar documento", disponíveis no Editor de Documentos, tem a função de
realizar alguma dessas ações quando o usuário escolher uma dessa opções no Prontuário
Eletrônico do Paciente. Por exemplo, após o médico finalizar o documento, pode ser criada uma
regra que dispare uma ação no banco de dados para que seja dada alta ao paciente. Nesse caso,
a função responsável por dar alta ao paciente deve ser informada na propriedade "Ação".
Layout de relatório
Para que o documento criado tenha um layout de relatório, clicar no layout de tela e em seguida
clicar em ações e escolher a opção "Gerar layout de relatório";
O sistema cria mais uma opção na árvore, sinalizada com um ícone referente à relatório;
No layout do relatório, podem existir mais informações que no layout de tela. Por exemplo, é
possível inserir uma caixa de texto e dentro dessa caixa de texto referenciar um metadado ou
campo. Ao referenciar um metadado, no relatório será exibido o valor inicial ou ação desse
metadado. Ao referenciar um campo, no relatório é exibido o que foi digitado na tela. Para mais
informações, verificar o exemplo de Impressão - Atestado.
Os documentos com layout "Relatório" podem possuir cabeçalho e rodapé. Não é necessário criar
um cabeçalho e um rodapé para cada relatório. O sistema possui um repositório de cabeçalhos e
rodapés que podem ser utilizados em vários documentos simultaneamente;
Para vincular um cabeçalho ou um rodapé ao relatório, é necessário que ele esteja em versão de
teste e que o cabeçalho ou o rodapé tenham sido criados na pasta "Repositório de Cabeçalhos e
Rodapés". Para fazer o vínculo, informar o código nos campos "Código do cabeçalho" e "Código do
rodapé".
Teste do documento
Na aba "Teste", é possível visualizar como o documento montado será exibido no Prontuário
Eletrônico do Paciente;
No campo "Num. Documento", informar o código do documento. Esse código está disponível na
aba "Propriedade";
É possível digitar informações na documento para testar o seu funcionamento. Caso deseje,
acionar o botão , para salvar as informações digitadas;
Após salvar as informações digitadas, clicar em para finalizar. Com isso, não é possível mais
digitar informações e será exibida a mensagem: Registro finalizado com sucesso!;
O botão permite ao usuário validar as informações dos campos, por meio das regras inseridas
nos documentos;
Por meio do botão , é possível definir quais parâmetros serão utilizados para os testes, tais
como código de atendimento, código do paciente, prestador etc.
Publicação do documento
Quando a montagem do documento estiver pronta, clicar na versão em teste, ir na aba
"Propriedades" e marcar o check "Publicado";
Quando a versão for publicada, ela não poderá mais sofrer alterações. Caso seja necessária
alguma alteração após a publicação da versão, é necessário duplicá-la para que seja criada uma
versão de teste que pode ser alterada;
Na aba "Teste", basta informar o código do documento e clicar em "Versão publicada" para
visualizar o documento da maneira como ele será exibido no Prontuário Eletrônico do Paciente.
Duplicar versão
Caso deseje duplicar uma versão já publicada, basta selecionar o documento e clicar na ação
"Duplicar Versão".
É exibida uma mensagem para que seja definida a opção de exportação. Marcando o campo
"Exportar metadados?", serão exportados juntamente com o documento, os campos, cabeçalhos
e rodapés que estão associados a ele;
Caso o usuário esteja com o perfil MV, é possível escolher o idioma da exportação. Ao selecionar
a opção desejada, a descrição dos campos será automaticamente alterada para a língua
escolhida;
Ao clicar em , é exibida uma janela do Explorer para que seja escolhido o local onde
o arquivo será salvo. Esse arquivo contém informações sobre a versão corrente do sistema. No
momento que ele for importado, será verificado se a versão corrente do sistema suporta o arquivo,
garantindo a compatibilidade;
Impactos
Na tela abaixo será possível vincular ao perfil do usuário o documento eletrônico para o qual ele deverá
ter acesso. Para tal basta cadastrar o módulo referente ao documento eletrônico, informar os
parâmetros e, no campo, "Valor" informar o código do Documento Eletrônico para o qual se deseja
efetuar o vínculo:
Módulos
N/A
Função da tela
Permitir a criação de cabeçalhos e rodapés para serem inseridos nos documentos confeccionados
pelo Editor de Documentos. Esses cabeçalhos e rodapés podem ser utilizados em vários documentos
simultaneamente.
Pré-requisitos
Movimentações
Como usar
Criação de cabeçalho/rodapé
Para criar um cabeçalho ou rodapé, é necessário primeiramente cadastrar o grupo e subgrupo, aos
quais o cabeçalho ou rodapé será vinculado;
Para cadastrar o grupo, selecionar no menu a opção "Repositório Local" e acionar o botão ;
Automaticamente o sistema cria uma pasta com um nome padrão, respeitando um sequencial pré-
estabelecido. É possível modificar a descrição para o nome a escolha do usuário;
Em seguida, é necessário criar um subgrupo. Para isso, selecionar a pasta do grupo e acionar o
botão ;
O subgrupo é criado com um nome padrão, que pode ser modificado para um nome da escolha do
usuário;
Depois de criado o subgrupo, acionar novamente o botão para criar o cabeçalho ou rodapé;
O sistema gera um código para o cabeçalho ou rodapé, bem como um metadado e uma descrição.
As duas últimas informações podem ser modificadas de acordo com a necessidade do usuário,
mas devem ser únicas no sistema. O código serve para que o sistema identifique o cabeçalho ou
rodapé que será utilizado nos documentos;
Quando o cabeçalho ou rodapé é criado, automaticamente são vinculados a ele a versão, o layout
e as pastas de campos e regras, criando a seguinte estrutura:
> Versão 1
>> Layout 1
>>> Campos
>>> Regras
Enquanto a versão não tiver sido publicada, ela ficará sinalizada da seguinte forma .
É importante observar que os cabeçalhos e rodapés devem ficar restritos às partes superior e
inferior do layout. O tamanho do cabeçalho/rodapé pode ser ajustado, mas sempre se mantendo
nessa posição;
A aba de "Edição" apresenta uma barra de ferramentas que facilita a organização do documento
(tela ou relatório). Segue abaixo um detalhamento das funções da barra de ferramentas:
Os objetos permite a inserção de texto, linha vertical, definição da espessura da linha, frame,
linha horizontal e coloração da linha;
Nas fontes, é possível modificar a fonte da letra, o tamanho, definir se ela será negrito, itálico
ou sublinhado, bem como a cor da fonte e do fundo;
Ainda no alinhamento são oferecidas mais opções de distribuição, conforme a figura abaixo:
Em outros, é possível agrupar e desagrupar objetos, configurar uma grid, além de escolher se
grade na aba "Edição" será ou não exibida. A função de agrupar e desagrupar é um muito
importante para campos do tipo RadioButton. Ao agrupar dois ou mais RadioButtons, somente
é possível marcar uma opção, ou seja a marcação de um RadioButton faz com que os outros
sejam desmarcados;
Duplicar cabeçalho/rodapé
A versão publicada do cabeçalho/rodapé pode ser duplicada. Para isso, clicar em "Ações" e depois
em "Duplicar Versão".
Histórico de versão
Os cabeçalhos, ao serem criados, ficam com uma versão em teste. Ao clicar na flag "Publicado",
essa versão passa a ser publicada. Caso seja necessário fazer alguma alteração numa versão já
publicada, é necessário duplicá-la, criando uma nova versão de teste. Após publicar a versão em
teste, ela passa para publicada e a versão que estava publicada anteriormente, passa para
histórico;
Atualizar cabeçalho/rodapé
Ao duplicar um cabeçalho/rodapé para realizar alterações, é gerado um novo código. Os
documentos que estejam vinculados a esse cabeçalho/rodapé podem ser atualizados
automaticamente;
Para atualizar todos, manter o check box "Atualizar Todos?" marcado e clicar em ;
Para atualizar apenas alguns documentos, desmarcar o check box "Atualizar Todos". São listados
os documentos vinculados ao cabeçalho/rodapé no lado esquerdo da janela. Para selecionar o
documento, arrastá-lo para o lado direito;
O campo de pesquisa é usado como facilitador quando houver muitos documentos. Para excluir
um documento selecionado, clicar em .
Impactos
Os cabeçalhos e rodapés criados serão utilizados para compor os documentos eletrônicos criados.
Para relacioná-los, basta informar seus respectivos códigos na aba "Propriedades" referente ao layout
de relatório de documento.
Exemplos
Nesta sessão, serão explicados alguns exemplos de campos e documentos que geralmente são
utilizados no Editor de Documentos, são eles:
Agrupamento de RadioButton;
Cálculo do IMC;
Impressão - Atestado;
Impressão TextArea Expansível/Dinâmico;
Sim/Não/Outros;
Texto padrão;
Uso do botão;
Retorno de informações dos metadados.
Agrupamento radioButton
Quando houver uma pergunta com somente uma resposta possível dentre duas opções ou mais, é
utilizado o campo do tipo "RadioButton". Por exemplo, para indicar se o paciente é ou não fumante,
devem ser usados dois RadioButtons: Sim e Não. Entretanto, se na tela houver vários RadioButtons
para resposta a mais de uma pergunta, é necessário fazer o agrupamento das possíveis respostas
para uma pergunta, pois do contrário o documento considera que todos os "RadioButtons" se referem
ao mesmo assunto.
Legenda
Cálculo do IMC
Quando é necessário que a resposta de um campo seja baseada nas informações providas em outros
campos, é necessário aplicar uma regra. Por exemplo, para fazer o cálculo do IMC, é necessário
informar o peso e a altura (em metros) do paciente. O documento deve ser montado como no exemplo
abaixo:
No campo IMC, deve ser aplicada uma regra com as seguintes propriedades:
Impressão - Atestado
Em alguns documentos, o usuário pode utilizar um texto corrido no qual irá referenciar um metadado.
Um exemplo é o documento de atestado. Para criar criar o atestado, primeiramente deve ser criado
um layout de tela, no qual são inseridos os campos para digitação do nome do paciente e do CID, por
exemplo.
Utilizando a ferramenta de , disponível na barra de ferramentas da aba "Edição", deve ser inserido
um texto como o seguinte:
Ao emitir um relatório, alguma informação ficar maior do que o previsto durante montagem do layout.
Por exemplo, na descrição do diagnóstico do paciente, o prestador pode sentir a necessidade de
escrever algumas informações adicionais que irão aumentar consideravelmente o tamanho do campo.
Nesses casos, é importante incluir uma quebra logo abaixo do campo para evitar que ele sobreponha
o campo imediatamente abaixo caso as informações sejam muito grandes. Com a quebra,
automaticamente o sistema posiciona o campo seguinte mais para baixo. Não havendo quebra, a
primeira informação irá sobrepor a segunda.
Legenda
Sim/Não/Outros
Para determinadas perguntas, quando uma resposta for dada, pode ser necessário um complemento.
Por exemplo, se para o questionamento "Local de procedência" forem dadas as seguintes opções:
Casa
Trabalho
Outros
Ao escolher a opção "Outros", um campo pode ser habilitado para que seja informado qual é o outro
local de procedência.
1) Limpar se desabilitado: caso os campos "Casa" ou "Trabalho" sejam marcados, o campo que é
habilitado se o campo "Outros" for selecionado deve ser apagado;
2) Outro: caso o campo "Outros" seja marcado, uma caixa de texto deve ser habilitada para
informação do outro local de procedência;
3) Sim/Não: Quando um dos campos for marcado, os outros dois devem ser desmarcados. Para isso,
é necessário que os três campos sejam do tipo RadionButton e que os três estejam agrupados.
Texto padrão
Em algumas situações, o prestador precisa, com muita frequência, digitar um mesmo texto. Para
facilitar a utilização do documento, pode ser criado um texto padrão. Nesses casos, é criado um
campo do tipo "Text" ou "TextArea" e na aba "Propriedades", é necessário marcar a propriedade
"Utilizar texto padrão" e clicar na propriedade "Lista de Valores do Texto Padrão" para indicar as
opções padrão que serão utilizadas nesse campo.
Uso do botão
Em alguns casos, após digitar ou selecionar determinada informação, o sistema pode efetuar um
comando. Por exemplo, se após escolher uma opção num campo do tipo "ComboBox", o usuário
desejar inserir essa informação numa área de texto, é possível criar um botão para realizar isso. Para
tanto, é necessário que o botão criado possua uma regra como a seguinte:
Informações cadastrais
Informações históricas
Como configurar
Deve-se colocar a instrução SQL, chamando a função do banco de dados, dentro do atributo ação do
metadado. Para retornar informações cadastrais, deve-se colocar a query abaixo no atributo ação do
metadado, substituindo apenas o nome do metadado mantendo as apas.
Em seguida deve-se colocar a query abaixo no atributo ação do novo metadado, substituindo os
parâmetros (mas mantendo as apas) conforme explicação abaixo:
TIPO DE RETORNO: Colocar a letra ‘A’ caso queira o último registro do metadado do atendimento
atual. Se desejar o último registro do metadado do paciente de qualquer atendimento, usar a letra
‘P’.
EXCLUI ATUAL: Colocar a letra ‘S’ caso queira o penúltimo registro do atendimento ou letra ‘N’
caso queira o registro do atendimento atual. Esse parâmetro deve está em concordância com o
parâmetro TIPO DE RETORNO conforme segue abaixo: