Lotus Notes

Gerncia Regional de Operao de Paulo Afonso GRP Servio de Ensino Tcnico Operacional SPTO
Curso de Desenvolvimento em Lotus Notes Designer Por Bruno Ricardo Pg. 1/29

Sumrio

Objetivo ..................................................................................................................2
Programa................................................................................................................2
MetodoIogia............................................................................................................2
1. Base de Dados Notes.....................................................................................3
2. EIementos bsicos de uma Base de Dados Notes ......................................4
3. Criao de FormuIrios..................................................................................5
4. Criao de Vises...........................................................................................9
5. Criao de Estruturas de Tpicos...............................................................11
6. Criao de Pginas.......................................................................................12
7. Criao de Conjuntos de Quadros..............................................................13
8. Criao de Sub-formuIrios.........................................................................13
9. Criao de Campos CompartiIhados..........................................................14
10. Tpicos avanados de Campos CompartiIhados e FormuIrios..........14
11. Tpicos avanados de Vises .................................................................20
12. Tpicos avanados de Funes..............................................................22
13. Criao de Agentes...................................................................................23
14. Tpicos avanados de Bases de Dados.................................................23
15. Tpicos Gerais CompIementares ............................................................25
Referncias ..........................................................................................................29


Objetivo
Apresentar a funcionrios da Chesf, da regional de Paulo Afonso, conceitos introdutrios e avanados
sobre Desenvolvimento em Lotus Notes Designer para que possam, num futuro prximo, aumentar
o contingente de desenvolvedores e mantenedores de sistemas baseados na tecnologia Lotus
Notes.
Programa
Contedo Carga Horria
1. Base de Dados Notes 1
2. Elementos bsicos de uma Base de Dados Notes 1
3. Criao de Formulrios 6
4. Criao de Vises 4
5. Criao de Estruturas de Tpicos 1
6. Criao de Pginas 1
7. Criao de Conjuntos de Quadros 1
8. Criao de Sub-formulrios 1
9. Criao de Campos Compartilhados 1
10. Tpicos avanados de Campos Compartilhados e Formulrios 7
11. Tpicos avanados de Vises 4
12. Tpicos avanados de Funes 4
13. Criao de Agentes 1
14. Tpicos avanados de Bases de Dados 1
15. Tpicos Gerais Complementares 6
Carga Horria Total 40

MetodoIogia
As aulas sero ministradas em laboratrio de informtica com, no mximo, dois usurios por
computador. Elas sero baseadas no contedo desta apostila e ministradas utilizando aulas
expositivas com predominncia de exemplos prticos realizados em computador e exibidos para a
turma utilizando datashow. Estes exemplos devem ser repetidos pelos treinandos para que possam
interiorizar a aprendizagem. Outros exemplos devem lhes ser oferecidos a ttulo de desafio para
verificar e melhorar a qualidade da aprendizagem.


1. Base de Dados Notes
um arquivo que contm tudo o que necessrio ao seu funcionamento. Cada base de dados Notes
contm eIementos de estrutura, Igica, dados e ACL (Access Control List lista de controle de
acesso). Esta base de dados salva em algum diretrio de um computador que possua o servidor
BM Domino (tambm h a opo de salvar a base de dados em diretrio local). Ele salvo como um
arquivo nico, de extenso NSF (Notes Storage Facility), ex: brunor.nsf, names.nsf, Atos.nsf...
Geralmente, uma base de dados contm documentos. Cada uma delas trata de um tpico especfico,
algumas s permitem a leitura das informaes, enquanto outras permitem que voc crie seus
prprios documentos (isto definido na ACL). Voc cria um documento ao preencher informaes em
um formulrio contido no banco de dados, em espaos pr-estabelecidos chamados de campos.
Graas a estas caractersticas, o Notes no considerado um SGBD (Sistema de Gerenciamento de
Banco de Dados), tecnicamente, nem mesmo considerado um banco de dados, na verdade trata-se
de um banco de documentos.

Desde que sejam criados os mecanismos necessrios, possvel acessar o contedo destas bases
de dados, ou mesmo alter-los, atravs de um browser, como o nternet Explorer, o que torna o
acesso aos bancos de dados mais rpido. Contudo, pode-se perder alguns recursos ou facilidades,
disponveis apenas quando acessados via cliente Lotus Notes. No geral, vale a seguinte regra: caso
deseje disponibilizar um banco de dados em uma LAN ou MAN, use a soluo cliente Lotus Notes.
Caso deseje disponibilizar um banco de dados em uma WAN, use uma soluo WEB com acesso via
browser, para que a aplicao no se torne intoleravelmente lenta. O uso de rplicas locais tambm
pode contornar o problema de uma soluo cliente Lotus Notes para WAN, reduzindo-a a um
conjunto de LANs/MANs. Alm disso, adaptar uma base para o acesso via web possui desafios e
caractersticas prprios, que no so o objetivo deste curso.

Uma outra preocupao com bases de dados Notes o volume de documentos que ser hospedado.
Bases muito volumosas, com documentos muito grandes ou com muitos documentos pequenos
podem se tornar muito lentas, a depender das condies, de modo intolervel.

A seguir, so demonstradas algumas aes referentes a bases de dados Notes.

1.1. Monitorar o tamanho da base de dados:
1 Seleciona a base de dados na rea de trabalho;
2 Acessa o menu Arquivo > Banco de Dados > Propriedades;
3 Selecione a aba informaes (i).
OBS: clicando no boto % de uso v-se o estado de compactao da base. Este percentual deve
estar em torno de 96% (quanto maior melhor). Caso no esteja, possvel compact-la manualmente
clicando no boto Compactar. Aps alguns minutos (talvez muitos) o servidor faz a compactao.
Esta ao importante aps a excluso de documentos. Caso no tenha pressa, pode-se esperar
por rotinas automticas do servidor Domino de compactao de bases.

1.2. Copiar um link de Base de Dados
1 Clicar com o boto direito do mouse sobre o link de base de dados que deseja copiar;
2 No sub-menu Banco de Dados, selecionar a opo Copiar como Link.
OBS: uma vez copiado, um link de banco de dados pode ser colado em uma mensagem de correio e
enviado para algum destinatrio.

1.3. Criando uma cpia local de uma base de dados
1 Na rea de Trabalho, clicar com o boto direito do mouse sobre o link da base de dados;
2 No sub-menu Banco de Dados, selecionar a opo Nova Cpia;
3 No campo Ttulo, digite o nome da base, ex: Brunor local;
LAN (Local Area Network) um sistema que interliga computadores em uma rea de alcance
bastante restrita. Em geral limita-se a prdios ou at mesmo prdios prximos. Em distncias
maiores, so necessrias outras tecnologias, formando MANs (Metropolitans Area Network), no
caso de espao geogrfico em uma mesma cidade, e WANs (Wide Area Network), em caso de
redes de longo alcance, como a nternet ou redes coorporativas como a da Chesf.

4 Clique no boto ao lado do campo Nome do Arquivo e selecionar a pasta de destino da
cpia ( ), confirmando no boto OK.

1.4. Criar uma nova base de dados:
1 Acessa o menu Arquivo > Banco de Dados > Novo;
2 Em Servidor, mantenha Local (s administradores podem criar novas bases de dados em
servidores pblicos);
3 Digite o Ttulo (nome da base de dados);
4 Conforme a necessidade, altere o nome do arquivo (extenso nsf);
5 Clique no cone da pasta amarela ( ) e indique o diretrio de salvamento;
6 Clique no boto OK para concluir.

