Configurando
Painéis Customizados de Navegação
[1]
- Desenhando Painéis de Navegação
[2]
- Criando Novos Painéis de Navegação
[3]
- Customizando
os Ícones nos Painéis de Navegação
Desenhando
Painéis de Navegação
O
IW-Care permite que os próprios administradores do sistema
'desenhem' painéis de navegação para tornar o
uso do sistema mais fácil e amigável. A figura a seguir
mostra um exemplo de um painel de navegação :
Conforme
pode ser observado um painel no IW-Care se assemelha a uma espécie
de 'organograma' formado por um conjunto de blocos. A forma, cor,
tipo de fonte, cor de fonte, cor de fundo etc podem ser livremente
escolhidos por quem estiver desenhando o painel. O essencial a ser
compreendido no que diz respeito ao desenho de painéis é
que a cada 'ícone' declarado será possível
associar:
(a) 'links' para lançar qualquer uma das
interfaces (HMI´s Human Machine Interfaces') do IW-Care;
(b)
'links' para lançamento de documentos de diversos tipos de
mídia (textos, planilhas, imagens, filmes etc).
Para
lançar um menu contendo a relação de painéis
configurados o IW-Care oferece um botão na barra de
ferramentas do 'frame de navegação'. A figura abaixo
ilustra o menu de painéis:
Nota:
Os painéis são recursos cujo acesso pode ser controlado
através do ambiente de segurança do IW-Care. Sendo
assim a lista de painéis que estarão acessíveis
poderá variar de usuário para usuário.
Criando
Novos Painéis de Navegação
Para
declarar um novo painel de navegação utilize a
interface HMI : F00007 (navegação: Menu - Administrador
- Configuração de Painéis) ilustrada a seguir:
Descrição
dos Botões:
Pesquisar
: popula o gride com todos os painéis configurados até
o presente momento no IW-Care;
Editar
: essa opção
faz com o IW-Care lance uma caixa de diálogo de edição
de painéis. Através dessa caixa de diálogo o
usuário poderá tanto criar um novo painel quanto
editar algumas propriedades básicas de um painel
pré-existente. A figura a seguir mostra essa caixa de
diálogo:
As
seguintes propriedades podem ser editadas:
(a)
Nome do painel : poderá ser editado diretamente sobre o campo
'Título';
(b) Tipo de fonte e cor de fundo: clique no
botão '...' para lançar uma caixa de seleção
de fontes e cores de fundo;
(c) Imagem de fundo : clique no
botão '...' para lançar uma caixa de seleção
de um arquivo '.gif ' contendo uma imagem que ficará ao fundo
do painel.
Para
criar um novo painel clique no botão 'Limpar'. O IW-Care
colocar a inteface acima no modo de inserção (note que
o botão 'Alterar' é substituído por um botão
'Inserir'). Para inserir um novo painel digite o nome desejado para o
novo painel, edite o tipo de fonte e a cor de fundo e se desejar
informe um arquivo de imagem de fundo para o novo painel e, sem
seguida clique no botão 'Inserir'.
Desenhar
: para 'desenhar'
painéis o usuário deverá selecionar no gride o
painel a ser desenhado e em seguida clicar no botão
'Desenhar'. Nesse momento o IW-Care irá lançar a
interface de edição dos painéis de navegação.
A figura a seguir ilustra essa interface:
Declarando
Ícones em um Painel de Navegação Customizado
Para
declarar ícones em um painel clique com o botão direito
do mouse sobre o fundo do painel. Conforme ilustrado acima será
apresentado um menu com a opção 'Inserir Ícone'.
Acione essa opção para que o sistema exiba a seguinte
caixa de diálogo:
Selecione
um 'tipo de ícone' na caixa de seleção no canto
superior direito e clique no botão 'Inserir'. Isso fará
com que seja criado um ícone do tipo escolhido do painel de
navegação conforme ilustrado abaixo:
A
cada ícone declarado em um painel poderão ser
associados:
(a)
uma ou várias transações
(b)
um ou vários Atalhos para lançamento de documentos ou
outros aplicativos
Associando
Transações a Ícones
É
possível associar uma transação do IW-Care a
qualquer ícone presente no painel. Por exemplo prático
mais imediato de aplicação desse recurso é
podermos associar um comando de 'lançamento' de qualquer
interface (HMI´s) do IW-Care aos ícones.
Esse
recurso possibilita que sejam criados painéis customizados de
navegação para diferentes grupos de usuários.
Para isso clique com o botão direito do mouse sobre o ícone.
Aparecerá um menu-popup onde uma das opções é
configurar 'Transações', como ilustrado abaixo:
Ao
clicar na opção transação o sistema
abrirá a seguinte caixa de diálogo:
Clique
no botão editar para associar uma nova transação
ao ícone. A seguinte caixa de diálogo será
apresentada:
Digite
as seguintes informações:
'Nome
Transação' :
Trata-se do nome que será mostrado no painel. Quando
se tratar de um ícone associado a uma única transação
o ícone já assumirá automaticamente o nome da
transação que for digitado nesse campo. Quando se
tratar de um ícone associado a múltiplas transações
então, ao clicar sobre o ícone no modo de execução
do painel, será aberto um menu-popup com os nomes das
transações configurados nesse campo.
IHM
Execução:
Nesse campo deverá ser informado o nome da classe
visual a ser lançada. Uma forma simples e prática de
obter esses nomes será consultar diretamente sobre a caixa de
diálogo do menu de navegação do IW-Care
ilustrada maiws abaixo:
Parâmetros:
Transcreva nesse campo os parâmetros (valor do campo
PARAM apresentado na caixa de diálogo F00020). Na grande
maioria das interfaces esse campo ficará em branco.
Modal:
(sim;não) : Determina
o comportamento das interfaces tipo caixa de diálogo. Uma
caixa de diálogo modal não permitirá que ela
perca o foco na estação de trabalho ao passo que uma
caixa de diálogo não modal permite a perda do foco.
Por
exemplo, para obter o nome da classe de lançamento da HMI do
prontuário eletrônico ilumine essa opção
no menu e clique no botão 'Alterar'. O sistema exibirá
a seguinte caixa de diálogo:
A
informação situada no campo denominado 'Classe' (nesse
exemplo :
'com.iw.visualLayer.careProgram.careProgram.IwFormMedConsult')
corresponde exatamente ao comando de lançamento da interface
que deverá ser digitado no campo 'IHM Execução'.
Não tente digitar o nome novamente, para evitar erros utilize
o recurso copiar (CTR-C) e colar (CTR-V) para transcrever o nome
desses comandos do menu de navegação para a caixa de
diálogo F00062.
A
ilustração a seguir mostra a caixa de diálogo
F00062 populada para a inserção da transação
de lançamento da interface de acesso ao prontuário
eletrônico:
Após
a execução da transação inserir o nosso
painel ficaria da seguinte forma:
Quando
esse painel for posto no modo de execução, quando o
usuário clicar com o botão esquerdo do mouse sobre o
ícone 'Prontuário Eletrônico” será
lançada a interface F01039 – Prontuário
Eletrônico do IW.
Associando
Atalhos para Aplicativos e Documentos a um Ícone
É
possível associar um Atalho de Documento a qualquer ícone
presente no painel. Para isso clique com o botão direito do
mouse sobre o ícone. Aparecerá um menu-popup onde uma
das opções é configurar 'Atalhos' para
documentos. Como ilustrado abaixo:
Com
o acionamento da opção de Atalho aparece a caixa de
diálogo abaixo:
Ela
lista os Atalhos previamente associados, permitindo inserir, alterar
e excluir atalhos.
Pressionando
o botão Editar aparece o diálogo abaixo que nos
permite especificar de fato o Atalho para um documento:
campo
Nome do Atalho
Deve ser preenchido com um texto
que aparecerá no popup de execução do painel. O
acionamento dessa opção no painel de execução
fará com que o IW-Care carregue a aplicação
adequada para a exibição do documento e faça
com que a ela exiba o mesmo.
Campo
Tipo de Aplicativo
Nessa caixa de seleção
deve ser selecionado o tipo de aplicativo (Editor de Texto,
Processador de texto, Planilha Eletrônica, Mídia
Player) que deve ser usado para abrir o documento. O caminho
completo do executável desse aplicativo deve estar
relacionado na variável de ambiente (Path do sistema) para
que o atalho funcione.
Existem 3 constantes de sistema
que são usadas para definir que aplicativo usar para cada
tipo de documento em cada sistema operacional (Windows/Linux). As
constantes de Sistema K_IFR_WINDOWS, K_IFR_LINUX e a constante comum
K_IFR_APPLICATION também devem estar devidamente valoradas
para que o Atalho funcione.
A Constante K_IFR_APPLICATION
define os tipos de aplicações e as constantes
K_IFR_WINDOWS e K_IFR_LINUX associam um aplicativo executável
ao tipos definidos pela constante K_IFR_APPLICATION, de acordo com
sistema operacional que é detectado automaticamente pelo
IW-Care.
Obs.: somente para Windows/XP: No caso
específico do Windows/XP o IW-Care procura primeiro no
Registry do Sistema pelo programa default que o windows utiliza para
abrir o documento (olhando pela extensão do nome do
documento) não havendo necessidade do executável do
programa estar na variável de ambiente Path do
sistema.
Caso não encontre nenhum programa default no
registry ele então tenta processar o Atalho usando o tipo de
aplicação presente no campo Application e os valores
parametrizados nas constantes citadas acima.
-
|
URL
|
URL
(Uniform
Resource Locator) possui
sintaxe muito bem definida e possibilita endereçar de
modo preciso qualquer recurso, esteja ele na Internet, numa
Intranet, na rede local ou até mesmo num diretório
local. Aqui podemos considerar recurso como um arquivo de
qualquer tipo: .doc,
.xls,
.cvs,
.txt,
.pdf,
.avi,
.jpg,
.gif,
.mpeg,
.html,
.htm,...
).
Extrapola
o objetivo desse documento cobrir toda a sintaxe de uma URL
(maiores detalhes
http://www.ietf.org/rfc/rfc1738.txt).
Aqui
serão fornecidas recomendações práticas
e citar exemplos objetivos.
Estar atento quanto à
visibilidade da URL em todo o escopo onde a aplicação
será utilizada. Se a aplicação é de
uso somente interno e restrita a único local físico,
usar endereço que aponte para arquivo na rede local pode
ser aceitável, mas se possui usuários externos,
esses usuários receberão mensagem de Link quebrado
uma vez que o modo como a URL foi construída só
faz sentido para máquinas conectadas à rede local.
O Uso de URL´s que apontem para arquivos em diretórios
locais é totalmente desaconselhável pois tais
links só funcionariam nessa máquina
específica.
Procurar endereçar
documentos cuja URL inicie com “http://” e cuja
árvore de diretórios do mesmo se inicie no mesmo
endereço do dispatcher do servidor de aplicação.
Este procedimento garante sempre que esses documentos estarão
disponíveis no momento que o servidor do IW-Care está
no ar. Assim tanto a aplicação como os documentos
estariam usando o mesmo WebServer garantindo assim a
homogeneidade operacional do sistema e a visibilidade dos
documentos tanto para usuários internos como externos.
Ex de um atalho para documento de um usuário que
acessa o IW-Care instalado no nosso escritório de São
Paulo:
http://200.204.170.183/IW-Care/customerlogotype.gif
Esse
exemplo especifica a URL para logomarca do IW-Care.
|
|
|
Identificador
de documento empacotado.
Para
especificar um documento que é distribuído dentro
de um pacote .jar do IW-Care basta iniciar o endereço
com “iwdocument://” e em seguida especificar o
caminho para o arquivo empacotado seguindo a mesma hierarquia
de diretórios que foi utilizada ao fazer o empacotamento
usando o Empacotador do IW-Care. Embora a sintaxe lembre uma
URL esse tipo de endereçamento não é uma
URL pois o prefixo “iwdocuments://” não é
definido na especificação sintática de uma
URL e só tem significado dentro do IW-Care.
Esse
tipo de atalho é o mais performático. Garante a
presença do documento na estação cliente,
uma vez que eles são distribuídos automaticamente
pelo Java Web Start. Contudo existe a desvantagem de que sempre
que for gerada uma nova versão desse documento, ao se
lançar o IW-Care será realizada a atualização
desse documento na máquina cliente antes do início
propriamente dito da execução do IW-Care. Note
que se o documento for longo e o usuário estiver fazendo
acesso via internet o tempo de atualização do
documento poderá ser significativo e irá depender
da velocidade da conexão com a internet. Não é
aconselhável a utilização desse tipo de
endereçamento para referenciar documentos muito extensos
(como vídeos) onera o tempo de distribuição
da aplicação.
Exemplos:
iwdocument://teste1.txt
iwdocument://produtos/teste2.doc
iwdocument://produtos/Pasta1.xls
|
A
figura a seguir ilustra como ficou o nosso painel de exemplo com os
dois ícones criados nesse tutorial:
IMPORTANTE:
Para salvar no servidor o “layout” do painel que está
sendo desenvolvido clique no botão salvar (botão com
imagem de um disquete situado no barra de ferramentas canto superior
da tela). Esse botão faz com que o IW grava somente a
renderização (disposição física
dos componentes no painel). A salva dos “ícones”
propriamente ditos é realizada pelo IW automaticamente após
cada inserção de um novo ícone no painel de
navegação.
Customizando
os Ícones nos Painéis de Navegação
A
partir da versão server do IW que roda sobre Jboss
8 (Wild Fly) o
mecanismo de customização de imagens (ícones)
disponíveis no ambiente de configuração dos
painéis do IW ficou bastante simplificado da seguinte forma:
(a) As imagens a serem publicadas continuam necessitando
estar em formato .gif, .png ou jpg.
(b) Para proceder a
publicação as imagens , os arquivos das imagens
customizadas deverão ser simplesmente copiados para o seguinte
diretório no(s) servidor(es) de aplicação do IW:
C:\Java\wildfly-8.2.0.Final\standalone\deployments\IwResource.war\panelImages
Após
o posicionamento das novas imagens no diretório indicado acima
deverão ser executadas as seguintes “bat´s”
para propagação das imagens para as demais instâncias
do WildFly utilizadas pelo IW:
C:\Java\IwMultiServerAdmin\Update_Wildfly_1.bat
C:\Java\IwMultiServerAdmin\Update_Wildfly_2.bat
IMPORTANTE:
Rodar esta duas bats em janela Prompt DOS debaixo de
administrador
Nota:
O mecanismo anterior de publicação de imagens de
painéis foi descontinuado. Caso sua instalação
do IW ainda não esteja com versão para Jboss 8
(WildFly)
e
você necessite customizar imagens de painéis solicite à
Incoway a atualização da sua versão do IW.