1.5. Controle de acesso
2 No sub-menu Banco de Dados, selecionar a opo Controle de Acesso. L voc encontrar
um conjunto de usurios delegados, para os quais voc poder adicionar ou remover
atribuies, marcando ou desmarcando as caixas de verificao correspondentes.
OBS: nunca adicione ou remova atribuies de usurios pr-existentes, pois rotinas de correes
automticas de sua base no mais podero ser executadas, caso sejam necessrias. Nunca rebaixe
a sua prerrogativa de Gerente, pois no poder desfazer esta ao, pois j no mais ser gerente da
sua prpria caixa de correio. O controle de acesso uma funo que no tem efeito para bases de
dados locais.

1.6. Abrir uma base de dados no Notes Designer
2 Clicar no sub-menu Abrir no Designer.

1.7. Abrir uma base de dados no browser
1 No nternet Explorer, digitar https://servidor/diretrio/nomeDaBase.nsf;
2 Ex: https://sede10/Aplic/da/Atos.nsf.
Obs: como j foi dito anteriormente, para que uma base seja acessada via browser necessrio que
sejam criadas algumas condies mnimas.

2. EIementos bsicos de uma Base de Dados Notes
Os elementos bsicos de uma base de dados Notes so sete: formuIrio, viso, estrutura de
tpico, pgina, conjunto de quadro, sub-formuIrio e campo compartiIhado. Obs: as
informaes aqui presentes esto de acordo com a verso 5.0 do Notes.

O formuIrio a interface de entrada de dados da base. composto por um conjunto de campos,
que so reas especficas de um formulrio destinadas insero dos dados. No sistema Notes, no
existe o conceito de tabelas de dados, como no Access, Paradox ou como em SGBD's (Oracle,
SQLServer, MySQL, etc), a estrutura de dados definida pelos campos inseridos no formulrio. O
Notes tambm no tem suporte lgica relacional, portanto no pode ser acessado via linguagem
SQL (existe um programa que faz a converso de linguagens, o NotesSQL, mas tem que ser
instalado no servidor Lotus Domino).

A viso a interface de acesso aos documentos salvos na base. uma matriz (tabela) de dados,
onde as colunas representam os campos de um formulrio, as linhas so representaes dos
documentos salvos e as clulas so os dados salvos nos campos dos formulrios. No Notes no
existe o conceito de relatrio, as vises so o que h de mais prximo de um relatrio.

Estrutura de tpico um elemento de layout que serve para facilitar a organizao do acesso aos
diversos tipos de elementos de interface da base de dados, tais como vises e formulrios. Aps
inserido em uma pgina, funciona como um menu de acesso aos recursos da base de dados.

Pgina um elemento bsico de interface com usurio. Nela, o designer pode inserir informaes,
imagens, figuras, grficos, Java Applets, link's de acesso, elementos incorporados (como estruturas

de tpicos), entre outros. Serve, basicamente, para repassar informaes aos usurios e estruturar o
acesso aos diversos elementos da base de dados.

Conjunto de quadro um elemento de layout que serve para distribuir o espao da tela em quadros,
nos quais so inseridos outros elementos da base, como pginas e vises. O uso de conjuntos de
quadros melhora a interface com o usurio, tornando a navegao mais inteligente.

O sub-formuIrio funcionalmente idntico a um formulrio. O que o distingue que ele pode ser
inserido em vrios formulrios distintos. til quando se deseja produzir um conjunto de informaes
e campos que sero necessrios em vrios formulrios (um cabealho padro, por exemplo),
evitando a criao em multiplicidade de campos e outros elementos do formulrio (redundncia).

O campo compartiIhado um campo criado independentemente de formulrio e que pode ser
usado em vrios formulrios. O objetivo do uso de campos compartilhados tambm evitar a
redundncia.

Figura 1: Elementos de Estrutura

No Painel de Design da Figura 1 vem-se os elementos bsicos de estrutura detalhados
anteriormente, alm de outros. Clicando em algum dos elementos exibida a lista dos elementos
criados no Painel de Trabalho (lista de formulrios, lista de vises, etc).
3. Criao de FormuIrios
No painel de trabalho h um boto para criar um novo formulrio em branco (vazio), ou pelo menu
Criar > Estrutura > FormuIrio. A construo de um formulrio uma operao simples, mas que
requer alguns cuidados. Basicamente, resume-se a introduzir campos e alterar as configuraes
deles e as propriedades do prprio formulrio. A Figura 2 mostra a janela de formatao de
formulrios. O paineI de trabaIho a rea onde so inseridos os campos e outros objetos para
construir o formulrio. A janeIa de configurao exibe informaes configurveis de objetos
inseridos e do prprio formulrio. PaineI de script a rea destinada a introduzir lgica na
construo do formulrio. O paineI do programador possui duas abas: objetos, que exibe opes
de configurao de objetos do formulrio, e referncia, que exibe informaes sobre campos e
Painel de Trabalho
Painel de
Design

frmulas de design. Para exibir o painel do programador e o painel de script clicar no menu Exibir
PaineI do Programador. Para exibir a janela de configurao, clicar no menu Estrutura
Propriedades (atalho AIt + Enter).

Figura 2: Janela de Formatao de Formulrio

A primeira alterao a ser feita em um formulrio aps a sua criao a alterao do seu nome, o
que pode ser feito na janela de configurao de formulrio. Recomenda-se no utilizar caracteres
especiais, visto que uma informao puramente estrutural (no afeta a interface) e que pode vir a
ser utilizado em algum script ou frmula. O ttuIo da janeIa, que exibido na interface, pode ser
alterado selecionando-a no painel do programador e digitando o seu valor entre aspas duplas no
painel de script. Outras configuraes de formulrios sero vistas mais adiante.

Para adicionar campos, clicar no menu Criar > Campo... inserido um campo com configurao
padro. No notes todos os campos so originalmente iguais, o que os distingue so as mudanas de
parmetros de configurao. Na Figura 3 temos a janela de parmetros de configurao de campos,
com a opo de tipos de campos destacada a direita. Na Figura 4 temos vrios campos com os
parmetros tipo distintos. Eles esto representados pelas respectivas visualizaes no modo de
execuo, e no no modo de design. Outro parmetro importante o nome, para o qual devemos ter
o mesmo cuidado que tivemos com o nome do formulrio. Uma importante dica para nomes de
Painel de
Trabalho
Painel do
Programador
Painel de Script
Janela de
ConIigurao

campos inserir como prefixo um acrnimo do formulrio ao qual pertence (ex: cli_nome, do
formulrio cliente). Este cuidado facilitar muito o trabalho do designer na configurao de vises.

Figura 3: Parmetros de configurao de campos

Figura 4: Formulrio com vrios campos

Na Figura 4 so destacados os principais tipos de campos, os demais sero vistos posteriormente.
Na Figura 5 temos selecionadas as abas de controle especficos de alguns tipos de campos, com
Texto
DataHora
Numrico
Lista de
Dilogo
Caixa de verificao
Boto de opo
Listagem
Caixa de Combinao
Hipertexto (Rich Text)

seus respectivos parmetros de configurao. Da esquerda para a direita e de cima para baixo temos
as abas de controle dos tipos Data/Hora, Numrico, Lista de Dilogo e Caixa de Verificao.

Figura 5: Abas de controle especficas

No que se refere apresentao do formulrio, h vrias opes para format-lo. possvel inserir
texto formatado em qualquer parte, o menu Texto possui vrias opes de configuraes de texto,
tais como tipo, fonte, cor, recuo, espaamento, alinhamento, numerao, itenizao, entre outros.
Atravs do menu Criar, tambm possvel inserir figuras e tabelas, para organizar a distribuio de
elementos no formulrio. Para configurao de tabelas h o menu TabeIa. Outro objeto que pode ser
inserido a Seo (menu Criar > Seo > Padro), que serve para delimitar uma determinada rea
do formulrio para ser visualizada de modo opcional (Figura 6). Dentro de uma seo podem ser
inseridos quaisquer outros objetos do formulrio, incluindo outras sees. Uma seo tambm possui
parmetros prprios de configurao. Outros objetos que podem ser inseridos pelo menu Criar sero
vistos posteriormente em momento oportuno.

Figura 6: Seo aberta/fechada
Data/Hora
Numerico
Lista de
Dialogo
Caixa de
VeriIicao

4. Criao de Vises
Para acessar a lista de vises, clique na opo Vises do Painel de Design. Uma primeira viso (sem
ttulo) criada automaticamente. Ela pode e deve ser usada como primeira viso, alterando seus
parmetros de configurao e salvando as modificaes. Esta viso se diferencia das demais, pois
no poder ser excluda, mesmo que no seja mais necessria. Para criar novas vises clique no
boto Nova Viso do Painel de Trabalho.

Figura 7: Nova Viso

Construir uma viso adicionar colunas, definir quais campos sero exibidos nestas colunas e alterar
alguns poucos parmetros de configurao destas colunas e do prprio formulrio. Um primeiro
parmetro a ser alterado o Nome, que, ao contrrio do formulrio, pode ser definido com caracteres
especiais, espaos em branco, etc. Para efeito de compatibilidade com programao, usa-se um
nome alternativo, o AIias. Este segue as mesmas restries que nomes de formulrios. Para agrupar
as vises pode-se utilizar um prefixo comum no nome seguido de "\ (ex: Clientes\Dados Bsicos).

Figura 8: Configurao de Viso

Por padro, uma viso exibe todos os documentos da base de dados a qual pertence. Pode-se inserir
opes de seleo na viso, clicando em SeIeo de viso do Painel do Programador, para filtrar os
documentos que sero exibidos. As condies de limitao so adicionadas clicando no boto
Adicionar Condio do Painel de Script. Elas podem ser por autor, por data, por campo ou por
formuIrio. Outras formas de filtro usando frmulas sero vistas mais adiante. Um dos papis do
designer entender as necessidades dos usurios para criar vises que possam garantir o acesso
fcil e rpido aos dados. Para isso, deve utilizar filtros adequados para exibir, apenas, os documentos
essenciais em uma viso. Uma dica importante para quem deseja limitar o acesso a determinadas
informaes ocultar certas vises para os usurios. Para faz-lo seleciona a viso que deseja
ocultar no Painel de Trabalho da lista de vises (Figura 7), clique no menu Estrutura > Propriedades
da Estrutura, selecione a aba Estrut. (estrutura, ) e marque a opo OcuItar eIemento de
estrutura de CIientes do Notes 4.6 ou posterior (ou Ocultar elemento de estrutura de Browsers da
Web estas duas opes podem ser marcadas simultaneamente, ocultando o acesso viso tanto
via cliente Notes quanto via browser da Web). Este resultado tambm pode ser obtido nomeando a
viso entre parntese, podendo ser exibida como um elemento incorporado (esta vantagem ser mais
bem compreendida quando estivermos vendo viso incorporada no ltimo tpico desta apostila).

Figura 9: Criando e configurando colunas

Toda viso recm criada j traz uma primeira coluna que pode e deve ser utilizada. Para inserir outra,
clicar no menu Criar > Inserir Nova CoIuna ou Criar > IncIuir Nova CoIuna. A ultima opo inclui
uma nova coluna na posio mais direita da viso. A primeira opo insere uma coluna na posio
mais esquerda da viso ou imediatamente esquerda de uma coluna, caso alguma tenha sido
selecionada. Para adicionar funcionalidade a coluna, pode-se definir qual o seu contedo. Para isso,
no Painel de Script, existem Funes SimpIes pr-definidas que podem ser utilizadas, tais como
autor do registro, data de criao, ltima modificao, entre outras. Pode-se tambm optar por exibir
um dos campos de um dos formulrios criados, selecionando Campo, no Painel de Script, onde ser
exibida uma lista com todos os campos de todos os formulrios criados nesta base de dados, em
ordem alfabtica crescente (isso mostra a importncia de adicionar como prefixo de cada campo um
acrnimo do formulrio ao qual pertence, para que os campos de um mesmo formulrio sejam
agrupados na ordenao). Uma observao importante que campos do tipo rich-text no podem ser
exibidos em vises, por conter dados em formato de hipertexto (anexos, imagens, figuras, link's, etc.).
Uma terceira opo seria o uso de FrmuIa, que ser detalhado nos prximos tpicos, bem como
outras opes de configurao de vises e colunas.

5. Criao de Estruturas de Tpicos
Para acessar a lista de estruturas de tpicos, clique na opo Estrutura de Tpicos do Painel de
Design. Para criar novas estruturas de tpicos clique no boto Nova Estrutura de Tpicos do Painel
de Trabalho. Uma estrutura de tpico , basicamente, um menu. Sendo assim, para definir uma nova
entrada na estrutura clica no boto Nova Entrada. Deve-se definir o RtuIo para a entrada. Para o
tipo de contedo, as opes mais importantes so EIemento Definido e URL. Quando selecionar
elemento definido necessrio definir qual o tipo de elemento de estrutura ser exibido, pgina,
viso, formulrio (novo, em branco), etc. Aps definir o tipo de elemento de estrutura, necessrio
selecionar um dos elementos da lista para o campo VaIor (clicar no boto Pesquisar ). Para definir
uma URL basta selecionar este tipo e digitar o endereo Web no campo VaIor. No campo Quadro
pode-se indicar o quadro de destino em que o elemento deva ser aberto, para o caso de utilizar
conjunto de quadros, que ser visto nos prximos tpicos. Caso o campo Quadro fique em branco,
por padro, o cliente Notes abrir o elemento em uma nova janela. No caso de acesso via browser da
Web, o elemento ser aberto no quadro atual da estrutura de tpicos. No essencial escolher uma
imagem para a entrada de estrutura, pois, para alguns casos, o prprio Domino Designer gera uma
imagem. Caso deseje personalizar necessrio disponibilizar a imagem que deseja usar previamente
em Recursos de magens. Na aba de ocultao possvel esconder a entrada para o Cliente Notes
ou para o acesso via browser da Web.

Figura 10: Parmetros de configurao de entrada de estrutura de tpicos

O tipo pode ser definido como (Nenhum), servindo apenas como organizador. Caso deseje que uma
entrada seja apresentada de modo hierrquico, sub-entrada (como um sub-menu), basta recu-la
para a direita (Figura 11).

Figura 11: Exemplo de estrutura de tpicos com sub-entradas
Tipo (Nenhum)
Tipo Viso

6. Criao de Pginas
Para acessar a lista de pginas, clique na opo Pginas do Painel de Design. Para criar nova
pgina clique no boto Nova Pgina do Painel de Trabalho. No que se refere diagramao de uma
pgina, ela propicia as mesmas opes de formatao e objetos a inserir que os formulrios, a
exceo de campos, tais como estrutura de tpicos, imagens, figuras e sees. Muitos parmetros de
configurao tambm so os mesmos dos formulrios, tais como TtuIo da JaneIa e Nome. As
opes de segundo plano tambm so as mesmas e sero aqui destacadas.

Figura 12: Parmetros de configurao de segundo plano

As configuraes de segundo plano seguem padro de compatibilidade com a Web, logo, pode-se
definir uma cor e uma imagem ou figura. Caso seja definida uma imagem ou figura possvel coloc-
la lado a lado ou ocult-la, conforme a necessidade.

Figura 13: Criao de Tabela

Outra opo de layout comum a pginas e formulrios a tabela. O Notes possui quatro opes de
tabela: bsica, formato de divisrias, animada (exibe cada linha por 2 segundos) e programada (exibe
uma linha a partir do valor de um campo). Elas possuem as opes bsicas de formatao de
tabelas, como espessura e cor de linha e cor e imagem de segundo plano.

7. Criao de Conjuntos de Quadros
Para acessar a lista de conjuntos de quadros, clique na opo Conjuntos de Quadros do Painel de
Design. Para criar novo conjunto de quadros clique no boto Novo Conjunto de Quadros do Painel
de Trabalho. O Notes possui conjuntos de quadros com 2, 3 ou 4 quadros, cada um com quatro
opes de layout (Figura 14). Aps a criao do conjunto de quadros deve-se definir um Nome e um
TtuIo, este ltimo opcional, pois o cliente notes mostrar o nome ou ttulo do elemento do quadro.

Figura 14: Opes de Conjunto de Quadros

Para cada quadro deve-se definir o nome do quadro, o tipo de objeto a ser exibido (para o caso de
elementos de estrutura deve-se selecionar tambm o tipo de elemento, viso, pgina, etc.) e o valor
do objeto (nome ou alias da viso, da pgina, etc.). Pode-se definir um quadro padro de destino para
link's no quadro. Nas outras abas da janela de Parmetros de Configurao de Quadro pode-se
definir opes de largura de quadro, barra de rolagem, permisso de re-direcionamento, largura e cor
de borda e definies de margens.

Figura 15: Janela de Parmetros de Configurao de Quadro

8. Criao de Sub-formuIrios
Para acessar a lista de subformulrios, clique na opo Recursos > SubformuIrios do Painel de
Design. Para criar novo subformulrio clique no boto Novo SubformuIrio do Painel de Trabalho.
Como j foi citado anteriormente, um subformulrio funcionalmente idntico a um formulrio. O que
o distingue que ele pode ser inserido em vrios formulrios distintos, quando se deseja inserir um
conjunto de informaes e campos que sero necessrios em vrios formulrios. Outra diferena
que um subformulrio no possui muitas opes de parmetros de configurao como as formulrios.

Pode-se configurar apenas o Nome, opo de disponibilidade de subformulrio para insero em
formulrios e opo de disponibilidade de subformulrio para criao de documentos, como em um
formulrio. Para inserir um subformulrio em um formulrio, abra o formulrio onde o subformulrio
ser inserido, posicione o cursor no ponto de insero e clique na opo de menu Criar > Inserir
SubformuIrio.

Figura 16: Janela de Parmetros de Configurao de Subformulrio

9. Criao de Campos CompartiIhados
Para acessar a lista de campos compartilhados, clique na opo Recursos > Campos
CompartiIhados do Painel de Design. Para criar novo campo compartilhado clique no boto Novo
Campo CompartiIhado do Painel de Trabalho. Um campo compartilhado um campo criado
independentemente de formulrio e que pode ser usado em vrios formulrios. O objetivo evitar que
campos que tm a mesma funo sejam criados vrias vezes em formulrios diferentes, quando se
poderia criar um s campo compartilhado e inseri-lo nos formulrios onde so necessrios. As opes
de configurao de campos compartilhados so as mesmas de campos comuns. Para inserir um
campo compartilhado em um formulrio, abra o formulrio onde o campo ser inserido, posicione o
cursor no ponto de insero e clique na opo de menu Criar > Inserir Campo CompartiIhado.
10. Tpicos avanados de Campos CompartiIhados e FormuIrios
Este tpico destinado insero de programao e automao em campos de formulrios e
campos compartilhados. No Notes, os campos podem ser editveis ou programveis. Para este
ltimo caso, existem trs opes: Computado, Computado p/ exibio e Computado quando
composto (Figura 17). Eles diferem com relao atualizao do valor do campo. Computado
quando composto s aceitar atualizao antes do salvamento, Computado aceitar atualizao
sempre que o documento for salvo e Computado para exibio atualizar sempre que o documento
for exibido.

Figura 17: Opes de Campos Programveis

Na Figura 18 temos um exemplo de um campo chamado Tes_totaI que foi definido como campo
computado. Ele deve exibir um VaIor equivalente ao campo Tes_vaIor acrescido do percentual do
campo Tes_percentagem (Tes_TotaI = Tes_vaIor + Tes_vaIor X Tes_percentagem%, exemplo
Tes_totaI = 20 + 20 X 10%). As variveis v e p so substitutos para os campos Tes_valor e

Tes_percentagem, respectivamente. O Notes no um ambiente de programao, ele possui,
apenas, reas destinadas introduo de scripts. Como a maioria das linguagens de script, no
necessrio declarar previamente uma varivel, bastando, simplesmente, inici-la, pois o Notes se
encarrega de definir uma rea de memria compatvel com o valor a ser armazenado. Exemplo, x :=
10, onde x a varivel, := o smbolo de atribuio e 10 o valor que ser armazenado na varivel x
(o Notes reservar uma rea da memria capaz de armazenar o nmero 10 e atribuir seu valor a
varivel x). O uso de variveis no obrigatrio, a programao do Valor do campo Tes_total poderia
ser substituda por Tes_vaIor + Tes_vaIor * Tes_percentagem / 100, contudo a sua utilizao torna
as frmulas e equaes mais simples e fceis de escrever e entender, constituindo boa prtica de
programao. O Notes no diferencia maisculas de minsculas para ambiente de programao.

Figura 18: Valor do campo Tes_total no Painel do Programador

Para que a frmula funcione corretamente, os campos Tes_valor e Tes_percentagem devem ser
iniciados com VaIor Padro vlido (0, por exemplo Figura 19).

Figura 19: Valor Padro do campo Tes_valor

Uma maneira muito comum de inserir programao utilizando estruturas de controle de fluxo. O
Notes disponibiliza uma frmula padro para controle de fluxo, a @if. No Notes, todas as frmulas
padronizadas so iniciadas com o smbolo @. Para entender como o @if funciona vamos utilizar a
seguinte situao: o campo Tes_tipo do tipo caixa de combinao com as opes A, B e C; caso a
opo A seja selecionada, o percentual do Valor do campo Tes_total deve ser 20%, caso contrrio,
deve ser o percentual do campo Tes_percentagem. A frmula resultante a exibida na Figura 20,
onde Tes_tipo = "A" a condio a ser testada (verdadeira ou falsa), a o valor a ser assumido
para a condio verdadeira e x o valor a ser assumido para a condio falsa. O ; o separador.

Figura 20: Valor do campo Tes_total com frmula @if

No modo de execuo do formulrio (cliente notes), para atualizar a exibio de campos computados
tecle F9 no teclado. Para tornar estas atualizaes automticas ative as opes AtuaIizar campos
ao aIterar paIavra chave e AtuaIizar campos automaticamente, do campo computado e do
formulrio, respectivamente (Figura 21).

Figura 21: Atualizaes automticas de campos e formulrios

O Notes permite a introduo de estruturas condicionais aninhadas, ou seja, vrios @if aninhados,
um dentro do outro. Para entender como funciona vamos utilizar a seguinte situao: o campo
Tes_tipo do tipo caixa de combinao com as opes A, B e C; caso a opo A seja selecionada, o
percentual do Valor do campo Tes_total deve ser 20%, caso a opo B seja selecionada, o
percentual do Valor do campo Tes_total deve ser 10%, caso a opo C seja selecionada, o
percentual do Valor do campo Tes_total deve ser o percentual do campo Tes_percentagem, caso no
haja opo selecionada, Tes_total deve ser zero (0). A frmula resultante a exibida na Figura 22.

Figura 22: Valor do campo Tes_total com frmulas @if aninhadas

Os campos editveis possuem um atributo chamado VaIidao da Entrada, que serve para impedir
que o documento seja salvo com algum valor de campo incorreto ou em branco. Para entender como
funciona este recurso vamos utilizar a seguinte situao: o campo Tes_tipo no pode ser deixado em
branco, obrigatrio selecionar uma de suas opes (A, B ou C). Sendo assim, basta preencher o
atributo VaIidao da Entrada com a frmula:

@If(Tes_Tipo = "";@Failure("Tipo em branco, selecione uma opo.");@Success)

Onde @FaiIure uma funo que impede o salvamento do documento, exibindo mensagem de
advertncia (entre aspas), e @Success a funo que torna o valor do campo vlido.

Outro atributo importante dos campos editveis a Converso da Entrada. Serve para alterar o
valor de um campo no momento em que validado o seu valor. Para entender como funciona este
recurso vamos utilizar a seguinte situao: no campo Tes_equipe deve ser digitado o nome da equipe
sempre com letras maisculas. Caso no sejam usadas letras maiscula, o valor do campo deve ser
alterado para tal. Sendo assim, basta preencher o atributo Converso da Entrada com a frmula:
@UpperCase(Tes_equipe), onde @UpperCase uma funo que torna todas as letras do campo
Tes_equipe maisculas (todas ninsculas @LowerCase).

Quando queremos inserir uma programao num formulrio nem sempre til salvar o contedo do
clculo. Para esta situao o Notes dispe de um objeto chamado Texto Computado. Ele aceita as
mesmas formatao e programao de um campo computado, mas o seu valor no ser salvo junto
com o documento. uma opo valiosa tanto para o caso de no querermos desperdiar espao de
armazenamento na base de dados com informaes que podem ser rapidamente calculadas em
tempo real, quanto para pginas, que no possuem campos e a nica opo de inserir programao
com o uso de texto computado. Para inserir um texto computado posicione o cursor no ponto do
formulrio, sub-formulrio ou pgina onde deseja inseri-lo e clica no menu Criar > Texto
Computado. Os documentos salvos possuem campos ocultos cujo contedo salvo de modo
automtico, tais como autor (@Author), data e hora de criao (@Created), data e hora de
modificao (@Modified), tamanho em bytes (@DocLength), identificao nica de documento
(@DocumentUniqueD), entre outros. A identificao nica de documento uma numerao de 32
dgitos hexadecimais que serve para identificar os documentos de modo nico em uma base de
dados. Como um nmero, para que possa ser visualizada em um campo computado necessrio
trat-lo como texto, usando a funo @Text, @Text(@DocumentUniqueD). O campo autor exibe o
nome distinto do autor, com o nome e localizao do servidor ao qual pertence (Bruno Ricardo Costa
Nunes/pauloafonso2/chesf). Para exibir apenas o nome do autor (Bruno Ricardo Costa Nunes) utiliza
a funo @Name, @Name([CN]; @Author). Caso deseje recuperar apenas o nome hierrquico
(pauloafonso2/chesf), substitua CN por HierarchyOnly, @Name([HierarchyOnly]; @Author). Tambm
possvel recuperar o nome hierrquico invertido (chesf/pauloafonso2), @Name([ToKeyword];
@Author).

Um outro recurso importante para formulrios, pginas e, at mesmo, vises a Ao. Aes podem
ser acessadas tanto via menu Aes, quanto atravs de botes em barra especfica que ficam
disponveis no canto superior esquerdo do formulrio, pgina ou viso (Figura 23).

Figura 23: Formulrio com barra de botes

Para exibir o PaineI de Aes, clica no menu Exibir > PaineI de Ao. J existem algumas aes
pr-configuradas que podem ser formatadas conforme a necessidade. Para acessar as propriedades
de uma ao selecione-a no painel de aes e clica no menu Estrutura > Propriedades da Ao.
Entre as opes que podem ser alteradas temos o Nome que ser exibido, a Posio em relao a
outros botes da barra, ncluir ao na barra de botes, ncluir ao no menu Aes e opes de

exibio de grfico no boto (o prprio Notes disponibiliza um conjunto de 155 grficos que podem
ser utilizados). Para adicionar nova ao clica no menu Criar > Ao. Tambm possvel configurar
a barra de botes. Para exibir as propriedades da barra de botes selecione uma ao qualquer no
painel de aes e clica no menu Estrutura > Propriedades da Barra de Ao.

Figura 24: Propriedades de ao e opes de imagem

Na Figura 24, o nome da ao aparece com um sinal de underline antes da letra d, cuja funo criar
uma opo de atalho pela tecla d quando a ao acessada via menu Criar > Ao. Como exemplo,
vamos inserir uma nova ao, alterar seu nome para Novo e alterar o contedo da sua Frmula para
@Command([Compose];"NomeDoFormulario"). Esta ao criar um novo documento em branco a
partir do formulrio NomeDoFormuIario, onde @Command uma funo especial de executa
comandos via Notes e Compose o comando para criar um novo documento em branco (exige como
parmetro o nome do formulrio). Veja abaixo outros comandos teis que so comumente usados em
aes:
@Command([FileSave]) Salva os dados do documento;
@Command([FileCloseWindow]) Fecha janela ativa. No caso de um documento, caso seus
dados tenham sofrido alterao, uma janela perguntar sobre a necessidade de salvamento
dos dados;
@Command([FileSave]); @Command([FileCloseWindow]) Salva os dados do documento e
fecha a janela (o ponto e vrgula entre os comandos obrigatrio);
@Command([FilePrint]) Abre a janela de impresso de documentos do notes;
@Command([Execute]; "calc.exe" ) Executa algum programa instalado no sistema
operacional da mquina local, onde caIc.exe o executvel Calculadora do Windows XP.
possvel executar no s o programa como tambm abrir um arquivo dentro dele:
@Command([Execute];"winword.exe"; "C:\\Teste\\RestricoesPendentes.doc"), onde as barras
de diviso de diretrio devem ser digitadas aos pares, por questo de compatibilidade com a
Web. Caso o executvel no esteja em um diretrio padro do sistema operacional, haver a
necessidade de digitar o caminho completo, com as duas barras de diretrio.

De modo independente da barra de botes, possvel inserir botes em qualquer parte de um
formulrio ou pgina. Basta posicionar o cursor no ponto de insero e clicar no menu Criar > Ponto
de Aceso > Boto. Possui os mesmos comandos e frmulas utilizados em aes, com, praticamente,
as mesmas opes de formatao, a exceo dos grficos, que no esto disponveis para este tipo
de boto. Tambm possvel vincular um texto ou imagem a uma frmula. Basta selecionar o objeto
que ser vinculado e clicar no menu Criar > Ponto de Aceso > Ponto de Acesso de Ao. Possui

os mesmos comandos e frmulas utilizados em Botes, com as mesmas opes de formatao. H
outros tipos de pontos de acesso:
Criar > Ponto de Aceso > VincuIar Ponto de Acesso cria um ponto de acesso no objeto
selecionado para uma URL ou elemento de estrutura, como pginas e vises;
Criar > Ponto de Aceso > Popup de Texto cria uma legenda flutuante para um objeto
selecionado;
Criar > Ponto de Aceso > Popup de FrmuIa cria uma legenda flutuante para um objeto
selecionado que pode ter seu contedo modificado a partir do resultado de uma frmula.

Em formulrios Notes possvel organizar os campos e outros objetos em regies de layout. A
vantagem que as regies de layout permitem que o designer organize melhor os objetos. Para
inserir uma regio de layout posicione o cursor no ponto de insero e clique no menu Criar > Regio
de Layout > Nova Regio de Layout. Para inserir legendas de texto selecione a regio de layout e
clique no menu Criar > Regio de Layout > Texto.

O Notes permite que um campo seja definido como multivalorado, ou seja, em um nico campo pode-
se armazenar vrios valores. Pode-se definir este recurso marcando a opo Permitir vrios
vaIores, na janela de parmetros de configurao do campo. Quando estivermos vendo tpicos
avanados de vises veremos como este recurso pode ser til.

O Notes permite que, a partir de um formulrio, o usurio possa enviar um e-mail Notes incorporando
informaes do formulrio. Como exemplo, crie um boto ou uma ao no formulrio e adicione a
seguinte frmula:

@MailSend(para; copia; copia_oculta; "Ttulo do E-mail"; "Cabealho do E-mail."; "Corpo
do E-mail." + @NewLine + "Clcuo do valor total: "
+@Text(Tes_total);[IncludeDocLink]);

A frmula @MaiISend possui sete parmetros a serem passados:
para, copia, copia_ocuIta esses parmetros referem-se aos destinatrios do e-mail. Pode-
se passar como texto ("Bruno Ricardo Costa Nunes/pauloafonso2/chesf), lista de texto
("Bruno Ricardo Costa Nunes/pauloafonso2/chesf : "Marcos Antonio de
Oliveira/pauloafonso2/chesf) ou um campo do tipo Nomes onde o usurio pode digitar o
destinatrio que desejar (Lembre de marcar Permitir vrios vaIores, na guia Bsico, e, na
guia ControIe, selecionar Usar caixa de diIogo Endereos para fazer opes, e marcar
as opes Procurar nomes ao inserir caracteres e Exibir boto de ajuda de entrada
Figura 25);

Figura 25: Configurao de campo tipo Nomes


TtuIo do E-maiI, CabeaIho do E-maiI, Corpo do E-maiI parmetros conforme descrio.
Pode-se utilizar texto, campos formatados para texto (funo @Text) ou texto e campos
concatenados (+). A funo @NewLine faz uma quebra de linha no texto;
[IncIudeDocLink] este parmetro inclui um link para o documento. Caso o documento no
tenha sido salvo aparecer uma mensagem de erro para o destinatrio que clicar no link.

Caso seja necessrio omitir um ou mais parmetros substitua-os por pares de aspas duplas(").

11. Tpicos avanados de Vises
A SeIeo de viso utilizando o mtodo FciI limitada. Para termos acesso a mais recursos
necessrio utilizar o mtodo FrmuIa. Como exemplo, vamos selecionar os documentos do
formulrio Teste, cujo campo Tes_equipe seja PIanejamento e cujo campo Tes_totaI seja maior
que 2.500,00:

SELECT Form = "Teste" & Tes_equipe = "PLANEJAMENTO" & Tes_total >2500

Neste outro exemplo, vamos selecionar os documentos do formulrio Teste, cujo campo Tes_valor
seja maior que 2.000,00 ou cujo campo Tes_percentagem seja maior que 30%:

SELECT Form = "Teste" & (Tes_valor > 2000 | Tes_percentagem >30)

Os smbolos & e | correspondem, respectivamente, aos operadores lgicos E (AND) e OU (OR).

No Notes tambm possvel inserir programao nas colunas da viso. Como exemplo, vamos
inserir uma Frmula em uma coluna para exibir VaIor Baixo quando o campo Tes_total for menor do
que 2.000,00 e VaIor AIto, caso contrrio:

@If(Tes_total < 2000; "Valor Baixo."; "Valor Alto.")

Em vises Notes pode-se ocultar uma coluna, mantendo a sua funcionalidade. Por exemplo, pode-se
inserir uma coluna com a data de criao do documento classificando esta coluna como decrescente,
ocultando-a em seguida, marcando a opo OcuItar coIuna, na janela de propriedades. Assim, os
documentos seriam classificados em ordem decrescente pela data de criao sem exibir tal coluna.

Um outro recurso muito til das vises Notes a categorizao de colunas. Consiste em agrupar os
documentos de uma viso a partir do valor de uma determinada coluna. Como exemplo, vamos definir
a primeira coluna da viso (Equipe) com o campo Tes_equipe e agrupar os documentos pelo valor
deste campo. Para isso, marque as opes Mostrar quebra quando a Iinha for expansveI e
Categorizado, na janela de propriedades (Figura 26).

Figura 26: Opes de Categorizao de Coluna

O resultado o exibido na Figura 27.

Figura 27: Viso Teste com coluna Equipe categorizada e uma coluna exibindo cone

Outro recurso que pode ser til a exibio de um cone em uma coluna. Para que isso seja possvel
necessrio marcar a opo Exibir vaIores como cones na janela de propriedades. Alm disso, o
valor da coluna tem que ser um nmero inteiro e pertencer ao intervalo que vai 1 a 176, ou seja, o
Notes possui 176 opes de cones. Na Figura 27, a sexta coluna possui uma frmula que retorna
115 quando o campo Tes_totaI for menor do que 2.000,00 e 114, caso contrrio:

@If(Tes_total < 2000; 115; 114).

A Tabela 1 traz uma relao entre o valor numrico e o cone que este valor representa. A tabela
funciona da seguinte forma: o cone 115 est na coluna 11 e na linha 5, ou seja, o nmero
representativo do cone formado pela concatenao da coluna com a linha, respectivamente, 11
com 5 = 115.

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
1
2
3
4
5
6
7
8
9
0

Tabela 1: Relao de cones de Coluna

Para finalizar este tpico, mostraremos como mostrar Totais por Coluna. Basta selecionar a opo
TotaI no parmetro Totais da guia CIassificao da janela de configurao de coluna. O resultado
pode ser visualizado na Figura 27, coluna Total. A cor de Totais da CoIuna pode ser alterada na
janela de configurao de viso, na aba EstiIo.


12. Tpicos avanados de Funes
At agora vimos um nmero limitado de funes, mas o Notes possui uma vasta gama de funes,
que podem ser acessadas no Painel do Programador, na aba Referncia, selecionando a opo
Funes@ de FrmuIas (Figura 28). Alm das funes comuns, h tambm funes de comando,
ou @Command, que podem ser acessadas selecionando a opo Comandos@ de FrmuIas.

Figura 28: Relao de Funes

Para adicionar uma frmula selecione-a no Painel do Programador e clique no boto adicionar. O
boto de ajuda oferece algumas informaes teis sobre a utilizao da frmula e, algumas vezes,
exemplos, mas est em ngls. Para acessar a ajuda em Portugus necessrio abrir o banco de
dados por fora, no servidor sede11, no caminho heIp\heIp5_designer.nsf.

A funo @Now retorna a data-hora atual, mas pega como referncia o sistema operacional do
usurio no recebe parmetro. As funes @Date e @Time retornam a data e a hora,
respectivamente, dado um parmetro data-hora, exemplo: @Date(@Now), @Time(@Now). Outra
funo de data @Weekday, que retorna um nmero para o dia da semana (domingo = 1, segunda
= 2, etc), exemplo @Weekday(@Now). Outras funes teis de data so @Day, @Month e @Year,
que recebem como parmetro um valor de data ou data-hora e retornam o dia do ms, o ms e o ano,
respectivamente. A funo @Adjust ajusta o valor de hora-data passado como parmetro pelo
nmero de anos, meses, dias, horas, minutos e/ou segundos especificado, veja a sintaxe: @Adjust(
dataAAjustar ; anos ; meses ; dias ; horas ; minutos ; segundos ), ex.: @Adjust(@Now;0;-1;0;0;0;0),
retorna a data atual ajustada para o Ms anterior.

O Notes possui algumas funes que retornam valores de bases de dados. A funo @DbCoIumn
procura e retorna uma coluna inteira de valores de uma viso. Sintaxe: @DbColumn( tipoBase :
"NoCache" ; servidor : banco_de_dados ; viso ; NmeroColuna ), onde tipoBase o tipo de base de
dados que est sendo acessada (para o Notes usar ", padro), "NoCache fora que o Notes/Domino
recupere as ltimas informaes para cada pesquisa, sevidor : banco_de_dados serve para
especificar servidor e base de dados que sero acessados (substitua tudo por " para base de dados
atual), viso o nome da viso (entre aspas duplas), e NmeroColuna o nmero da coluna que
ser retornada, ex.: @DbColumn( "" : "NoCache" ; "" ; "Teste" ; 4). Similar ao anterior, @DbLookup
verifica uma viso e localiza todos os documentos contendo o valor-chave na coluna especificada.
Sintaxe: @DbLookup( tipoBase: "NoCache" ; servidor : banco_de_dados ; viso ; chave ;
nmeroColuna ), onde chave o valor a ser localizado, ex.: @DbLookup( "" : "NoCache" ; "" ; "Teste"
; "PLANEJAMENTO" ; 2). Esta funo est sujeita a retornar um erro, caso um valor no seja
encontrado. Para que a execuo da aplicao no seja interrompida, armazene o valor do
@DBLookUp em uma varivel e teste se o seu valor d erro usando a funo @IsError, como
abaixo:
A := @DbLookup( "" : "NoCache" ; "" ; "Teste" ; "PLANEJAMENTO" ; 2 );
@if( @IsError(A) ; 0 ; A )

Sempre que for necessrio comentar uma programao utilize a palavra reservada REM. sso facilita
a manuteno da base de dados. muito til adicionar comentrios a uma frmula longa ou
complicada, pois facilita o entendimento posterior. Sintaxe: REM "Seus comentrios".


13. Criao de Agentes
Usando agentes, possvel automatizar tarefas, pois, trabalhando nas bases de dados do Domino,
eles podem realizar tarefas repetitivas como gerenciar documentos e enviar e-mails. Pode-se criar
agentes simples, escolhendo aes a partir de uma caixa de dilogo, ou complexos, usando frmulas
do Notes. Para acessar a lista de agentes, clique na opo Agentes do Painel de Design. Para criar
novo agente clique no boto Novo Agente do Painel de Trabalho. Todo agente deve ser identificado
com um Nome. Deve-se tambm definir quando o agente ser executado, cuja opo mais simples
ManuaImente a partir do Menu Aes, mas tambm se pode program-lo para executar
periodicamente, selecionando uma das opes (diariamente, mensalmente, etc.) e clicando no boto
Programar para ajustar horrio, dia, etc. Tambm necessrio definir sobre quais documentos ele
deve agir, onde a opo mais comumente usada Documentos seIecionados, que exige que o
usurio marque os documentos sobre quais o agente ser executado (em tempo de execuo, no
cliente Notes). Pode-se usar tambm as opes Todos os documentos da viso ou Todos os
documentos do banco de dados, e deixar o filtro para ser executado na frmula da ao do agente.
Caso deseje que o agente possa ser executado por outros usurios, marque a opo Agente
CompartiIhado. Esta opo s estar disponvel antes do agente ser salvo pela primeira vez. Por
fim, deve-se definir qual ao ser executada, onde podem ser adicionadas aes simples, clicando
no boto Adicionar Ao ou executar frmulas. Para as aes simples, existem vrias opes, tais
como enviar mensagens ou alterar valores de campos. Para executar frmulas, selecione a opo
correspondente e digite a frmula. Abaixo exibido um exemplo.

@If(Ponto_exc_status = "Em Elaborao";
@Do(
@SetField("Ponto_exc_status";"Aguardando Aprovao");
@SetField("Ponto_exc_historico"; Ponto_exc_historico + "Em " +
@Text(@Now) + " -> Envio Automtico" +
@NewLine + @NewLine);
"");
"")

No exemplo acima, caso o campo Ponto_exc_status seja igual a Em EIaborao, o valor deste
campo alterado para Aguardando Aprovao e o campo Ponto_exc_historico alterado para o
valor anterior acrescido de Em mais data-hora atual mais - Envio Automtico mais duas quebras de
linha. Para alterar o valor dos campos utilizada a frmula @SetFieId. A funo @Do utilizada
para concatenar vrias aes em uma mesma resposta para o teste lgico de @If.
14. Tpicos avanados de Bases de Dados
Quando sua base de dados estiver com os elementos bsicos de estrutura concludos, pode-se
definir que elemento ser aberto primeiro quando a base de dados for acessada (Figura 29).

Figura 29: Aba niciar da Janela de Parmetros de Configurao de Bases de Dados

possvel definir opes diferentes para clientes Notes e Browser da Web, como pode ser visto na
Figura 29. As opes mais comumente utilizadas so Conjuntos de Quadros e Pginas.

Outro recurso que pode ser til a utilizao de atribuies. Elas servem para criar perfis de usurios
que podero ser utilizados para complementar as lacunas de segurana deixadas na ACL (Lista de
Controle de Acesso). Para criar atribuies acesse a ACL (Menu Arquivo > Banco de Dados >
ControIe de Acesso), selecione a aba atribuies, clique em Adicionar e digite o nome da
atribuio.

Figura 30: Aba de Atribuies da ACL

Em seguida, selecione a aba Bsico e defina quais atribuies cada usurio ter (Figura 31).

Figura 31: Aba de Opes Bsicas da ACL

15. Tpicos Gerais CompIementares

15.1. Ocultao em elementos de estrutura a partir de atribuies da ACL
nicialmente, veremos como nos beneficiar das atribuies criadas na ACL. Alguns dos elementos de
estrutura permitem que suas entradas, como as estruturas de tpicos, ou seus pargrafos, como
pginas, formulrios e sub-formulrios, sejam ocultados para impedir que um determinado usurio ou
grupo de usurios acessem o que no se quer que seja acessado por ele. Na Figura 32 temos uma
Aba de Ocultao de Pargrafo de um formulrio. Podemos marcar a opo OcuItar parg. se frm.
for verd., ou seja, o pargrafo ser ocultado se o resultado da frmula digitada na JaneIa de
FrmuIas for verdadeira.

Figura 32: Aba de Ocultao de Pargrafo

Como exemplo, vejamos a seguinte frmula: @sNotMember("[Planejamento]"; @UserRoles). A
funo @UserRoIes retorna uma lista com as atribuies da ACL que o usurio corrente possui. A
funo @IsNotMember verifica se "[PIanejamento]" no faz parte da lista de atribuies retornada,
caso no faa parte retorna 1 (verdadeiro) e oculta o pargrafo para aquele usurio, caso contrrio
retorna 0 (faIso) e exibe o pargrafo. Conforme a necessidade, a funo @IsMember poder ser
mais adequada (sintaxe similar).

Para ocultar um pargrafo de texto ou qualquer outro objeto de elemento de estrutura pode-se utilizar
qualquer frmula que retorne valor 1 ou 0 (verdadeiro ou falso). Em particular, as funes @Is_
possuem muitas opes.

15.2. Remover opo de salvamento de formulrio
Por padro, sempre que algum campo de um formulrio alterado em tempo de execuo, o cliente
Notes exibe uma janela de confirmao de salvamento. sto acontece porque todo formulrio Notes
possui um campo numrico oculto denominado SaveOptions, que, por padro, possui valor 1
(verdadeiro), o que provoca sempre a exibio da janela de salvamento quando algum campo
alterado ou uma frmula de campo computado atualizada. Pode ser til para o seu sistema que um
determinado formulrio ignore esta situao e aceite o fechamento sem questionar sobre o
salvamento dos dados modificados. Exemplo: em um formulrio tipo checklist, que s ter utilidade
impresso, no devendo ser salvo. Para utilizar este recurso necessrio que o valor do campo
SaveOptions seja alterado para 0 (faIso). H muitas formas de fazer isto. A seguir exibida uma
frmula que inserida no atributo TtuIo do FormuIrio:

Field SaveOptions := SaveOptions;
@SetField( "SaveOptions"; 0);
"Aqui o Ttulo do seu Formulrio"

A primeira linha obrigatria para poder utilizar a funo @SetFieId.

15.3. Sees de acesso controlado
Como vimos anteriormente, uma seo um objeto que pode ser inserido um formulrio ou uma
pgina e que tem a funo de agrupar outros objetos. Uma seo de acesso controlado como uma
seo comum, mas que possui o recurso adicional de impedir o acesso no modo de edio a pessoas
no autorizadas aos campos internos a ela. muito til quando se deseja criar um workflow, onde
vrias pessoas acessaro um mesmo formulrio, mas com prerrogativas distintas. Exemplo: um plano
de ao.

Figura 33: Aba Frmula da Janela de Parmetros de Configurao de Seo de Acesso Controlado

Na Figura 33 temos a aba Frmula da Janela de Parmetros de Configurao de Seo de Acesso
Controlado. Na rea destinada frmula digite a lista de editores separados por dois pontos (:). Os
nomes de usurios devem ser digitados tal e qual consta na Lista de Endereos. O termo Gerente se
refere a um campo EditveI do tipo Nomes, com Caixa de diIogo de endereos para fazer
opes e com a opo Procurar nomes ao inserir caracteres marcada. Este tipo de campo sempre
gera nomes completos, com o nome do servidor incluso, sendo necessrio inserir a seguinte frmula
no atributo Converso da Entrada: @Name([CN]; Editor).

Uma seo de acesso controlado tambm se comporta como um campo de um formulrio, onde seus
dados so formados pela lista de usurios calculados pela sua frmula. Ela tambm possui um nome
(Nome de campo de seo), para que seus dados possam ser acessados e utilizados, conforme
necessidade.

15.4. Estruturas do tipo Resposta
Alguns sistemas de dados necessitam de uma hierarquia do tipo resposta, ou seja, a partir de um
formulrio pode-se gerar outro hierarquicamente atrelado a ele. Com o Notes possvel gerar
documentos de resposta em vrios nveis de hierarquia. Para entender o funcionamento deste
recurso vamos utilizar o seguinte exemplo: queremos criar um sistema onde possamos cadastrar
clientes e dependentes. Devemos criar um formulrio para cadastrar clientes (Clientes) com os
seguintes dados: nome, endereo e telefone (cli_nome, cli_endereco, cli_fone). Neste formulrio, crie
uma ao chamada Adicionar Dependente com a seguinte frmula:

@Command([Compose]; "Dependentes")

Tambm necessrio criar um formulrio para cadastro de dependentes (Dependentes) com os
seguintes dados: nome, data de nascimento e nome do cliente (dep_nome, dep_nascimento,
cli_nome). O campo cli_nome deve ser computado e a frmula do seu VaIor o nome do prprio
campo. Este formulrio dever ser do Tipo Resposta e deve ter marcada a opo FrmuIas herdam
vaIores do documento seIecionado, que fica na aba Padres da Janela de Parmetros de
Configurao do formulrio. No essencial que o formulrio Dependentes tenha o campo cli_nome,
do nome do cliente, nem que a opo FrmuIas herdam vaIores do documento seIecionado esteja
marcada para que o sistema de hierarquia funcione. Estas duas modificaes esto mutuamente
relacionadas e sero teis futuramente quando estivermos vendo Viso ncorporada. Em seguida,
crie uma viso com a seguinte frmula de SeIeo de Viso:

SELECT Form = "Clientes" | Form = " Dependentes"

Na aba Opes da viso marque a opo Mostrar documentos de resposta hierarquicamente. Na
primeira coluna da viso marque a opo Mostrar respostas apenas e digite a seguinte frmula de
em VaIor da CoIuna:

dep_nome + ". Nascimento: " + @Text(dep_nascimento)

O valor da segunda coluna deve ser o campo cIi_nome, e marque a opo Mostrar quebra quando
a Iinha for expansveI. O valor da terceira coluna deve ser o campo cIi_endereco. O valor da quarta
coluna deve ser o campo cIi_fone. O valor da coluna Telefone pode ser formatado para a mscara
padro de telefone usando a seguinte frmula:

numero := @Right( @Text(cli_fone);8 );
prefixo := @Left( @Text(cli_fone); @Length(@Text(cli_fone))-8 );
numeroFormatado := @Left(numero;4) + "-" + @Right(numero;4);

@if(prefixo = "";
numeroFormatado;
"(" + prefixo + ") " + numeroFormatado
)

As funes @Right e @Left copiam um texto especificado, no tamanho especificado, da direita para
a esquerda e da esquerda para a direita, respectivamente. A funo @Length retorna o nmero de
caracteres de um texto. Aps cadastrar alguns clientes e adicionar dependentes, o resultado deve ser
algo como exibido na Figura 34. Opcionalmente, a ao Adicionar Dependente, do formulrio
CIientes, pode ser tambm includa na viso.

Figura 34: Viso com Documentos de Resposta em formato Hierrquico

Em tempo, importante saber que os campos dos documentos de respostas s podem ser exibidos
concatenados. Outro detalhe importante que quando um documento excludo suas respostas no
sero excludas automaticamente, elas, apenas, no mais sero exibidas na viso ativa, pois esta
viso s mostrar as respostas que esto atreladas a algum documento vlido.

15.5. Viso ncorporada em Formulrio
O Notes permite que uma viso seja incorporada a uma pgina ou a um formulrio. Uma viso
incorporada a um formulrio particularmente interessante, pois agrega algumas funcionalidades a
viso original. Para entendermos a utilidade deste recurso vamos utilizar o exemplo do tpico 15.4.
Vamos primeiro criar uma viso apenas para o formulrio Clientes. essencial que a opo Mostrar
documentos de resposta hierarquicamente seja desmarcada nesta viso, do contrrio, os
documentos de resposta no sero visveis, pois esta viso no mostra os documentos de clientes. O
valor da primeira coluna deve ser o campo cIi_nome e deve ser categorizado com exibio de quebra
de linha. As duas outras colunas devem ser dep_nome e dep_nascimento. O resultado o exibido
na Figura 35.


Figura 35: Viso Dependentes categorizada pelo nome do Cliente

No que se refere ao formulrio Clientes, posicione o cursor no final do formulrio e clique no menu
Criar > EIemento Incorporado > Viso e selecione a viso Dependentes. Em seguida, selecione a
viso incorporada e digite cIi_nome no valor da frmula do atributo Mostrar nica categoria. Na aba
Exibir da janela de Parmetros de Configurao de Viso ncorporada, marque as opes Ajustar
janeIa para largura e altura. O resultado o exibido na Figura 36.

Figura 36: Viso Dependentes incorporada ao Formulrio Clientes

Percebam que, quando em uma viso incorporada define-se Mostrar nica categoria, a coluna
categorizada ocultada, mostrando-se apenas os dados da categoria correspondente. importante
lembrar que este resultado s foi obtido por que o formulrio Dependentes possui o campo cli_nome,
do nome do cliente. Caso deseje que a nica forma de acesso viso Dependentes seja este,
atravs da viso incorporada, basta renome-la, colocando seu nome entre parnteses.

Para maiores informaes sobre desenvolvimento em Notes Designer consulte a base de dados de
ajuda, que pode ser encontrada em sede11/help/help5_designer.nsf.


Referncias

Lotus. Fundamentos do Domino Designer, Lotus Notes Verso 5. Lotus Education.

Ajuda do Domino Designer 5. Disponvel em sede11/help/help5_designer.nsf.

Lotus Notes

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Lotus Notes

Hochgeladen von

Copyright:

Verfügbare Formate

Gerncia Regional de Operao de Paulo Afonso GRP Servio de Ensino Tcnico Operacional SPTO

Das könnte Ihnen auch gefallen