Web Content Manager Versão 8.0

Transcrição

Versão 8 Release 0
򔻐򗗠򙳰
ii
Índice
Visão Geral . . . . . . . . . . . . . 1
IBM Web Content Manager . . . . . . . . . 1
Novos Recursos e Melhorias do IBM Web Content
Manager . . . . . . . . . . . . . . . . 2
Especificações Suportadas para Inserção de Links
no Conteúdo Remoto . . . . . . . . . . 4
Recursos da Documentação . . . . . . . . . 5
Recursos de Acessibilidade . . . . . . . . . 6
Tipos de Web Sites . . . . . . . . . . . . 7
Portal de Intranet . . . . . . . . . . . . 7
Site de E-business . . . . . . . . . . . 8
Site de Brochureware . . . . . . . . . . 10
Site de E-library . . . . . . . . . . . . 10
Site de Parceiro . . . . . . . . . . . . 11
Divisões Conceituais e Funcionais de um Website . 12
Tutoriais . . . . . . . . . . . . . . 15
Tutorial: Criando e Publicando Conteúdo com
Páginas Gerenciadas . . . . . . . . .
Etapa 1. Configurar o acesso à biblioteca .
Etapa 2. Configurar organização . . . .
Etapa 3. Criar fluxo de trabalho . . . .
Etapa 4. Criar modelo de página . . . .
Etapa 5. Criar a página usando um modelo e
enviar as mudanças para a revisão . . .
Etapa 6. Aprovar e publicar mudanças . .
Etapa 7. Organizar mudanças para o servidor
entrega . . . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
15
16
16
17
19
. . 22
. . 26
de
. . 27
Planejando um Web Site . . . . . . . 29
Definindo o Projeto . . . . . . . . . .
Planejamento de Recursos Humanos . . . .
O Gerente de Projeto . . . . . . . .
O Analista de Negócios . . . . . . .
A Equipe de Arquitetura e Design . . . .
A Equipe de Implementação . . . . . .
A Equipe de Desenvolvimento . . . . .
A Equipe de Criação de Web Site . . . .
A Equipe de Aquisição de Conteúdo . . .
A Equipe de Manutenção . . . . . . .
Criando um Documento de Análise . . . .
Projetando um Web Site de Protótipo Usando
HTML . . . . . . . . . . . . . .
Criando um Documento de Design . . . .
Arquitetura do Servidor . . . . . . .
Arquitetura de Segurança. . . . . . .
Arquitetura de Informações . . . . . .
Arquitetura de Design . . . . . . . .
Arquitetura da Autoria . . . . . . .
Arquitetura de Aquisição de Conteúdo . .
Arquitetura de Entrega . . . . . . .
Arquitetura de Manutenção . . . . . .
Roteiro para Construir um Sistema de Conteúdo
Web . . . . . . . . . . . . . . .
Implementando o Ambiente de Autoria . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
29
31
31
32
33
36
40
41
43
44
45
. .
. .
. .
. .
. .
. .
. .
. .
. .
. .
da
. .
. .
47
48
48
49
52
54
55
57
58
59
60
60
Construindo o Sistema de Autoria de Conteúdo 61
Importando e Criando Conteúdo . . . . . . 62
Implementando o Ambiente de Entrega . . . . 62
Etapas Finais . . . . . . . . . . . . . 63
Instalando e migrando . . . . . . . . 65
Configurando Web Content Manager
67
Configurando um Ambiente de Autoria de
Conteúdo da Web . . . . . . . . . . . . 67
Instalando o Portlet de Autoria . . . . . . . 67
Opções Adicionais de Configuração do Portlet de
Autoria . . . . . . . . . . . . . . . 68
Opções de Autoria do Conteúdo da Web . . . 69
Configurando a Procura de Portlet de Autoria . . 73
Importando Arquivos Grandes e Imagens . . . 74
Aumentando os Tempos Limites . . . . . . 76
Configurando o Acesso ao Servidor Remoto para
Links . . . . . . . . . . . . . . . 77
Configurando o Suporte para Documentos
Associados . . . . . . . . . . . . . 78
Configurando um Ambiente de Migração de Dados
de Conteúdo da Web . . . . . . . . . . . 82
Configurando um Ambiente de Entrega de
Conteúdo da Web . . . . . . . . . . . . 83
Configurando a Análise de Site para o
Visualizador de Conteúdo da Web. . . . . . 83
Parâmetros da Interface de Configuração XML
para o Visualizador de Conteúdo da Web . . . 86
Opções de Armazenamento em Cache . . . . 88
Opções de Pré-renderização . . . . . . . . 94
Desativando a Barra de Ferramentas do Site em
um Servidor de Entrega . . . . . . . . . 98
Portlet de Autoria Reservado . . . . . . . . 99
Configurando o Portlet de Autoria Reservado
100
Opções de Configuração Adicionais . . . . . . 101
Controlando o Acesso a Hosts Especificados em
uma URL. . . . . . . . . . . . . . 101
Variáveis de Substituição do Conteúdo da Web 102
Ativando Tags Connect . . . . . . . . . 103
Tarefa de Configuração Remover Autoria . . . 104
Ativando E-mail . . . . . . . . . . . 104
Configurando Páginas Gerenciadas . . . . . . 105
Ativando Páginas Gerenciadas . . . . . . 105
Desativando Páginas Gerenciadas . . . . . 107
Transferindo Associações de Conteúdo para a
Biblioteca de Sites do Portal . . . . . . . 108
Propriedades da Organização . . . . . . . . 110
Ativando a Procura para o Conteúdo da Web. . . 111
Indexando Conteúdo da Web . . . . . . . 111
Configurando Opções de Procura do Web
Content Manager . . . . . . . . . . . 113
Configurando o Centro de Procura para
Procurar Conteúdo da Web . . . . . . . . 114
iii
Efetuando Crawl no Conteúdo da Web com
Listas de Valores Iniciais de Procura . . . . .
Gerenciando a Identificação e a Classificação no
Conteúdo da Web . . . . . . . . . . . .
Usando Identificação e Classificação de Escopos
com Conteúdo da Web . . . . . . . . .
Sincronizando Escopos para o Conteúdo da Web
114
119
119
120
Configurando um Site. . . . . . . . 123
Barra de Ferramentas do Site . . . . . . . .
Visualizando como Outro Usuário . . . . . .
Bibliotecas . . . . . . . . . . . . . .
Bibliotecas de Conteúdo da Web . . . . . .
Itens Padrão da Biblioteca de Conteúdo da Web
Páginas . . . . . . . . . . . . . . .
Criação e Navegação pela Página. . . . . .
Criando uma Página da Barra de Ferramentas
do Site . . . . . . . . . . . . . .
Modelos de Páginas . . . . . . . . . .
Criando Páginas a partir de um Modelo Usando
a Barra de Ferramentas do Site . . . . . .
Layout e estilo da página . . . . . . . .
Alterando o Estilo da Página . . . . . . .
Alterando o Layout da Página. . . . . . .
Mover uma página . . . . . . . . . .
Comparação de suporte a recursos por tipos de
páginas de portal . . . . . . . . . . .
Projetos e Fluxos de Trabalho . . . . . . . .
Visão Geral dos Projetos . . . . . . . . .
Gerenciamento de Fluxo de Trabalho e
Mudanças . . . . . . . . . . . . .
Melhores Práticas para Projetos . . . . . .
Páginas Gerenciadas . . . . . . . . . . .
Artefatos do WebSphere Portal Afetados pelas
Páginas Gerenciadas . . . . . . . . . .
Rascunhos e Projetos para Mudanças nas
Páginas Gerenciadas . . . . . . . . . .
Escopo de Edições para Páginas Gerenciadas
Modo de Edição e Páginas de Administração
Páginas Gerenciadas e Gerenciamento do Site
Páginas Gerenciadas e o Portlet de Autoria . .
Associações de Conteúdo do Sistema . . . .
Melhores Práticas para Páginas Gerenciadas . .
Resolvendo Problemas de Páginas Gerenciadas
Problemas Conhecidos para Páginas
Gerenciadas . . . . . . . . . . . . .
Administrando Páginas Gerenciadas. . . . .
Itens de Conteúdo da Web . . . . . . . . .
Criando Modelos de Autoria . . . . . . .
Construindo uma Estrutura do Site . . . . .
Modelos de Apresentação . . . . . . . .
Mapas de Modelo . . . . . . . . . . .
Itens de conteúdo . . . . . . . . . . .
Componentes . . . . . . . . . . . .
Estratégias do Traçado de Perfil . . . . . .
Elementos . . . . . . . . . . . . . .
Criando Links e Navegação . . . . . . .
Utilizando um Elemento Search . . . . . .
Armazenando Texto e HTML . . . . . . .
Armazenando Arquivos e Imagens . . . . .
Elementos de seleção . . . . . . . . . .
iv
123
127
127
127
128
129
130
130
131
132
132
132
133
133
133
134
134
137
151
151
152
152
153
154
154
154
155
155
156
158
160
171
171
179
182
185
186
187
187
189
189
197
201
203
207
Conteúdo Personalizado. . . . . . . . .
Utilizando um Elemento de Navegação de
Página. . . . . . . . . . . . . . .
Geração de URL Usando Tags PathCmpnt e
URLCmpnt . . . . . . . . . . . . .
Personalizando Documentos Associados . . .
Inserindo um Link no Conteúdo Remoto . . .
Utilizando Atributos Start e End . . . . . .
Configurando Parâmetros para o Formato Datas
Nota sobre Como Formatar Números . . . .
Tags . . . . . . . . . . . . . . . .
Tags de Conteúdo da Web . . . . . . . .
Recuando Designs de Elemento . . . . . .
Gravando links no conteúdo da Web . . . .
Vinculação Contextual . . . . . . . . .
Utilizando o Cache Customizado . . . . . .
Renderizando Plug-ins Fornecidos com o Web
Content Manager . . . . . . . . . . .
Controle de Acesso . . . . . . . . . . .
Usuários, Grupos e Funções . . . . . . .
Interface de Autoria . . . . . . . . . . .
Páginas de Portal Customizadas para Autoria
Estratégias de Acesso ao Sistema de Autoria . .
Customização do Portlet de Autoria . . . . .
Interfaces de Autoria Customizadas . . . . .
Estratégias de Edição Sequencial do Conteúdo
da Web . . . . . . . . . . . . . .
Conteúdo. . . . . . . . . . . . . . .
IBM Web Content Integrator . . . . . . .
WebDAV . . . . . . . . . . . . . .
Blogs . . . . . . . . . . . . . . .
Wikis . . . . . . . . . . . . . . .
Gerenciamento de Itens . . . . . . . . . .
Trabalhando com Pastas . . . . . . . . .
Gerenciando Versões de Itens . . . . . . .
Itens Bloqueados e de Rascunho . . . . . .
Excluindo um Item . . . . . . . . . .
Visualizando Referências de Item. . . . . .
Personalização . . . . . . . . . . . . .
Como um Site é Personalizado . . . . . .
Termos do Personalização . . . . . . . .
A Interface do Personalização . . . . . . .
Visão Geral da Publicação de Regras de
Personalização . . . . . . . . . . . .
A Coleta de Recursos do Conteúdo da Web . .
A Coleta de Recursos do Usuário do Portal . .
Recomendações do LikeMinds. . . . . . .
Feedback e Analítica . . . . . . . . . .
Desenvolvimento de um Portlet Personalizado
Referência de Programação do Personalization
208
214
217
218
222
224
225
226
227
227
228
229
230
231
236
245
245
255
255
256
256
261
261
265
265
310
321
325
328
328
328
329
330
331
331
333
334
357
359
369
371
373
401
439
500
Entregando o conteúdo da Web . . . 517
Acessando o Conteúdo da Web Por Meio de um
Servlet. . . . . . . . . . . . . . .
Entregando Conteúdo da Web em uma Página de
Portal . . . . . . . . . . . . . . .
Introdução à Entrega de Conteúdo da Web em
uma Página de Portal . . . . . . . .
Exibindo Conteúdo com Visualizadores de
Conteúdo da Web . . . . . . . . . .
Customizando Entrega de Conteúdo da Web
. 517
. 518
. 519
. 534
536
Executando Renderização Remota com o WSRP
e o Visualizador de Conteúdo da Web . . . .
Exemplos Administrativos Avançados . . . .
Melhores Práticas e Limitações do Visualizador
de Conteúdo da Web . . . . . . . . . .
Entrega Pré-renderizada . . . . . . . . . .
Pré-renderizando um Web Site . . . . . .
Acessando o Site Pré-renderizado . . . . .
551
552
563
564
565
566
Mantendo o Conteúdo da Web . . . . 569
Usando a Tarefa do Corretor de Membro de
Conteúdo da Web . . . . . . . . . . . .
Corretor de Membro com Organização . . . . .
Utilizando a Tarefa Atualizar Segurança . . . .
Usando a ferramenta de atualização do fluxo de
trabalho . . . . . . . . . . . . . . .
Limpando o Histórico do Item . . . . . . .
Limpando Histórico da Versão . . . . . . .
Reconfigurando o Log de Eventos de Conteúdo da
Web . . . . . . . . . . . . . . . .
Usando a Tarefa de Configurações de Cache de
Exportação . . . . . . . . . . . . . .
Exportando e Importando Bibliotecas de Conteúdo
da Web . . . . . . . . . . . . . . .
Exportando e Importando uma Biblioteca de
Conteúdo da Web . . . . . . . . . . .
Exportando e Importando uma Biblioteca de
Conteúdo da Web em um Ambiente do z/OS .
Exportando e Importando uma Cópia da
Biblioteca de Conteúdo da Web . . . . . .
Clonando um Repositório de Conteúdo da Web
Preparação de Clonagem . . . . . . . .
Clonando Dados . . . . . . . . . . .
569
574
575
578
579
580
582
583
584
586
589
591
596
596
597
Desenvolvimento . . . . . . . . . . 599
A API do IBM Web Content Manager . . . . .
Utilizando a API . . . . . . . . . . .
Tags JSP do Web Content Manager . . . . .
APIs de Gerenciamento de Biblioteca de
Conteúdo da Web . . . . . . . . . . .
APIs de Organização . . . . . . . . . .
Convertendo um visualizador de conteúdo da Web
do IBM API no JSR 286 API . . . . . . . .
Utilizando Ações Remotas . . . . . . . . .
Criando uma Página de Ativação Customizada . .
Criando Plug-ins Customizados . . . . . . .
Criando uma Classe de Botão Customizado . .
Criando uma Classe de Plug-in de Renderização
Criando uma Classe de Ação de Fluxo de
Trabalho Customizada . . . . . . . . .
Criando uma Classe de Provedor de Texto . .
Criando uma Classe de Validação de Upload do
Arquivo . . . . . . . . . . . . . .
Criando uma Classe de Assinante . . . . .
Criando uma Classe de Organizador . . . .
Criando uma Classe do Processador de
Contexto . . . . . . . . . . . . . .
Criando uma Classe de Filtro de Resolução de
Página de Conteúdo . . . . . . . . . .
599
599
600
603
606
606
608
619
620
620
621
625
626
628
630
631
632
633
Criando uma Classe de Filtro de Geração de
URL de Conteúdo . . . . . . . . . . .
Implementando Aplicativos de Plug-in
Customizados . . . . . . . . . . . .
Instrumentando Conteúdo da Web para Active Site
Analytics . . . . . . . . . . . . . . .
Usando a Tag do Plug-in de Renderização de
Dados de Analítica. . . . . . . . . . .
Usando o Componente HTML de Amostra para
Active Site Analytics . . . . . . . . . .
Ativando o Suporte de Microformato Padrão
nos Visualizadores de Conteúdo da Web . . .
Amostras de Classe Auxiliar para Contexto de
Conteúdo da Web . . . . . . . . . . . .
PortletWCMContextHelper . . . . . . . .
PortalWCMContextHelper . . . . . . . .
WCMContextHelper . . . . . . . . . .
Serviço REST do Web Content Manager . . . .
Introdução ao Serviço REST do Web Content
Manager . . . . . . . . . . . . . .
Serviço de Consulta REST para Conteúdo da
Web . . . . . . . . . . . . . . .
Trabalhando com Itens de Conteúdo da Web
Usando REST . . . . . . . . . . . .
Material de Referência do Serviço REST do Web
Content Manager . . . . . . . . . . .
Exibindo Dados de Fontes Externas . . . . . .
Criando Web Sites para Localidades Diferentes . .
Ativando os Sistemas de Mensagens Java para o
Conteúdo da Web . . . . . . . . . . . .
638
654
655
655
657
657
658
658
660
663
665
665
667
674
702
708
708
709
Administrando Organização . . . . . 711
Visão Geral de Distribuição. . . . . . .
Criando um Relacionamento de Organização .
Criando um Relacionamento de Organização a
Partir da Linha de Comandos . . . . . .
Ajuste de Sindicância. . . . . . . . .
Resolução de Problemas de Distribuição . .
.
.
. 711
. 715
.
.
.
. 718
. 721
. 723
Resolução de Problemas . . . . . . 727
Ferramentas para Resolução de Problemas e
Diagnóstico . . . . . . . . . . . . . .
IBM Support Assistant . . . . . . . . .
Coleta de Dados e Análise de Sintoma . . . .
Criação Manual de Arquivos JAR Ativados por
Aspecto . . . . . . . . . . . . . .
Informações de Versão e Histórico do Portal . . .
Registro e Rastreio . . . . . . . . . . .
Registros do Tempo de Execução do WebSphere
Portal . . . . . . . . . . . . . . .
Coleta de Lixo Detalhada nos Logs da Java
Virtual Machine (JVM) . . . . . . . . .
Arquivos de Rastreio e de Registro do
WebSphere Application Server. . . . . . .
Registro de Eventos do Sistema . . . . . .
Arquivos de Rastreio do Web Content Manager
Ativar Permanentemente o Rastreio . . . . .
Ativar o Rastreio Apenas para a Sessão Atual
do WebSphere Portal . . . . . . . . . .
Entrar em Contato com o Suporte . . . . . .
Índice
727
727
728
729
730
731
732
737
737
738
741
741
741
744
v
Terminologia do Web Content
Manager . . . . . . . . . . . . . 745
Referência. . . . . . . . . . . . . 747
Convenções . . . .
Estrutura de diretórios
Termos de Uso . . .
Avisos . . . . . .
Marcas Registradas
Glossário . . . . .
Q . . . . . . .
B . . . . . . .
A . . . . . . .
I. . . . . . . .
T . . . . . . .
F . . . . . . .
G . . . . . . .
vi
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
747
748
753
754
755
756
756
757
757
758
759
759
759
H
S
J.
L
M
N
A
D
R
S
P
E
V
T
X
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
759
760
760
760
760
761
761
761
764
764
765
766
766
766
767
Índice Remissivo . . . . . . . . . . 769
Visão Geral
O IBM® Web Content Manager é incluído com o IBM WebSphere Portal para
fornecer uma solução robusta de gerenciamento de conteúdo da web. Ele inclui uma interface de autoria
que pode ser customizada e estendida, um fluxo de trabalho, uma versão, uma taxonomia e muito mais.
IBM Web Content Manager
O Web Content Manager é usado para criar, gerenciar e entregar conteúdo para seu website. Você pode
criar conteúdo usando o portlet de autoria de conteúdo da Web ou criar sua própria interface de autoria
customizada. O conteúdo da Web armazenado nos sistemas de gerenciamento de conteúdo externo
também pode ser consultado dentro de um sistema Web Content Manager. É possível entregar conteúdo
da web usando portlets de visualizadores de conteúdo da web, o servlet do Web Content Manager ou
pré-renderizar seu site para HTML.
Criação de Website
Antes de configurar o seu sistema de conteúdo da Web, você deve ler as seções inteiras de WebSphere
Portal Planejamento e Instalação para determinar a melhor configuração geral para o seu sistema
WebSphere Portal.
Também é possível revisar o Wiki da Família WebSphere Portal . Esse site abrange uma ampla variedade
de tópicos que os especialistas do produto consideram essenciais para obter uma implementação
bem-sucedida.
Em uma solução do Web Content Manager, os elementos de layout e design de um website são
gerenciados separadamente do conteúdo de um website. Isso permite que você altere o layout e o design
de uma página da web sem alterar o conteúdo, e altere o conteúdo sem ter de atualizar o layout e o
design. Muitos recursos de design do website, como navegação, são gerados automaticamente usando
elementos e componentes predefinidos.
Autoria de Conteúdo da Web
Um dos usos principais do Web Content Manager é na criação de um sistema de autoria de conteúdo da
web para os criadores de conteúdo da web. Em um sistema Web Content Manager, o design e layout de
seu website são separados do conteúdo exibido em um website. Isso permite que autores de conteúdo da
web criem o conteúdo do seu site sem precisar entender como construir um website. Os sistemas de
autoria de conteúdo da web que você cria são projetados para fornecer diferentes experiências de autoria
de conteúdo da web para diferentes tipos de usuários.
v “Interface de Autoria” na página 255
Acessando Conteúdo Externo
O conteúdo da web usado em um Web Content Manager também pode ser armazenado e gerenciado em
sistemas de gerenciamento de conteúdo externo. O Web Content Integrator é usado para importar
1
conteúdo em um sistema Web Content Manager usando o formato de alimentação RSS. O conteúdo dos
sistemas de conteúdo federado pode ser vinculado diretamente em um sistema do Web Content Manager.
Também é possível usar o WebDAV para importar o conteúdo de um sistema de arquivos em um sistema
do Web Content Manager.
v “IBM Web Content Integrator” na página 265
v “WebDAV” na página 310
v “Configurando o Suporte para Documentos Associados” na página 78
Gerenciando o Conteúdo da Web
O Web Content Manager inclui um conjunto de recursos para ajudar você a manter e gerenciar seu
sistema Web Content Manager. Isso inclui controle de versão, gerenciamento e aprovação de mudanças,
projetos com diversos itens e pastas definidas pelo usuário para agrupar conjuntos de itens de conteúdo
da web.
v “Gerenciamento de Itens” na página 328
Bibliotecas de Conteúdo da Web Pré-instaladas
Um conjunto de bibliotecas de conteúdo da web pré-instaladas é fornecido para permitir que você inclua
recursos de blog e wiki em seus websites. Use blogs, bibliotecas de blogs e wikis para obter controle da
comunidade e alterar o modo de trabalho.
v Blogs e Wikis
Entregando o conteúdo da Web
O conteúdo da web pode ser entregue para seus visualizadores de website site usando portlets do
Visualizador de Conteúdo da Web, um servlet ou como arquivos HTML pré-renderizados.
v “Entregando o conteúdo da Web” na página 517
Planejando seu Sistema Web Content Manager
Este centro de informações inclui vários tópicos projetados para ajudar a planejar e gerenciar seu sistema
Web Content Manager. Use estes tópicos para assegurar que o sistema Web Content Manager esteja
projetado para desempenho ideal e facilidade de uso, bem como para assegurar que o sistema Web
Content Manager esteja suficientemente planejado e provido de recursos.
v
v
v
v
“Planejamento de Recursos Humanos” na página 31
“Planejando um Web Site” na página 29
Topologias de Servidor
“Roteiro para Construir um Sistema de Conteúdo da Web” na página 60
Configurando e Administrando o Web Content Manager
Ao instalar um sistema Web Content Manager, você configura os servidores em seu sistema de modo
diferente, dependendo de sua função no sistema. Uma vez configurados, há também um conjunto de
funções de administração que você usa para gerenciar bibliotecas, organização e feeds de conteúdo da
web.
v “Configurando Web Content Manager” na página 67
v “Administrando Organização” na página 711
Novos Recursos e Melhorias do IBM Web Content Manager
O Web Content Manager inclui novos recursos e várias melhorias nos recursos existentes.
2
A Página Inicial de Autoria
A nova página inicial de autoria fornece um ponto de entrada customizado para diferentes tipos de
usuários. É uma interface com o usuário de página única e simplificada, permitindo que:
v Autores casuais criem e submetam conteúdo facilmente.
v Contribuidores frequentes criem e trabalhem com seus itens.
v Usuários avançados vejam facilmente o que acontece em todo o site e rapidamente criem ou editem
qualquer item pelo qual eles são responsáveis.
Navegando no Portlet de Autoria
Suporte CMIS para Documentos Federados
O recurso de documentos federados permite que você insira links no conteúdo que reside em um
repositório de conteúdo remoto. Agora é possível inserir links nos documentos dos repositórios que
suportam Content Management Interoperability Services 1.0 (CMIS 1.0).
“Configurando o Suporte para Documentos Associados” na página 78.
Aprimoramentos de Modelo de Conteúdo
Os recursos de modelo de conteúdo do Web Content Manager foram expandidos para tornar mais rápido
e mais fácil criar e entregar conteúdo da web. Os visualizadores de conteúdo da web, os modelos de
página de conteúdo da web e as associações de conteúdo trabalham juntos para fornecer uma estrutura
flexível que pode ser usada para montar rapidamente páginas que contenham conteúdo da web. Para
ilustrar como esses blocos de construção funcionam juntos, o Web Content Manager inclui bibliotecas de
conteúdo da web pré-instaladas com amostra de conteúdo da web.
v “Introdução à Entrega de Conteúdo da Web em uma Página de Portal” na página 519
v “Criando Conteúdo com Itens do Modelo de Conteúdo da Web de Amostra” na página 526
O Serviço REST do Web Content Manager
O novo serviço REST do Web Content Manager torna as informações do repositório facilmente acessíveis,
enquanto mantém a segurança. Uma interface de URL simples permite que os desenvolvedores criem
consultas e utilizem essas informações para estender facilmente a interface com o usuário de autoria.
“Serviço REST do Web Content Manager” na página 665
Modelos de Área de Site
As áreas de site agora são tratadas como conteúdo, permitindo que você aproveite a vantagem de
serviços, como fluxo de trabalho, versão e perfil de metadados. Os administradores do site podem
restringir o tipo de item que pode ser criado em diferentes áreas de site, fornecendo um controle mais
granular. É possível agora mapear áreas de site para modelos de apresentação, o que permite a você
renderizar diretamente as áreas de site. Esses aprimoramentos fornecem aos autores a capacidade de criar
documentos "compostos", com as áreas de site agindo como item de conteúdo pai contendo áreas de site
e itens de conteúdo filhos.
“Criando Modelos de Autoria” na página 171
Novo Menu e Opções do Navegador
Os aprimoramentos nos componentes de menu e navegador fornecem novas opções de configuração que
incluem a definição de escopo de consultas de menu para uma biblioteca, bem como a definição do ponto
de início para navegadores com base no contexto da página ou por meio de uma sequência de consulta.
Visão Geral
3
Isso permite a reutilização dos mesmos componentes em diferentes partes do site, em vez de salvar o
mesmo componente diversas vezes com diferentes consultas ou pontos de início. Além disso, os
navegadores agora suportam marcação hierárquica, tornando possível seguir padrões da web modernos e
também produzir navegação de página acessível.
v “Utilizando um Elemento de Menu” na página 190
v “Utilizando um Elemento do Navegador” na página 193
Páginas Gerenciadas
A Versão 8.0 introduz suporte para páginas gerenciadas, que são páginas do portal armazenadas no Web
Content Manager. Gerenciando páginas do portal a partir do Web Content Manager, você pode aplicar
recursos de conteúdo da web como fluxo de trabalho, controle de versão e publicação periódica em
páginas do portal. Esse suporte fornece um método robusto e integrado para executar gerenciamento de
site, assegurando que as mudanças sejam coordenadas e publicadas juntas.
Principais benefícios das páginas gerenciadas:
v As mudanças em uma página são feitas no estado de rascunho, sem afetar o servidor de produção.
v Os rascunhos são organizados dentro de projetos no Web Content Manager. Quando você publica as
mudanças no rascunho no servidor de produção, um projeto coordena as atualizações e assegura que
todos os rascunhos sejam publicados ao mesmo tempo.
v Um processo de fluxo de trabalho assegura que as mudanças na página sejam disponibilizadas ao
servidor de produção apenas quando forem aprovadas. É possível criar fluxos de trabalho
customizados para adaptar os requisitos de seu ambiente de site e de autoria.
v Uma barra de ferramentas gráfica integra as funções das páginas gerenciadas diretamente às páginas
do portal. A barra de ferramentas fornece acesso rápido à edição de recursos, projetos e ações de fluxo
de trabalho que se aplicam à página. Também é possível alterar facilmente o escopo de suas mudanças
para que seja possível gerenciar as mudanças com projetos ou editar diretamente o site publicado.
v A publicação periódica fornece um método conveniente e flexível para transferir páginas gerenciadas
de um ambiente temporário para um ambiente de produção. Com a publicação periódica, todos os
artefatos e conteúdo necessários da página são transferidos ao mesmo tempo.
v O suporte ao script também está disponível para automatizar tarefas de páginas gerenciadas. A
Interface de Script do Portal inclui métodos para trabalhar com projetos e bibliotecas de conteúdo da
web, e a interface de configuração XML inclui suporte semelhante para projetos.
Saiba mais sobre páginas gerenciadas
.
Especificações Suportadas para Inserção de Links no Conteúdo
Remoto
O recurso de documentos federados permite que você recupere informações sobre documentos em um
repositório remoto e insira links nesses documentos em seu conteúdo da web. Diversos tipos de feeds são
suportados para acessar conteúdo remoto.
O recurso de documentos federados pode acessar conteúdo de sistemas remotos que suportam os
seguintes métodos:
v Content Management Interoperability Services 1.0 (CMIS 1.0)
v Interfaces remotas de Serviços de Documento, conforme suportado pelo Lotus Quickr, IBM Content
Manager e FileNet Content Manager
v Feeds Atom (somente regras do Personalização)
Para obter detalhes sobre configuração e uso do recurso de documentos federados, consulte os seguintes
tópicos:
4
v Ativar o acesso a servidores remotos: “Configurando o Suporte para Documentos Associados” na
página 78
v Usando regras com documentos federados: “Personalizando Documentos Associados” na página 218
v Inserindo links no conteúdo da web: “Inserindo um Link no Conteúdo Remoto” na página 222
Recursos da Documentação
O ponto de início para informações é a documentação do produto. A documentação do produto é
fornecida no wiki da família WebSphere Portal. Ainda existem outros sites e recursos disponíveis para
você ao trabalhar com o WebSphere Portal, mas essa consolidação destina-se à localização mais fácil das
informações. O objetivo também é conduzir melhorias no conteúdo e deixar a comunidade fazer edições e
comentários sobre a documentação. Saber onde procurar informações pode economizar tempo e dinheiro.
Saiba mais sobre os recursos primário e secundário na documentação do Web Content Manager e do
WebSphere Portal e no conteúdo complementar.
Existem duas origens principais para conteúdo: o wiki da família WebSphere Portal e o site de suporte do
WebSphere Portal. Uma excelente origem secundária é developerWorks, onde é possível encontrar
exemplos e artigos baseados em tutorial.
Cada fonte de conteúdo vincula a outras fontes para ajudá-lo a navegar entre os recursos. Cada fonte de
conteúdo possui um objetivo específico e destina-se ao uso com as outras fontes.
A documentação do produto entregue no wiki (na guia Documentação do Produto) é desenvolvida pela
IBM para ajudá-lo a aproveitar os recursos baseados nos padrões de uso esperados. Você pode contribuir
com o conteúdo para refletir sua experiência com o produto. O conteúdo do wiki acessado a partir da
guia Início é desenvolvido pela comunidade, dentro e fora da IBM. O intento é compartilhar experiências
com o produto e com base nos padrões de uso reais e casos de uso. O conteúdo de Suporte é
desenvolvido pelo Suporte IBM para ajudá-lo a evitar e diagnosticar problemas com o intento de ser tão
responsivo quanto possível.
Wiki do WebSphere Portal
O wiki inclui:
v A guia Documentação do Produto, que inclui:
– Visão geral do produto com novos realces de recursos, recursos do produto e acessibilidade
Visão Geral
5
– Planejamento de informações para implementação
– Instruções de instalação destinadas a um único servidor para provas de conceito ou servidores de
desenvolvimento, produção independente e ambientes de produção em cluster
– Opções de configuração que são geralmente feitas uma vez, ou sem frequência, e têm efeito global
sobre o portal
– Tarefas de administração para uso diário
– Instruções de integração
– Informações de desenvolvimento para ajudá-lo a desenvolver portlets e aplicativos
– Informações de resolução de problemas com informações de criação de log e rastreio
– Mensagens para ajudá-lo a diagnosticar e resolver problemas
v Guias suplementares, como o Guia de Desempenho e Ajuste
v IBM Redbooks
v Melhores Práticas
v Cenários de Implementação
v Ofertas de multimídia, como vídeos e demonstrações baseadas em tarefas
v Cartões de referência
Pontos-chave que devem ser lembrados sobre o wiki:
v Informações fornecidas anteriormente no centro de informações são agora fornecidas a partir da guia
Documentação do Produto do wiki.
v O conteúdo baseia-se na experiência
v É possível editar artigos, incluir comentários e criar seus próprios artigos
v O wiki é monitorado pela IBM
v É possível assinar feeds RSS para novos artigos, comentários e edições recentes
Página de Suporte do WebSphere Portal
A página de Suporte inclui:
v Notas técnicas escritas em resposta a problemas com o produto ou a documentação
v Downloads de fix packs, incluindo instruções para aplicação de correções
v Informações de resolução de problemas
v Atualizações para problemas de alta prioridade
Pontos-chave que devem ser lembrados sobre a página de Suporte:
v É possível assinar atualizações e novo conteúdo de Suporte usando MyNotifications
v É possível fazer download de ferramentas, como o IBM Support Assistant
Recursos de Acessibilidade
Recursos de Acessibilidade ajudam usuários portadores de deficiência física ou visual a utilizar produtos
de software com sucesso.
Este versão do IBM WebSphere Portal:
v Suporta a instalação por meio de uma interface de linha de comandos, conhecida como modo de console.
Equivale à instalação que usa interface gráfica com o usuário.
v Suporte a interfaces comumente usadas pelos leitores de tela e lupas (apenas Windows)
v Suporte para o uso de softwares leitores de tela e sintetizadores de voz digitais de forma a ouvir o
conteúdo exibido na tela.
v Operação utilizando apenas o teclado
6
v
v
v
v
v
Permissão para o usuário solicitar mais tempo para concluir respostas com tempo programado
Suporte para a customização de atributos de vídeo, como cor, contraste e tamanho da fonte
Comunicação de todas as informações, independentemente da cor
Suporte para a conexão de dispositivos alternativos de entrada e saída
Suporte para alternativas de informações de áudio
v Suporte para controle ajustável de volume
v Não atualiza a tela com taxas que podem induzir a ataques epilépticos
v Documentação fornecida em formato acessível
Navegador recomendado: Firefox 10.
Leitor de tela recomendado: JAWS 12.
A documentação inclui os seguintes recursos para auxiliar na acessibilidade:
v Toda a documentação está disponível em formatos HTML para fornecer a oportunidade máxima para
que os usuários apliquem a tecnologia de software de leitor de tela.
v Todas as imagens na documentação são fornecidas com texto alternativo para que os usuários com
deficiência visual possam entender o conteúdo das imagens.
Quando apropriado, a documentação para recursos específicos do produto contém informações adicionais
sobre acessibilidade.
Consulte os links relacionados para obter informações sobre o comprometimento da IBM com
acessibilidade.
Tipos de Web Sites
Tipos de Web sites diferentes precisarão de soluções diferentes e usarão aplicativos e recursos diferentes.
Esta seção contém exemplos de Web sites diferentes e os tipos de aplicativos e recursos necessários para
entregá-los.
Portal de Intranet
Um site de portal de intranet é projetado para que as informações sejam rapidamente disseminadas aos
funcionários para tornar mais eficiente os processos de negócios internos mais comuns e para fornecer
um sentido de comunidade em uma organização.
O site fornece acesso a:
v notícias sobre o que está acontecendo na organização.
v alertas contendo informações das quais os funcionários devem estar cientes e tomar as possíveis ações.
v formulários para trabalhar com vários processos internos, como licenças, compras e viagens.
v uma biblioteca de políticas e procedimentos com versões on-line de toda a documentação sobre política
e procedimento.
v comunidades organizacionais com recursos colaborativos, como blogs e fóruns.
v um sistema de procura para localização de conteúdo pelos funcionários.
O portal de intranet também possui uma página inicial personalizada que é construída dinamicamente
usando um conjunto de regras que recuperam conteúdo com base na função, no departamento e no local
do usuário atual. A identificação apropriada do conteúdo e sua correspondência com o usuário atual
permitem que o conteúdo exibido seja apropriado para o usuário.
Vários componentes são usados juntos para que este portal de intranet funcione:
Visão Geral
7
v O WebSphere Portal é usado para fornecer uma plataforma para a integração de conteúdo e de
aplicativos que formam o portal de intranet.
v O tema geral e a navegação de nível superior da intranet também são gerenciados usando o
WebSphere Portal.
v O Web Content Manager fornece o layout de micronível do conteúdo do portal e também é usado para
construir diretamente as notícias, os alertas e o conteúdo das comunidades.
v Os formulários são aplicativos on-line construídos por meio do sistema de Formulários/Lista, sendo
enviado para o site usando o Web Content Manager
v Políticas e Procedimentos são bibliotecas de documentos gerenciadas usando o IBM FileNet Content
Manager.
v Um produtor de alimentações customizado seria gravado para permitir que o Web Content Integrator
consuma uma alimentação a partir do IBM FileNet Content Manager e o Web Content Manager seria
usado para apresentar os documentos em um Web site.
v O Personalização é usado para associar conteúdo aos usuários gerando, dinamicamente, o conteúdo
que é exibido na página inicial personalizada
v Um sistema de discussão de terceiro é usado para entregar fóruns colaborativos na seção de
comunidades do site usando um portlet customizado.
v As áreas de comunidade também podem ser baseadas nos teamrooms do Lotus Quickr
v A procura do WebSphere Portal é usada com a categorização do Web Content Manager para fornecer
uma procura de texto simples e uma procura baseada em uma categoria mais avançada.
O tamanho de um portal de intranet tenderá a ser proporcional ao tamanho da organização. Uma
organização grande terá mais informações a serem disseminadas, mais processos de negócios, mais
comunidades de funcionários. Isso significa que o conteúdo e a ocupação do usuário tenderão a crescer
na mesma proporção.
Conceitos relacionados
Para criar um sistema de conteúdo da Web você precisa implementar hardware, configurar servidores,
projetar um sistema de autoria, configurar um ambiente de entrega e ativar a organização. Obtenha uma
visão geral das etapas necessárias para construir seu sistema de conteúdo da Web. Tenha em mente os
documentos de análise e design desenvolvidos durante a fase de planejamento de um projeto à medida
que você revisa o roteiro.
“IBM Web Content Integrator” na página 265
O Web Content Integrator é uma solução para integrar o conteúdo da Web gerenciado externamente com
o WebSphere Portal. Através do uso de tecnologias de feed de organização de conteúdo padrão baseadas
em RSS 2.0, o Web Content Integrator fornece um mecanismo fracamente acoplado para transferir o
conteúdo e metadados publicados para o portal após eles terem sido aprovados no sistema de origem.
Depois que o conteúdo e os metadados tiverem sido transferidos para o portal, será possível usar os
recursos de gerenciamento de conteúdo integrados do WebSphere Portal para proteger, personalizar e
exibir conteúdo para os usuários.
Informações relacionadas
Lotus Quickr
FileNet Content Manager
Site de E-business
Um site de e-business é um site de apresentação externa designado à comercialização de produtos e
serviços de uma empresa e permite a compra desses itens on-line. O foco do site é ajudar os
consumidores a atender suas necessidades com o produto ou serviço apropriado e maximizar suas
compras.
8
O site fornece:
v press releases sobre as notícias mais recentes relacionadas a produtos e serviços da empresa
v uma área promocional com informações sobre produtos e serviços, incluindo vendas, transações com
pacotes especiais e descontos
v uma área de catálogo de produtos e serviços com o catálogo inteiro exibido como uma taxonomia para
procura.
v uma área de compras em que os usuários podem ver:
– uma lista de procura de produtos e serviços disponíveis para compra on-line.
– um resumo dos itens que pretendem comprar.
– uma área para calcular impostos, fretes e outros custos.
– uma área para comprar esses itens on-line usando pedidos de correio ou usando uma chamada
telefônica de acompanhamento de um vendedor.
– uma área para controlar pedidos já iniciados.
v artigos em que a organização pode ajudar clientes a usar artigos discutindo seus produtos e serviços.
v uma área de suporte com documentação técnica, números de contato, formulários de pedido de
suporte, Perguntas mais Frequentes e downloads.
v um serviço para assinar uma newsletter em que o usuário receberá uma atualização regular com
destaque para novas promoções, produtos ou artigos.
A página inicial do site é usada para realçar as promoções mais recentes e para apresentar como destaque
a marca da organização. Em todo o site, a filtragem colaborativa é usada para ajudar a sugerir produtos e
serviços aos consumidores com base em sua atividade de compra e de navegação. Também é possível
usar um sistema de discussão para que os usuários construam uma comunidade em que possam fazer
comentários e avaliar vários produtos e serviços.
Vários componentes são usados juntos para construir o site de e-business:
aplicativos que formam o site de e-business.
WebSphere Portal.
v O Web Content Manager fornece o layout de micronível do conteúdo do site e também é usado para
construir diretamente os press releases, as Perguntas Frequentes, os artigos e o conteúdo promocional.
v As áreas de catálogo e de compras que estão sendo executadas usando o WebSphere Commerce.
v O Personalização é usado para sugerir produtos aos usuários com base na filtragem colaborativa e para
enviar a newsletter por e-mail.
Um site de e-business pode gerar uma grande quantidade de tráfego com uma quantidade relativamente
pequena de conteúdo.
Visão Geral
9
IBM WebSphere Commerce
Site de Brochureware
Um site de brochureware é um site de apresentação externa que age como a presença de uma
organização na World Wide Web. O foco de substituição está na representação da marca da organização
para seus clientes em potencial.
Esse tipo de site é relativamente estático e não precisa de recursos de agregação do WebSphere Portal
sendo entregue, como alternativa, usando-se os recursos de entrega de servlet e de pré-renderização do
Web Content Manager. O site também foi projetado para ser facilmente indexado pelos mecanismos de
procura, como o Google.
Este site incluiria:
v informações sobre a organização, incluindo sua ética, seus objetivos, sua missão e seu histórico
v uma área de notícias na qual a organização pode conversar sobre planos atuais e futuros
v uma área de contato com listas de locais, números de telefone e formulários de contato on-line nos
quais os usuários podem enviar consultas, solicitar ligações telefônicas de acompanhamento
v uma área de oportunidades de emprego em que uma organização pode anunciar ocupações
v uma área de parceiros em que os parceiros da organização estejam listados com informações sobre eles
e seus relacionamentos com a organização, além de links para Web sites de parceiros e detalhes de
contato do parceiro
v informações sobre os produtos e serviços da organização, incluindo casos de referência e certificados
Os componentes deste site estão limitados ao fornecimento pelo Web Content Manager de toda a
apresentação, navegação e conteúdo.
Um site de brochureware pode gerar uma grande quantidade de tráfego com uma quantidade
relativamente pequena de conteúdo.
Site de E-library
Um site de biblioteca on-line é dedicado ao fornecimento de acesso a uma grande quantidade de
conteúdo. O principal exemplo é um site de notícias, em que novo conteúdo é criado durante o dia, todos
os dias da semana, e é publicado on-line sendo, então, arquivado quando desatualizado. Outros exemplos
incluem diários, relatórios de analistas e bibliotecas de software.
Em geral, os usuários precisam registrar-se nesses sites, podendo então ter a oportunidade de receber
e-mails regularmente com um resumo do conteúdo mais recente. Um site de notícias pode oferecer as
10
notícias mais recentes gratuitamente, mas o acesso ao conteúdo arquivado pode precisar ser pago. Outros
tipos de sites de "biblioteca" podem exigir pagamento para obter acesso a qualquer conteúdo.
Vários componentes são usados juntos para entregar um site de e-library:
aplicativos que formam o site de e-business.
WebSphere Portal.
v O Web Content Manager fornece o layout de micronível do conteúdo do site e também é usado para
construir conteúdo diretamente.
v Para e-libraries, em que o conteúdo é apresentado como documentos, então o IBM FileNet Content
Manager seria usado para armazenar e gerenciar os documentos.
v Um produtor de alimentações customizado seria gravado para permitir que o Web Content Integrator
consuma uma alimentação a partir do IBM FileNet Content Manager e o Web Content Manager seria
usado para apresentar os documentos em um Web site.
Um site de e-library pode ter um público muito amplo e uma grande quantidade de conteúdo.
FileNet Content Manager
Site de Parceiro
O público de um site de parceiro são os parceiros de uma organização. O site fornece informações e
aplicativos não aplicáveis ao público mais amplo de consumidores. Um site de parceiro exigiria,
geralmente, um login, mas não usaria um sistema de registro automatizado. Os parceiros de negócios
seriam conhecidos da empresa e receberiam um login para obter acesso ao site de parceiro.
Um site de parceiro pode incluir as seguintes áreas:
v uma área de notícias com foco nos parceiros. Organizações maiores que trabalham em múltiplas áreas
de negócios poderiam personalizar a área de notícias para adaptação a cada parceiro.
v uma área de promoções detalhando transações especiais para os parceiros.
v serviços on-line, que oferecem ferramentas e recursos úteis para uso dos parceiros, como calculadoras,
formulários e catálogos.
v uma área de faturamento na qual os parceiros possam ver o status atual da nota para serviços
contratados junto à organização.
v uma área de comunidade na qual os parceiros possam postar suas próprias informações e também
interagir entre si para ajuda mútua e receber ajuda da organização.
Visão Geral
11
Vários componentes são usados juntos para entregar um site de parceiro:
aplicativos que formam o portal de intranet.
WebSphere Portal.
v O Web Content Manager fornece o layout de micronível do conteúdo do portal e também é usado para
construir diretamente as notícias e o conteúdo promocional.
v Vários produtos IBM e aplicativos de terceiros são usados para construir e implementar a área de
serviços on-line.
v Os serviços de catálogo e de faturamento no site são executados usando o WebSphere Commerce.
v O Personalização está sendo usado para filtrar conteúdo em todo o site para garantir que o conteúdo
apropriado e os serviços sequenciais estejam chegando aos parceiros apropriados.
É provável que um site de parceiro tenha um público limitado, mas uma grande quantidade de conteúdo.
IBM WebSphere Commerce
Divisões Conceituais e Funcionais de um Website
Ao construir um website usando o Web Content Manager, você divide o website nas seguintes divisões
conceituais e funcionais.
Tabela 1. Divisões Conceituais e Funcionais para Layout
Content
Layout
v Itens de conteúdo
v Modelos de apresentação
v Áreas de Site
v Designs de Componente
v Componentes
v Layout de página e portlets
v Temas
Tabela 2. Divisões Conceituais e Funcionais para Estilo
Contexto
Estilo
v Estrutura do Site
v CSS
v Hierarquia de páginas
v Temas
v Definição de Perfil
v Usuário Atual
v Personalização
Ao desenvolver um website usando o Web Content Manager e o WebSphere Portal, você está dividindo
os elementos do website entre conteúdo, contexto, layout e estilo.
12
Conteúdo:
Há dois tipos de conteúdo:
Dinâmico
Conteúdo dinâmico é gerado dinamicamente com base em um conjunto de parâmetros
pré-configurados, como navegador ou menu.
Estático
Conteúdo estático é conteúdo no qual você armazena marcação ou arquivos diretamente
em um componente, item de conteúdo ou área de site. Onde você armazena conteúdo
estático depende de como o conteúdo é usado:
v Conteúdo específico de página é armazenado em itens de conteúdo.
v Conteúdo relacionado a uma seção do site pode ser armazenado em uma área de site.
v Conteúdo reutilizado em diversas seções do site é armazenado em componentes.
Layout:
O layout e a estrutura de cada página no website são definidos usando estes recursos:
v A estrutura geral de cada página é determinada pelo tema que você está usando, o layout da
página escolhido e os portlets de visualizador de conteúdo da web incluídos no layout da
página.
v O layout do conteúdo exibido em cada visualizador de conteúdo da web é determinado pela
marcação usada pelo modelo de apresentação atual e pela marcação armazenada nos elementos
e componentes referenciados no modelo de apresentação.
Contexto:
O contexto do conteúdo atualmente exibido também é importante. O layout e design da página
em que um item de conteúdo é exibido são diferentes dependendo de:
v A página de portal atual (páginas diferentes podem usar temas, layouts, portlets de
visualizador de conteúdo da web diferentes e até mesmo modelos de apresentação diferentes).
v A área de site atual (o conteúdo vinculado a áreas de site diferentes pode usar mapas de
modelo diferentes que são mapeados para áreas de site diferentes).
v O usuário atual (usuários diferentes podem ter acesso diferente a vários elementos de página,
incluindo páginas individuais, portlets e itens de conteúdo da web).
Cada uma dessas variáveis contextuais permite que você exiba conteúdo ou componentes de
diferentes maneiras, dependendo do contexto atual. Além disso, o perfil do portlet atual, item de
conteúdo ou usuário atual pode determinar o que é exibido em uma página, igual com qualquer
recurso de personalização usado pelo website.
Estilo: Embora você possa colocar elementos estilísticos diretamente em HTML, está se tornando cada
vez mais comum usar CSS para armazenar e gerenciar todos os elementos estilísticos de um
website. Em um site do WCM, o CSS pode ser:
v Armazenado no lado do servidor e referenciado em um tema do WebSphere Portal
v Armazenado diretamente em um item de conteúdo ou componente do WCM
Uma boa prática é armazenar a marcação CSS em um campo HTML armazenado em um item de
conteúdo. Isso permite acesso rápido ao CSS se for necessário fazer uma mudança. Além disso, é
possível usar recursos avançados, como fluxos de trabalho e edição sequencial, para ajudar a
manter o CSS. Ao armazenar todos os elementos estilísticos em CSS, é possível fazer mudanças
estilísticas rapidamente no website simplesmente editando um arquivo CSS em vez de editar
diversos itens do WCM.
Quando uma página da web é renderizada, o Web Content Manager seleciona todos esses tipos de item
individuais e os combina para construir uma página da web completa.
Visão Geral
13
14
Tutoriais
Tutorial: Criando e Publicando Conteúdo com Páginas Gerenciadas
Este tutorial demonstra como é possível usar páginas gerenciadas, projetos e fluxo de trabalho para criar
e aprovar páginas de rascunho. Após a aprovação, as mudanças são publicadas em um servidor de
entrega com organização.
O cenário para este tutorial abrange as funções e tarefas a seguir:
Administrador do site (SiteAdmin)
O administrador do site tem privilégios de administrador no portal e no Web Content Manager.
O SiteAdmin faz parte do grupo de usuários wpsadmins e executa estas tarefas:
v Configura estágios do fluxo de trabalho e cria um fluxo de trabalho customizado.
v Cria um modelo de página que usa o fluxo de trabalho customizado.
v Especifica configurações de controle de acesso conforme necessário.
v Configura um relacionamento de organização entre o servidor de autoria e o servidor de
entrega.
v Publica projetos para organização.
Autor de conteúdo (Autor 1)
O autor de conteúdo é responsável por uma determinada parte do site e pode criar páginas
conforme necessário, além de estar apto a incluir e editar conteúdo nessas páginas. O Autor 1 faz
parte do grupo de usuários Editores de Conteúdo.
Revisor de conteúdo (Revisor 1)
O Revisor 1 revisa as mudanças enviadas pelos autores de conteúdo e aprova ou rejeita as
mudanças individuais. Na aprovação, o Revisor 1 envia o projeto completo para aprovação. O
Revisor 1 faz parte do grupo Revisores de Conteúdo.
Aprovador de conteúdo (Aprovador 1)
O Aprovador 1 supervisiona as mudanças no site e é responsável por aprovar projetos para
publicação. O Aprovador 1 faz parte do grupo Aprovadores de Conteúdo.
Conteúdo
“Etapa 1. Configurar o acesso à biblioteca” na página 16
Para que os autores, editores e aprovadores de conteúdo possam começar, o administrador do site
deve conceder acesso à biblioteca aos autores e aprovadores de conteúdo.
“Etapa 2. Configurar organização” na página 16
As atualizações em páginas e conteúdo gerenciados são transferidas do servidor de autoria para o
servidor de entrega com organização. Quando você publica um projeto, é possível usar organização
para publicar automaticamente novas atualizações de páginas e conteúdo. Para ativar esse
comportamento, o SiteAdmin configura a organização entre as bibliotecas de conteúdo da web
necessárias dos dois servidores.
“Etapa 3. Criar fluxo de trabalho” na página 17
As páginas criadas neste tutorial estão sujeitas ao fluxo de trabalho customizado que está anexado ao
modelo de página. Antes de criar o modelo de página no servidor de autoria, o SiteAdmin cria o
fluxo de trabalho customizado a ser usado com as novas páginas.
“Etapa 4. Criar modelo de página” na página 19
O SiteAdmin cria um modelo de página que os autores de conteúdo podem usar para criar páginas.
“Etapa 5. Criar a página usando um modelo e enviar as mudanças para a revisão” na página 22
15
Depois que o SiteAdmin inclui o modelo de página Modelo 1, os autores de conteúdo podem criar
páginas usando o modelo.
“Etapa 6. Aprovar e publicar mudanças” na página 26
Depois que o Autor 1 envia as mudanças no projeto Atualizações de Notícias para revisão, o Revisor
1 revisa as mudanças e envia o projeto para aprovação. O Aprovador 1 então acessa o projeto e
aprova as atualizações para publicação. Quando o projeto é enviado, o SiteAdmin o publica e as
mudanças então ficam disponíveis para todos os usuários no servidor de autoria.
“Etapa 7. Organizar mudanças para o servidor de entrega” na página 27
Depois que o SiteAdmin publica o projeto, as atualizações estão prontas para organização no servidor
de entrega. Embora a organização seja executada em intervalos planejados, o SiteAdmin acessa o
servidor de entrega e inicia manualmente o processo de organização.
Etapa 1. Configurar o acesso à biblioteca
Para que os autores, editores e aprovadores de conteúdo possam começar, o administrador do site deve
conceder acesso à biblioteca aos autores e aprovadores de conteúdo.
Nesta etapa, o acesso é definido para estas bibliotecas:
Site do Portal
Os objetos de página e o conteúdo de páginas gerenciadas são armazenados na biblioteca da Site
do Portal. O acesso de contribuidor é requerido para o grupo Editores de Conteúdo.
Web Content
O fluxo de trabalho customizado e os estágios do fluxo de trabalho são armazenados na
biblioteca de Conteúdo da Web. O acesso de contribuidor é requerido para os grupos Editores de
Conteúdo, Revisores de Conteúdo e Aprovadores de Conteúdo.
1. Clique em Administração > Conteúdo do Portal > Bibliotecas de Conteúdo da Web.
2. Configure as permissões para a biblioteca de Site do Portal.
a. Clique no ícone Configurar Permissões para a biblioteca de Site do Portal.
b. Clique no ícone Editar Função para a função de Editor.
c. Clique em Incluir e selecione o grupo Editores de Conteúdo.
3. Configure as permissões para a biblioteca de Conteúdo da Web.
a. Clique no ícone Configurar permissões para a biblioteca de Conteúdo da Web.
b. Clique no ícone Editar Função para a função de Contribuidor.
c. Clique em Incluir e selecione os grupos Editores de Conteúdo, Revisores de Conteúdo e
Aprovadores de Conteúdo.
Remember: Além do acesso apropriado nas bibliotecas, os autores de conteúdo precisam de acesso de
Editor a todas as páginas e portlets que estão envolvidos. Esse acesso permite que os autores criem
páginas e incluam portlets nas páginas. Este tutorial confia no conteúdo de amostra com acesso
predefinido. Entretanto, se você usar seu próprio conteúdo, assegure-se de especificar acesso suficiente
nesses recursos do portal para que os autores possam trabalhar com eles.
Etapa 2. Configurar organização
As atualizações em páginas e conteúdo gerenciados são transferidas do servidor de autoria para o
servidor de entrega com organização. Quando você publica um projeto, é possível usar organização para
publicar automaticamente novas atualizações de páginas e conteúdo. Para ativar esse comportamento, o
SiteAdmin configura a organização entre as bibliotecas de conteúdo da web necessárias dos dois
servidores.
Nesse relacionamento de organização, o servidor de entrega é o assinante e o servidor de autoria é o
organizador.
16
1. Efetue login no servidor de entrega como administrador.
2. Crie um espaço compartilhado na área segura de credenciais para acessar o organizador.
a. Clique em Administração > Acessar > Área Segura de Credenciais.
b. Clique em Incluir um espaça na área segura.
c. Insira um nome para o espaço na área segura (por exemplo, syndication-slot).
d. Clique em novo e insira um recurso da área segura para associar ao espaço (por exemplo,
syndication-resource).
e. Clique em Espaço na área segura é compartilhado e insira o ID do usuário e a senha para acessar
o espaço a partir do servidor de autoria. O ID do usuário e a senha devem ser definidos no
servidor de autoria. Este tutorial usa as credenciais do SiteAdmin.
3. Clique em Administração > Conteúdo do Portal > Assinantes.
4. Clique em Assinar Agora.
5. Especifique os detalhes do organizador e assinante.
a. No campo URL do Organizador, insira a URL para acessar o servidor de autoria.
Essa URL utiliza o formato http://hostname:port_number/wcm_context_root. A raiz de contexto
padrão para Web Content Manager é wps/wcm. Por exemplo:
http://www.example.com:10039/wps/wcm
b. No campo Nome do Organizador, insira um nome para identificar o servidor de autoria no
relacionamento de organização. Esse nome é usado para o item do organizador que é criado no
servidor de autoria.
c. No campo Nome do Assinante, insira um nome para identificar o servidor de entrega no
relacionamento de organização. Esse nome é usado para o item do assinante que é criado no
servidor de entrega.
d. No campo Espaço na Área Segura de Credenciais, selecione o espaço na área segura de
credenciais que você criou anteriormente (por exemplo, syndication-slot).
e. Clique em Avançar e selecione as bibliotecas que você deseja organizar.
As bibliotecas a seguir são necessárias para este tutorial:
v Site do Portal: Contém artefatos de página e conteúdo relacionado.
v Conteúdo da Web: Contém itens de fluxo de trabalho.
v Modelos de Conteúdo da Web: Necessários para itens de conteúdo da web de amostra.
v Conteúdo de Página de Modelo: Necessário para itens de conteúdo da web de amostra.
Para cada biblioteca, selecione Itens ativos no campo Escopo.
f. Clique em Concluir.
g. Para verificar a conexão da organização, clique no ícone Testar conexão.
Etapa 3. Criar fluxo de trabalho
As páginas criadas neste tutorial estão sujeitas ao fluxo de trabalho customizado que está anexado ao
modelo de página. Antes de criar o modelo de página no servidor de autoria, o SiteAdmin cria o fluxo de
trabalho customizado a ser usado com as novas páginas.
O fluxo de trabalho customizado é armazenado na biblioteca de Conteúdo da Web, sendo um fluxo de
trabalho com três estágios simples que contém estes estágios: Rascunho, Revisão, Publicação.
1. Crie o estágio de fluxo de trabalho Revisão.
Nota sobre estágios de fluxo de trabalho: Para fins de simplicidade, este tutorial usa os estágios
Rascunho e Publicação que são fornecidos com o portal por padrão. Entretanto, da mesma forma que
ocorre com qualquer fluxo de trabalho no Web Content Manager, é possível especificar estágios
adicionais, como o de Expiração, conforme necessário.
a. Clique em Aplicativos > Conteúdo > Gerenciamento de Conteúdo da Web.
Tutoriais
17
b. Clique em Conteúdo da Web > Itens de Fluxo de Trabalho > Estágios de Fluxo de Trabalho.
c. Clique em Novo > Estágio de Fluxo de Trabalho.
d. Insira Estágio de Revisão para o nome do estágio do fluxo de trabalho.
e. Salve o estágio.
2. Conceda aos autores e aprovadores acesso aos estágios de fluxo de trabalho. Edite cada estágio de
fluxo de trabalho e configure o acesso apropriado.
Esta tabela lista os três estágios de fluxo de trabalho com as configurações de acesso necessárias para
cada estágio.
Estágio do fluxo de trabalho
Configurações de Acesso
Rascunho
v Para permitir que autores editem conteúdo que está no
estado de rascunho, clique em Conceder acesso de
Editor para incluir o grupo Editores de Conteúdo.
v Para permitir que autores movam itens para o estágio
seguinte no fluxo de trabalho, clique em Conceder
acesso de Aprovador para incluir o grupo Editores de
Conteúdo.
Revisão
v Para assegurar que somente revisores possam enviar
conteúdo de rascunho para aprovação, clique em
Conceder acesso de Aprovação e inclua o grupo
Revisores de Conteúdo.
v Para permitir que autores visualizem status de
conteúdo no estágio de revisão, clique em Conceder
acesso de Usuário para incluir o grupo Editores de
Conteúdo.
Publicação
Para permitir que autores criem rascunhos de conteúdo
publicado, clique em Conceder acesso de Aprovador
para incluir o grupo Editores de Conteúdo.
Figura 1. Captura de tela das configurações de acesso para o estágio de fluxo de trabalho de Revisão.
3. Crie o fluxo de trabalho customizado (Fluxo de Trabalho 1).
a. Clique em Conteúdo da Web > Itens de Fluxo de Trabalho > Fluxos de Trabalho.
18
b.
c.
d.
e.
Clique em Novo > Fluxo de Trabalho.
Insira Fluxo de Trabalho 1 para o nome do fluxo de trabalho.
Nas propriedades do fluxo de trabalho, clique em Incluir Estágios do Fluxo de Trabalho.
Inclua os estágios a seguir e ordene-os apropriadamente: Estágio de Rascunho, Estágio de Revisão,
Estágio de Publicação.
Figura 2. Captura de tela dos estágios de fluxo de trabalho no Fluxo de Trabalho 1.
f. Salve as alterações.
Etapa 4. Criar modelo de página
O SiteAdmin cria um modelo de página que os autores de conteúdo podem usar para criar páginas.
Como as mudanças nas páginas precisam ser aprovadas antes de serem publicadas neste tutorial, o
SiteAdmin especifica um fluxo de trabalho customizado (Fluxo de Trabalho 1) ao configurar propriedades
de páginas para o modelo. Quando um autor de conteúdo cria uma página usando o modelo, as
mudanças na página estão sujeitas ao Fluxo de Trabalho 1.
1. Clique em Início para navegar para a página principal do portal.
2. Crie um projeto.
Tip: Só é possível configurar um fluxo de trabalho nos itens que estão em um estado de rascunho.
Por causa desse comportamento, você deve criar o modelo como rascunho no contexto de um projeto.
Ao trabalhar em um projeto, é possível também verificar o fluxo de trabalho para certificar-se de que
os estágios se comportam conforme esperado.
a. Abra o menu do projeto e clique em Novo Projeto.
Figura 3. Captura de tela do menu do projeto aberto.
b. Insira Novo Modelo como nome do projeto e salve o projeto. O menu do projeto é atualizado para
indicar que o projeto Novo Modelo é o projeto ativo.
Tutoriais
19
Figura 4. Captura de tela do menu do projeto, mostrando o projeto ativo (Novo Modelo).
3. Crie o modelo de página.
a. Clique em Administração > Interface com o Usuário do Portal > Modelos de Página.
b. Clique em Mais > Nova Página Irmã e insira Modelo 1 como nome da página do novo modelo.
Use o modelo de página Básico padrão para criar o Modelo 1.
c. Clique em Criar. As propriedades da página na barra de ferramentas do site são atualizadas para
indicar o novo modelo. O fato de o nome da página estar entre parênteses indica que a página
está em um estado de rascunho.
Figura 5. Captura de tela da página Modelo 1 no modo de edição.
4. Inclua o fluxo de trabalho customizado no modelo de página.
a. Clique em Editar nas propriedades da página, na guia Visão Geral da barra de ferramentas do
site. O link Editar é exibido quando você posiciona o cursor na seção de propriedades da página
da barra de ferramentas.
Figura 6. Captura de tela da seção de propriedades da página da barra de ferramentas do site.
b. Na janela Propriedades da Página, clique na guia Segurança.
20
c. Clique em Selecionar no campo Fluxo de Trabalho e inclua o fluxo de trabalho Fluxo de Trabalho
1.
Assim que você seleciona o fluxo de trabalho, o rascunho da página entra no fluxo de trabalho
selecionado. É possível confirmar o estágio do fluxo de trabalho atual examinando as propriedades
do fluxo de trabalho. Nesse caso, o estágio de Rascunho é o estágio atual e o estágio de Revisão é
o próximo estágio.
Figura 7. Captura de tela das propriedades do fluxo de trabalho para o rascunho da página Modelo 1 na janela
Propriedades da Página.
d. Salve as alterações.
5. Conclua o fluxo de trabalho para o modelo de rascunho. Para poder publicar o projeto e tornar o
novo modelo de página disponível aos usuários, você deve mover o modelo pelo fluxo de trabalho.
a. Clique em Mais > Próximo Estágio.
Nota: A opção Próximo Estágio só está disponível aos usuários com o acesso de Aprovador no
estágio do fluxo de trabalho atual.
Figura 8. Captura de tela do menu Mais na barra de ferramentas do site, com a opção Próximo Estágio destacada.
Quando você clica em Novo Estágio, o item de rascunho avança para o estágio seguinte no fluxo
de trabalho atual. Nesse cenário, o modelo é movido para o Estágio de Revisão do Fluxo de
Trabalho 1. É possível verificar se o fluxo de trabalho foi alterado nas propriedades da página.
Tutoriais
21
Figura 9. Captura de tela das propriedades da página do modelo de página Modelo 1, mostrando o estágio do fluxo
de trabalho atualizado.
b. Clique em Mais > Próximo Estágio para mover o modelo para o estado de publicação.
6. Publique o projeto Novo Modelo.
Embora o modelo de página Modelo 1 esteja no estado publicado, o modelo ainda não está disponível
aos usuários porque o projeto que contém o modelo não foi publicado.
a. Abra o menu do projeto.
b. Clique em Publicar.
Nota: A ação Publicar não está disponível no menu do projeto, até que todos os itens do projeto
estejam no estado publicado.
Figura 10. Captura de tela do menu do projeto Novo Modelo, com a ação Publicar destacada.
Após a publicação do projeto, você sai do contexto do projeto e volta para o site publicado. O
modelo de página Modelo 1 agora é listado com os outros modelos de página no portal.
Important: As mudanças no fluxo de trabalho não são aplicadas dinamicamente aos modelo de página
que usam o fluxo de trabalho. Se você alterar o fluxo de trabalho ou seus estágios depois de publicar o
projeto que contém o modelo, repita as etapas para configurar o fluxo de trabalho:
1. Crie um projeto.
2. Edite o modelo de página e especifique o fluxo de trabalho novamente na guia Segurança nas
propriedades da página.
3. Mova o modelo para o fluxo de trabalho e publique o projeto.
Etapa 5. Criar a página usando um modelo e enviar as mudanças para
a revisão
Depois que o SiteAdmin inclui o modelo de página Modelo 1, os autores de conteúdo podem criar
páginas usando o modelo.
22
Nesse cenário, o Autor 1 é responsável pela seção do website que é identificada por uma página chamada
Notícias. A própria página Notícias foi criada pelo SiteAdmin e foi baseada no modelo de página Modelo
1.
1. Crie um projeto para gerenciar atualizações.
a. Insira Atualização de Notícias como nome do projeto.
b. Nas configurações de Aprovação, clique em Incluir e selecione um aprovador para o projeto.
Nesse caso, o Autor 1 cria o projeto e, como aprovador, ele especifica o Aprovador 1. Quando as
mudanças no projeto forem revisadas e enviadas, o Aprovador 1 poderá executar a aprovação final
do projeto concluído.
Nota sobre aprovação de projeto: Esta etapa de revisão é uma revisão diferente de qualquer
revisão imposta pelo fluxo de trabalho em uma página ou outro item propriamente dito. Mesmo
que o fluxo de trabalho do item esteja concluído para todos os itens do projeto, as atualizações
não poderão ser publicadas enquanto o projeto não for aprovado.
c. Na guia Propriedades nas configurações de Acesso, conceda acesso de Editor ao grupo Revisores
de Conteúdo. Esse acesso é requerido para permitir que o revisor visualize os itens no projeto e
execute as etapas de aprovação.
2. Navegue para a página Notícias e clique em criar um rascunho.
Tip: É possível usar as configurações de acesso no estágio de Publicação do fluxo de trabalho para
permitir que os autores criem rascunhos de conteúdo publicado concedendo aos autores acesso de
Aprovador. Essa abordagem assegura que os autores não possam editar diretamente conteúdo
publicado. Nesse cenário, o grupo Editores de Conteúdo tem o acesso de Aprovador no estágio de
Publicação do Fluxo de Trabalho 1. Como o Autor 1 é membro do grupo Editores de Conteúdo, ele
está apto a criar um rascunho da página Notícias.
Figura 11. Captura de tela da barra de ferramentas do site, mostrando um link que permite ao autor criar um rascunho
da página Notícias.
3. Crie uma página filha da página Notícias.
a. Clique em Mais > Nova Página Filha.
Nota: Como o Autor 1 tem acesso apenas à página Notícias, o menu Mais mostra um conjunto
limitado de opções de criação de página.
Tutoriais
23
Figura 12. Captura de tela do menu Mais, mostrando que apenas a opção Nova Página Filha está disponível, devido
ao acesso concedido ao Autor 1.
b. Selecione o modelo de página Modelo 1 e insira Negócios para o nome da página.
c. Clique em Criar.
Nota sobre páginas gerenciadas e biblioteca de Site do Portal: Ao usar páginas gerenciadas, as
páginas que você cria no portal são armazenadas na biblioteca de Site do Portal. Por exemplo, neste
tutorial, quando o Autor 1 cria a página Negócios, uma área de site correspondente é criada na
biblioteca de Site do Portal. O caminho para a área de site da página do portal inclui a hierarquia de
páginas inteira até a raiz do contexto:
Conteúdo > Raiz de Conteúdo > Início > Notícias > Negócios
4. Inclua o conteúdo na página Negócios.
a. Clique na guia Conteúdo na barra de ferramentas do site.
b. Clique em Conteúdo da Web na lista de categorias. A barra de ferramentas do site mostra uma
lista de portlets de visualizador de conteúdo da web pré-configurados que você pode incluir na
página.
c. Inclua um visualizador de Rich Text e um visualizador de Imagem na página. O conteúdo nos
visualizadores não será renderizado enquanto você não clicar em Salvar Rascunho.
Nesse ponto, é possível editar o conteúdo renderizado pelos dois visualizadores com o recurso de
edição sequencial.
Conforme você atualiza a página e inclui conteúdo, as informações do projeto na barra de
ferramentas refletem essas mudanças.
Figura 13. Captura de tela das propriedades do projeto na barra de ferramentas do site, listando os itens recentes no
projeto que foram atualizados.
Tip: Embora este tutorial use conteúdo da web padrão, é possível incluir seu próprio conteúdo da
web na barra de ferramentas do site. Para obter detalhes, consulte Incluindo conteúdo da web
predefinido na barra de ferramentas do site.
5. Quando as mudanças no conteúdo estiverem concluídas, envie o projeto para revisão.
24
a. Clique em Mais > Próximo Estágio. Esta etapa move a página Negócios para o estágio de Revisão
do fluxo de trabalho.
b. Como também há itens de conteúdo no projeto, é possível enviar esses itens clicando em
Gerenciar na seção de propriedades do projeto da barra de ferramentas ou no menu do projeto.
Figura 14. Captura de tela das propriedades do projeto na barra de ferramentas do site, com a ação Gerenciar
destacada.
c. Na janela Gerenciar, selecione os itens do projeto que você precisa enviar para revisão e clique em
Mais > Aprovar. Neste tutorial, você deve enviar os itens Imagem, Rich Text e Notícias.
Nota: Como o item Notícias é uma página, é possível também enviar a página navegando para a
página e clicando em Mais > Próximo Estágio, se você preferir.
Quando você envia os itens do projeto para aprovação neste tutorial, o status do item na janela
Gerenciar é atualizado:
v Os dois itens da página (Notícias e Negócios) ainda mostram um status de Rascunho. Embora
as páginas agora estejam no estágio de Revisão do fluxo de trabalho, elas permanecem em um
estado de rascunho até que sejam aprovadas e o fluxo de trabalho prossegue para o estágio de
Publicação.
É possível verificar o estado do fluxo de trabalho atual de uma página na janela Gerenciar.
Clique no item da página e visualize as propriedades do fluxo de trabalho na guia
Propriedades.
v Os dois itens de conteúdo (Imagem e Rich Text) mostram um status de Publicação Pendente.
Como esses itens são incluídos como conteúdo de amostra com o portal, eles usam um fluxo de
trabalho de dois estágios simples que não incluem um estágio de revisão.
Tip: É possível criar seu próprio conteúdo para incluir na categoria Conteúdo da Web da barra
de ferramentas do site que use um fluxo de trabalho mais sofisticado. Nesse caso, anexe o fluxo
de trabalho ao item de conteúdo que é copiado quando o portlet é incluído em um página.
Tutoriais
25
Figura 15. Captura de tela dos itens do projeto na janela Gerenciar após o envio para revisão.
Etapa 6. Aprovar e publicar mudanças
Depois que o Autor 1 envia as mudanças no projeto Atualizações de Notícias para revisão, o Revisor 1
revisa as mudanças e envia o projeto para aprovação. O Aprovador 1 então acessa o projeto e aprova as
atualizações para publicação. Quando o projeto é enviado, o SiteAdmin o publica e as mudanças então
ficam disponíveis para todos os usuários no servidor de autoria.
1. O Revisor 1 abre o projeto Atualizações de Notícias no modo de edição.
a. Abra o menu do projeto e clique em Todos os Projetos.
b. Selecione Atualizações de Notícias na lista de projetos e clique em Selecionar.
Nota: A lista de projetos inclui apenas aqueles aos quais você tem acesso.
c. Clique em Editar Modo.
Figura 16. Captura de tela do menu do projeto com a ação Modo de Edição destacada.
2. O Revisor 1 navega para a página para revisão e envia as mudanças para aprovação final.
a. Nas propriedades do projeto, clique em Acessar para a página Negócios. Selecione essa opção
para navegar até a página e visualizar todo o conteúdo de rascunho no contexto.
Figura 17. Captura de tela das propriedades do projeto, com a ação Acessar destacada para a página Negócios.
b. Clique em Mais > Próximo Estágio para aprovar as mudanças e mover a página para o estágio de
Publicação do fluxo de trabalho.
26
c. Repita as etapas anteriores para aprovar a página Notícias. Todos os itens do projeto agora têm
um status de Publicação Pendente.
d. Envie o projeto para revisão clicando em Enviar para Revisão no menu do projeto.
Figura 18. Captura de tela do menu do projeto, com a ação Enviar para Revisão destacada.
Visualizando como Outro Usuário: É possível também optar por visualizar as mudanças como outro
usuário sem efetuar logout e login novamente. Para obter detalhes sobre visualização e configurações
de acesso necessárias, consulte Visualizando como Outro Usuário.
3. O Aprovador 1 efetua login e abre o projeto no modo de edição. Após a revisão das mudanças no
projeto, o Aprovador 1 clica em Aprovar no menu do projeto.
Figura 19. Captura de tela do menu do projeto, com a ação Aprovar destacada.
4. Quando as mudanças no projeto são aprovadas, o SiteAdmin publica o projeto tornando atual o
projeto Atualização de Notícias e clicando em Publicar no menu do projeto.
Related information
Visualizando como Outro Usuário
Etapa 7. Organizar mudanças para o servidor de entrega
Depois que o SiteAdmin publica o projeto, as atualizações estão prontas para organização no servidor de
entrega. Embora a organização seja executada em intervalos planejados, o SiteAdmin acessa o servidor de
entrega e inicia manualmente o processo de organização.
1. Efetue login no servidor de entrega como administrador.
2. Clique em Administração > Conteúdo do Portal > Assinantes.
3. Para o relacionamento de organização com o servidor de autoria, clique no ícone Atualizar Assinante.
Tutoriais
27
Uma vez concluída a organização, o servidor de entrega é atualizado automaticamente com a página
Negócios e seu conteúdo associado.
Figura 20. Captura de tela do servidor de entrega, com a nova página Negócios mostrada.
28
Planejando um Web Site
Antes de construir um website, reserve o tempo para analisar, planejar e
projetar o sistema inteiro que suporta o website. Você não deve planejar apenas o website, mas o sistema
de conteúdo da web que gerencia o website e a infraestrutura necessária para o sistema. Você também
deve definir antecipadamente as funções e os usuários envolvidos na construção do website e na
instalação da infraestrutura.
Definindo o Projeto
É importante ter uma compreensão dos objetivos, entregas e escopo de um sistema de conteúdo da Web.
A sua definição do projeto descreve o quê, o porquê e o quem do projeto e pode ser usada durante toda
a vida do sistema de conteúdo da Web.
Você define as seguintes informações em seu plano do projeto:
Experiência
Defina as informações de plano de fundo para o projeto. Essas informações podem incluir o porquê do
projeto estar sendo executado e qualquer histórico de projetos relacionados anteriores e atuais.
Missão
Qual é a missão do projeto? Gravar uma instrução da missão pode ajudar a determinar os requisitos do
Web site.
Objetivos
É essencial determinar os objetivos do projeto. Esses objetivos podem ser fornecidos pela equipe do
projeto, determinado a partir de reuniões com as pessoas interessadas no projeto e workshops de
usabilidade com usuários. É importante que todas as pessoas interessadas concordem com os objetivos
finais do site. Cada objetivo deve ser claro e conciso. Não deve haver espaço para suposições ou
interpretações variadas.
Objetivos de Negócios
Esses objetivos definem o que os negócios desejam alcançar. Eles focam nos interesses, como lucro
e valor da marca.
Exemplos de objetivos de negócios para um site da Internet incluem:
v
v
v
v
Reduzir custos de distribuição de press releases e materiais de vendas
Reduzir o número de ligações feitas pela equipe de suporte
Reforçar a lealdade de clientes existentes
Descobrir possíveis clientes on-line
Exemplos de objetivos de negócios para uma intranet incluem:
v Fornecer conteúdo especializado e padronizado para grupos-chave dentro da empresa
29
v Garantir que os funcionários sintam-se valorizados
v Reduzir custos de negócios tornando a equipe mais produtiva, melhorando suas tarefas
principais
Objetivos Operacionais
Os objetivos operacionais podem ser agrupados de acordo com objetivos a curto e a longo prazos.
Exemplos de objetivos operacionais incluem:
v Fornecer informações para funcionários da empresa
v Fornecem informações para clientes
v Desenvolver qualificações dentro da empresa para administrar um Web site
v Desenvolver funcionalidade de conexão única
Objetivos do Usuário
Esses objetivos definem as necessidades do usuário do Web site e são cruciais para desenvolver
os objetivos, a estrutura e a funcionalidade do site.
Exemplos de um objetivo do usuário para um site da Internet incluem:
v Facilitar a localização do que eu desejo
v Tornar as informações compreensíveis e relevantes
v Deixar-me saber onde estou no site
v Manter minha privacidade
Exemplos de um objetivo do usuário para uma intranet incluem:
v Localizar informações relevantes e atualizadas com a maior rapidez possível
v Manter-me informado das notícias e atualizações mais recentes
v Ajudar-me a executar funções principais, como preencher planilhas de horas e aplicar licenças
v Reduzir minhas frustrações
v Deixar-me publicar informações
v Ajudar-me a sentir conectado, com suporte e valorizado
Objetivos do Site
Os objetivos do site são derivados dos negócios, operacionais e objetivos do usuário. Eles podem
ser o resultado da interseção dos negócios, operacionais e objetivos do usuário, ou eles podem ser
objetivos adicionais resultantes da análise.
Exemplos de objetivos do site para um site da Internet incluem:
v Fornecer facilidade e clareza para entender a navegação que permite aos usuários localizar
informações com rapidez
v Fornecer um recurso de procura
v Gravar um conteúdo da Web para facilitar a leitura e a compreensão
v Fornecer uma seção de Perguntas Mais Frequentes especificando as perguntas mais frequentes
da equipe de suporte
v Fornecer uma estrutura que organize o conteúdo do usuário e não a divisão de negócios
Exemplos de objetivos do site para uma intranet incluem:
v Fornecer facilidade e clareza para entender a navegação que permite aos usuários localizar
informações com rapidez
v Suporte a tarefas-chave principais, como entrada na planilha
v Fornecer uma seção de notícias customizada
v Fornecer uma seção de Perguntas Mais Frequentes especificando as perguntas mais frequentes
da equipe de suporte
v Fornecer uma estrutura que organize o conteúdo do usuário e não a divisão de negócios
30
v Permitir que a equipe insira conteúdo que é então colocado em um fluxo de trabalho antes de
ser publicado na intranet
Equipes do Projeto
Defina a função de cada uma das equipes envolvidas no projeto e a organização das equipes. Alguns
exemplos da equipe do projeto incluem:
Patrocinadores Executivos
Os proprietários e condutores do projeto
Equipe do Projeto
Responsáveis pelo gerenciamento, pela análise e pela construção dia a dia do novo site
Grupo de Referência
Representantes da unidade de negócios consultados para garantir que suas necessidades sejam
determinadas
Grupo do Foco
Representantes do usuário consultados para garantir que o novo site seja focado no usuário
Distribuíveis
Documenta todos os distribuíveis do projeto. Forneça uma descrição do que são os distribuíveis e o
intervalo de tempo esperado para entrega.
Planejamento de Recursos Humanos
Estas funções são exemplos do tipo de trabalho executado pelas pessoas que criam e gerenciam um Web
site. Uma única pessoa pode ser responsável por mais de uma das funções descritas nesta seção. As
funções que você implementa em sua organização para suportar seu Web site são determinadas pelo
tamanho e complexidade do sistema que está sendo implementado. Nem todas as funções a seguir são
necessárias para todo Web site, mas todos os aspectos dessas funções devem ser considerados durante
qualquer implementação do sistema.
O Gerente de Projeto
As grandes implementações complexas requerem um gerente de projeto para assegurar que haja recursos
suficientes disponíveis para implementar um sistema, que os usuários corretos tenham sido designados
ao projeto e que as tarefas necessárias para implementar o sistema ocorram no momento correto no
processo de implementação geral.
Definindo o projeto:
É importante ter um entendimento dos objetivos, distribuíveis e escopo de um sistema de
conteúdo da Web. O gerente de projeto é responsável por criar um plano do projeto para
documentar o escopo e objetivos gerais do projeto.
v “Definindo o Projeto” na página 29
Inspecionando o desenvolvimento de um protótipo do site e documentos de design:
Após definir o projeto e criar um documento de análise, o gerente de projeto é responsável por
inspecionar o desenvolvimento de um protótipo do site e documentos de design.
v “Projetando um Web Site de Protótipo Usando HTML” na página 47
v “Criando um Documento de Análise” na página 45
Assegurando que o projeto tenha o nível ideal de recursos humanos e físicos:
O gerente de projeto é responsável por assegurar que recursos humanos e físicos suficientes
tenham sido planejados para o design inicial, desenvolvimento e manutenção contínua do Web
site e infraestrutura relacionada.
31
Projeto que gerencia a implementação e instalação do hardware e software usados para gerenciar e
entregar o Web site:
O gerente de projeto é responsável por inspecionar a implementação e instalação do hardware e
software usados para gerenciar e entregar o Web site. O gerente de projeto monitora o progresso
da implementação geral e executa a ação apropriada para assegurar que marcos sejam atingidos a
tempo e no orçamento.
v Instalando
Projeto que gerencia a manutenção e conservação contínuas do hardware e software usados para
gerenciar e entregar o Web site:
O gerente de projeto também desenvolve um plano para o monitoramento e manutenção
contínuos do Web site e infraestrutura relacionada.
v “Mantendo o Conteúdo da Web” na página 569
Planejando instalar o WebSphere Portal
O Analista de Negócios
Um analista de negócios é responsável por desenvolver um documento de análise.
O analista de negócios é responsável por desenvolver um documento de análise. Este documento é usado
para registrar as informações reunidas de partes interessadas que determinam o design do Web site, seu
conteúdo e seus recursos. O documento de análise inclui informações sobre:
v Os tipos de usuários que usarão o sistema
v Quais recursos e aplicativos serão necessários no Web site
v Qual conteúdo existente precisará ser importado para o novo sistema de conteúdo da Web e qual novo
conteúdo precisará ser criado
32
“Criando um Documento de Análise” na página 45
Um documento de análise é usado para registrar as informações reunidas de pessoas interessadas que
determinam o design do Web site, seu conteúdo e seus recursos.
A Equipe de Arquitetura e Design
Com base nos dados coletados no documento de análise, a a equipe de arquitetura e design documenta
todas as coisas requeridas pelo sistema WebSphere Portal. Os documentos de design que a equipe
documenta são usados pelas equipes de implementação e desenvolvimento para implementar e gerenciar
o sistema WebSphere Portal.
A Equipe de Arquitetura Técnica
Os arquitetos técnicos são responsáveis por projetar a topologia de servidor geral necessária para o
sistema inteiro e a arquitetura dos servidores que compõem o sistema. A equipe de arquitetura técnica
pode incluir arquitetos técnicos, arquitetos de banco de dados, arquitetos de segurança, engenheiros de
desempenho e outros recursos, conforme necessário.
Determinando uma arquitetura de servidor:
O arquiteto técnico é responsável por projetar uma arquitetura de servidor, descrevendo todos os
servidores e o software relacionado necessários para entregar o Web site.
v “Arquitetura do Servidor” na página 48
v Topologias de Servidor
Determinando uma arquitetura de banco de dados:
O arquiteto de banco de dados é responsável por projetar uma arquitetura de banco de dados,
descrevendo todas as definições de configuração necessárias para os bancos de dados usados no
sistema.
v Considerações sobre o banco de dados
v Considerações sobre o registro do usuário
Determinando estratégias de organização:
O arquiteto técnico determina quais estratégias de organização são necessárias entre os diferentes
ambientes no sistema de conteúdo da Web.
v “Visão Geral de Distribuição” na página 711
Determinando uma arquitetura de segurança:
O arquiteto de segurança é responsável por projetar uma arquitetura de segurança, descrevendo
todos os grupos e funções e os níveis de acesso necessários para assegurar que diferentes tipos de
usuários tenham acesso apenas a funções e conteúdo apropriados para suas funções.
33
v
v
v
v
“Arquitetura de Segurança” na página 49
“Usuários, Grupos e Funções” na página 245
Usuários e grupos
Controlando o acesso
Determinando uma arquitetura de aquisição de conteúdo:
O arquiteto técnico é responsável por projetar uma aquisição de conteúdo, descrevendo os
detalhes técnicos dos métodos a serem usados ao importar o conteúdo existente no novo sistema
de conteúdo da Web. O conteúdo a ser importado é baseado nas informações coletadas no
documento de análise.
v “Arquitetura de Aquisição de Conteúdo” na página 57
v “Criando um Documento de Análise” na página 45
v “A API do IBM Web Content Manager” na página 599
Determinando estratégias de entrega:
O arquiteto técnico é responsável por determinar quais métodos de entrega são mais adequados
para os tipos de Web sites que estão sendo entregues.
v “Arquitetura de Entrega” na página 58
v “Tipos de Web Sites” na página 7
v “Entregando o conteúdo da Web” na página 517
Determinando estratégias de manutenção do sistema:
A equipe de arquitetura técnica também é responsável por determinar as estratégias e os
procedimentos de manutenção contínuos do sistema.
v “Arquitetura de Manutenção” na página 59
Topologias do Servidor
Instalando o WebSphere Portal
O Arquiteto de Informações
O arquiteto de informações determina a estrutura informativa geral do Web site com base nos requisitos
reunidos no documento de análise.
Determinando a estrutura do Web site:
A estrutura do website projetada pelo arquiteto de informações determina:
v Quais páginas de Portal precisarão ser criadas se estiver usando a entrega de portlet.
v Quais áreas de site precisarão ser criadas
34
v “Páginas Gerenciadas” na página 151
v “Planejando uma Estrutura de Site” na página 179
Determinando quais tipos de conteúdo são necessários:
Os tipos de conteúdo necessários para cada seção na estrutura do Web site determinam:
v Quais modelos de autoria são necessários
v Quais modelos de apresentação são necessários
v
v
v
v
Quais mapas de modelo são necessários
“Trabalhando com Modelos de Autoria” na página 171
“Modelos de Apresentação” na página 182
“Mapas de Modelo” na página 185
Determinando uma arquitetura de perfil de conteúdo:
O arquiteto de informações determina qual perfil de conteúdo é necessário para recursos como
menus.
v “Estratégias do Traçado de Perfil” na página 187
“Gerenciamento de Itens” na página 328
O IBM Web Content Manager inclui um intervalo de recursos que permitem gerenciar os itens de
conteúdo da Web usados em seu sistema.
“Entregando o conteúdo da Web” na página 517
O tipo de método de entrega usado para entregar o conteúdo da Web para seus
visualizadores dependerá do tipo de conteúdo que estiver sendo entregue e do tipo de visualizadores ao
qual seu Web site é destinado.
O Designer de Web Site
Um designer de Web site é responsável por projetar o layout e estilo das páginas da Web em um Web
site. Um designer gráfico também pode ser usado para criar gráficos e esquemas de cores para o Web
site.
Determinando quais temas, folhas de estilo e modelos são necessários:
O designer de Web site determina quais temas, folhas de estilo e modelos de apresentação são
necessários para entregar o Web site.
v “Arquitetura de Design” na página 54
v “Projetando um Web Site de Protótipo Usando HTML” na página 47
v Criando um Modelo de Apresentação
Determinando quais elementos e componentes são necessários:
Os tipos de página e modelos de apresentação necessários para seu site determinam:
v Quais componentes são necessários
v Quais elementos são necessários para cada modelo de autoria
v Quais elementos são necessários para serem armazenados nas áreas de site
35
v “Componentes” na página 187
Determinando estratégias de personalização:
O designer de Web site determina quais estratégias de personalização são necessárias para o Web
site.
v “Personalização” na página 331
O Arquiteto do Sistema de Autoria
O arquiteto do sistema de autoria é responsável por determinar a arquitetura do sistema de autoria usado
para criar e gerenciar conteúdo da Web.
Projetando a arquitetura de biblioteca:
O arquiteto do sistema de autoria determina quais bibliotecas são necessárias para o Web site.
v “Bibliotecas de Conteúdo da Web” na página 127
Determinando quais modelos de autoria são necessários:
O arquiteto do sistema de autoria documenta a configuração de cada modelo de autoria usado no
sistema de autoria e quais mapas de modelo são necessários para vincular modelos de autoria e
modelos de apresentação.
v “Trabalhando com Modelos de Autoria” na página 171
v “Mapas de Modelo” na página 185
Projetando uma arquitetura de pasta:
O arquiteto do sistema de autoria determina quais pastas são necessárias para armazenar tipos de
itens em agrupamentos lógicos.
v “Trabalhando com Pastas” na página 328
Projetar um modelo de gerenciamento de mudanças:
O arquiteto do sistema de autoria determina quais fluxos de trabalho são necessários para
gerenciar processos de aprovação e quais itens requerem um fluxo de trabalho.
v “Gerenciamento de Fluxo de Trabalho e Mudanças” na página 137
Determinar estratégias de controle de versão:
O arquiteto do sistema de autoria determina quais estratégias de controle de versão são aplicadas
ao sistema de conteúdo da Web.
v “Gerenciando Versões de Itens” na página 328
“Gerenciamento de Itens” na página 328
A Equipe de Implementação
Com base nos documentos de design desenvolvidos pela equipe de design técnico, a equipe de
implementação constrói e gerencia o sistema WebSphere Portal.
36
O Administrador de Banco de Dados
Um administrador de banco de dados é responsável por implementar os servidores de banco de dados e
repositórios de dados com base na arquitetura técnica desenvolvida pelo arquiteto do banco de dados.
O administrador de banco de dados é responsável por instalar todos os bancos de dados usados pelo
Web site e sistema relacionados. Os bancos de dados que o administrador configura são baseados na
arquitetura técnica desenvolvida pelos arquitetos técnicos e de banco de dados. O administrador de
banco de dados precisará familiarizar-se com a documentação do usuário dos repositórios de dados e de
usuário usados pelo sistema de conteúdo da Web.
“Arquitetura do Servidor” na página 48
Seus arquitetos técnicos definem quais ambientes de conteúdo da Web são necessários para o sistema e os
servidores necessários para cada ambiente. Essas informações asseguram que você tenha todos os
recursos de hardware necessários para suportar o sistema de conteúdo da Web
Considerações sobre Bancos de Dados
Considerações sobre o Registro do Usuário
O Administrador do WebSphere Portal
Um administrador do WebSphere Portal é responsável pela implementação e gerenciamento gerais dos
servidores em uma implementação do WebSphere Portal baseada na arquitetura desenvolvida pelo
arquiteto técnico.
Instalando e configurando o WebSphere Portal:
O administrador do WebSphere Portal é responsável por instalar e configurar todas as instâncias
do WebSphere Portal usadas no sistema geral.
v Instalando
v Configurando
Migração:
O administrador do WebSphere Portal é responsável por migrar dados e definições de
configuração de versões mais antigas do WebSphere Portal.
v Migrando
“Arquitetura de Segurança” na página 49
A arquitetura de segurança descreve quais grupos são necessários em seu site e qual acesso é necessário
para diferentes grupos para o portlet de autoria e o Web site renderizado.
O Administrador de Conteúdo da Web
Um administrador de conteúdo da Web é responsável por configurar os servidores de conteúdo da Web
em um sistema WebSphere Portal.
Ambientes de Autoria do Conteúdo da Web
Em um ambiente de autoria de conteúdo da Web, um administrador de conteúdo da Web executa as
seguintes tarefas:
37
Criar novas páginas
Um administrador pode precisar criar novas páginas para exibir portlets de autoria adicionais
usados por usuários diferentes ou para exibir portlets de visualizador de conteúdo da Web para
visualizar sites neles.
v “Páginas” na página 129
v “Páginas de Portal Customizadas para Autoria” na página 255
Configurar um portlet de autoria
Cada portlet de autoria em um ambiente de autoria precisa ser configurado para assegurar que
ele tenha sido configurado corretamente para os usuários usando cada portlet de autoria.
v “Configurações do Portlet de Autoria” na página 257
Configurar um portlet de visualizador de conteúdo da Web
Cada portlet de visualizador de conteúdo da Web em um ambiente de autoria precisa ser
configurado para exibir o conteúdo que está sendo visualizado.
v “Visualizadores de Conteúdo da Web” na página 519
v “Exibindo Conteúdo com Visualizadores de Conteúdo da Web” na página 534
Criar bibliotecas de conteúdo da Web
O administrador de conteúdo da Web cria um conjunto de bibliotecas de conteúdo da Web com
base nas recomendações do arquiteto de conteúdo da Web.
v “Bibliotecas de Conteúdo da Web” na página 127
Clonar um repositório de conteúdo da Web
Antes de ativar a organização, um administrador de conteúdo da Web, com um administrador de
banco de dados, clona um repositório de conteúdo da Web a partir do ambiente de autoria para
outros ambientes.
v “Clonando um Repositório de Conteúdo da Web” na página 596
Gerenciar a organização
Os relacionamentos da organização, normalmente, são criados em servidores do assinante. Como
você geralmente organiza apenas a partir de um ambiente de autoria para outros ambientes, não
criaria, normalmente, um relacionamento de organização a partir de um ambiente de autoria, mas
um administrador de conteúdo da Web pode precisar gerenciar as definições e configurações de
organização de tempos em tempos.
v Trabalhando com Organizadores e Assinantes
v “Ajuste de Sindicância” na página 721
Criar e gerenciar configurações e tarefas de alimentação
Às vezes, o conteúdo da Web é armazenado e mantido em sistemas externos. Use o Web Content
Integrator para consumir o conteúdo a partir de sistemas externos usando alimentações.
v Gerenciamento de Feed de Conteúdo da Web
Ajustar definições de configuração do ambiente de autoria
As definições de configuração do ambiente de autoria podem ser sintonizadas para recursos
específicos.
v “Configurando um Ambiente de Autoria de Conteúdo da Web” na página 67
Ambientes de Entrega do Conteúdo da Web
Em um ambiente de entrega de conteúdo da Web, um administrador de conteúdo da Web executa as
seguintes tarefas:
Criar novas páginas
Um administrador pode precisar criar novas páginas ao exibir conteúdo usando portlets de
visualizador de conteúdo da Web.
38
v “Páginas” na página 129
Configurar um portlet de visualizador de conteúdo da Web
Cada portlet de visualizador do conteúdo da Web em um ambiente de entrega precisa ser
configurado para exibir o conteúdo correto.
v “Visualizadores de Conteúdo da Web” na página 519
Gerenciar a organização
Um administrador de conteúdo da Web cria relacionamentos de organização para o ambiente de
entrega a partir dos ambientes de migração de dados e de autoria do conteúdo da Web.
Ajustar definições de configuração de um ambiente de entrega
As definições de configuração do ambiente de entrega podem ser sintonizadas para recursos
específicos.
v “Configurando um Ambiente de Entrega de Conteúdo da Web” na página 83
Em um Ambiente de UAT:
Um ambiente de teste de aceitação do usuário é configurado semelhante aos ambientes de autoria e de
entrega, dependendo do tipo de UAT que está sendo executado. As tarefas necessárias para configurar o
ambiente do UAT são as mesmas que aquelas dos ambientes de autoria e de entrega.
“Arquitetura de Entrega” na página 58
Os arquitetos técnicos e de informações precisam definir quais os métodos de entrega mais apropriados
para o Web site que você está entregando.
“Arquitetura do Servidor” na página 48
O Administrador de Segurança
Um administrador de segurança é responsável pela segurança do sistema geral, incluindo estratégias e
firewalls de controle de acesso.
Implementando o plano de segurança descrito no documento de arquitetura de segurança:
O administrador de segurança é responsável por implementar os recursos e processos de
segurança descritos no documento de arquitetura de segurança desenvolvido pelo arquiteto de
segurança.
v Considerações de segurança e autenticação
v “Arquitetura de Segurança” na página 49
Gerenciando o registro do usuário:
O administrador de segurança mantém o registro de segurança, executando várias tarefas de
atualização e exclusão.
v Gerenciando dados do usuário
Gerenciando usuários e grupos:
O administrador de segurança mantém os usuários e grupos armazenados no registro do usuário.
39
v Usuários e grupos
Gerenciando o controle de acesso
O administrador de segurança gerencia os controles de acesso a páginas, portlets, módulos e
outros aplicativos.
v Controlando o acesso
Tarefas de segurança adicionais
Há várias outras tarefas executadas pelo administrador de segurança, dependendo de qual
ambiente está sendo usado.
v Ativando a autenticação de configuração, o cookie Lembrar-me ou ambos
A Equipe de Desenvolvimento
Com base nos documentos de design desenvolvidos pela equipe de design técnico, a equipe de
desenvolvimento é responsável por criar aplicativos customizados usando a API do produto.
O Desenvolvedor de Portlet
O desenvolvedor de portlet é responsável por desenvolver novos portlets.
O desenvolvedor de portlet é responsável principalmente por criar portlets customizados usados para
agregar conteúdo e função de aplicativos externos. Os portlets desenvolvidos são baseados nos portlets
identificados no documento de design.
“Arquitetura de Design” na página 54
A arquitetura de design descreve qual será a aparência do seu Web site e quais componentes serão
necessários para construir o site. Você precisará definir modelos de apresentação, componentes e temas.
Desenvolvendo
O Desenvolvedor de Tema
Um desenvolvedor de tema é responsável por criar novos temas com base nos designs desenvolvidos
pelo arquiteto de informações e pelo designer gráfico.
O desenvolvedor de tema é responsável principalmente por criar temas customizados com base nos
designs de Web site descritos na arquitetura de design e no HTML usado no protótipo do Web site.
Temas são um conjunto de JSPs, imagens e folhas de estilo enviados com a estrutura do diretório comum.
Eles podem ser enviados diretamente no wps.war ou dentro de um arquivo WAR separado, ou com
outros temas, aparências e recursos.
40
“Projetando um Web Site de Protótipo Usando HTML” na página 47
Antes de criar um documento de design para o seu sistema de conteúdo da Web, pode ser útil criar um
protótipo do seu site usando HTML. Esse protótipo deve ser baseado na estrutura de tópicos definida em
seu plano de projeto e nos dados reunidos em seu documento de análise. A estrutura do site, o design e o
código HTML que você desenvolve para o seu protótipo podem ser usados como a base para vários dos
itens definidos em seu documento de design.
O Desenvolvedor de Conteúdo da Web
Um desenvolvedor de conteúdo da Web é responsável por estender o Web Content Manager usando a
API do Web Content Manager, desenvolvendo componentes JSP e criando plug-ins de conteúdo da Web.
A API do Web Content Manager
É possível usar a API do Web Content Manager para estender funções do Web Content Manager.
Interfaces de Autoria Customizadas
As interfaces de autoria customizadas são usadas por autores de conteúdo como uma alternativa
para usar o portlet de autoria.
v “Criando uma Página de Ativação Customizada” na página 619
v “Utilizando Ações Remotas” na página 608
Plug-ins Customizados
É possível criar plug-ins customizados para incluir recursos customizados em seu site como ações
do fluxo de trabalho customizadas e provedores de texto para sites com múltiplos códigos do
idioma.
v “Criando Plug-ins Customizados” na página 620
A Equipe de Criação de Web Site
Com base nos documentos de design desenvolvidos pela equipe de design técnico, a equipe de criação de
Web site é responsável por criar o Web site e sistemas relacionados.
O Criador de Web Site
Um criador de Web site é responsável por construir um Web site, criando modelos de apresentação,
modelos de autoria, áreas de site, componentes e categorias. O criador de Web site também é responsável
por criar itens de gerenciamento de conteúdo, como pastas e fluxos de trabalho. Os itens criados por um
criador de Web site são baseados nos designs criados pelo arquiteto de informações e pelo designer
gráfico.
Criando Itens de Gerenciamento de Conteúdo da Web
Antes de criar um Web site, o criador de conteúdo da Web começa criando quaisquer itens de
gerenciamento de conteúdo necessários:
Criando pastas
As pastas são usadas para armazenar tipos de itens em agrupamentos lógicos.
v “Trabalhando com Pastas” na página 328
41
Criando fluxos de trabalho
Os fluxos de trabalho são necessários para gerenciar os processos de aprovação dos itens.
v “Gerenciamento de Fluxo de Trabalho e Mudanças” na página 137
Criando projetos
Os projetos são usados para gerenciar o processo de aprovação de uma coleta de itens.
v “Visão Geral dos Projetos” na página 134
Criando um Web Site
Para criar um Web site, os seguintes itens do Web Content Manager precisarão ser criados:
Áreas de site
As áreas de site são usadas para definir a estrutura de um site. Os itens de conteúdo que fazem
parte da estrutura do site serão armazenados na estrutura do site.
v Criando Áreas de Site
Modelos de Autoria
Os modelos de autoria são necessários para os diferentes tipos de páginas em um Web site. Os
itens de conteúdo criados por autores de conteúdo serão baseados nos modelos de autoria criados
pelo criador de Web site.
v “Criando Modelos de Autoria” na página 171
Modelos de apresentação
Os modelos de apresentação determinam o layout das páginas em um Web site e são vinculados
aos modelos de autoria pelos mapas de modelo definidos nas áreas de site.
Elementos e componentes
Os elementos são incluídos nos modelos de autoria e áreas de site para armazenar diferentes
tipos de conteúdo. Os componentes são usados para criar elementos únicos que podem ser
reutilizados em um Web site.
v “Elementos” na página 189
Categorias
As categorias são usadas para definir o perfil de itens que foram configurados para permitir a
definição de perfil de conteúdo.
v “Planejando uma Taxonomia” na página 188
“Arquitetura de Informações” na página 52
A arquitetura de informações descreve a estrutura de informações do site e como os usuários navegarão
pelo site.
O Autor de Conteúdo da Web
Um autor de conteúdo da Web é responsável por criar conteúdo da Web para os sites desenvolvidos e
gerenciados usando o Web Content Manager.
Os autores de conteúdo criam conteúdo acessando um portlet de autoria ou usando uma interface de
autoria de conteúdo customizada.
Criando itens de conteúdo
Os modelos de apresentação determinam o layout das páginas em um Web site e são vinculados
aos modelos de autoria pelos mapas de modelo definidos nas áreas de site.
v “Itens de conteúdo” na página 186
42
Trabalhando com elementos e componentes
Os elementos são incluídos nos modelos de autoria e áreas de site para armazenar diferentes
tipos de conteúdo. Os componentes são usados para criar elementos únicos que podem ser
reutilizados em um Web site.
v “Elementos” na página 189
O Gerenciador de Conteúdo da Web
Um gerenciador de conteúdo da Web é responsável por executar atividades de manutenção do site
contínuas.
Movendo, vinculando e copiando itens:
De tempos em tempos, um gerenciador de conteúdo da Web precisará reprojetar a estrutura de
um Web site movendo ou copiando itens.
Gerenciando modelos de autoria:
De tempos em tempos, um gerenciador de conteúdo da web precisará reaplicar ou alterar o
modelo de autoria usado por itens de conteúdo e áreas de site.
Restaurando itens:
De tempos em tempos, um gerenciador de conteúdo da Web precisará restaurar um item para
uma versão salva anteriormente.
Editando perfis de usuário:
Informações de definição de perfil específicas para um sistema de conteúdo da Web podem ser
incluídas em um perfil do usuário para permitir que você personalize o conteúdo para um
conjunto específico de usuários.
Gerenciando controles de acesso
De tempos em tempos, um gerenciador de conteúdo da Web precisará reaplicar ou alterar os
controles de acesso de um conjunto de itens.
A Equipe de Aquisição de Conteúdo
Com base no conteúdo identificado no documento de análise, a equipe de aquisição de conteúdo é
responsável por importar conteúdo de sistemas legados para o novo Web site. A equipe consiste em uma
mistura de administradores e desenvolvedores. Os membros de equipe precisam ser especialistas em
produtos legados e no WebSphere Portal
A API do Web Content Manager:
É possível usar a API do Web Content Manager para importar conteúdo para o Web Content
Manager.
Alimentações de Conteúdo da Web
Use o Web Content Integrator para consumir o conteúdo a partir de sistemas externos usando
alimentações.
Usando WebDAV para conteúdo da Web:
Com o WebDAV para WebSphere Portal, é possível usar ferramentas do sistema operacional
padrão para criar, modificar e excluir o conteúdo da Web em vez do portlet de autoria padrão.
43
“Arquitetura de Aquisição de Conteúdo” na página 57
A arquitetura de aquisição de conteúdo é usada para definir qual conteúdo existente será importado no
sistema de conteúdo da Web, como ele será importado e qual conteúdo precisará ser criado.
A Equipe de Manutenção
Com base na arquitetura de manutenção desenvolvida pela equipe de design técnico, a equipe de
manutenção é responsável pelo monitoramento e manutenção contínuos do sistema geral.
O Administrador de Banco de Dados
Após todos os bancos de dados serem configurados, o administrador de banco de dados é responsável
pelo monitoramento e manutenção contínuos de todos os bancos de dados no sistema.
O Administrador do WebSphere Portal
O administrador do WebSphere Portal é responsável pela manutenção contínua dos servidores
WebSphere Portal no sistema.
v Administrando
O Administrador de Conteúdo da Web
Gerenciar organização:
Os relacionamentos da organização, normalmente, são criados em servidores do assinante. Como
você geralmente organiza apenas a partir de um ambiente de autoria para outros ambientes, não
criaria, normalmente, um relacionamento de organização a partir de um ambiente de autoria, mas
um administrador de conteúdo da Web pode precisar gerenciar as definições e configurações de
organização de tempos em tempos.
Gerenciar configurações e tarefas de alimentação:
Às vezes, o conteúdo da Web é armazenado e mantido em sistemas externos. Use o Web Content
Integrator para consumir o conteúdo a partir de sistemas externos usando alimentações.
v Gerenciamento de Feed de Conteúdo da Web
Manter um sistema de autoria:
De tempos em tempos, um administrador de conteúdo da Web precisa executar algumas tarefas
de manutenção.
O Administrador de Segurança
Gerenciando o registro do usuário:
O administrador de segurança mantém o registro de segurança, executando várias tarefas de
atualização e exclusão.
Gerenciando os usuários e grupos:
O administrador de segurança mantém os usuários e grupos armazenados no registro do usuário.
v Usuários e grupos
Gerenciando o controle de acesso:
O administrador de segurança gerencia os controles de acesso a páginas, portlets, módulos e
outros aplicativos.
44
v Controlando o acesso
Tarefas de segurança adicionais:
Há várias outras tarefas executadas pelo administrador de segurança, dependendo do ambiente
que está sendo usado.
v Ativando a autenticação de configuração, o cookie Lembrar-me ou ambos
O Engenheiro de Desempenho
O engenheiro de desempenho é responsável por assegurar que todo o hardware e software no sistema
seja ajustado para desempenho e confiabilidade máximos.
v Resolução de problemas
“Arquitetura de Manutenção” na página 59
Existe um conjunto de tarefas que você precisa planejar que manterá a saúde e a integridade do seu
sistema de conteúdo da Web. Os arquitetos técnico e de banco de dados precisarão definir quais
procedimentos de manutenção são necessários em seu sistema e quando e com que frequência eles
precisam ser executados.
Criando um Documento de Análise
Um documento de análise é usado para registrar as informações reunidas de pessoas interessadas que
determinam o design do Web site, seu conteúdo e seus recursos.
Há alguns exemplos das análises que podem ser executadas ao projetar um sistema de conteúdo da Web.
Análise do Usuário
Para projetar um Web site que suporte as necessidades da empresa e dos usuários, você deve conhecer
seu público. Isso é importante para determinar seus usuários nesse estágio inicial do projeto. Algumas
das coisas que você deseja descobrir são:
v Quem são eles?
v Quais são os grupos mais importantes?
v O que eles desejam fazer no site?
v O que fará com que eles retornem ao site?
v Qual o nível de experiência deles na Web?
Para ajudá-lo a entender ainda mais os seus principais grupos de usuários, é possível desenvolver
personagens e cenários:
Personagens
Um personagem é uma pessoa imaginária que representa um grupo de usuários principal para o
seu site. Usando as informações reunidas sobre esses usuários, crie uma pessoa que represente
cada grupo de usuários principal. Forneça a eles:
v Um nome e uma imagem
v Dados demográficos, como idade, escolaridade e status familiar
v Cargo e responsabilidades
v Seus objetivos e tarefas em relação ao site
v Um plano de fundo em seu computador e uso da Web
Cenários
Um cenário é uma história de como os usuários podem aproveitar o site. Ele ajuda a visualizar o
site e seus usuários. Eles podem ajudá-lo a visualizar o processo de navegação como um todo. Os
cenários são úteis também para validar o design do Web site depois que ele for concluído e
45
podem ser usados para testar a usabilidade. Use seus personagens e forneça a eles uma tarefa
para ser executada no site. Grave uma história sobre como o caractere usa o site para concluir a
tarefa fornecida. Seja criativo.
Análise Competitiva
Se você estiver construindo um Web site público, é útil dar uma olhada no que a concorrência está
fazendo. Gere uma lista de concorrentes e documente coisas que você gosta e não gosta a respeito dos
seus sites da Internet. Para sites da intranet em que você não pode comparar seu site com os dos
concorrentes, é possível assegurar que sua intranet atenda aos padrões atuais.
Requisitos do Web Site
Os requisitos da Web site descrevem os recursos e as funções de um Web site. Eles documentam o que o
site deve ter e também o que os usuários devem fazer. Os requisitos não são usados para descrever como
construir o Web site, que é detalhado no documento de design.
Exemplo:
Recursos Gerais:
v Procura
v Detalhes do contato
Permitir que os usuários:
v Comprem um produto
v Inscrevam-se em um newsletter
v Preencham um time-sheet on-line
Incluir o seguinte conteúdo e áreas de site:
v Press releases
v Políticas e guias
v Links para artigos relacionados
Inventário do Conteúdo
É útil identificar os tipos de conteúdo que compõem o site. Como o seu novo Web site pode ser
reprojetado de um site existente, identifique o conteúdo existente e o novo conteúdo que deve ser
gravado. Crie um inventário de conteúdo e inclua todas as páginas da Web existentes e os tipos possíveis
de conteúdo que você pensar. Os tipos de conteúdo incluem:
v Conteúdo estático, como avisos de copyright e instruções de privacidade
v Conteúdo dinâmico, como notícias mais recentes e campanhas de produtos
v Conteúdo transacional, como páginas de logon e páginas de registro para newsletters de e-mail
Ao criar um inventário de conteúdo, é possível coletar as seguintes informações:
v
v
v
v
v
v
v
Uma breve descrição
Área ou categoria do tópico
Prioridade
Formato, como uma página da Web, um arquivo ou um papel
Público desejado
Conteúdo relacionado
Data de criação
v Data de última modificação
v Proprietário
46
v Autor
v Data de Expiração
Projetando um Web Site de Protótipo Usando HTML
Antes de criar um documento de design para o seu sistema de conteúdo da Web, pode ser útil criar um
protótipo do seu site usando HTML. Esse protótipo deve ser baseado na estrutura de tópicos definida em
seu plano de projeto e nos dados reunidos em seu documento de análise. A estrutura do site, o design e o
código HTML que você desenvolve para o seu protótipo podem ser usados como a base para vários dos
itens definidos em seu documento de design.
Criando um Web site de protótipo usando HTML, você consegue ver como o Web site realmente se
parecerá, além de desenvolver vários dos recursos usados pelo seu sistema de conteúdo da Web e seu
Web site.
Construindo o Protótipo
v O Web site de protótipo deve incluir páginas de exemplo de cada tipo de página definido em seu
plano de projeto e seu documento de análise. Ele deve incluir também a estrutura de site básica do seu
Web site proposto.
v O protótipo deve ser um Web site funcional. Ele deve incluir o funcionamento de recursos de
navegação para permitir que você navegue pelo protótipo. Exemplos do conteúdo real são usados para
preencher o protótipo.
v Lembre-se de garantir que o HTML e outro código gravado para criar o protótipo atenda às boas
práticas de codificação, pois a maioria dos códigos que você desenvolve para o protótipo será
reutilizada em seu site do Web Content Manager.
Usando HTML para Planejar o Design de seu Site
Um método útil para começar a projetar o seu sistema de gerenciamento de conteúdo é usar HTML para
desenvolver um protótipo de seu site. Execute essa tarefa após prévia consulta com o arquiteto de
informações de conteúdo da Web.
O site HTML deve incluir:
v O design para as principais páginas iniciais de cada seção de seu site
v O design para páginas de conteúdo em cada seção
v Os recursos de navegação de seu site
O site HTML pode ser usado para ajudá-lo a determinar quais itens de conteúdo da Web precisam ser
criados em seu sistema de gerenciamento de conteúdo da Web.
Por exemplo, o design de cada página da Web no alvo simulado HTML pode determinar partes
diferentes do seu site do Web Content Manager:
v O layout de cada página HTML determina o layout de seus modelos de apresentação.
v O design dos recursos de navegação determina quais menus e navegadores precisarão ser criados.
47
Outros recursos de design, como imagens e folhas de estilo, determinarão quais componentes precisam
ser criados e se você precisa desenvolver um novo tema do WebSphere Portal.
Criando um Documento de Design
Depois de definir o projeto e criar um documento de análise, você define os requisitos do seu sistema de
conteúdo da Web em um documento de design. O documento de design descreve quais os tipos de
conteúdo necessários em seu site, como eles serão estruturados, como o conteúdo será criado e qual será
a aparência final do Web site.
Arquitetura do Servidor
Arquitetura Ambiental
Cada sistema Web Content Manager consiste em pelo menos um ambiente de autoria e um ambiente de
entrega. O ambiente de autoria é usado para criar e gerenciar itens individuais que compõem o seu Web
site. O sistema de entrega é usado para entregar o conteúdo da Web aos seus visualizadores. Além desses
ambientes, talvez seja necessário também ambientes de teste em que você executa o teste de aceitação do
usuário (UAT).
A equipe da arquitetura técnica documenta a arquitetura ambiental geral necessária para o seu sistema
Web Content Manager, incluindo:
v Quais ambientes de autoria, entrega e UAT são necessários
v Quais servidores ou clusters do WebSphere Portal são necessários em cada ambiente
v Quais servidores de banco de dados são necessários para armazenar os repositórios de dados usados
por cada servidor ou cluster do WebSphere Portal
v Quais relacionamentos da organização são necessários entre cada ambiente
v Quais repositórios do usuário, como o LDAP, são necessários
48
Arquiteturas do Servidor
A equipe da arquitetura técnica documenta também uma arquitetura do servidor para cada servidor
descrito na arquitetura ambiental. Uma arquitetura de servidor descreve a configuração detalhada de
cada servidor, incluindo:
v
v
v
v
v
Qual hardware é necessário para cada servidor
Qual sistema operacional é necessário para cada servidor
Qual software é necessário
As definições de configuração de todos os hardwares, softwares e sistemas operacionais
Outros relacionamentos como repositórios de dados remotos e repositórios do usuário
Arquitetura de Segurança
A arquitetura de segurança descreve quais grupos são necessários em seu site e qual acesso é necessário
para diferentes grupos para o portlet de autoria e o Web site renderizado.
Nota: O exemplo a seguir descreve o tipo de arquitetura de segurança necessário para um ambiente de
autoria. Na maioria dos casos, a arquitetura de segurança para um ambiente de temporariedade ou de
entrega seria muito mais simples se apenas ao grupo Todos os Grupos de Usuários do Portal fosse
designado acesso de usuário à biblioteca. Isso evitaria que os usuários pudessem editar conteúdo e
desativar recursos como ferramentas de autoria de serem exibidas no site publicado.
Neste exemplo, as funções de tipo de item são aplicadas aos seguintes grupos:
Tabela 3. Grupos
Grupo
Detalhes
WCMAdmins
Membros desse grupo requerem acesso a todos os recursos do portlet de autoria.
SiteAdmins
Membros desse grupo requerem acesso a todos os recursos do portlet de autoria, com
exceção do fluxo de trabalho.
SiteDesigners
Membros desse grupo exigem acesso a itens de conteúdo, modelos de apresentação,
modelos de autoria e componentes.
ContentAuthors
Membros desse grupo precisam de acesso de editor aos itens de conteúdo somente.
ContentApprovers
Membros desse grupo exigem acesso de contribuidor a itens de conteúdo apenas.
Acesso à Biblioteca
O método mais simples de configurar o acesso à biblioteca é conceder acesso de contribuidor a todos os
seus grupos. Isso concede a todos os usuários e grupos o acesso de contribuidor à biblioteca e ao portlet
de autoria. Acesso adicional é então concedido a cada grupo que utiliza permissões de recursos. Também
é possível conceder acesso de usuário ao grupo Usuário de Portal Anônimo para garantir que todos os
usuários anônimos possam acessar a biblioteca se o acesso anônimo for necessário para o seu Web site.
Tabela 4. Acesso à Biblioteca
Funções
Permitir Propagação
Permitir Herança
Administrador
Sim
Sim
Gerenciador
Sim
Sim
Editor
Sim
Sim
Usuário
NÃO
Sim
Usuário ou Grupo
Usuário Anônimo do Portal
49
Tabela 4. Acesso à Biblioteca (continuação)
Funções
Permitir Herança
Usuário ou Grupo
Colaborador
Sim
Sim
WCMAdmins
SiteAdmins
SiteDesigners
ContentAuthors
ContentApprovers
Permissões de Recursos
Configure as seguintes permissões de recursos para cada tipo de função:
v A função de administrador é designada ao grupo WCMAdmins para todos os recursos.
v A função de gerenciador é designada ao grupo SiteAdmins para todos os recursos, exceto o fluxo de
trabalho e elementos de fluxo de trabalho, já que eles não exigem acesso a esses recursos.
v Aos outros grupos são designadas funções para cada recurso, de acordo com as tabelas a seguir.
Modelos de Autoria
Ao grupo SiteDesigners é designado o acesso de editor para modelos de autoria, conforme for
necessário para criar novos modelos de autoria.
Tabela 5. Modelos de Autoria
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
SiteAdmins
Editor
Sim
Sim
SiteDesigners
Usuário
Sim
Sim
Colaborador
Sim
Sim
Componentes
Ao grupo SiteDesigners é designado o acesso de editor a componentes, conforme for necessário
para criar componentes.
Tabela 6. Componentes
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
SiteAdmins
Editor
Sim
Sim
SiteDesigners
Usuário
Sim
Sim
Colaborador
Sim
Sim
Conteúdo
Aos grupos SiteDesigners e ContentAuthors é designado o acesso de editor para conteúdo,
conforme for necessário para criar itens de conteúdo.
Ao grupo ContentApprovers é designado o acesso de Contribuidor apenas, pois eles não
precisam criar novos itens de conteúdo, mas precisam de acesso de aprovação para itens de
50
conteúdo durante um fluxo de trabalho. Você deve designar também acesso de aprovação ao
grupo ContentApprovers na seção de propriedades de quaisquer estágios do fluxo de trabalho
que ContentApprovers usará para aprovar itens de conteúdo.
Tabela 7. Conteúdo
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
SiteAdmins
Editor
Sim
Sim
SiteDesigners
ContentAuthors
Usuário
Sim
Sim
Colaborador
Sim
Sim
ContentApprovers
Modelos de Apresentação
Ao grupo SiteDesigners é designado o acesso de editor para modelos de apresentação, conforme
eles são necessários para criar novos modelos de apresentação.
Tabela 8. Modelos de Apresentação
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
SiteAdmins
Editor
Sim
Sim
SiteDesigners
Usuário
Sim
Sim
Colaborador
Sim
Sim
Áreas de Site e Páginas
Apenas os grupos WCMAdmins e SiteAdmins requerem acesso às áreas de site e páginas, já que
eles são os únicos grupos que constroem estruturas de sites.
Tabela 9. Áreas de Site e Páginas
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
SiteAdmins
Editor
Sim
Sim
Usuário
Sim
Sim
Colaborador
Sim
Sim
Taxonomia
Apenas os grupos WCMAdmins e SiteAdmins exigem acesso a taxonomias, já que eles são os
únicos grupos que controem taxonomias.
Tabela 10. Taxonomia
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
SiteAdmins
Editor
Sim
Sim
51
Tabela 10. Taxonomia (continuação)
Funções
Permitir Herança
Usuário
Sim
Sim
Colaborador
Sim
Sim
Usuário ou Grupo
Itens de Fluxo de Trabalho
Apenas o grupo WCMAdmins requer acesso a itens de fluxo de trabalho, já que esse é o único
grupo que cria fluxos de trabalho. Os grupos que usam fluxos de trabalho não requerem acesso
às permissões de recursos de itens de fluxo de trabalho.
Tabela 11. Itens de Fluxo de Trabalho
Funções
Permitir Herança
Usuário ou Grupo
Administrador
Sim
Sim
WCMAdmins
Gerenciador
Sim
Sim
Editor
Sim
Sim
Usuário
Sim
Sim
Colaborador
Sim
Sim
Herança de Segurança no Nível do Item
Por padrão, o acesso de cada função é herdado automaticamente por cada item em uma biblioteca. Para
evitar que um usuário ou grupo herde automaticamente o acesso a um item, você precisa desativar a
herança nesse item.
As permissões definidas para o tipo de item não concedem automaticamente o acesso a itens individuais.
Elas fornecem acesso apenas a tarefas e visualizações específicas dentro do portlet de autoria.
Você também pode designar acesso específico a grupos ou usuários individuais em cada item.
Seu sistema de gerenciamento de conteúdo irá exigir diferentes tipos de usuários. Será necessário criar
um grupo diferente para cada tipo de usuário e, em seguida, designar aos grupos diferentes funções em
seu sistema.
Considerações sobre o Registro do Usuário
Arquitetura de Informações
A arquitetura de informações descreve a estrutura de informações do site e como os usuários navegarão
pelo site.
Mapa do Site
A estrutura do Web site projetada pelo arquiteto de informações determina quais páginas e áreas de site
precisarão ser criadas para fornecer ao seu site uma estrutura hierárquica. O mapa do site descreve a
estrutura do site e determina quais páginas e áreas de site são necessárias em seu site. Exemplo:
v Página Inicial
– Páginas de Notícias
– Página de Produtos
- Área de Site do Produto 1
52
– Página de Downloads
– Página de Suporte
Tipos de Conteúdo
Os tipos de conteúdo identificados pelo arquiteto de informações determinam quais modelos de autoria
são necessários para o seu sistema de autoria. Por exemplo, o seu site pode exigir os seguintes tipos de
conteúdo:
v
v
v
v
v
v
Páginas Iniciais de Seção
Artigos de Notícias
Perfis de Funcionários
Informações do Produto
Galerias de Fotos
Renúncias de Responsabilidade Legal
Perfis e Taxonomias de Conteúdo
O arquiteto de informações é responsável por determinar quais taxonomias são necessárias para permitir
que os usuários determinem o perfil do conteúdo. Essas informações determinam qual conteúdo será
exibido nos componentes de menus.
Este é um exemplo de uma taxonomia para uma empresa de serviços financeiros:
v Taxonomia do MetaBank:
– Financeiro
- Soluções bancárias
- Taxas de Juros
v Pessoal
v Negócios
v Corporativo
– Notícias
53
“Páginas Gerenciadas” na página 151
As páginas gerenciadas simplificam o gerenciamento do site em seu portal, simplificando a criação de
páginas e a inclusão de conteúdo. Como as informações e o conteúdo das páginas são armazenados em
bibliotecas de conteúdo da web, é possível coordenar e publicar com mais facilidade mudanças com a
organização.
“Planejando uma Estrutura de Site” na página 179
Páginas e áreas de site inteligentes são usadas para definir uma estrutura de site hierárquica. Os itens de
conteúdo são salvos dentro da estrutura de site para fornecer sua estrutura de conteúdo e seu contexto.
“Trabalhando com Modelos de Autoria” na página 171
Ao trabalhar com modelos de autoria, defina configurações para o próprio modelo de autoria, bem como
configurações padrão para os itens criados usando o modelo de autoria.
Os modelos de apresentação determinam a estrutura de cada página da web no site e quais elementos e
componentes são exibidos em cada página.
“Estratégias do Traçado de Perfil” na página 187
Você utiliza os recursos de traçado de perfil do IBM Web Content Manager para agrupar itens de
conteúdo em tipos de conteúdo diferentes.
Arquitetura de Design
Temas e Folhas de Estilo
Você lista os temas, as folhas de estilo e os estilos da arquitetura de design. Esses designs podem ser
baseados nos estilos desenvolvidos para o seu Web site do protótipo.
Wireframes de Página
Os wireframes de página podem ser usados para descrever a estrutura básica de cada tipo de página em
seu site e os elementos usados em cada página.
Você lista cada modelo de apresentação necessário para o seu Web site mais seu HTML na arquitetura de
design. O HTML desenvolvido para o Web site do protótipo pode ser usado como a base para o HTML
no documento de design. O design do modelo de apresentação inclui:
v O design do HTML do modelo de apresentação
v Configurações de acesso
v Se um fluxo de trabalho é necessário e, nesse caso, qual deles
Componentes e Elementos
Cada componente e elemento necessário para o seu Web site é listado na arquitetura de design, bem
como informações adicionais como:
v Design HTML para qualquer componente necessário
v Seleções de parâmetros para qualquer parâmetro de componente
v Configurações de acesso
v Se um fluxo de trabalho é necessário e, nesse caso, qual deles
54
Estratégias de Personalização
O designer do Web site determina também qual o conteúdo que precisa ser personalizado para usuários
específicos. Por exemplo, talvez você queira exibir uma página inicial personalizada para cada usuário
individual com base no perfil do usuário. As estratégias de personalização documentadas na arquitetura
de design determinarão quais regras, pontos de conteúdo e campanhas precisam ser criados ao usar o
aplicativo Personalização.
“Componentes” na página 187
Você usa componentes para armazenar elementos que são usados em mais de uma área do seu Web site.
Por exemplo, um logotipo da empresa ou um aviso de copyright.
“Personalização” na página 331
O Portal Personalization fornece customização automática de conteúdo do website para usuários e grupos
de usuários individuais.
Arquitetura da Autoria
A arquitetura da autoria descreve quais tipos de conteúdo serão necessários para o site e quais estratégias
de gerenciamento de mudanças serão aplicadas ao atualizar o conteúdo e o design. Você precisará definir
quais modelos de autoria são necessários em seu sistema, quais fluxos de trabalho serão usados para
gerenciar mudanças e quais pastas serão usadas para agrupar itens no portlet de autoria.
Arquitetura de Biblioteca
A arquitetura de biblioteca descreve onde você armazenará seus itens de conteúdo da Web. Por exemplo,
você poderia dividir o seu site entre os itens que controlam a aparência e o comportamento de seu site,
como modelos e componentes de apresentação, a partir do conteúdo do seu site. Poderia também separar
suas bibliotecas em bibliotecas de equipes diferentes, como "recursos humanos" e "suporte".
Modelos de Autoria
Você precisará de um modelo de autoria separado para cada tipo de item de conteúdo e área de site
usados por seu site. A lista de modelos de autoria definida em sua arquitetura de autoria se baseia nos
tipos de páginas diferentes identificadas no plano do projeto, no documento de análise e no Web site do
protótipo.
As informações especificadas para cada modelo de autoria inclui:
v Que tipo de conteúdo usar. Exemplo:
– Uma área de site para um item pai
– Um item de conteúdo para os filhos do item pai
– Uma área de site para uma subseção de um item pai
v Para o modelo de autoria propriamente dito:
– Nome
– Título de exibição
– Descrição
– Tipo de modelo
– Configurações de acesso
v Configurações de formulário padrão, incluindo:
– Modelo de apresentação padrão, se necessário
55
–
–
–
–
–
Folha de estilo padrão, se necessário
Layout de formulário
Se os editores podem gerenciar elementos
Ações a serem ocultadas
Onde salvar itens
– Texto de ajuda
– Estratégia da versão
v Conteúdo padrão e campos para o item:
– Opções de exibição de campo e nome
– Opções de exibição de campo e título de exibição
– Opções de exibição de campo e descrição
– Elementos necessários
- Design HTML para qualquer conteúdo de elemento padrão
- Seleções de parâmetros padrão para qualquer parâmetro de componente
- Opções de exibição de campo
v Propriedades padrão para cada item:
– Opções de exibição de qualquer campo e perfil padrão
– Opções de exibição de qualquer campo e parâmetros de fluxo de trabalho padrão
– Opções de exibição de qualquer campo e configurações de acesso padrão
– Opções de exibição de campo para a seção Histórico
Fluxos de Trabalho
Você usa fluxos de trabalho para controlar o acesso, a verificação e a aprovação eventual de itens. Apenas
se um item for aprovado em todos os estágios até um estágio publicado, ele poderá ser visualizado em
seu Web site. Você pode utilizar um fluxo de trabalho para:
v Revisar a exatidão do conteúdo
v Revisar o conteúdo em relação a quaisquer implicações legais
v Revisar o conteúdo para garantir que ele atenda às diretrizes de acessibilidade
v Assegurar que nenhum código doloso, como ataques de scripts cruzados, tenha sido incluído no
conteúdo
Cada fluxo de trabalho, estágio do fluxo de trabalho e ação do fluxo de trabalho necessário em seu
sistema de conteúdo da Web é listado na arquitetura de autoria.
Pastas
As pastas são usadas para agrupar conjuntos de tipos de item em agrupamentos lógicos. Isso é útil
quando você tem vários itens em sua biblioteca e deseja distinguir entre diferentes grupos de itens dentro
de cada visualização de tipo de item. Cada pasta necessária para o seu sistema de conteúdo da Web é
listada na arquitetura de autoria.
Por exemplo, você poderia usar um conjunto de pastas para conjuntos de grupos diferentes de
componentes da imagem:
v Logotipos
v Diagramas
v Fotos da equipe
v Fotos do produto
56
Estratégias de Gerenciamento da Versão
É possível configurar seu sistema para salvar automaticamente uma versão de um item sempre que ele
for publicado, ou permitir que os usuários selecionem quando salvar uma versão de um item. A
estratégia de gerenciamento de versão para diferentes tipos de itens é documentada na arquitetura de
autoria.
“Bibliotecas de Conteúdo da Web” na página 127
Seu sistema de conteúdo da Web pode conter múltiplas bibliotecas. O número de bibliotecas necessárias é
determinado pelo tipo de Web site que você está criando e os tipos de usuários que exigem acesso a cada
biblioteca.
seu sistema.
“Trabalhando com Pastas” na página 328
Você usa pastas para agrupar conjuntos de tipos de itens em agrupamentos lógicos.
“Gerenciamento de Fluxo de Trabalho e Mudanças” na página 137
É possível gerenciar mudanças nos itens de conteúdo da Web criando rascunhos, usando fluxos de
trabalho ou incluindo itens nos projetos.
“Gerenciando Versões de Itens” na página 328
for publicado, ou permitir que os usuários selecionem quando salvar uma versão de um item. É possível
restaurar itens individualmente ou optar por restaurar um conjunto de itens dentro de uma biblioteca que
tenha o mesmo rótulo ou com versão na data e hora especificadas, ou antes delas. A versão é controlada
por meio dos serviços de configuração do Web Content Manager no WebSphere Integrated Solutions
Console e é ativada por padrão.
Arquitetura de Aquisição de Conteúdo
A arquitetura de aquisição de conteúdo é usada para definir qual conteúdo existente será importado no
sistema de conteúdo da Web, como ele será importado e qual conteúdo precisará ser criado.
A arquitetura de aquisição de conteúdo é baseada no inventário de conteúdo coletado durante a fase de
análise do projeto. Para cada parte do conteúdo identificado no inventário de conteúdo, você define as
seguintes informações:
v Se esse conteúdo será importado no sistema de conteúdo da Web ou se será criado um novo conteúdo.
v Se o conteúdo será importado e qual ferramenta será usada. Por exemplo, WebDav ou o Web Content
Integrator.
Além disso, o tipo de item que está sendo criado precisa ser identificado. Exemplo:
v Partes reutilizáveis do conteúdo são melhores criadas como componentes
v Conteúdo específico de página da Web é melhor criado como um item de conteúdo
v Conteúdo específico para uma determinada seção de um Web site é melhor salvo dentro de uma área
de site
57
“A API do IBM Web Content Manager” na página 599
Você pode utilizar a API do Web Content Manager para estender funções do Web Content Manager.
Tarefas relacionadas
“WebDAV” na página 310
Com o WebDAV para IBM WebSphere Portal, é possível usar ferramentas do sistema operacional padrão
para criar, modificar e excluir o conteúdo da Web em vez do portlet de autoria padrão.
Arquitetura de Entrega
Os arquitetos técnicos e de informações precisam definir quais os métodos de entrega mais apropriados
para o Web site que você está entregando.
A arquitetura de entrega descreve quais os métodos de entrega necessários para o seu sistema de
conteúdo da Web.
Entrega Pré-renderizada
É possível pré-renderizar um Web site completo em HTML e salvá-lo no disco. O site pré-renderizado
pode ser usado como site ativo e exibido para usuários usando o Web Content Manager ou um servidor
da Web. Você implementa um site pré-renderizado quando não está usando nenhum recurso do
WebSphere Portal, como portlets, e seu conteúdo for estático e atualizado apenas periodicamente.
Entrega do Servlet
Os usuários podem acessar o conteúdo exibido através do servlet do Web Content Manager. Um Web site
entregue por servlet deve ser usado quando você não precisar usar nenhum dos recursos baseados no
WebSphere Portal, tais como ferramentas de autoria.
Entrega do Visualizador de Conteúdo da Web Local
Os visualizadores de conteúdo da Web são portlets que exibem conteúdo de uma biblioteca de conteúdo
da Web como parte de uma página de portal. Se sua apresentação for simples, um único visualizador de
conteúdo da Web poderá ser suficiente, mas também é possível usar múltiplos visualizadores de
conteúdo da Web para agregar conteúdo de diferentes bibliotecas e fornecer uma experiência mais rica
para seus usuários. Um portlet de visualização de conteúdo da Web local é usado para exibir conteúdo
dentro do ambiente de entrega de conteúdo da Web.
Entrega do Visualizador de Conteúdo da Web Remoto
Um portlet de visualização de conteúdo da Web remoto é usado para exibir conteúdo em um servidor ou
cluster remoto do WebSphere Portal.
58
Arquitetura de Manutenção
Existe um conjunto de tarefas que você precisa planejar que manterá a saúde e a integridade do seu
sistema de conteúdo da Web. Os arquitetos técnico e de banco de dados precisarão definir quais
procedimentos de manutenção são necessários em seu sistema e quando e com que frequência eles
precisam ser executados.
Estratégias de Backup e Restauração
Você deve documentar estratégias de backup e de restauração para todos os softwares e repositórios em
seu sistema de conteúdo da Web. Essa abordagem inclui procedimentos de documentação para backup e
restauração:
v Repositórios de Dados
v Temas
v
v
v
v
Portlets
Estruturas de Páginas
Definições de Configuração
Aplicativo Customizado
Aplicando Atualizações
O processo e a sincronização de atualizações de software são definidos na arquitetura de manutenção.
Isso não se aplica apenas ao Web Content Manager e ao WebSphere Portal, mas a todos os produtos de
software em seu sistema de conteúdo da Web.
Por exemplo, você deveria documentar procedimentos para instalar correções acumulativas para o Web
Content Manager regularmente.
Executando Ferramentas de Manutenção
Você documenta o processo e a sincronização de execução de cada ferramenta de manutenção. Essa
documentação não se aplica apenas ao Web Content Manager e ao WebSphere Portal, mas a todos os
produtos de software em seu sistema de conteúdo da Web.
Por exemplo, você deveria documentar quando e com que frequência executar ferramentas de
manutenção, como a tarefa de corretor, e quando eliminar históricos do item e da versão para manter o
desempenho do servidor.
59
“Mantendo o Conteúdo da Web” na página 569
Use estas ferramentas e recursos para assegurar a operação eficiente de seu
sistema Web Content Manager system.
Roteiro para Construir um Sistema de Conteúdo da Web
Implementando o Ambiente de Autoria
O primeiro ambiente a ser implementado é o seu ambiente de autoria. Esse ambiente pode ser
inicialmente usado por uma pequena equipe como um ambiente de desenvolvimento, mas pode
eventualmente ser usado como o ambiente de autoria de todos os seus usuários. O ambiente de autoria é
implementado com base na arquitetura técnica definida nos documentos de design do projeto.
1. Com base na arquitetura de banco de dados definida no documento de design do projeto, o
administrador de banco de dados implementa um servidor de banco de dados no ambiente de
autoria.
2. Com base na arquitetura de segurança definida no documento de design do projeto, o administrador
do LDAP:
a. Cria um novo servidor LDAP se um já não existir.
b. Cria todos os grupos e usuários necessários para o sistema de conteúdo da Web.
3. Com base na arquitetura do servidor definida no documento de design do projeto, o administrador
do WebSphere Portal faz o seguinte:
a. Instala um servidor ou cluster de servidores do WebSphere Portal.
b. Configura o servidor ou cluster do WebSphere Portal para usar o servidor de banco de dados
configurado pelo administrador de banco de dados.
c. Configura o WebSphere Portal para usar o servidor LDAP como seu repositório do usuário.
d. Configura várias propriedades de configuração do WebSphere Application Server, do WebSphere
Portal e do Web Content Manager para garantir que o sistema seja configurado corretamente para
autoria de conteúdo da Web e seja ajustado para desempenho ótimo.
v Instalando
v Configurando
4. Com base na arquitetura de informações e na arquitetura de segurança definidas no documento de
design do projeto, o administrador do WebSphere Portal:
a. Cria todas as bibliotecas necessárias para o sistema de conteúdo da Web.
60
b. Designa usuários e grupos para as funções e permissões de acesso.
c. Cria todas as páginas necessárias pelo sistema de conteúdo da Web.
d. Inclui todos os portlets de autoria necessários para as páginas apropriadas e configura os portlets
de autoria para uso por equipes diferentes para criar e gerenciar itens de conteúdo da Web.
e. Inclui todos os portlets do visualizador de conteúdo da Web necessários para as páginas
necessárias para uso como páginas de visualização.
v “Usuários, Grupos e Funções” na página 245
v Trabalhando com Páginas Gerenciadas
v “Configurações do Portlet de Autoria” na página 257
5. O teste e o ajuste finais do ambiente de autoria são realizados por todos os administradores.
O ambiente de autoria está agora pronto para uso.
Construindo o Sistema de Autoria de Conteúdo
Para poder iniciar a inclusão de conteúdo em seu sistema de conteúdo da Web, é necessário criar todos
os itens que serão usados para gerenciar e entregar seu conteúdo da Web.
1. Com base na arquitetura de design definida no documento de design do projeto, o desenvolvedor de
conteúdo da Web cria plug-ins e código JSP em preparação para a criação do sistema de autoria de
conteúdo.
v “O Desenvolvedor de Conteúdo da Web” na página 41
v “Desenvolvimento” na página 599
2. Com base na arquitetura de informações definida no documento de design do projeto, o criador do
Web site faz o seguinte:
a. Cria áreas de site.
b. Cria taxonomias e categorias.
v “O Criador de Web Site” na página 41
v “Arquitetura de Informações” na página 52
v “Estratégias do Traçado de Perfil” na página 187
3. Com base na arquitetura de autoria de conteúdo definida no documento de design do projeto, o
criador do Web site faz o seguinte:
a. Cria ações de fluxo de trabalho, estágios e define fluxos de trabalho.
b. Cria modelos de autoria.
v “Arquitetura da Autoria” na página 55
4. Com base na arquitetura de design definida no documento de design do projeto, o criador do Web
site faz o seguinte:
a. Cria componentes.
b. Cria modelos de apresentação.
v Criando Componentes
5. Com base na arquitetura de informações definida no documento de design do projeto, o criador do
Web site edita áreas de site e define mapas de modelo.
61
v “Mapas de Modelo” na página 185
6. Se necessário, o desenvolvedor de conteúdo da Web cria também uma interface de autoria de
conteúdo customizada, com base na arquitetura de autoria de conteúdo definida no documento de
design do projeto.
v “O Desenvolvedor de Conteúdo da Web” na página 41
7. O criador do Web site cria então algum conteúdo de teste para testar o sistema de autoria de
conteúdo e visualiza o conteúdo de teste. Quaisquer defeitos encontrados no sistema de autoria de
conteúdo são especificados e as alterações necessárias são feitas para aprimorar o desempenho e a
usabilidade.
Importando e Criando Conteúdo
Quando o sistema de autoria estiver pronto, você importará e criará o conteúdo padrão do sistema. Isso é
geralmente gerenciado por uma equipe separada da equipe que constrói o sistema de autoria de
conteúdo da Web.
1. Com base nos dados reunidos durante a fase de análise do projeto, a equipe de aquisição de conteúdo
identifica e prepara qualquer conteúdo existente para importação no sistema de autoria de conteúdo
da Web.
v “A Equipe de Aquisição de Conteúdo” na página 43
v “Arquitetura de Aquisição de Conteúdo” na página 57
2. A equipe de aquisição de conteúdo importa então o conteúdo existente no sistema de autoria de
conteúdo da Web usando recursos, como o Web Content Integrator, o WebDav ou a API de conteúdo
da Web.
3. A equipe de aquisição de conteúdo cria então um novo conteúdo com base na arquitetura de
informações definida no documento de design do projeto.
4. A equipe de aquisição de conteúdo testa então o sistema de autoria e visualiza o conteúdo padrão.
Quaisquer defeitos encontrados no sistema de autoria são especificados e as alterações necessárias são
feitas para aprimorar o desempenho e a usabilidade.
Implementando o Ambiente de Entrega
O ambiente de entrega é usado para entregar o Web site aos visualizadores de seus Web sites. O
ambiente de entrega é implementado com base nos requisitos definidos no documento de design do
projeto.
1. Com base na arquitetura de banco de dados definida no documento de design do projeto, o
administrador de banco de dados faz o seguinte:
a. Implementa um servidor de banco de dados para o ambiente de entrega.
b. Clona os dados armazenados no banco de dados de autoria para o banco de dados de entrega.
v “Clonando um Repositório de Conteúdo da Web” na página 596
2. Com base na arquitetura do servidor definida no documento de design do projeto, o administrador
do WebSphere Portal faz o seguinte:
a. Instala um servidor ou cluster de servidores do WebSphere Portal.
62
b. Configura o servidor ou cluster do WebSphere Portal para usar o servidor de banco de dados
configurado pelo administrador de banco de dados.
c. Configura várias propriedades de configuração do WebSphere Application Server, do WebSphere
Portal e do Web Content Manager para garantir que o sistema seja configurado corretamente para
a entrega do conteúdo da Web e seja ajustado para desempenho ótimo.
v Instalando
v Configurando
3. Com base na arquitetura de informações e na arquitetura de segurança definidas no documento de
design do projeto, o administrador do WebSphere Portal:
a. Cria todas as páginas necessárias pelo sistema de conteúdo da Web.
b. Inclui todos os portlets do visualizador de conteúdo da Web necessários para as páginas
apropriadas.
v Trabalhando com Páginas Gerenciadas
4. O administrador do WebSphere Portal configura e ativa a organização.
v “Administrando Organização” na página 711
5. O teste e o ajuste finais do ambiente de entrega são realizados por todos os administradores.
O ambiente de entrega agora está pronto para uso.
Etapas Finais
Depois que os seus ambientes estiverem instalados, o sistema de autoria estiver concluído, o conteúdo
padrão incluído em seu site e o sistema totalmente testado, você estará pronto para começar.
1. Assegure-se de que as pessoas interessadas estejam prontas para usar o seu Web site e o sistema de
autoria:
a. Assegure-se de que os autores de conteúdo tenham feito treinamento sobre como usar o novo
sistema de autoria de conteúdo da Web.
b. Assegure-se de que todos os sistemas de entrega ou autoria de legado sejam redirecionados ao
novo sistema.
c. Ative as campanhas de marketing para trazer visitantes ao novo Web site.
2. Com base na arquitetura de manutenção definida no documento de design do projeto, você executa
tarefas de monitoramento e manutenção regulares para garantir que o seu sistema esteja saudável e
funcionando de maneira eficiente.
v “Arquitetura de Manutenção” na página 59
63
64
Instalando e migrando
O IBM Web Content Manager é instalado usando a interface de instalação do
WebSphere Portal. Instruções completas de instalação estão incluídas na documentação do produto
WebSphere Portal. Siga as instruções de instalação do WebSphere Portal, em seguida, configure os
ambientes de autoria e entrega com base em suas necessidades e instruções fornecidas nesta
documentação. Instruções de migração também estão incluídas na documentação do produto WebSphere
Portal; o Web Content Manager é migrado como parte do processo de migração geral do WebSphere
Portal.
65
66
Configure um servidor de conteúdo instalando o IBM Web Content Manager
em diversas implementações para fornecer ambientes robustos e flexíveis para desenvolvimento e entrega
de conteúdo da web. Depois de instalar o servidor de conteúdo, há etapas de configuração adicionais que
devem ser concluídas, de acordo com a função do servidor em seu ambiente de conteúdo da Web.
A configuração do Web Content Manager é gerenciada por meio de serviços definidos como provedores
de ambientes de recursos no IBM WebSphere Application Server. Para cada serviço, você pode editar as
propriedades existentes e incluir novas propriedades usando o WebSphere Integrated Solutions Console.
Definindo as Propriedades de Configuração do Serviço
Configurando um Ambiente de Autoria de Conteúdo da Web
Configure o ambiente de autoria instalando o portlet de autoria e ativando outros recursos necessários
para suportar o ambiente de autoria.
Instalando o Portlet de Autoria
As páginas que incluem o portlet de autoria do Web Content Manager e o portlet de renderização local
são criadas quando o WebSphere Portal for instalado pela primeira vez. Execute a tarefa de configuração
do portlet de autoria apenas se você desinstalou anteriormente seus portlets de autoria ou de
renderização local. A tarefa de configuração do portlet de autoria criará automaticamente as páginas do
Web Content Manager e instalará o portlet de autoria e os portlets de renderização local.
Instalando no AIX,, IBM i, Linux, Solaris e Windows
1. Abra um prompt de comandos.
2. Execute a tarefa configure-wcm-authoring a partir do diretório wp_profile_root/ConfigEngine.
AIX, Linux Solaris
./ConfigEngine.sh configure-wcm-authoring -DPortalAdminPwd=password
-DWasUserid=username -DWasPassword=password
IBM i ConfigEngine.sh configure-wcm-authoring -DPortalAdminPwd=password
Janelas
ConfigEngine.bat configure-wcm-authoring -DPortalAdminPwd=password
3. Efetue logout do portal e login novamente.
4. Selecione Conteúdo da Web no banner do produto para acessar o portlet de autoria.
Nota sobre o Cluster: Se o portlet de autoria não for exibido após a instalação de um cluster, talvez seja
necessário ativar o portlet.
67
Instalando no z/OS
1. Inicie o Diálogo de Customização.
2. Navegue para o painel Configurar Web Content Manager: Configurar WebSphere Portal >
WebSphere Portal para z/OS > Tarefas de Configuração do Aplicativo > Configurar Gerenciamento
de Conteúdo da Web.
3. Selecione Implementar Portlets de Autoria.
4. Selecione Definir Variáveis.
5. Selecione a opção referente às variáveis que você deseja definir e acompanhe os painéis para definir
as variáveis.
6. Gere as tarefas de customização.
7. Siga as instruções no Diálogo de Customização para submeter as tarefas de customização.
Nota sobre o Cluster: Se o portlet de autoria não for exibido após a instalação de um cluster, talvez seja
necessário ativar o portlet.
Consistência de Código do Idioma
O idioma exibido no portlet de autoria é determinado pela região ou pelo código do idioma do usuário.
Entretanto, há alguns elementos do portlet de autoria que utilizam as funções do WebSphere Portal, como
campos de seleção de dados. Eles serão exibidos utilizando o código do idioma do servidor WebSphere
Portal. Por essa razão, o idioma e os códigos de idioma do site que está sendo criado, o cliente e o
servidor devem estar consistentes.
Se o seu site tiver conteúdo em diferentes idiomas, aplicativos de autoria do Web Content Manager
separados deverão ser configurados para cada idioma nos diversos WebSphere Portal Servers. Eles
podem ser combinados em um site utilizando um servidor de migração de dados.
Nota: Se um usuário alterar seu código do idioma, qualquer diálogo do Web Content Manager aberto no
momento será fechado. Um usuário também terá de iniciar uma nova sessão antes da exibição utilizando
o novo código de idioma. É recomendável configurar o código do idioma correto do cliente antes de
utilizar o Web Content Manager.
Gerenciando Portlets em seu Cluster
Opções Adicionais de Configuração do Portlet de Autoria
É possível especificar opções adicionais de configuração do portlet de autoria utilizando a visualização de
administração do portlet.
Para incluir parâmetros adicionais de configuração do portlet de autoria:
v Abra a visualização de administração do portal.
v Vá para Administração>Gerenciamento de Portlet>Portlets.
v Procure pelo portlet de Autoria de Conteúdo da Web.
v Abra a visualização de configuração.
Você pode incluir qualquer um dos seguintes parâmetros de configuração opcionais:
68
Tabela 12. Parâmetros de Configuração do Portlet de Autoria Adicionais
Parâmetro
Detalhes
htmlfield.rows
Digite o número de linhas a serem exibidas em um
campo HTML utilizado em um design de elemento ou
em um gabarito de apresentação. Se não for especificado,
será utilizada a configuração padrão de 15 linhas.
htmlfield.columns
Define a largura de um campo HTML utilizado em um
design de elemento ou em um gabarito de apresentação.
A largura é definida como o número de caracteres a
serem exibidos por linha. Se não for especificada, será
utilizada a configuração padrão de 85 caracteres.
htmlfield.embedded.rows
Define o número de linhas a serem exibidas em um
campo HTML utilizado em um design de elemento ou
em um gabarito de apresentação, mas não em um
componente HTML. Se não for especificado, o número
de linhas definido utilizando htmlfield.rows será utilizado.
htmlfield.embedded.columns
Define a largura de um campo HTML utilizado em um
design de elemento ou em um gabarito de apresentação,
mas não em um componente HTML. A largura é
definida como o número de caracteres a serem exibidos
por linha. Se não for especificado, o número de
caracteres definido utilizando htmlfield.columns será
utilizado.
htmlfield.htmlcomponent.rows
Define o número de linhas a serem exibidas no campo
HTML utilizado em um componente HTML. Se não for
especificado, o número de linhas definido utilizando
htmlfield.rows será utilizado.
htmlfield.htmlcomponent.columns
Define a largura do campo HTML utilizada em um
componente HTML. A largura é definida como o número
de caracteres a serem exibidos por linha. Se não for
especificado, o número de caracteres definido utilizando
htmlfield.columns será utilizado.
htmlfield.presentation.rows
Define o número de linhas a serem exibidas no campo
HTML utilizado em um gabarito de apresentação. Se não
for especificado, o número de linhas definido utilizando
htmlfield.rows será utilizado.
htmlfield.presentation.columns
Define a largura do campo HTML utilizada em um
gabarito de apresentação. A largura é definida como o
número de caracteres a serem exibidos por linha. Se não
for especificado, o número de caracteres definido
utilizando htmlfield.columns será utilizado.
EDIT_LIVE_CUSTOM_LICENCE
Use isso para inserir uma chave de licença customizada a
ser usada no lugar da licença OEM para Ephox EditLive
usando este formato:ID da
Conta,Domínio,Expiração,Chave de
Licença,Licenciado,Produto,Liberação
Nota: Todos os usuários precisarão efetuar logoff e login antes de quaisquer alterações de configuração
aparecerem no portlet de autoria.
Opções de Autoria do Conteúdo da Web
É possível padronizar o comportamento de autoria do ambiente de conteúdo da Web alterando as
definições de configuração, como um fluxo de trabalho, uma determinação de perfil e um controle de
versão.
69
Você define e gerencia opções de autoria no serviço WCM WCMConfigService usando o WebSphere
Integrated Solutions Console.
Ativando Fluxos de Trabalho
Como padrão, o aplicativo IBM Web Content Manager aplicará o fluxo de trabalho apenas aos itens de
conteúdo. É possível atualizar o serviço WCM WCMConfigService para ativar fluxos de trabalho para itens
diferentes.
Para ativar fluxos de trabalho, crie uma nova propriedade para o tipo de item ao qual você deseja aplicar
o fluxo de trabalho e especifique um valor de com.aptrix.pluto.workflow.WorkflowControl para a
propriedade. É possível ativar o fluxo de trabalho para os seguintes tipos de item:
v Itens de conteúdo (control.Content)
v Modelos de apresentação (control.Style)
v
v
v
v
v
Modelos de autoria (control.Template)
Itens de taxonomia (control.Taxonomy)
Categorias (control.Category)
Itens de área de site (control.SiteArea)
Componentes da biblioteca (control.Cmpnt)
Por exemplo, para ativar o fluxo de trabalho para modelos de autoria, você deve incluir a seguinte
propriedade:
v Nome da propriedade: control.Template
v Valor: com.aptrix.pluto.workflow.WorkflowControl
Para desativar o fluxo de trabalho para um tipo de item, defina a propriedade como "false". Por exemplo,
para desativar o fluxo de trabalho para modelos de autoria, você deve fazer o seguinte:
v Nome da propriedade: control.Template
v Valor: false
Nota: Se os fluxos de trabalho estiverem ativados para os seguintes itens, uma visualização de fluxo de
trabalho não estará disponível no navegador de visualizações de item.
v Áreas de site.
v Taxonomias e Categorias.
v Fluxos de trabalho, estágios de fluxos de trabalho ou ações de fluxos de trabalho.
Itens individuais podem ainda ser movidos através de estágios do fluxo de trabalho acessando-os por
meio das visualizações de item normais e aprovando-os.
Nota: Apenas os itens de conteúdo podem ser movidos por meio de um fluxo de trabalho usando a API
de conteúdo da Web. Se você ativar fluxos de trabalho para outros tipos de item, não poderá aprovar ou
rejeitar esses itens utilizando a API.
Ativando o Gerenciamento de Perfis
Como padrão, o aplicativo Web Content Manager incluirá no fluxo de trabalho apenas os itens de
conteúdo. É possível atualizar o serviço WCM WCMConfigService para ativar a determinação de perfil para
itens diferentes.
Para ativar a determinação de perfil, crie uma nova propriedade para o tipo de item ao qual você deseja
aplicar a determinação de perfil e especifique um valor de com.aptrix.pluto.taxonomy.ProfileControl
para a propriedade. É possível ativar o fluxo de trabalho para os seguintes tipos de item:
70
v
v
v
v
v
Itens de conteúdo (control.Content)
Modelos de apresentação (control.Style)
Modelos de autoria (control.Template)
Itens de taxonomia (control.Taxonomy)
Categorias (control.Category)
v Itens de área de site (control.SiteArea)
v Componentes da biblioteca (control.Cmpnt)
Por exemplo, para ativar a determinação de perfil para componentes, você deve incluir a seguinte
propriedade:
v Nome da propriedade: control.Cmpnt
v Valor: com.aptrix.pluto.taxonomy.ProfileControl
Para desativar a determinação de perfil para um tipo de item, defina a propriedade como "false". Por
exemplo, para desativar a determinação de perfil em componentes, você deve fazer o seguinte:
v Nome da propriedade: control.Cmpnt
v Valor: false
Opções de Controle de Versão
Por padrão, o controle de versão é ativado com as seguintes propriedades:
v versioningStrategy.AuthoringTemplate
v
v
v
v
v
versioningStrategy.Component
versioningStrategy.Content
versioningStrategy.PresentationTemplate
versioningStrategy.Taxonomy
versioningStrategy.Workflow
v versioningStrategy.Default
É possível usar os seguintes valores para especificar as configurações de controle de versão:
sempre
Uma versão é salva sempre que um item sem fluxo de trabalho for salvo, ou sempre que um item
de fluxo de trabalho for publicado.
manual
As versões só serão salvas quando um usuário com, no mínimo, acesso de editor optar por salvar
uma versão. Essa configuração causa as seguintes alterações na interface:
v O botão Salvar Versão está disponível no modo de leitura de itens sem fluxo de trabalho e em
itens de fluxo de trabalho no estado publicado.
v O botão Salvar e Versão está disponível no modo de edição de itens sem fluxo de trabalho e
em itens de fluxo de trabalho no estado publicado.
Nunca expirar
Desative o controle de versão de um tipo de item.
Se uma estratégia de controle de versão não estiver definida para um tipo de item, então será usada a
estratégia de controle de versão especificada pela propriedade versioningStrategy.Default.
Opções de Herança
Por padrão, a herança é propagada automaticamente para cada item, em forma decrescente. É possível
desativar a herança automática especificando a seguinte propriedade:
71
v Nome da propriedade: default.inherit.permissions.enabled
v Valor: false
Quando essa configuração estiver especificada, ela será aplicada apenas a novos itens. A herança sobre os
itens existentes permanecerá inalterada.
Opções de Bloqueio de Item Hierárquico
Quando um item de conteúdo está sendo editado, ele está bloqueado. Outros usuários estão impedidos
de editar o item de conteúdo até que ele seja destravado. O bloqueio de áreas de site, taxonomias e
categorias é configurável e não está ativado por padrão. Para ativar o bloqueio de tipos de itens
hierárquicos, especifique as seguintes propriedades: altere os seguintes parâmetros para "true":
Nome da propriedade
Valor
wcm.authoringui.lock.taxonomies
true
wcm.authoringui.lock.categories
true
wcm.authoringui.lock.siteareas
true
wcm.authoringui.lock.projects
true
Quando o bloqueio estiver ativado para áreas de site, não será possível criar nenhum filho na área de site
bloqueada. Por exemplo, se uma área de site estiver bloqueada, não será possível criar nenhuma nova
área de site ou item de conteúdo nessa área de site até que ela seja desbloqueada. Isso se aplica apenas
aos filhos diretos do pai bloqueado. Os itens que são descendentes dos filhos de um pai bloqueado não
são afetados.
Definindo Tipos MIME Válidos para o Elemento de Imagem
Você define os tipos mime de arquivos que têm permissão para serem transferidos por upload no
elemento de imagem usando a propriedade imageresourcecmpnt.allowedmimetypes e uma lista de tipos
mime para o valor. Por exemplo:
v Nome da propriedade: imageresourcecmpnt.allowedmimetypes
v Valor: image/gif,image/jpeg
Isso evitará que os usuários façam upload de arquivos que não sejam de imagem no elemento de
imagem.
Filtragem de Conteúdo Ativo
A filtragem de conteúdo ativo fornece a capacidade de separar fragmentos HTML especificados do
HTML inserido nos elementos. Isso inclui elementos Rich Text e HTML. A filtragem de conteúdo ativa é
configurada usando a propriedade active.content.filtering.enable. Por padrão, a filtragem de
conteúdo ativa está ativada. Se ativada, ela evitará que um usuário introduza código malicioso em um
website, como scripts de site cruzado.
Por exemplo, se um usuário tivesse digitado esse código em um elemento HTML:
Boas-vindas
<a href="javascript:window.alert("boo!")">my link</a>
<script language="javascript">window.alert("boo 2!")</script>
Clique no link para ter uma surpresa.
Ele seria alterado para este quando salvo:
Boas-vindas
<a href="<"- active content removed -->">my link</a>
<"- active content removed -->
Clique no link para ter uma surpresa.
72
Configurando a Posição de Filho Padrão
É possível configurar o parâmetro wcm.authoringui.childPlacementDefault para especificar a posição
padrão de novos itens de conteúdo.
Valor da propriedade
Descrição
start
Essa configuração, por padrão, colocará um novo item de
conteúdo como primeiro item em uma área de site.
end
Essa configuração, por padrão, colocará um novo item de
conteúdo como último item em uma área de site.
v Se esse parâmetro não for configurado, a posição de filho padrão será "end".
v A posição padrão especificada em um modelo de autoria substituirá essa configuração para itens de
conteúdo criados com esse modelo de autoria.
Configurando o tamanho da lista suspensa da biblioteca de trilha de navegação
É possível configurar o parâmetro wcm.authoringui.breadcrumbLibrariesMaximum para especificar o
número de bibliotecas que devem ser mostradas na trilha de navegação da interface de autoria. Por
exemplo, wcm.authoringui.breadcrumbLibrariesMaximum=16
v Se esse parâmetro não for configurado, somente as 10 primeiras bibliotecas serão exibidas.
v O valor desse parâmetro deve ser um número inteiro entre 5 e 50.
v É recomendável que seu valor deve ficar entre 10 e 20.
v Se um número de bibliotecas maior que esse existir, as bibliotecas restantes poderão ser acessadas
usando a opção Selecionar de todas as bibliotecas.
Itens Expirados
Por padrão, os itens expirados são exibidos ao lado dos itens publicados e de rascunho.
Para determinar se os itens expirados são listados em visualizações, é possível especificar a propriedade
wcm.authoringui.showexpireditems no serviço WCM WCMConfigService usando o WebSphere Integrated
Solutions Console:
v Se definido como true, os itens expirados serão exibidos ao lado dos itens publicados e de rascunho.
v Se definido como false, apenas os itens publicados e de rascunho serão exibidos.
v Se não especificado, essa definição terá o valor-padrão de true.
Configurando a Procura de Portlet de Autoria
É possível alterar a configuração do portlet de autoria para alterar a forma como a procura funciona.
Você define e gerencia opções de procura do portlet de autoria no serviço WCM WCMConfigService usando
o WebSphere Integrated Solutions Console.
É possível especificar as seguintes propriedades:
wcm.authoringui.advancedsearch.searchonselection
v Os valores possíveis são true ou false.
73
v Se definir como true, quando você clicar em Procura Avançada, uma procura avançada será
executada automaticamente com base em qualquer texto inserido atualmente na procura básica.
Se nada tiver sido digitado na procura básica, a procura avançada não será executada
automaticamente.
v Se definido como false, a procura avançada não será executada automaticamente se houver
um texto existente no campo de procura básica.
v Se a propriedade não estiver especificada, essa definição será padronizada com o
comportamento false.
wcm.authoringui.simplesearch.addstar
v Se definido como true, um caractere curinga será incluído no final do texto inserido na procura
básica. Por exemplo, a procura por Span procurará automaticamente por Span* e exibirá os
resultados da procura que tenham título, descrição ou palavras-chave começadas com a palavra
Span, como Spanish.
v Se definido como false, apenas correspondências exatas ao texto inserido no campo de procura
básica serão procuradas.
wcm.authoringui.advancedsearch.addstar
v Se definido como true, um caractere curinga será incluído no final do texto inserido na procura
avançada. Por exemplo, a procura por Span procurará automaticamente por Span* e exibirá os
resultados da procura que tenham título, descrição ou palavras-chave começadas com a palavra
Span, como Spanish.
v Se definido como false, apenas correspondências exatas ao texto inserido no campo de procura
avançada serão procuradas.
Importando Arquivos Grandes e Imagens
Como a importação de arquivos grandes no IBM Web Content Manager pode ter um impacto negativo no
desempenho, é possível ajustar várias configurações para assegurar o melhor desempenho ao importar
arquivos.
Antes de atualizar as configurações para manipulação de arquivo grande, revise as seguintes
considerações:
Nota UNIX: Se você estiver executando em um sistema operacional UNIX, assegure que você tenha
usado o comando ulimit -f para configurar o tamanho máximo de arquivos que podem ser criados para
terem pelo menos o tamanho do maior arquivo que você precisaria para fazer upload no servidor de
conteúdo. O comando ulimit -f unlimited remove qualquer limite no tamanho do arquivo. Ao
configurar o tamanho, também certifique-se de que o sistema tenha espaço em disco suficiente para
suportar a configuração.
Requisitos de Espaço em Disco: Ao importar arquivos, um diretório temporário é usado para armazenar
os arquivos durante o processo de upload. Se o tamanho dos arquivos transferidos por upload exceder o
espaço em disco disponível para o diretório temporário, a operação de importação falhará. Ao fazer
upload de arquivos grandes, assegure que haja espaço em disco suficiente para acomodar a importação.
74
O local do diretório temporário é especificado pela propriedade jcr.binaryValueFileDir no arquivo
wp_profile_root/PortalServer/jcr/lib/com/ibm/icm/icm.properties.
1. Efetue login no WebSphere Integrated Solutions Console.
2. Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos > WCM
WCMConfigService > Propriedades Customizadas.
Nota sobre o Cluster: Se você estiver usando esse servidor de conteúdo da web como parte de um
cluster, assegure-se de usar o WebSphere Integrated Solutions Console para o gerenciador de
implementação ao manipular propriedades de configuração.
3. Para a propriedade resource.maxUploadSize, especifique um valor em megabytes correspondente ao
tamanho do maior arquivo cuja importação você deseja permitir. Por exemplo, se não desejar
permitir que arquivos maiores que 34 MB sejam importados, atualize a propriedade
resource.maxUploadSize para ter um valor igual a 34. Embora seja recomendável que esse valor não
exceda 100 MB, não é possível fazer upload de arquivos maiores que 512 MB.
4. Para a propriedade resourceserver.maxCacheObjectSize, especifique um valor de 300 KB ou menos.
5. Inclua a propriedade transaction.sync.remove e especifique um valor de true.
6. Clique em Servidores > Tipos de Servidor > WebSphere Application Servers > portal_server >
Infraestrutura do Servidor > Administração > Propriedades Customizadas
7. Inclua a propriedade protocol_http_large_data_inbound_buffer e para o valor especifique o
tamanho máximo do arquivo em bytes. Esse valor deve corresponder ao valor definido para a
propriedade resource.maxUploadSize no serviço WCM WCMConfigService.
Observe que a propriedade protocol_http_large_data_inbound_buffer utiliza bytes. Assim, se tiver
especificado um valor de 34 MB para a propriedade resource.maxUploadSize, especifique um valor
igual a 35651584 bytes para a propriedade protocol_http_large_data_inbound_buffer.
8. Clique em Recursos > JDBC > Origens de Dados > datasource_name > Propriedades Customizadas
9. Especifique a propriedade fullyMaterializeLobData com um valor de false.
10. Clique em Recurso > JDBC > Origens de Dados > datasource_name > Propriedades do Conjunto
de Conexões.
11. Aumente o número máximo de coletas de banco de dados permitidas para o servidor de aplicativos
aumentando o valor do campo Máximo de Conexões para um valor maior que as 50 conexões
padrão.
12. Se estiver trabalhando com arquivos maiores que 100 MB, aumente a configuração de tempo limite
da transação de contêineres da Web.
a. Clique em Servidores > Tipos de Servidor > WebSphere Application Servers > portal_server >
Serviços de Contêiner > Serviço de Transações.
b. Aumente o valor da configuração do Tempo Limite Total de Duração da Transação da
configuração padrão de 120 segundos.
13. Aumente o número máximo de encadeamentos permitidos no conjunto de encadeamentos usados
pelo contêiner da Web.
a. Clique em Servidores > Tipos de Servidor > WebSphere Application Servers > portal_server >
Conjuntos de Encadeamentos > WebContainer.
b. Configure o valor do campo Tamanho Máximo em 100 encadeamentos.
14. Se você estiver usando o IBM HTTP Server Versão 7, aumente o valor de tempo limite da conexão
para conexões no aplicativo.
a. Clique em Servidores > Tipos de Servidor > Servidores da Web > web_server > propriedades
do plug-in > Propriedades Customizadas > Novas.
b. No campo Nome, insira ServerIOTimeout.
c. No campo Valor, insira o valor de tempo limite em segundos.
O valor-padrão é 60 segundos. Entretanto, ao trabalhar com arquivos grandes, este valor-padrão,
geralmente, é insuficiente e pode fazer com que uma falsa resposta de erro do servidor seja
75
enviada que, por sua vez, faz com que o portal emita o pedido novamente. Especifique um valor
de tempo limite que seja longo o suficiente para permitir que um pedido com falha receba uma
resposta ou insira -1 para um valor de tempo limite ilimitado.
15. Clique em Salvar para salvar as alterações na configuração.
16. Reinicie o portal para que as configurações tomem efeito.
Nota: Se o gerenciador de cache da política do portal indicar que vários encadeamentos de contêiner da
Web estão interrompidos, configure a propriedade
cacheinstance.com.ibm.wps.policy.services.PolicyCacheManager.lifetime no serviço WP
CacheManagerService com um valor igual a -1. Esta configuração reduz as conexões com o banco de
dados e tempos de carregamento, e ajuda a evitar que os encadeamentos sejam interrompidos.
Aumentando os Tempos Limites
Se os usuários estiverem obtendo erros de tempo de execução ao salvar itens, você poderá aumentar a
configuração total transaction lifetime timeout do servidor WebSphere Portal.
A configuração tempo limite total do tempo de vida da transação é alterada usando o WebSphere
Acesse Servidores > Tipos de Servidor > WebSphere Application Servers > portal_server > Serviços de
Contêiner > Serviço de Transações.
A configuração tempo limite total do tempo de vida da transação deve ser alterada para a mesma
quantidade em todos os servidores em seu sistema de conteúdo da Web.
Alternativas ao Aumento dos Tempos Limites do Servidor
O aumento da configuração total transaction lifetime timeout nem sempre pode ser a melhor solução
para tempos limites do servidor, visto que aumentar muito essa configuração pode causar queda no
desempenho. Erros de tempo limite gerados ao salvar itens ocorrem quando a transação atual é concluída
antes de o item ter sido salvo. Se o item que você está salvando contiver grandes quantidades de dados,
talvez seja melhor reprojetá-lo em vez de alterar a configuração total transaction lifetime timeout:
Tabela 13. Alternativas ao Aumento dos Tempos Limites do Servidor
Opção
Detalhes
Modelos de Autoria
Se um número grande de elementos tiver sido incluído em um modelo de autoria,
você poderá obter um erro de tempo limite ao salvar. Em vez de utilizar um único
modelo de autoria, crie vários modelos de autoria contendo apenas aqueles elementos
requeridos para uma tarefa específica.
Modelos e componentes de
apresentação
Você pode receber erros de tempo limite ao salvar modelos ou componentes de
apresentação que contêm grandes quantidades de HTML ou rich text em seus
designs. Em vez disso, crie vários componentes HTML ou rich text e depois faça
referência a eles nos modelos de apresentação ou nos designs de componente.
Áreas de Site e Itens de
Conteúdo
É possível receber erros de tempo limite ao salvar áreas de site e itens de conteúdo
que contenham elementos que usem grandes quantidades de HTML. Em vez disso,
crie vários componentes HTML ou rich text e depois faça referência a eles nos designs
de elemento.
Se um grande número de elementos foi incluído em uma área de site ou um item de
conteúdo, você poderá obter um erro de tempo limite ao salvar. Nesse caso, reduza o
número de elementos armazenados na área de site ou no item de conteúdo.
76
Tabela 13. Alternativas ao Aumento dos Tempos Limites do Servidor (continuação)
Opção
Detalhes
Arquivos para download
Outra alternativa para criar conteúdo da Web contendo grandes quantidades de
HTML ou rich text é fornecer informações em seu Web site no formato de arquivos
disponíveis para download. Eles podem ser armazenados como elementos de recurso
do arquivo.
Configurando o Acesso ao Servidor Remoto para Links
Antes de poder incluir links nos arquivos e documentos armazenados em sistemas de gerenciamento
remoto nos elementos de conteúdo da Web, você deve configurar seu servidor com informações sobre o
sistema remoto e as configurações usadas para tratar a comunicação com o sistema.
Uso do IBM Content Manager e de SSL: O IBM Content Manager Services para Lotus Quickr fornece a
capacidade de vincular-se a documentos armazenados no IBM Content Manager. Esses links são gerados
de acordo com a URL de serviço de base configurada no IBM Content Manager Services para Lotus
Quickr, conforme especificado pela propriedade urlBaseService no arquivo cmpathservice.properties.
Se você tiver ativado a criptografia do Secure Sockets Layer (SSL) de seu portal, verifique se a URL de
serviço de base indica o protocolo https e não o protocolo http para garantir que os links sejam gerados
corretamente. Consulte a documentação do IBM Content Manager Services para Lotus Quickr para obter
detalhes sobre como atualizar a propriedade urlBaseService.
Para evitar o vínculo com servidores não seguros, é necessário especificar uma lista de domínios
permitidos que seu portal pode acessar usando o componente de proxy AJAX do portal. É possível usar a
configuração de proxy AJAX global para customizar o tráfego HTTP de saída, tal como aplicar valores de
tempo limite de HTTP específicos ou configurar um servidor proxy HTTP de saída. Para fazer isso,
mapeie os padrões de URL para o servidor ECM na política dinâmica federated_documents_policy
usando o serviço de configuração WP ConfigService.
2.
3.
4.
5.
Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos.
Clique em WP ConfigService.
Em Propriedades Adicionais, clique em Propriedades Customizadas.
Clique em Novo e insira o nome da propriedade
wp.proxy.config.urlreplacement.federated_documents_policy.suffix e configure o valor da
sequência para o padrão do servidor ECM.
Por exemplo, para ativar o servidor para acessar informações a partir do servidor ECM
ecm.example.com na porta 10038 sobre HTTP, você incluiria a seguinte propriedade:
wp.proxy.config.urlreplacement.federated_documents_policy.1=http://ecm.example.com:10038/*
Nota: O valor da chave da propriedade suffix pode ser qualquer valor desde que seja exclusivo no
conjunto de mapeamento de chaves para federated_documents_policy.
6. Crie propriedades adicionais conforme necessário para quaisquer outros servidores ECM que você
precisa acessar através do servidor.
7. Salve suas mudanças e reinicie o servidor de portal.
Se um usuário tentar acessar um servidor (por exemplo, www.example.com) que não foi incluído na lista de
domínios permitidos, a seguinte mensagem será exibida:
O acesso ao servidor remoto www.example.com não foi concedido.
Entre em contato com o administrador do sistema.
77
Inserindo um Link no Conteúdo Remoto
Biblioteca de Publicações do IBM DB2 Content Manager
Configuração de Proxy AJAX
Configurando o Suporte para Documentos Associados
Para poder acessar metadados de documentos federados, é necessário configurar o acesso aos servidores
remotos que contêm os documentos e especificar informações sobre os feeds ou documentos de serviço
usados para recuperar os documentos. Também é possível sintonizar as configurações de cache que são
usadas com o recurso de documentos associados.
Requisito de autenticação: Para poder usar o recurso de documentos federados, você deve concluir uma
das seguintes etapas:
v Ative a conexão única (SSO) no IBM WebSphere Application Server entre o servidor de portal e o
sistema de gerenciamento de conteúdo.
v Use um sistema de gerenciamento de conteúdo que suporte autenticação básica HTTP e ative um slot
de área segura de credencial que armazene as credenciais para autenticação no servidor remoto.
Importante: Se você estiver configurando a conexão única entre o IBM Lotus Quickr e seu servidor de
portal, exporte a chave de SSO a partir do servidor Lotus Quickr e importe-a no servidor de portal, em
vez do contrário.
Configurando o Acesso a Sistemas Remotos para Documentos Federados
Para recuperar informações de metadados para documentos nos sistemas de gerenciamento de conteúdo
remotos, configure o recurso de documentos associados com informações sobre o sistema remoto e as
configurações usadas para manipular a comunicação com o sistema.
Como o recurso de documentos associados usa o componente do proxy AJAX para acessar o sistema de
gerenciamento de conteúdo remoto, é possível usar a configuração de proxy AJAX global para customizar
o tráfego HTTP de saída, tal como aplicar valores de tempo limite HTTP específicos ou configurar um
servidor proxy HTTP de saída. É necessário listar os servidores de gerenciamento de conteúdo
individuais a serem acessados através do recurso de documentos associados como destinos de pedido
permitidos na configuração de proxy AJAX e ativar o encaminhamento de cookie LTPA para esses
pedidos. Para fazer isto, mapeie os padrões de URL para o servidor de gerenciamento de conteúdo na
política dinâmica federated_documents_policy usando o serviço de configuração WP ConfigService.
2. Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos.
3. Clique em WP ConfigService.
4. Em Propriedades Adicionais, clique em Propriedades Customizadas.
5. Clique em Novo e insira o nome da propriedade
wp.proxy.config.urlreplacement.federated_documents_policy.suffix e configure o valor de cadeia
com o padrão de URL do servidor de gerenciamento de conteúdo.
Por exemplo, para ativar o recurso dos documentos associados para acessar informações do servidor
de gerenciamento de conteúdo ecm.example.com na porta 10038 sobre HTTP, você incluiria a seguinte
propriedade:
wp.proxy.config.urlreplacement.federated_documents_policy.1=http://ecm.example.com:10038/*
78
Nota: O valor da chave da propriedade suffix pode ser qualquer valor contanto que seja exclusivo
no conjunto de mapeamentos de chaves para a política dinâmica federated_documents_policy.
6. Crie propriedades adicionais conforme necessário para quaisquer outros servidores de gerenciamento
de conteúdo que você precisa acessar através do recurso de documentos associados.
7. Opcional: O recurso de documentos associados também pode consumir feeds ATOM arbitrários. Para
que isso seja ativado, é possível mapear o prefixo de URL do feed ATOM com a política dinâmica
default_policy.
a. Clique em Novo, insira o nome da propriedade
wp.proxy.config.urlreplacement.default_policy.suffix e configure o valor de cadeia com o
padrão de URL do servidor que fornece o feed ATOM.
Por exemplo, para ativar o recurso de documentos associados para acessar feeds ATOM do
servidor www.example.com, você incluiria a seguinte propriedade:
wp.proxy.config.urlreplacement.default_policy.1=http://www.example.com/*
O valor da chave da propriedade suffix pode ser qualquer valor contanto que seja exclusivo no
conjunto de mapeamento de chaves para a política dinâmica default_policy.
Importante: Para evitar que o token de segurança seja encaminhado para servidores não
confiáveis, certifique-se de não usar a política dinâmica federated_documents_policy para esses
servidores.
b. Crie propriedades adicionais conforme necessário para qualquer outro servidor de feed ATOM que
for necessário acessar por meio do recurso de documentos associados.
8. Salve suas alterações e reinicie o servidor de portal.
Configurando o Recurso de Documentos Federados
Configure o recurso de documentos federados para especificar informações sobre os servidores de origem
para os documentos que estão disponíveis aos usuários.
Quando o portal recupera documentos de um servidor remoto, a autenticação pode ser necessária para
acessar os documentos no servidor remoto. É possível usar diversos tipos de autenticação:
v Conexão única (SSO) entre o portal e o servidor remoto
v Informações de nome de usuário e senha na interface com o usuário. Apenas a autenticação básica de
HTTP é suportada para servidores CMIS.
v Slots de áreas seguras de credenciais que manipulam autenticação HTTP
Além de ativar ou desativar slots de áreas seguras de credenciais para autenticação, é possível identificar
os servidores que fornecem documentos. Para cada servidor, é possível definir características como o tipo
de documento que o servidor retorna e o título usado para identificar o servidor.
3. Clique em WP FederatedDocumentsService.
5. Especifique se os slots de áreas seguras de credenciais são usados para autenticação nos servidores
remotos.
Como é possível acessar documentos federados por meio do editor de personalização ou do editor
de rich text fornecido com o Web Content Manager, é possível configurar os slots de áreas seguras
de credenciais para cada método de forma independente.
a. Se você estiver acessando documentos federados usando o editor de personalização, clique em
wp.federated.documents.pzn.vaultselection.enabled. Para ativar slots de áreas seguras de
79
credenciais, configure o valor como true ou, para desativar slots da área segura de credenciais,
configure o valor como false. Por padrão, o valor é true.
b. Se você estiver acessando documentos federados usando o editor de rich text no Web Content
Manager, clique em wp.federated.documents.wcm.vaultselection.enabled. Para ativar slots de
áreas seguras de credenciais, configure o valor como true ou, para desativar slots da área segura
de credenciais, configure o valor como false. Por padrão, o valor é true.
Se você ativar slots de áreas seguras de credenciais, os usuários poderão selecionar um slot de área
segura de credencial na interface com o usuário. É possível também usar a propriedade
wp.federated.documents.suffix.vault.slot para especificar um slot de credencial padrão a ser usado
com um determinado servidor remoto.
6. Especifique se os usuários podem inserir seus próprios servidores ao acessar o conteúdo remoto ou
podem usar apenas os servidores predefinidos que você configura.
a. Clique em wp.federated.documents.custom.server.enabled.
b. Para permitir que os usuários insiram seus próprios servidores, configure o valor como true.
Para evitar que os usuários insiram servidores customizados, configure o valor como false.
Quando configurado como false, a interface com o usuário não exibe o campo de entrada para
servidores customizados. Por padrão, o valor é true.
7. Especifique se os documentos dos servidores que suportam interfaces remotas de Serviços de
Documentos podem ser recuperados pelo portal. Exemplos de produtos que suportam interfaces
remotas de Serviços de Documentos incluem IBM Lotus Quickr, IBM Content Manager e IBM
FileNet Content Manager.
a. Clique em wp.federated.documents.document.services.enabled.
b. Para permitir o acesso a feeds de Serviços de Documentos, configure o valor como true. Para
desativar o acesso a feeds de Serviços de Documentos, configure o valor como false. Se
configurado como false, os usuários ainda podem acessar servidores que suportam feeds CMIS
ou Atom, mas as conexões com servidores de Serviços de Documentos não são suportadas. Por
padrão, o valor é true.
8. Para cada servidor remoto que contém documentos que você deseja acessar do portal, configure a
URL do servidor, o tipo de feed e propriedades opcionais adicionais.
O valor da parte suffix da chave de propriedade é usado para agrupar propriedades relacionadas
para cada servidor. Use o mesmo valor suffix para as propriedades relacionadas ao mesmo servidor.
O suffix pode ser qualquer valor, desde que exclusivo entre as chaves de propriedade.
Para cada propriedade, clique em Novo e insira o nome e o valor:
wp.federated.documents.suffix.url
Valor: A URL para um feed Atom ou documento de serviço CMIS para o servidor remoto.
Esta propriedade é requerida.
wp.federated.documents.suffix.type
Valor:
v CMIS indica que o servidor remoto fornece um documento de serviço CMIS.
v DocumentServices indica que o servidor remoto suporta as interfaces remotas dos serviços
de documento.
v ATOM indica que o servidor remoto fornece um feed Atom genérico.
Se nenhum valor for especificado, um valor padrão CMIS será usado.
wp.federated.documents.suffix.title.default
Valor: O título usado para identificar esse servidor de origem na interface com o usuário,
quando não há nenhum pacote de recursos definido para fornecer texto de título. Se nenhum
título padrão e nenhum pacote configurável de recursos estiverem definidos, o valor da
propriedade wp.federated.documents.suffix.url será usado na interface com o usuário.
wp.federated.documents.suffix.nls.resources
Valor: O nome do pacote configurável de recursos que contém título e descrição traduzidos
80
usados para identificar esse servidor de origem na interface com o usuário. Se essa
propriedade não for definida, o título padrão será usado. Se nenhum título padrão e nenhum
pacote configurável de recursos estiverem definidos, o valor da propriedade
wp.federated.documents.suffix.url será usado na interface com o usuário.
wp.federated.documents.suffix.vault.slot
Valor: O nome do slot de área segura de credencial que armazena as credenciais usadas para
autenticação no servidor remoto. Os slots de áreas seguras de credenciais são configurados e
gerenciados pelo administrador do portal. Essa propriedade define o slot de área segura de
credencial padrão que é predefinido na interface com o usuário, embora o usuário também
possa selecionar um slot diferente se um estiver disponível. Se essa propriedade não estiver
definida, a interface com o usuário não exibirá um slot de área segura de credencial padrão,
mas você ainda poderá selecionar um slot na lista disponível. Esta propriedade é opcional.
Nota: O slot de área segura de credencial deve conter as credenciais que são necessárias
para autenticação no servidor remoto.
wp.federated.documents.suffix.override.authentication.enabled
Valor: true ou false. Quando configurado como true, o usuário pode alterar o método de
autenticação do servidor na interface com o usuário. Quando configurado como false, a
interface com o usuário não exibe o campo para alterar o método de autenticação. O
valor-padrão é true.
9. Opcional: Configure a quantidade de dados retornados para o atributo de metadados de resumo do
documento.
a. Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos.
b. Clique em WCM WCMConfigService.
c. Em Propriedades Adicionais, clique em Propriedades Customizadas.
d. Clique em wcm.pzn.ecm.max.field.length e insira o número de caracteres a ser retornado. Se
nenhum valor for especificado, o valor padrão será 128 caracteres.
10. Opcional: Configure se as mudanças de propriedade são carregadas automaticamente.
Por padrão, o serviço de Documentos Federados recarrega automaticamente as propriedades em um
intervalo especificado, sem exigir que você reinicie o portal. É possível alterar o comportamento de
recarregamento automático ou modificar o intervalo de recarregamento.
Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos.
Clique em WP FederatedDocumentsService.
Em Propriedades Adicionais, clique em Propriedades Customizadas.
Clique em wp.federated.documents.document.service.reload.disabled e especifique um valor
true para desativar o recarregamento automático de propriedades. O valor padrão é false.
e. Clique em wp.federated.documents.document.service.reload.interval e especifique o intervalo
em segundos para recarregar as propriedades. O valor padrão é 3 segundos.
a.
b.
c.
d.
11. Salve as alterações. O serviço de Documentos Federados recarrega automaticamente qualquer
propriedade atualizada. Se você tiver desativado o recarregamento automático, reinicie o servidor de
portal.
12. Se você ativar slots de áreas seguras de credenciais, conceda acesso a esses slots para todos os
usuários autenticados.
a. Efetue login no portal como administrador.
b.
c.
d.
e.
Clique em Administração > Acesso > Resource Permissions.
Na lista de tipos de recursos, navegue para Recursos Virtuais.
Para o recurso ADMIN_SLOTS, clique no ícone Designar Acesso.
Edite a função de Usuário e inclua o grupo Todos os Usuários do Portal Autenticados na
função.
81
Ajuste de Cache para Documentos Associados
O recurso de documentos associados usa o cache de lista de documentos, o cache de dados de
documentos e o cache de tipos de feeds para gerenciar informações sobre a lista de documentos, os dados
de documentos e os tipos de feeds que um servidor fornece.
v O cache da lista de documentos contém a lista de identificadores de documento contidos no resultado da
seleção de regra de um usuário específico e uma regra de seleção específica. O cache é ativado por
padrão com uma duração de entrada de cache padrão de 10 minutos.
v O cache de dados do documento contém os metadados de um documento específico. O cache é ativado
por padrão com uma duração de entrada de cache padrão de 10 minutos.
v O cache de tipo de feed contém o tipo de feed para uma determinada URL de feed. O tipo de feed pode
ser Serviços de Documento, CMIS ou ATOM. O cache é ativado por padrão com uma duração de
entrada de cache padrão de 24 horas.
Para sintonizar esses caches, é possível configurar o Serviço do Gerenciador de Cache (WP
CacheManagerService) no WebSphere Integrated Solutions Console. Usando as propriedades a seguir:
v Cache de lista de documentos: cacheinstance.com.ibm.pzn.wcm.ecm.DocumentListCache
v Cache de dados de documentos: cacheinstance.com.ibm.pzn.wcm.ecm.DocumentMetaDataCache
v Cache de tipo de feed: cacheinstance.com.ibm.pzn.wcm.ecm.FeedTypeServerCache
As atualizações que ocorrem no sistema de gerenciamento de conteúdo remoto não podem ser refletidas
imediatamente no lado do portal se houver uma entrada correspondente localizada no cache. Os valores
de duração do cache individual determinam o atraso de tempo máximo para atualizações
correspondentes.
Nota:
v O atraso de tempo para novos documentos se tornarem visíveis e documentos excluídos serem
removidos depende do valor de duração para o cache da lista de documentos configurado.
v O atraso de tempo para atualizações nos metadados que descrevem um documento (por exemplo,
alterações no título do documento) depende do valor da duração configurado para o cache da lista de
documentos.
O cache da lista de documentos específico do usuário é invalidado, explicitamente, toda vez que o
usuário efetua login, para que a lista mais atual de identificadores de documentos disponíveis esteja
disponível mediante login.
Configurando um Ambiente de Migração de Dados de Conteúdo da
Web
Configure o ambiente de migração de dados para emular o ambiente de entrega de conteúdo da Web e
permitir teste antes da implementação.
Você define e gerencia opções do ambiente de temporariedade no serviço WCM WCMConfigService usando o
WebSphere Integrated Solutions Console.
v Se o seu servidor de migração de dados for utilizado unicamente como um servidor de
armazenamento em que as alterações em seu site são acumuladas antes da organização dessas
alterações em um ambiente de entrega, você poderá precisar apenas revisar as configurações de
organização do servidor de migração de dados. Na maioria dos casos, você deve assegurar-se de que a
organização automática esteja desativada.
82
v Se estiver usando o seu ambiente de migração de dados para testar a aceitação do usuário antes da
organização em um ambiente de entrega, então precisará assegurar-se de que todas as outras definições
configuradas em seu servidor de migração correspondam às definidas no servidor de entrega.
Configurando um Ambiente de Entrega de Conteúdo da Web
Configure o seu ambiente de entrega instalando os visualizadores de conteúdo da Web e ativando
quaisquer outros recursos necessários.
Configurando a Análise de Site para o Visualizador de Conteúdo da
Web
Para controlar dados de uso do visualizador de conteúdo da web, é possível configurar o portal para
criação de log de análise do site para o visualizador de conteúdo da web.
Ativando o Criador de Logs do Visualizador de Conteúdo da Web
Para aproveitar a criação de log de análise do site disponível no visualizador de conteúdo da web, é
necessário configurar o serviço WP SiteAnalyzerLogService e ativar o serviço
SiteAnalyzerJSRPortletLogger.
Antes de ativar o criador de logs SiteAnalyzerJSRPortletLogger, você deve assegurar que a análise do site
foi ativada para o portal em geral, conforme descrito em Criando log e analisando dados do site do lado
do servidor.
3. Clique em WP SiteAnalyzerLogService.
4. Ative o criador de logs SiteAnalyzerJSRPortletLogger através do WP SiteAnalyzerLogService
definindo o parâmetro SiteAnalyzerJSRPortletLogger.isLogging e configurando o valor de
parâmetro como true.
5. Salve suas alterações e reinicie o portal.
Exemplo de Análise de Site para o Visualizador de Conteúdo da Web
O registro de análise do site utiliza o formato de registro NCSA Combinado, que é uma combinação do
formato de registro NCSA Comum e três campos adicionais: o campo referrer, o campo user_agent e o
campo cookie. Esse exemplo descreve informações de uma típica criação de log de análise do site para o
visualizador de conteúdo da web.
O registro de análise do site do IBM WebSphere Portal é:
wp_profile_root/logs/WebSphere_Portal/sa_date_time.log
onde date_time é a data e hora de criação do arquivo. O arquivo de log atual (ativo) é denominado sa.log.
Nota: O WP SiteAnalyzerService pode ser configurado para usar nomes de arquivos diferentes.
O exemplo a seguir exibe uma entrada de amostra no log de análise do site, à medida que ela é gravada
pelo visualizador de conteúdo da Web se o SiteAnalyzerJSRPortletLogger estiver ativado.
9.37.3.88 - jdoe [22/Nov/2008:22:11:27 +0100] "GET /Portlet/5_8000CB1A00U6B02NVSPH1G20G1/
Web_Content_Viewer_(JSR_286)/Web%20Content%2fTestSite01%2fTestSiteArea01
%2fTestContent01?PortletPID=5_8000CB1A00U6B02NVSPH1G20G1&PortletMode=view&PortletState=normal
&RequestType=render&PUBLIC_CONTEXT=%2fWeb%20Content%2fTestSite01 %2fTestSiteArea01
%2fTestContent01 HTTP/1.1" 200 -1 "http://myserver.company.com/Page/
83
6_8000CB1A00UR402F0JC25U1O25/MyPage" "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
rv:1.8.1.18) Gecko/20081029 Firefox/2.0.0.18" "JSESSIONID=0000JwIm04xm7btVLwzCj9Qo-uj:-1"
A tabela descreve cada campo do formato de registro:
Tabela 14. Explicação de cada campo no formato de registro
Campo do Exemplo
9.37.3.88
-
jdoe
host
O endereço IP do cliente HTTP que enviou o
pedido.
Importante: Se houver um servidor de proxy
reverso entre o cliente e o portal, o endereço IP
registrado será aquele do servidor proxy reverso
em vez do cliente HTTP. Para registrar o
endereço IP do cliente HTTP, você deve remover
o servidor proxy reverso do ambiente.
rcf931
O identificador usado para identificar o cliente
que está fazendo o pedido. Se o identificador do
cliente não for conhecido, o campo será
configurado com o caractere de hífen (-).
username
O ID do usuário para o cliente. Se o ID do
usuário não for conhecido, o campo será
configurado com o caractere de hífen (-).
[22/Nov/2008:22:11:27 +0100]
84
Nome do Campo de Registro e Explicação
date:time timezone
A data e a hora do pedido de HTTP.
Tabela 14. Explicação de cada campo no formato de registro (continuação)
Campo do Exemplo
"GET /Portlet/[...] HTTP/1.1"
request O método de HTTP, a URI do recurso solicitado
e a versão de HTTP usada pelo cliente. O URI é
composto pelos elementos a seguir:
v O identificador Portlet.
v O ID da instância do visualizador de
conteúdo da Web que é necessário.
v O nome administrativo do visualizador de
conteúdo da Web (Nota: Esse nome é sempre
o mesmo, a menos que o portlet tenha sido
clonado)..
v O caminho de contexto do item do Web
Content Manager renderizado codificado em
UTF-8.
v Uma cadeia de consultas contendo os
seguintes parâmetros:
PortletPID
O ID da instância do visualizador de
conteúdo da Web que é necessário.
PortletMode
O modo no qual o portlet é
renderizado. Observe que o
visualizador de conteúdo da Web
grava entradas de log apenas no
modo de visualização.
PortletState
O estado da janela de portlet.
RequestType
O tipo de pedido (observe que o
visualizador de conteúdo da Web
grava entradas de log apenas para
pedidos de renderização).
Isso é seguido por uma lista de todos os
parâmetros de pedidos disponíveis para a
instância do visualizador de conteúdo da Web
como pares chave-valor codificados por
UTF-8.
200
-1
"http://myserver.company.com/Page/
6_8000CB1A00UR402F0JC25U1O25/MyPage"
statuscode
O código de status de HTTP para o pedido.
bytes
O número de bytes de dados transferidos do
cliente como parte do pedido. Um valor igual a
-1 indica que o número de bytes é
desconhecido.
referrer
O referente no caso de entradas de log de
análise do site de portlet identifica a página de
portal na qual a instância de conteúdo da Web é
renderizada.
85
Tabela 14. Explicação de cada campo no formato de registro (continuação)
Campo do Exemplo
"Mozilla/5.0 [...]"
"JSESSIONID=0000JwIm04xm7btVLwzCj9Qo-uj:-1"
user_agent
O tipo de navegador da Web usado pelo cliente.
cookies
O nome e o valor de um cookie que foi enviado
ao navegador do cliente como parte do pedido.
Se vários cookies tiverem sido enviados, a lista é
delimitada pelo caractere ponto e vírgula.
Referências relacionadas
Compreendendo o Registro de Análise do Site
Parâmetros da Interface de Configuração XML para o Visualizador de
Conteúdo da Web
Tal como ocorre com outros portlets em seu portal, é possível usar a interface de configuração XML
(comando xmlaccess) para implementar e configurar o visualizador de conteúdo da web. Para simplificar
a configuração do portlet com a interface de configuração XML, os parâmetros do portlet que você pode
especificar aceitam valores de caminho além dos IDs padrão.
Por padrão, o visualizador de conteúdo da web é configurado com IDs exclusivos. A vantagem disso é
que configuração não é comprometida se um item for renomeado ou movido. Entretanto, ao configurar
um portlet com a interface de configuração XML, pode ser difícil determinar o ID exclusivo de um item.
Ao configurar o visualizador de conteúdo da web, é possível referenciar itens de conteúdo da web por
seus caminhos, bem como por seus IDs, usando os parâmetros a seguir:
AUTHORINGTEMPLATE_OVERRIDE
Especifica os modelos de autoria da seção de perfil. O parâmetro pode conter múltiplos valores,
separados por vírgulas. A lista pode conter valores de ID e de caminho.
CATEGORY_OVERRIDE
Especifica as categorias da seção de perfil. Para listar múltiplas categorias, separe as categorias
por vírgulas. É possível usar valores de ID e de caminho.
SITEAREA_OVERRIDE
Especifica as áreas de site da seção de perfil. Para listar múltiplas áreas de site, separe as áreas de
site por vírgulas. É possível usar valores de ID e de caminho.
WCM_BROADCASTS_TO
Especifica a configuração de transmissão de links para o visualizador de conteúdo da Web. Os
valores incluem:
v WCM_LINKING_DYNAMIC: Informações sobre o item de conteúdo da Web exibidos no visualizador
de conteúdo da Web são usadas para determinar dinamicamente para qual página o contexto é
transmitido.
v WCM_LINKING_SELF: O contexto do visualizador de conteúdo da Web atual é transmitido para
outros visualizadores de conteúdo da Web na mesma página de portal.
v WCM_LINKING_OTHER: O contexto do visualizador de conteúdo da Web atual é transmitido para
outros visualizadores de conteúdo da Web em outra página de portal, conforme especificado
pelo parâmetro WCM_PORTAL_PAGE_ID.
v WCM_LINKING_NONE: O contexto do visualizador de conteúdo da Web atual não é transmitido
para outros visualizadores de conteúdo da Web.
86
WCM_COMPONENT_IDR
Especifica um componente de biblioteca e será usado apenas se o tipo de conteúdo Componente
estiver selecionado.
WCM_CONTENT_COMPONENT
Especifica o nome do elemento a ser exibido, quando o parâmetro WCM_CONTENT_TYPE tiver o valor
CONTENT_COMPONENT.
WCM_CONTENT_CONTEXT_IDR
Especifica o contexto de renderização do conteúdo. Ele pode ser um item de conteúdo ou uma
área de site, conforme especificado pelo parâmetro WCM_CONTENT_CONTEXT_TYPE.
WCM_CONTENT_CONTEXT_TYPE
Especifica o tipo de contexto de conteúdo configurado. Os valores incluem:
v CONTENT: Indica se o contexto de conteúdo é um item de conteúdo.
v PARENT: Indica se o contexto de conteúdo é uma área de site.
WCM_CONTENT_TYPE
Especifica o item a ser exibido. Os valores incluem:
v CONTENT: Indica se o item a ser exibido é um item de conteúdo.
v COMPONENT: Indica se o item a ser exibido é um componente.
v CONTENT_COMPONENT: Indica se o item a ser exibido é um elemento.
WCM_DESIGN_IDR
Especifica um modelo de apresentação alternativo.
WCM_LISTENS_TO
Especifica como o visualizador de conteúdo da Web está configurado para receber links
transmitidos de outros visualizadores de conteúdo da Web. Os valores incluem:
v WCM_LINKING_OTHER: As informações são recebidas de qualquer visualizador de conteúdo da
Web que transmita links.
v WCM_LINKING_SELF: As informações são recebidas apenas deste visualizador de conteúdo da
Web.
v WCM_LINKING_NONE: Nenhuma informação de outros visualizadores de conteúdo da Web é
recebida.
WCM_PAGE_TITLE
Usado com o parâmetro WCM_PAGE_TITLE_TYPE, esse parâmetro especifica o título da página do
visualizador de conteúdo da Web. Os valores incluem:
v O título definido pelo usuário da página, se o parâmetro WCM_PAGE_TITLE_TYPE tiver um valor
igual a WCM_PAGE_TITLE_TYPE_GENERAL.
v O nome do pacote configurável de recursos que contém o título da página, se o parâmetro
WCM_PAGE_TITLE_TYPE tiver um valor igual a WCM_PAGE_TITLE_TYPE_RESBUN.
WCM_PAGE_TITLE_TYPE
Especifica como o título da página é exibido para o visualizador de conteúdo da Web. O valor
inclui:
v WCM_PAGE_TITLE_TYPE_DEFAULT: O título padrão definido na interface de administração do portal
é usado.
v WCM_PAGE_TITLE_TYPE_GENERAL: Um título definido pelo usuário é usado, conforme especificado
pelo parâmetro WCM_PAGE_TITLE.
v WCM_PAGE_TITLE_TYPE_RESBUN: O título é definido em um pacote configurável de recursos,
conforme especificado pelo parâmetro WCM_PAGE_TITLE.
v WCM_PAGE_TITLE_TYPE_DYN: O título é definido pelo valor do campo Título de Exibição para o
item que é exibido no visualizador de conteúdo da Web.
87
WCM_PORTAL_PAGE_ID
Especifica o nome exclusivo ou o ID do objeto da página que é o destino para transmissões de
links, quando o parâmetro WCM_BROADCASTS_TO estiver definido como WCM_LINKING_OTHER.
WCM_PORTLET_TITLE
Usado com o parâmetro WCM_PORTLET_TITLE_TYPE, esse parâmetro especifica o título do portlet
para o visualizador de conteúdo da Web. Os valores incluem:
v O título definido pelo usuário do portlet, se o parâmetro WCM_PORTLET_TITLE_TYPE tiver um
valor igual a WCM_PORTLET_TITLE_TYPE_GENERAL.
v O nome do pacote configurável de recursos que contém o título do portlet, se o parâmetro
WCM_PORTLET_TITLE_TYPE tiver um valor igual a WCM_PORTLET_TITLE_TYPE_RESBUN.
WCM_PORTLET_TITLE_TYPE
Especifica como o título do portlet é exibido para o visualizador de conteúdo da Web. O valor
inclui:
v WCM_PORTLET_TITLE_TYPE_DEFAULT: O título padrão definido na interface de administração do
portal é usado.
v WCM_PORTLET_TITLE_TYPE_GENERAL: Um título definido pelo usuário é usado, conforme
especificado pelo parâmetro WCM_PORTLET_TITLE.
v WCM_PORTLET_TITLE_TYPE_RESBUN: O título é definido em um pacote configurável de recursos,
conforme especificado pelo parâmetro WCM_PORTLET_TITLE.
v WCM_PORTLET_TITLE_TYPE_DYN: O título é definido pelo valor do campo Título de Exibição para
o item de conteúdo que é exibido no visualizador de conteúdo da Web.
Ao especificar um caminho de conteúdo, você deve iniciar com o caractere de barra (/) seguido pelo
nome da biblioteca, conforme indicado nos seguintes exemplos de caminhos de conteúdo válidos:
/mylib/myfolder/mysitearea/mycontent
ou
/mylib/mypresentationtemplate
Nota: Se você configurar um item por seu caminho em vez de por seu ID, a configuração do portlet
poderá se tornar inválida se o item for renomeado ou movido. Se um item tiver sido configurado pelo
seu caminho, o visualizador de conteúdo da Web exibirá um ícone de caminho pequeno após o item,
quando você estiver no modo Editar Configurações Compartilhadas ou Configurar.
Importante: Ao configurar um item por seu caminho, não é possível construir o caminho a partir dos
campos Título de Exibição dos itens no caminho. É necessário usar os campos Nome dos itens ao
especificar o caminho.
Opções de Armazenamento em Cache
As páginas da Web e conteúdo gerados pelo IBM Web Content Manager a partir de origens de dados
externas podem ser armazenados em cache pelo aplicativo Web Content Manager. Se utilizado
corretamente, o armazenamento em cache do Web Content Manager pode aumentar drasticamente o
desempenho de um site.
Tipos de Cache de Conteúdo da Web
Aprenda sobre os tipos de armazenamento em cache usados pelo IBM Web Content Manager,
armazenamento em cache do conteúdo da Web básico e armazenamento em cache do conteúdo da Web
avançado.
Cache Básico de Conteúdo da Web
Essa é a opção de cache mais simples. Na primeira vez em que uma página da Web é renderizada pelo
aplicativo Web Content Manager, ela é armazenada em um cache. Os usuários então acessam essa página
88
a partir do cache até que ele expire. Só então a página da Web é renderizada novamente. O principal
benefício deste cenário é o desempenho aprimorado. O cache básico deverá ser utilizado apenas em
conteúdo estático que não requer acesso em "tempo real".
Cache Avançado de Conteúdo da Web
Há duas diferenças principais entre o cache básico e o cache avançado:
v O cache avançado pode armazenar em cache as páginas baseadas nos diferentes perfis de usuário.
v Os parâmetros de cache nas tags connect e nos pedidos de URL podem ser utilizados para substituir as
definições padrão de cache avançado de conteúdo da Web no servidor, permitindo que você defina as
configurações de cache customizado para páginas da Web ou componentes individuais.
Tabela 15. Tipos de armazenamento em cache avançado
Tipo de armazenamento em
cache avançado
Detalhes
Cache de site
É igual ao cache básico de conteúdo da Web, exceto que os parâmetros de cache nas
tags connect e nos pedidos de URL podem ser utilizados para substituir as definições
de cache avançado de conteúdo da Web padrão no servidor.
Cache de sessão
Quando o armazenamento em cache da sessão é ativado, uma cópia de cada página
da Web que um usuário visita é armazenada no cache de sessão. O usuário acessa a
versão armazenada em cache de uma página da Web até que inicie uma nova sessão
ou até que a página da Web armazenada em cache seja expirada do cache.
Armazenamento em cache
de usuário
Quando o armazenamento em cache do usuário está ativado, uma cópia de cada
página da Web que um usuário visita é armazenada no cache do usuário. O usuário
acessa a versão de uma página da Web armazenada em cache até que ela seja
expirada do cache.
Cache protegido
O armazenamento em cache protegido é usado em sites nos quais os recursos de
segurança do item são usados para conceder acesso a diferentes usuários para
diferentes páginas da Web e componentes com base nos grupos aos quais eles
pertencem.
Cache personalizad
O cache personalizado é utilizado para armazenar em cache as páginas da Web de
usuários que possuem o mesmo "perfil de personalização". Isso significa que os
usuários que selecionaram as mesmas categorias de personalização e palavras-chaves,
que pertencem ao mesmo grupo, compartilham um único cache.
Cache de Conteúdo da Web Padrão Versus Cache Customizado
Os parâmetros de cache nas tags connect e nos pedidos de URL podem ser utilizados para substituir as
definições padrão de cache avançado de conteúdo da Web no servidor, permitindo que você defina as
configurações de cache customizado para páginas da Web ou componentes individuais.
Na maioria dos casos, o cache básico, de site e de sessão seria utilizado apenas como o cache de conteúdo
da Web padrão em seu servidor. O cache de usuário, protegido e personalizado seria utilizado geralmente
ao utilizar o cache personalizado em tags connect e pedidos de URL.
Nota: Se o cache básico for utilizado como o cache padrão de conteúdo da Web, o cache customizado
não poderá ser utilizado.
Comparações de Cache
Tabela 16. Armazenamento em cache básico versus armazenamento em cache avançado
Função
Uso da memória por item:
Cache Básico
Armazenamento em Cache
Avançado
Média
Alto
89
Tabela 16. Armazenamento em cache básico versus armazenamento em cache avançado (continuação)
Cache Básico
Avançado
Muito alta
Alto
customizado:
Não
Sim
Processamento da tag de conexão:
Não
Sim
Web Content Viewer Portlet:
Não
Sim
Função
Aprimoramento do desempenho:
Componentes de Personalização de Armazenamento em Cache:
O armazenamento em cache de conteúdo da Web pode, às vezes, ser usado com componentes de
Personalização, mas dependerão das condições configuradas na regra de personalização ou dos recursos
usados para determinar os resultados da regra. O teste de cache será necessário para determinar se o
conteúdo retornado por seu componente de personalização pode ser armazenado em cache usando o
armazenamento em cache do conteúdo da Web.
Armazenamento em Cache Versus Pré-renderização
O conteúdo exibido em portlets de renderização e por meio do IBM Web Content Manager podem ser
armazenados em cache. Uma alternativa para armazenar em cache é o uso do recurso de
pré-renderização. Visualize as diferenças entre cada estratégia.
Um site pré-renderizado pode ser visualizado de dois modos:
Usando um Servidor da Web
A visualização de um site pré-renderizado por meio de um servidor da Web é semelhante à
utilização do cache básico, pois o conteúdo exibido é estático e os caches estático e customizado
não podem ser usados.
Utilizando o Web Content Manager
A visualização de um site pré-renderizado por meio do Web Content Manager é semelhante à
utilização do cache avançado, pois o conteúdo pode ser dinâmico e o cache customizado pode ser
utilizado.
Cache Básico Versus Site Pré-renderizado Entregue com um Servidor da Web
À primeira vista, o recurso de pré-renderização e cache básico fazem a mesma coisa. Entretanto, existem
algumas diferenças maiores que determinarão qual é o melhor recurso para você.
A principal diferença entre os dois recursos é que o recurso de pré-renderização obtém uma captura
instantânea de todo o site toda vez que é executado. O armazenamento no cache básico armazena apenas
numa base página por página. Se o desempenho for seu maior problema, a pré-renderização pode ser a
resposta. Caso contrário, o armazenamento em cache básico pode ser uma opção melhor.
Tabela 17. Cache Básico Versus Site Pré-renderizado Entregue com um Servidor da Web
Função
Cache Básico
Site pré-renderizado entregue com
um servidor da Web
Desempenho:
Muito rápido
Extremamente rápido
Sim
Não
Cache customizado:
Sim
Não
Requisitos de memória:
Baixo para Médio
Os requisitos de memória dependem
do servidor da Web que está sendo
utilizado.
90
Tabela 17. Cache Básico Versus Site Pré-renderizado Entregue com um Servidor da Web (continuação)
Site pré-renderizado entregue com
um servidor da Web
Função
Cache Básico
Requisitos do disco:
Baixo para Médio
Potencialmente muito alto, visto que
o site inteiro deve caber no disco.
Links quebrados inesperados:
Sim
Não
Como algumas páginas talvez sejam O site é pré-renderizado em um
armazenadas em cache em momentos único lote, reduzindo muito as
diferentes, existe uma pequena
chances de inconsistências no site.
chance de que nem todos os links na
página armazenada no cache sejam
válidos.
Cache Avançado versus um Site Pré-renderizado Entregue Utilizando o Web Content
Manager
Essas opções são muito semelhantes. Poderá ser necessário testar ambas as estratégias antes de decidir o
que é melhor para o seu site.
Tabela 18. Cache Avançado versus um Site Pré-renderizado Entregue Utilizando o Web Content Manager
Avançado
Site pré-renderizado entregue por
meio do Web Content Manager
Desempenho:
Rápido quando armazenado em
cache, mas mais lento se a página de
solicitação expirar no cache. (Como o
processamento da tag tem um custo,
depende de quantas tags connect
uma página contém.)
Rápido, mas como o processamento
da marcação tem um custo, depende
de quantas marcações Connect a
página contém.
Sim
Não
Cache customizado:
Sim
Não
Requisitos de memória:
Médio para alto.
Médio para alto.
Requisitos do disco:
Médio para alto.
Médio para alto.
Links quebrados inesperados:
Sim
Não
Função
Como algumas páginas talvez sejam O site é pré-renderizado em um
armazenadas em cache em momentos único lote, reduzindo muito as
chances de inconsistências no site.
diferentes, existe uma pequena
chance de que nem todos os links na
página armazenada no cache sejam
válidos.
Estratégias de Expiração
Assim como as estratégias de armazenamento em cache, as estratégias de expiração padrão de um
servidor podem ser configuradas no serviço WCM WCMConfigService usando o WebSphere Integrated
Solutions Console. Os parâmetros de expiração customizada também podem ser definidos nas tags
connect e nos pedidos de URL para substituírem as estratégias de expiração padrão de um servidor.
Nota: Se o cache básico for utilizado como o cache padrão de conteúdo da Web, a expiração
customizada não poderá ser utilizada.
91
Na maioria dos casos, o planejamento de expiração se baseia na freqüência com que o conteúdo é
atualizado. Assim, se o conteúdo de origem for atualizado a cada hora, cada cache expirará de hora em
hora. Se o conteúdo de origem for atualizado diariamente, cada cache expirará diariamente.
Além desses exemplos, um planejamento de expiração diferente será utilizado. Se suas páginas da Web
forem atualizadas apenas uma vez por semana, ou uma vez por mês, você ainda assim poderá planejar
os seus armazenamentos em cache para expirar diariamente. Caso contrário, quando o seu conteúdo de
origem for atualizado, ele poderá levar uma semana para ser exibido em seu site.
Expirações de Armazenamento em Cache versus Expirações de Fluxo de Trabalho
O parâmetro expires em um fluxo de trabalho não está relacionado ao parâmetro Expires no
armazenamento em cache do IBM Web Content Manager. Uma página definida para expirar à meia-noite
como parte de um fluxo de trabalho expirará apenas se ainda não tiver sido salva em um cache. A página
permanecerá no cache até que o aplicativo Web Content Manager a expire, independentemente da
configuração de Expires em um fluxo de trabalho.
“Parâmetros de Expiração de Cache” na página 232
Você utiliza o parâmetro "expires" nas tags e URLs do IBM Web Content Manager para especificar quanto
tempo os dados serão mantidos no cache antes de expirarem. Depois que os dados expiram em um
cache, o próximo pedido de dados será recuperado do servidor original. O parâmetro expires não é
obrigatório.
Configuração de Cache de Conteúdo da Web
É possível padronizar o comportamento do armazenamento em cache do seu ambiente de conteúdo da
Web alterando as definições de configuração, como o tipo de cache padrão e as configurações de
expiração.
Você define e gerencia opções de cache do conteúdo da web no serviço WCM WCMConfigService usando o
WebSphere Integrated Solutions Console.
Configurando o Tipo de Cache de Conteúdo da Web Padrão
O ambiente de armazenamento em cache do conteúdo da Web do seu servidor de conteúdo da Web é
especificado pelas seguintes propriedades:
v connect.businesslogic.defaultcache
v connect.moduleconfig.ajpe.contentcache.defaultcontentcache
Tabela 19. Parâmetros de armazenamento em cache
Parâmetro
valor defaultcache
valor defaultcontentcache
Sem armazenamento em cache:
false
Nenhum
Cache básico:
true
Não especificado
Armazenamento em cache do site:
false
Site
Armazenamento em cache da sessão:
false
Sessão
Armazenamento em cache do
usuário:
false
Usuário
Armazenamento em cache seguro:
false
Protegido
personalizado:
false
Personalizado
92
Parâmetros Adicionais de Cache Padrão de Conteúdo da Web
As definições de configuração de cache do conteúdo da Web são especificados pelas seguintes
propriedades no serviço WCM WCMConfigService.
Tabela 20. Propriedades de cache por tipo de cache
Tipo de Cache
Propriedades
Cache básico:
connect.businesslogic.defaultcacheexpires
connect.businesslogic.defaultcache
Cache Avançado: Todos
connect.moduleconfig.ajpe.contentcache.defaultcontentcache
connect.moduleconfig.ajpe.contentcache.contentcacheexpires
Cache Avançado: Apenas
cache de sessão
connect.sessioncacheconfig.memcachesize
Tabela 21. Detalhes da propriedade de cache
Propriedade de Cache
Detalhes
contentcacheexpires
Define a expiração padrão para todos os caches
avançados. Ela pode ser um período relativo ou uma
data e hora absolutas.
defaultcache
Se true, o cache básico está ativado. Se false ou ausente,
o cache avançado está ativado.
defaultcacheexpires
Define a expiração padrão para o cache básico. Ela pode
ser um período relativo ou uma data e hora absolutas.
defaultcontentcache
Se o cache avançado estiver ativado, o cache avançado
padrão será definido aqui.
resourceserver.browserCacheMaxAge
Isso é usado para definir o tempo máximo em que um
item será armazenado em um cache do navegador da
Web.
resourceserver.maxCacheObjectSize
Isso é utilizado para definir o tamanho máximo de
objetos que podem ser armazenados em cache em
kilobytes. Por padrão, este configurado como 300.
Formatos de Tempo de Expiração do Cache
Ao definir as configurações de expiração do cache listadas na Tabela 3, é possível especificar um tempo
relativo ou um tempo absoluto:
v REL {valor inteiro}{unidades}
v ABS {cadeia de formato da data}
{unidades} =
v d|D para dias
v m|M para meses
v s|S para segundos
v h|H para horas
{cadeia de formato da data} =
v Mon, 06 Nov 2000 09:00:00 GMT
v Monday, 06-Nov-00 09:00:00 GMT
v Mon Nov 6 09:00:00 2000
93
v 6 Nov 2000 9:00 AM
Nota: Os dois últimos formatos assumem GMT.
Exemplos:
v contentcacheexpires="REL 300S"
v contentcacheexpires="ABS Mon, 06 Nov 2000 09:00:00 GMT"
Configuração do Cache de Dados
O armazenamento de dados em cache é utilizado para armazenar em cache os dados recuperados pelo
aplicativo IBM Web Content Manager de origens externas utilizando tags connect ou por pedidos feitos
pelas URLs.
Você define e gerencia opções de cache de dados no serviço WCM WCMConfigService usando o WebSphere
Especifique as seguintes propriedades para as opções de cache de dados:
connect.connector.httpconnector.defaultcache
É utilizado quando nenhum cache é especificado em uma solicitação de dados. Os valores
possíveis são true ou false. Se true, os dados serão armazenados no cache do site.
connect.connector.httpconnector.defaultcacheexpires
A data/hora de expiração para itens incluídos em um cache (site ou sessão) se a data/hora de
expiração não estiver especificada no pedido.
connect.connector.sqlconnector.defaultcache
Determina se deve armazenar os dados em cache por padrão ou não. Os valores possíveis são
true ou false.
Opções de Pré-renderização
É possível ativar a pré-renderização de modo que o conteúdo possa ser visualizado por meio de um
aplicativo IBM Web Content Manager ou como um site independente acessível por meio de um servidor
da Web.
Você define e gerencia opções de pré-renderização no serviço WCM WCMConfigService usando o WebSphere
Iniciar a Pré-renderização Automaticamente
Embora seja possível pré-renderizar manualmente um website por meio da interface de URL, também é
possível configurar a pré-renderização para executar automaticamente quando o servidor for iniciado.
2. Clique em WCM WCMConfigService.
4. Edite a propriedade connect.businesslogic.module e anexe cacher ao valor. Exemplo:
web,mail,default,ajpe,federatedproxy,ajpecatselect,memberfixer,workflowenablement,
itemdispatcher,plutouploadfile,plutodownloadfile,synd,subs,syndication,
refreshallitems,unlocklibrary,custom,data,clearversions,clearhistory,
reseteventlog,cacher
5. Salve suas mudanças e reinicie o servidor.
94
Ativar a Pré-renderização para Sites Visualizados Usando o Web Content Manager
Essa opção é utilizada quando você está acessando o site pré-renderizado por meio do Web Content
Manager. Isso aumentará o desempenho como conteúdo estático que é acessado a partir do site
pré-renderizado, mas o conteúdo dinâmico ainda será processado pelo Web Content Manager.
Para permitir que usuários acessem o site pré-renderizado por meio de um aplicativo Web Content
Manager, especifique a propriedade connect.businesslogic.module.default.class no serviço WCM
WCMConfigService usando o WebSphere Integrated Solutions Console.
v Nome da propriedade: connect.businesslogic.module.default.class
v Valor: com.aptrix.cacher.CacherModule
Nota: Você não pode utilizar o portlet de renderização local (Web Content Viewer) quando
Pré-renderização está definido como o módulo padrão.
Ativar a Pré-renderização para Sites Independentes
Essa opção é utilizada quando você está utilizando o Web Content Manager para gerar um site
pré-renderizado, mas não está utilizando o Web Content Manager para visualizar o site pré-renderizado.
Você precisará utilizar um servidor da Web para visualizar o site pré-renderizado.
Especifique a propriedade connect.businesslogic.module.cacher.class no serviço WCM WCMConfigService
usando o WebSphere Integrated Solutions Console.
v Nome da propriedade: connect.businesslogic.module.cacher.class
v Valor: com.aptrix.cacher.CacherModule
Especifique as seguintes propriedades para configurar o armazenamento em cache. Os valores padrão
estão listados, embora você possa padronizar esses valores, conforme for necessário. A menos que você
configure explicitamente um valor para uma propriedade, o valor padrão será usado.
connect.moduleconfig.cacher.destdir
Valor: ${USER_INSTALL_ROOT}/PortalServer/wcm/ilwwcm/cacher
Diretório base sob o qual cada cache de site será criado. Haverá um subdiretório criado para cada
site.
Importante: Se o pré-renderizador for executado com a propriedade
connect.moduleconfig.cacher.overwritecache definida como true, quaisquer arquivos no
caminho connect.moduleconfig.cacher.destdir que não foram gravados na última execução do
pré-renderizador serão excluídos. Por esse motivo, assegure-se de que o caminho
connect.moduleconfig.cacher.destdir seja utilizado somente para armazenar o conteúdo
renderizado e que ele não contenha nenhum outro dado que não possa ser criados novamente.
connect.moduleconfig.cacher.tempdir
Valor: ${USER_INSTALL_ROOT}/PortalServer/wcm/ilwwcm/cacher/temp
O diretório temporário necessário para construir o cache do site antes de mover os dados para o
diretório base especificado pela propriedade connect.moduleconfig.cacher.destdir.
connect.moduleconfig.cacher.delay
Valor: 1
Isso é utilizado para definir o tempo, em segundos, entre o pedido de uma página e o
armazenamento em cache.
connect.moduleconfig.cacher.busydelay
Valor: 5
95
Isso é utilizado para definir o tempo, em segundos, da configuração "busy delay". Isso é utilizado
se estiver em execução dentro do período do busy start ao busy end. Caso contrário, a
configuração "delay" também será utilizada.
connect.moduleconfig.cacher.busystart/connect.moduleconfig.cacher.busyend
Valor: 9:00 am/5:00 pm
Essas configurações determinam os tempos nos quais a configuração "busy delay" será utilizada.
Digite um tempo absoluto conforme mostrado.
connect.moduleconfig.cacher.overwritecache
true
O pré-renderizador substituirá os arquivos no diretório de cache destdir (em seguida,
excluirá os arquivos desnecessários). Isso resulta em uma alteração progressiva no
conteúdo do site na medida em que for visualizado pelo usuário. Esse é o valor padrão.
false
Na primeira vez em que um site for pré-renderizado, os arquivos do site armazenado em
cache serão incluídos no diretório de destino. Como as alterações são feitas no site por
meio do portlet de autoria, a nova versão do site será gradativamente armazenada em
cache no diretório temporário e o site antigo permanecerá no diretório de destino. Depois
que o armazenador em cache concluir o armazenamento do site completamente, o
conteúdo do diretório temporário será movido para o diretório de destino que conterá as
versões nova e antiga do site armazenado em cache.
Nota: Um valor de false não deverá ser usado se um servidor da Web exibir os dados
pré-renderizados, pois alguns servidores da Web bloqueiam os diretórios de dados.
connect.moduleconfig.cacher.rendereruser
Valor: Anonymous.
Determina o usuário a ser utilizado para renderizar o conteúdo do Web Content Manager. Digite
Anônimo ou Administrador ou um usuário ou nome de grupo específico.
O site é pré-renderizado com base nos direitos de segurança desse usuário. Se o usuário
especificado aqui não tiver acesso a um determinado componente, ele não será pré-exibido.
connect.moduleconfig.cacher.task.cacherurl
Valor: http://${WCM_HOST}:${WCM_PORT}/${WCM_CONTEXT_ROOT}/connect/
A URL completa a ser utilizada como substituição do servlet de conexão nas páginas
pré-renderizadas. A URL deve terminar com a cadeia especificada na propriedade
connect.moduleconfig.cacher.task.servletpath se não estiver em branco. O contexto de
cacherurl é usado ao gerar uma URL com pré-renderização. Essa propriedade não será usada
quando uma página pertencer a um site que ainda não foi pré-renderizado no nível do site pela
tarefa planejada ou por meio de um pedido SRV=cacheSite.
connect.moduleconfig.cacher.task.servletpath
Valor: /connect
O caminho do servlet de conexão substituído definido na propriedade
connect.moduleconfig.cacher.task.cacherurl. Essa propriedade poderá permanecer em branco
se o contexto cacherurl deverá ser usado inalterado.
connect.moduleconfig.cacher.defaultcontentname
Valor: index.html
Isso define o nome do arquivo padrão ou home usado ao acessar o site pré-renderizado.
Normalmente, o nome será index.html.
connect.moduleconfig.cacher.task.siteareas
Valor: LibraryA/SiteAreaA,LibraryB/SiteAreaB,SiteAreaC
As áreas de site dentro do ambiente Web Content Manager a serem armazenadas em cache são
inseridas aqui, separadas por vírgulas. Essa propriedade oferece a opção de especificar a
96
biblioteca, além da área de site. Se a biblioteca for especificada, o pré-renderizador procurará a
área de site nessa biblioteca. Se nenhuma biblioteca for especificada, a biblioteca padrão será
usada, conforme especificado na propriedade defaultLibrary.
Nota: Se qualquer nome de área de site contiver vírgula, você deverá criar parâmetros separados
para cada área de site usando este formato: connect.moduleconfig.cacher.task.siteareas.N
N representa um número inteiro diferente para cada parâmetro. Por exemplo, se você quiser
pré-renderizar uma área de site chamada "SiteArea,Red" e um site chamado "Site,Yellow",
precisaria criar os seguintes parâmetro:
connect.moduleconfig.cacher.task.siteareas.1=MyLib/SiteArea,Red
connect.moduleconfig.cacher.task.siteareas.2=Site,Yellow
connect.moduleconfig.cacher.task.interval.recurrence
connect.moduleconfig.cacher.task.interval.startdelay
É possível definir o CacherModule para executar depois de um número recorrente de minutos.
recurrence:
Valor: 10.
O período recorrente em minutos de uma tarefa recorrente.
startdelay:
Valor: 1
O atraso em minutos antes de iniciar a primeira tarefa recorrente.
Nota: Se você não configurar a pré-renderização para iniciar automaticamente quando o servidor
for iniciado, a pré-renderização em intervalos não funcionará até que você acione manualmente o
módulo do cacher.
connect.moduleconfig.cacher.task.scheduled.times
Valor: 3:00 am
Como alternativa, o CacherModule pode ser configurado para executar um certo número de
vezes. Digite uma série de tempos absolutos, separados por vírgulas.
Importante: Ao especificar valores de tempo, assegure-se de adequar-se ao formato H:MM am|pm,
incluindo o uso do caractere de vírgula (:) e do espaço. Valores especificados incorretamente
impedirão o funcionamento correto da pré-renderização.
Nota: Se você não configurar a pré-renderização para iniciar automaticamente quando o servidor
for iniciado, a pré-renderização em horários planejados não funcionará até que você acione
manualmente o módulo do cacher.
Recursos de Pré-renderização
connect.moduleconfig.cacher.useTieredResourceFolders
Valor: false
Todos os recursos, como recursos de imagens e de arquivo, são armazenados na seguinte pasta:
CACHER_DIR\LIBRARY\SITEAREA\resources
Por padrão, cada recurso individual é salvo em sua própria pasta. Por exemplo, um recurso com
o ID "7961d78049717f29bc57fee5670e9d7b" será armazenado nesta pasta:
CACHER_DIR\LIBRARY\SITEAREA\resources\7961d78049717f29bc57fee5670e9d7b
É possível alterar esse comportamento para que os recursos sejam armazenados em um conjunto
em camadas de subpastas com base nos dois primeiros caracteres do ID do recurso, alterando o
valor de connect.moduleconfig.cacher.useTieredResourceFolders para true. Por exemplo, um
recurso com o ID "7961d78049717f29bc57fee5670e9d7b" será armazenado nesta pasta:
97
CACHER_DIR\LIBRARY\SITEAREA\resources\7\9\
Todos os outros recursos cujos IDs iniciam com "79" também serão armazenados nesta pasta. Isso
é feito para reduzir o número de sub-pastas nas pastas "recursos".
Desativando a Barra de Ferramentas do Site em um Servidor de
Entrega
A barra de ferramentas do site fornece acesso aos recursos de edição para páginas gerenciadas, além de
inclusão e edição de páginas e conteúdo da web. Embora essencial para um servidor de autoria, é
recomendado que você desative a barra de ferramentas do site em um servidor de entrega. É possível
desativar a barra de ferramentas para um portal inteiro ou para portais virtuais específicos.
A função de barra de ferramentas do site normalmente não é necessária em um servidor de entrega e
desativar a barra de ferramentas do site pode melhorar o desempenho no servidor de entrega.
1. Efetue login no WebSphere Integrated Solutions Console como administrador.
3. Clique em WP VirtualPortalConfigService.
4. Atualize as propriedades de configuração apropriadas, dependendo se você deseja afetar o portal
inteiro ou um portal virtual específico.
v Para afetar o portal inteiro, conclua as seguintes etapas:
a. Clique em Propriedades Personalizadas.
b. Edite a propriedade global.toolbar.enabled e configure o valor como false.
Essa configuração desativa a barra de ferramentas do site para todos os portais virtuais.
v Para afetar um portal virtual específico, conclua as seguintes etapas:
a. Clique em Propriedades Personalizadas.
b. Para desativar a barra de ferramentas do site para o portal virtual padrão, edite a propriedade
default.toolbar.enabled e configure o valor como false.
c. Para cada portal virtual diferente do padrão no qual você deseja desativar a barra de
ferramentas do site, especifique as propriedades a seguir.
context.virtual_portal_context.property.toolbar.enabled
Configure o valor como false. Substitua virtual_portal_context pelo contexto do portal
virtual de destino (por exemplo, context.vp1.property.toolbar.
hostname.virtual_portal_hostname.property.toolbar.enabled
Configure o valor como false. Substitua virtual_portal_hostname pelo nome do host do
portal virtual de destino (por exemplo,
hostname.vp.example.com.property.toolbar.enabled.
Se definida, a propriedade global.toolbar.enabled age como uma configuração de fallback
para portais virtuais que não têm valores definidos.
Para obter informações adicionais sobre prefixos, marcadores e a ordem na qual as propriedades
são avaliadas, consulte Serviço de Configuração do Portal Virtual
98
Serviço de Configuração do Portal Virtual
Portlet de Autoria Reservado
Ao trabalhar com o visualizador de conteúdo da web ou as páginas de conteúdo da web, alguns cenários
envolvem tarefas de autoria de conteúdo da web realizadas com componentes de ferramentas de autoria.
Essas tarefas de autoria são executadas através de uma instância especial do portlet de autoria que é
reservado, especificamente, para essas tarefas e está instalado na página que está oculta a partir da
navegação da página disponível para usuários típicos.
As tarefas a seguir usam o portlet de autoria reservado:
v Selecionar uma pasta de conteúdo da Web ao criar ou editar as propriedades de uma página de
conteúdo da Web.
v Configurar o visualizador de conteúdo da web, como selecionar o item de conteúdo a ser exibido.
v Executar a edição sequencial usando componentes de ferramentas de autoria renderizados no
visualizador de conteúdo da web.
Geralmente, as tarefas de autoria são executadas em uma janela separada que abre a partir da página
atual, mas é possível configurar o comportamento de componentes de ferramentas de autoria para
redirecionar usuários para a página oculta contendo o portlet de autoria reservado.
Assegurando a Disponibilidade do Portlet de Autoria Reservado
Se a instância do portlet de autoria ou a página de portal oculta não estiver disponível ou se o usuário
não tiver permissão para acessar nenhuma delas, as tarefas de autoria que requerem o portlet de autoria
reservado falharão, fazendo com que as páginas de conteúdo da web e o visualizador de conteúdo da
web fiquem inutilizáveis. Por essa razão, você precisa ser cuidadoso ao administrar o portlet de autoria
reservado e a página de portal oculta.
As condições a seguir são essenciais para o funcionamento adequado do portlet de autoria reservado:
v Os usuários que executam qualquer uma das tarefas de autoria anteriores devem ter a função de
Usuário na página de portal oculta.
v Os usuários que executam qualquer uma das tarefas de autoria anteriores devem ter a função de
usuário no portlet de autoria reservado.
v O portlet de autoria reservado deve ser o único portlet localizado na página de portal oculta.
v O nome exclusivo da página de portal oculta deve ser
com.ibm.wps.hiddenpage.wcm.Authoring_Portlet.
v O nome exclusivo da janela de portlet da instância do portlet de autoria na página de portal oculta
deve ser com.ibm.wps.hiddenpage.wcm.control.Authoring_Portlet.
Problemas de disponibilidade relacionados ao portlet de autoria reservado ou à página de portal oculta
geralmente são identificados pelos seguintes sintomas:
v O arquivo SystemOut.log para o servidor de portal contém mensagens de erro que fazem referência ao
portlet de autoria ou página oculta. Por exemplo:
EJPDB0124E: A cadeia especificada [com.ibm.wps.hiddenpage.wcm.Authoring_Portlet] não pode
ser desserializada como um ID de objeto nem resolvida como um nome exclusivo.
EJPDB0124E: A cadeia especificada [com.ibm.wps.hiddenpage.wcm.control.Authoring_Portlet]
não pode ser desserializada como um ID de objeto nem resolvida como um nome exclusivo.
v Quando uma janela separada é ativada a partir da página atual para executar a tarefa de autoria, a
nova janela exibe a mensagem a seguir:
99
Erro 400: EJPPH0006E: A resolução de um URI falhou. Consulte o rastreio de pilha para obter
informações mais detalhadas.
v Quando uma janela separada é ativada a partir da página atual para executar a tarefa de autoria, a
nova janela está vazia.
v Quando o usuário é redirecionado para outra página de portal para executar a tarefa de autoria, o
usuário é redirecionado para a página de portal padrão em vez da página que contém o portlet
reservado.
v Quando o usuário é redirecionado para outra página de portal para executar a tarefa de autoria, o
usuário é redirecionado para uma página vazia.
Se qualquer um desses problemas ocorrer, verifique se as condições para a operação adequada do portlet
de autoria reservado e da página de portlet oculta estão totalmente implementadas.
Nota: Se o portlet de autoria reservado ou a página do portlet oculta for removida inadvertidamente,
você poderá implementá-los novamente usando a tarefa de configuração action-install-wcm-hiddenauthoring.
Configurando o Portlet de Autoria Reservado
O portlet de autoria reservado é essencial para a operação adequada de páginas de conteúdo da web e
do visualizador de conteúdo da web, portanto, é importante que a configuração do portlet de autoria
reservado reflita as configurações semelhantes para executar tarefas de autoria como a configuração de
outras instâncias do portlet de autoria do IBM Web Content Manager.
1.
2.
3.
4.
5.
Efetue login no portal como administrador.
Clique em Administração na barra de ferramentas.
Em Interface de Usuário do Portal na árvore de navegação, clique em Gerenciar Páginas.
Procure a página com o nome exclusivo com.ibm.wps.hiddenpage.wcm.Authoring_Portlet.
Clique no ícone Editar Layout da Página (lápis pequeno) para a página.
6. Selecione Editar Configurações Compartilhadas no menu do portlet e especifique quaisquer
configurações para o portlet de autoria reservado. As configurações disponíveis e o processo para
atualizá-las são os mesmos para o portlet de autoria reservado, pois eles são para qualquer outra
instância do portlet de autoria.
Nota: As alterações feitas no portlet de autoria reservado com o modo Editar Configurações
Compartilhadas afetam apenas o portlet de autoria reservado e nenhuma outra instância do portlet
de autoria. Para assegurar uma experiência de autoria consistente, é possível fazer as mesmas
mudanças em outras instâncias do portlet de autoria usando o modo Editar Configurações
Compartilhadas para cada instância. Alternativamente, é possível fazer as mesmas alterações em cada
instância do portlet de autoria usando o modo Configurar a partir de uma única instância. As
mudanças feitas no modo Configurar também afetam o portlet de autoria reservado.
7. Salve as alterações.
100
“Controlando o Comportamento dos Componentes de Ferramentas de Autoria” na página 263
Os componentes das ferramentas de autoria renderizados em um visualizador de conteúdo da web
permitem criar, ler, editar, excluir, aprovar ou rejeitar itens de conteúdo diretamente no visualizador de
conteúdo da web, em vez de requererem que você navegue para o portlet de autoria do IBM Web
Content Manager para executar a mesma ação. O visualizador de conteúdo da web ativa uma janela
pop-up que é aberta na página atual ou redireciona o usuário para outra página de portal que contém o
portlet de autoria.
Opções de Configuração Adicionais
Essas opções de configuração estão disponíveis para direcionar os requisitos de instalação para cenários
de implementação adicionais.
Controlando o Acesso a Hosts Especificados em uma URL
Por padrão, você pode especificar qualquer nome do host em uma URL utilizada para recuperar o
conteúdo. Entretanto, é possível restringir o acesso a uma lista especificada de nomes do host,
modificando a configuração do serviço WCM WCMConfigService.
3. Atualize a configuração para bloquear o acesso a hosts desconhecidos. Especifique a seguinte
propriedade:
v Nome da propriedade: connect.connector.httpconnector.denyunknownhosts
v Valor: true
4. Para cada nome de host ao qual deseja conceder acesso, inclua uma nova propriedade. Use o seguinte
formato para novas propriedades:
v Nome da propriedade: connect.connector.httpconnector.hosts.host_name, em que host_name é o
nome completo do host do servidor ao qual você deseja permitir acesso. Por exemplo:
connect.connector.httpconnector.hosts.www.example.com
v Valor: true ou false
5. Opcional: Especifique um valor de expiração de cache padrão para o nome do host incluído incluindo
uma nova propriedade. Use o seguinte formato para novas propriedades:
v Nome da propriedade: connect.connector.httpconnector.hosts.host_name.defaultcacheexpires,
em que host_name é o nome completo do host do servidor ao qual você deseja permitir acesso. Por
exemplo: connect.connector.httpconnector.hosts.www.example.com.defaultcacheexpires
v Valor: expiration_time. Por exemplo: REL 9000s
6. Opcional: Especifique uma configuração de cache padrão para o nome do host incluído incluindo
uma nova propriedade. Use o seguinte formato para novas propriedades:
v Nome da propriedade: connect.connector.httpconnector.hosts.host_name.defaultcache, em que
host_name é o nome completo do host do servidor ao qual você deseja permitir acesso. Por
exemplo: connect.connector.httpconnector.hosts.www.example.com.defaultcacheexpires
v Valor: true ou false
101
“Parâmetros de Expiração de Cache” na página 232
obrigatório.
Variáveis de Substituição do Conteúdo da Web
O IBM Web Content Manager utiliza diversas variáveis de substituição definidas na configuração do IBM
WebSphere Application Server.
Se for necessário modificar essas variáveis, use o WebSphere Integrated Solutions Console para o servidor
de aplicativos. Se você estiver trabalhando com uma célula gerenciada ou um cluster, use o WebSphere
Integrated Solutions Console do gerenciador de implementação ao fazer mudanças.
Tabela 22. Variáveis de Substituição do Conteúdo da Web
Variável
Descrição
WCM_CONTEXT_ROOT
A raiz de conteúdo do aplicativo corporativo do Web
Content Manager.
Exemplo: wps/wcm
WCM_HOST
O nome completo do host da máquina que executa o
portal.
Exemplo: www.example.com
WCM_ILWWCM_HOME
Esse é o diretório no qual o aplicativo Web Content
Manager está instalado
Exemplo: PortalServer_root/wcm
WCM_PORT
O número da porta utilizada para acessar o portal.
Exemplo: 10038
WCM_SCHEMA
O nome do esquema do banco de dados do domínio JCR
configurado para uso com o IBM WebSphere Portal.
Exemplo: jcr
WCM_SEARCHSEED_CONTEXT_ROOT
A raiz de contexto do portlet Search Seed.
Exemplo: wps/wcmsearchseed
WCM_WEB_APP_HOME
O caminho do diretório no qual o arquivo ilwwcm.war
está localizado.
Exemplo: was_profile_root/wp_profile/installedApps/
node_name/wcm.ear/ilwwcm.war
Exemplo: was_profile_root/installed_apps/cell-name/
wcm.ear/ilwwcm.war
102
Tabela 22. Variáveis de Substituição do Conteúdo da Web (continuação)
Variável
Descrição
WCM_WPS_CONTEXT_ROOT
A raiz do contexto ou o URI base do portal. Todas as
URLs que começam com este caminho serão reservadas
para o portal.
Exemplo: wps
http://hostname.example.com:10038/wps/portal
WCM_WPS_DEFAULT_HOME
A página padrão do portal. Esta é a página para usuários
que não estão com login efetuado.
Exemplo: portal
http://hostname.example.com:10038/wps/portal
WCM_WPS_PERSONALIZED_HOME
A página do portal para usuários que já efetuaram login
no portal. Essa página não pode ser acessada por
usuários anônimos.
Exemplo: myportal
http://hostname.example.com:10038/wps/myportal
Ativando Tags Connect
Ative as tags de conexão para fazer referência aos componentes de conteúdo da Web e aplicar
armazenamentos em cache customizados aos componentes.
3. Especifique as propriedades connect.businesslogic para processar tags de conexão de qualquer host
ou de hosts específicos.
Processar tags de conexão de qualquer host
Inclua a seguinte propriedade:
v Nome da propriedade: connect.businesslogic.processunknownhosts
v Valor: true
Processar tags de conexão de hosts específicos
Inclua a seguinte propriedade:
v Nome da propriedade: connect.businesslogic.processunknownhosts
v Valor: false
Para cada host para o qual deseja ativar o processamento, inclua uma nova propriedade:
v Nome da propriedade: connect.businesslogic.hosts.hostname
v Valor: true
4. Reinicie o servidor ou o cluster.
103
Tarefa de Configuração Remover Autoria
A tarefa de configuração Remover Autoria desinstalará o portlet de autoria e as páginas de portal
relacionadas.
Executando a tarefa de configuração:
Para remover o portlet de Autoria:
1. Pare o servidor.
2. Abra um prompt de comandos
3. Abra uma sessão telnet no servidor de portal.
4. Execute a tarefa remove-wcm-authoring a partir do diretório wp_profile_root/ConfigEngine.
Janelas
ConfigEngine.bat remove-wcm-authoring -DWasPassword=password
UNIX ./ConfigEngine.sh remove-wcm-authoring -DWasPassword=password
IBM i ConfigEngine.sh remove-wcm-authoring -DWasPassword=password
z/OS
./ConfigEngine.sh remove-wcm-authoring -DWasPassword=password
Ativando E-mail
Para usar a ação de fluxo de trabalho de e-mail, você deve configurar o Web Content Manager para usar
seu servidor SMTP.
3. Especifique propriedades connect.connector.mailconnect para usar seu servidor SMTP. Inclua as
seguintes propriedades:
Servidor SMTP padrão
v Nome da propriedade: connect.connector.mailconnector.defaultsmtpserver
v Valor: mail.yourmailserver.com
Endereço de e-mail padrão para o campo "de"
v Nome da propriedade: connect.connector.mailconnector.defaultfromaddress
v Valor: [email protected]
Endereço de e-mail padrão para o campo "responder para"
v Nome da propriedade: connect.connector.mailconnector.defaultreplytoaddress
v Valor: [email protected]
4. Se você usar um servidor SMTP assegurado, também precisará especificar um nome de usuário e
senha para acessar o servidor SMTP: Inclua as seguintes propriedades:
Nome do usuário padrão
v Nome da propriedade: connect.connector.mailconnector.defaultusername
v Valor: username
104
Senha padrão
v Nome da propriedade: connect.connector.mailconnector.defaultpassword
v Valor: password
5. Salve as alterações.
6. Reinicie o portal para que as novas configurações sejam efetivadas.
Configurando Páginas Gerenciadas
Quando você executa uma nova instalação do IBM WebSphere Portal 8.0, as páginas gerenciadas são
ativadas por padrão. No entanto, você também pode desativar e ativar manualmente o recurso conforme
necessário.
Nota de migração: Se você migrar de uma versão anterior, páginas gerenciadas serão desativadas por
padrão, mas poderá ativar o recurso após a migração.
Ativando Páginas Gerenciadas
Por padrão, o suporte para páginas gerenciadas é ativado para o portal virtual padrão. No entanto, você
também pode ativar manualmente esse suporte se as páginas gerenciadas estiverem desativadas.
Importante: Não tente ativar as páginas gerenciadas em um servidor no qual páginas gerenciadas já
estão ativadas. Se você desativou anteriormente páginas gerenciadas e deseja reativar o recurso, deverá
garantir que a biblioteca de sites do portal esteja vazia primeiro. Se houve falha ao remover artefatos de
páginas da configuração anterior, o portal resultante poderá não funcionar corretamente.
Quando o suporte para páginas gerenciadas estiver ativado em um portal virtual, todas as páginas no
portal virtual serão copiadas na biblioteca de sites do portal em IBM Web Content Manager. No entanto,
as seguintes páginas não são tratadas como páginas gerenciadas e não são copiadas:
v Páginas de administração, conforme identificadas pelo rótulo ibm.portal.Administration e seu filhos
v Páginas particulares
Cada portal virtual tem sua própria biblioteca de sites do portal.
Nota: Para usufruir das vantagens dos recursos disponíveis para as páginas gerenciadas na interface com
o usuário, suas páginas deverão usar o tema do Portal 8.0.
1. Inicie o servidor de portal.
2. Para ativar o suporte para páginas gerenciadas, execute a tarefa enable-managed-pages a partir do
diretório wp_profile_root/ConfigEngine.
Janelas
ConfigEngine.bat enable-managed-pages -DPortalAdminPwd=password
-DWasPassword=password
AIX, Linux Solaris
./ConfigEngine.sh enable-managed-pages -DPortalAdminPwd=password
IBM i ConfigEngine.sh enable-managed-pages -DPortalAdminPwd=password -DWasPassword=password
z/OS
./ConfigEngine.sh enable-managed-pages -DPortalAdminPwd=password
105
Depois de executar a tarefa enable-managed-pages pela primeira vez, a propriedade managed.pages é
criada no serviço de configuração WP WPConfigService. O valor da propriedade é configurado como
true.
3. Reinicie o servidor de portal.
4. Para preencher bibliotecas de conteúdo da web com informações sobre portais virtuais no sistema,
execute a tarefa create-virtual-portal-site-nodes a partir do diretório wp_profile_root/
ConfigEngine. Para cada portal virtual, essa tarefa cria uma biblioteca e uma área de site chamada
lost-found para recursos que não podem ser localizados adequadamente. Se a biblioteca ou a área de
site existir, a tarefa sairá. Por padrão, a tarefa é executada em todos os portais virtuais do sistema.
Janelas
ConfigEngine.bat create-virtual-portal-site-nodes -DPortalAdminPwd=password
AIX, Linux Solaris
./ConfigEngine.sh create-virtual-portal-site-nodes -DPortalAdminPwd=password
IBM i ConfigEngine.sh create-virtual-portal-site-nodes -DPortalAdminPwd=password
z/OS
./ConfigEngine.sh create-virtual-portal-site-nodes -DPortalAdminPwd=password
5. Para preencher bibliotecas de conteúdo da web com informações sobre as páginas do portal no
sistema, execute a tarefa create-page-nodes a partir do diretório wp_profile_root/ConfigEngine.
Essa tarefa também pode ser usada quando as páginas do portal e os artefatos das páginas
gerenciadas no Web Content Manager não estão sincronizados. Neste caso, a tarefa tenta
ressincronizar os artefatos do portal e os artefatos de conteúdo da web, dando precedência aos
artefatos do portal.
Nota sobre Desempenho: Dependendo da quantidade de informações no sistema, a execução da
tarefa create-page-nodes pode demorar muito. Por causa do carregamento de banco de dados da
tarefa, não é recomendada a execução da tarefa com frequência. A execução inicial da tarefa requer a
maior parte do tempo, enquanto que execuções subsequentes geralmente requerem menos tempo.
Janelas
ConfigEngine.bat create-page-nodes -DPortalAdminPwd=password -DWasPassword=password
AIX, Linux Solaris
./ConfigEngine.sh create-page-nodes -DPortalAdminPwd=password -DWasPassword=password
IBM i ConfigEngine.sh create-page-nodes -DPortalAdminPwd=password -DWasPassword=password
z/OS
./ConfigEngine.sh create-page-nodes -DPortalAdminPwd=password -DWasPassword=password
Por padrão, esta tarefa é executada em todas as páginas em todos os portais virtuais. Para limitar esta
tarefa em um portal virtual específico, identifique o portal virtual incluindo um dos seguintes
parâmetros na linha de comandos. Cada parâmetro exige o prefixo -D na linha de comandos.
VirtualPortalHost
Especifique o nome do host do portal virtual. Por exemplo, vp.example.com.
Importante: Se o nome de host do portal virtual for igual ao nome de host do portal virtual
padrão, você também deverá especificar a propriedade VirtualPortalContext. É possível
especificar a propriedade VirtualPortalHost por ela mesma apenas se o nome de host for
exclusivo.
VirtualPortalContext
Especifique o contexto de portal virtual que identifica o portal virtual. Por exemplo, vp1.
106
É possível customizar a tarefa com os parâmetros opcionais a seguir na linha de comandos. Cada
parâmetro exige o prefixo -D na linha de comandos.
RunParallel
Indica se você deseja que a tarefa seja executada com diversos encadeamentos. Um valor de
false indica um encadeamento único e é a configuração padrão.
Um valor true indica diversos encadeamento, conforme especificado pelo gerenciador de
trabalho wpsJcrSyncWorkManager no WebSphere Integrated Solutions Console. Cada
encadeamento requer uma conexão com o banco de dados. Para melhor desempenho,
verifique se o conjunto de conexões com o banco de dados suporta pelo menos todas as
conexões como tendo encadeamentos no conjunto.
Excluded
Especifique uma lista de nomes exclusivos de nós de página para excluir do processo de
criação. A exclusão de uma página também exclui suas páginas filhas. Por padrão, as páginas
de administração do portal (ibm.portal.Administration) são excluídas.
6. Opcional: Se você usou páginas de conteúdo da web antes de ativar páginas gerenciadas, poderá
transferir o conteúdo que está associado a essas páginas na biblioteca de sites do portal. Para obter
detalhes sobre como executar essa transferência, consulte Transferindo Associações de Conteúdo para a
Biblioteca de Sites do Portal
“Transferindo Associações de Conteúdo para a Biblioteca de Sites do Portal” na página 108
Quando você ativa páginas de gerenciamento, todas as páginas de conteúdo da web que você possui são
convertidas em páginas gerenciadas e incluídas na biblioteca de sites do portal. No entanto, o conteúdo
que está associado às páginas de conteúdo da web permanece nas bibliotecas originais. Você pode
transferir esse conteúdo associado à biblioteca de sites do portal com a tarefa internalize-contentmappings.
Desativando Páginas Gerenciadas
Desative o suporte para as páginas gerenciadas executando a tarefa de configuração disable-managedpages.
A desativação de páginas gerenciadas tem os seguintes efeitos:
v Por padrão, cada portal virtual tem sua própria área de trabalho específica na qual o conteúdo é
armazenado. Quando você desativa páginas gerenciadas, apenas uma única área de trabalho do portal
virtual padrão fica disponível. As áreas de trabalho de outros portais virtuais ainda estão ali, mas você
não pode mais acessá-las. Qualquer associação do sistema entre as páginas nesses portais virtuais e
suas respectivas bibliotecas de sites do portal não funcionará mais.
Importante: Para preservar o conteúdo nos outros portais virtuais, você deve importar ou organizar as
bibliotecas no portal virtual padrão antes de desativar as páginas gerenciadas.
v Você ainda pode acessar a biblioteca de sites do portal do portal virtual padrão, mas a biblioteca não
será mais sincronizada automaticamente com a estrutura de página.
v As páginas não serão mais gerenciadas no IBM Web Content Manager, com as seguintes implicações:
– Nenhum rascunho de página poderá ser criado.
– Nenhuma nova versão das páginas poderá ser criada.
– As páginas não serão mais organizadas.
– As mudanças de controle de acesso executadas na interface do portal não serão mais aplicadas à
área de site da página do portal.
– Se você excluir uma página da interface do portal, a área de site da página do portal correspondente
não será excluída.
v Se você criar uma página com o modelo de página Básico ou Artigos, a página não terá nenhuma
associação do conteúdo da web. Essa associação ausente poderá causar erros se você tentar incluir
107
conteúdo a partir da categoria Conteúdo da Web da guia Conteúdo na barra de ferramentas do site.
Para usar os itens de conteúdo da web de amostra quando páginas gerenciadas estiverem desativadas,
crie uma associação de conteúdo da web na página antes de tentar incluir conteúdo.
1. Execute a tarefa disable-managed-pages a partir do diretório wp_profile_root/ConfigEngine.
Janelas
ConfigEngine.bat disable-managed-pages -DPortalAdminPwd=password
AIX, Linux Solaris
./ConfigEngine.sh disable-managed-pages -DPortalAdminPwd=password
IBM i ConfigEngine.sh disable-managed-pages -DPortalAdminPwd=password
z/OS
./ConfigEngine.sh disable-managed-pages -DPortalAdminPwd=password
Depois de executar a tarefa disable-managed-pages pela primeira vez, a propriedade managed.pages
será criada no serviço de configuração WP WPConfigService. O valor da propriedade é configurado
como false.
2. Reinicie o servidor de portal.
Transferindo Associações de Conteúdo para a Biblioteca de Sites do
Portal
Quando você ativa páginas de gerenciamento, todas as páginas de conteúdo da web que você possui são
convertidas em páginas gerenciadas e incluídas na biblioteca de sites do portal. No entanto, o conteúdo
que está associado às páginas de conteúdo da web permanece nas bibliotecas originais. Você pode
transferir esse conteúdo associado à biblioteca de sites do portal com a tarefa internalize-contentmappings.
Nota: Não se pretende que páginas de administração sejam páginas gerenciadas e, portanto, elas não são
incluídas quando você ativa páginas gerenciadas.
Ao transferir a associação de conteúdo para uma página na biblioteca de sites do portal, ocorrem diversas
situações:
v O conteúdo que é referido pela associação de conteúdo padrão da página é copiado para a área de site
da página do portal da página. Apenas a associação de conteúdo padrão é afetada; outras associações
de conteúdo da página são ignoradas.
Nota: Páginas aninhadas não são copiadas. Áreas de sites aninhadas não são copiadas nos seguintes
casos:
– A área de site aninhada é referida pela associação padrão de outra pagina.
– A área de site aninhada tem o mesmo nome de uma área de site existente na mesma página.
v Mapeamentos de modelo e elementos de conteúdo existentes na área de site associada são copiados na
página do portal. Se o mapeamento de modelo ou elemento já existir para a página, a cópia não será
executada.
v A configuração de conteúdo padrão da página do portal é modificada para a referência do conteúdo
copiado.
v A configuração de qualquer visualizador de conteúdo da web na página é atualizada para fazer
referência ao conteúdo que está armazenado na área de site da página do portal. No entanto,
configurações do visualizador que usam caminhos de conteúdo não serão afetadas.
Para transferir associações de conteúdo, execute a tarefa internalize-content-mappings a partir do
diretório wp_profile_root/ConfigEngine.
108
Janelas
ConfigEngine.bat internalize-content-mappings -DPortalPage=target_page
-DIncludeDescendants=true_or_false -DSynchronous=true_or_false -DPortalAdminPwd=password
AIX, Linux Solaris
./ConfigEngine.sh internalize-content-mappings -DPortalPage=target_page
IBM i ConfigEngine.sh internalize-content-mappings -DPortalPage=target_page
z/OS
./ConfigEngine.sh internalize-content-mappings -DPortalPage=target_page
As seguintes propriedades devem ser especificadas na linha de comandos ou no arquivo
wkplc.properties.
PortalPage
O ID de objeto ou nome de página exclusivo da página para qual você deseja transferir o
conteúdo. Se a página de destino estiver contida em um portal virtual, você deverá identificar o
portal virtual especificando o parâmetro VirtualPortalContext ou o parâmetro
VirtualPortalHost.
IncludeDescendants
Especifique true para transferir o conteúdo da página de destino e de qualquer página filha. Para
transferir o conteúdo apenas para a página de destino, especifique false. Se não especificado, o
valor padrão será true.
Synchronous
Especifique true para executar a transferência de forma síncrona. Para executar a transferência de
forma assíncrona, especifique false. Se não especificado, o valor padrão será true.
Verbose
Especifique true para efetuar a saída de informações adicionais para o log. Para gerar
informações de log básicas, especifique false. Se não especificado, o valor padrão será false.
VirtualPortalContext
Especifique o contexto de portal virtual que identifica o portal virtual. Por exemplo, vp1.
VirtualPortalHost
Especifique o nome do host do portal virtual. Por exemplo, vp.example.com.
Importante: Se o nome de host do portal virtual for igual ao nome de host do portal virtual
padrão, você também deverá especificar a propriedade VirtualPortalContext. É possível
especificar a propriedade VirtualPortalHost por ela mesma apenas se o nome de host for
exclusivo.
PortalAdminPwd
A senha do administrador do WebSphere Portal.
WasPassword
A senha do administrador do WebSphere Application Server.
Comandos de exemplo:
v Janelas: ConfigEngine.bat internalize-content-mappings -DPortalPage=example.page
-DIncludeDescendants=true -DSynchronous=true -DPortalAdminPwd=password -DWasPassword=password
109
v AIX, Linux Solaris: ./ConfigEngine.sh internalize-content-mappings -DPortalPage=example.page
v IBM i: ConfigEngine.sh internalize-content-mappings -DPortalPage=example.page
v z/OS: ./ConfigEngine.sh internalize-content-mappings -DPortalPage=example.page
Propriedades da Organização
É possível padronizar o comportamento da organização do seu ambiente de conteúdo da Web alterando
definições de configuração, como o intervalo da organização e a organização automática.
Você define e gerencia opções de organização no serviço WCM WCMConfigService usando o WebSphere
Alterando o Intervalo de Sindicância
Embora a frequência de sindicância seja definida por padrão durante a instalação, é possível alterar o
intervalo de sindicância para melhor atender às necessidades do seu ambiente.
Por exemplo, você pode reduzir o intervalo em um ambiente de autoria ativo em que os usuários devem
colaborar bastante e contar com a replicação adequada. De maneira semelhante, é possível aumentar o
intervalo para permitir replicação excessiva de dados que não são alterados com frequência.
Nota: O intervalo de sindicância aplica-se a todas as operações de sindicância e não pode ser
especificado separadamente em pares diferentes de executor da syndicator-assinante.
Para alterar o intervalo de organização, modifique a propriedade deployment.itemChangedTaskDelay. Por
padrão, o intervalo de sindicância é definido como 30 segundos. Especifique o número de segundos a ser
utilizado como o intervalo de sindicância, com um mínimo de 0 segundos e um máximo de 65.536
segundos. Um valor de 0 evitará que ocorra a sindicância. Se você definir o valor para um intervalo
muito reduzido de modo que a sindicância não possa ser concluída antes que ele expire, a sindicância
começará novamente quando a sindicância anterior for concluída.
Desativando a Sindicância Automática
Em alguns casos, você poderá optar por contar apenas com a sindicância manual para ter controle
completo sobre quando ocorre a sindicância. Para fazer isso, desative a sindicância automática. Quando a
organização automática está desativada, a configuração de intervalo de organização é ignorada. Essa
propriedade deve ser definida como o mesmo valor no organizador e no assinante.
Para desativar a organização automática, especifique a seguinte propriedade:
v Nome da propriedade: connect.moduleconfig.syndication.inittasks
v Valor: false
Configurando um Servidor Somente Assinante
Um servidor syndicator utiliza diversos processos para reunir e enfileirar conteúdo para sindicância.
Esses processos às vezes podem causar impacto sobre o desempenho do servidor quando da execução.
Entretanto, um servidor somente assinante não exige esses processos, de modo que você pode aprimorar
o desempenho no servidor somente assinante desativando os processos.
Para fazer isso, verifique se a propriedade deployment.subscriberOnly está configurada para true.
110
Ativando a Organização Segura Usando SSL
Para ativar e usar SSL na organização, as seguintes propriedades devem ser alteradas no WCM
WCMConfigService para usar o protocolo "https" e a porta apropriada.
v deployment.itemDispatcherUrl
v deployment.syndicatorUrl
v deployment.subscriberUrl
v
Ativando a Procura para o Conteúdo da Web
Use a Procura de Portal para procurar o texto exibido em sites da Web criados por IBM Web Content
Manager.
Indexando Conteúdo da Web
Para procurar conteúdo da Web, o seu conteúdo deve primeiro ser indexado pelo mecanismo de procura
do WebSphere Portal. Depois que o conteúdo for indexado, será possível executar procuras usando o
centro de procura ou usando um componente de procura. Se você procurar por documentos no centro de
procura do WebSphere Portal, esteja ciente de que verá resultados de procura apenas de documentos
publicados. Mudanças pendentes não publicadas em um projeto não serão incluídas nos resultados.
Criando uma Fonte de Conteúdo em uma Área de Site
O mecanismo de procura do WebSphere Portal define as fontes de conteúdo que indexam o seu conteúdo
da Web. Todas as áreas de site e itens de conteúdo filhos da área de site selecionada serão incluídos no
índice. As fontes de conteúdo relacionadas são agrupadas em uma coleta de procura.
1. Vá para Administração > Administração de Procura > Gerenciar Procura.
2. Selecione ou crie uma nova coleta. A coleta de procura padrão chamada WebContentCollection é
fornecida por padrão.
3. Clique em Nova Fonte de Conteúdo.
4. Selecione Site WCM como o tipo de fonte de conteúdo.
5. Insira um nome no campo Nome da Fonte de Conteúdo.
6. Insira a seguinte URL no campo Coletar documentos vinculados a partir desta URL:
Para um servidor independente:
http://hostname:port_number/wps/seedlist/myserver?SeedlistId=library/sitearea1/childsitearea2
&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Você precisará substituir hostname, port_number, library e site area pelos valores
apropriados para o seu site. Se o seu nome de biblioteca ou nome de área de site contiver
espaços, será necessário substituir os espaços por um símbolo "+". Por exemplo, o caminho
library one/site area one seria definido como library+one/site+area+one
Para um cluster:
Nesse caso, você usa o host e a porta do servidor HTTP:
http://httpserver:port_number/wps/seedlist/myserver?SeedlistId=library/sitearea1/childsitearea2
Você precisará substituir httpserver, port_number, library e site area por valores
111
Para um portal virtual configurado para usar o Contexto da URL como seu ponto de acesso:
http://httpserver:port_number/wps/seedlist/myserver/virtualPortalContext?SeedlistId=library/sitearea1/childsitearea2
Você precisará substituir httpserver, port_number, virtualPortalContext, library e site area
com valores apropriados para o seu site. Se o seu nome de biblioteca ou nome de área de site
contiver espaços, será necessário substituir os espaços por um símbolo "+". Por exemplo, o
caminho library one/site area one seria definido como library+one/site+area+one
Para um portal virtual configurado para usar um nome do host diferente como seu ponto de
acesso:
http://vphostname:port_number/wps/seedlist/myserver/?SeedlistId=library/sitearea1/childsitearea2
Você precisará substituir vphostname, port_number, library e site area com valores
Nota: O ID da lista de valores iniciais pode ser algum dos seguintes:
v biblioteca
v biblioteca/área de site
v biblioteca/área de site/área de subsite/...
v o JCRID de uma área de site
7. Se o conteúdo a ser indexado for seguro, acesse a guia Segurança e insira o nome de usuário e senha
que serão usadas para acessar o site seguro. Você deve então clicar em Criar na própria guia de
procura.
8. Se o seu site usa ações remotas, será necessário removê-las do índice de procura. Acesse a guia Filtro:
a.
b.
c.
d.
e.
f.
Digite um nome no campo Nome da Regra
Selecione Aplicar regra ao Coletar documentos
Selecione o tipo de regra de Excluir
Selecione a base de regra de Texto URL
Digite *&wcmAuthoringAction=* no campo Texto da URL
Clique em Criar na guia Filtro
9. Clique em Criar.
Se você tiver múltiplas áreas de site pai e desejar que suas procuras sejam executadas em todas as áreas
de site, poderá criar uma fonte de conteúdo para cada uma delas na mesma coleta. Se não desejar que
suas procuras sejam executadas em todas as áreas de site pai, crie uma coleta separada para cada área de
site pai ou grupo de áreas de site pai relacionadas.
Procurando Conteúdo da Web em um Portal Virtual
Os serviços de procura e as coletas de procura são separados para portais virtuais individuais e não são
compartilhados entre portais virtuais individuais. Configure um serviço de procura individual e coletas
de procura separadas para cada portal virtual. Estas coletas podem ser utilizadas para efetuar crawl e
procurar o mesmo conjunto de documentos.
Se estiver usando um Web site que seja compartilhado com vários portais virtuais, então para procurar
esse Web site em um ambiente de portal virtual, você deve:
1. Criar uma nova coleta de procura para o portal virtual. Você pode criar uma nova fonte de conteúdo
copiando a URL da coleta de procura original.
112
2. Crie um novo componente de procura, ou copie um existente, e configure-o para utilizar a nova coleta
de procura do portal virtual criada na etapa 1.
3. Crie um novo formulário de procura, utilizando um componente HTML, configurado para utilizar o
componente de procura criado na etapa 2.
4. Criar um novo item de conteúdo para exibir o componente HTML criado na etapa 3.
Essas etapas deverão ser executadas para cada portal virtual do sistema.
Configurando Opções de Procura do Web Content Manager
Você pode editar as seguintes opções de procura, para gerenciar como o serviço de procura funciona com
os formulários de procura do Web Content Manager
1. Edite o arquivo SearchService.properties.
Local do Arquivo:
Janelas
wp_profile_root/PortalServer/wcm/shared/app/config/wcmservices
UNIX wp_profile_root/PortalServer/wcm/shared/app/config/wcmservices
IBM i wp_profile_root/PortalServer/wcm/shared/app/config/wcmservices
z/OS wp_profile_root/PortalServer/wcm/shared/app/config/wcmservices
2. Especifique valores para os parâmetros de procura.
SearchService.DateFormatString
Isso é utilizado para configurar o formato de data ao inserir as datas nos formulários de
procura e para exibir os resultados da procura. Digite uma cadeia de formatações de datas
Java suportada. Se essa propriedade não estiver configurada, o formato padrão será MMM dd
aaaa HH:mm:ss z.
SearchService.RecrawlInterval
Este é o intervalo de novo crawl, em horas.
SearchService.BrokenLinksExpirationAge
Esse é a idade de expiração de links quebrados padrão, em dias.
SearchService.MetaFields
Utilizada para especificar elementos adicionais a serem submetidos ao crawl durante a
procura de Metadados.
O formato para esse valor de parâmetro é: elementName,key1
Para especificar mais de um mapa de campo de metadados, utilize o seguinte formato:
elementName1,key1;elementName2,key2;elementName3,key3
Por exemplo, para efetuar crawl de Metadados em um nome de elemento denominado
metaText:
v SearchService.MetaFields=metaText,meta
v elementName é o nome do elemento para o qual você gostaria de procurar Metadados.
Qualquer elemento válido com esse nome em uma área de site ou item de conteúdo
pesquisável será submetido ao crawl.
v key é a "chave" especificada em uma tag de elemento utilizada como parte de um design de
elemento de procura. No exemplo anterior, a chave de "meta" foi usada. Para renderizar o
conteúdo do elemento metaText em um design de elemento de procura, você utilizaria a
seguinte tag: <Element context="autoFill" type="content" key="meta"/>
Nota:
v Somente elementos de texto e elementos de texto abreviado podem ser procurados.
113
v Apenas áreas de site que foram configuradas para serem pesquisáveis serão submetidas ao
crawl.
SearchService.SearchSeed.ExcludeFileAttachments=false
Configure isso para "true" para impedir que os anexos do componente de recurso do arquivo
sejam incluídos nos resultados da procura.
Se configurar como false, os arquivos armazenados nos elementos do recurso do arquivo nos
itens de conteúdo também poderão ser procurados. Os arquivos armazenados em elementos
do recurso do arquivo em uma área de site podem ser procurados também contanto que um
item de conteúdo padrão tenha sido selecionado.
3. Salve o arquivo SearchService.properties.
4. Reinicie o portal para que as novas configurações sejam efetivadas.
Configurando o Centro de Procura para Procurar Conteúdo da Web
É possível usar o Centro de Procura para procurar conteúdo da Web incluindo uma coleta de procura de
conteúdo da Web no Centro de Procura.
1. Vá para Administração –> Administração de Procura –> Gerenciar Procura –>Escopos de Procura.
2. Clique em Novo Escopo.
3. Clique em Selecionar Locais e selecione sua coleta de procura de conteúdo da Web.
4. Conclua o escopo da procura e clique em OK.
Efetuando Crawl no Conteúdo da Web com Listas de Valores Iniciais
de Procura
A Procura do Portal suporta o uso de listas de valores iniciais para efetuar crawl de Web sites e seus
metadados de maneira mais eficiente e para fornecer aos proprietários do conteúdo controle detalhado
sobre como o conteúdo e os metadados sofrem crawl. É possível configurar o portal para usar o suporte a
lista de valores iniciais ao efetuar crawl do conteúdo gerado com o IBM Web Content Manager.
Por padrão, a Procura do Portal é configurada para usar o formato da lista de valores iniciais 1.0 ao
indexar o conteúdo para coletas de procura. Quando usado com conteúdo da web, o formato da lista de
valores iniciais 1.0 possibilita utilizar o tipo de página de conteúdo da web para renderizar o conteúdo
encontrado nos resultados da procura na página de conteúdo da web correspondente. Também é possível
incluir campos de metadados customizados a partir de um item de conteúdo da Web que aparecerá na
lista de valores iniciais de procura, mas não na origem de HTML.
A lista de valores iniciais de procura 1.0 pode tornar informações de controle de acesso disponíveis de
uma maneira que torna a pré-filtragem do conteúdo possível. A pré-filtragem fornece a abordagem de
filtragem mais rápida porque ocorre no nível do índice de procura. Uma vantagem adicional da
pré-filtragem é que fontes de conteúdo protegido remoto podem ser procuradas a partir do portal. O
modo de filtragem é definido como parte dos parâmetros de configuração do serviço de procura.
Nota: Suporte para efetuar crawl da lista de valores iniciais genérica 1.0 está disponível apenas com o
IBM OmniFind Enterprise Edition Versão 9.1 e posterior.
Usando o Formato 1.0 da Lista de Valores Iniciais de Procura
A partir da versão 6.1.5, a Procura do Portal está configurada para suportar o formato 1.0 da lista de
valores iniciais de procura do IBM Web Content Manager, por padrão. Versões anteriores à 6.1.5 usam o
formato 0.9 da lista de valores iniciais de procura do Web Content Manager.
A lista de valores iniciais de procura 1.0 fornece vários recursos:
v É possível usar o tipo de página de conteúdo da web para renderizar conteúdo localizado nos
resultados da procura na página de conteúdo correspondente da web.
114
v É possível incluir campos de metadados customizados de um item de conteúdo da web que apareça na
lista de valores iniciais de procura, mas não na origem HTML.
v É possível procurar em uma biblioteca ou uma área de site específica, em todas as bibliotecas de
conteúdo da web, ou em uma lista de bibliotecas.
v É possível executar crawl incremental de bibliotecas para processamento mais rápido da lista de
valores iniciais. Com o crawl incremental, quando um crawl solicita novos itens, apenas aqueles que
foram incluídos, alterados ou excluídos desde o crawl anterior são recuperados.
Importante: A sintaxe da URL da lista de valores iniciais foi alterada com o formato da lista de valores
iniciais 1.0. Coletas de procura mais antigas criadas usando o formato da lista de valores iniciais 0.9 não
podem ser reutilizadas ou migradas para o novo formato. Certifique-se de indexar todo o conteúdo
novamente depois de atualizar o formato da lista de valores iniciais do Web Content Manager de 0.9 para
1.0.
A lista de valores iniciais de procura 1.0 pode tornar informações de controle de acesso disponíveis de
uma maneira que torna a pré-filtragem do conteúdo possível. A pré-filtragem fornece a abordagem de
filtragem mais rápida porque ocorre no nível do índice de procura. Uma vantagem adicional da
pré-filtragem é que fontes de conteúdo protegido remoto podem ser procuradas a partir do portal. O
modo de filtragem é definido como parte dos parâmetros de configuração do serviço de procura.
Ativando o Suporte para a Lista de Valores Iniciais de Procura 1.0:
Se desejar usar a Procura de Portal para efetuar crawl em seu conteúdo da Web e aproveitar recursos
como páginas de conteúdo da Web, será necessário ativar o suporte à lista de valores iniciais 1.0 do
crawler da Procura do Portal.
1. Efetue login no portal como administrador.
2. Clique em Administração na barra de ferramentas.
3. Crie uma nova coleta de procura.
a. Clique em Gerenciar Procura > Coletas de Procura.
b. Crie uma nova coleta de procura para seu conteúdo da Web. Certifique-se de que a nova coleta de
procura usa o serviço de procura do portal editado nas etapas anteriores.
4. Inclua as propriedades customizadas a seguir no ambiente de recursos WP ConfigService usando o
WebSphere Integrated Solutions Console:
a. wcm.config.seedlist.version=1.0
b. wcm.config.seedlist.servletpath=/seedlist
c. wcm.config.seedlist.metakeys=<metakey1>,<metakey2> Esta é uma etapa opcional e só será
necessária se você quiser especificar seus próprios metadados.
Usando o Suporte à Procura de Campo de Metadados Customizado:
Com o suporte da lista de valores iniciais de procura 1.0, os campos de metadados customizados
especificados nos itens de conteúdo são incluídos na lista de valores iniciais de procura como informações
de metadados, sem requerer que os metadados apareçam na origem de HTML para os itens de conteúdo.
3. Clique em WP ConfigService.
115
5. Clique em Novo e insira o nome da propriedade wcm.config.seedlist.metakeys e configure o valor
de cadeia para uma lista delimitada por vírgulas de seus próprios metadados (por exemplo,
<metakey1, metakey2>).
Inclua os nomes do elemento de texto de seu conteúdo que devem ser incluídos nos resultados da
procura na propriedade wcm.config.seedlist.metakeys. Se desejar incluir mais de um elemento de
texto, separe-os com vírgulas. O nome do elemento de texto em seu item de conteúdo que deve ser
incluído na lista de valores iniciais de procura deve corresponder ao nome configurado para esta
chave de configuração.
Por exemplo, defina wcm.config.seedlist.metakeys=language,region no provedor de ambiente de
recurso WP ConfigService e inclua um componente de texto do IBM Web Content Manager como um
elemento com o nome language em um item de conteúdo ou modelo de autoria. Em seu item de
conteúdo é possível inserir o valor german no componente de texto para o idioma. Após salvar o item
de conteúdo, o crawler de procura incluirá o valor german em um campo de metadados chamado
language na lista de valores iniciais de procura. Em seguida, você pode filtrar os resultados da
procura com base em suas informações de metadados.
6. Clique em OK e salve as alterações na configuração principal.
7. Inicie novamente o portal.
API de Serviço REST da Lista de Valores Iniciais 1.0:
A API do IBM Web Content Manager para recuperar o conteúdo do aplicativo através de uma lista de
valores iniciais é baseada no estilo da arquitetura REST. Para obter o conteúdo da lista de valores iniciais,
crawlers de terceiros ou aplicativos do administrador precisam construir e enviar apenas solicitações de
HTTP ao servlet de aplicativo.
Todos os pedidos da API REST são chamadas síncronas. A ordem dos parâmetros nos pedidos não
importa. Os nomes de parâmetros fazem distinção entre maiúsculas e minúsculas e devem ser inseridos
no formato descrito aqui. Uma resposta de erro HTTP (por exemplo, o código de status 404) é gerada nas
seguintes situações:
v Um parâmetro desconhecido ou não suportado é enviado como parte do pedido.
v O Web Content Manager não pode resolver o caminho ou ID da área de site.
v Web Content Manager não pode localizar nenhum item.
v O aplicativo corporativo da lisa de valores iniciais de procura (Seedlist_Servlet) não está em execução.
O pedido é um comando HTTP GET padrão. A URL é formada combinando o nome do host do servlet
da lista de valores iniciais, o número da porta e o caminho, seguida por uma coleção de parâmetros de
entrada separados por caracteres de e comercial (&). Os parâmetros de entrada são inseridos como pares
nome-valor.
Exemplo:
http://host_name:port_number/wps/seedlist/myserver?SeedlistId=library_list&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=action&Range=number_of_entries
library_list
Uma ou mais bibliotecas de conteúdo da web, separados por vírgulas. Se nenhum valor for
especificado, todas as bibliotecas serão usadas.
action
A ação a ser executada na solicitação. As ações a seguir estão disponíveis:
GetDocuments
Recupera uma lista de itens de conteúdo com suas informações associadas.
number_of_entries
Para cada página da lista de valores iniciais que é retornada, esse valor especifica o número de
entradas na lista de itens de conteúdo. Se nenhum valor for especificado, 100 itens serão
retornados.
116
Exemplos
Nesses exemplos, substitua as variáveis a seguir por valores apropriados ao seu ambiente:
v
v
v
v
v
v
v
host_name
virtual_portal_host_name
http_server
port_number
biblioteca
site_area
site_area_id
Para o parâmetro SeedlistId, é possível especificar o valor nos seguintes formatos:
v Nenhum valor
v Uma biblioteca específica (por exemplo, library1)
v Uma área de site específica (por exemplo, site_area1)
v Uma lista de bibliotecas, separadas por vírgulas (por exemplo, library1,library2,library3)
v O JCRID de uma área de site
Recupere no máximo 100 itens de um servidor independente usando o caminho para a área de site
http://host_name:port_number/wps/seedlist/myserver?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Recupere no máximo 200 itens de um servidor independente usando o ID da área de site
http://host_name:port_number/wps/seedlist/myserver?SeedlistId=site_area_id&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments&Range=200
Recupere no máximo 100 itens de uma biblioteca específica
http://host_name:port_number/wps/seedlist/myserver?SeedlistId=library&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Recupere no máximo 100 itens de todas as bibliotecas
Nota: Para usar todas as bibliotecas, deixe o valor SeedlistId vazio.
http://host_name:port_number/wps/seedlist/myserver?SeedlistId=&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Recupere no máximo 100 itens de uma lista especificada de bibliotecas
http://host_name:port_number/wps/seedlist/myserver?SeedlistId=library1,library2&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Recupere no máximo 100 itens de um cluster
Nota: Ao referenciar um cluster, especifique a solicitação com o nome do host e o número da
porta do servidor HTTP.
http://http_server:port_number/wps/seedlist/myserver?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Recupere no máximo 100 itens de uma porta virtual configurada para usar o contexto de URL como
ponto de acesso
http://http_server:port_number/wps/seedlist/myserver/virtual_portal_context?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Recupere no máximo 100 itens de uma porta virtual configurada para usar um nome de host diferente
como ponto de acesso
http://virtual_portal_host_name:port_number/wps/seedlist/myserver?SeedlistId=library/site_area&Source=com.ibm.workplace.wcm.plugins.seedlist.retriever.WCMRetrieverFactory&Action=GetDocuments
Importante: É possível acessar a API REST para a lista de valores iniciais 1.0 de procura do Web Content
Manager com uma conexão segura (HTTPS) ou com uma conexão descoberta (HTTP). Dependendo do
método, assegure-se de usar a porta correta. Entretanto, se você acessar esta API REST com uma conexão
descoberta, será automaticamente redirecionado para uma conexão segura.
117
Parâmetro
Valor Padrão
Descrição
SeedlistID
Nenhum padrão; deve ser
especificado.
Identifica a lista de valores iniciais. Esse parâmetro pode
ser especificado das seguintes maneiras:
v Um valor vazio faz com que todas as bibliotecas
sejam usadas.
v Uma biblioteca específica (por exemplo, library1)
v Uma área de site específica (por exemplo, site_area1)
v Uma lista de bibliotecas, separadas por vírgulas, por
exemplo
library1,library2,library3
v O JCRID de uma área de site
Iniciar
0
Define o número de início para a seção retornada
atualmente.
Intervalo
100
Define o número de entradas retornadas para a seção
atual.
Data
Nenhum padrão. Se não especificado, Indica que entradas (documentos) que foram atualizadas
todos os resultados aplicáveis são
após esta data são recuperadas. O formato de data
retornados.
(compatível com o padrão ISO 8601) é o seguinte :
dateTtimezone, em que date é yyyy-MM-dd, time é
HH:mm:ss e zone é ±hhmm. Este formato inclui
informações de fuso horário, que são críticas se o cliente
e servidor estiverem em fusos horários diferentes.
Importante: A codificação de URL HTML adequada
deve ser executada (por exemplo, representar o símbolo
de mais + como %2B).
Ações
GetDocuments
Define a ação solicitada para execução.
v GetDocuments recupera todos os documentos
subjacentes.
v GetNumberOfDocuments retorna o número de todos
os documentos subjacentes, geralmente para
propósitos de depuração. Este valor deve ser o
mesmo que o número de todos os documentos
retornados de um pedido GetDocuments apropriado.
Formato
ATOM
Registro de Data e Nenhum padrão.
Hora
Define o formato de saída : ATOM / HTML/ XML.
Indica o registro de data e hora do provedor de
conteúdo a partir de uma sessão de crawling anterior. O
registro de data e hora representa para o provedor de
conteúdo alguma captura instantânea do conteúdo e
permite que o crawler obtenha apenas as alterações de
conteúdo no próximo crawl. Esse parâmetro é usado
para crawl incremental.
Usando a Lista de Valores Iniciais de Procura 0.9
Embora a Procura do Portal seja configurada para suportar, por padrão, o formato da lista de valores
iniciais de procura 1.0, é possível reconfigurar o portal para usar o formato da lista de valores iniciais
padrão 0.9 ao procurar conteúdo da Web com o Centro de Procura. Por exemplo, você pode optar por
usar o formato da lista de valores iniciais 0.9 porque deseja fazer uso das coletas de procura antigas ou
porque você recupera o conteúdo da lista de valores iniciais 0.9 usando a URL da lista de valores iniciais,
que usa uma sintaxe diferente da URL usada com o formato da lista de valores iniciais de procura 1.0.
Importante: Com o IBM WebSphere Portal Versão 7, o formato da lista de valores iniciais de procura 0.9
é reprovado. Embora você ainda possa usar o formato da lista de valores iniciais 0.9, é recomendado que
você faça a transição para o formato da lista de valores iniciais 1.0 para garantir compatibilidade futura.
118
Para usar o formato da lista de valores iniciais 0.9, você, essencialmente, desativa o suporte padrão para o
formato da lista de valores iniciais 1.0.
1. Efetue login no portal como administrador.
2. Clique em Administração na barra de ferramentas.
3. Desative o suporte da lista de valores iniciais de procura 1.0 para IBM Web Content Manager.
a. Efetue login no WebSphere Integrated Solutions Console (http://hostname.example.com:10027/
ibm/console).
b. Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos.
c. Clique em WP ConfigService.
d. Em Propriedades Adicionais, clique em Propriedades Customizadas.
e. Remova a propriedade denominada wcm.config.seedlist.version.
f. Remova a propriedade denominada wcm.config.seedlist.servletpath.
g. Se ela existir, remova a propriedade denominada wcm.config.seedlist.metakeys.
h. Clique em OK e salve as alterações na configuração principal.
i. Inicie novamente o portal.
Gerenciando a Identificação e a Classificação no Conteúdo da Web
Ao usar a identificação e a classificação com o conteúdo da web, o visualizador de conteúdo da web
fornece opções de escopo adicionais para a filtragem de resultados de identificação e classificação. Como
as alterações no sistema de conteúdo da Web podem afetar a precisão das informações de identificação e
classificação usadas pelo portal, é importante manter as informações de escopo atualizadas sincronizando
os escopos regularmente.
“Identificando e Classificando Plug-ins para Conteúdo da Web” na página 238
Da mesma forma que é possível identificar e classificar recursos do portal como páginas e portlets,
também é possível identificar e classificar itens de conteúdo gerados com o IBM Web Content Manager e
exibidos com o visualizador de conteúdo da web. Dois componentes de plug-in estão disponíveis para
suportar a identificação e a classificação de itens de conteúdo em seu sistema de conteúdo da Web. É
possível incluir os componentes [Plugin:tags] e [Plugin:ratings] em um modelo de apresentação para
integrar com rapidez os widgets de identificação e classificação no item de conteúdo atual.
Usando Identificação e Classificação de Escopos com Conteúdo da
Web
A definição de escopo é geralmente usada para filtrar a nuvem de tag ou a visão geral das classificações,
de acordo com os metadados hierárquicos anexados aos recursos que estão sendo identificados. Ao
aplicar a identificação e a classificação ao conteúdo da Web, é possível criar o escopo desses componentes
de exibição, de acordo com o modelo de autoria, a categoria ou o pai do item de conteúdo.
É possível configurar as definições avançadas do visualizador de conteúdo da web para limitar os
resultados para mostrar apenas identificações ou classificações associadas a um ou mais dos escopos a
seguir:
v O pai do item de conteúdo que está sendo exibido (por exemplo, uma área de site).
v O modelo de autoria que é usado para gerar o item de conteúdo ou a área de site que está sendo
exibida.
v As categorias usadas para criar o perfil do item de conteúdo que está sendo exibido. Dessa maneira, é
possível gerenciar escopos a partir do sistema de conteúdo da Web definindo taxonomias para seus
itens de conteúdo.
119
“Sincronizando Escopos para o Conteúdo da Web”
Quando os usuários estão identificando ou classificando o conteúdo da web, o visualizador de conteúdo
da web fornece as informações de identificação ou classificação para o portal, em que ele está
armazenado. Se as informações do sistema de conteúdo da Web forem alteradas, isso poderá fazer com
que as informações de identificação e classificação armazenadas no portal fiquem fora de sincronização.
Isso pode acontecer, por exemplo, se os itens de conteúdo forem movidos ou se as informações sobre a
categoria forem alteradas. Para garantir que as informações de identificação e classificação estejam
atualizadas, sincronize os escopos usados no conteúdo da Web. É possível configurar a sincronização
automática de acordo com diferentes condições ou executar uma sincronização manual, conforme for
necessário.
Sincronizando Escopos para o Conteúdo da Web
necessário.
Sincronizando Escopos Quando Itens Forem Alterados
Para executar automaticamente a sincronização de escopo sempre que um item for alterado no sistema de
conteúdo da Web, especifique a propriedade
tagging.syndication.enableItemModificationSynchronization no serviço de configuração do Web
Content Manager.
Nota: Esse tipo de sincronização funciona apenas para alterações de itens individuais. Por exemplo, esse
tipo de sincronização não é executado automaticamente quando uma área de site ou uma pasta inteira for
movida. Para sincronizar escopos após tais alterações, é possível executar a sincronização manualmente.
1. Efetue login no WebSphere Integrated Solutions Console (http://hostname.example.com:10027/ibm/
console).
5. Inclua a propriedade tagging.syndication.enableItemModificationSynchronization.
a. Clique em Novo e insira o nome da propriedade
tagging.syndication.enableItemModificationSynchronization.
b. Defina o valor da cadeia como true.
7. Reinicie o portal.
Sincronizando Escopos Após a Organização
Para executar automaticamente a sincronização de escopo sempre que ocorrer uma organização,
especifique a propriedade tagging.syndication.enableTagSynchronization no serviço de configuração do
Web Content Manager.
120
1. Efetue login no WebSphere Integrated Solutions Console (http://hostname.example.com:10027/ibm/
console).
5. Inclua a propriedade tagging.syndication.enableTagSynchronization.
a. Clique em Novo e insira o nome da propriedade tagging.syndication.enableTagSynchronization.
b. Defina o valor da cadeia como true.
7. Reinicie o portal.
Planejando a Sincronização de Escopo
É possível planejar a sincronização de escopo a ser executada em horários específicos, definindo o
planejamento com a interface de configuração de XML.
1. Verifique se alguma sincronização planejada já foi definida para o portal.
a. Crie um arquivo de exportação que possa ser usado com o comando xmlaccess. Este é um
exemplo de um pedido que pode ser usado para consultar a configuração atual:
<?xml version="1.0" encoding="UTF-8"?>
<request type="export" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="PortalConfig_8.0.0.xsd">
<portal action="locate">
<task action="export" name="com.ibm.portal.cp.SynchronizationTask"/>
</portal>
</request>
b. Execute o comando xmlaccess, especificando o arquivo de exportação. O arquivo de saída
resultante contém todos os horários de sincronização planejada definidos no portal.
2. Defina o planejamento da sincronização.
a. Para definir um horário para uma sincronização planejada, crie um documento de pedido de
XML. Por exemplo, para planejar que uma sincronização ocorra diariamente às 15h36, você
deveria usar um pedido como este:
<request type="update" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<task action="create" name="com.ibm.portal.cp.SynchronizationTask">
<startTime>15:36</startTime>
</task>
</portal>
</request>
Para cada sincronização planejada, crie um elemento task separado e especifique o horário com
um elemento startTime.
b. Execute o comando xmlaccess, especificando o arquivo que contém o pedido de planejamento. As
informações de escopo do sistema de conteúdo da Web serão então sincronizados
automaticamente, de acordo com o planejamento definido.
3. Opcional: Se você desejar definir um horário mínimo antes de as sincronizações subsequentes serem
executadas, especifique a propriedade tagging.syndication.minimumTagSynchronizationTimeInterval
no serviço de configuração do Web Content Manager.
a. Efetue login no WebSphere Integrated Solutions Console (http://hostname.example.com:10027/
ibm/console).
b. Clique em Recursos > Ambiente de Recursos > Provedores de Ambientes de Recursos.
c. Clique em WP ConfigService.
121
d. Em Propriedades Adicionais, clique em Propriedades Customizadas.
e. Clique em Novo e insira o nome da propriedade
tagging.syndication.minimumTagSynchronizationTimeInterval.
f. Defina o valor da cadeia como o número de segundos entre as sincronizações.
g. Clique em OK e salve as alterações na configuração principal.
h. Reinicie o portal.
Trabalhando com a Interface de Configuração do XML
Referência de Configuração do XML
Sincronizando Escopos Manualmente
Se você não ativou a sincronização automática dos escopos usados para o conteúdo da Web ou se desejar
executar a sincronização fora de um período de sincronização planejado, poderá iniciar manualmente o
processo de sincronização.
Para executar a sincronização manualmente, execute a tarefa de configuração cp-sync ou envie um
pedido de XML ao portal usando a interface de configuração XML.
v Para executar a sincronização com uma tarefa de configuração, execute a seguinte tarefa a partir do
diretório wp_profile_root/ConfigEngine:
– Janelas: ConfigEngine.bat cp-sync -DWasPassword=password -DPortalAdminPwd=password
– UNIX: ./ConfigEngine.sh cp-sync -DWasPassword=password -DPortalAdminPwd=password
– IBM i: ConfigEngine.sh cp-sync -DWasPassword=password -DPortalAdminPwd=password
– z/OS: ConfigEngine.sh cp-sync -DWasPassword=password -DPortalAdminPwd=password
v Crie um arquivo de pedido de XML e envie-o usando o comando xmlaccess. Este é um exemplo de um
pedido que pode ser usado para iniciar a sincronização:
<request type="update" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<task action="create" name="com.ibm.portal.cp.SynchronizationTask"/>
</portal>
</request>
Trabalhando com a Interface de Configuração do XML
122
Configurando um Site
Configurar um site inclui customizar a aparência do site, criar páginas e incluir
conteúdo no site. Também é possível incluir wikis e blogs em seu site e permitir que os usuários
identifiquem e classifiquem o conteúdo no site.
Barra de Ferramentas do Site
A barra de ferramentas do site fornece acesso a recursos usados regularmente para páginas gerenciadas a
partir de um local central. As principais tarefas que podem ser executadas incluem trabalhar com
projetos, incluir e editar conteúdo, alterar propriedades da página e customizar estilo e layout.
Nota:
v A barra de ferramentas do site requer o tema do Portal 8.0.
v Dependendo do nível de autorização do usuário, algumas opções da barra de ferramentas podem não
ser exibidas. Por exemplo, para usuários sem acesso de edição à página, a barra de ferramentas não
inclui os links para especificar o modo de visualização ou edição.
Modo de Visualização
Figura 21. Barra de Ferramentas do Site Exibida no Modo de Visualização.
A barra de ferramentas é inicialmente exibida no modo de visualização e fornece informações básicas
sobre a página e o acesso a tarefas de autoria.
1. Estão incluídos links para áreas principais do portal, permitindo acesso rápido aos aplicativos, como o
portlet de autoria.
2. Com os links Modo de Edição e Modo de Visualização, é possível especificar o modo para a página.
O modo de visualização mostra o estado do rascunho do projeto selecionado atualmente. O modo de
edição permite modificar a página e seu conteúdo como parte do projeto selecionado atualmente.
3. O menu de projetos exibe o projeto selecionado atualmente. As mudanças na página ou no conteúdo
da página são feitas como mudanças no rascunho, e são associadas ao projeto selecionado. O menu de
projetos fornece vários recursos adicionais:
v Para alterar rapidamente os projetos, o menu lista os cinco projetos mais recentes associados à
página e que continuam ativos.
v A opção Site Publicado limpa o projeto atual e exibe a versão publicada da página. Embora seja
possível fazer edições enquanto a opção Site Publicado está selecionada, recomenda-se fazer a
123
edição enquanto estiver em um projeto. As edições feitas no site publicado entram em vigor
imediatamente e não se beneficiam das proteções do fluxo de trabalho que são fornecidas pelos
projetos.
v É possível criar projetos. Quando você cria um projeto, o novo projeto é selecionado
automaticamente como o projeto atual.
v Para usar um projeto que não está listado como um projeto recente, é possível procurar ou navegar
por todos os projetos disponíveis.
v Você pode executar tarefas de gerenciamento para o projeto. Essas tarefas incluem trabalhar com
uma lista de todos os itens do projeto ou alterar propriedades do projeto.
Nota:
v Se um usuário tiver uma permissão de controle de acesso superior à do usuário privilegiado da
página, o usuário poderá criar ou selecionar um projeto ao editar a página. O menu do projeto não
está disponível para usuários que têm apenas direitos privilegiados a uma página, pois suas edições
são customizações particulares da página.
v Se páginas gerenciadas estiverem desativadas, o menu do projeto não será exibido. Ao contrário,
um botão de alternância será exibido, permitindo que o usuário comute do modo de visualização
para o modo de edição.
Modo de Edição
Ao clicar em Modo de Edição, a barra de ferramentas é expandida para exibir informações adicionais
sobre a página e o projeto selecionado e para fornecer acesso aos recursos de edição. A figura a seguir
mostra a barra de ferramentas do site no modo de edição.
Figura 22. Barra de ferramentas do site expandida no modo de edição.
1. O projeto ativo é indicado pelo menu do projeto. As edições feitas na página e em seu conteúdo são
salvas como rascunhos no projeto atual.
2. Há ações de autoria disponíveis no modo de edição, incluindo salvar mudanças como rascunho ou
descartar mudanças que não foram salvas.
Nota: Os usuários podem reverter as mudanças feitas na página usando o botão Reverter. Os
usuários podem reverter as seguintes ações:
v Incluir conteúdo
v Alterar o estilo
v Alterar o layout
v Mover um portlet
v Ocultar um portlet
124
v Arrastar um portlet
v Excluir um portlet
Os usuários não podem reverter as seguintes ações:
v Criar uma página
v Mover uma página
v Excluir uma página
Quando o usuário salva a página clicando em Salvar, todas as ações de edição são confirmadas e não
podem mais ser revertidas.
3. A área expandida da barra de ferramentas fornece guias que mostram informações sobre a página e o
projeto, permitindo customizar a página. As guias incluem:
Visão Geral
Exibe informações sobre a página ou o projeto:
v As informações sobre a página incluem propriedades como nome, URL conveniente e fluxo
de trabalho designado. As associações de conteúdo da web e as associações de comunidade
também são exibidas. Se você tiver direitos de acesso suficientes, poderá editar as
propriedades e associações selecionando essa seção da barra de ferramentas e clicando em
Editar.
v As informações sobre o projeto incluem uma lista de itens de conteúdo e páginas que fazem
parte do projeto atual. É possível editar os itens e as páginas selecionando essa seção da
barra de ferramentas e clicando em Ler ou Acessar. Se nenhum projeto for selecionado,
nenhuma informação sobre o projeto será exibida.
Conteúdo
Fornece categorias para organizar componentes que é possível incluir na página, como
portlets, iWidgets e conteúdo da web.
Estilo Fornece temas predefinidos que podem ser selecionados para alterar a aparência da página.
Layout
Fornece formatos predefinidos que podem ser selecionados para alterar o layout e os widgets
dos portlets na página.
4. É possível maximizar e minimizar a barra de ferramentas enquanto se está no modo de edição.
Editar as propriedades da página
A barra de ferramentas do site fornece também acesso às páginas do portal. Para abrir a janela
Propriedades da Página, conclua estas etapas:
1. Expanda a barra de ferramentas do site no modo de edição.
2. Destaque a seção de propriedades da página da barra de ferramentas com o teclado ou posicionando
o cursor sobre a seção.
3. Clique em Editar.
Nota: O link Editar só é mostrado quando você destaca a seção de propriedades da página.
125
Figura 23. Captura de tela da seção de propriedades da página da barra de ferramentas do site, mostrando o link
Editar para acessar a janela Propriedades da Página.
A janela Propriedades da Página fornece acesso às seguintes informações:
Geral
A guia Geral mostra o nome de exibição, o nome da URL amigável e a descrição da página. Se a
página foi criada a partir de um modelo de página, o modelo também será listado.
Cache A guia Cache contém o escopo de cache e o intervalo de expiração do cache para controlar como
as informações são armazenadas em cache para a página.
Segurança
A guia Segurança lista autores e proprietários associados à página e contém as configurações de
fluxo de trabalho da página. As configurações de fluxo de trabalho incluem os itens a seguir:
v O fluxo de trabalho designado à página.
v
v
v
v
O estágio do fluxo de trabalho atual da página e o próximo estágio.
Configurações de data e hora para todas as ações específicas do fluxo de trabalho.
Usuários adicionais que podem visualizar a página publicada.
A ação de fluxo de trabalho atual que foi concluída.
Localização
A guia Localização lista o título e a descrição da página para todos os idiomas suportados. É
possível também configurar valores específicos do idioma para o título e a descrição.
Avançado
A guia Avançado fornece acesso a estas configurações:
v O nome exclusivo da página.
v O local do conteúdo da web associado à página. O caminho de conteúdo inclui a biblioteca de
conteúdo da web e a hierarquia da área de site nessa biblioteca.
v O local do modelo de layout de página associado à página. Se você alterar ou atualizar o
modelo de layout, será possível atualizar a página clicando em Atualizar Layout do Modelo.
v As configurações de tema da página, incluindo o tema atual e o perfil do tema associados à
página. É possível também especificar o tipo de agregação usado quando a página é
renderizada.
v A configuração de acesso de portlet da página. É possível permitir todos os portlets ou
especificar portlets individuais.
v Uma lista de versões da página, incluindo a versão atual. É possível trabalhar com as versões
clicando em Gerenciar Versões.
v Os mapas de modelo que associam modelos de apresentação e modelos de autoria para o
conteúdo criado como filho desta página. Para trabalhar com mapas de modelo, clique em
Incluir associações de modelo.
v Os metadados definidos para a página.
126
Visualizando como Outro Usuário
Você pode visualizar as mudanças em seu website sem efetuar logout e login novamente como outro
usuários. Essa capacidade de visualização permite verificar com rapidez se usuários com diferentes níveis
de acesso veem apenas conteúdo para os quais tenham autorização. É possível visualizar mudanças como
um usuário específico ou como um usuário não autenticado.
Enquanto estiver no modo de edição, clique em Mais e, em seguida, clique em Como Usuário ou Como
Usuário Não Autenticado. A página é atualizada de acordo com o usuário que você está personificando.
Para parar a visualização, clique em Parar Visualização.
É possível modificar a função de visualização para customizar o comportamento de visualização no
seguinte cenário:
v O User1 cria um projeto e uma página dentro do projeto. A nova página contém um portlet.
v O User1 tenta então visualizar a página como User2. Nesse caso, o User2 tem as permissões para
visualizar a página, mas não tem as permissões para visualizar o portlet que está na página.
v O User1 recebe a seguinte mensagem: Você não está autorizado a usar este portlet. Esta
mensagem é exibida para esclarecer que um portlet será renderizado aqui caso o usuário tenha as
permissões necessárias.
Você pode suprimir a mensagem neste cenário.
Para obter mais informações sobre as permissões de acesso necessárias para visualização como outro
usuário, consulte Controle de Acesso para Páginas Gerenciadas.
1. Efetue logon no WebSphere Integrated Solutions Console como um administrador.
3. Clique em WP ConfigService e, em seguida, clique em Propriedades Customizadas.
4. Clique em portlets.unauthorized.visible.project. Configure o valor como false para suprimir a
mensagem. O valor-padrão é true.
“Controle de Acesso para Páginas Gerenciadas” na página 161
O controle de acesso para páginas gerenciadas fornece mais recursos do que o controle de acesso para
páginas de portal padrão. Além dos recursos de controle de acesso disponíveis para páginas por meio da
administração do portal, também é possível aplicar recursos do IBM Web Content Manager, como fluxo
de trabalho e organização, ao controle de acesso.
Bibliotecas
Crie um conjunto de bibliotecas para armazenar diferentes tipos de itens de conteúdo da web para
diferentes websites ou equipes.
É possível criar bibliotecas com o portlet de administração Bibliotecas de Conteúdo da Web.
Importante: Ao criar uma biblioteca de conteúdo da web, assegure-se de que o nome da biblioteca não
corresponda ao contexto de URL de nenhum portal virtual no mesmo servidor. Se o nome de uma
biblioteca e o contexto de URL de um portal virtual tiverem o mesmo valor, o resultado pode ser um
comportamento de renderização incorreto.
Bibliotecas de Conteúdo da Web
Seu sistema de conteúdo da Web pode conter múltiplas bibliotecas. O número de bibliotecas necessárias é
determinado pelo tipo de Web site que você está criando e os tipos de usuários que exigem acesso a cada
biblioteca.
127
Na maioria dos sistemas, será necessário um mínimo de duas bibliotecas:
1. Uma biblioteca de design na qual você armazena todos os itens necessários para o próprio sistema de
conteúdo da Web
2. Uma biblioteca de conteúdo usada para armazenar o conteúdo desenvolvido por seus criadores de
conteúdo
A separação de seu site nessas bibliotecas permite um melhor controle do acesso a cada biblioteca, além
de permitir a configuração de diferentes estratégias de associação em cada biblioteca.
Exemplo:
Os conteúdos de recursos humanos e marketing estão armazenados em bibliotecas separadas.
Uma terceira biblioteca é utilizada para armazenar o conteúdo relativo à marca (imagens, modelos de
apresentação, texto relativo à marca e componentes HTML).
O conteúdo da biblioteca de marcas pode ser acessado e utilizado tanto pelos recursos humanos e
marketing, mas é de somente leitura. Apenas usuários com acesso ao editor ou acima à biblioteca de
marcas podem editar essa biblioteca.
Itens Padrão da Biblioteca de Conteúdo da Web
Ao criar uma biblioteca de conteúdo da Web, é possível optar por incluir um conjunto de itens de
conteúdo da Web padrão na nova biblioteca. Eles podem ser usados como um ponto de início em seu
sistema e Web site do Web Content Manager.
Itens Padrão
Os itens a seguir são criados quando você seleciona Incluir Itens Padrão na Nova Biblioteca ao criar
uma biblioteca.
Itens do Fluxo de Trabalho:
v Um fluxo de trabalho chamado Fluxo de Trabalho Expresso com um único estágio de fluxo de
trabalho chamado Estágio Publicar que usa a ação de publicação chamada Publicar.
v Um fluxo de trabalho chamado Fluxo de Trabalho de Três Estágios que usa os seguintes
estágios do fluxo de trabalho:
– Estágio Rascunho
– Estágio Publicar que usa a ação de publicação chamada Publicar.
– Estágio Expirar que usa a ação de expiração chamada Expirar.
128
Modelo de Autoria:
O modelo de autoria é chamado Artigo e contém um único elemento de rich text chamado Corpo
e usa o Fluxo de Trabalho Expresso como o fluxo de trabalho padrão para itens de conteúdo
criados usando esse modelo de autoria.
Modelo de Apresentação:
O modelo de apresentação é chamado Layout de Artigo Simples.
Área de Site e Itens de Conteúdo:
v Os itens de conteúdo chamados Artigo de Amostra e Artigo de Amostra 2 são armazenados
na área de site chamada Artigos.
v A área de site chamada Artigos contém um mapa de modelo entre o modelo de autoria
chamado Artigo e o modelo de apresentação chamado Layout de Artigo Simples.
Componentes:
v A ferramenta de autoria chamada Barra de Ferramentas do Artigo é usada para incluir as
funções Novo e Editar na página renderizada. Ela é referenciada no modelo de apresentação
chamado Layout de Artigo Simples.
v O menu chamado Lista de Artigos é usado para exibir uma lista de itens de conteúdo na
página renderizada. Ele é referenciado no modelo de apresentação chamado Layout de Artigo
Simples.
Controles de Acesso
À medida que os itens padrão da biblioteca de conteúdo da Web são configurados para herdar suas
configurações de acesso a partir da biblioteca em que estão armazenados, os usuários não poderão
acessar esses itens até que você tenha configurado as definições de acesso da biblioteca.
Usando os Itens Padrão
Os itens padrão são melhor exibidos usando um portlet do visualizador de conteúdo da Web:
1. Vá para Administração > Gerenciar Páginas.
2. Selecione Criar Nova Página a Partir de.
3. Em Mapeamentos de Conteúdo da Web, selecione a área de site chamada Artigos na biblioteca de
conteúdo da Web.
4. Preencha o restante do formulário e clique em OK.
5. Edite o layout da nova página e inclua um portlet Visualizador de Conteúdo da Web (JSR 286) na
página.
6. O item de conteúdo chamado Artigo de Amostra é exibido na página.
Páginas
Uma página é um elemento de organização que contém conteúdo. Há diferentes tipos de páginas no
portal. Há também interfaces diferentes para criar e gerenciar páginas.
O tema do portal permite executar as seguintes tarefas:
v Criar, reordenar, excluir e editar as propriedades de páginas, rótulos e URLs
v Reordenar páginas, rótulos e URLs
v Atribuir acesso a páginas, rótulos e URLs
v Mover páginas para um novo local na hierarquia do portal
Tanto administradores quanto usuários com acesso apropriado podem criar e excluir páginas. Os usuários
só podem excluir as páginas que criam ou as páginas para as quais possuem pelo menos o acesso de
Gerenciador.
129
Criação e Navegação pela Página
Ao criar uma página, ela é criada em relação a páginas existentes, como uma irmã ou uma filha. A
hierarquia da página afeta a navegação gerada.
Criação da Página
Há duas interfaces com o usuário para a criação de páginas, o portlet Manage Pages e a barra de
ferramentas do site. As páginas criadas a partir dessas interfaces com o usuário são criadas como páginas
gerenciadas. As páginas gerenciadas são armazenadas em uma biblioteca de conteúdo da web chamada
Site do Portal. Elas também possuem outros benefícios, como fluxo de trabalho. Se você desativar as
páginas gerenciadas, não será possível criar páginas a partir da barra de ferramentas do site.
Navegação
A partir de qualquer página, é possível criar uma página filha ou irmã usando a barra de ferramentas do
site. É possível mover a página, se for necessário.
Se você criar uma página a partir do portlet Manage Pages de administração, você deverá selecionar a
raiz de conteúdo e localizar o local correto na hierarquia.
URLs Conhecidas e Mapeamento de URL
Ao criar um mapeamento de URL, criar uma página ou modificar uma página, os mapeamentos de URL
e as URLs conhecidas não podem corresponder, sobrepor-se parcialmente ou interferir entre si. Por
exemplo, não use sequências como home, ibm, ibm.com. Também não use sequências que já sejam usadas
como mapeamentos de URL ou como URLs conhecidas no portal. Conflito pode causar loops de
redirecionamento do navegador. Às vezes, o loop ocorre sem uma mensagem de erro.
Para determinar essas sequências, use a interface de configuração XML para criar uma exportação a partir
do portal. Em seguida, varra o arquivo exportado em relação à sequência que você deseja usar para o
mapeamento de URL ou para a URL conhecida.
organização.
“Desativando Páginas Gerenciadas” na página 107
Desative o suporte para as páginas gerenciadas executando a tarefa de configuração disable-managedpages.
Criando uma Página da Barra de Ferramentas do Site
Uma página exibe conteúdo, como portlets e outras páginas. As páginas organizam as informações do
site. À medida que você cria páginas, também cria novos elementos navegacionais para o site. É possível
criar uma página em uma página existente ou você pode criar uma página que seja um peer para uma
página existente. Ao criar uma página, também é possível fazer referência a uma página existente, aplicar
um layout e selecionar marcações suportadas.
Sua função de acesso determina o tipo de página que você pode criar.
Páginas públicas
Você deve ter a designação de função de Administrador, Gerenciador ou Editor para criar uma
página pública.
130
Página customizada (página derivada)
Você deve ter a designação de função de Editor ou Usuário Privilegiado para criar uma página
customizada.
Se tiver a função de Editor na página derivada, poderá alterar tudo, exceto as marcações.
Se você tiver a função de Usuário Privilegiado na página derivada, poderá alterar o título,
aparências ou layout da página derivada. Essa função está restrita para um layout, pela página
pai de derivação.
Se você fizer referência a uma página existente, o layout, as marcações suportadas, os bloqueios, as
aparências, a lista de portlets e os títulos específicos do código de idioma serão pré-determinados pela
página existente que está sendo referida. Qualquer alteração na página original resulta na mesma
alteração em todas as páginas referenciadas.
Ao criar uma página, você pode fornecer a ela uma URL amigável. URLs amigáveis devem ser exclusivas
e o portal validará que o nome inserido é exclusivo. Como
1. Clique em Mais > Nova Página Filha ou Nova Página Irmã, dependendo de onde deseja que a
página apareça na hierarquia.
2. Digite uma URL exclusiva em Nome da URL Amigável ou use o nome que foi gerado para você.
Esse nome cria um endereço customizado para sua página que é fácil de lembrar e compartilhar.
Nota: Ao criar um mapeamento de URL ou criar ou modificar uma página, certifique-se de que ela
seja exclusiva. Por exemplo, não use sequências como home, ibm, ibm.com. Além disso, não use
sequências que já foram usadas como mapeamentos de URL ou URLs amigáveis em seu portal. Caso
contrário, poderão ocorrer loops de redirecionamento do navegador, às vezes sem uma mensagem de
erro. Para determinar essas sequências, use a interface de configuração XML para exportar seu portal.
Depois, faça a varredura do arquivo exportado para a sequência que você deseja usar para seu
mapeamento de URL ou URL amigável. Por padrão, o portal garante que o nome da URL amigável
que você insere seja exclusivo. No entanto, esse cumprimento não inclui páginas derivadas com um
nome amigável herdado e irmãos que são movidos por uma regra de personalização.
3. Você pode selecionar um modelo de página clicando em Alterar. O Modelo de Página Básico padrão
fornecido com o portal criar uma página de portal vazia.
4. Clique em Criar para criar a página e incluir um novo conteúdo. Clique em Cancelar se quiser sair
sem criar a página.
Modelos de Páginas
O portal inclui modelos que estão disponíveis para uso imediato, Básico e Artigos. Também é possível
criar modelos e incluí-los na barra de ferramentas do site.
Os modelos Básico e Artigos são páginas gerenciadas. As páginas gerenciadas são armazenadas em uma
biblioteca do IBM Web Content Manager chamada Site do Portal.
Página Básica do Portal
Ao criar uma página, é possível selecionar um modelo de página. O modelo de página padrão é Básico
para a página básica do portal. Ao criar uma página usando esse modelo, é possível incluir portlets,
conteúdo e muito mais na página.
Artigos
O modelo de artigos possui dois portlets que exibem conteúdo, Articles e List of Articles. Esse tipo de
portlet é referido como um portlet do visualizador de conteúdo.
131
Há também uma associação de conteúdo entre os dois portlets. O portlet List of Articles exibe uma lista
dos armazenamentos de artigos na área de site da página. É possível selecionar um artigo na lista, que
será exibido no portlet Article.
organização.
Criando Páginas a partir de um Modelo Usando a Barra de
Ferramentas do Site
Crie páginas rapidamente usando um modelo de página. As páginas criadas a partir de modelos de
páginas contêm portlets e configurações pré-configurados.
1. Navegue para a página em que deseja incluir a nova página.
2. Clique em Editar Modo na barra de ferramentas do site.
3. Clique em Mais e, em seguida, clique em Nova Página Filha ou em Nova Página Irmã, dependendo
de onde você deseja criar a página.
4. Insira o nome da página.
5. Digite uma URL exclusiva no campo Nome da URL Conhecida. A URL conhecida cria um endereço
customizado para a página, fácil de lembrar e compartilhar.
Nota: Ao criar um Mapeamento de URL ou criar/modificar uma página, certifique-se de que os
Mapeamentos de URL e URLs amigáveis em seu portal não correspondam, sobreponham-se
parcialmente ou de alguma forma façam interface entre si. Por exemplo, não use sequências como
home, ibm, ibm.com e não use sequências que já sejam usadas como Mapeamentos de URL ou URLs
conhecidas no portal. Caso contrário, loops infinitos de redirecionamento do navegador poderão
ocorrer, às vezes, sem uma mensagem de erro. Para determinar essas sequências, crie uma exportação
a partir do portal usando a interface de configuração XML. Em seguida, varra o arquivo de saída de
resultado XML exportado da sequência que você deseja usar para o Mapeamento de URL ou para a
URL conhecida.
6. Na seção Modelo de Página, clique em Alterar para selecionar o modelo de página que deseja usar
para a nova página. O modelo padrão é o modelo Básico.
Nota: Se você estiver criando uma página pública, deverá ter pelo menos acesso à função Usuário
para a página de modelo que está usando.
7. Clique em Criar.
Layout e estilo da página
Layout da página define como as informações (conteúdo, aplicativos e assim por diante) são organizadas
em sua página. Estilo da página define o esquema de cores que é aplicado à página.
O Portal inclui layouts e estilos que estão disponíveis para uso imediato. É possível selecionar facilmente
um layout e um estilo na barra de ferramentas do site. Além dos layouts e estilos incluídos é possível
criar adicionais, conforme necessário.
Alterando o Estilo da Página
Altere a aparência de uma página selecionando um estilo na lista de temas predefinidos. Ao selecionar
um tema, ele é visualizado na página. É possível incluir estilos customizados na lista de temas da página
que estão disponíveis para seleção.
Para alterar a aparência de uma página, proceda da seguinte forma:
132
1.
2.
3.
4.
5.
Navegue até a página ou selecione aquela que deseja alterar e clique em Modo de Edição.
Clique na guia Estilo.
Selecione uma categoria no menu lateral.
Filtre os resultados exibidos, digitando termos de procura na caixa de entrada.
Folheie o conteúdo usando a barra de rolagem.
6. Para visualizar um estilo, clique nele.
7. Para confirmar uma mudança de estilo no servidor, clique em Salvar Rascunho.
8. Feche a barra de ferramentas clicando no botão Minimizar ou clicando no botão de alternância Modo
de Edição para retornar ao Modo de Visualização.
Nota: O estilo padrão disponível na instalação padrão do portal reconfigura a página para que não tenha
nenhuma folha de estilo customizada aplicada. Portanto, uma página que possui o estilo padrão aplicado
simplesmente herda os estilos aplicados às páginas anteriores.
Alterando o Layout da Página
Você pode selecionar um layout de página na lista de formatos predefinidos.. Os portlets e os widgets são
posicionados automaticamente no novo layout. Você pode incluir layouts customizados definidos na lista
de formatos de página disponíveis para seleção.
Nota: O tema do portal não suporta contêineres bloqueados.
1. Navegue até a página em que deseja alterar o layout e clique em Modo de Edição para abrir a barra
de ferramentas.
2. Clique na guia Layout.
3. Para selecionar um layout, clique no item de layout. Nenhuma mudança no conteúdo é exibida neste
momento.
Nota: É possível filtrar os layouts mostrados digitando termos de procura separados por espaços na
caixa de entrada na barra de ferramentas.
4. Para confirmar uma mudança de layout para o servidor, clique em Salvar Rascunho. A página é
automaticamente atualizada para renderizar a mudança do layout.
Mover uma página
Você pode mover uma página e seus filhos para outro local na hierarquia do portal.
1. Navegue para a página que você deseja mover e clique em Editar Modo.
2. Clique em Mais > Mover Página.
3. No diálogo, selecione o local para mover a página.
4. Clique em Salvar para concluir a movimentação.
Uma alternativa para o diálogo da página de movimentação sequencial é o portlet Manage Pages.
Comparação de suporte a recursos por tipos de páginas de portal
Obtenha informações sobre as considerações de quais tipos de páginas e temas do portal podem ser
usados para quais propósitos e o que eles suportam. A tabela a seguir compara que tipo de página
suporta que recursos do portal.
Tabela 23. Suporte de recursos do portal por diferentes tipos de páginas
Recurso do portal a ser suportado
Páginas de portal anteriores ao
portal Versão 8.0
Página do construtor de páginas a
partir do portal Versão 8.0
Suporte de componente
133
Tabela 23. Suporte de recursos do portal por diferentes tipos de páginas (continuação)
Recurso do portal a ser suportado
Páginas de portal anteriores ao
portal Versão 8.0
Página do construtor de páginas a
partir do portal Versão 8.0
Usar o portlet IBM
Sim
v agregação do lado do servidor: sim
v agregação do lado do cliente: não
Usar portlet padrão JSR186 ou JSR268 Sim
Sim
Usar o IWidget Versão 2.1
Não
Sim
Portlet consumido com o uso de
WSRP
Sim
Sim
Comunicação entre portlets
Sim
Sim
Comunicação entre widgets
Não
Sim
Comunicação de widget com portlet
e de portlet com widget
Não
v agregação do lado do servidor: não
Incluir ou remover componentes
Sim
Sim
Alterar o layout do contêiner
Sim
Não
Alterar o estilo
Não
Não
Incluir ou remover componentes
Sim
Sim
Alterar o layout do contêiner
Sim
sim. É necessário designar um
modelo diferente.
Alterar o estilo
Não
Sim
Interface dinâmica com o usuário
Sim
Não
Outros serviços de portlet
Sim
v agregação do lado do servidor: sim
Comunicações
v agregação do lado do cliente: sim
Derivação explícita da página:
v páginas de portal derivadas de
páginas de portal
v páginas do construtor de páginas
derivadas de páginas do construtor
de páginas
Infraestrutura
v agregação do lado do cliente:
depende
Projetos e Fluxos de Trabalho
Os projetos permitem alterar um conjunto de itens em seu site e garantir que eles sejam publicados em
conjunto ao mesmo tempo. Um novo projeto tem um fluxo de trabalho padrão que permite que o
conteúdo seja revisado e aprovado antes que ele seja publicado.
Visão Geral dos Projetos
Os projetos permitem que você altere um conjunto de itens e garante que eles sejam publicados juntos ao
mesmo tempo.
v É possível criar um projeto diretamente ou baseá-lo em um projeto criado anteriormente.
v Depois de criado, é possível incluir itens existentes no projeto e criar novos itens.
v Todos os itens são incluídos em um projeto com um status de rascunho.
134
v O projeto propriamente dito não pode ser publicado até que todos os itens dele estejam prontos para
serem publicados.
v Cada item de um projeto pode ter um processo de aprovação de mudanças separado.
v Os próprios projetos podem também ser processados por meio de um processo de aprovação.
Estados do Projeto
Ao trabalhar com um projeto, o projeto progride por vários estados.
Ativo
Um projeto que possui itens de rascunho é considerado "ativo". Esses itens podem ser aprovados
individualmente até atingirem um estado de "pendente".
Organização
Se a organização "Todos os itens" ou "Ativo e Projeto" tiver sido ativada para uma biblioteca, um
status de "Organização" será exibido no projeto até que todos os itens no organizador e no
assinante tenham atingido um estado de pendente.
Revisar
Se algum aprovador tiver sido designado a um projeto, o projeto poderá ser submetido para
revisão depois que todos os itens do projeto estiverem em um estado pendente. Se aprovado, o
projeto progredirá para pendente.
Pendente
Um projeto que contém apenas itens em um estado "pendente" ou que foi aprovado, é
considerado "pendente". Se a opção de publicação do projeto estiver definida como automática,
esse estado será ignorado. Quando o projeto for publicado manualmente ou quando a data de
publicação for atingida, o projeto se moverá para o estado "publicando".
Publicando
Esse é o estado em que todos os itens do projeto se movem de pendente para publicado.
Com Falha
Indica que um ou mais itens do projeto falharam ao serem publicados.
Publicado
Depois que todos os itens forem publicados, o projeto atingirá um estado de "publicado".
Estado de Revisão do Projeto
Se você selecionar pelo menos um aprovador para um projeto, o projeto deverá ser submetido para
revisão para que possa ser publicado.
Para forçar uma revisão, um usuário com acesso de editor ou mais clica em Enviar para Revisão na barra
de ferramentas depois que todos os itens do projeto estiverem "pendentes". Um projeto pode requerer a
aprovação de apenas um único aprovador ou de todos os aprovadores. Apenas quando o projeto for
aprovado ele se tornará pendente. O projeto será então publicado automática ou manualmente,
dependendo de como ele foi configurado.
Depois que um projeto estiver no estado de revisão:
v Usuários com acesso de editor ou mais alto poderão retornar um projeto para um estado ativo clicando
em Retirar da Revisão .
v Aprovadores poderão aprovar um projeto clicando em Aprovar Projeto. Um projeto pode requerer a
aprovação de apenas um único aprovador ou de todos os aprovadores.
v Aprovadores poderão recusar um projeto clicando em Rejeitar Projeto. O projeto será retornado para o
estado ativo.
v Se a aprovação em conjunto for especificada, os aprovadores poderão retirar uma aprovação enquanto
o projeto ainda estiver na revisão clicando em Retirar Aprovação. A aprovação do usuário é retirada,
mas o projeto permanece em um estado de revisão.
135
Formas de Publicar um Projeto
A publicação de um projeto atualiza o site da web ativo com suas mudanças.
Há três métodos de publicação usados por projetos:
Quando Data estiver selecionado, todos os itens são publicados assim que todos os itens do
projeto atingirem um estado de "pendente" e a data de publicação selecionada no projeto for
atingida. Também é possível clicar em Publicar no formulário do projeto antes de a data ser
atingida, depois que todos os itens do projeto atingirem um estado de "pendente".
Data
Manual
Quando Manual estiver selecionado, todos os itens permanecem em um estado de "pendente" até
que o projeto seja publicado manualmente clicando em Publicar no formulário do projeto. O
botão Publicar não é ativado até que todos os itens do projeto atinjam um estado de "pendente".
Apenas usuários com acesso de editor ou superior em um projeto podem publicar um projeto.
Automático
Quando Automático for selecionado, todos os itens são publicados assim que todos os itens do
projeto atingirem um estado de "pendente".
Depois que o projeto for publicado, você poderá continuar a revisar o histórico do status e de versão dos
itens do projeto abrindo o formulário do projeto.
Nota: Você e outros usuários podem atualizar os mesmos itens em diversos projetos. São exibidas
mensagens quando você move um item para o estado de publicação para avisar quando isso ocorreu.
Projetos e Organização
Projetos são incluídos na organização, o método usado pelo IBM Web Content Manager para replicar
dados de uma biblioteca de conteúdo da web em um servidor organizador para uma biblioteca de
conteúdo da web em um servidor de assinante. Embora os projetos sejam organizados com outros itens
em uma biblioteca que está sendo organizada, não é possível usar a cópia do assinante do projeto para
atualizar ou publicar seu projeto. Trabalhe apenas com projetos no servidor organizador.
Quando um projeto é organizado, o método de publicação no assinante é automaticamente alterado para
"Adiado para Organização" e as seguintes ações são desativadas no assinante:
v Publicar Projeto
v
v
v
v
Incluir no Projeto
Remover do Projeto
Marcar para Exclusão
Cancelar Exclusão
Isso significa que o projeto no assinante não pode ser atualizado ou publicado, a menos que ele receba
atualizações do organizador.
Ações de Projetos e Fluxo de Trabalho Customizado
Cada estágio do fluxo de trabalho contém ações padrão, mas você também pode criar ações de fluxo de
trabalho customizado criando um plug-in de fluxo de trabalho customizado.
É possível designar ações de fluxo de trabalho customizadas para execução quando um projeto entrar em
um estado específico em um projeto. Por exemplo, você poderia criar uma ação de fluxo de trabalho
customizada que poderia:
v verificar a conformidade de normas da web para todos os recursos do projeto, incluindo itens que não
participam tradicionalmente de fluxo de trabalho, como componentes e modelos de apresentação.
v rejeitar automaticamente um projeto se estiver na revisão durante um período de tempo.
v excluir automaticamente um projeto quando for publicado com sucesso.
136
Gerenciamento de Fluxo de Trabalho e Mudanças
Status do Item
Há três níveis principais de status em que um item pode estar a qualquer momento; Rascunho,
Publicado ou Expirado. O estado atual de um item indica onde ele existe em um processo de
gerenciamento de mudanças e onde esse item pode ser visualizado e acessado.
Tipos de Status
Rascunho
Indica que o item está sendo atualizado no momento.
Publicado Pendente
Um item que usa um fluxo de trabalho pode aparecer em um estado de publicado pendente. Isso
indica que o item foi inserido em um estágio do fluxo de trabalho que inclui uma ação de
publicação, mas a ação ainda será processada.
Publicado
Um status publicado indica que um item está pronto para ser renderizado no site ativo.
Expirado Pendente
Um item que usa um fluxo de trabalho pode aparecer em um estado expirado pendente. Isso
indica que o item foi inserido em um estágio do fluxo de trabalho que inclui uma ação de
expiração, mas a ação ainda será processada.
Expirado
Um status expirado indica que um item está pronto para ser expirado do site ativo.
Alterando o Status
O status de um item pode ser alterado apenas de maneira linear:
v Rascunho para Publicado.
v Publicado para Expirado.
v Expirado para Publicado .
v Publicado para Rascunho .
Não é possível alterar o status de um item de Expirado para Rascunho.
O Processo de Publicação e Expiração de Itens
Quando o status de um item muda de publicado ou expirado, isso não significa que o item será incluído
ou removido do site renderizado. Um status de publicado ou expirado significa que o processo de
publicação ou expiração de um item foi iniciado.
O horário real em que um item publicado aparecerá em um Web site ou o horário em que um item
expirado será removido de um Web site, depende também de:
v quanto tempo leva para distribuir atualizações ao servidor de entrega
v quanto tempo leva para que o cache atual expire
Itens de Rascunho:
A criação de um rascunho de um item permite trabalhar nas alterações desse item sem alterar a versão
publicada do item. Os itens de rascunho podem ser itens independentes ou parte do formulário de um
fluxo de trabalho. Depois que as alterações estiverem concluídas, será possível optar por publicar o item
ou descartar as alterações cancelando o rascunho. É possível criar diversos rascunhos de um único item.
137
Nota: Os itens de rascunho são exibidos apenas no Portlet de Autoria e não são renderizados no Web site
publicado.
Trabalhando com Itens de Rascunho Sem Utilizar um Fluxo de Trabalho
É possível criar diretamente um rascunho de qualquer item sem fluxo de trabalho.
Criando um item de rascunho
Para criar um novo item de rascunho:
v abra um item publicado sem fluxo de trabalho no modo de edição e clique em Salvar como
Rascunho. Isso criará uma cópia de rascunho do item publicado sem remover o item publicado
do site ativo.
v abra um item publicado sem fluxo de trabalho no modo de leitura e clique em Criar Rascunho.
Isso criará uma cópia de rascunho do item publicado sem remover o item publicado do site
ativo.
v abra um item publicado sem fluxo de trabalho no modo de leitura e clique em Alterar para
Rascunho. Isso alterará o estado do item de "publicado" para "rascunho" e o item não será
mais visível no site ativo. Não será possível alterar um item para rascunho se ele estiver sendo
referenciado por qualquer outro item.
Salvando um item de rascunho
Depois que o rascunho foi criado:
v para salvar o item de rascunho, clique em Salvar, Salvar e Fechar ou Salvar e Ler.
v para publicar o item de rascunho, clique em Salvar e Publicar.
Depois de salvo, o seu item de rascunho será exibido junto com outros itens em suas
visualizações de itens, mas será exibido com um status de rascunho. Se você criou um rascunho
de um item publicado anteriormente, as versões de rascunho e publicado do item aparecerão em
suas visualizações de item. É possível editar e salvar rascunhos várias vezes antes de publicar
suas alterações.
Publicando um item de rascunho
Todas as alterações feitas em um item de rascunho não aparecerão no site ativo até que você
publique o item de rascunho. Quando o seu rascunho estiver pronto para publicação, será
possível:
v selecionar um item em uma visualização e clicar em Publicar Item.
v abrir um item no modo de leitura e clicar em Publicar Item.
v abrir um item no modo de edição e clicar em Salvar e Publicar.
Cancelando um rascunho
O cancelamento de um rascunho é basicamente igual à exclusão de um rascunho, uma vez que
todas as mudanças feitas no item são descartadas. Para cancelar um rascunho, abra um item de
rascunho e clique em Mais Ações > Cancelar Rascunho. É necessário acesso ao editor ou
superior para cancelar um rascunho de itens sem usar um fluxo de trabalho.
Trabalhando com Itens de Rascunho em um Fluxo de Trabalho
Dentro de um fluxo de trabalho, os itens têm um status de rascunho até que eles entrem em um estágio
do fluxo de trabalho onde uma ação de publicação é executada. Os itens de rascunho em um fluxo de
trabalho são exibidos ao lado dos outros itens em suas visualizações de itens, mas são exibidos com um
status de rascunho. Se você criou um rascunho de um item publicado anteriormente, as versões de
rascunho e publicado do item aparecerão em suas visualizações de item. É possível editar e salvar
rascunhos várias vezes, enviando seu rascunho para o próximo estágio do fluxo de trabalho.
138
Você usa os seguintes botões para trabalhar com itens durante um fluxo de trabalho.
Tabela 24. Aprovando e recusando controles de acesso.
Nota: Esta tabela assume acesso de contribuidor ou superior à biblioteca.
Ações
Funções
Acesso ao Item
Acesso à função aos
recursos da biblioteca
Mais Ações > Aprovar
Quando a aprovação em
conjunto é configurada, é
usado um botão para
aprovar um item nas
visualizações Todos os
Itens e Meus Itens.
Aprovador ou
administrador.
Acesso de contribuidor ou
superior ao tipo de item.
Mais Ações > Cancelar
Rascunho
Acesso de gerenciador ou
Remove totalmente um
item de rascunho de um
superior.
fluxo de trabalho. É exibido
somente depois da
publicação de um item e da
criação de um novo
rascunho.
Mais Ações > Recusar
Utilizado quando um item
é recusado durante um
fluxo de trabalho. Executa
quaisquer ações definidas
no estágio de recusa e, em
seguida, envia o item de
volta para o primeiro
estágio de um fluxo de
trabalho.
Acesso de aprovador.
Mais Ações > Próximo
Estágio
Utilizado para aprovar um
item e enviá-lo para o
próximo estágio em um
fluxo de trabalho.
Mais Ações > Estágio
Anterior
O botão Estágio Anterior
retorna um item ao estágio
anterior em relação ao
estágio atual. Quando um
item é movido para o
estágio anterior, as ações do
fluxo de trabalho de
entrada no estágio anterior
são executadas, mas as
ações do fluxo de trabalho
de saída no estágio atual
não são.
superior.
Mais Ações > Processar
Agora
Processa manualmente um
item se seu status estiver
pendente. Todas as ações
no estágio serão
processadas.
Acesso de Administrador
Submeter para revisão
Usado para mover um item Acesso de aprovador.
de rascunho para um
estágio de rascunho para
aprovação.
Publicar
Usado para mover um item Acesso de aprovador.
de rascunho para um
estágio com uma ação de
publicação.
Acesso de aprovadores nos
estágios de fluxo de
trabalho cujo acesso foi
concedido aos aprovadores
para o botão de estágio
anterior.
Não obrigatório.
139
Desativando Múltiplos Rascunhos:
Ao criar um fluxo de trabalho, é possível optar por desativar a criação de múltiplos rascunhos de
qualquer item usando esse fluxo de trabalho. Isso permite que você designe um fluxo de trabalho aos
itens em que deseja gerenciar apenas uma alteração de cada vez.
Trabalhando com Itens de Rascunho em um Projeto
Você usa itens de rascunho dentro de um projeto da mesma maneira que usa rascunhos fora de um
projeto, independentemente de o item de rascunho estar participando de um fluxo de trabalho ou não. A
única diferença é que quando o rascunho está pronto para ser publicado, ele permanecerá em um estado
pendente até que todos os itens do projeto estejam prontos para serem publicados. Os itens de rascunho
em um projeto são exibidos ao lado dos outros itens em suas visualizações de itens, mas são exibidos
com um status de rascunho. Se você criou um rascunho de um item publicado anteriormente, as versões
de rascunho e publicada do item aparecerão em suas visualizações de item.
Gerenciando Rascunhos
Há várias maneiras de gerenciar seus itens de rascunho:
v Se estiver visualizando um item publicado com apenas um item de rascunho, você poderá visualizar o
item de rascunho clicando em Mais Ações > Ir para Rascunho.
v Ao visualizar um item de rascunho, você pode abrir a versão publicada de um item clicando em Mais
Ações > Ir para Publicada.
v Se um item publicado tiver mais de um rascunho, clique em Mais Ações > Gerenciar Rascunhos para
visualizar uma lista de rascunhos do item atual. Todos os rascunhos são exibidos, mas é possível
apenas ler, editar e cancelar rascunhos para os quais você tem acesso suficiente.
Itens publicados:
Os itens não são visíveis em um Web site até que sejam publicados. Depois de publicados, um item pode
ser expirado ou retornado a um estado de rascunho.
Trabalhando com Itens Publicados sem Utilizar um Fluxo de Trabalho
Para criar um novo item de rascunho:
v abra um item publicado sem fluxo de trabalho no modo de edição e clique em Salvar como Rascunho.
Isso criará uma cópia de rascunho do item publicado sem remover o item publicado do site ativo.
v abra um item publicado sem fluxo de trabalho no modo de leitura e clique em Alterar para Rascunho.
Isso alterará o estado do item de "publicado" para "rascunho" e o item não será mais visível no site
ativo.
140
Trabalhando com Itens Publicados Usando um Fluxo de Trabalho
Use as seguintes opções de controle de acesso para trabalhar com itens durante um fluxo de trabalho.
Tabela 25. Funções e Controles de Acesso de Itens Publicados.
Nota: Esta tabela assume que o acesso de contribuidor ou superior foi configurado à biblioteca.
Acesso ao Item
Ações
Funções
Aprovar
Quando a aprovação de
Aprovador ou
conjunto for configurada,
administrador.
use esta opção para aprovar
um item nas visualizações
Todos os Itens e Meus
Itens.
Criar Rascunho
Cria uma cópia de
superior, ou acesso de
rascunho de um item
aprovador.
publicado. O item
publicado fica bloqueado
no site renderizado,
enquanto uma cópia do
item é enviada por meio de
um fluxo de trabalho.
Assim que o item de
rascunho tiver sido
aprovado para publicação,
ele substituirá o item
publicado.
Acesso de editor ou
Próximo Estágio
fluxo de trabalho.
141
Tabela 25. Funções e Controles de Acesso de Itens Publicados (continuação).
Acesso ao Item
Ações
Funções
Estágio Anterior
A opção de estágio anterior O acesso de gerenciador ou Acesso de contribuidor ou
retorna um item ao estágio superior ou nos estágios do superior ao tipo de item.
fluxo de trabalho que
anterior do estágio atual.
foram configurados para
v Se o estágio atual
ativar o acesso approvers
contiver uma ação de
para a opção de estágio
publicação, o status do
anterior.
item reverterá para
rascunho quando
retornado ao estágio
anterior. A versão
publicada será removida
e não será mais visível
no site ativo.
v Quando um item é
movido para o estágio
anterior, as ações do
entrada no estágio
anterior são executadas,
mas as ações do fluxo de
trabalho de saída no
estágio atual não são.
Nota: A opção de estágio
anterior não está ativada:
v em itens publicados que
tenham filhos.
v em itens publicados em
que já exista um
rascunho.
Processar Agora
142
Processa manualmente um
pendente. Todas as ações
no estágio serão
processadas.
Não obrigatório.
Tabela 25. Funções e Controles de Acesso de Itens Publicados (continuação).
Ações
Funções
Acesso ao Item
Reiniciar Fluxo de
Trabalho
Envia um item de volta
para o primeiro estágio de superior, ou acesso de
um Fluxo de Trabalho sem aprovador.
ativar o estágio de rejeição.
O item não aparece mais
como publicado e foi
removido do site
renderizado.
Nota: Ao reiniciar um
fluxo de trabalho, as ações
configuradas para execução
na entrada do primeiro
estágio não serão
executadas.
fluxo de trabalho com
vários estágios, um item de
rascunho é criado no
primeiro estágio. Além
disso, o item também será
exibido na visualização de
itens excluídos para que a
última versão publicada do
item possa ser restaurada.
Quando o rascunho for
republicado, a versão na
visualização de itens
excluídos será removida.
Nota: Os itens com
referências não podem ser
reiniciados no fluxo de
trabalho. As referências
incluem componentes de
link, elementos de link e
links integrados nos
campos Rich Text ou
HTML. Você precisará
remover essas referências
para poder reiniciar o fluxo
de trabalho do item. Use o
diálogo de referências de
visualização para ver se
existem referências. Essa
restrição é para evitar que
links quebrados apareçam
em seu site.
Acesso de editor ou
Itens Expirados:
Itens expirados são itens que já foram publicados, mas foram removidos do Web site ativo. Apenas itens
que usam um fluxo de trabalho podem ser expirados.
Use as seguintes opções de controle de acesso para trabalhar com itens expirados em um fluxo de
trabalho.
143
Tabela 26. Funções e Controles de Acesso de Itens Expirados.
Acesso ao Item
Ações
Funções
Aprovar
Quando a aprovação de
Aprovador ou
conjunto for configurada,
administrador.
use esta opção para aprovar
um item nas visualizações
Todos os Itens e Meus
Itens.
Criar Rascunho
Cria uma cópia de
rascunho de um item
expirado.
aprovador.
Acesso de editor ou
Próximo Estágio
fluxo de trabalho. Para
itens expirados, estágios
adicionais de fluxo de
trabalho podem incluir
ações adicionais que serão
executadas após a
expiração de um item.
Estágio Anterior
A opção de estágio anterior O acesso de gerenciador ou Acesso de contribuidor ou
retorna um item ao estágio superior ou nos estágios do superior ao tipo de item.
fluxo de trabalho que
anterior do estágio atual.
foram configurados para
v Se o estágio atual
ativar o acesso approvers
contiver uma ação de
para a opção de estágio
expiração, o status do
anterior.
item reverterá para
publicado quando
retornado ao estágio
anterior e será visível no
site ativo.
v Quando um item é
movido para o estágio
anterior, as ações do
entrada no estágio
anterior são executadas,
mas as ações do fluxo de
trabalho de saída no
estágio atual não são.
Processar Agora
144
Expira manualmente um
expirado pendente. Todas
as ações no estágio serão
processadas.
Não obrigatório.
Tabela 26. Funções e Controles de Acesso de Itens Expirados (continuação).
Ações
Funções
Acesso ao Item
Reiniciar Fluxo de
Trabalho
Envia um item de volta
para o primeiro estágio de superior, ou acesso de
um Fluxo de Trabalho sem aprovador.
ativar o estágio de rejeição.
O item não aparece mais
como publicado e foi
removido do site
renderizado.
fluxo de trabalho, as ações
configuradas para execução
na entrada do primeiro
estágio não serão
executadas.
fluxo de trabalho com
vários estágios, um item de
rascunho é criado no
primeiro estágio. Além
disso, o item também será
exibido na visualização de
itens excluídos para que a
última versão publicada do
item possa ser restaurada.
Quando o rascunho for
republicado, a versão na
visualização de itens
excluídos será removida.
Nota: Os itens com
referências não podem ser
reiniciados no fluxo de
trabalho. As referências
incluem componentes de
link, elementos de link e
links integrados nos
campos Rich Text ou
HTML. Você precisará
remover essas referências
para poder reiniciar o fluxo
de trabalho do item. Use o
diálogo de referências de
visualização para ver se
existem referências. Essa
restrição é para evitar que
links quebrados apareçam
em seu site.
Acesso de editor ou
Estágios e Ações do Fluxo de Trabalho
Você utiliza fluxos de trabalho para controlar o acesso, a verificação e a aprovação eventual de itens.
Apenas se um item for aprovado em todos os estágios até um estágio publicado, ele poderá ser
visualizado em seu Web site.
Um fluxo de trabalho deve ter pelo menos um estágio, mas geralmente tem mais, e sempre passa por um
padrão linear. Você pode utilizar um fluxo de trabalho para:
145
v
v
v
v
revisar a exatidão do conteúdo.
revisar o conteúdo quanto a quaisquer implicações legais.
revisar o conteúdo para garantir que ele atenda às diretrizes de acessibilidade.
garantir que nenhum código malicioso, como ataques de scripts cruzados, tenha sido incluído no
conteúdo.
Um estágio de rejeição pode ser especificado, que é um estágio que é executado quando um documento é
recusado, antes de movê-lo para o primeiro estágio do fluxo de trabalho. Se um item for rejeitado em
qualquer estágio, alguém com acesso de editor precisará corrigir ou aditar o item e submetê-lo
novamente ao fluxo de trabalho selecionado (para aprovação). Todos os itens rejeitados
(independentemente do estágio em que estejam no processo de aprovação) são enviados de volta para o
primeiro estágio (criação) do workflow.
Você também pode especificar que um comentário deve ser inserido em cada movimentação que um
documento faz no fluxo de trabalho ou apenas em estágios específicos. Esse comentário é incluído na
seção de histórico do documento.
Estágios de Fluxo de Trabalho:
Os estágios de fluxo de trabalho são os blocos de construção de um fluxo de trabalho. Crie pelo menos
um estágio antes de criar um workflow.
Estágios de Fluxo de Trabalho
Os estágios determinam:
v Quais ações executar ao entrar ou sair de um estágio de fluxo de trabalho.
v Os níveis de acesso de usuários ou grupos nesse estágio.
Na maioria dos casos, as ações são executadas ao se entrar em um estágio. Por exemplo, você inclui uma
ação de movimentação planejada para executar a entrada em um estágio de modo que ela seja ativada
logo que o item entrar nesse estágio. Mas se você configurar uma ação de movimentação planejada para
executar ao sair de um estágio, ela nunca será executada. O tipo de ação mais comum a ser executado ao
sair de um estágio são ações de email, quando você desejar notificar os usuários de que um item saiu de
um estágio de fluxo de trabalho ou ações de fluxo de trabalho customizado que tenham sido designadas
para executar uma tarefa quando um item sair de um estágio.
Nota: Algumas ações precisam ser executadas em uma ordem específica. Por exemplo:
v Uma ação de movimentação planejada deve ser sempre a ação final em um estágio do fluxo de
trabalho, pois as ações planejadas após uma ação de movimentação planejada não serão executadas.
v Não é possível executar uma ação de versão antes de uma ação de publicação, porque não é possível
salvar versões de itens de rascunho.
v Se estiver usando uma ação customizada, talvez queira executar a ação customizada antes de executar
uma ação de e-mail, para que o item de conteúdo de rascunho esteja em um estado pronto para ser
revisado por um aprovador.
Nota: As definições de acesso definidas na seção propriedades do formulário de estágio de fluxo de
trabalho são as definições de segurança aplicadas aos itens durante um fluxo de trabalho, não as da seção
Segurança de um estágio de fluxo de trabalho. A seção Segurança define apenas quem tem acesso ao
próprio item do estágio de fluxo de trabalho.
Estágios de Rejeição
Além dos estágios de fluxo de trabalho que compõem um fluxo de trabalho, também há estágios de fluxo
de trabalho que são utilizados como parte da rejeição de um item. Quando um item é rejeitado, um
146
estágio de rejeição pode ser acionado para executar ações predefinidas. Ao término da execução das
ações, o item é retornado para o primeiro estágio do fluxo de trabalho.
Ações do Fluxo de Trabalho:
Cada estágio do fluxo de trabalho contém conjuntos de ações, aquelas que são executadas ao inserir o
estágio e aquelas que são executadas ao sair dele. As ações executadas na saída estão restritas às ações
não programadas, uma vez que devem ser executadas imediatamente.
A tabela a seguir descreve as ações que você pode escolher para estágios do fluxo de trabalho.
Tabela 27. Ações do Estágio de Fluxo de Trabalho
Ações
Detalhes
Publicar
Altera o Status de um item de Rascunho para Publicado. Isto significa que o item
está disponível no site renderizado.
Um item só será publicado depois que tiver digitado um estágio de fluxo de trabalho
que contenha uma ação de publicação e quando a data e a hora publicadas
selecionadas tiverem sido alcançadas.
Expirar
Altera o Status de um item de Publicado para Expirado. Isso significa que o
documento não está mais disponível no site.
Um item só será expirado depois que tiver digitado um estágio de fluxo de trabalho
que contenha uma ação de expiração e quando a data e a hora expiradas selecionadas
tiverem sido alcançadas.
E-mail
Envia e-mails quando executado. É possível criar novas ações de e-mail e especificar
quem serão os destinatários. É possível selecionar aprovadores, autores e proprietários
de e-mail. É possível também criar uma lista de outros usuários ou grupos para
enviar e-mail.
Um link para o Item a ser revisado é incluído no e-mail.
Movimentação Planejada
Executa uma movimentação planejada para o próximo estágio em uma data
especificada. Uma caixa de listagem permitirá que você selecione um de quatro tipos
de data que são inseridos em cada documento individual ou que você especifique
uma data estática.
Versão
Isso criará uma versão de um item quando executado.
Customizado
Também é possível criar ações do fluxo de trabalho customizado criando um plug-in
de fluxo de trabalho customizado. Elas podem ser usadas e planejadas dentro de um
fluxo de trabalho como outras ações do fluxo de trabalho.
Acessando Itens Durante um Fluxo de Trabalho:
Se um item estiver participando de um fluxo de trabalho, o criador receberá acesso de gerenciador para o
item apenas no primeiro estágio do fluxo de trabalho. Conforme o item progride em um fluxo de
trabalho, o acesso ao item é determinado pelo fluxo de trabalho combinado com os níveis de acesso
definidos pelo sistema.
Tabela 28. Níveis de acesso
Nível de Acesso
1º Estágio do Fluxo de Trabalho
Estágios Adicionais do Fluxo de
Trabalho
Ler
v Definido pelo Sistema
v Definido pelo Sistema
v Fluxo de trabalho definido
v Sistema definido
v Sistema definido
Editar
147
Tabela 28. Níveis de acesso (continuação)
Nível de Acesso
1º Estágio do Fluxo de Trabalho
Estágios Adicionais do Fluxo de
Trabalho
Excluir
v Usuário que Criou o Item
v Sistema definido
v Sistema definido
Aprovar
Aprovação Conjunta:
A aprovação conjunta é utilizada em casos nos quais a aprovação de vários usuários é necessária antes de
mover o documento para o próximo estágio.
v Você especifica quais estágios deseja que sejam conjuntamente aprovados.
v Se a aprovação conjunta estiver ativa, então todos os aprovadores especificados para esse estágio
devem aprovar o documento.
v A exceção é um administrador, que pode forçar um documento para o próximo estágio.
v Se um grupo for especificado como um aprovador, apenas um usuário por grupo precisará aprovar o
documento.
v Se esse usuário for membro de um grupo além do Grupo que recebeu acesso para Aprovação, todos os
grupos serão considerados como tendo aprovado o documento.
Exemplo de Fluxo de Trabalho:
Este exemplo descreve as etapas necessárias para criar um Fluxo de Trabalho de quatro estágios.
Ações
As ações requeridas para este fluxo de trabalho são:
Tabela 29. Ações
Ações
Descrição
Publicar
Torna um documento visível como um documento publicado no Web site.
Essa ação de movimentação planejada detecta quando um documento passou de sua
data de expiração e o move para o estágio Expirado.
Expirar
Para a visualização de um documento no Web site.
E-mail
Envia e-mails para usuários selecionados. Neste exemplo, você seleciona
"Aprovadores de Estágio de E-mail".
Estágios
Os seguintes estágios compõem o Fluxo de Trabalho:
Tabela 30. Estágios
Estágio do Fluxo de Trabalho
Estágio 1, Rascunho
148
Ações na Inserção
Descrição
Todo conteúdo começará o Fluxo de
Trabalho nesse Estágio. Todos os
autores de conteúdo estarão
autorizados a utilizar o estágio de
Rascunho.
Tabela 30. Estágios (continuação)
Estágio do Fluxo de Trabalho
Ações na Inserção
Descrição
Estágio 2, Revisar
E-mail
O conteúdo necessitará de um estágio
de revisão antes de ser publicado.
Um pequeno grupo de pessoas estará
autorizado a aprovar o conteúdo
nesse estágio e movê-lo para o
estágio Publicar (Publish). A ação de
e-mail enviará um e-mail a cada
aprovador.
Estágio 3, Publicar
Publicar
Esse é o estágio em que o conteúdo
do Fluxo de Trabalho é publicado. A
ação Publicar é ativada quando a
Data de Publicação é atingida. Nesse
ponto o conteúdo será visível no Web
site. A ação Movimentação Planejada
também será ativada quando a Data
de Expiração for atingida.
Estágio 4, Expirado
A ação Movimentação Planejada
moverá o conteúdo para esse estágio,
em que a ação Expirar parará a
visualização do documento no Web
site.
Expirar
Progredindo Através do Fluxo de Trabalho
Tabela 31. Progredindo Através do Fluxo de Trabalho
Processo
Estágio
Status
Um item é criado e salvo pela
primeira vez:
Estágio 1, Rascunho
Rascunho
Quando o Criador do Item estiver
pronto, ele o moverá para o próximo
estágio.
Estágio 2, Revisar
Rascunho
Um Aprovador acessará o documento
e o revisará. Se aprovado, o item será
movido para o próximo estágio.
Rascunho com Publicação pendente
Publicado
O Status é o Rascunho com
Publicação pendente. Isso ocorre
porque o tempo especificado no
campo Data de Publicação do item
ainda não foi atingido.
Assim que a Data de Publicação for
atingida, o status do item será
alterado para Publicado. O item
continua no Estágio 3, Publicar, mas
seu status é alterado.
149
Tabela 31. Progredindo Através do Fluxo de Trabalho (continuação)
Processo
Quando a Data de Expiração (Expire
Date) for atingida, o documento será
movido para o estágio final.
Estágio
Status
Estágio 4, Expirar
Expirado
Como as ações Movimentação
Planejada e Expirar estão usando a
data Expirado neste exemplo, o
status do item é alterado
imediatamente para Expirado.
Se a ação Movimentação Planejada
usou uma Data Geral antes da Data
de Expiração, então o status do item
permanecerá Expirado com
Publicação pendente até que a Data
de Expiração tenha sido atingida,
mesmo que ela tenha entrado no
Estágio 4, Expirar.
Utilizando fluxos de trabalho e acessando itens de fluxo de trabalho:
Os usuários não precisam acessar as ações ou estágios de um fluxo de trabalho para participar de um
fluxo de trabalho. As ações são executadas utilizando o acesso do sistema e não são determinadas pelo
acesso do usuário que aprovou/rejeitou o item.
Incluindo Fluxo de Trabalho em Páginas Gerenciadas
O fluxo de trabalho padrão usado para páginas gerenciadas tem apenas um estado de rascunho e
aprovado. No entanto, se o fluxo de trabalho padrão não for suficiente, será possível definir fluxos de
trabalho customizados e usá-los com páginas gerenciadas.
Antes de executar essa tarefa, assegure-se de ter incluído a biblioteca Site do Portal na lista de bibliotecas
que é possível editar com o portlet de autoria. No portlet de autoria, clique em Preferências e, em
seguida, clique em Configurar ou Editar Configurações Compartilhadas.
Para usar um fluxo de trabalho customizado com uma página gerenciada, você deve criar um modelo de
página e especificar o fluxo de trabalho customizado no modelo. Quando você cria uma página
gerenciada com base no modelo, o fluxo de trabalho customizado é usado para a página.
1. No portlet de autoria, crie quaisquer estágios do fluxo de trabalho necessários e, em seguida, crie o
fluxo de trabalho customizado.
2. Crie um projeto para usar ao criar o modelo de página.
3.
4.
5.
6.
Nota: Como é possível configurar um fluxo de trabalho apenas nos itens de rascunho, você deve criar
o modelo como um rascunho no contexto de um projeto. Depois de incluir seu fluxo de trabalho
customizado no rascunho, publique o rascunho para tornar o modelo de página disponível.
No menu do projeto, selecione o novo projeto como o contexto atual.
Clique em Administração > Interface com o Usuário do Portal > Modelos de Página.
Clique em Nova Página e crie o modelo da página.
Clique em Salvar Rascunho.
7. Inclua o fluxo de trabalho no modelo.
a. Na barra de ferramentas do site, clique em Editar na seção de propriedades da página.
b. Na janela Propriedades da Página, clique em Segurança.
c. Na seção Fluxo de Trabalho, clique em Selecionar no campo Fluxo de Trabalho.
150
d. Selecione o fluxo de trabalho customizado e salve suas mudanças.
8. Aprove e publique o projeto para tornar o modelo de página disponível para uso.
a. No menu do projeto, clique em Gerenciar na seção de ações do projeto.
b. Selecione o modelo de página na lista de itens do projeto e clique em Mais > Aprovar.
c. Clique em Publicar Projeto.
Depois de concluir essa tarefa, é possível selecionar o novo modelo de página ao criar uma página em
um projeto e o fluxo de trabalho customizado será usado automaticamente.
Melhores Práticas para Projetos
Use estas dicas e diretrizes para desenvolver e publicar projetos de forma mais eficiente.
Usar Projetos Separados para as Diferentes Partes da Estrutura do Site
Coordenar projetos é uma parte importante para assegurar que mudanças feitas no website sejam
publicadas conforme o esperado. Por exemplo, pode haver dois autores trabalhando na mesma parte da
estrutura do site, mas cada um editando páginas em um projeto diferente. Como os autores estão
trabalhando em projetos diferentes, eles não podem ver as mudanças no rascunho feitas pelo outro autor
até que os projetos sejam publicados. Se os dois autores inserirem uma nova página entre as duas
mesmas páginas publicadas, a ordem resultante da página poderá não ser o que se pretendeu.
Para evitar essas situações, evite editar a mesma parte da estrutura do site com diversos projetos ao
mesmo tempo. Em vez disso, ao usar diversos projetos ao mesmo tempo, assegure-se de usar cada
projeto para uma parte diferente da estrutura do site.
Coordenar Mudanças para um Projeto nos Usuários
Quando diversos usuários estiverem trabalhando no mesmo projeto, um usuário poderá não estar ciente
das mudanças feitas por outro usuário. Se você alterar o estado do projeto, como excluí-lo ou publicá-lo,
quaisquer atualizações pendentes de outros usuários não serão salvas. Para garantir que você não
descarte inadvertidamente as mudanças feitas por outros usuários, coordene com os usuários do projeto
antes de alterar o estado do mesmo.
Coordenar Nomes Exclusivos Entre Projetos
Quando diversos projetos são usados para o mesmo site, nomes exclusivos semelhantes podem ser
apresentados em diferentes projetos. Por exemplo, você pode ter dois autores trabalhando no mesmo site,
mas cada um deles editando um projeto diferente. Como os autores estão trabalhando em projetos
diferentes, eles não podem ver os nomes exclusivos de rascunho que outro autor usa até que os projetos
sejam publicados. Se os dois autores inserirem um nome exclusivo semelhante, o resultado poderá ser
diferente do que se esperava.
Para evitar essas situações, evite apresentar novos nomes exclusivos com diversos projetos ao mesmo
tempo. Ao usar diversos projetos ao mesmo tempo, verifique se você usa nomes exclusivos diferentes em
cada projeto.
Páginas Gerenciadas
organização.
151
Páginas gerenciadas são páginas do portal armazenadas no IBM Web Content Manager. Pelo
gerenciamento de páginas do portal de dentro do Web Content Manager, é possível aplicar recursos como
fluxo de trabalho, controle de versão e organização em páginas do portal.
Quando você executa uma nova instalação do IBM WebSphere Portal, as páginas gerenciadas são ativadas
por padrão. No entanto, se você migrar de uma versão anterior ou tiver desativado anteriormente o
recurso, verifique se as páginas gerenciadas estão ativadas, conforme descrito em Configurando Páginas
Gerenciadas.
“Configurando Páginas Gerenciadas” na página 105
Quando você executa uma nova instalação do IBM WebSphere Portal 8.0, as páginas gerenciadas são
ativadas por padrão. No entanto, você também pode desativar e ativar manualmente o recurso conforme
necessário.
Artefatos do WebSphere Portal Afetados pelas Páginas Gerenciadas
É possível gerenciar todos os tipos de páginas do portal, incluindo páginas que usam o tema do Portal
8.0, páginas dinâmicas e páginas estáticas.
Para beneficiar-se de todos os recursos disponíveis para as páginas gerenciadas na interface com o
usuário, você deve usar as páginas que usam o tema do WebSphere Portal 8.0.
Os seguintes artefatos do portal são afetados pelo suporte às páginas gerenciadas:
v Páginas do portal, incluindo propriedades da página, metadados e configurações de layout
v Controle de acesso concedido às páginas do portal
v Ligações públicas que conectam portlets na mesma página ou em páginas diferentes
v Preferências do portlet feitas no modo Editar Configurações Compartilhadas
Os seguintes artefatos do portal não são afetados pelo suporte a páginas gerenciadas e, portanto, não
estão disponíveis para versão ou organização:
v Aplicativos compostos
v Páginas derivadas explicitamente
v Páginas particulares
v Regras de personalização que estão definidas no Personalização e não no Web Content Manager
v Tags e classificações
v Temas e Aparências
v Mapeamentos de URL
v Artefatos que são armazenados no armazenamento de arquivos do WebDAV pelos portlets ou iWidgets
v WSRP Producers
Implementação de Tema do Portal 8.0
Rascunhos e Projetos para Mudanças nas Páginas Gerenciadas
É possível criar, atualizar e aprovar páginas em um estado de rascunho, sem afetar o site publicado. Ao
trabalhar com páginas gerenciadas, é possível editar páginas como rascunhos, gerenciar rascunhos com
fluxo de trabalho de aprovação e, em seguida, organizar para publicar mudanças.
A estrutura da página é replicada na estrutura do site de uma biblioteca de conteúdo da web. Por causa
dessa integração, é possível incluir conteúdo da web diretamente em uma página com o portlet de
autoria. Em seguida, a publicação periódica publica a página gerenciada, assegurando que as mudanças
feitas na página e no conteúdo da web associado sejam publicadas ao mesmo tempo. Atualize as páginas
152
em um estado de rascunho primeiro. Os rascunhos são organizados dentro de projetos no Web Content
Manager. Quando você publica as mudanças no rascunho no site publicado, um projeto coordenará as
atualizações e garantirá que todos os rascunhos sejam publicados ao mesmo tempo.
As seguintes mudanças em uma página resultam em um rascunho que não está visível no site publicado
e está visível apenas dentro do projeto:
v Qualquer ação executada usando a barra de ferramentas, como incluir conteúdo na página, alterar o
estilo da página ou alterar o layout da página.
v Alterar o controle de acesso concedido a uma página.
Alterar as propriedades da página.
Criar uma página filha.
Mover uma página.
Excluir uma página.
Alterar a comunidade ou as associações de conteúdo da web de uma página.
Criar ou modificar ligações de portlet para comunicação entre portlets na mesma página ou em
páginas diferentes.
v Alterar a configuração do portlet com o modo Configurar ou o modo Editar Configurações
Compartilhadas do portlet.
v
v
v
v
v
v
Mudanças nesses elementos de rascunho da página resultam em um novo rascunho ou em uma
atualização de um rascunho existente. Um rascunho de página consiste nos seguintes elementos:
v O próprio item da página, incluindo título, descrição, metadados e propriedades
v O controle de acesso da página
v O layout da página
v Qualquer ligação de página pública que esteja conectada a portlets na mesma página ou em outra
página
v Quaisquer preferências definidas no modo Editar Configurações Compartilhadas
“Visão Geral dos Projetos” na página 134
Os projetos permitem que você altere um conjunto de itens e garante que eles sejam publicados juntos ao
mesmo tempo.
Escopo de Edições para Páginas Gerenciadas
Quando você edita páginas gerenciadas em um projeto, usa o fluxo de trabalho para aprovar as
mudanças antes da publicação, até que sejam aprovadas. Se você editar páginas sem selecionar um
projeto, suas mudanças serão publicadas imediatamente.
A forma recomendada de editar páginas gerenciadas é trabalhar em um projeto. Quando você trabalha
em um projeto, qualquer mudança feita em uma página afetará apenas a visualização dentro do projeto.
Após aprovação e publicação do projeto, as mudanças ficam então disponíveis a todos os usuários.
Nota: Mudanças nas páginas particulares e nas páginas da comunidade não fazem parte de um projeto.
Quando se está trabalhando em um projeto, as ações que personalizam ou criam uma página particular
não ficam visíveis.
Quando nenhum projeto for selecionado, você estará modificando o site publicado. As mudanças em
páginas públicas afetam todos os usuários e estão disponíveis imediatamente. Ao trabalhar no site
publicado, as mudanças que outros usuários estão fazendo nos projetos ativos não ficam visíveis.
Fluxo de trabalho padrão para páginas gerenciadas em projetos
153
Para disponibilizar as mudanças feitas na página no site publicado, você deve submeter a página para
revisão e aprovação. As etapas para o fluxo de trabalho dependem do que está definido para a página.
Por padrão, um fluxo de trabalho simples é designado aos rascunhos de mapeamento da página ou da
URL. O fluxo de trabalho padrão (Fluxo de Trabalho Express) possui apenas dois estados: rascunho e
aprovado. Para páginas que usam esse fluxo de trabalho, enviar o rascunho moverá a página para o
estado pendente público. Quando todas as mudanças no projeto estiverem publicadas, a página de
rascunho pendente também será publicada. Depois que todos os itens no projeto atingirem o estado
pendente de publicação, você poderá publicar o projeto clicando em Publicar no menu de projetos.
Nota: Se você usar o portlet de autoria para editar as configurações de acesso para uma página que faça
parte de um fluxo de trabalho, não poderá modificar os aprovadores. Para alterar os aprovadores da
página, você deve configurar os aprovadores no estágio do fluxo de trabalho que contém atualmente a
página.
No entanto, você pode alterar o fluxo de trabalho designado na interface com o usuário para incluir os
estágios de revisão e aprovação adicionais no nível de projeto do Web Content Manager. Depois que as
mudanças do rascunho no projeto são aprovadas e publicadas, as páginas atualizadas ficam visíveis a
todos os usuários. Para obter detalhes sobre como usar um fluxo customizado, consulte Incluindo Fluxo de
Trabalho em Páginas Gerenciadas.
“Incluindo Fluxo de Trabalho em Páginas Gerenciadas” na página 150
O fluxo de trabalho padrão usado para páginas gerenciadas tem apenas um estado de rascunho e
aprovado. No entanto, se o fluxo de trabalho padrão não for suficiente, será possível definir fluxos de
trabalho customizados e usá-los com páginas gerenciadas.
Modo de Edição e Páginas de Administração
Como as páginas de administração não devem ser editadas, elas são excluídas dos recursos do modo de
edição fornecidos pela barra de ferramentas do site.
Quando você navega para uma página de administração, a barra de ferramentas do site sai
automaticamente do modo de edição. Os recursos do modo de edição são suprimidos pelo parâmetro da
página theme.disable.edit.mode no rótulo da página de Administração (nome exclusivo
wps.Administration). Configurar o parâmetro na página de administração de nível superior também faz
com que as páginas filhas sejam afetadas.
É possível configurar o parâmetro theme.disable.edit.mode em qualquer página em que você queira
desativar o modo de edição na barra de ferramentas do site. Edite as propriedades da página e inclua o
parâmetro theme.disable.edit.mode com um valor de true.
Páginas Gerenciadas e Gerenciamento do Site
O uso de páginas gerenciadas é o método preferencial para o gerenciamento de site. O portlet Resource
Manager foi descontinuado na Versão 8.0, mas ainda pode ser usado em ambientes em que as páginas
gerenciadas não estão disponíveis.
Para obter informações sobre o gerenciamento de site com o portlet Gerenciador de Recursos, consulte a
Documentação do Produto da Versão 7: Gerenciando o seu Site.
Documentação do Produto da Versão 7: Gerenciando seu Site
Páginas Gerenciadas e o Portlet de Autoria
Ao criar uma página gerenciada no portal, um item de página correspondente é criado na biblioteca de
sites do portal. Os itens da página são representados como áreas do site da página do portal na biblioteca
de conteúdo da web.
154
Por padrão, o nome de exibição da área de site da página do portal baseia-se no título da página do
portal. O Web Content Manager designa um nome exclusivo na biblioteca para cada área de site da
página do portal. Esse nome exclusivo permite que você tenha páginas com o mesmo título organizado
em áreas de site da página do portal separadas.
Embora seja possível visualizar os itens da página no portlet de autoria, os itens são somente leitura. Para
alterar, mover ou excluir os itens da página, você deve usar a interface com o usuário do portal. No
entanto, é possível usar o portlet de autoria para incluir áreas de site e itens de conteúdo na estrutura do
site da página gerenciada. Nesse caso, o conteúdo que você inclui é renderizado automaticamente pelos
componentes, como menus ou navegadores, e por visualizadores de conteúdo da web.
Nota: Se você excluir uma página do portal, a área de site da página do portal será excluída da biblioteca
de conteúdo da web. Se a área de site da página do portal contiver qualquer outra área de site ou itens
de conteúdo eles também serão excluídos.
Associações de Conteúdo do Sistema
As associações de conteúdo do sistema são usadas para associar uma página do portal com seus artefatos
correspondentes em IBM Web Content Manager. Uma associação de conteúdo do sistema é uma extensão
da associação de conteúdo padrão.
Uma associação de conteúdo padrão mapeia uma página de conteúdo da web ou um visualizador de
conteúdo da web para conteúdo em uma biblioteca de conteúdo da web. Para uma associação de
conteúdo do sistema, há um sinalizador de sistema adicional que distingue entre associação e associação
de conteúdo. Como as associações de conteúdo da web, as associações de conteúdo do sistema apontam
para objetos em uma biblioteca de conteúdo da web. No entanto, os objetos são associados a uma página
gerenciada em vez de a conteúdo. As associações de conteúdo do sistema são gerenciadas pelo portal.
O sinalizador system é um sinalizador particular, somente leitura, e não pode ser modificado
programativamente usando a API pública ou a API REST. No entanto, é possível usar essas interfaces
para consultar uma associação de conteúdo e determinar se é uma associação de conteúdo do sistema ou
uma associação de conteúdo padrão.
Melhores Práticas para Páginas Gerenciadas
Use estas dicas e diretrizes para desenvolver e implementar páginas gerenciadas com mais eficiência.
Criar Links no Conteúdo da Web para Páginas do Portal
Ao ativar páginas gerenciadas, é possível criar links para páginas do portal a partir do portlet de autoria
no IBM Web Content Manager. É possível criar links para páginas do portal de duas maneiras:
v Editando um item de conteúdo no editor de rich text e inserindo um link.
v Criando um componente de link.
Para selecionar a página do portal, clique em Navegar pelo Conteúdo no campo Link e navegue até a
página na biblioteca do Site do Portal.
Integridade referencial aplica-se a links para páginas do portal. Não será possível excluir uma página do
portal se existir um link que aponte para essa página. É possível visualizar ou remover essas referências
de link das seguintes maneiras:
v Edite as propriedades da página na interface com o usuário do portal e selecione Visualizar
Referências.
v Selecione o item da página no portlet de autoria no Web Content Manager e clique em Mais >
Visualizar Referências.
155
Quando os usuários clicam em um link, o link é resolvido de acordo com a associação de conteúdo do
sistema do item da página do portal na biblioteca do Site do Portal. Com base na associação de conteúdo
do sistema, a página de portal apropriada é exibida.
Importante: Não é possível alterar as associações de conteúdo do sistema por meio de operações típicas
com a interface com o usuário. No entanto, é possível alterar as associações de conteúdo do sistema por
meio de interfaces programáticas, como a interface de configuração XML (comando xmlaccess) ou outras
operações do banco de dados de baixo nível. Se uma associação de conteúdo do sistema for alterada ou
corrompida por meio de um método desse tipo, o link poderá não ser mais resolvido.
Usar URLs Amigáveis Exclusivas com Páginas Gerenciadas
Ao criar páginas gerenciadas, não é possível impingir programaticamente exclusividade das URLs
amigáveis. Devido a esse comportamento, é possível criar diversas páginas com a mesma URL amigável,
o que pode produzir resultados inesperados. Para evitar possível confusão, verifique se todas as URLs
amigáveis criadas são exclusivas.
Usar o Processamento de Transação com a Interface de Configuração XML
Como as páginas gerenciadas são armazenadas na biblioteca de sites do Portal no Web Content Manager,
cada página tem objetos correspondentes no banco de dados JCR. Você deve estar ciente dessa relação ao
criar, atualizar ou excluir páginas gerenciadas com a interface de configuração XML. Se o processamento
de xmlaccess for interrompido, ele poderá resultar em incompatibilidade entre o estado da página e o
estado do banco de dados.
Para garantir que as informações de página e do banco de dados de uma página gerenciada permaneçam
sincronizadas, use o atributo transaction-level do elemento request no arquivo XML. Para obter mais
informações sobre como usar o atributo transaction-level, consulte Referência de Configuração XML.
Por exemplo:
<request
type="update"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="PortalConfig_8.0.0.xsd"
transaction-level="resource">
Resolvendo Problemas de Páginas Gerenciadas
Ao usar páginas gerenciadas, você pode encontrar problemas que estão relacionados a projetos, direitos
de acesso ou outras questões.
O usuário A não pode visualizar o projeto X
Verifique se o usuário A tem os seguintes direitos de acesso:
v Usuário no projeto. Especifique este acesso editando o projeto e incluindo o usuário A na lista Usuário
da seção Acesso.
v Usuário no recurso virtual WCM_REST_SERVICE. Especifique este acesso no portal clicando em
Administração > Acesso > Permissões do Recurso e editando o recurso WCM_REST_SERVICE.
O Usuário A Não Pode Modificar uma Página Publicada ou de Rascunho
Verifique os seguintes problemas como possíveis causas:
v Se a página fizer parte de um fluxo de trabalho, verifique se o usuário A tem acesso de Editor ao
estágio atual do fluxo de trabalho.
156
v A herança de controle de acesso está ativada para a área de site da página do portal? A configuração
está ativada por padrão, mas pode ser desativada quando necessário. Verifique a configuração editando
a área de site da página de portal e visualizando a seção Acesso das propriedades para determinar se a
configuração Herança está selecionada.
Se a herança de controle de acesso estiver desativada, verifique se o usuário A tem acesso de Editor à
área de site da página do portal.
Por que o Usuário A Recebe a Mensagem "Você Está Customizando esta Página.
As Mudanças Estarão Visíveis Apenas para Você"?
Esta mensagem é gerada porque o usuário A tem acesso de Usuário Privilegiado à página. Esse nível de
acesso é o acesso padrão para um usuário recentemente criado e as mudanças que o usuário faz ficam
visíveis apenas a ele.
Se você quiser que as mudanças que o usuário A faz fiquem visíveis a todos os usuário dessa página, o
usuário A precisará de acesso de Editor na página.
O Usuário A Está em um Projeto e Recebe a Mensagem "Você Está Customizando
esta Página. As Mudanças Estarão Visíveis Apenas para Você" e um Rascunho
Não Será Criado
Esta mensagem é gerada porque o usuário A tem o acesso de Usuário Privilegiado à página. Esse nível
de acesso é o acesso padrão para um usuário recentemente criado e as mudanças que o usuário faz ficam
visíveis apenas a ele.
Para criar um rascunho em um projeto, o usuário A requer um dos seguintes acessos:
v Direitos de editor da página.
v Acesso de usuário na página e acesso de Aprovador no item da página de conteúdo da web
correspondente.
O Usuário A Não Pode Arrastar o Conteúdo da Barra de Ferramentas do Site na
Página
Ao usar a barra de ferramentas do site e tentar incluir o conteúdo da categoria Conteúdo na barra de
ferramentas, o seguinte acesso será requerido para o usuário A:
v Direitos de editor da página.
v Direitos de usuário no portlet do visualizador de conteúdo da web que o usuário A deseja incluir.
As Páginas do Portal Não Estão Sincronizadas com as Áreas de Site da Página do
Portal na Biblioteca de Sites do Portal
Geralmente, as páginas no portal e suas áreas de site da página de portal correspondentes na biblioteca
de sites do portal são automaticamente sincronizadas. No entanto, em alguns casos, esses artefatos
podem se tornar dessincronizados. Por exemplo, essa situação pode ocorrer ao restaurar dados de um
backup ou de erros ao criar a área de site da página do portal depois que a página do portal é criada.
Você pode ressincronizar a biblioteca de sites do portal com base na estrutura de páginas do portal atual
que está armazenada no banco de dados do portal. Ao executar essa sincronização, o banco de dados do
portal atuará como um repositório principal. Qualquer área de site da página do portal na biblioteca de
sites do portal que não corresponda às páginas do portal existentes será removida da biblioteca de sites
do portal. Qualquer área de site de conteúdo ou item de conteúdo na área de site da página do portal
afetada também será removida.
Para executar esta ressincronização, execute a tarefa de configuração create-page-nodes, conforme
descrito em Ativando Páginas Gerenciadas.
157
Importante: Essa tarefa também remove todas as páginas de rascunho que não são localizadas na
biblioteca de sites do portal.
Problemas Conhecidos para Páginas Gerenciadas
Você pode rever os problemas conhecidos das páginas gerenciadas.
Entidades de Portlet Remotas não Reconhecem Projetos
Objetos PortletEntity armazenados no domínio de Liberação do banco de dados do portal reconhecem
projetos. Mudanças feitas em uma entidade de portlet, como a configuração e modificação de
preferências, são refletidas como uma mudança limitada ao projeto ativo. Mudanças em um portlet feitas
no projeto ativo não são visíveis no site publicado até que as mudanças sejam organizadas.
Essa capacidade de modificar um portlet em um projeto não se aplica a portlets remotos que são
produzidos com o WSRP. Como sistema remoto, o Produtor do WSRP é responsável pelo gerenciamento
de entidades de portlet. No entanto, como o Produtor do WSRP não reconhece o projeto, o Produtor não
pode diferenciar entre as seguintes mudanças:
v Mudanças feitas na entidade de portlet remoto diretamente no site publicado.
v Mudanças feitas na entidade de portlet remoto ao visualizar e interagir com um projeto.
Devido a essa limitação, as mudanças feitas em um projeto são exibidas imediatamente no site publicado
por meio da entidade de portlet remoto.
Problemas com o Portlet de Autoria
Resultados da Procura para Itens da Página no Portlet de Autoria
Ao procurar no portlet de autoria com o filtro Títulos ou Descrições, nenhum resultado é
retornado para os itens da página. Para assegurar-se de que os resultados da procura sejam
retornados, use o filtro Todos os atributos. Os itens da página são incluídos nos resultados da
procura porque os atributos de título e descrição são armazenados em um documento XML no
item da página.
Ordem de classificação das páginas gerenciadas
Quando exibidas no portlet de autoria, as páginas gerenciadas são listadas de acordo com os IDs
das páginas, e não com os títulos da página. Se você tentar classificar páginas por título, esse
comportamento fará com que as páginas sejam exibidas em uma ordem inesperada. Esse
comportamento de classificação também se aplica a qualquer janela ou visualização, como a
janela Gerenciar Projeto, que é baseada no portlet de autoria.
Alterando a Ordem das Páginas Gerenciadas no Portal
Você pode modificar a ordem e a hierarquia das páginas gerenciadas no portal apenas com a barra de
ferramentas do site na interface do portal. Se você mover a área de site da página do portal no portlet de
autoria, a ordem da página no portal não será afetada.
Regras de Personalização
v As regras do Personalização que você cria usando o editor do Personalização não são gerenciadas no
Web Content Manager e, portanto, não estão disponíveis para versão ou incluídas na organização.
Essas regras devem ser publicadas usando o comando pznload ou publicando com Personalização.
v As regras do Personalização não têm conhecimento dos projetos e status dos itens em um projeto. Por
causa dessa característica, as regras operam apenas no conteúdo publicado e não incluem itens de
rascunho.
158
Suporte Limitado para Páginas Derivadas
As páginas explicitamente derivadas que estão no domínio da liberação podem ser gerenciadas pelo Web
Content Manager. No entanto, se você modificar uma página explicitamente derivada, essa mudança não
gerará rascunhos para todas as páginas derivadas. Se você desejar que a mudança ocorra em todas as
páginas derivadas, deverá editar cada página derivada separadamente. Para obter informações adicionais,
consulte a documentação sobre páginas derivadas.
Definições de Configuração do Portlet
Modo Configurar
Se você alterar as definições de configuração de um portlet no modo Configurar, essas mudanças
serão globais e não estarão limitadas à página. Como as mudanças são globais, elas não podem
ser gerenciadas no Web Content Manager e portanto não poderão ser organizadas em outro
servidor. Para transferir essas mudanças para outro servidor, use a interface de configuração XML
(comando xmlaccess).
Modo Editar Configurações Compartilhadas
Se você alterar as definições de configuração de um portlet no modo Editar Configurações
Compartilhadas, essas mudanças farão parte da página. Como as mudanças fazem parte da
página, elas não são gerenciadas no Web Content Manager e serão automaticamente organizadas
para outros servidores.
Assistente de Novo Site Não Suportado
O Assistente de Novo Site para criar portais virtuais não é suportado quando páginas gerenciadas são
ativadas.
Publicação Automática e Itens Excluídos
Quando você especifica a publicação automática para um projeto, o projeto é publicado assim que todos
os itens nele atingem um estado de "pendente." Exclusões não passam por um estágio de aprovação
explícita e estão disponíveis para publicação imediatamente. Se seu projeto consistir de apenas exclusões,
a publicação automática do projeto poderão ocorrer prematuramente.
Para evitar essa publicação automática, você pode concluir as seguintes etapas:
v Garanta que o projeto contenha novas páginas ou mudanças para páginas, que exigem aprovação antes
da publicação.
v Configure o projeto para usar a publicação manual.
Organização e Versão
v Você não pode organizar a biblioteca de sites do portal entre servidores que possuem diferentes ofertas
de produtos instaladas. Por exemplo, você não pode organizar a biblioteca de sites do portal a partir
de um servidor com o WebSphere Portal Enable instalado para um servidor com o WebSphere Portal
Express instalado.
v O recurso de versão do Web Content Manager também se aplica às páginas gerenciadas e permite que
você execute tarefas diferentes com versões da página. As tarefas de versão incluem versões de
salvamento, exclusão e restauração. A janela Propriedades da Página lista as versões da página na guia
Avançada. No entanto, se você criar uma página e organizá-la pela primeira vez, as informações de
versão estarão vazias quando você visualizar as propriedades da página no servidor de entrega. Após
operações de organização subsequentes, as informações de versão serão listadas.
159
Páginas e Tipos de Páginas: Páginas Compartilhadas, Derivadas e Ocultas
Administrando Páginas Gerenciadas
É possível executar tarefas de administração avançadas para páginas gerenciadas, como gerar URLs para
projetos ou trabalhar com projetos usando scripts.
Geração de URL do Projeto
É possível redirecionar o processamento para um projeto específico gerando URLs com a API de
ProjectIdentificationService, a API REST ou a API do Ativador. O processamento de solicitações opera
completamente no escopo de um projeto ou completamente fora do escopo de um projeto. Não é possível
alternar projetos durante o processamento da solicitação.
Quando uma solicitação originar-se de um projeto, a URL da solicitação conterá um identificador de
projeto para esse projeto. As informações sobre o projeto são incluídas apenas na URL e não são ligadas à
sessão. O identificador de projeto pode ser um ID de objeto (OID), conforme usado pelo portal, ou um
identificador exclusivo universal (UUID), conforme usado pelo Web Content Manager. Para direcionar o
processamento da solicitação para um projeto específico, você deverá gerar uma URL para o projeto e, em
seguida, renderizar a URL.
API Java
Para gerar URLs que tenham como destino um projeto usando a API Java no portal, será possível usar a
API de ProjectIdentificationService com a API de StateManagerService:
v O ProjectIdentificationService fornece métodos para criar um objeto ServerContext, com base no
identificador do projeto de destino e no objeto ServerContext atual.
v O objeto ServerContext específico do projeto pode então ser usado para recuperar um objeto
URLFactory do serviço do gerenciador de estado. Todas as URLs geradas com esse factory contêm o ID
do projeto.
Este exemplo constrói uma URL do portal para o estado de navegação atual para um novo projeto:
// construir um contexto do servidor para o projeto
final ServerContext projectCtx = projectService.createServerContext(
projectID, stateService.getServerContext());
// acessar o factory da URL para criar uma URL
final URLFactory urlFct = stateService.getURLFactory(projectCtx);
// construir uma URL para o estado atual
final EngineURL url = urlFct.newURL(Constants.SMART_COPY);
url.writeDispose(out);
// concluída a geração de URL
urlFct.dispose();
Este exemplo constrói uma URL do portal para um URI em um projeto específico:
// construir um contexto do servidor para o projeto
final PocServerContext projectCtx = projectService.createServerContext(
projectID, pocService.getServerContext());
// acessar o factory da URL para criar uma URL
final DisposablePocURLFactory urlFct = pocService
.getURLFactory(projectCtx);
// construir uma URL para o estado atual
final PocURL url = urlFct.newURL(PocURLFactory.LATE_BINDING);
url.setMode(Constants.VALUE_DOWNLOAD);
url.setURI(new URI("test:abc"));
160
// serializar
url.writeDispose(out);
// concluída a geração de URL
urlFct.dispose();
API do REST
Se o aplicativo usar a arquitetura Representational State Transfer (REST), será possível usar as APIs
remotas fornecidas com o portal para construir URLs específicas do projeto.
API do Ativador
Se você estiver usando a API do Ativador, poderá passar o identificador do projeto para a API de geração
de URL como o parâmetro project no objeto de parâmetros. O identificador do projeto pode ser um OID
ou um UUID serializado.
// obter o estado de navegação atual
var state = com.ibm.mashups.enabler.model.state;
var navState = state.NavigationStateModelFactory.getNavigationStateModel();
// obter o gerador de URL
var urlGen = state.UrlGeneratorFactory.getURLGenerator();
urlGen.getURL(navState, function(url) { alert(url); }, { "project": "UUID-of-Project" } );
Controle de Acesso para Páginas Gerenciadas
O controle de acesso para páginas gerenciadas fornece mais recursos do que o controle de acesso para
páginas de portal padrão. Além dos recursos de controle de acesso disponíveis para páginas por meio da
administração do portal, também é possível aplicar recursos do IBM Web Content Manager, como fluxo
de trabalho e organização, ao controle de acesso.
Ao criar uma página gerenciada no portal, um item de página correspondente é criado em uma biblioteca
de conteúdo da web. É possível visualizar e alterar as configurações de controle de acesso para uma
página gerenciada de duas maneiras:
v Navegando para a página e usando a barra de ferramentas do site
v Abrindo o item de página correspondente no portlet de autoria de conteúdo da web
Independentemente do método usado para alterar uma configuração de controle de acesso, o elemento
correspondente é atualizado automaticamente. Essa sincronização garante que permissões efetivas sejam
coordenadas entre a página de portal e o item de página de conteúdo da web.
Considerações Especiais
Como as páginas gerenciadas integram recursos das páginas de portal e do Web Content Manager,
existem considerações especiais que se aplicam ao controle de acesso das páginas gerenciadas.
Conjunto unificado de funções aplicáveis com diferentes recursos efetivos
Com páginas gerenciadas, as páginas do portal e o Web Content Manager estão cientes das
mesmas funções; no entanto, algumas funções são efetivamente ignoradas no Web Content
Manager. Por exemplo, as funções de Usuário Privilegiado e Editor de Marcação são usadas com
páginas do portal para suportar recursos como a personalização de uma página. No Web Content
Manager, essas funções não têm efeito no controle de acesso.
Ao executar uma ação de conteúdo da web em uma página gerenciada, como visualização,
publicação ou organização da página, o Web Content Manager conta com as funções do portal.
Esse reconhecimento garante que as páginas retenham suas permissões apropriadas das funções.
Para obter detalhes sobre as funções do portal, consulte Funções.
161
Grupos virtuais no Web Content Manager (autores, proprietários, criadores)
No Web Content Manager, é possível conceder acesso a grupos virtuais (autores, proprietários,
criadores) por meio do portlet de autoria de conteúdo da web ou como parte de um estágio do
fluxo de trabalho. As páginas do portal não fornecem um mecanismo equivalente. Quando você
concede permissões em um item de página a usuários ou grupos com os grupos virtuais, os
mapeamentos de função direta são designados na página de portal. Esses mapeamentos de
função garantem que permissões iguais sejam aplicadas.
O grupo virtual do proprietário, no entanto, limita-se a um único proprietário para itens de
página no Web Content Manager. O proprietário da página de portal é sincronizado
automaticamente com o proprietário do item de página. Esse proprietário possui o mesmo
conjunto de ações permitidas como a função Gerenciador, conforme descrito na seção Propriedade
de Funções.
Importante: Se você estiver usando grupos de autores ou de criadores para o gerenciamento do
controle de acesso no Web Content Manager, use apenas o portlet de autoria para executar as
tarefas de controle de acesso. Não use a barra de ferramentas do site na interface do portal para
revogar permissões, pois isso pode levar a uma designação potencialmente complexa de
permissões.
Suporte de Passagem para Páginas de Portal
Com páginas de portal, o suporte de passagem fornece permissões implícitas que permitem que
os usuários naveguem por meio de uma hierarquia de página. Por exemplo, um usuário pode ter
permissão para acessar uma página filha, mas pode não ter permissão para acessar a página pai.
Devido ao suporte de passagem, o usuário tem permissão para navegar para a página filha.
Consulte Funções para obter detalhes sobre suporte de passagem.
No entanto, o suporte de passagem não é fornecido para itens de conteúdo da web. Os autores
de conteúdo que usam o portlet de autoria devem ser designados à função de Usuário em todas
as páginas superiores à página filha para navegar para conteúdo editável. Sem essa permissão de
acesso, o conteúdo editável não será visível no portlet de autoria, embora o autor possa acessar a
página. As tarefas típicas de administração de página ainda podem ser executadas na página.
Permissões concedidas por meio de recursos virtuais
Com as páginas de portal tradicionais, é possível conceder permissões nos recursos virtuais
PORTAL e CONTENT_NODES que herdam permissões para a hierarquia de página completa.
Essa herança é descrita em Recursos. Você também pode especificar uma herança semelhante para
bibliotecas de conteúdo da web herdadas a partir do nó raiz.
Como as permissões para páginas gerenciadas são sincronizadas entre páginas de portal e itens
de página no Web Content Manager, essa herança é problemática. Essa herança pode resultar em
permissões efetivas diferentes nas páginas de portal e nos itens de conteúdo. Embora seja
possível gerenciar permissões corretamente por meio da página ou do portlet de autoria, a
abordagem preferencial é por meio da página. Se você conceder permissões para a hierarquia de
página inteira com herança, conceda essa permissão no recurso raiz da hierarquia de página
(página wps.content.root). Como a permissão neste nó de página é sincronizada com o item de
página correspondente no Web Content Manager, as permissões efetivas são sincronizadas
automaticamente por meio da hierarquia.
Permissões de controle de acesso gerenciadas por fluxos de trabalho
Ao trabalhar com páginas gerenciadas, você pode aplicar controle de acesso para itens da página
por meio de estágios e ações do fluxo de trabalho, conforme descrito em Gerenciamento de Fluxo de
Trabalho e Mudança. Além das permissões do fluxo de trabalho, você também pode especificar
permissões na página com a barra de ferramentas do site. As mudanças feitas com a barra de
ferramentas do site substituem as permissões de acesso em vigor pelo estágio do fluxo de
trabalho atual. Quando o próximo estágio do fluxo de trabalho for inserido, as mudanças da
barra de ferramentas do site serão reconfiguradas e as permissões especificadas pelo estágio do
fluxo de trabalho entrarão em vigor.
162
Suporte de Segurança Externo
Você não pode usar as funções externalizadas ou mapeamentos de funções com páginas
gerenciadas. As páginas não podem ser externalizadas enquanto estão sendo editadas em um
projeto. De modo semelhante, os recursos externalizados não podem ser incluídos em um projeto.
Permissões requeridas
As permissões a seguir são requeridas para ações típicas com páginas gerenciadas.
Tabela 32. Permissões requeridas para ações típicas com páginas gerenciadas.
Esta tabela descreve as permissões requeridas para ações típicas com páginas gerenciadas
Ação
Permissão requerida
Acessar uma visualização de projeto na barra de
ferramentas do site
Usuário no recurso virtual WCM_REST_SERVICE
Visualizar um projeto na barra de ferramentas do site
v Usuário no recurso virtual WCM_REST_SERVICE,
além das permissões que são necessárias para
visualizar um projeto específico
v Usuário no projeto selecionado
Criar um projeto
v Contribuidor na biblioteca do Site do Portal
Criar um rascunho de uma página publicada editando a
página em um projeto
v Editor na página
Crie um rascunho de uma página publicada com a ação
Criar Rascunho na barra de ferramentas do site.
v Usuário na página e Aprovador no item de página de
conteúdo da web correspondente. Para obter detalhes,
consulte “Função de aprovador para criar páginas de
rascunho” na página 164.
Criar um rascunho de página filho em uma página pai
de um projeto
v Contribuidor ou Editor na página pai
Visualizar um projeto
v Poder Executar como Usuário no recurso virtual
USERS
v O usuário que está personificado requer pelo menos
acesso de usuário para a página atual do portal. Se um
usuário anônimo não tiver acesso à página, a opção de
visualização Como Usuário Não Autenticado não
estará disponível na barra de ferramentas do site.
Além disso, se você selecionar a opção de visualização
Como Usuário, não poderá selecionar usuários que
não tenham acesso à página.
Por padrão, apenas usuários e usuários não
autenticados que possuem acesso explícito ao projeto
podem visualizá-lo. Você pode designar globalmente
acesso para usuários ou usuários não autenticados
para visualizar todos os itens em todas as bibliotecas e
projetos em um portal virtual específico ou portal
virtual padrão. Para designar esses direitos, use a
configuração Configurar Acesso Raiz no portlet de
administração da biblioteca (Administração >
Conteúdo do Portal > Bibliotecas de Conteúdo da
Web).
163
Tabela 32. Permissões requeridas para ações típicas com páginas gerenciadas (continuação).
Esta tabela descreve as permissões requeridas para ações típicas com páginas gerenciadas
Ação
Permissão requerida
Crie o conteúdo da web incluindo o visualizador de
conteúdo da web em uma página. O visualizador é
configurado para criar e renderizar conteúdo de uma
biblioteca de conteúdo da web.
v Editor na página
v Usuário no portlet de visualizador
v Nenhuma permissão de biblioteca é impingida.
Execute a edição sequencial do conteúdo em uma página v Editor na página
v Permissões adequadas na biblioteca que possuem o
conteúdo
Para obter as permissões necessárias para páginas do portal e itens de conteúdo da web, consulte
Permissões de Acesso para páginas de portal e Funções de Usuário e Acesso para itens de conteúdo da web.
O conjunto padrão de permissões de controle de acesso para usuários anônimos e para membros do
grupo Todos os Usuários Autenticados é descrito em Configurações de Controle de Acesso Inicial. Com
páginas gerenciadas, as seguintes permissões padrão existem:
v Usuários anônimos podem visualizar projetos e ter acesso de Usuário à biblioteca do Site do Portal.
v Os membros do grupo Todos os Usuários Autenticados podem criar novos projetos e ter acesso de
Editor à biblioteca de sites do portal. Esse acesso garante que os usuários possam executar tarefas de
edição sequenciais. Você pode restringir acesso conforme necessário ao portlet de administração da
biblioteca.
Para modificar uma página de portal ou um item de página, é necessário apenas aquelas permissões
necessárias para executar a ação a partir da interface com o usuário ou a API de programação. Também
não são requeridas permissões para as ações de sincronização subjacentes que ocorrem automaticamente.
Essas atualizações automáticas são executadas com privilégios no sistema.
Por exemplo, é possível incluir um portlet em uma página usando a barra de ferramentas do site. Nesse
caso, você requer permissões suficientes na página que está editando e no portlet que está incluindo. No
entanto, não é necessário permissões adicionais para as atualizações internas e os itens correspondentes
na biblioteca de conteúdo da web.
Função de aprovador para criar páginas de rascunho
Com páginas gerenciadas, é possível usar um fluxo de trabalho para permitir que usuários corporativos
criem versões rascunho de páginas que eles normalmente não têm permissão para editar. Usando um
fluxo de trabalho dessa maneira, você executa dois procedimentos:
v Fornece aos usuários de negócios a capacidade de modificar páginas.
v Pode ainda assegurar que os rascunhos sejam revisados e aprovados por usuários técnicos antes que as
mudanças sejam publicadas no site externo.
Normalmente, um usuário com acesso de Usuário para uma página tem permissão apenas para visualizar
a página. Mas se o usuário também tiver acesso de Aprovador para o item de página correspondente na
biblioteca do Site do Portal, ele poderá criar rascunhos de página. Quando um usuário tem esse acesso,
ele pode navegar para a página de portal e usar a barra de ferramentas do site para criar um rascunho.
Para permitir que usuários corporativos criem páginas de rascunho, conclua as etapas a seguir:
1. Na biblioteca do Site doe Portal, designe um fluxo de trabalho aos itens de página que correspondem
às páginas de portal que os usuários devem modificar. Por padrão, os itens de página não são
gerenciados em um fluxo de trabalho.
164
2. Edite o estágio de publicação do fluxo de trabalho e atualize as propriedades de controle de acesso
para incluir os usuários na função de Aprovador.
3. Edite o estágio de rascunho inicial do fluxo de trabalho e atualize as propriedades de controle de
acesso. Inclua os usuários nas funções que correspondem às permissões que os usuários necessitam
nas páginas de rascunho criadas por eles.
Função de Contribuidor para criar páginas filho
Os usuários com acesso de Contribuidor à versão publicada de uma página podem criar páginas filho
nessa página. Quando no modo de edição da página pai, os contribuidores podem usar a barra de
ferramentas do site para criar uma página filho.
“Gerenciamento de Fluxo de Trabalho e Mudanças” na página 137
Funções
Recursos
Permissões de Acesso
Funções e Acesso do Usuário
Definições Iniciais de Controle de Acesso
Interface de Script do Portal e Suporte a Projetos
Com a Interface de Script do Portal, é possível criar scripts Jacl ou Jython para automatizar o
gerenciamento de projetos.
Usando o bean de Projeto com a Interface de Script do Portal, é possível executar as seguintes ações em
projetos:
v Listar todos os projetos disponíveis
v Criar e excluir projetos
v Recuperar informações sobre um projeto específico
v Recuperar atributos específicos do código de idioma para projetos
v Aprovar projetos
v Publicar projetos
v Configurar projeto ativo
Para executar comandos com o bean de Projeto, é possível usar o bean de Portal para configurar um
projeto como o contexto para comandos subsequentes.
Listar Projetos
Para recuperar uma lista de projetos, use o método listall. Este método retorna os nomes dos projetos.
v Sintaxe de Jacl: $Project listall
v Sintaxe da Jython: Project.listall()
Exemplo de Jacl:
wsadmin>$Project listall
"TestProject1"
Exemplo da Jython:
wsadmin>Project.listall()
’"TestProject2" "TestProject1"’
165
Criar Projetos
Para criar um projeto, use o método create.
v Sintaxe Jacl: $Project create "project_name"
v Sintaxe Jython: Project.create("project_name")
Exemplo de Jacl:
wsadmin>$Project create "TestProject1"
TestProject1
Exemplo da Jython:
Project.create("TestProject1")
’TestProject1’
Nota: Se você criar um projeto com a Interface de Script do Portal, o projeto não será listado com os
projetos recentes no menu de projetos.
Excluir Projetos
Para excluir um projeto, use o método delete.
v Sintaxe Jacl: $Project delete "project_name"
v Sintaxe Jython: Project.delete("project_name")
Exemplo de Jacl:
wsadmin>$Project delete "TestProject1"
Exemplo da Jython:
wsadmin>Project.delete("TestProject1")
Recuperar Detalhes do Projeto
Recupere detalhes do projeto com o método details. Esse método retorna as seguintes informações sobre
o projeto: o identificador exclusivo universal (UUID), o estado, o nome e o título.
v Sintaxe Jacl: $Project details "project_name"
v Sintaxe Jython: Project.details("project_name")
Exemplo de Jacl:
$Project details "TestProject1"
uuid : bb571f0c-2143-4bcc-ba42-358a64d75116
state: ACTIVE
name : TestProject1
title: TestProject1
items:
testpage1 (draft / new)
Exemplo da Jython:
wsadmin>print Project.details("TestProject1")
uuid : 255f129d-cc46-4d83-823d-80f9a28d13f5
state: ACTIVE
name : TestProject1
title: TestProject1
items:
testpage1 (draft / new)
Recuperar Atributos Traduzidos
Se algum atributo de projeto for convertido, como o título ou a descrição, será possível recuperar esses
atributos com o método nlsget. Especifique o atributo com um dos seguintes parâmetros:
v Título: title ou t
v Descrição: description, descr ou d
166
v Sintaxe Jacl: $Project nlsget "project_name" attribute_parameter [locale]
v Sintaxe Jython: Project.nlsget("project_name","attribute_parameter"[,"locale"])
Exemplo de Jacl:
wsadmin>$Project nlsget "TestProject1" descr en
Essa é a descrição para TestProject1.
Exemplo da Jython:
wsadmin>print Project.nlsget("TestProject1", "descr", "en")
Essa é a descrição para TestProject1.
Se você não especificar um valor para o parâmetro locale, o código de idioma selecionado atualmente será
usado.
Aprovar Projetos
Para aprovar os rascunhos em um projeto, use o método approve. Esse método aprova todos os itens do
rascunho no projeto ao mesmo tempo. Para poder publicar um projeto, todos os itens do projeto devem
ser aprovados.
v Sintaxe Jacl: $Project approve "project_name"
v Sintaxe Jython: Project.approve("project_name")
Exemplo de Jacl:
wsadmin>$Project approve "TestProject1"
wsadmin>$Project details "TestProject1"
state: PENDING
name : TestProject1
title: TestProject1
items:
testpage1 (draft / new / publish pending)
Exemplo da Jython:
wsadmin>Project.approve("TestProject1")
uuid : 255f129d-cc46-4d83-823d-80f9a28d13f5
state: PENDING
name : TestProject1
title: TestProject1
items:
testpage1 (draft / new / publish pending)
Publicar Projetos
Para publicar um projeto, use o método publish. Para poder publicar um projeto, todos os itens do
projeto devem ser aprovados.
v Sintaxe Jacl: $Project publish "project_name"
v Sintaxe Jython: Project.publish("project_name")
Exemplo de Jacl:
wsadmin>$Project publish "TestProject1"
wsadmin>$Project details "TestProject1"
state: PUBLISHED
name : TestProject1
title: TestProject1
items:
testpage1 (published)
167
Exemplo da Jython:
wsadmin>Project.publish("TestProject1")
uuid : 255f129d-cc46-4d83-823d-80f9a28d13f5
state: PUBLISHED
name : TestProject1
title: TestProject1
items:
testpage1 (published)
Configurar projeto ativo
Para comandos que você deseja executar dentro de um projeto, use o método setproject do bean do Portal
para especificar o projeto. Ao chamar o método setproject, identifique o projeto ativo com o nome do
projeto. Se você chamar o método setproject sem especificar um nome de projeto, o projeto ativo será
limpo. Ao configurar o projeto durante uma sessão, ele será ativado imediatamente.
Para configurar o projeto ativo, estabeleça uma sessão de usuário com o portal usando o comando login
do bean do portal.
v Sintaxe Jacl: $Project setproject "project_name"
v Sintaxe Jython: Portal.setproject("project_name")
Exemplo de Jacl:
wsadmin>$Portal setproject "TestProject1"
Exemplo da Jython:
wsadmin>Portal.setproject("TestProject1")
Exemplos
Esses exemplos demonstram uma seqüência de comandos típica para criar uma página em um projeto
específico. Cada script de exemplo executa as seguintes operações:
v
v
v
v
v
Estabelece uma sessão do usuário.
Cria um projeto (myproject).
Recupera os detalhes do projeto para o myproject.
Configura o projeto ativo para o projeto myproject.
Localiza a página Home no portal.
v Cria a página testpage1 como uma página filha da página Home. Essa operação ocorre no contexto do
projeto ativo.
v Limpa o projeto ativo.
v Finaliza a sessão do usuário.
Exemplo de Jacl:
$Portal login
set myproject [$Project create "My new project"
$Project details $myproject
$Portal setproject $myproject
$Content find any un ibm.portal.Home select
$Content create page testpage1 html shared public
$Portal setproject
$Portal logout
Exemplo da Jython:
Portal.login()
myproject = Project.create("My new project")
Project.details(myproject)
Portal.setproject(myproject)
168
Content.find("any", "un", "ibm.portal.Home", "select")
Content.create("page","testpage1","html", "shared", "public")
Portal.setproject()
Portal.logout()
Interface de Script do Portal e Bibliotecas de Conteúdo da Web
Com a Interface de Script do Portal, é possível criar scripts Jacl ou Jython para automatizar o
gerenciamento de bibliotecas de conteúdo da web. Usando o bean DocumentLibrary com a Interface de
Script do Portal, é possível criar e excluir bibliotecas, recuperar uma lista de bibliotecas e recuperar
atributos de biblioteca.
Criar Bibliotecas
Para criar uma biblioteca, use o método create.
v Sintaxe de Jacl: $DocumentLibrary create "library_name"
v Sintaxe da Jython: DocumentLibrary.create("library_name")
Exemplo de Jacl:
wsadmin>$DocumentLibrary create "Library1"
"library1"
Exemplo da Jython:
wsadmin>DocumentLibrary.create("Library1")
’"library1"’
Excluir Bibliotecas
Para excluir uma biblioteca, use o método delete.
v Sintaxe de Jacl: $DocumentLibrary delete "library_name"
v Sintaxe da Jython: DocumentLibrary.delete("library_name")
Exemplo de Jacl:
wsadmin>$DocumentLibrary delete "Library1"
Exemplo da Jython:
wsadmin>DocumentLibrary.delete("Library1")
Listar Bibliotecas
Para recuperar uma lista de bibliotecas, use o método listall.
v Sintaxe de Jacl: $DocumentLibrary listall
v Sintaxe da Jython: DocumentLibrary.listall()
Exemplo de Jacl:
wsadmin>$DocumentLibrary listall
"template page content" "wiki template v70" "blog template v70" "web resources v70"
"portal site" "web content templates" "blog solo template v70" "web content"
"library1"
Exemplo da Jython:
wsadmin>DocumentLibrary.listall()
’"template page content" "wiki template v70" "blog template v70" "web resources v70"
"portal site" "web content templates" "blog solo template v70" "web content"
"library1"’
Recuperar Detalhes da Biblioteca
Recupere detalhes da biblioteca com o método details. Esse método retorna as seguintes informações
sobre a biblioteca: o identificador exclusivo universal (UUID), o estado, o nome e o título.
v Sintaxe de Jacl: $DocumentLibrary details "library_name"
169
v Sintaxe da Jython: DocumentLibrary.details("library_name")
Exemplo de Jacl:
wsadmin>$DocumentLibrary details "Library1"
uuid
: 64fa541a-a189-4ed6-8a6f-4c3dcc148295
name
: library1
title
: Library1
description:
enabled
: true
deletion prohibited: false
Exemplo da Jython:
wsadmin>print DocumentLibrary.details("Library1")
uuid
: 13b06eb0-52c7-415b-9a93-4195968aa2a3
name
: library1
title
: Library1
description:
enabled
: true
deletion prohibited: false
Interface de Configuração XML e Páginas Gerenciadas
É possível usar a interface de configuração XML (comando xmlaccess) para manipular páginas
gerenciadas da mesma forma que é possível para outros recursos do portal.
Escopo do Projeto
Ao usar a interface de configuração XML com páginas gerenciadas, o processamento ocorre
completamente dentro de um projeto ou completamente fora de um projeto.
Quando você importa uma página publicada e especifica um escopo de projeto, a página é criada como
uma página de rascunho no projeto.
Importante: Você não pode exportar uma página de rascunho e depois importar essa página como um
rascunho em outro projeto.
Para executar o comando xmlaccess de dentro de um projeto, especifique o projeto com seu nome ou
com o ID de objeto. O comando usa o seguinte formato, dependendo de como você identifica o projeto:
xmlaccess -in input_file -url http://hostname:port_number/wps/config/$project/project_name
xmlaccess -in input_file -url http://hostname:port_number/wps/config/$project/project_object_id
Exemplo:
v xmlaccess -in Export.xml -url http://www.example.com:10039/wps/config/$project/myproject
v O seguinte comando deve ser totalmente inserido em uma linha:
xmlaccess -in Export.xml -url
http://www.example.com:10039/wps/config/$project/
Z6QReDeN9E86O46P9CGJMK633P8JMG6J1P8MM47MPD6MMCC63PI3IL6GPD63R46J1
Nota do AIX Linux Solaris: Você pode precisar preceder o sinal de porcentagem ($) com uma barra
invertida (\) para evitar que $project seja interpretado como uma variável de ambiente. Por exemplo:
xmlaccess -in Export.xml -url http://www.example.com:10039/wps/config/\$project/myproject
Usar o Processamento de Transação com a Interface de Configuração XML
Como as páginas gerenciadas são armazenadas na biblioteca de sites do Portal no Web Content Manager,
cada página tem objetos correspondentes no banco de dados JCR. Você deve estar ciente dessa relação ao
criar, atualizar ou excluir páginas gerenciadas com a interface de configuração XML. Se o processamento
de xmlaccess for interrompido, ele poderá resultar em incompatibilidade entre o estado da página e o
estado do banco de dados.
170
Para garantir que as informações de página e do banco de dados de uma página gerenciada permaneçam
sincronizadas, use o atributo transaction-level do elemento request no arquivo XML. Para obter mais
informações sobre como usar o atributo transaction-level, consulte Referência de Configuração XML.
Por exemplo:
<request
type="update"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="PortalConfig_8.0.0.xsd"
transaction-level="resource">
Área de Site Lost-found
Quando o Web Content Manager não puder determinar o local correto de um item de página na
biblioteca de Site do Portal, o item de página será armazenado na área de site lost-found. Essa área de
site garante que você possa recuperar páginas e qualquer conteúdo armazenado nas páginas no evento de
um problema.
As seguintes causas são razões típicas para que uma página seja armazenada na área de site lost-found:
v O processo de sincronização entre o portal e o Web Content Manager localiza itens de página na
biblioteca de Site do Portal que não possui páginas correspondentes no portal.
v Você move uma página gerenciada sob uma página não gerenciada na hierarquia de página do portal.
Nesse caso, o item de página da página gerenciada é armazenado na área de site lost-found.
A área de site lost-found é um local somente leitura. Embora não seja possível editar itens em uma área
de site lost-found, é possível visualizar os itens e copiar conteúdo que você deseja salvar.
Itens de Conteúdo da Web
Ao criar um novo website, há um conjunto de itens de conteúdo da web principais que deve ser criado,
incluindo modelos e itens de estrutura de site.
Criando Modelos de Autoria
Um modelo de autoria é usado para definir as configurações de autoria padrão para áreas de site e itens
de conteúdo. Isso inclui o design do formulário de autoria, quais campos e elementos aparecem no
formulário e os valores padrão para campos e elementos. Você deve criar modelos de autoria antes de
criar áreas de site e itens de conteúdo.
“Trabalhando com Modelos de Autoria”
Trabalhando com Modelos de Autoria
Tipos de Modelo de Autoria
Modelos de Área de Site
Os modelos de autoria de área de site são usados para definir as configurações padrão de áreas
de site.
Modelo de Área de Site Padrão:
Uma área de site padrão é instalada com o IBM Web Content Manager. Isso pode ser usado para
manter o comportamento de áreas de site migradas das liberações anteriores. É possível desativar
171
a criação de novas áreas de site usando o modelo de área de site padrão alterando o parâmetro
de configuração a seguir para "false" no serviço WCM WCMConfigService usando o WebSphere
wcm.authoringui.defaultSiteAreaTemplateEnabled=false
Modelos de conteúdo
os modelos de autoria são usados para definir as configurações padrão de itens de conteúdo. Crie
conteúdo de renderização de duas maneiras diferentes:
Renderização de conteúdo
Se você configurar um modelo de autoria de conteúdo a ser renderizado como conteúdo,
os itens de conteúdo criados serão itens de conteúdo padrão. Eles são designados para
armazenar elementos que podem ser renderizados dentro dos modelos de apresentação.
Renderização de recurso
Se você configurar um modelo de autoria de conteúdo a ser renderizado como recurso, os
itens de conteúdo criados serão baseados em um arquivo armazenado em um elemento
de recurso do arquivo. Quando um item de conteúdo de recurso for renderizado, o
arquivo armazenado no elemento de recurso do arquivo selecionado será renderizado na
página da Web. Nenhum modelo de apresentação será usado quando o arquivo for
renderizado, apenas o conteúdo do próprio arquivo. Isso é útil quando você deseja
armazenar um arquivo e o renderiza diretamente em uma página, mas gostaria também
que o arquivo PDF fosse listado em componentes navegacionais, como menus e
navegadores.
Definindo propriedades de modelo de autoria
Seleção de elemento
Ao criar um modelo de autoria, inclua elementos no modelo para determinar quais tipos de
conteúdo serão armazenados no item. Ao construir o modelo de autoria, você pode selecionar
mais de um campo de elemento do mesmo tipo de elemento. Por exemplo, você poderá incluir
três campos de elementos de texto, dois campos de elementos de rich text e quatro campos de
elementos de imagem no mesmo modelo de autoria.
Valores padrão
É possível especificar valores padrão para cada campo e elemento no modelo de autoria. Valores
padrão bem selecionados podem tornar mais fácil e mais eficiente para um autor criar novos
itens e podem simplificar o processo de criação de item.
Layout de Formulário Simplificado
O modelo de autoria fornece recursos que ajudam a simplificar a apresentação do formulário de
autoria.
Opções de layout do formulário de autoria
É possível controlar o layout geral dos campos no formulário de autoria especificando
uma opção de layout de formulário de autoria. Dependendo da opção de layout
selecionada, isso pode reduzir o espaço vertical necessário para exibir os elementos no
formulário de autoria.
Campos Ocultos
Além de organizar um formulário de autoria com uma opção de layout para os campos, é
possível simplificar ainda mais o formulário apresentado ao autor do item com o uso de
campos ocultos. Com exceção dos campos que são obrigatórios para um formulário de
autoria, é possível designar qualquer outro campo no modelo de autoria para que fique
oculto. Um campo marcado para ficar oculto no modelo de autoria não é exibido no
formulário de autoria, com isso simplificando a aparência visual do formulário.
Entretanto, observe que embora um campo oculto não seja exibido no formulário de
autoria, as informações definidas no campo ainda estão associadas ao formulário de
autoria e serão processadas com o formulário. Isso é particularmente útil quando usado
em conjunto com um valor padrão para um campo, porque permite a você especificar
172
uma configuração para um campo e, em seguida, ocultar o campo no formulário de
autoria para assegurar que o valor do campo não possa ser alterado pelo autor do item.
Por exemplo, convém configurar níveis de controle de acesso para o item gerado do
modelo de autoria na seção Controle de Acesso do modelo e, em seguida, ocultar essa
seção no formulário de autoria resultante. Quando um item é gerado a partir do modelo,
os níveis de controle de acesso do item serão derivados dos valores padrão no modelo.
Texto de ajuda customizado
Para ajudar a customizar ainda mais o formulário de conteúdo para um autor de item, o Web
Content Manager fornece a capacidade de incluir texto de ajuda customizado no modelo de
autoria.
v É possível definir texto de ajuda para o formulário de autoria inteiro que é gerado a partir do
modelo de autoria. Por exemplo, esse texto de ajuda pode ser usado para descrever o propósito
do formulário. Você deve incluir qualquer informação específica que poderia ser usada pelos
autores que utilizam o formulário.
v Além do texto HTML que é possível incluir para descrever o formulário de autoria inteiro,
também é possível especificar o texto de ajuda sequencial exibido com cada elemento no
formulário. Esse texto de ajuda pode fornecer informações de destino para um campo
específico no formulário, explicando valores possíveis ou observando condições especiais
relacionadas ao campo.
Etiquetando Elementos
Os nomes de rótulos de elementos em diferentes itens devem ser iguais se uma referência de elemento
em um modelo de apresentação tiver de ser alterada dependendo do contexto atual. É importante
considerar isso se dois modelos de autoria estarão utilizando o mesmo modelo de apresentação. No
entanto, os tipos de elementos não precisam ser consistentes.
Tabela 33. Exemplo: Uma referência de elemento chamada Título da Área do Site Atual
Área de Site
Etiqueta de elemento
Tipo de elemento
Negócios
Título
Imagem
Pessoal
Título
Rich Text
Recursos
Título
Texto
Notícias
Título
Texto
“Criando Modelos de Autoria” na página 171
Um modelo de autoria é usado para definir as configurações de autoria padrão para áreas de site e itens
de conteúdo. Isso inclui o design do formulário de autoria, quais campos e elementos aparecem no
formulário e os valores padrão para campos e elementos. Você deve criar modelos de autoria antes de
criar áreas de site e itens de conteúdo.
Customizando Elementos Utilizando JSP
Um campo "JSP personalizado (custom JSP)" está disponível em alguns tipos de elementos quando
incluídos em um modelo de autoria. Use-o para fazer referência a um arquivo JSP a ser usado em vez da
visualização padrão do elemento na interface com o usuário. É possível redigir o arquivo JSP para
controlar a aparência de um elemento, e para restringir os valores que podem ser inseridos num
elemento.
Armazenando Arquivos JSP:
Arquivos JSP podem estar localizados:
v no diretório was_profile_root/installedApps/node-name/wcm.ear/ilwwcm.war de seu servidor.
173
A página JSP também é armazenada no diretório war do cliente do portlet de renderização local ou do
servlet ou portlet que chama a JSP, se estiver utilizando a API do Web Content Manager. Por exemplo,
para renderizar uma página JSP em um portlet de renderização local, também seria necessário
armazenar uma cópia do arquivo JSP em was_profile_root/installedApps/node-name/
PA_WCMLocalRendering.ear/ilwwcm-localrende.war
v em qualquer outro aplicativo da Web em execução no portal. Ao fazer referência aos arquivos JSP em
outro aplicativo da Web, utilize o caminho a seguir: contextPath;jspPath
Por exemplo: /wps/customapplication;/jsp/editor.jsp
API CustomBean e EditorBean:
A API CustomBean e EditorBean pode ser encontrada em com.ibm.workplace.wcm.api.authoring no
Javadoc localizado na pasta was_profile_root\installedApps\nodename\wcm.ear\ilwwcm.war\
webinterface\.
Fazendo Referência a Arquivos JSP
Ao fazer referência a um arquivo JSP no campo JSP Customizado da visualização de propriedades do
elemento, é possível usar os seguintes formatos.
Quando localizado dentro do diretório ilwwcm.war do seu servidor, use este formato
was_profile_root/installedApps/node-name/wcm.ear/ilwwcm.war
Nota: A página JSP também é armazenada no diretório war do cliente do portlet de renderização
local ou do servlet ou portlet que chama a JSP, se estiver utilizando a API do Web Content
Manager. Por exemplo, para renderizar uma página JSP em um portlet de renderização local,
também seria necessário armazenar uma cópia do arquivo JSP em was_profile_root/
installedApps/node-name/PA_WCMLocalRendering.ear/ilwwcm-localrende.war
Quando localizado dentro de qualquer outro aplicativo da Web em execução no portal
contextPath;jspPath
Especifica uma versão do modo de edição do campo em que a JSP está localizada em
outro aplicativo. Por exemplo: /wps/customapplication;/jsp/editor.jsp
jspPath
Especifica uma versão do modo de edição do campo em que a JSP está localizada no
mesmo aplicativo que o Web Content Manager.
editmode=contextPath;jspPath
Especifica uma versão do modo de edição do campo em que a JSP está localizada em
outro aplicativo.
editmode=jspPath
Especifica uma versão do modo de edição do campo em que a JSP está localizada no
readmode=contextPath;jspPath
Especifica uma versão do modo de leitura do campo em que a JSP está localizada em
outro aplicativo.
readmode=jspPath
Especifica uma versão do modo de leitura do campo em que a JSP está localizada no
readmode=contextPath;jspPath,editmode=contextPath;jspPath
Especifica uma versão do modo de edição e do modo de leitura do campo em que as
JSPs estão localizadas em outro aplicativo.
174
readmode=jspPath,editmode=jspPath
Especifica uma versão do modo de edição e do modo de leitura do campo em que as
JSPs estão localizadas no mesmo aplicativo que o Web Content Manager.
Exemplo de Elemento de Texto
<%@ taglib uri="/WEB-INF/tld/portlet.tld" prefix="portletAPI" %>
<%@ page import="com.ibm.workplace.wcm.api.authoring.CustomItemBean" %>
<portletAPI:init />
<%
CustomItemBean customItem =
(CustomItemBean) request.getAttribute("CustomItemBean");
customItem.setSubmitFunctionName("myoptionsubmit");
String fvalue = (String)customItem.getFieldValue();
fvalue = fvalue.replaceAll("\"", """).replaceAll("\"","'");
%>
<script language=’Javascript’>
function myoptionsubmit()
{
document.getElementById(’<%=customItem.getFieldName()%>’).value =
document.getElementById(’<%=customItem.getFieldName()%>_mycustomoption’).value;
}
</script>
<INPUT id=’<%=customItem.getFieldName()%>_mycustomoption’ value="<%=fvalue%>">
Exemplo de Elemento de Rich Text
<%@ page import="com.ibm.workplace.wcm.app.ui.portlet.widget.EditorBean"%>
<%@ taglib uri="/WEB-INF/tld/wcm.tld" prefix="wcm" %>
<%
EditorBean editor = (EditorBean) request.getAttribute("EditorBean");
%>
function setHtml(id, html)
{
document.getElementById(id + "_rte").value = html;
}
function getHtml(id)
{
return document.getElementById(id + "_rte").value;
}
function setRichTextValue(theText)
{
document.getElementById(’<%= editor.getName()%>_rte’).value = theText;
}
</script>
<textarea
cols="85" rows="15" id="<%= editor.getName() %>_rte"></textarea>
<script type="text/javascript">
var initialValue = document.getElementById(’<%= editor.getHiddenContentFieldName() %>_inithtml’).value;
var editorTextArea = document.getElementById(’<%= editor.getName()%>_rte’);
editorTextArea.value = initialValue;
if (initialisedRTEs != null)
175
{
initialisedRTEs = initialisedRTEs + 1;
}
</script>
Exemplo de Elemento de Seleção de Opção Customizada com Validação
Este exemplo é utilizado para criar uma lista de seleção de opções predefinidas.
<portletAPI:init />
<%
customItem.setSubmitFunctionName("mysubmit");
%>
<SELECT id=’<%=customItem.getFieldName()%>_mycustom’ >
<OPTION></OPTION>
<OPTION
<% if (((String)fvalue).compareTo("Option1") == 0) {%>
SELECTED
<% } %>
>Option1</OPTION>
<OPTION
SELECTED
<% } %>
>Option2</OPTION>
<OPTION
SELECTED
<% } %>
>Option3</OPTION>
<OPTION
SELECTED
<% } %>
>Option4</OPTION>
</SELECT>
function mysubmit()
{
var selIndex=document.getElementById(’<%=customItem.getFieldName()%>_mycustom’).selectedIndex;
if (selIndex <= 0)
{
document.getElementById("<%=customItem.getFieldName()%>").value = "";
}
else
{
document.getElementById("<%=customItem.getFieldName()%>").value =
document.getElementById(’<%=customItem.getFieldName()%>_mycustom’).options[selIndex].text;
}
}
</script>
176
Exemplo de Elemento de Data
Este exemplo é utilizado para criar uma lista de seleção de datas predefinidas.
Nota: Apenas as datas podem ser selecionadas, não as horas.
<portletAPI:init />
<%
customItem.setSubmitFunctionName("mydatesubmit");
%>
<SELECT id=’<%=customItem.getFieldName()%>_mycustomdate’ >
<OPTION></OPTION>
<OPTION
<% if (((String)fvalue).compareTo("Jul 4, 2005") == 0) {%>
SELECTED
<% } %>
>Jul 4, 2005</OPTION>
<OPTION
<% if (((String)fvalue).compareTo("Aug 15, 2005") == 0) {%>
SELECTED
<% } %>
>Aug 15, 2005</OPTION>
<OPTION
<% if (((String)fvalue).compareTo("Dec 25, 2005") == 0) {%>
SELECTED
<% } %>
>Dec 25, 2005</OPTION>
<OPTION
<% if (((String)fvalue).compareTo("Jan 26, 2006") == 0) {%>
SELECTED
<% } %>
>Jan 26, 2006</OPTION>
</SELECT>
function mydatesubmit()
{
var selIndex=document.getElementById(’<%=customItem.getFieldName()%>_mycustomdate’).selectedIndex;
document.getElementById(’<%=customItem.getFieldName()%>_mycustomdate’).options[selIndex].text;
}
</script>
Exemplo de Elemento de Número
Este exemplo é utilizado para criar uma lista de seleção de números predefinidos.
<portletAPI:init />
<%
177
customItem.setSubmitFunctionName("mynumbersubmit");
%>
<SELECT id=’<%=customItem.getFieldName()%>_mycustomnumber’
<OPTION></OPTION>
<OPTION
<% if (((String)fvalue).compareTo("6") == 0) {%>
SELECTED
<% } %>
>6</OPTION>
<OPTION
<% if (((String)fvalue).compareTo("8.5") == 0) {%>
SELECTED
<% } %>
>8.5</OPTION>
<OPTION
<% if (((String)fvalue).compareTo("12") == 0) {%>
SELECTED
<% } %>
>12</OPTION>
<OPTION
<% if (((String)fvalue).compareTo("15.45") == 0) {%>
SELECTED
<% } %>
>15.45</OPTION>
</SELECT>
>
function mynumbersubmit()
{
var selIndex=document.getElementById(’<%=customItem.getFieldName()%>_mycustomnumber’).selectedIndex;
document.getElementById(’<%=customItem.getFieldName()%>_mycustomnumber’).options[selIndex].text;
}
</script>
Exemplo de Elemento de Seleção de Usuário
Este exemplo é utilizado para criar um campo no qual digitar um nome de usuário.
<portletAPI:init />
<%
customItem.setSubmitFunctionName("myusersubmit");
%>
function myusersubmit()
{
document.getElementById(’<%=customItem.getFieldName()%>’).value =
document.getElementById(’<%=customItem.getFieldName()%>_mycustomuser’).value;
}
178
</script>
<INPUT id=’<%=customItem.getFieldName()%>_mycustomuser’ value="<%=fvalue%>">
Construindo uma Estrutura do Site
Uma estrutura de site é composta por um conjunto hierárquico de páginas e áreas de site inteligentes que
são usadas para definir a estrutura de navegação do website. Armazene itens de conteúdo na estrutura
do site salvando-os em diferentes páginas ou áreas de site inteligentes.
Planejando uma Estrutura de Site
Páginas e áreas de site inteligentes são usadas para definir uma estrutura de site hierárquica. Os itens de
conteúdo são salvos dentro da estrutura de site para fornecer sua estrutura de conteúdo e seu contexto.
Planejando uma Estrutura de Site
Uma estrutura de site consiste em uma única página ou área de site inteligente de nível superior sob a
qual são armazenadas outras páginas, áreas de site e itens de conteúdo inteligentes. Embora uma
estrutura de site contenha apenas uma única área de site de nível superior, é possível criar múltiplas
estruturas de site para uso em um único Web site.
179
Áreas de Site:
v Você utiliza áreas de site para construir a estrutura do site dentro da qual agrupa itens de
conteúdo. As áreas de site que compõem a estrutura do site podem ser classificadas em
ascendentes, descendentes e irmãos. A hierarquia vertical de uma estrutura de site é dividida
em ascendentes e descendentes. Dependendo de onde você está na estrutura de site, as áreas
de site podem agir como ascendentes e descendentes. As Áreas de Site que compartilham o
mesmo ascendente são conhecidas como irmãs.
v Os relacionamentos entre os modelos de autoria e os modelos de apresentação são definidos
em áreas de site.
v Você deve selecionar um modelo de autoria ao criar áreas de site. O modelo de autoria
determina quais elementos estão disponíveis por padrão no formulário de área de site.
v O conteúdo da Web específico da área de site é armazenado em áreas de site na forma de
elementos.
Itens de conteúdo:
v Você usa itens de conteúdo para armazenar conteúdo específico da página da Web na forma de
elementos.
v Você salva itens de conteúdo dentro de áreas de site.
v Você pode salvar itens de conteúdo dentro de várias áreas de site e várias estruturas de site.
v Você deve selecionar um modelo de autoria ao criar itens de conteúdo. O modelo de autoria
determina quais elementos estão disponíveis por padrão no formulário de item de conteúdo.
v A área de site na qual um item de conteúdo está localizado e o modelo de autoria do item de
conteúdo determinam qual modelo de apresentação utilizar para exibir os elementos
armazenados dentro de um item de conteúdo.
v Você utiliza categorias e palavras-chave para traçar o perfil de itens de conteúdo que o
aplicativo IBM Web Content Manager utiliza para gerar partes adicionais do conteúdo, como
menus.
Quando Usar Áreas de Site e Itens de Conteúdo
Áreas de site e itens de conteúdo são semelhantes a tipos de itens. Todos eles armazenam conteúdo da
Web na forma de elementos, mas são usados de maneiras diferentes:
v Áreas de site são utilizadas para definir seções diferentes dentro de uma estrutura de site. Elas podem
também ser usadas como conteúdo de início para cada seção do seu website.
v Itens de conteúdo representam o conteúdo específico da página da Web e podem ser usados em
múltiplas áreas de site e múltiplas estruturas de site.
A estrutura de um Web site determinará se uma única estrutura de site ou múltiplas estruturas de site
são usadas.
180
Nos seguintes exemplo, uma empresa vende três marcas de produto diferentes.
Exemplo 1: Um único Web site
Neste exemplo, o método mais simples a ser usado é um Web site que abrange uma única estrutura de
site com múltiplas áreas de site:
v Área de site da parte superior
– Área de site para a Marca A
- Item de conteúdo A1
- Item de conteúdo genérico
– Área de site para a Marca B
- Item de conteúdo B1
– Área de site para a Marca C
- Item de conteúdo C1
Exemplo 2: Intranet, extranet e Web site
Neste exemplo, uma estrutura de site separada é criada para uma intranet, uma extranet e um Web site.
Alguns itens de conteúdo são utilizados em mais de uma estrutura de site.
181
Tabela 34. Exemplo 2: Intranet, extranet e Web site
Intranet
v Intranet
– Site de intranet para a Marca A
Extranet
v Extranet
– Área de Site de Extranet para a
Marca A
Web Site
v Web Site
– Área de Web site para a Marca
A
- Item de conteúdo A3 (apenas
para intranet)
para extranet)
para Web)
- Item de conteúdo de extranet
genérico
- Item de conteúdo da Web
genérico
Marca B
B
- Item de conteúdo de intranet
genérico
– Área de site de intranet para a
Marca B
- Item de conteúdo B3 (apenas
para intranet e extranet)
para intranet e extranet)
para Web)
genérico
genérico
Marca C
C
genérico
– Área de site de intranet para a
Marca C
- Item de conteúdo C3 (apenas
para intranet)
para extranet e Web)
para extranet e Web)
genérico
genérico
genérico
Os modelos de apresentação permitem alterar a aparência de uma página sem ter de atualizar o que está
sendo exibido em uma página. Por exemplo, um modelo de apresentação que exibe um menu de um
lado de uma página pode ser alterado para posicioná-lo no outro lado, sem ter de reconstruir o menu.
Todas as páginas da web que se baseiam no mesmo modelo de apresentação são alteradas.
Há uma pequena diferença entre a construção de um modelo de apresentação e a utilização de HTML
para construir uma página da Web. Pode até mesmo ser útil construir um "esboço" da página que você
está projetando em HTML antes de criar um novo modelo de apresentação. Basta substituir as seções
diferentes em sua página da Web pelas referências aos elementos usando tags de conteúdo da Web.
É necessário criar um modelo de apresentação separado para cada tipo de página em seu site.
Layout de página
Use HTML para definir o layout de um modelo de apresentação da mesma maneira que usa HTML para
definir o layout de uma página da Web.
182
Este é um exemplo de um possível layout de um modelo de apresentação. Embora seja recomendado que
elementos HTML (como tabelas) sejam utilizados para especificar o layout exato de um modelo de
apresentação, você não precisa utilizá-los. É possível definir o layout de sua página do modo que desejar.
Assim que o layout estiver definido, tudo o que você precisa é fazer referência aos diferentes
componentes nas diversas seções da tabela HTML. (É possível fazer referência a mais de um componente
dentro de uma única célula de tabela.)
É possível, também, digitar texto e tags HTML diretamente em um modelo de apresentação. Isso será útil
se você tiver um elemento que precise aparecer em todas as páginas utilizando um modelo de
apresentação comum. Entretanto, se esse elemento for usado em outros modelos de apresentação, será
mais eficiente salvá-lo como um componente.
Exemplo
Este é um exemplo do HTML que você pode digitar em um modelo de apresentação para definir o layout
de um modelo.
<html>
<head></head>
<body>
<table width="100%" border="0"
cellspacing="0">
<tr><td colspan="3"></td></tr>
183
<tr><tdrowspan="3"></td><td></td><td
rowspan="3"></td></tr>
<tr><td></td></tr>
<tr><td></td></tr>
<tr><tdcolspan="3"></td></tr>
</table>
</body>
</html>
O texto e as tags do IBM Web Content Manager são então incluídas nas células de tabelas diferentes para
criar a página da Web final.
Ativando Tags de Conexão
As tags de Conexão são tags avançadas do Web Content Manager que podem ser utilizadas para
recuperar dados de origens externas e aplicar armazenamento em cache customizado. As tags de
Conexão do Processo devem ser selecionadas em um formulário de modelo de apresentação para que as
tags de conexão sejam processadas.
Estilo de Página
Use HTML para definir as propriedades padrão de um modelo de apresentação da mesma maneira que
usa HTML para definir as propriedades padrão de uma página da Web.
Você pode definir qualquer propriedade HTML válida, incluindo:
v tamanhos de margem;
v cores de texto;
v imagens e cores de segundo plano.
Exemplo
Este é um exemplo do HTML que você pode digitar em um modelo de apresentação para definir as
propriedades padrão de um modelo de apresentação.
<html>
<head></head>
<body bgcolor="#CC0000" text="#000000" link="#6666FF"
vlink="#9999FF" alink="#FF33CC"leftmargin="5" topmargin="5">
</body>
</html>
Nota: Se as mesmas propriedades da página forem utilizadas em mais de um modelo de apresentação,
elas poderão ser armazenadas em um único componente de texto que seja referido no modelo de
apresentação:
<body <component name="TextComponentName"/>>
Isso significa que editando um único componente de texto, as propriedades de página de vários gabaritos
de apresentação podem ser rapidamente atualizadas.
Utilizando Folhas de Estilo em Cascata
As propriedades de estilo padrão não podem ser definidas para os componentes. As propriedades de
página padrão substituirão quaisquer propriedades de página definidas em um componente.
É possível utilizar as folhas de estilo em cascata para controlar o estilo dos componentes. Por exemplo,
você poderia criar os links em um menu em uma cor diferente para os links em um navegador usando
folhas de estilo em cascata para determinar o estilo de componentes diferentes.
184
Nota: Onde possível, a boa prática é utilizar uma folha de estilo em cascata para um site inteiro. Utilize
um link para a folha de estilo em vez de incorporá-la.
Mapas de Modelo
Mapas de modelo são usados para determinar quais modelos de apresentação são usados para exibir
cada área de site ou item de conteúdo.
Estratégias do Mapa de Modelo
O modelo de apresentação usado por um item é determinado pelo relacionamento entre o modelo de
autoria do item e um modelo de apresentação definido no modelo de autoria, ou um mapa de modelo
definido em uma área de site no caminho do item atual. Os mapas de modelos designados em áreas de
site substituirão aqueles definidos em modelos de autoria.
Isso pode resultar nos seguintes relacionamentos:
v Um item de conteúdo pode ser exibido usando dois modelos de apresentação diferentes se vinculados
a áreas de site diferentes.
v Dois itens que usam diferentes modelos de autoria poderão se exibidos usando o mesmo modelo de
apresentação se ambos os modelos de autoria estiverem mapeados para o mesmo modelo de
apresentação.
Definido nos Modelos de Autoria
Se você selecionar um modelo de apresentação padrão em um modelo de autoria, ele será usado
como modelo de apresentação padrão para todos os itens com base nesse modelo de autoria. Isso
assegurará que todos os itens com base nesse modelo de autoria serão renderizados com o
mesmo modelo de apresentação, mas não garante a consistência de design entre outros itens
localizados na mesma área de site. Se um mapa de modelo diferente for especificado em qualquer
área de site no caminho do item, o mapa de modelo definido na parte mais baixa do caminho do
item será usado em seu lugar.
Definido nas áreas de site
Se você definir um mapa de modelo em uma área de site, isso assegurará que todos os itens com
base no modelo de autoria selecionado usarão o mesmo modelo de apresentação nessa área de
site. Se um mapa de modelo diferente for especificado em qualquer área de site filho da área de
site pai, o mapa de modelo definido na área de site na parte mais baixa do caminho do item será
usado.
Exemplos de Mapa de Modelo
Nestes exemplos, os seguintes mapas de modelo são usados:
v O Modelo de Autoria 1 usa o Modelo de Apresentação 1 como seu modelo de apresentação padrão
v
v
v
v
v
O Modelo de Autoria 2 usa o Modelo de Apresentação 2 como seu modelo de apresentação padrão
O Modelo de Autoria 3 também usa o Modelo de Apresentação 2 como seu modelo de apresentação padrão
O Modelo de Autoria 4 não possui modelo de apresentação padrão
A Área de Site 1 não possui mapa de modelo
A Área de Site 2 contém um mapa entre o Modelo de Autoria 1 e o Modelo de Apresentação 2
v A Área de Site 1 e a Área de Site 2 estão localizadas na Área de Site A.
v A Área de Site A contém um mapa entre o Modelo de Autoria 4 e o Modelo de Apresentação 3
O modelo de apresentação usado por cada item será determinado pelo modelo de autoria que o item
usou e pelo local do item na estrutura de site.
185
Tabela 35. Resultados do Mapa de Modelo
Conteúdo e Local
Resultado
Conteúdo 1 usando o Modelo de Autoria 1 localizado na
Área de Site 1
Como a Área de Site 1 não contém mapas de modelo, o
Conteúdo 1 é exibido usando o Modelo de Apresentação 1
que é o modelo de apresentação padrão do Modelo de
Autoria 1.
Área de Site 2
Como a Área de Site 2 contém um mapa entre o Modelo de
Autoria 1 e o Modelo de Apresentação 2, o Conteúdo 1 é
exibido usando o Modelo de Apresentação 2.
Área de Site 1
que é o modelo de apresentação padrão do Modelo de
Autoria 2.
Área de Site 1
Conteúdo 3 também é exibido usando o Modelo de
Apresentação 2 que é o modelo de apresentação padrão
do Modelo de Autoria 3.
Área de Site 1
que é mapeado para o Modelo de Autoria 4 na Área de Site
A.
Referências de Elementos
Ao referenciar elementos em uma apresentação, é importante observar o seguinte:
v Os elementos que um modelo de apresentação usa devem ser definidos no modelo de autoria no qual
o conteúdo é baseado.
v Se o elemento que está sendo referenciado não existir no item atual, nada será exibido nessa seção do
modelo de apresentação.
Embora o autor do modelo possa identificar uma série de elementos que podem ser exibidos no
formulário de item, a exibição ou não dos elementos depende do modelo de apresentação usado com o
modelo de autoria para renderizar o formulário de conteúdo. Um modelo de apresentação poderá não
incluir todos os elementos definidos em um modelo de autoria, mas para que um elemento ou tipo de
elemento esteja disponível para um modelo de apresentação, o elemento deve ser incluído no modelo de
autoria utilizado para criar o conteúdo.
Itens de conteúdo
Você usa itens de conteúdo para armazenar conteúdo específico da página da Web na forma de
elementos.
Cada item de conteúdo criado é baseado em um modelo de autoria. O modelo de autoria pode
determinar quais tipos de elementos estão incluídos em um item de conteúdo, se um fluxo de trabalho
será usado ou não e qual fluxo de trabalho usar, e onde o item de conteúdo pode ser salvo.
Cada item de conteúdo criado é o equivalente a uma página da Web em um Web site tradicional. Ao
contrário dos Web sites tradicionais, um único item de conteúdo pode ser vinculado a áreas diferentes em
seu Web site ou vinculados a um Web site diferente. As alterações feitas em um único item de conteúdo
estarão visíveis em cada local que você vincular o item de conteúdo.
A aparência e o comportamento de um item de conteúdo ao ser exibido em um Web site dependerá de
qual modelo de autoria foi usado para criar o item de conteúdo e qual modelo de apresentação é usado
186
para exibir o conteúdo. O modelo de apresentação usado dependerá do contexto atual do item de
conteúdo e de qual mapa modelo se aplica ao contexto atual do item de conteúdo.
Componentes
Você usa componentes para armazenar elementos que são usados em mais de uma área do seu Web site.
Por exemplo, um logotipo da empresa ou um aviso de copyright.
Componentes Estáticos
Os componentes estáticos são usados para armazenar conteúdo estático, como texto, arquivos ou
imagens.
v componente de referência de componente
v componente de data e hora
v componente de recurso de arquivo
v Componente HTML
v componente de imagem
v Componente JSP
v componente de link
v
v
v
v
v
v
componente de número
componente de rich text
componente de texto curto
Elemento de Folha de Estilo
componente de texto
componente de seleção de usuário
Componentes Dinâmicos
Os componentes dinâmicos são usados para gerar dinamicamente conteúdo com base nos parâmetros
definidos nas propriedades do componente.
v componente de menu
v componente de navegador
v Componente Personalization
v componente de taxonomia
v componente de nome de usuário
Componentes da Ferramenta
Os componentes da ferramenta são usados para criar ferramentas que podem ser incluídas nas páginas
da Web para que os usuários executem tarefas como procura, edição sequencial e paginação através de
páginas de links.
v componente de ferramentas de autoria
v componente de navegação de página
v componente de procura
Estratégias do Traçado de Perfil
Você utiliza os recursos de traçado de perfil do IBM Web Content Manager para agrupar itens de
conteúdo em tipos de conteúdo diferentes.
Métodos de Traçado de Perfil
Você utiliza os seguinte métodos de traçado de perfil para agrupar itens de conteúdo.
187
Traçando Perfil de Itens de Conteúdo
Taxonomias e Categorias
Uma Categoria refere-se ao assunto do item de conteúdo. Por exemplo, o item de conteúdo pode
ser da categoria Novos Produtos ou Últimas Notícias. Você utiliza taxonomias para agrupar
categorias. Os usuários selecionam em uma lista predefinida de categorias ao traçar o perfil de
um item de conteúdo.
Na maioria dos casos, deve-se utilizar apenas as categorias de nível inferior do conteúdo de
perfil. Isso dará mais controle sobre o que será exibido em menus.
Palavras-chave
Você também utiliza Palavras-chaves para traçar o perfil do conteúdo. Ao contrário das
categorias, que são escolhidas em uma lista predefinida, você pode digitar qualquer
palavra-chave que queira ao criar itens de conteúdo.
Opções Adicionais de Traçado de Perfil
Traçando perfil de usuários
Você pode incluir informações de perfil nos usuários. Isso pode ser utilizado como parâmetros de
procura em elementos de menu.
Traçando o perfil de portlets de renderização
Você pode digitar informações de perfil ao configurar um portlet de renderização. Isso pode ser
utilizado como parâmetros de procura em elementos de menu.
Traçado de Perfil Versus Controles de Acesso
O traçado de perfil pode ser usado para personalizar um Web site para usuários diferentes. Isso é
diferente de utilizar controles de acesso de item para limitar quais itens um usuário pode acessar. Em um
perfil baseado em site personalizado, embora um usuário possa não ser capaz de acessar todas as páginas
através de menus personalizados, ele ainda pode acessar outras páginas utilizando navegadores ou
procurando conteúdo. Utilizar controles de acesso limita um usuário a apenas visualizar itens para os
quais o acesso foi concedido.
Planejando uma Taxonomia
Antes de criar uma taxonomia, você deve analisar como ela será utilizada no site para determinar a
melhor estrutura.
Você agrupa categorias dentro de taxonomias.
Você não pode utilizar taxonomias nas procuras de menu. Se desejar ter um menu que retorne resultados
baseados no perfil de conteúdo com qualquer categoria em uma taxonomia, deverá criar uma única
categoria de nível superior e basear o menu na categoria de nível superior.
Taxonomia de Exemplo de "Metabancos"
v Financeiro
– Soluções bancárias
– Taxas de Juros
- Pessoal
- Negócios
- Pessoa Jurídica
v Notícias
Neste exemplo:
188
v Taxonomia = Taxonomia de Metabancos
v "Financeiro (Financial)" é o ascendente de "Taxas de Juros (Interest Rates)", "Pessoal (Personal)",
"Comercial (Business)", "Pessoa Jurídica (Corporate)" e "Soluções Bancárias (Banking Solutions)".
v "Pessoal (Personal)", "Comercial (Business)" e "Pessoa Jurídica (Corporate)" são os descendentes de
"Taxas de Juros (Interest Rates)" e "Financeiro (Financial)".
Utilizando Categorias para Traçar o Perfil de Conteúdo
Ao construir uma hierarquia de taxonomias e categorias é importante considerar como um menu utilizará
suas categorias em uma procura. Isso porque os menus procuram para cima e para baixo nos grupos de
categorias.
Tabela 36. Exemplos
Cenário
Exemplo
Se você basear um menu em uma categoria de nível
superior, todo o conteúdo que tenha perfil com
categorias pertencentes a essa categoria de nível superior
e seus descendentes aparecerá no menu.
No exemplo anterior, um menu baseado em Financeiro
exibirá o conteúdo cujo perfil tem alguma das seguintes
opções:
v Financeiro
– Soluções bancárias
– Taxas de Juros
- Pessoal
- Negócios
- Pessoa Jurídica
médio, todo o conteúdo que tenha perfil com a categoria
de nível médio ou seus descendentes ou ascendentes
aparecerá no menu.
Um Menu com base em Taxas de Juros, exibirá o
Conteúdo cujo perfil tenha uma das seguintes opções:
v Financeiro
– Taxas de Juros
- Pessoal.
- Negócios.
- Pessoa Jurídica.
Um menu baseado em Comercial exibirá o conteúdo cujo
inferior, todo conteúdo que tenha perfil com a categoria perfil tem uma das seguintes opções:
de nível inferior ou seus ascendentes será retornado pelo v Financeiro
menu.
– Taxas de Juros
- Negócios.
Elementos
Crie um website construindo modelos e especificando outros componentes principais do sistema. Uma
vez estabelecidos esses itens, é possível começar a incluir elementos nos modelos e usá-los para criar
itens de conteúdo.
Criando Links e Navegação
Use esses elementos para definir ou gerar links entre páginas diferentes em um website, ou incluir
elementos de navegação em um website.
Elemento de Link
Um elemento de link armazena um link em um item de conteúdo da Web ou um conteúdo externo, como
uma página da Web.
189
A maioria das páginas da Web contém links, para outras páginas da Web ou para arquivos. Em um site
de conteúdo da Web, a maioria dos links é gerada usando elementos de navegador e de menu. Um
elemento de link armazena um link que não faz parte da navegação de um site. Por exemplo, você pode
armazenar um link para o item de conteúdo "home" em um elemento de link. Em seguida, você inclui
uma referência no elemento de link em cada modelo de apresentação utilizado pelo site para permitir que
os usuários retornem ao item de conteúdo "home". Se você desejar alterar seu conteúdo "home", apenas
precisará alterar o item selecionado no elemento de link.
Criando um Elemento de Link
Para criar um elemento de link, é possível incluir um elemento de link em um modelo de autoria, uma
área de site ou um item de conteúdo, ou criar um componente de link.
Utilizando um Elemento de Menu
Para criar um elemento de menu, especifique os critérios da procura de itens de conteúdo, e crie um
layout para os metadados ou conteúdo a serem exibidos em tal elemento.
“Elemento de Menu”
Um elemento de menu exibe os metadados e o conteúdo dos itens de conteúdo que correspondem aos
critérios de procura do elemento de menu. Os critérios de procura de um elemento de menu podem
incluir correspondência de áreas de site, gabaritos de autoria, categorias e palavras-chave.
Elemento de Menu:
Um elemento de menu exibe os metadados e o conteúdo dos itens de conteúdo que correspondem aos
critérios de procura do elemento de menu. Os critérios de procura de um elemento de menu podem
incluir correspondência de áreas de site, gabaritos de autoria, categorias e palavras-chave.
Criando um Elemento de Menu
Somente é possível utilizar um elemento de menu criando um componente de menu. Não é possível
incluir um elemento de menu em modelos de autoria, sites, áreas de site ou itens de conteúdo.
Opções de Procura de Menu
As opções de procura do elemento de menu são definidas na seção Consulta do Componente do Menu
do formulário do elemento de menu. Essas opções de procura definem quais itens de conteúdo do seu
site serão exibidos no elemento de menu. As opções de procura podem incluir uma combinação de
parâmetros de procura incluindo procuras baseadas nos modelos de autoria, categorias e áreas de site.
Os menus podem procurar o seguinte em um Web site:
v Conteúdo com modelos de autoria correspondentes
v Conteúdo com áreas de site correspondentes
v Conteúdo com categorias correspondentes
v Conteúdo com palavras-chave correspondentes
Entre diferentes critérios, as procuras de menu são procuras "e", mas em cada critério de procura, as
procuras de menu são procuras "ou". Por exemplo, um elemento de menu que procura duas categorias
diferentes e um modelo de autoria exibirá itens de conteúdo cujo perfil tenha pelo menos um tipo de
cada perfil. O conteúdo que corresponde apenas a um tipo de perfil não será exibido.
Os menus não exibirão resultados de procura se você selecionar um critério de procura, mas não inserir
nenhum parâmetro de procura. Por exemplo, se o menu estiver configurado para exibir resultados
baseados em categorias, mas nenhuma categoria estiver especificada no formulário de menu, então
nenhuma correspondência será exibida.
190
Opções de Classificação de Menu
Você pode classificar os resultados da procura do menu de acordo com os seguintes critérios.
v
v
v
v
v
v
v
Nome do documento de conteúdo
Descrição do documento de conteúdo
Data da publicação
Data da expiração
Data geral um
Data geral dois
Data de última modificação
É possível selecionar no máximo três opções de classificação.
Opções de Paginação de Menu
O IBM Web Content Manager fornece opções de paginação flexíveis para permitir que você exiba os
resultados de procura que são gerados pelo elemento de menu.
v Você pode especificar o número de resultados exibidos em uma página de menu. Por exemplo, um
menu definido para mostrar cinco resultados por página exibiria apenas os cinco registros do conjunto
de resultados de procura.
v Você pode indicar onde no conjunto de resultados você deseja iniciar a exibição dos resultados, ao
especificar qual página de menu será utilizada como ponto de partida. Por exemplo, se você estiver
exibindo cinco resultados por página de menu e desejar mostrar os registros 6–10, você iniciaria a
exibição dos resultados de procura com a segunda página de menu em vez da primeira.
v Para fornecer navegação mais fácil nos resultados da procura em um menu, você pode incluir um
elemento de navegação de página no cabeçalho ou no rodapé do elemento do menu. O elemento de
navegação de página permite avançar e retroceder através de várias páginas de menu sem precisar
criar vários elementos de menu para exibir páginas diferentes.
v Um grande número de resultados de procura poderá causar um atraso quando o elemento de menu for
inicialmente renderizado. Para evitar esse atraso, você pode limitar o número máximo de resultados
por página incluídos no menu. Para aprimorar ainda mais a eficiência do menu, você também pode
especificar quantas páginas de resultados devem ser lidas além da página atual, para que o
desempenho da paginação não seja afetado pela reconstrução do menu.
Enquanto um elemento de navegação de página for uma forma conveniente de exibir e navegar pelos
resultados de procura de um menu, você pode utilizar as opções de paginação do menu para exibir os
resultados de procura de outras formas. Por exemplo, se você desejar mostrar os resultados em uma
tabela de três colunas, poderá criar três elementos de menu com o mesmo critério de procura, e em
seguida, ajustar as opções de paginação de cada menu para exibir diferentes conjuntos de resultados:
Tabela 37. Exemplo
Menu
Resultados por Página
Página inicial
Registros exibidos
Elemento de menu 1:
5
1
1a5
Elemento de menu 2:
5
2
6 a 10
Elemento de menu 3:
5
3
11 a 15
Os três menus poderiam ser referidos dentro de três células diferentes de uma linha da tabela em um
191
“Utilizando um Elemento de Menu” na página 190
Para criar um elemento de menu, especifique os critérios da procura de itens de conteúdo, e crie um
layout para os metadados ou conteúdo a serem exibidos em tal elemento.
Exemplos de Design de Elementos de Menu:
Você formata a aparência e comportamento dos elementos de menu utilizando HTML e as tags de
sinalizador de substituição.
Design de Menu Simples
Este exemplo mostra a estrutura básica do design de elemento utilizado por um menu para formatar os
dados da procura. Você digita as seguintes tags na seção Design do resultado de procura de cada menu
(Design for each menu search result do formulário de elemento de menu.
Tabela 38. Design para cada resultado de procura de menu
Design
Detalhes
<a href="
[placeholder
tag="href" ]
">
Em vez de uma URL, use um marcador href.
[placeholder
tag="title" ]
</a><br>
Em vez de texto, insira um marcador de título.
Isso será repetido para cada link retornado pela consulta de procura definida no elemento de menu.
Também é possível usar uma tag TitleLink:
Design
detalhes
[placeholder
tag="titlelink" ]
<br>
Produz o mesmo resultado do exemplo anterior.
Ao criar menus para serem utilizados nos portlets de renderização, uma tag URLCmpnt é utilizada para
criar um link em vez de um sinalizador de substituição.
Design para cada resultado de procura de menu:
<a HREF=
"[URLCmpnt context="autofill" type="content" mode="portal" portalTarget="URLMap">"
target="_blank"> [Property context="autofill" type="content" field="title"] </a>
<br>
Utilizando um Menu para Exibir Imagens
Para exibir imagens em um menu, em vez de texto, substitua o sinalizador de substituição de nome por
uma referência a um elemento de Imagem selecionado no conteúdo ou em áreas de site.
Design
Detalhes
<a href="
[placeholder
tag="href" ]
">
Em vez de uma URL, use um marcador href. Isso é onde a URL do item de menu é
inserida no menu renderizado.
192
Tabela 40. Design para cada resultado de procura de menu (continuação)
Design
Detalhes
[element
type="sitearea"
context="autofill"
key="Image"
]
</a></br>
Em vez de um sinalizador de substituição de nome (como no exemplo anterior),
insira uma tag element. O tipo de origem pode ser conteúdo ou área de site. O
contexto é preenchimento automático.
Nesse exemplo, o campo que está sendo referido é "Imagem". As áreas de site ou o
conteúdo que está sendo retornado também deve conter um elemento de Imagem
denominado "Imagem". As imagens que você armazena na área de site ou no
conteúdo podem ser diferentes, mas todas devem ter a mesma etiqueta.
Incluindo um Elemento de Navegação de Página em um Design de Menu
Para incluir controles de navegação em um menu, você inclui uma referência em um elemento de
navegação de página no rodapé ou cabeçalho.
Cabeçalho
<div>
Resultados do Menu
Tabela 41. Design para resultado da procura do menu. Cria uma nova linha de tabela para cada item listado no
menu.
Design
Detalhes
<span>
<a href="
[placeholder
tag="href" ]
">
Em vez de um URL, insira um marcador URL aqui. Isso é onde a URL do item de
menu é inserida no menu renderizado.
[placeholder
tag="name"
] </a><br>
</span>
Em vez de texto, insira um sinalizador de substituição de nome.
Rodapé
Tabela 42. Rodapé
Design
Detalhes
<span>
[component name=
"pagenav" ]
</span>
</div>
Inclua uma referência para um elemento de navegação
de página criado anteriormente para incluir recursos de
navegação em um design de menu. Neste exemplo, o
elemento de navegação de página é referido a partir de
um componente de navegação de página chamado
"pagenav".
Utilizando um Elemento do Navegador
Crie um elemento do navegador para exibir uma lista de links com base em uma seção da estrutura de
um site.
Elementos do Navegador:
Os elementos de um navegador exibem metadados e conteúdo a partir de uma seção predefinida de uma
estrutura de site, geralmente, na forma de links.
Navegadores não são menus. Os menus são uma lista de hyperlinks que o levam a páginas específicas.
Os navegadores também podem ser hyperlinks que o levam a páginas específicas, mas são organizados
193
de modo diferente. Os navegadores apresentam a disposição lógica de um Web site enquanto os menus
são uma lista de páginas da Web relacionadas em seu Web site.
O elemento do navegador é configurado selecionando uma área de início e determinando uma
profundidade de filho, um nível de pai e um valor de irmão em relação à área de início. As áreas de
início possíveis são áreas de site ou itens de conteúdo.
Também existem opções para determinar se a área de início deve ser exibida, se os itens de conteúdo
devem ser exibidos e se a hierarquia da área de início para a área de site atual deve ser expandida.
Um conjunto de designs de elementos é utilizado para formatar as informações de cada ramificação de
um navegador.
Os navegadores exibem links para áreas de site diferentes em um Web site. Assim, cada área de site em
um Web site deve ter um item de conteúdo padrão. Caso contrário, alguns links em um navegador não
funcionarão.
Criando um Elemento de Navegador
Somente é possível utilizar um elemento de navegador criando um componente de navegador. Não é
possível incluir um elemento de navegador em modelos de autoria, áreas de site ou itens de conteúdo.
Exemplos de Formatação do Navegador:
Você utiliza HTML para formatar o layout de um navegador.
v Os elementos do navegador podem ter mais de um design de elemento.
v Cada nível do navegador pode ter o seu próprio design de elemento.
v Se você desejar que todos os níveis de seu navegador tenham a mesma aparência, terá de construir
apenas design de elemento.
v Se houver três níveis em uma área de site, mas apenas dois designs de elemento em seu navegador,
então os dois últimos níveis do navegador utilizarão o design de elemento final.
As tabelas a seguir contêm alguns exemplos de como você pode formatar a aparência de um navegador.
Navegador de Dois Níveis Simples
Este exemplo mostra a estrutura básica do design de elemento utilizado por um navegador.
Tabela 43. Navegador de Dois Níveis Simples
Design
Detalhes
Design
Design de resultados
do navegador 1
Uma tag <b> é
incluída para exibir o
texto no primeiro
nível do navegador
em negrito.
<b>
[placeholder tag="namelink" ]
</b><br>
do navegador 2
O segundo design é
repetido para cada
link retornado pelos
parâmetros definidos
no elemento do
navegador após o
primeiro nível.
<br>
194
Navegador Utilizado em um Portlet de Renderização
Neste exemplo, uma tag URLCmpnt é utilizada para criar um link em vez de um sinalizador de
substituição. Isso permite especificar o nome da página de portal utilizada ao visualizar os links gerados
pelo navegador:
Tabela 44. Navegador Utilizado em um Portlet de Renderização
Campo Design
Código de Design
Cabeçalho
<Tabela>
Design de resultados do
navegador 1
<tr><td>
<b>
<a HREF=
"<URLCmpnt context="autofill" type="content" mode="portal" portalTarget="URLMap"]"
target="_blank"> [Property context="autofill" field="title"] </a></b>
</td></tr>
Design de resultados do
navegador 2
<tr><td>
<a HREF=
"[URLCmpnt context="autofill" type="content" mode="portal" portalTarget="URLMap"]"
target="_blank"> [Property context="autofill" field="title"] </a></td></tr>
Footer (Rodapé)
</Table>
Uma lista desordenada
Neste exemplo, tags de lista desordenada são usadas para formatar resultados do navegador. Esse design
requer a seleção dos seguintes parâmetros do navegador:
v Mostrar campos de cabeçalho, rodapé e separador para cada design de resultado
Tabela 45. Navegador de Dois Níveis Simples
Design
Detalhes
Design
Cabeçalho 1
O cabeçalho é usado
para abrir novas tags
<ul> e <li> em cada
nível no navegador.
<ul><li>
do navegador 1
A tag de marcador é
usada para renderizar
o nome e link de cada [placeholder tag="namelink"]
item no navegador.
Separador 1
o campo de separador
fecha e abre a tag <li>
</li><li>
para cada item
exibido no navegador.
Rodapé 1
O rodapé é usado
para fechar as tags
</ul> e </li> em
cada nível do
navegador.
</li></ul>
195
Tabela 45. Navegador de Dois Níveis Simples (continuação)
Design
Detalhes
Marcação de
Apresentação 2
Neste exemplo, você
não precisa incluir
nenhuma marcação na
Marcação de
Apresentação 2. A
marcação inserida em
Marcação de
Apresentação 1 é
usada
automaticamente para
os outros níveis do
navegador.
Design
Exemplos de Tipos de Navegador:
Você pode utilizar os elementos do navegador para exibir diferentes seções de uma estrutura do site em
diferentes maneiras.
Navegadores Breadcrumb
Se um Web site for grande e complexo, um usuário poderá facilmente ficar perdido. Uma navegação
estrutural permite que o usuário veja a posição da página da Web atual no Web site e o caminho lógico
de volta para o nível mais alto da estrutura do site. Uma trilha de navegação não fornece o caminho real
que o usuário percorreu no Web site; o botão Voltar do navegador fornece isso. Uma navegação
estrutural é o dispositivo de orientação que mostra a um usuário onde a página da Web exibida se
encontra na estrutura do site.
Você utiliza as seguintes definições de configuração para criar um navegador breadcrumb:
Tabela 46. Configurações de Parâmetro do Navegador de Breadcrumb
Parâmetro
Configuração
Tipo de Início
Áreas de site atual
Incluir Início
Sim
Nível Anterior
Todos
Nível Descendente
Nenhum
Nível de Irmãos
Precedentes
Nenhum
Próximo Nível de Irmãos
Nenhum
Mostrar Parte Superior
Não
Mostrar Conteúdo
Sim
Expandir navegador para
exibir área de site atual
Não
Expandir ramificação do
navegador atual em um
nível
Não
Realçar área de site ou
conteúdo atual usando
design de resultado do
navegador final
Não
196
Navegadores de Mapa do Site
Um mapa do site fornece, resumidamente, a estrutura do site. Um mapa do site é um componente do
navegador que exibe essa parte da estrutura do site que você define.
Para criar um mapa do site, o navegador é configurado como segue:
Tabela 47. Configurações de parâmetro do navegador do mapa do site
Parâmetro
Configuração
Tipo de Início
Site Atual
Incluir Início
Sim
Nível Anterior
Nenhum
Nível Descendente
2 Níveis
Nível de Irmãos
Precedentes
Nenhum
Próximo Nível de Irmãos
Nenhum
Mostrar Parte Superior
Não
Mostrar Conteúdo
Não
Expandir navegador para
exibir área de site atual
Não
Expandir ramificação do
navegador atual em um
nível
Não
Realçar área de site ou
conteúdo atual usando
design de resultado do
navegador final
Não
Utilizando um Elemento Search
Um elemento de procura é usado para exibir os resultados de uma consulta de procura. Um elemento de
procura não pode ser usado isoladamente, mas deve ser usado junto com um elemento HTML que seja
usado para definir o formulário de consulta de procura.
Para criar um formulário de procura, é necessário:
1. criar uma consulta de procura usando um elemento HTML
2. criar uma visualização de resultados da procura usando um componente de procura
Faça referência ao elemento HTML e ao componente de procura em um único modelo de apresentação. O
componente de procura só é renderizado depois que uma consulta de procura é executada por um
usuário.
“Ativando a Procura para o Conteúdo da Web” na página 111
Use a Procura de Portal para procurar o texto exibido em sites da Web criados por IBM Web Content
Manager.
Exemplos de Consulta de Procura
Estes são exemplos de consultas de procura que você pode criar usando um elemento HTML.
197
Consulta de Procura Simples
Este é um exemplo de um formulário de consulta de procura simples:
Tabela 48. Consulta de Procura Simples
Exemplo de código
Descrição
<form
action=’<PathCmpnt type="servlet" />
/library/sitearea/content’ method="post">
Este é o cabeçalho do
formulário em que você
especifica o local do item de
conteúdo que contém o
elemento search utilizado
para exibir o resultado da
procura.
Geralmente, é o mesmo item
de conteúdo em que esse
elemento HTML está
armazenado.
<table>
<tr><td>
<input type="text" name="search_query"/>
</td></tr>
<tr><td align="right">
<input type="submit" value="Search"/>
</td></tr>
</table>
É o corpo do formulário de
procura. Como qualquer
formulário HTML padrão,
ele contém um campo de
entrada e um botão de
envio.
</form>
Fecha o formulário.
Neste exemplo, uma tabela
foi utilizada para formatar o
formulário de consulta de
procura.
Procurando Metadados
Neste exemplo, foram incluídos mais dois campos, permitindo que os usuários procurem o título do
conteúdo e o nome do autor:
Tabela 49. Procurando Metadados
Exemplo de código
Descrição
<form
procura.
elemento HTML está
armazenado.
198
Tabela 49. Procurando Metadados (continuação)
Exemplo de código
Descrição
<table>
<tr>
ele contém campos de
envio.
<td>Content Title</td>
<td><input type="text" name="search_title"/></td>
</tr>
<tr>
<td>Author’s Name</td>
<td><input type="text" name="search_authors"/></td>
</tr>
<tr>
<td>Content Body</td>
<td>
</td></tr>
</td></tr>
</table>
</form>
Incluindo Dados Ocultos
Neste exemplo, um campo oculto foi incluído para restringir a procura a conteúdo que utiliza o modelo
de autoria, chamado "Press Release":
Tabela 50. Incluindo Dados Ocultos
Exemplos de código
Descrição
<form
procura.
elemento HTML está
armazenado.
<input type="hidden"
name="search_authoringtemplate"
value="Press Release"/>
Neste exemplo, um campo
oculto de entrada foi
incluído e procura conteúdo
que utiliza o modelo de
autoria, chamado "Press
Release".
199
Tabela 50. Incluindo Dados Ocultos (continuação)
Exemplos de código
Descrição
<table>
<tr>
ele contém campos de
envio.
<td>Content Title</td>
<td><input type="text" name="search_title"/></td>
</tr>
<tr>
<td>Author’s Name</td>
<td><input type="text" name="search_authors"/></td>
</tr>
<tr>
<td>Content Body</td>
<td>
</td></tr>
</td></tr>
</table>
</form>
Exemplos de Resultado da Procura
Estes são exemplos de como projetar seus resultados da procura.
Exemplo de Design de Elemento de Procura para Uso em um Web Site
Neste exemplo, uma tabela é usada para o layout dos resultados da procura.
Tabela 51. Exemplo de Design de Elemento de Procura para Uso em um Web Site
Campo Design
Detalhes
Cabeçalho
Exemplo de código
<table>
Resultado
Os atributos a serem
exibidos em cada
resultado de procura
são definidos aqui.
<tr><td>
<attributeResource attributeName="namelink"/><br>
<attributeResource attributeName="summary"/>
</td></tr>
Separador
Um separador pode
ser utilizado para
delinear cada
resultado de procura.
<tr><td
Rodapé
<tr><td>
Um elemento de
<component name="pagenavigationcomponent"/>
navegação de página
</td></tr>
armazenado em um
</table>
componente é
mencionado aqui para
incluir a navegação de
página nos resultados
da procura.
Nenhum Resultado
(No results)
200
bgcolor="#FFFAA" colspan="2"/></tr>
Não há resultados para sua consulta. Refine sua procura e tente
novamente.
Exemplo de Design de Elemento de Procura para Utilização em um Portlet de
Renderização
Neste exemplo, uma tabela é usada para o layout dos resultados da procura.
Tabela 52. Exemplo de Design de Elemento de Procura para Utilização em um Portlet de Renderização
Campo Design
Detalhes
Cabeçalho
Resultado
Exemplo de código
<table>
Os atributos a serem
exibidos em cada resultado
de procura são definidos
aqui.
Ao exibir os resultados da
procura em um portlet de
renderização, você deve
especificar a página na qual
o conteúdo vinculado será
exibido quando aberto.
<tr><td>
<a href="/[PORTAL_CONTEXT_ROOT]/
[PORTAL_PAGE_URL_MAPPING]/?WCM_GLOBAL_CONTEXT=
<AttributeResource attributeName="url" />">
<AttributeResource attributeName="title" /></a>
<attributeResource attributeName="summary"/>
</td></tr>
Um mapa de URL para a
página de portal que
contém o portlet de
renderização é necessário.
Separador
Um separador pode ser
<tr> <td
utilizado para delinear cada
resultado de procura.
Rodapé
Um elemento de navegação
de página armazenado em
um componente é
mencionado aqui para
incluir a navegação de
página nos resultados da
procura.
Nenhum Resultado (No
results)
bgcolor="#FFFAA" colspan="2"/>
</tr>
<tr><td>
[component name="pagenavigationcomponent"]
</td></tr>
</table>
Não há resultados para sua consulta. Refine sua procura
e tente novamente.
Armazenando Texto e HTML
Você utiliza tipos diferentes de elementos para armazenar texto ou HTML, dependendo do tipo de texto
ou de HTML que está sendo criado.
Dica: Texto comum a todo o conteúdo que utiliza um modelo de apresentação único deve ser digitado
diretamente no modelo de apresentação, não em elementos separados.
Elementos de Texto, Rich Text e HTML
Você utiliza o elementos de texto curto, texto, texto complexo e HTML para armazenar blocos de texto,
mas cada um deles possui propriedades um pouco diferentes.
Criando um Elemento
Elementos de texto curto, texto, rich text e HTML podem ser incluídos em áreas de site, itens de
conteúdo e modelos de autoria ou podem ser criados como componentes individuais.
201
Elemento de Texto Abreviado
Um elemento de texto curto é utilizado para armazenar pequenas quantias de texto com comprimento
fixo, em que o comprimento tenha 250 bytes ou menos. Ao contrário dos outros elementos de texto, os
elementos de texto curto também podem ser utilizados como um parâmetro de procura em uma regra do
Personalização.
Elemento de Texto
Utilize um elemento de texto para armazenar quantias de texto maiores do que se pode armazenar em
um elemento de texto curto. Nenhum processamento especial ocorre para esse elemento.
Elemento HTML
Um elemento HTML é utilizado para armazenar fragmentos de HTML que podem ser reutilizados em
modelos de apresentação e outros designs de elementos. Você pode digitar HTML diretamente no
elemento ou fazer upload de HTML a partir de um arquivo HTML criado anteriormente.
Elemento de Texto Complexo
Um elemento de texto complexo é semelhante ao elemento HTML, exceto que inclui um editor de texto
complexo que pode ser utilizado para formatar texto armazenado em um elemento de texto complexo. O
principal propósito do elemento de texto complexo é fornecer aos criadores de conteúdo no nível base
um editor de texto fácil de ser utilizado. Usuários avançados que precisam produzir código mais
avançado, incluindo tags de conteúdo da Web, ou que precisam armazenar fragmentos de HTML devem
usar um elemento HTML.
Você deve usar elementos de rich text moderadamente em modelos de autoria, áreas de site e itens de
conteúdo, pois a inclusão de múltiplos elementos de rich text nesses itens pode reduzir o desempenho da
autoria.
Os editores de rich text usados pelo Web Content Manager são fornecidos por outros fornecedores. Para
obter informações sobre o uso do editor de rich text, consulte a documentação do usuário fornecida pelo
fornecedor do editor de rich text específico.
Usando Tags de Conteúdo da Web em Elementos de Rich Text e HTML
Tabela 53. Usando Tags de Conteúdo da Web em Elementos de Rich Text e HTML
Tipo de elemento
Detalhes
Elementos de Texto Curto e
de Texto
Tags de conteúdo da Web não podem ser utilizadas em elementos de texto curto e de
texto.
Elementos HTML
Qualquer combinação de tags de conteúdo da Web pode ser usada em elementos
HTML com as seguintes exceções:
1. Não é possível utilizar aspas simples em redor dos valores de atributo.
v [Component name='example']
v [Component name='example' start='<a href="' end=' ">link</a>']
v [Component name='example' start='<img src="' end=' "/>']
2. Não é possível utilizar aspas duplas dentro dos valores de atributo.
v [Component name="example" start="<a href="" end="">link</a>"]
v [Component name="example" start="<img src="" end=""/>"]
202
Tabela 53. Usando Tags de Conteúdo da Web em Elementos de Rich Text e HTML (continuação)
Tipo de elemento
Detalhes
Elementos Rich Text
As tags básicas do Web Content Manager podem ser utilizadas em elementos de rich
text. Por exemplo, as seguintes tags podem ser utilizadas em elementos de Rich Text:
v [component name="test"]
v [element type="content" context="current" key="body"]
Nota: O realce de elementos RTF não está ativado por padrão. Para ativar esse
suporte, assegure-se de que o seu administrador do servidor inclua a seguinte
propriedade no serviço WCM WCMConfigService:
v Nome da propriedade: wcm.enableWCMTagHighlighting
v Valor: true
Os seguintes formatos de tag são inválidos:
1. O uso de aspas simples em redor dos valores de atributo.
v [Component name='example']
v [Component name='example' start='<a href="' end=' ">link</a>']
v [Component name='example' start='<img src="' end=' "/>']
2. O uso de aspas duplas dentro dos valores de atributo.
v [Component name="example" start="<a href="" end="">link</a>"]
v [Component name="example" start="<img src="" end=""/>"]
3. Tags incorporadas dentro de outras tags HTML.
v <a href='[Component name="example"]'>link</a>
v <img src='[Component name="example"]'/>
Elemento de Número
Você pode armazenar um valor numérico em um elemento de número.
Criando um Elemento de Número
Para criar um elemento de número, é possível incluir um elemento de número em um modelo de autoria,
uma área de site ou um item de conteúdo, ou criar um componente de número.
Armazenando Arquivos e Imagens
Você utiliza estes elementos para armazenar arquivos ou imagens.
Elemento de Recurso de Arquivo
É possível armazenar um arquivo em um elemento de recurso do arquivo. É possível, então, referenciar o
recurso do arquivo para que usuários possam fazer download do arquivo usando um link ou, para tipos
de arquivos suportados, converter o arquivo diretamente em HTML e renderizá-lo na página.
Armazenando um arquivo em um elemento de recurso de arquivo:
v Você pode fazer referência do arquivo em qualquer lugar no site, independentemente do local ou da
URL do arquivo original.
v O arquivo é transferido automaticamente para outros servidores durante a distribuição.
203
Criando um Elemento de Recurso de Arquivo
Para criar um elemento de recurso de arquivo, é possível incluí-lo em um modelo de autoria, uma área
de site ou um item de conteúdo ou criar um componente de recurso de arquivo.
Usando um item de conteúdo de recurso versus usando um componente de recurso de arquivo:
Se você configurar um modelo de autoria para ser um modelo de recurso, os itens de conteúdo criados
usando esse modelo de autoria serão conhecidos como itens de conteúdo do recurso. Como um
componente de recurso de arquivo, os arquivos armazenados dentro de um item de conteúdo de recurso
podem ser renderizados diretamente em uma página da Web. A diferença entre usar um item de
conteúdo de recurso em vez de um componente de recurso de arquivo é que um item de conteúdo de
recurso pode ser listado em componentes navegacionais, como menus e navegadores.
Fazendo Referência a um Recurso de Arquivo
Um recurso de arquivo pode ser referenciado nos modelos de apresentação e em outros designs de
elemento usando uma tag de componente ou de elemento.
Criando um Link para um Recurso de Arquivo
Para criar um link para um recurso de arquivo em um modelo de apresentação ou um design de
elemento para que usuários façam download da referência de arquivo, use as estruturas de tag a seguir.
Para criar um link para um componente de recurso de arquivo, use uma tag de componente:
<a href="[component name="FileResourceName"]">Link Text</a>
Para criar um link para um elemento de recurso de arquivo, use uma tag de elemento. Por exemplo, para
vincular-se a um elemento de recurso de arquivo no item de conteúdo atual:
<a href="[element type="content" content="current" key="FileResourceName"]">Link Text</a>
Renderizando um Recurso de Arquivo em uma Página
Se seu recurso de arquivo for um tipo de arquivo que pode ser convertido em HTML, será possível, em
vez disso, converter o arquivo em HTML e renderizar o HTML convertido diretamente em seu conteúdo
da Web usando o parâmetro format="HTML" em uma tag de componente ou de elemento. Por exemplo:
[component name="FileResourceName" format="HTML"]
[element type="content" content="current" key="FileResourceName" format="HTML"]
Exemplos de tipos de arquivos suportados incluem:
v
v
v
v
Documentos de processamento de texto (*.doc, *.odt)
Planilhas (*.xls) *
Arquivos HTML (*.htm, *.html)
Arquivos de texto (*.txt)
Outros tipos de arquivos também podem funcionar, mas você precisará testá-los primeiro.
Nota: Se você configurar um modelo de autoria para ser um modelo de recurso, então os itens de
conteúdo criados serão itens de conteúdo de recurso. Quando um link para um item de conteúdo de
recurso for renderizado, o arquivo armazenado no elemento de recurso de arquivo selecionado é
renderizado na página da Web. Nesse caso, você não usaria uma tag de elemento. Em vez disso, o
recurso de arquivo é renderizado usando uma tag de marcador em um design de navegador ou de menu,
ou criando um link diretamente no próprio conteúdo de recurso.
204
Elemento de Imagem
Você armazena uma imagem em um elemento de imagem.
Ao armazenar uma imagem em um elemento de imagem:
v Você pode fazer referência da imagem em qualquer lugar no site, independentemente do local ou da
URL do arquivo original.
v A imagem é transferida automaticamente para outros servidores durante a sindicância.
v Você pode fazer referência ao elemento de imagem dentro de outros itens, conforme necessário.
Criando um Elemento de Imagem
Para criar um elemento de imagem, é possível incluí-lo em um modelo de autoria, uma área de site ou
um item de conteúdo, ou criar um componente de imagem.
Nota: As imagens com nomes que incluem caracteres não ASCII não podem ser pré-renderizadas. Se
você estiver pré-renderizando um site, você deve renomear a imagem antes de incluí-la no elemento de
imagem.
Tipos Mime Válidos
É possível configurar quais tipos mime são válidos para um elemento de imagem editando a
configuração imageresourcecmpnt.allowedmimetypes. Consulte “Opções de Autoria do Conteúdo da Web”
na página 69 para obter informações adicionais.
Elementos da JSP
Você utiliza um elemento da JSP para armazenar um caminho para uma JSP. Quando renderizado em um
modelo de apresentação ou design de elemento, um pedido para uma JSP é gerado e renderizado.
Criando um Elemento JSP
Para criar um elemento JSP, é possível incluir um elemento JSP em um modelo de autoria, uma área de
site ou um item de conteúdo, ou criar um componente JSP.
Organização:
A distribuição não moverá a página JSP utilizada como referência em um elemento da JSP. Somente o
item que contém o elemento JSP será movido. Você precisará armazenar a página JSP nas mesmas pastas
nos servidores de assinatura e de distribuição.
Nota:
A JSP referida em um componente JSP não deve incluir uma referência, direta ou indiretamente, no
mesmo componente JSP. Isso inclui referências nas tags de conteúdo da Web ou na API. Se incluir, será
criado um loop e ocorrerão erros.
Utilizando Folhas de Estilo em Itens
Folhas de estilo podem ser usadas para formatar a aparência e o comportamento de páginas do IBM Web
Content Manager da mesma forma que em páginas da Web normais.
Criando e Fazendo Referência a Elementos de Folha de Estilo
Elementos de folha de estilo só podem ser armazenados em componentes de folha de estilo.
Para vincular um componente de folha de estilo a um modelo de autoria específico, selecione um
componente de folha de estilo como a folha de estilo padrão em um modelo de autoria.
205
Para vincular um componente de folha de estilo para uma área de site ou um item de conteúdo
específico, você deve incluir um elemento de referência de componente em uma área de site ou um item
de conteúdo e selecionar um componente de folha de estilo.
Fazendo Referência a um Elemento de Folha de Estilo em um Modelo de Apresentação
Elementos de folha de estilo são referidos na seção "cabeçalho (header)" de um modelo de apresentação
utilizando uma tag de componente ou de elemento de estilo.
Tabela 54. Fazendo Referência a um Elemento de Folha de Estilo em um Modelo de Apresentação
Detalhes
Exemplo de código
Para utilizar a folha de
estilo especificada no
modelo de autoria do item
de conteúdo atual, utilize
uma tag <styleElement>.
<HTML>
<HEAD>
<styleElement source="template"/>
</HEAD>
<BODY></BODY>
</HTML>
Para usar a folha de estilo
selecionada em um
elemento de referência de
componente armazenado
na área de site ou no item
de conteúdo atual, você
deve usar uma tag
<styleElement>.
<HTML>
<HEAD>
<styleElement source="path" name="component
reference name"/>
</HEAD>
<BODY></BODY>
</HTML>
Para utilizar uma folha de
estilo específica, você deve
utilizar uma tag
<component>.
<HTML>
<HEAD>
<component name="style sheet
component name"/>
</HEAD>
<BODY></BODY>
</HTML>
Quando renderizado no conteúdo da Web, as referências aos componentes da folha de estilo são
renderizadas como links de folha de estilo externos:
<HTML>
<HEAD>
<link href="stylesheet" media="media-type" rel="styleheet-type" type="text">
</HEAD>
<BODY></BODY>
</HTML>
Utilizando Estilos em Tags HTML
Estilos são utilizados em HTML armazenado em modelos de apresentação e designs de elemento da
mesma forma que HTML normal. O estilo deve existir na folha de estilo que foi referida no modelo de
apresentação utilizado para renderizar o HTML.
Por exemplo, para incluir uma classe chamada "wcm" em uma tag de título:
<H1 class="wcm">Heading</H1>
Usando Estilos em Tags de Conteúdo da Web
As folhas de estilo podem ser utilizadas para formatar o estilo do conteúdo recuperado utilizando as tags
do Web Content Manager. O estilo deve existir na folha de estilo que foi referida no modelo de
apresentação utilizado para renderizar a tag do Web Content Manager.
206
Por exemplo, para formatar os links em um menu utilizando uma classe de folha de estilo chamada
"wcm", a seguinte tag do sinalizador de substituição seria utilizada:
<a href="<placeholder tag="href" />" class="wcm"><placeholder tag="name" /></a>
Elementos de seleção
Você pode usar esses elementos para fazer seleções por elementos existentes e dados.
Elemento de Referência de Componente
Você utiliza um elemento de referência de componente para armazenar uma referência a um componente.
Você utiliza elementos de referência de componente de duas maneiras:
v Um elemento de referência de componente pode ser incluído em um modelo de autoria. Isso permite
que os criadores de conteúdo selecionem um componente existente em uma biblioteca de componentes,
em vez de construírem os seus próprios componentes.
v Ao fazer referência a um elemento de referência de componente em um modelo de apresentação ou em
outro elemento, o componente que está sendo exibido pode ser alterado sem que seja preciso alterar o
modelo de apresentação ou o design de elemento.
Por exemplo, se tiver feito referência a um elemento de referência de componente chamado "Produto
de Destaque" ["Featured Product"] em mais de um modelo de apresentação, o elemento referido dentro
do elemento de referência de componente poderá ser alterado sem precisar editar os gabaritos de
apresentação.
Criando um Elemento de Referência de Componente
Para criar um elemento de referência de componente, é possível incluí-lo em um modelo de autoria, uma
área de site ou um item de conteúdo, ou criar um componente de referência de componente.
Elemento de Data e Hora
Você usa um elemento de data e hora para armazenar uma data ou hora a ser exibida em uma página da
Web.
Criando um Elemento de Data e Hora
Para criar um elemento de data e hora, é possível incluir um elemento de data e hora em um modelo de
autoria, uma área de site ou um item de conteúdo, ou criar um componente de data e hora.
Elemento de Seleção de Opção
Um elemento de seleção de opção é usado para apresentar uma lista de opções predefinidas que seus
criadores de conteúdo podem selecionar ao criar um item de conteúdo ou uma área de site. Um elemento
de seleção de opção pode ser incluído apenas em um modelo de autoria.
Ao usar um elemento de seleção de opção, é possível inserir um conjunto de opções customizado ou
selecionar um conjunto de categorias. A opção que você usará dependerá de como deseja usar o elemento
de seleção de opção.
Simplificando a Determinação de Perfis de Itens
Se você selecionar um conjunto de categorias em um elemento de seleção de opção, poderá optar por ter
as categorias que um usuário seleciona ao criar um item incluído no perfil do item. Isso significa que
você pode usar diversos elementos de seleção de opção em um formulário de item para simplificar o
processo de criação de perfil de um item. Por exemplo, se você usou taxonomias separadas para "tipo de
produto", "equipe" e "campanha", poderia usar três elementos de seleção de opção separadas em um
modelo de autoria. Isso facilitaria a seleção de categorias pelos criadores de conteúdo a partir de cada
taxonomia no formulário de conteúdo.
207
Exibindo Texto Diferente em uma Página Renderizada
Um caso de uso simples para o uso de elementos de seleção de opção é quando você deseja permitir que
os criadores de conteúdo selecionem a partir de uma lista pequena de opções de texto que será então
renderizado em uma página. Por exemplo, se você quisesse indicar diferentes tipos de documentos, como
"procedimento", "política" ou "notícias" na página renderizada.
Trabalhando com Código Customizado
Os elementos de seleção de opção podem também ser usados para permitir que os criadores de conteúdo
selecionem diferentes opções que podem ser então usadas como parâmetros em algum código
customizado, como um fluxo de trabalho customizado ou um componente JSP.
Elemento de Seleção do Usuário
Um elemento de seleção de usuário armazena uma seleção de usuários ou grupos.
Criando um Elemento de Seleção de Usuário
Para criar um elemento de seleção de usuário, é possível incluir um elemento de seleção de usuário em
um modelo de autoria, uma área de site ou um item de conteúdo, ou criar um componente de seleção de
usuário.
Utilizando um Elemento de Seleção de Usuário
Clique em Selecionar Usuários (Select Users) para selecionar usuários e grupos.
v Selecione Usuários ou Grupos.
v Digite o texto para procura no campo Procurar e, em seguida, clique em Procurar. Deixe o campo
Procurar em branco para exibir todos os usuários ou grupos. Selecione os usuários ou grupos
requeridos e, em seguida, clique em OK.
v Para remover um usuário ou grupo, selecione os usuários ou grupos que você gostaria de remover e,
em seguida, clique em Remover.
Nota: Os usuários virtuais não podem ser selecionados em um elemento de seleção do usuário.
Conteúdo Personalizado
Você utiliza estes elementos para criar ou fazer referência ao conteúdo personalizado.
Elemento de Personalização
Um elemento de personalização armazena uma referência a uma regra ou ponto de conteúdo de
personalização gerado pelo Portal Personalization. Para utilizar um elemento de personalização, você
deve criar um componente de personalização.
Um elemento de personalização pode:
v Exibir conteúdo de personalização dentro de um modelo de apresentação ou design de elemento.
v Exibir um link ao conteúdo de personalização dentro de um modelo de apresentação ou design de
elemento.
v Exibir atributos do conteúdo de personalização dentro de um modelo de apresentação ou design de
elemento.
Criando um Elemento de Personalização
Somente é possível utilizar um elemento de personalização criando um componente de personalização.
Não é possível incluir um elemento de personalização em modelos de autoria, áreas de site ou itens de
conteúdo.
208
Nota: Um máximo de 100 itens pode ser exibido em um único elemento do Personalization.
Controles de Acesso
Ao criar um elemento de personalização, um usuário será capaz de selecionar apenas as regras de
personalização e pontos do conteúdo aos quais possui acesso no Portal Personalization.
A regra de personalização ou o ponto de conteúdo selecionado no elemento de personalização será
renderizado apenas se o usuário que estiver visualizando o conteúdo da Web tiver acesso à regra de
personalização ou ao ponto de conteúdo no Portal Personalization.
Recriando regras do Personalization e pontos de conteúdo
Se você excluir uma Regra de Personalização ou ponto de Conteúdo que foi referido em um elemento de
Personalização e, em seguida, criar uma nova Regra de Personalização ou ponto de conteúdo com o
mesmo nome, ele não será mais exibido no elemento de Personalização. Você precisará editar o elemento
de Personalização e selecionar novamente a Regra de Personalização ou o ponto de conteúdo.
Componentes de Personalização de Armazenamento em Cache
O armazenamento em cache de conteúdo da Web pode, às vezes, ser usado com componentes de
Personalização, mas dependerão das condições configuradas na regra de personalização ou dos recursos
usados para determinar os resultados da regra. O teste de cache será necessário para determinar se o
conteúdo retornado por seu componente de personalização pode ser armazenado em cache usando o
armazenamento em cache do conteúdo da Web.
Exemplos de Elementos de Personalização
O layout e o design de um elemento de personalização são criados de um modo semelhante ao de um
elemento de menu, com um design de cabeçalho, design de rodapé e um design a ser repetido para cada
resultado.
Criando um Menu Personalizado
1. Crie um ponto de conteúdo ou uma regra de personalização no Portal Personalization com base em
algum conteúdo do Web Content Manager.
2. Crie um elemento de personalização no Web Content Manager.
v Clique no botão Procurar e selecione o ponto de conteúdo ou regra de personalização criada
anteriormente. Clique em OK.
v Crie um design de elemento para exibir os resultados do ponto de conteúdo ou da regra de
personalização. Isso é semelhante ao design de um elemento de Menu ou Navegador. Por exemplo,
digite o seguinte na seção "Design para cada Resultado de Procura de Menu":
<br>
3. Salve o elemento de personalização.
4. Faça referência ao elemento de personalização em um gabarito de apresentação.
Exibindo o Conteúdo Personalizado
Para exibir uma única parte do conteúdo personalizado do Web Content Manager para diferentes
usuários:
1. Crie um gabarito de autoria que inclui um elemento. Por exemplo, um elemento de texto chamado
"body".
2. Crie um conjunto de itens de conteúdo com base nesse gabarito de autoria.
209
3. Criar um ponto de conteúdo ou uma regra de personalização no Portal Personalization com base no
modelo de autoria e no conteúdo. O ponto de conteúdo ou a regra de personalização devem retornar
somente uma única parte do conteúdo do Web Content Manager para cada usuário.
personalização. Por exemplo, insira o seguinte na seção Design para cada Resultado de Procura de
Menu:
[element type="Content" context="autofill" key="Body"]
Isso exibirá o conteúdo do elemento de texto chamado "Body" a partir do item de conteúdo
retornado pelo ponto de conteúdo ou pela regra de personalização.
6. Faça referência ao elemento de personalização em um gabarito de apresentação.
Exibindo Componentes de Conteúdo da Web Personalizado
Um conjunto de componentes de conteúdo da Web pode ser exibido usando um elemento de
personalização:
1. Crie um ponto de conteúdo ou uma regra de personalização no Portal Personalization que procure
por componentes de conteúdo da Web.
personalização. Por exemplo, insira o seguinte na seção design de elemento:
Cabeçalho:
<div>
Design de cada resultado da procura de menu:
Você deve utilizar uma tag Component com um contexto de "autofill".
<span>
[Component context="autofill" ]
</span><br>
Rodapé:
</div>
4. Referencie o elemento de personalização em um modelo de apresentação.
Exibindo Atributos do Conteúdo Personalizado
Os atributos de conteúdo personalizado também podem ser exibidos utilizando um componente de
personalização:
1. Crie um ponto de conteúdo ou regra de personalização no Portal Personalization.
personalização. Por exemplo, insira o seguinte na seção design de elemento:
Cabeçalho:
210
<div>
Design de cada resultado da procura de menu:
Você deve usar uma tag "AttributeResource" para cada atributo que deseja exibir. Exemplo:
<span>
[AttributeResource attributeName="ibmcm:title"]
[AttributeResource attributeName="ibmcm:effectiveDate"]
</span><br>
Rodapé:
</div>
4. Referencie o elemento de personalização em um modelo de apresentação.
Notas:
Exibindo Palavras-chave e Categorias:
Para recuperar uma lista de categorias ou palavras-chave, utilize a tag de Propriedade.
Exibindo Autores e Proprietários:
Para recuperar uma lista de autores ou proprietários, utilize a tag de Propriedade.
Exibindo o Caminho do Site:
Para exibir o caminho do site para um elemento personalizado do Web Content Manager, utilize uma tag
do sinalizador de substituição.
Elemento de Taxonomia
Um elemento de taxonomia define o layout de um formulário de seleção de categoria que permite que os
usuários selecionem categorias para exibir em um menu personalizado.
Configure o elemento selecionando uma taxonomia ou categoria para ser a área de início da árvore de
seleção de categoria. Em seguida, selecione uma profundidade de filhos relativa à área de início.
Selecione "Incluir Início" se você desejar que a área de início seja exibida na árvore de seleção de
categoria. Esta opção não terá efeito se a área de início for uma taxonomia.
Há duas opções de design de elemento disponíveis: uma é renderizada quando o usuário que efetuou
logon seleciona a categoria que deve ser exibida e a outra caso o usuário não selecione a categoria. Esses
designs de elemento são elementos de texto complexo utilizados de forma semelhante aos elementos de
navegador e de menu.
Nota: Para utilizar esse recurso, é necessário configurar um banco de dados de extensão de propriedade
para armazenar dados específicos do usuário. Consulte Gerenciando Dados do Usuário para obter
informações adicionais.
Criando um Elemento de Taxonomia
Somente é possível utilizar um elemento de taxonomia criando um componente de taxonomia. Não é
possível incluir um elemento de taxonomia em modelos de autoria, áreas de site ou itens de conteúdo.
Criando Árvores de Seleção de Categoria
Você utiliza árvores de seleção de categoria para permitir que os usuários personalizem seus menus.
Nota:
211
v Assegure-se de que a propriedade connect.businesslogic.module.ajpecatselect.class esteja definida
no serviço WCM WCMConfigService, usando o WebSphere Integrated Solutions Console, com um valor de
com.aptrix.pluto.CategoryProfileUpdaterModule.
v Você não pode utilizar árvores de seleção de categoria em um portlet Local Rendering. Em vez disso,
você deve renderizar a árvore diretamente. Exemplo:
http://host:port/wps/wcm/myconnect/library/sitearea/content
Formulário do Elemento de Taxonomia
A principal função do elemento de taxonomia é exibir uma árvore de seleção de categoria utilizada para
permitir que um usuário selecione categorias para personalização do menu.
v Você configura o elemento selecionando uma taxonomia ou uma categoria como uma área de início.
v Selecione uma profundidade filha na área de início e um nível pai relativos à área de início.
v Selecione "Incluir Início" para exibir a área de início. Essa opção não terá nenhum efeito se a área de
início for uma taxonomia.
v Há duas opções de design de elemento disponíveis:
– Uma é processada quando o usuário que efetuou logon seleciona a categoria que deve ser exibida.
– A outra será processada se o usuário não tiver selecionado a categoria.
Esses designs de elemento são elementos de rich text e são utilizados de modo similar aos elementos
do navegador e de menu.
O exemplo de formulário do elemento de taxonomia cria um formulário de entrada da caixa de seleção:
v O número de identificação da categoria é atribuído ao atributo "value" nos campos de entrada.
v Os campos de entrada da caixa de opções são criados, designando o valor "selectedCategories" ao
atributo "name".
v Os campos de entrada ocultos são criados, atribuindo o valor "visibleCategories" ao atributo "name".
Designs de Elemento
Os exemplos de código a seguir são utilizados para desenvolver uma árvore de seleção de categoria
básica:
Tabela 55. Cabeçalho
Código
Detalhes
[PathCmpnt end="/[Library]/[SiteArea]/[Content]?MOD=AJPECatSelect’
method=post>
"start="
<FORM action=’" type="servlet"]
Chama o Módulo Atualizador de
Perfil da Categoria.
value=’[PathCmpnt type="servlet"]/[Library]/[SiteArea]/[Content]’
name="redirectURL">
Isso aponta para a página que deverá
ir depois que o pedido do usuário
tiver sido processo. O elemento não
será renderizado corretamente se o
caminho "[Site area]/[Content]" não
for válido.
212
Tabela 55. Cabeçalho (continuação)
Código
Detalhes
name="updateSourceProfile" value="true">
Essa linha determina como um perfil
de categoria do usuário é atualizado.
O parâmetro "value" é opcional.
True
Atualiza de forma
permanente o perfil de
categoria do usuário.
Falso
Atualiza somente o perfil de
sessão do usuário.
Atualizando o perfil de
sessão do usuário:
As categorias selecionadas
do usuário são calculadas ao
combinar as categorias que
estão no perfil de sessão do
usuário e as categorias que
estão em um perfil de
categoria do usuário
permanente. Portanto, se
uma categoria estiver no
perfil de categoria do usuário
e for removida apenas do
perfil de sessão do usuário,
ela ainda será mostrada
como selecionada.
Tabela 56. Design de Elemento Não Selecionado
Código
Detalhes
<input type="checkbox" name="selectedCategories"
value="[Placeholder tag="idnum"]"/>
<IndentCmpnt offset="0" repeat=".."]
[Placeholder tag="name"]
<input type="hidden" name="visibleCategories"
<br>
É utilizado para exibir itens com seleção cancelada na
árvore de seleção de categorias exibidas.
Tabela 57. Design de Elemento Selecionado
Código
Detalhes
<input type="checkbox" checked name="selectedCategories"
[IndentCmpnt offset="0" repeat=".."]
[Placeholder tag="name"]
<input type="hidden" name="visibleCategories"
<br>
É utilizado para exibir itens
selecionados na árvore de seleção de
categorias exibidas.
Tabela 58. Rodapé
Código
Detalhes
<input type="submit" value="Set User Categories"></input>
</form>
O rodapé contém o botão Enviar.
213
Elemento de Recuo:
Este exemplo utiliza a tag de elemento de recuo. Ela pode ser utilizada nos elementos de navegador e de
taxonomia. Essa tag representa uma cadeia HTML/texto que deve ser repetida dependendo da
profundidade do nó da árvore que está sendo renderizado nesses elementos.
No exemplo de elemento de taxonomia, o elemento de indentação é usado para renderizar e repetir o ".",
dependendo da profundidade do nó ao qual o design de elemento está sendo aplicado. É possível
deslocar o valor repetido, atribuindo um valor inteiro para o atributo "offset" da marcação. Por exemplo,
uma profundidade do nó atual de 5 e um valor de deslocamento de -2 renderizará a cadeia de repetição
três vezes. Se a soma do deslocamento e a profundidade do nó forem negativas ou 0, a cadeia repetida
não será exibida.
designs e elemento:
A única diferença entre o design de elemento não selecionado e o design de elemento selecionado é que o
campo de entrada da caixa de opções no design de elemento selecionado tem o atributo "checked"
configurado.
Acesso ao usuário:
Se estiver utilizando um elemento de taxonomia, os usuários deverão receber acesso de "Edição" ao seu
próprio item de usuário para permitir que atualizem suas categorias selecionadas.
Utilizando uma URL para atualizar categorias do usuário:
Você pode utilizar uma URL como uma alternativa à utilização de uma árvore de seleção de categorias
para atualizar as categorias selecionadas de um usuário:
http://host:port/wcm/connect/SiteArea/SelectPage?MOD=AJPECatSelect
&redirectURL=/wcm/connect/SiteArea/Content&updateSourceProfile=false
&selectedCategories=categoryID1,categoryID3
&visibleCategories=categoryID1,categoryID2,categoryID3,categoryID4
Os parâmetros "selectedCategories" e "visibleCategories" possuem vários valores que são delimitados por
vírgulas. As categorias especificadas em "selectCategories" devem ser um subconjunto de
"visibleCategories".
Essa URL poderia ser utilizada em uma página na forma de um botão para permitir que os usuários
atualizem as categorias de seus usuários. Por exemplo, você pode criar um botão que inclua a categoria
"Notícias" em uma lista de categorias selecionadas por um usuário.
Utilizando um Elemento de Nome de Usuário
Um elemento de nome de usuário exibe o nome do usuário atual em um modelo de apresentação, design
de componente ou design de elemento. Somente é possível utilizar um elemento de nome de usuário se
criar um componente de nome de usuário. Não é possível incluir um elemento de nome de usuário em
modelos de autoria, áreas de site ou itens de conteúdo.
Para criar um componente de nome de usuário, acesse Aplicativos > Conteúdo > Gerenciamento de
Conteúdo da Web e, em seguida, clique em Novo > Componente > Nome de Usuário.
Utilizando um Elemento de Navegação de Página
Um elemento de navegação de página fornece controles de navegação que são usados para navegar por
um conjunto de resultados gerados por menus, navegadores, personalização e elementos de procura.
214
“Elemento de Navegação de Página”
Elemento de Navegação de Página
Um elemento de navegação de página pode gerar dois tipos de controles de navegação de página:
v Os controles de transferência proporcionam navegação relativa à página atual. Isto inclui vinculação
sequencial para a página de resultados anterior ou seguinte e vinculação rápida para as primeiras e
últimas páginas no conjunto.
v Os controles de paginação proporcionam navegação de acordo com o número de página do conjunto
de resultados. Uma lista de links de número de página é exibida, juntamente com um link de
continuação para acesso ao conjunto de números de página anterior ou seguinte, se não forem exibidos
todos os números de página.
Um elemento de navegação de página pode combinar controles de transferência e de paginação como no
exemplo de Navegação a seguir.
Tabela 59. Exemplo de Layout de Navegação da Página.
Primeiro
<<
Anterior
<
Continuação
...
Números de Página
4,5,6
Continuação
...
Ir para a Página
Vá para a página:
Próximo
>
Último
>>
Tamanho da Página
Itens a serem exibidos: 10 | 50 | Todos
Utilizando o Elemento de Navegação de Página em um Portlet de Renderização Remota
O elemento de navegação de página não funcionará quando renderizado em um portlet de renderização
remota configurado para não receber links de outros portlets. Você deve configurar um portlet de
renderização remota para receber links de "Este portlet" ou "Outros portlets e este portlet" para utilizar
um elemento de navegação de página.
Criando um Elemento de Navegação de Página
Somente é possível utilizar um elemento de navegação de página se criar um componente de navegação
de página. Não é possível incluir um elemento de navegação de página em modelos de autoria, áreas de
site ou itens de conteúdo.
215
“Utilizando um Elemento de Navegação de Página” na página 214
Exemplo de Design de Navegação da Página
Esse é um exemplo de um design de um elemento de navegação de página.
Esse exemplo usa dois elementos de navegação de página para produzir um sistema de navegação de
página como este:
Tabela 60. Exemplos de dois elementos de navegação de página que produzem um sistema de navegação
<<
<
...
Página 5 de 10
(Page 5 of 10).
4,5,6
...
Vá para a
página:
>
>>
Número de
itens a serem
exibidos: 10 |
50 | Todos
Primeiro Elemento de Navegação de Página
1. Crie um componente de navegação de página chamado "firstnavigation".
2. Selecione Transferir (Shuttle) (controles primeiro (first), anterior (previous), próximo (next) e último
(last)) e Paginação (Paging) (numeração de páginas (page numering) e continuation (continuação)).
3. Selecione Limitar Número de Página (Limit number of pages) e digite 3 no campo associado.
4. Digite o seguinte texto nos campos de design de elemento:
Tabela 61. Design do primeiro elemento de navegação de página
Elemento de Design
Código de Design
Cabeçalho
<span>
Footer (Rodapé)
</span>
Separador
| </span><span>
Primeiro controle - design
ativo
<font color="#000000"><<</font>
Primeiro controle - design
inativo
<font color="#999999"><<</font>
Controle anterior - design
ativo
<font color="#000000"><</font>
Controle anterior - design
inativo
<font color="#999999"><</font>
Próximo controle - design
ativo
<font color="#000000">></font>
Próximo controle - design
inativo
<font color="#999999">></font>
Último controle - design
ativo
<font color="#000000">>></font>
Último controle - design
inativo
<font color="#999999">>></font>
Continuação
...
216
Segundo Elemento de Navegação de Página
1. Crie um componente de navegação de página chamado "secondnavigation".
2. Selecione Ir para a Página (caixa de entrada da página) (Jump to page (page input box)) e Tamanho
da Página (seleção de tamanho da página) (Page size (page size selection)).
3. Defina esta configuração na seção Ir para a Página (caixa de entrada da página) (Jump to page (page
input box)):
v Rótulo do campo: Vá para a página:
v Tamanho do campo: 3
4. Defina esta configuração na seção Controle de Tamanho da Página (Page size control):
v Rótulo do campo: Número de itens a serem exibidos:
v Tamanhos da página:
10 | 10
50 | 50
0 | Tudo
5. Digite o seguinte texto nos campos de design de elemento:
Tabela 62. Design do segundo elemento de navegação de página
Elemento de Design
Código de Design
Cabeçalho
<span>
Page [PageInfo value="currentPage" ]
[PageInfo value="unknownPages" knowntext="of" unknowntext="of at least" ]
[PageInfo value="totalPages" ].
</span>
<span>
Footer (Rodapé)
Separador
| </span>
</span><span>
Referenciando os Componentes de Navegação de Página em outro Design de Elemento
Utilize as tags de componente para referenciar os componentes de navegação de página em outro design
de elemento, como um menu:
<div>
[component name="firstnavigation" ]
<br>
[component name="secondnavigation" ]
</div>
Geração de URL Usando Tags PathCmpnt e URLCmpnt
Há algumas considerações especiais a serem lembradas ao usar as tags URLCmpnt e PathCmpnt para criar
URLs para outros itens de conteúdo da Web a partir de seu conteúdo.
Usando a Tag URLCmpnt
A tag do componente da URL URLCmpnt pode ser usada para criar URLs para itens de conteúdo em um
modelo de apresentação. Se o atributo mode="portal" estiver configurado, o item de conteúdo será
exibido através de um portlet do visualizador de conteúdo.
Usando a Tag PathCmpnt
O componente de caminho é usado para criar a parte base de uma URL no conteúdo da Web.
Geralmente, a parte base é estendida por alguma cadeia que identifica o conteúdo a ser exibido. Se o
componente de caminho for usado dentro do contexto de um visualizador de conteúdo da web, a URL
217
gerada terá o formato de URL atualizado e, portanto, não poderá ser exibida com o visualizador de
conteúdo da web tradicional.
Incluindo Parâmetros de URL
A inclusão de parâmetros de URL em uma URL de portal regular não afetará o visualizador de conteúdo
da web. Para este propósito, é necessário usar a tag URLCmpnt ou PathCmpnt. Parâmetros de consulta de
URL adicionais, como aqueles usados com o visualizador de conteúdo da Web tradicional, podem ser
anexados nas URLs geradas por essas tags.
Personalizando Documentos Associados
O Portal Personalization fornece o recurso de documentos federados para recuperar metadados sobre
documentos armazenados em sistemas de gerenciamento de conteúdo externo ou repositórios de
documentos. Exemplos desses sistemas incluem o IBM Lotus Quickr, IBM Content Manager, IBM FileNet
Content Manager e o Microsoft Sharepoint. Você pode usar um componente de personalização no IBM
Web Content Manager para exibir metadados de documentos federados e para criar links para download
ou abrir os documentos.
O recurso de documentos federados pode adquirir metadados de sistemas remotos que suportam os
seguintes métodos:
v Interfaces remotas de Serviços de Documento, conforme suportado pelo Lotus Quickr, IBM Content
Manager e FileNet Content Manager
v Content Management Interoperability Services 1.0 (CMIS 1.0), conforme suportado pelo IBM
Connections, IBM Content Manager, IBM FileNet Content Manager, Microsoft Sharepoint e outros.
v Feeds Atom
Criando uma Regra de Seleção de Documentos Associados
Crie uma regra de seleção que selecione metadados de documentos contidos em uma pasta específica de
um sistema de gerenciamento de conteúdo remoto ou repositório de documentos.
Antes de criar uma regra para acessar informações de documentos federados, verifique se você
configurou o recurso, conforme descrito em “Configurando o Suporte para Documentos Associados” na
página 78.
Abra o Personalization Navigator.
Navegue até a pasta na qual você deseja criar a regra ou crie uma pasta para a nova regra.
Clique em Novo > Regra.
Insira um nome para a regra.
Opcional: Insira uma descrição para a regra para identificar os dados que a regra seleciona.
Clique no link para a ação Selecionar no editor de regras (por exemplo, Conteúdo da Web) e
selecione Documentos Federados.
7. Especifique a pasta no sistema remoto inserindo a URL diretamente ou pesquisando no sistema
remoto. Além de uma pasta em um sistema remoto, é possível inserir a URL de qualquer feed Atom
disponível na rede. Os dados Atom expostos por esses feeds são mapeados para tags
AttributeResource correspondentes no IBM Web Content Manager.
v Para inserir a URL de uma pasta diretamente, conclua estas etapas:
a. Clique em valor *.
b. Insira a URL da pasta.
1.
2.
3.
4.
5.
6.
c. Clique em Submeter.
v Para procurar por um servidor de serviços de documentos ou servidor CMIS, clique no símbolo >
na condição URL de Feed e clique em Selecionar Pasta de Documentos para ativar o assistente
para selecionar uma pasta.
218
Para conectar-se a um servidor remoto, identifique o servidor e o método de autenticação usado
para acessar o servidor. É possível selecionar um servidor predefinido ou inserir a URL do servidor
diretamente. Por padrão, nenhum servidor predefinido está configurado, mas um administrador
pode incluir servidores na lista. Para autenticar-se em um servidor, há diversos métodos
disponíveis:
– Se a conexão única estiver configurada entre o servidor remoto e o portal, será possível
conectar-se com o usuário atual.
– É possível inserir um ID do usuário e uma senha para o servidor remoto.
– É possível selecionar um slot de área segura de credencial associado ao servidor. Os slots de
áreas seguras de credenciais são configurados por um administrador e permitem que os usuários
efetuem login sem credenciais.
Se você utilizar um ID de usuário e senha ou slot de área segura de credencial, o servidor remoto
deverá aceitar solicitações de autenticação que usam autenticação básica HTTP.
Para obter detalhes sobre como os administradores podem incluir servidores e configurar a
autenticação, consulte Configurando o Recurso de Documentos Federados.
Nota: Para procurar por servidores remotos e selecionar uma pasta, a página que contém o Editor
de Personalização exige um tema e perfil de módulo que suporte o módulo de tema
wp_federated_documents_picker. Por exemplo, você pode usar o tema do Portal 8.0 e o perfil
completo ou adiado. Se a página não usar esse módulo de tema, o assistente para selecionar uma
pasta não estará disponível quando você clicar em Selecionar Pasta de Documentos. É possível
ainda inserir manualmente uma URL de feed em uma pasta remota clicando em valor *. Para ativar
o assistente de seleção de pastas, verifique se o módulo do tema wp_federated_documents_picker
está disponível na página que contém o Editor de Personalização.
8. Opcional: Clique em mostrar todos os itens e especifique o número máximo de entradas a serem
recuperadas.
9. Clique em Salvar.
Agora, é possível usar essa regra em um componente de personalização para renderizar o resultado da
seleção dessa regra no conteúdo da Web.
“Portlet de Autoria Reservado” na página 99
“Configurando o Recurso de Documentos Federados” na página 79
A Estrutura do Módulo
Usando uma Norma de Documentos Associados em um Componente de
Personalização
Para acessar as informações a partir de uma norma de documentos associados em seu sistema de
conteúdo da Web, crie um componente de personalização, associe-o à norma e especifique o design para
exibição de informações do documento recuperadas pela norma.
1. Abra o portlet de autoria e clique em Novo > Componente > Personalização.
2. Insira um nome e descrição para o novo componente.
219
3. Clique em Procurar na seção Elemento de Personalização e selecione a regra de seleção de
documentos associados.
4. Defina o design para os cabeçalhos, rodapés e documentos individuais selecionados pela regra de
seleção configurada. Use o elemento AttributeResource para referenciar campos de metadados
individuais dos documentos selecionados.
5. Salve o componente.
Agora, é possível visualizar seu componente e referenciá-lo a partir dos modelos de apresentação, de
outros designs de elementos ou de visualizadores de um conteúdo da Web.
Designs de Amostra para uma Regra de Seleção de Documentos Associados:
Ao renderizar informações de metadados do documento recuperadas com uma regra de seleção de
documentos associados, é possível padronizar os designs do cabeçalho, do rodapé e do resultado da
procura do menu para apresentações simples ou mais elaboradas.
Design da Lista com Marcadores
Para renderizar uma lista com marcadores simples de links para os documentos, é possível usar um
design como o descrito aqui.
Cabeçalho
<ul>
Design do resultado de procura de cada menu (Design for each menu search result)
<li>
<a target="_blank" href="[AttributeResource attributeName="contentLink"]">
[AttributeResource attributeName="title"]
</a>
</li>
Footer (Rodapé)
</ul>
Design da Lista de Tabelas
Para renderizar uma lista completa de informações com uma tabela, é possível usar um design como o
descrito aqui.
Cabeçalho
<table>
<tr>
<th>Title</th>
<th>Authors</th>
<th>Load</th>
<th>Carregar Portal</th>
<th>Carregar via Portal com Autenticação</th><th>Load</th>
<th>Edit</th>
<th>Content Type</th>
<th>Size</th>
<th>Updated</th>
<th>Published</th>
</tr>
Design do resultado de procura de cada menu (Design for each menu search result)
<tr>
<td><b>[AttributeResource attributeName="title"]</b></td>
<td>[AttributeResource attributeName="authors" separator=","]</td>
<td><a target="_blank" href=" [AttributeResource attributeName="rawContentLink"]">download</a></td>
220
<td><a target="_blank"
<td>[AttributeResource
</tr>
href="[AttributeResource attributeName="contentLink"]">download</a></td>
href=" [AttributeResource attributeName="contentLinkAuthenticated"]">download</a></td>
href="[AttributeResource attributeName="viewLink"]">open</a></td>
attributeName="contentType"]</td>
attributeName="size"]</td>
attributeName="updated"]</td>
attributeName="published"]</td>
Footer (Rodapé)
</table>
Valores de AttributeResource para Documentos Associados:
A tag AttributeResource é usada como um marcador para exibir atributos de uma regra de seleção de
documentos associados em um design de elemento de personalização. Ela não pode ser utilizada em um
modelo de apresentação ou outros tipos de elemento.
Quando usado com uma regra de seleção de documentos associados, os valores a seguir para o atributo
attributeName da tag AttributeResource são suportados para cada documento no conjunto de resultados:
authors
Este atributo exibe os nomes dos autores do documento. O resultado real depende do
mapeamento de atributo correspondente que precisa existir no sistema de gerenciamento de
conteúdo remoto. Se nenhum mapeamento desse tipo existir, um valor vazio será exibido.
contentLink
Este atributo exibe a URL absoluta que pode ser usada para fazer download do documento. Ao
contrário do atributo rawContentLink, o atributo contentLink contém a URL que endereça o proxy
Ajax com os parâmetros usados para fazer download do documento por meio do proxy. É
possível desativar URLs de proxy editando a propriedade
wcm.pzn.ecm.enable.proxy.content.links no serviço de configuração WCM WCMConfigService e
configurando o valor como false.
contentLinkAuthenticated
Esse atributo exibe a URL absoluta que pode ser usada para fazer download do documento,
incluindo informações sobre autenticação quando necessárias. Da mesma forma que o atributo
contentLink, o atributo contentLinkAuthenticated contém a URL que endereça o proxy Ajax com
os parâmetros usados para fazer download do documento por meio do proxy. Entretanto,
dependendo da regra de seleção de personalização, o atributo contentLinkAuthenticated pode
também incluir informações sobre uma área segura de credencial compartilhada usada para
autenticar o usuário. As informações sobre autenticação de área segura de credencial só estão
disponíveis se a regra de seleção foi criada usando uma área segura de credencial.
contentType
Este atributo exibe o tipo MIME do documento. Se essas informações não forem fornecidas pelo
sistema de gerenciamento de conteúdo remoto, um valor vazio será exibido.
contributors
Esse atributo exibe os nomes dos contribuidores do documento. O resultado real depende do
mapeamento de atributo correspondente que precisa existir no sistema de gerenciamento de
conteúdo remoto. Se nenhum mapeamento desse tipo existir, um valor vazio será exibido.
id
Este atributo exibe o ID exclusivo do documento.
published
Este atributo indica o ponto no tempo da primeira disponibilidade do documento. O resultado
real depende do mapeamento de atributo correspondente que existe no sistema de gerenciamento
de conteúdo remoto. Se nenhum mapeamento desse tipo existir, um valor vazio será exibido.
rawContentLink
Esse atributo exibe a URL absoluta bruta que pode ser usada para fazer download do documento.
Embora semelhante ao atributo contentLink, o atributo rawContentLink contém a URL conforme
221
ela é exibida no feed de documentos federados usado pela regra de seleção de documentos
federados. Esse valor não inclui nenhum proxy adicional endereçado na URL.
size
Este atributo exibe o tamanho do documento em bytes. Se essas informações não forem
fornecidas pelo sistema de gerenciamento de conteúdo remoto, um valor vazio será exibido.
summary
Esse atributo exibe o resumo do documento. Se essas informações não forem retornadas pelo
sistema de gerenciamento de conteúdo remoto, um valor vazio será exibido.
Nota: Como o valor do atributo de resumo pode conter dados de caractere muito grandes, a
quantidade de dados retornados por esse atributo é limitada. É possível aumentar ou diminuir a
quantidade de dados retornados, configurando a propriedade wcm.pzn.ecm.max.field.length no
serviço de configuração WCM WCMConfigService.
title
Este atributo exibe o título do documento. O resultado real depende do mapeamento de atributo
correspondente que precisa existir no sistema de gerenciamento de conteúdo remoto. Se nenhum
mapeamento desse tipo existir, o nome do arquivo é exibido.
updated
Este atributo indica o ponto no tempo da última atualização no documento fornecido. O
resultado real depende do mapeamento de atributo correspondente que existe no sistema de
gerenciamento de conteúdo remoto. Se nenhum mapeamento desse tipo existir, um valor vazio
será exibido.
viewLink
Este atributo exibe a URL absoluta que pode ser usada para abrir o documento fornecido no
contexto da interface com o usuário de gerenciamento de conteúdo remoto. Se nenhuma URL
desse tipo for retornada pelo sistema de gerenciamento de conteúdo remoto, um valor vazio será
exibido.
Nota: O atributo viewLink não será suportado se você estiver conectado a um repositório do IBM
Content Manager ou estiver usando um servidor CMIS.
A seguir, há um exemplo de como usar estes valores de atributo em um design:
<li>
<a target="_blank" href="[AttributeResource attributeName="contentLink"]">
[AttributeResource attributeName="title"]
</a>
</li>
Inserindo um Link no Conteúdo Remoto
É possível inserir links no conteúdo remoto em elementos contendo um campo rich text usando o botão
Inserir Link no Documento Remoto no editor de rich text. Apenas conteúdo remoto configurado para
acessar servidor remoto pode ser selecionado usando esse botão.
Clique em Inserir Link para Documento Remoto e use os painéis do assistente para selecionar um
documento.
Para conectar-se a um servidor remoto, identifique o servidor e o método de autenticação usado para
acessar o servidor. É possível selecionar um servidor predefinido ou inserir a URL do servidor
diretamente. Por padrão, nenhum servidor predefinido está configurado, mas um administrador pode
incluir servidores na lista. Para autenticar-se em um servidor, há diversos métodos disponíveis:
v Se a conexão única estiver configurada entre o servidor remoto e o portal, será possível conectar-se
com o usuário atual.
v É possível inserir um ID do usuário e uma senha para o servidor remoto.
v É possível selecionar um slot de área segura de credencial associado ao servidor. Os slots de áreas
seguras de credenciais são configurados por um administrador e permitem que os usuários efetuem
login sem credenciais.
222
Se você utilizar um ID de usuário e senha ou slot de área segura de credencial, o servidor remoto deverá
aceitar solicitações de autenticação que usam autenticação básica HTTP.
Se você acessar o servidor remoto com um ID de usuário e senha, um slot de área segura de credencial
temporário será criado para armazenar e gerenciar dados de autenticação. Quando você fecha o
assistente, o slot de área segura de credencial temporário é excluído automaticamente. Entretanto, se você
não fechar o assistente explicitamente, o slot de área segura de credencial temporário não poderá ser
excluído. Por exemplo, essa situação poderá ocorrer se você fechar a janela do navegador antes de
concluir o assistente. Todo slot de área segura de credencial temporário que não for usado por pelo
menos três horas é removido por uma tarefa de limpeza (com.ibm.portal.cmis.TransientSlotCleanupTask)
executada uma vez por dia. Um administrador pode alterar o planejamento da tarefa de limpeza usando
a interface de configuração XML.
Nota sobre Tema: A função Inserir Link para Documento Remoto requer o módulo do tema
wp_federated_documents_picker. A página contendo o portlet de autoria deve usar um tema que integra
esse módulo do tema. Além disso, para garantir que o módulo está carregado, o perfil do módulo que é
usado pela página deve incluir o módulo do tema wp_federated_documents_picker. O perfil adiado
(profiles/profile_deferred.json) e o perfil integral (profiles/profile_full.json) do tema do Portal 8.0
suportam o assistente para inserir links no conteúdo remoto.
Se o módulo do tema wp_federated_documents_picker não puder ser carregado pelo portlet de autoria, o
assistente não estará disponível quando você clicar em Inserir Link para Documento Remoto. Para
acessar o assistente, assegure-se de que o tema e o perfil do módulo aplicados à página do portal
contendo o portlet de autoria incluam o módulo do tema wp_federated_documents_picker. Se o recurso
estiver desativado ao usar a edição sequencial de conteúdo da web, conclua estas etapas:
v Aplique o tema na página de autoria oculta que contém o módulo do tema
wp_federated_documents_picker. Por exemplo, é possível aplicar o tema do Portal 8.0.
v Aplique um perfil do módulo na página de autoria oculta que contém o módulo do tema
wp_federated_documents_picker. Por exemplo, é possível aplicar o perfil integral do tema do Portal
8.0.
v Aplique uma aparência sem decorações na instância do portlet de autoria reservada na página de
autoria oculta. Por exemplo, é possível aplicar a aparência "Portal 8.0 - Sem Aparência".
223
“Portlet de Autoria Reservado” na página 99
“Definindo Opções de Texto Formatado” na página 260
É possível configurar o IBM Web Content Manager para usar o editor Rich Text padrão, um editor Rich
Text avançado ou um editor Rich Text de terceiros em campos Rich Text.
“Configurando o Recurso de Documentos Federados” na página 79
A Estrutura do Módulo
Customizando Páginas
Determinando quais APIs do Lado do Cliente a Página Atual do Portal Fornece
Utilizando Atributos Start e End
Os atributos start e end são utilizados para agrupar os dados retornados por uma tag Web Content
Manager dentro de outras tags, como HTML. Esses atributos não são obrigatórios.
A principal vantagem de usar atributos start e end é que o código digitado nos atributos start e end é
renderizado apenas quando a própria tag de componente é renderizada. Por exemplo, se um usuário não
tiver acesso ao conteúdo exibido usando uma tag de componente, então nem o conteúdo nem os códigos
start e end serão exibidos. Isso também se aplica quando um componente não existe ou não contém
qualquer conteúdo.
Exemplo:
Neste exemplo, os atributos start e end são utilizados para exibir um conjunto de componentes de texto
em uma lista de marcadores. Isso poderia se digitado em um modelo de apresentação.
<ul>
[component
[component
[component
[component
</ul>
name="Component1"
name="Component2"
name="Component3"
name="Component4"
start="<li>"
start="<li>"
start="<li>"
start="<li>"
end="</li>"
end="</li>"
end="</li>"
end="</li>"
]
]
]
]
Os componentes de texto seriam semelhantes a este quando renderizados:
v Componente 1
v Componente 2
v Componente 3
v Componente 4
Se um usuário não tivesse acesso ao componente 3, a lista renderizada seria semelhante a esta:
v Componente 1
v Componente 2
v Componente 4
224
Em contraste, você também poderia incluir esse código em um modelo de apresentação:
<ul>
<li>[component
<li>[component
<li>[component
<li>[component
</ul>
name="Component1"
name="Component2"
name="Component3"
name="Component4"
]</li>
]</li>
]</li>
]</li>
Se um usuário não tivesse acesso ao componente 3, a lista renderizada seria então semelhante a esta:
v Componente 1
v Componente 2
v
v Componente 4
Embora o componente de texto não seja renderizado, o marcador ainda é renderizado.
Configurando Parâmetros para o Formato Datas
Esses parâmetros são utilizados para definir o formato de datas.
Tabela 63. Parâmetros de formatação de data
Símbolo
Significado
Apresentação
Exemplo
G
designador de era
(Texto)
DC
y
ano
(Número)
1996
M
mês no ano
(Texto e Número)
Julho e 07
d
dia no mês
(Número)
10
h
hora em am/pm (1-12)
(Número)
12
H
hora do dia (0-23)
(Número)
0
m
minuto na hora
(Número)
30
s
segundo no minuto
(Número)
55
S
milissegundo
(Número)
978
T
dia na semana
(Texto)
Terça-feira
I
dia no ano
(Número)
189
F
dia da semana no mês
(Número)
2 (2ª qua em julho)
w
semana no ano
(Número)
27
T
semana no mês
(Número)
2
a
marcador de am/pm
(Texto)
PM
k
hora no dia (1-24)
(Número)
24
K
hora em am/pm (0-11)
(Número)
0
z
fuso horário
(Texto)
Horário Padrão do Pacífico
'
escape para texto
(Delimitador)
''
aspa simples
(Literal)
O número de letras determina o formato:
Texto
v Quatro ou mais padrões de letras, utilizar formato completo.
v Menos de quatro, utilizar formato curto ou abreviado, se existir.
225
Exemplo:
v
v
v
v
Dia/Mês/Ano
d,M,a = 3,3,3.
dd,MM,aa = 03,03,03.
dd,MMM,aa = 03,Mar,03.
dd,MMMM,aaaa = 03,Março,2003.
Maiúscula e Minúscula:
v O uso de maiúsculas e minúsculas nas letras utilizadas no código de data e hora não é consistente. Por
exemplo, "M" para mês, mas "d" para dia e "a" para ano.
v Letras maiúsculas e minúsculas podem ter significados diferentes. Por exemplo, "s" para segundo e "S"
para milissegundo.
Formato incorreto:
Se um código de data ou hora for inserido incorretamente, nada será retornado.
Outros caracteres:
Qualquer caractere no padrão que não esteja nos intervalos de ['a'..'z'] e ['A'..'Z'] é tratado como texto
entre aspas. Por exemplo, caracteres como ':', '.', ' ', '#' e '@' aparecerão no texto de hora resultante mesmo
se não estiverem entre aspas simples.
Exemplos Utilizando o Código do Idioma dos Estados Unidos:
Tabela 64. Exemplo
Padrão de Formato
Resultado
"yyyy.MM.dd G 'at'
hh:mm:ss z"
1996.07.10 AD at 15:08:56 PDT
"EEE, MMM d, ''yy"
Wed, July 10, '96
"h:mm a"
12:08 PM
"hh 'o''clock' a, zzzz"
12 o'clock PM, Pacific Standard Time
"K:mm a, z"
0:00 PM, PST
"yyyyy.MMMMM.dd GGG
hh:mm aaa"
1996.July.10 AD 12:08 PM
Nota sobre Como Formatar Números
A Sintaxe de Padrão de Formato de Número do Java é utilizada para configurar o formato dos números.
Tabela 65. Sintaxe do Padrão de Formato de Número Java
Símbolo
Significado.
0
Representa um dígito. Os zeros à direita e à esquerda são mostrados.
#
Representa um dígito. Os zeros à direita e à esquerda não são mostrados.
.
Um marcador para separador decimal.
,
Um marcador para separador de agrupamento.
T
Utilizado para separar uma mantissa e o expoente nos formatos exponenciais.
;
Utilizado para separar formatos.
-
O prefixo negativo padrão.
%
Multiplica o número por 100 e o exibe na forma de por cento.
226
Tabela 65. Sintaxe do Padrão de Formato de Número Java (continuação)
Símbolo
Significado.
?
Multiplica o número por 1000 e o exibe na forma de por mil.
¤
Exibe o número como uma moeda.
'
Utilizado para citar caracteres especiais num prefixo ou sufixo.
Exemplos:
Para o número 123456.789.
Tabela 66. Exemplo
Padrão de Formato
Resultado
###,###.###
123,456.789
###.##
123456.79
00000000.0000
000123456.7890
Tags
Tags são usadas na marcação para referenciar conteúdo armazenado ou gerado por elementos, ou para
exibir metadados de diferentes itens.
Tags de Conteúdo da Web
Use as tags do IBM® Web Content Manager para referenciar elementos nos modelos de apresentação e
nos designs de elementos.
Para criar uma tag de conteúdo da web, clique em Inserir uma Tag em um campo de modelo de
apresentação ou design de elemento. O diálogo Auxiliar de Tag é aberto. Em seguida, selecione e
configure um dos seguintes tipos de tag:
Tag de design alternativo
Você usa uma tag de design alternativo para exibir um componente diferente baseado no item
que está sendo retornado por um menu ou navegador que está no caminho atual ou não.
Tag de recurso de atributo
Use a tag de recurso do atributo para definir as informações retornadas por uma consulta de
procura.
Tag do Componente
A tag Component é utilizada para fazer referência ao conteúdo de um componente dentro de um
gabarito de apresentação ou design de elemento.
Tag de elemento
A tag Elemento (Element) é utilizada para fazer referência a um elemento dentro de um gabarito
de apresentação ou design de elemento.
Tag de indentação
Você pode utilizar uma tag de recuo para formatar designs de elementos que requerem que os
resultados sejam recuados.
Tag de informações de página
Você usa a tag de informações de página para exibir detalhes da navegação de página no design
de um elemento de navegação de página.
Tag do Componente de Caminho
A tag de componente de caminho é usada para representar determinados caminhos da URL,
227
como o caminho do servlet, o caminho base ou o caminho de contexto da página atual. Essa tag
pode ser incluída em modelos de apresentação, designs de elementos e designs de componentes.
Tag do Sinalizador de Substituição
Você usa uma tag de marcador para exibir metadados dentro de um design de elemento ou de
componente.
Tag de plug-in
Os plug-ins renderizados são referidos usando a tag de plug-in.
Tag de propriedade
Uma tag de propriedade é usada para exibir vários campos e metadados de itens de conteúdo e
áreas de site.
Tag de elemento de estilo
A tag de elemento de estilo é usada para fazer referência a um componente de folha de estilo
selecionado como a folha de estilo padrão em um modelo de autoria, ou um componente de
folha de estilo referido em uma área de site ou um item de conteúdo usando uma referência de
componente.
Tag de URL
A tag URLCmpnt é usada para gerar uma URL para uma área de site ou um item de conteúdo.
Recuando Designs de Elemento
Você pode utilizar uma tag de recuo para formatar designs de elementos que requerem que os resultados
sejam recuados.
Este é o formato de uma tag IndentCmpnt:
[indentcmpnt repeat=" " offset=" " start=" " end=" " ]
Para criar uma tag IndentCmpnt:
1. Clique em Inserir uma Tag a partir de um campo de modelo de apresentação ou de design de
elemento. O diálogo Auxiliar de Tag é exibido.
2. Selecione Indentar como o tipo de tag.
3. Selecione o nível de deslocamento. O deslocamento é usado para determinar quantas vezes a cadeia
de repetição é usada para cada indentação. Os deslocamentos usados baseiam-se no número de nós
do conteúdo hierárquico que está sendo exibido. Por exemplo, uma profundidade do nó atual de 5 e
um valor de deslocamento de -2 renderizará a cadeia de repetição três vezes. Se a soma do
deslocamento e a profundidade do nó forem negativas ou 0, a cadeia repetida não será exibida.
4. Clique em OK para incluir a tag em seu design.
Depois de incluir a tag em seu design, você também pode incluir os seguintes parâmetros na tag:
Tabela 67. Parâmetros de tag de alinhamento
Parâmetro de Tag
Descrição
repeat=" "
Digite o texto para repetir no início do recuo.
start=" "
Os atributos start e end são utilizados para agrupar os dados retornados por uma tag
em outras tags, como HTML. Esses atributos não são obrigatórios.
end=" "
Conjuntos de caracteres de byte duplo:
Nem todos os conjuntos de caracteres de byte duplo suportam ASCII estendido. Para usar tags como
" ", você precisa substituir "&" por "&".
Por exemplo:
228
[indentcmpnt offset="0" repeat="&nbsp;&nbsp;"]
Gravando links no conteúdo da Web
Os links nos itens de conteúdo podem ser gravados como URLs.
Vinculando o conteúdo da Web a partir de outro conteúdo da Web
Os exemplos a seguir mostram como gravar links para o conteúdo da web que devem ser usados com o
visualizador de conteúdo da web ou o servlet do Web Content Manager.
Para criar um link de uma parte do conteúdo da Web para outra parte do conteúdo da Web, use o
seguinte formato de URL:
[URLCmpnt mode="current" context="Selected" type="Content"
name="LIBRARY/SITE_AREA_PATH/CONTENT"]
v LIBRARY = o nome da biblioteca de conteúdo da Web.
v SITE_AREA_PATH = o caminho para a área de site em que o conteúdo reside.
v CONTENT = o nome do item de conteúdo.
Vinculando o conteúdo da Web de um portlet externo ou site da Web
Para criar um link a partir de um portlet externo ou Web site da Web que exiba o conteúdo da Web, use
o seguinte formato de URL:
http://HOST/wps/wcm/connect/LIBRARY/SITE_AREA_PATH/CONTENT
v HOST = o nome do host Web Content Manager.
v wps/wcm = a raiz do conteúdo do Web Content Manager.
Vinculando o Conteúdo Exibido em um Visualizador de Conteúdo da Web a Partir
de um Portlet ou Website
Para criar um link de um portlet ou website externo para o conteúdo exibido em um visualizador de
conteúdo da web, use o formato de URL a seguir:
http://PORTAL_HOST/wps/mypoc/vp_mapping?urile=wcm%3Apath%3ALIBRARY/
SITE_AREA_PATH/CONTENT&page=unique_name | object_id | &mapping=mapping |
&current=true | &pagedesign=LIBRARY/PRES_TEMPLATE_NAME
v PORTAL_HOST = o nome do host do Web Content Manager.
v wps/mypoc = a raiz de contexto do Web Content Manager, especificando a parte do serviço de
consulta de conteúdo.
– Para acesso protegido, use wps/mypoc.
– Para acesso não-protegido, use wps/poc.
v vp_mapping = o mapeamento do portal virtual, se adequado. Por exemplo, wps/mypoc/myvp ou
wps/poc/myvp.
Para endereçar uma página de portal específico, use um dos seguintes parâmetros. Os parâmetros não
podem ser combinados.
v page: Especifique o nome exclusivo ou ID de objeto da página.
229
v mapping: Especifique o mapeamento de URL da página.
v current: Indica que a página atual deve ser usada.
Para endereçar um modelo de apresentação específico a ser usado para renderizar o conteúdo da Web,
use um dos seguintes parâmetros:
v pagedesign: Especifique o nome da biblioteca e o modelo de apresentação a ser usado, incluindo os
nomes de todas as pastas
Consulta de Página Dinâmica: O parâmetro page é opcional. É possível usar o recurso de transmissão de
link do visualizador de conteúdo da web para consultar páginas dinamicamente, simplesmente omitindo
o parâmetro page. Por exemplo, se você tiver um item de conteúdo chamado News1, armazenado na
biblioteca Conteúdo da Web, na área de site News, poderá criar um link para esse item de conteúdo com
a seguinte URL:
http://host_name/wps/mypoc?urile=wcm%3Apath%3A/Web+Content/News/News1
Como alternativa, você também pode incluir uma página de portal específica usando um mapeamento de
URL com o seguinte formato:
http://PORTAL_HOST/PORTAL_CONTEXT_ROOT
/PORTAL_PAGE_URL_MAPPING/?current=true&urile=wcm%3Apath%3ALIBRARY/SITE_AREA_PATH/CONTENT
v PORTAL_HOST = o nome do host do portal
v PORTAL_CONTEXT_ROOT = a raiz de contexto do portal. Para sites anônimos, utilize /wps/portal,
caso contrário, utilize /wps/myportal
v PORTAL_PAGE_URL_MAPPING = o nome composto do mapeamento de URL do portal para a página
do portal que contém o portlet do Web Content Manager (os mapeamentos da URL podem ser
configurados usando os portlets de administração do portal).
Nota: O visualizador de conteúdo da web na página de destino deve ser configurado para receber links
de Outros Portlets e este Portlet.
Incluindo Parâmetros de Cache em uma URL
É possível incluir conteúdo da Web do “Parâmetros de Cache” na página 231 e do “Parâmetros de
Expiração de Cache” na página 232 em uma URL para customizar as estratégias de armazenamento em
cache para itens individuais. Por exemplo:
http://HOST/wps/wcm/connect/LIBRARY/SITE_AREA_PATH/CONTENT>?cache=site&contentcache=session
Incluindo um Parâmetro Modificado pela Última Vez em uma URL
É possível incluir a data de última modificação do item de conteúdo atual no cabeçalho da página
renderizada. Exemplo:
http://HOST/wps/wcm/connect/LIBRARY/SITE_AREA_PATH/CONTENT>?returnLastModified=true
Vinculação Contextual
A vinculação contextual é utilizada em sistemas em que o conteúdo de um site é compartilhado entre
vários sites. Ao vincular conteúdo a um site, links integrados (links em HTML e elementos de link) farão
referência ao site no qual está localizado o item de conteúdo original. A vinculação contextual é utilizada
para que, quando o conteúdo for vinculado de outro site, o link seja renderizado em relação ao site atual,
se possível.
230
Link de Caminho Contextual
O link de caminho contextual tentará resolver um link utilizando uma técnica de caminho relativo. O link
de caminho contextual presume que cada estrutura de site na qual está armazenado o conteúdo
vinculado tenha a mesma estrutura de site.
O link de caminho contextual pode ser aplicado a elementos mencionados utilizando a tag de elemento.
Por exemplo:
v [Element type="content" context="current" key="body" link="path" ]
Ela poderá ser utilizada apenas se context=current ou context=autofill.
Quando o link de caminho contextual é utilizado, um link compatível é procurado utilizando o mesmo
caminho relativo. Se nenhum link for localizado, o link original será utilizado.
Utilizando o Cache Customizado
Você pode anular os parâmetros de armazenamento em cache padrão de um site utilizando os
parâmetros "cache" e "expire" nas URLs e nas tags do IBM Web Content Manager.
Nota: O cache customizado pode ser utilizado apenas quando um cache de Conteúdo da Web padrão do
servidor é definido para nenhum cache ou para cache avançado. Se o cache básico for usado como seu
cache de conteúdo da Web padrão, o cache customizado não poderá ser usado.
Há dois métodos básicos nos quais o cache customizado pode ser utilizado com as definições do cache de
servidor padrão:
Cache de Servidor Padrão Ativado
Nesse cenário, alguma forma de cache de servidor padrão foi ativado. Os parâmetros de cache
em tags connect e URLs podem ser utilizados para:
v Desativar o cache para os dados que estiverem sendo solicitados.
v Aplicar parâmetros de cache diferentes para os dados que estão sendo solicitados.
Esse método é utilizado com sites que são na maior parte estáticos, mas que contêm alguns
elementos dinâmicos que requerem uma estratégia de cache diferente da estratégia de cache
padrão do servidor.
Cache de Servidor Padrão Desativado
Nesse cenário, o cache de servidor padrão foi desativado. Os parâmetros de cache em tags
connect e URLs podem ser utilizados para ativar o cache para os dados que estiverem sendo
solicitados.
Esse cenário é utilizado com sites que contêm um grande número de elementos que requerem
estratégias de cache diferentes.
Parâmetros de Cache
Utilize os parâmetros de "cache" nas tags e URLs do IBM Web Content Manager para especificar se os
dados recuperados devem ser armazenados em cache ou não e, caso sim, como deverão ser armazenados
em cache. O parâmetro de "cache" não é obrigatório.
Parâmetros de armazenamento em cache customizados só podem ser usados quando um cache de
conteúdo da Web padrão do servidor estiver configurado como nenhum ou para o armazenamento em
cache avançado. Se o cache básico for usado como cache de conteúdo da Web padrão, o cache
customizado não poderá ser usado. O armazenamento em cache customizado pode ser utilizado para
configurar parâmetros de cache para caches básicos, avançados e de dados. Quando o cache customizado
é utilizado em uma tag connect, o cache se aplica aos dados sendo recuperados pela tag connect. Quando
o cache customizado é utilizado em um pedido de URL, o cache se aplica a toda a página sendo
solicitada.
231
Tabela 68. Valores para o Parâmetro de CACHE
Cache Básico
Cache Avançado
Cache de Dados
CACHE=SITE
CACHE=SESSION
CACHE=NONE
CONTENTCACHE=SITE
CONNECTORCACHE=SITE
CONTENTCACHE=SESSION
CONNECTORCACHE=SESSION
CONTENTCACHE=USER
CONNECTORCACHE=NONE
CONTENTCACHE=SECURED
CONTENTCACHE=PERSONALIZED
CONTENTCACHE=NONE
Exemplos:
<CONNECT MOD=Web SRV=HTML ACTION=http://www.ibm.com CACHE=SITE >
http://host:port/wps/wcm/connect/library/sitearea/content?cache=site&contentcache=session
Estratégias de Cache Customizado
v Ao aplicar o cache customizado ao conteúdo estático, você utilizará principalmente CACHE=SITE,
CACHE=SESSION ou CONTENTCACHE=USER.
v Quando os Grupos do Usuário são utilizados na implementação de segurança do site, você pode
utilizar a estratégia de cache personalizado SECURED: CONTENTCACHE=SECURED.
v Quando as Categorias e/ou Palavras-chaves, junto com os Grupos de Usuários, são utilizadas para
personalização do site, você pode utilizar a estratégia de cache personalizado PERSONALIZED:
CONTENTCACHE=PERSONALIZED.
v Se o Cache padrão de conteúdo da Web do servidor estiver definido como Avançado, você deverá usar
CONTENTCACHE=NONE para desativar o armazenamento em cache.
v Se você estiver recuperando dados externos, deverá utilizar CONNECTORCACHE=NONE para
desativar o armazenamento em cache.
Parâmetro CacheKey
O parâmetro CacheKey é usado ao armazenar em cache o conteúdo através do cache básico. Um
parâmetro CacheKey é utilizado como uma chave em vez de um URL. Isso será útil se você tiver vários
URLs para a mesma página, mas desejar que ela seja armazenada em cache apenas uma vez. Isso reduz a
quantidade de memória utilizada pelo cache.
Exemplo:
As seguintes URLs podem usar a mesma página da Web chamada news.html.
<CONNECT MOD=Web SRV=HTML ACTION=http://www.ibm.com/news.html
CACHE=SITE CACHEKEY=news >
<CONNECT MOD=Web SRV=HTML ACTION=http://www.ibm.com.au/news.html
<CONNECT MOD=Web SRV=HTML ACTION=http://www.lotus.com/news.html
Nesse exemplo, "news" é usado como o CacheKey para armazenar o valor da resposta dessas tags de
conexão. Isso significa que news.html é armazenado em cache somente uma vez em vez de três vezes
separadas.
Parâmetros de Expiração de Cache
obrigatório.
232
Parâmetros de expiração de cache customizados só podem ser usados quando um cache de conteúdo da
Web padrão do servidor estiver configurado como nenhum ou para o armazenamento em cache
avançado. Se o cache básico for utilizado como o cache padrão de conteúdo da Web, a expiração
customizada não poderá ser utilizada. Mesmo que você não possa utilizar a expiração customizada com o
cache básico ativado, ainda poderá utilizar a expiração customizada (ao utilizar o cache avançado) para
expirar dados no cache básico.
Os valores do parâmetro expires podem representar um período relativo ou uma data e hora absolutas:
Cache Básico
v EXPIRES="ABS {data e hora}"
v EXPIRES="REL {inteiro}{unidades}"
Cache Avançado
v CONTENTCACHEEXPIRES="ABS {data e hora}"
v CONTENTCACHEEXPIRES="REL {inteiro}{unidades}"
Cache de Dados
v CONNECTORCACHEEXPIRES="ABS {data e hora}"
v CONNECTORCACHEEXPIRES="REL {inteiro}{unidades}"
Exemplos:
<CONNECT MOD=Web SRV=HTML ACTION=http://www.ibm.com CACHE=SITE
EXPIRES="REL 9000s">
http://host:port/wps/wcm/connect/library/sitearea/content?cache=site&expires="REL 9000s"
Estratégias de Expiração Customizada
v CONNECTORCACHEEXPIRY= deve ser utilizado ao definir os parâmetros de expiração customizada
durante a recuperação de dados externos que utilizam uma tag connect ou pedido de URL.
v Se o cache padrão for básico ou se você especificar CACHE= em uma tag connect ou em um pedido de
URL, deverá utilizar EXPIRES=
v Se o cache padrão for avançado ou se você especificar CONTENTCACHE= em uma tag connect ou em
um pedido de URL, deverá utilizar CONTENTCACHEEXPIRES=
v Se o cache padrão for nenhum e apenas CACHE= ou CONTENTCACHE= for especificado em uma tag
de conexão ou um pedido de URL, a propriedade
connect.connector.httpconnector.defaultcacheexpires no serviço WCM WCMConfigService será usada
para expirar os dados.
Especificando uma Hora Absoluta
Uma data absoluta especifica a data e a hora em que o documento expira.
Para indicar uma hora, utilize o seguinte formato:
v ABS {data e hora}
Por exemplo:
v ABS Mon, 29 May 2000 03:04:18 GMT
Uma solicitação para esse documento após esse horário exato fará com que o documento seja esvaziado
do cache e uma nova cópia seja recuperada.
Ao especificar uma data de expiração absoluta, a data deverá ser prefixada por ABS, e a data especificada
deverá estar em um dos seguintes formatos:
v Mon, 06 Nov 2000 09:00:00 GMT
233
v Monday, 06-Nov-00 09:00:00 GMT
v Mon Nov 6 09:00:00 2000.
v 6 Nov 2000 9:00 AM.
Os três primeiros formatos de data são os utilizados na especificação HTTP padrão, enquanto o último é
um formato de data simples e curto para conveniência.
Ao utilizar horas e datas absolutas para expirar dados, os itens armazenados em cache permanecerão em
cache até que expirem. Depois de expirado, o item original será recuperado no próximo pedido e uma
cópia será colocada no cache, porém como a hora ou a data absoluta já expirou, o item será expirado
imediatamente. Essencialmente, depois de expirado, um item não será novamente armazenado de modo
permanente no cache ao utilizar horas e datas absolutas. Todos os valores de hora absoluta estão em
GMT.
Especificando um Período Relativo
Em vez de especificar uma hora absoluta, uma hora relativa poderá ser utilizada para especificar se o
documento expirará algum tempo depois que o documento for colocado no cache, por exemplo em
algumas horas ou alguns dias. A hora real em que o documento expira é calculada a partir da hora em
que o documento é recuperado e adicionado ao cache.
Em vez de especificar uma hora fixa para a expiração de dados armazenados em cache, a expiração
poderá ser especificada em relação à hora em que os dados foram incluídos no cache, por exemplo,
algumas horas ou alguns dias.
Para indicar uma hora relativa, utilize o seguinte formato:
v REL {número inteiro}{unidades}
Nota: O espaço após REL é necessário.
O inteiro especifica um número inteiro de unidades de hora. Números decimais não são suportados. As
unidades são especificadas utilizando um único caractere que não coincide maiúsculas e minúsculas:
v S: Segundos
v H: Horas
v D: Dias
v M: Meses
Tabela 69. Exemplos de Formatação
Em uma Tag de Conexão
Em um Pedido de URL
v EXPIRES="REL 2M"
v EXPIRES=REL 2M
v EXPIRES="REL 9000s"
v EXPIRES=REL 9000s
O primeiro exemplo indica uma expiração em dois meses. O segundo indica 9.000 segundos (2h30).
Por design, apenas segundos, horas, dias ou meses podem ser especificados. Minutos não são suportados
para simplificar a interface (M é utilizado para meses). Em vez disso, pode ser utilizado um valor
múltiplo em segundos (por exemplo, 300 segundos para 5 minutos).
234
Armazenando em Cache Elementos do IBM Web Content Manager
Você pode aplicar o armazenamento em cache para elementos usando tags de "conexão" para fazer
referência a elementos dentro de modelos de apresentação em vez de tags de componente ou elemento.
Importante:
v Consulte “Ativando Tags Connect” na página 103 para obter informações sobre como ativar as tags de
conexão.
v Tags de Conexão do Processo devem ser selecionadas em um formulário de modelo de apresentação
para que as tags de conexão sejam processadas.
Exemplo: Aplicando Armazenamento em Cache Customizado
Este é um exemplo do tipo de tag que pode ser usado para armazenar em cache elementos individuais
dentro de um modelo de apresentação.
<connect
SRV="cmpnt" PATH="/Library/SiteArea/Content"
SOURCE="library" CMPNTNAME="TestNav" CONTENTCACHE="site" EXPIRES="REL 9000s">
</connect>
Tabela 70. Detalhes da Tag de Conexão
Parâmetro
Detalhes
SRV="cmpnt"
O Serviço para esse Módulo é "cmpnt".
PATH="/libraryname/
SiteArea/Content"
Define o contexto do elemento.
Os marcadores "sitepath" e "name" podem ser usados no lugar de "PATH=" ao
armazenar em cache menus ou navegadores:
[placeholder tag="sitepath"]/[placeholder tag="name"]
SOURCE="library"
A origem é "content", "sitearea" ou "library". Neste exemplo ela é "library" porque o
elementos que estamos armazenando em cache vem de um componente.
CMPNTNAME="TestNav"
Este é o nome do elemento que será armazenado em cache.
CONTENTCACHE="site"
Esse é "site" ou "session".
EXPIRES="REL 9000s"
O horário no qual o componente expirará do cache é configurado aqui.
Na primeira vez que o modelo de apresentação for renderizado, o elemento será incluído no cache. Na
próxima vez que o modelo for renderizado, o elemento será exibido a partir do cache em vez de ser
renderizado novamente pelo aplicativo Web Content Manager. O elemento não será renderizado
novamente pelo aplicativo Web Content Manager até que expire do cache. Por este motivo, somente
elementos que não exigem nova renderização sempre que uma página é acessada devem ser
armazenados em cache.
Se você está armazenando em cache um componente usado em mais de um modelo de apresentação,
recomenda-se salvar a tag de conexão como um componente HTML e depois fazer referência a esse
componente em cada modelo de apresentação. Se você precisar então alterar as tags de componente
armazenadas em cache, precisará apenas alterá-la no componente HTML e não em vários modelos de
apresentação.
Se você tiver um conjunto de componentes armazenados em cache que usa a mesma configuração de
"expiração", recomenda-se salvar o parâmetro "Expires=" como um componente HTML e depois fazer
referência a esse componente em cada tag de conexão usada para armazenar componentes em cache. Se
235
você precisar então alterar o parâmetro "Expires=", precisará apenas alterá-lo no componente HTML e não
em várias tags de conexão. Isso também se aplica a qualquer tag de cache comum.
Exemplo: Desativando o Armazenamento em Cache
Você também pode usar este método para desativar o armazenamento em cache. Neste exemplo, a
propriedade CONTENTCACHE=NONE é usada para desativar o armazenamento em cache desse
elemento.
<connect
SRV="cmpnt" PATH="/SiteArea/Content"
SOURCE="library" CMPNTNAME="TestNav" CONTENTCACHE="none" >
</connect>
Renderizando Plug-ins Fornecidos com o Web Content Manager
O IBM Web Content Manager fornece diversos plug-ins de renderização que você pode usar para
aprimorar conteúdo da web.
Plug-in de Ação Remota
Use o plug-in RemoteAction para referenciar ações remotas de conteúdo da web. As ações remotas
permitem a você acionar ações que normalmente são executadas com o portlet de autoria, como criar e
editar itens e gerar visualizações.
É possível referenciar ações remotas usando tags de plug-in com o seguinte formato:
[plugin:RemoteAction action=" " docid=" "
useCurrentSelection=" " dialog=" " useCurrentContext=" "]
action=
Este atributo é a ação remota a ser executada.
docid=
Este atributo é o ID do documento do item com relação ao qual executar a ação remota.
useCurrentContext=
Se configurado como true, o ID do documento é obtido do contexto de renderização, em vez do
atributo docid.
dialog=
Se esse atributo for configurado como true, quando renderizado em um visualizador de conteúdo
da web, a ação remota é renderizada como um URL. A URL redireciona o usuário para uma
página de portal oculta usada pelo visualizador para edição sequencial.
Este exemplo demonstra uma ação "new" para criar um item de conteúdo:
[plugin:RemoteAction action="new" type="com.ibm.workplace.wcm.api.WCM_Content" pid="com.ibm.workplace.wcm.api.WCM_SiteArea/ID2" atid="com.aptrix.pluto.presentation.template/ID
Para obter detalhes sobre as ações remotas que você pode acessar com tags de plug-in, consulte Usando
Ações Remotas.
“Utilizando Ações Remotas” na página 608
Ações remotas são usadas para acionar ações a partir do aplicativo IBM Web Content Manager.
Plug-in de Dados de Analítica de Site
Use o plug-in de renderização AnalyticsData para introduzir microformatos para Active Site Analytics no
conteúdo da web.
Os microformatos reúnem informações sobre os itens de conteúdo que são renderizados nas páginas do
portal. É possível inserir mais de uma tag no conteúdo.
236
Inclua a tag de plug-in AnalyticsData no design de modelo de conteúdo ou apresentação. Cada tag pode
conter apenas um atributo. Use a seguinte sintaxe:
[Plugin:AnalyticsData property="" | element="" | value= ""
css-class = ""]
Para selecionar um valor que seja usado no microformato para Active Site Analytics, use um dos
seguintes atributos:
property
Use esse atributo para selecionar uma das propriedades suportadas do item de conteúdo da web.
Esse atributo pode ter os seguintes valores:
id
O identificador exclusivo do conteúdo.
title
O título de exibição do conteúdo.
path
O caminho exclusivo do conteúdo na biblioteca.
lastmodified
A data de quando o conteúdo foi modificado pela última vez.
authors
O autor ou autores do conteúdo. Se o conteúdo tiver mais de um autor, uma tag de
microformato será gravada para cada autor.
element
Use esse atributo para selecionar um elemento do conteúdo. O elemento deve ser um texto ou
um tipo de elemento de texto curto. Para o valor desse atributo, especifique o nome do elemento
que você deseja selecionar.
value
Use esse atributo para passar um valor de texto ao plug-in. Se você configurar esse atributo,
deverá também configurar o valor da classe CSS usando o atributo css-class. Consulte a
seguinte descrição desse atributo para obter detalhes.
Nota: Em uma única referência a uma tag, só é possível usar um dos atributos anteriores. Para usar mais
de um atributo, inclua outra referência na tag.
css-class
Use esse atributo para controlar qual classe CSS é usada para as tags de microformato. Esse
atributo é obrigatório quando você especifica o atributo value. O atributo é opcional quando você
usa o atributo property ou element. Se você não especificar esse atributo com o atributo property
ou element, a classe CSS será determinada do valor do atributo property ou element. Nesse caso,
a classe CSS será gerada ao prefixar asa.wcm.content_item. e o valor do atributo property ou
element.
Exemplos
[Plugin:AnalyticsData property="title"]
Essa configuração seleciona o título de exibição do item de conteúdo. O seguinte microformato é
inserido na página:
<span style="display:none" class="asa.wcm.content_item.title">Título de exibição</span>
[Plugin:AnalyticsData property="authors" css-class="com.acme.content.authors"]
Essa configuração seleciona os autores do item de conteúdo. Se você usar essa configuração e
uma classe CSS customizada, os seguintes microformatos serão inseridos na página:
<span style="display:none" class="com.acme.content.authors">Autor 1</span>
<span style="display:none" class="com.acme.content.authors">Autor 2</span>
[Plugin:AnalyticsData element="element1"]
Essa configuração seleciona o valor do texto do elemento no item de conteúdo. O seguinte
microformato é inserido na página:
<span style="display:none" class="asa.wcm.content_item.element1">Valor do elemento com o elemento de nome 1</span>
237
[Plugin:AnalyticsData element="element1" css-class="asa.wcm.content_item.path"]
Essa configuração seleciona o valor do texto do elemento no item de conteúdo. O seguinte
<span style="display:none" class="asa.wcm.content_item.path">Valor do elemento com o elemento de nome 1</span>
[Plugin:AnalyticsData value="Some text" css-class="asa.wcm.content_item.title"]
Essa configuração usa o texto especificado pelo atributo value. O seguinte microformato é
inserido na página:
<span style="display:none" class="asa.wcm.content_item.title">Um texto</span>
[Plugin:AnalyticsData css-class="asa.wcm.content_item.title" value="[Property context='current'
type='content' field='title']"]
Essa configuração passa o valor da tag [Property] aninhada para o plug-in. O seguinte
<span style="display:none" class="asa.wcm.content_item.title">Título de exibição da tag de propriedade aninhada</span>
[Plugin:AnalyticsData css-class="asa.tag.SitePromotion" value="Halloween2012"]
Essa configuração cria uma tag de promoção do site com o valor que é passado para o plug-in. O
seguinte microformato é inserido na página:
<span style="display:none" class="asa.tag.SitePromotion">Halloween2012</span>
Plug-in de Caminho do Site
Use o plug-in SitePath para renderizar o caminho do site do conteúdo atual.
É possível referenciar o caminho do site com o seguinte formato:
[plugin:SitePath type="rel | abs"]
Esse plug-in utiliza o seguinte atributo:
type = rel | abs
Esse atributo define se o caminho é relativo ou não à biblioteca atual. Se você omite esse atributo,
o valor assume o padrão de rel e usa o caminho relativo. O valor abs indica um caminho
absoluto para o conteúdo renderizado.
Exemplos:
v Caminho absoluto:
[plugin:SitePath type="abs"]
v Caminho relativo:
[plugin:SitePath]
Identificando e Classificando Plug-ins para Conteúdo da Web
Da mesma forma que é possível identificar e classificar recursos do portal como páginas e portlets,
também é possível identificar e classificar itens de conteúdo gerados com o IBM Web Content Manager e
exibidos com o visualizador de conteúdo da web. Dois componentes de plug-in estão disponíveis para
suportar a identificação e a classificação de itens de conteúdo em seu sistema de conteúdo da Web. É
possível incluir os componentes [Plugin:tags] e [Plugin:ratings] em um modelo de apresentação para
integrar com rapidez os widgets de identificação e classificação no item de conteúdo atual.
“Gerenciando a Identificação e a Classificação no Conteúdo da Web” na página 119
Ao usar a identificação e a classificação com o conteúdo da web, o visualizador de conteúdo da web
fornece opções de escopo adicionais para a filtragem de resultados de identificação e classificação. Como
as alterações no sistema de conteúdo da Web podem afetar a precisão das informações de identificação e
classificação usadas pelo portal, é importante manter as informações de escopo atualizadas sincronizando
os escopos regularmente.
Incluindo um Widget de Identificação no Conteúdo da Web:
238
É possível incluir um widget de identificação em um item de conteúdo incluindo um componente
[Plugin:tags] em seu modelo de apresentação. Por padrão, o componente de plug-in é renderizado
usando o design TaggingWidgetDesign, que está incluído na biblioteca de conteúdo da Web Web Resources
v70, ou é possível seu próprio design.
Nota: Ao usar tag e classificação com o conteúdo da Web, assegure-se de que a sincronização dos
escopos de tag e classificação tenha sido configurada para o portal.
Para incluir um widget de identificação em um item de conteúdo, inclua o plug-in de identificação em
seu modelo de apresentação.
Exemplo:
<div id="tags">[Plugin:tags]</div>
O plug-in de identificação suporta os seguintes parâmetros especificados em um formato key=value:
design=path
O parâmetro design indica qual design usar ao renderizar o widget de identificação. Especifique
as informações de path usando o caminho completo da biblioteca para o componente HTML que
contém o modelo de design do widget de identificação. Exemplo:
[Plugin:tags design="Web Content/folder/myTaggingDesign"]
Se o parâmetro design não for especificado, um design padrão será definido no componente
TaggingWidgetDesign, que é fornecido com a biblioteca Web Resources v70 library incluída no
produto. Durante a renderização, o sistema verifica os seguintes locais com relação ao design
padrão:
1. A biblioteca de conteúdo da Web atual
2. A biblioteca de conteúdo da Web Web Resources v70
actionScope=scope
O parâmetro actionScope indica o escopo das tags que você deseja exibir nesse widget. Para
obter uma lista dos valores possíveis, consulte a descrição do parâmetro tagScope usado com o
widget de tag sequencial. Exemplo:
[Plugin:tags actionScope="personal_private"]
Nota de classe de folha de estilo: O modelo de apresentação que inclui o widget deve assegurar que a
classe de folha de estilo lotusui30 seja designada à marcação que contém o widget. É possível especificar
essa classe de folha de estilo das maneiras a seguir:
v No modelo de apresentação, coloque o widget dentro de um elemento <div> que referencie a classe.
Por exemplo, <div class="lotusui30"> ... </div>.
v Crie um design para o widget que especifique a classe e referencie o design a partir da tag Plugin com
o parâmetro design.
“Sincronizando Escopos para o Conteúdo da Web” na página 120
necessário.
Incluindo um Widget de Classificação no Conteúdo da Web:
239
É possível incluir um widget de classificação em um item de conteúdo incluindo um componente
[Plugin:ratings] em seu modelo de apresentação. Por padrão, o componente de plug-in é renderizado
usando o design RatingWidgetDesign, que está incluído na biblioteca de conteúdo da Web Web Resources
v70, ou você pode criar seu próprio design.
Nota: Ao usar tag e classificação com o conteúdo da Web, assegure-se de que a sincronização dos
escopos de tag e classificação tenha sido configurada para o portal.
Para incluir um widget de classificação a um item de conteúdo, inclua o plug-in de classificação em seu
Exemplo:
<div id="ratings">[Plugin:ratings]</div>
O plug-in de classificação suporta os seguintes parâmetros especificados em um formato key=value:
design=path
O parâmetro design indica qual design usar ao renderizar o widget de classificação. Especifique
as informações de path usando o caminho completo da biblioteca para o componente HTML que
contém o modelo de design do widget de classificação. Exemplo:
[Plugin:ratings design="Web Content/folder/myRatingDesign"]
Se o parâmetro design não for especificado, um design padrão será definido no componente
RatingWidgetDesign, que é fornecido com a biblioteca Web Resources v70 incluída no produto.
Durante a renderização, o sistema verifica os seguintes locais com relação ao design padrão:
1. A biblioteca de conteúdo da Web atual
2. A biblioteca de conteúdo da Web Web Resources v70
actionScope=scope
O parâmetro actionScope indica o escopo das tags que você deseja exibir nesse widget. Para
obter uma lista dos valores possíveis, consulte a descrição do parâmetro ratingScope usado com
o widget de tag sequencial. Exemplo:
[Plugin:tags actionScope="community"]
Nota de classe de folha de estilo: O modelo de apresentação que inclui o widget deve assegurar que a
classe de folha de estilo lotusui30 seja designada à marcação que contém o widget. É possível especificar
essa classe de folha de estilo das maneiras a seguir:
v No modelo de apresentação, coloque o widget dentro de um elemento <div> que referencie a classe.
Por exemplo, <div class="lotusui30"> ... </div>.
v Crie um design para o widget que especifique a classe e referencie o design a partir da tag Plugin com
o parâmetro design.
240
“Sincronizando Escopos para o Conteúdo da Web” na página 120
necessário.
Plug-ins de Utilitário
Estão disponíveis plug-ins de utilitário para dar a você maior controle sobre como é inserida marcação no
conteúdo da web. Por exemplo, é possível usar comparações para determinar condicionalmente quando
inserir marcação ou incluir comentários que possam ser visualizados apenas por autores de conteúdo.
Plug-in de Comentário
Use o plug-in de Comentário para inserir comentários que só autores de conteúdo possam visualizar.
Todo texto escrito entre as tags de início e finalização do plug-in é tratado como comentário. Esse texto
não é processado, mas omitido quando o conteúdo da web é renderizado. Exemplo:
[Plugin:Comment] Isto é um comentário [/Plugin:Comment]
Plug-in Equals
Use o plug-in Equals para inserir marcação no conteúdo da web apenas se os valores de dois atributos de
texto corresponderem. O plug-in fornece os dois atributos text1 e text2. Toda marcação entre as tags de
início e finalização é renderizada como parte do conteúdo da web apenas se os valores desses dois
atributos corresponderem.
A amostra a seguir só renderizará a marcação entre as tags de início e finalização do plug-in se o
conteúdo renderizado estiver atualmente em um estágio de fluxo de trabalho chamado Revisão.
[Plugin:Equals text1="Revisão" text2="[Property type=’content’
context=’current’ field=’currentstage’]"]
Documento em revisão.
[/Plugin:Equals]
Plug-in NotEquals
Use o plug-in NotEquals para inserir marcação no conteúdo da web apenas se os valores de dois
atributos de texto não corresponderem. O plug-in fornece os dois atributos text1 e text2. Toda marcação
entre as tags de início e finalização é renderizada com o conteúdo da web apenas se os valores desses
dois atributos não corresponderem.
A amostra a seguir renderiza a marcação entre as tags de início e finalização apenas se o elemento type
do conteúdo renderizado não tiver o valor Interno:
[Plugin:NotEquals text1="Interno" text2="[Element type=’content’
context=’current’ key=’type’]"]
Documento público
[/Plugin:NotEquals]
241
Plug-in Locale
Use o plug-in Locale para incluir informações de localidade em seu conteúdo da web ou para inserir
marcação em seu conteúdo da web dependendo do código de idioma atual. Esse plug-in determina o
código de idioma suportado preferencial no contexto atual.
O plug-in Locale usa os atributos a seguir:
acceptLanguage
Permite definir um ou mais códigos de idioma preferenciais que podem ser selecionados pelo
portal em um contexto específico. Os valores de atributos devem estar em conformidade com a
especificação de sintaxe do campo de cabeçalho Accept-Language do protocolo HTTP/1.1. Para
obter detalhes sobre esse campo de cabeçalho, consulte a seção Accept-Language da Especificação
RFC2616.
Se o atributo acceptLanguage não for definido, o portal considerará todos os códigos de idioma
suportados disponíveis como igualmente aceitáveis ao determinar o código de idioma suportado
preferencial para o contexto selecionado.
pattern
Permite definir o formato de saída para o código de idioma que é impresso pelo plug-in Locale.
Os valores de atributos especificam um padrão que pode incluir os marcadores a seguir:
v {language}: Marcador para o código de idioma de duas letras minúsculas de um código de
idioma, conforme definido pelo padrão ISO-639.
v {country}: Marcador para o código do país de duas letras maiúsculas de um código de idioma,
conforme definido pelo padrão ISO-3166.
v {variant}: Marcador para a variante específica do fornecedor ou específica do navegador de
um código de idioma.
Se o atributo pattern não for definido, o padrão a seguir será usado: {language}-{country}{variant}.
printLocale
Permite definir se o código de idioma suportado preferencial, determinado pelo plug-in Locale, é
inserido em seu conteúdo da web. O atributo pode ter os valores a seguir:
v true: O código de idioma suportado preferencial é gravado na marcação da página.
v false: O código de idioma suportado preferencial não é gravado na marcação da página.
Combinando este atributo com o atributo acceptLanguage, os usuários podem definir o conteúdo
a ser renderizado apenas nas circunstâncias a seguir:
v Se um código de idioma específico for aplicável ao contexto atual
v Se um código de idioma de um conjunto específico de códigos de idioma for aplicável ao
contexto atual
Embora o corpo da tag Plugin seja impresso se um código de idioma aceitável for suportado, o
código de idioma suportado preferencial não é exibido quando esse atributo é configurado como
false.
Se o atributo printLocale não for definido, um valor true será usado.
Se o plug-in Locale especificar o conteúdo do corpo, a marcação entre as tags de início e finalização será
renderizada apenas se o código de idioma suportado preferencial for determinado. Se nenhum código de
idioma suportado se aplicar ao contexto atual, o plug-in Locale não inserirá marcação no conteúdo.
Exemplos:
242
v Ao incluir o plug-in Locale em seu conteúdo da web sem definir atributos adicionais, o código de
idioma suportado preferencial no contexto atual é inserido em seu conteúdo da web. O formato padrão
{language}-{country}-{variant} é usado (por exemplo, es-ES-WIN):
[Plugin:Locale]
v O atributo pattern permite definir o formato de saída do código de idioma suportado preferencial. A
amostra a seguir renderiza o código de idioma usando um formato customizado e omite o elemento
variante (por exemplo, es_ES):
[Plugin:Locale pattern="{language}_{country}"]
v A amostra a seguir renderiza o código de idioma do código de idioma suportado preferencial no
contexto atual (por exemplo, da). Apenas idiomas de países nórdicos são aceitos como um resultado. Se
nenhum dos códigos de idioma especificados for suportado no contexto atual, nada será impresso em
seu conteúdo da web. Por exemplo, se o usuário configurar o navegador da web ou o perfil do usuário
do portal para usar apenas o idioma inglês (en), o plug-in Locale não retornará nenhum código de
idioma.
[Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2"
pattern="{language}"]
v É possível evitar que o código de idioma suportado preferencial seja renderizado com o atributo
printLocale. Esta amostra insere o corpo da tag Plugin no conteúdo da web apenas se o código de
idioma suportado preferencial corresponder a um dos idiomas nórdicos especificados. O código de
idioma determinado não é incluído no conteúdo da web.
[Plugin:Locale acceptLanguage="da,fo;q=0.8,fi;q=0.6,is;q=0.4,no;q=0.2,sv;q=0.2"
printLocale="false"]
<div>Esta marcação será exibida apenas se o contexto atual suportar um código de idioma
que represente um dos idiomas nórdicos especificados.</div>
[/Plugin:Locale]
v Também é possível combinar o plug-in Locale com outros plug-ins. O exemplo a seguir mostra como é
possível usar o plug-in Matches com o plug-in Locale. A marcação no corpo do plug-in Matches é
renderizada em seu conteúdo apenas se o código de idioma suportado preferencial representar um
idioma espanhol.
Plugin:Matches pattern="es(.*)" text="[Plugin:Locale]"]
<div>Esta marcação aparecerá apenas se o código de idioma suportado preferencial no
contexto atual representar um idioma espanhol. Nem o código do país
nem a variante são importantes contanto que o código de idioma
seja "es".</div>
[/Plugin:Matches]
Plug-in Matches
Use o plug-in Matches para inserir condicionalmente marcação no conteúdo da web avaliando uma
expressão regular com relação a um valor de texto passado. O plug-in fornece dois atributos: text e
pattern. Toda marcação entre as tags de início e finalização do plug-in será renderizada apenas se o valor
do atributo text corresponder à expressão regular no atributo pattern.
É possível também ter correspondência de padrões negativa. Neste caso, a marcação do corpo da tag de
plug-in só será renderizada se o texto não corresponder à expressão regular. Para usar correspondência
de padrões negativa, configure o atributo negative-match como true.
Nota: O dialeto da expressão regular usado pelo plug-in é definido pela classe de linguagem Java
java.util.regex.Pattern.
Exemplos:
v A amostra a seguir só renderizará a marcação entre as tags de início e finalização se o conteúdo
renderizado estiver atualmente em um estágio do fluxo de trabalho cujo nome contenha a palavra
Review.
243
[Plugin:Matches text="[Property type=’content’ context=’current’
field=’currentstage’]" pattern=".*Review.*"]
Documento em revisão
[/Plugin:Matches]
Para que a distinção de maiúsculas e minúsculas do caractere da correspondência seja ignorada, prefixe
a sequência de controle (?i) na expressão regular. A amostra a seguir também corresponde nomes de
estágio de fluxo de trabalho, como review:
field=’currentstage’]" pattern="(?i).*review.*"]
Documento em revisão
[/Plugin:Matches]
v A amostra a seguir só renderizará a marcação entre as tags de início e finalização se o conteúdo
renderizado estiver atualmente em um estágio do fluxo de trabalho cujo nome não contenha a palavra
Review:
field=’currentstage’]" negative-match="true" pattern=".*Review.*"]
Documento não em revisão
[/Plugin:Matches]
v É possível também usar grupos de captura para expressões regulares. Para acessar o valor de um
grupo, use o plug-in MatchedGroup. Só é possível usar esse plug-in entre as tags de início e finalização
do plug-in Matches. Ele fornece o atributo group para recuperar um grupo de captura por seu índice.
Por exemplo, para acessar a primeira palavra em uma lista de palavras separadas por vírgula, use o
plug-in da seguinte forma:
[Plugin:Matches pattern="(.*)(,)(.*)" text="key1,key2"]
Primeira chave é: [Plugin:MatchedGroup group="1"]
[/Plugin:Matches]
Plug-in ThemeCapability
Use o plug-in ThemeCapability para recuperar a lista de recursos de tema disponíveis da página que está
atualmente renderizada. Esses recursos são descritos em Artefatos Básicos e sua Relação. O plug-in retorna
os recursos, sem ordem específica, como uma sequência de pares nome-valor que são separados por
vírgulas.
Este é um exemplo de sequência que é retornada quando a tag [Plugin:ThemeCapability] é renderizada
em uma página que usa o tema de perfil integral:
{analytics_aggregator=8.0, portal.livetext.hcard=8.0, widget_container=2.1,
active_site_analytics=8.0, portal.livetext.action=8.0,
open_ajax_hub=2.0, dojo=1.7, mashups.enabler=3.0.0.1,
content_mapping.picker=8.0, cp_tagging_rating=8.0, oneUI=3.0.1,
portal.livetext.adr=8.0, mashups.builder=3.0.0.1,
federated_documents.picker=8.0, portal.livetext.c2a=8.0}
É possível usar o plug-in Matches para verificar a disponibilidade de recursos de tema específicos e, em
seguida, incluir dinamicamente a marcação no conteúdo renderizado. A amostra a seguir incluirá uma
sequência (... O Dojo está disponível ...) na marcação apenas se o recurso de tema do dojo estiver
disponível no contexto de renderização atual:
[Plugin:Matches text="[Plugin:ThemeCapability]" pattern=".*dojo=.*"]
... O Dojo está disponível ...
[/Plugin:Matches]
Plug-in ToolbarState
Use o plug-in ToolbarState para recuperar o estado da barra de ferramentas do site que é fornecido com o
tema do Portal 8.0. O plug-in renderiza as sequências a seguir para indicar o estado atual da barra de
ferramentas:
244
open
Indica que a barra de ferramentas é expandida como resultado da página estar no modo de
edição.
closed Indica que a barra de ferramentas é reduzida como resultado da página estar no modo de
visualização.
unknown
Indica que nenhum modo de página está selecionado. Este estado pode ocorrer, por exemplo,
diretamente após o login.
Por exemplo:
[Plugin:ToolbarState]
É possível usar o plug-in Equals para verificar o estado atual da barra de ferramentas e, em seguida,
incluir dinamicamente a marcação no conteúdo renderizado. A amostra a seguir incluirá um componente
(web content templates/edit) na marcação apenas se a barra de ferramentas do site estiver expandida no
momento:
[Plugin:Equals text1="open" text2="[Plugin:ToolbarState]"]
[Component name="web content templates/edit"]
[/Plugin:Equals]
Cabeçalho Accept-Language na Especificação RFC2616
Controle de Acesso
É possível restringir o acesso para usuários e grupos selecionados às visualizações em um portlet de
autoria, aos itens gerenciados pelo portlet de autoria e aos elementos e páginas exibidos em um Web site.
Como os Níveis de Acesso e de Segurança São Configurados
Há três níveis de controles de acesso para o conteúdo da Web
Biblioteca:
O acesso em nível de biblioteca determina o acesso à biblioteca como um todo. Se concedido,
fornece um ponto de entrada para a biblioteca. Um usuário precisa de pelo menos acesso de
contribuidor para uma biblioteca para ter acesso a ela no Portlet de Autoria.
Tipo de item por biblioteca:
Os controles de acesso de Tipo de Item definem as visualizações e tarefas de um tipo de item que
um usuário pode acessar no portlet de autoria para uma biblioteca específica. As permissões
definidas para tipos de item em uma biblioteca não concedem automaticamente o acesso a itens
individuais. Elas apenas concedem acesso a tarefas e visualizações específicas dentro do portlet
de autoria.
Nível de item:
Os controles de acesso em nível de item definem as ações que um usuário pode desempenhar em
um item individual. Por exemplo, um tipo de Gerenciador para os Componentes tem acesso às
ações Limpar e Desbloquear mas, se esse usuário também não tiver acesso de Gerenciador para
um componente individual, as ações Limpar e Desbloquear não serão ativadas quando esse
componente for selecionado.
Usuários, Grupos e Funções
seu sistema.
245
Funções de Gerenciamento de Conteúdo da Web
Você define o acesso de um usuário ou grupo para uma biblioteca para determinar quem possui acesso a
uma biblioteca e para definir o acesso para as diferentes visualizações no portlet de autoria.
Tabela 71. Funções
Funções
Direitos de acesso ao portlet de autoria e de renderização
v User
Os usuários e grupos designados para essa função podem:
v visualizar itens em um Web site ou um portlet de renderização ao qual eles
receberam designação de pelo menos acesso de usuário.
Dica: A maneira mais simples de designar usuários para essa função é selecionar
qualquer um dos grupos de usuários padrão, como "Todos os Usuários do Portal
Autenticados" ou "Usuário do Portal Anônimo". Os usuários ainda precisarão de
acesso de "usuário" para um item antes que seja renderizado em um Web site ou um
portlet de renderização.
v Contribuidor
Os usuários e grupos designados para essa função podem:
v visualizar itens em um portlet de renderização ou um Web site renderização por
servlet ao qual eles receberam designação de pelo menos acesso de usuário.
v visualizar bibliotecas para as quais eles designaram acesso de contribuidor em um
portlet de autoria.
v acessar a visualização "Meus Itens" e "Todos os Itens" no portlet de autoria para as
bibliotecas para as quais eles designaram acesso de contribuidor.
v
v Editor
acessar o tipo de item no portlet de autoria para tipos de itens ao qual eles
receberam designação de pelo menos acesso de usuário.
portlet de autoria.
v acessar as visualizações "Meus Itens" e "Todos os Itens" em um portlet de autoria
para bibliotecas às quais eles receberam designação de pelo menos acesso de
contribuidor.
v
para os tipos de itens da biblioteca aos quais o usuário e grupos receberam
designação de pelo menos acesso de editor, os editores podem acessar as seguintes
ações no portlet de autoria:
– acessar a visualização do tipo de item
– criar um novo item
– incluir/remover links
– aplicar modelo de autoria
– copiar
– excluir
– editar
– vincular para
– mover
– restaurar uma versão
– editar rótulos da versão
246
Tabela 71. Funções (continuação)
Funções
Direitos de acesso ao portlet de autoria e de renderização
v Gerente
Usuários e grupos designados a essas funções podem:
portlet de autoria.
contribuidor.
v
para os tipos de item da biblioteca para a qual designaram acesso de gerente, os
gerentes podem acessar todas as ações disponíveis aos editores, e também as
seguintes ações no portlet de autoria:
– editar configurações de acesso
– próximo estágio
– limpeza
– desbloqueio
– editar perfil do usuário
v Administrator
Usuários e grupos designados a essas funções podem:
portlet de autoria.
contribuidor.
v todas as ações no portlet de autoria para tipos de item de biblioteca para os quais
eles designaram acesso de administrador.
v Administrador de
Segurança
Essas funções não tem acesso aos itens do Web Content Manager.
v Delegante
v Usuário Privilegiado
Administradores do WebSphere Portal:
Os Administradores do WebSphere Portal possuem acesso de Administrador automaticamente a todos os
tipos de itens.
Metodologia Aditiva e Subtrativa:
Você pode designar funções a uma biblioteca inteira e aos tipos de itens de uma biblioteca utilizando
uma metodologia aditiva ou subtrativa.
Por exemplo, com uma metodologia aditiva, você aplica à biblioteca inteira o grupo "Todos os Usuários
do Portal Autenticados" para a função "Contribuidor". Isto concederá o acesso "Todos os Usuários do
Portal Autenticados" à biblioteca e a quaisquer portlets de autoria configurados para utilizar a biblioteca.
Em seguida, aplica as funções de Editor, Gerenciador ou Administrador aos tipos de recurso específicos
para conceder acesso adicional para usuários ou grupos especificados.
247
Com uma metodologia subtrativa, você aplica a função Gerente ou Administrador a um usuário ou
grupo para a biblioteca inteira. Você pode então aplicar as funções de Editor, Contribuidor ou Usuário a
tipos de item específicos e desmarcar a caixa de opção de herança. Isso reduz o acesso a tipos de item
diferentes para usuários ou grupos especificados.
É recomendável que a propagação da biblioteca de conteúdo da Web seja ativada porque isso simplificará
a administração do acesso à biblioteca e porque a desativação da propagação resultará em erros
relacionados ao acesso.
Visualização Todos os Itens:
Um usuário ao qual foi designado acesso a um item sempre pode visualizar esse item na visualização
Todos os Itens, independentemente de terem acesso à visualização de tipo de item relacionada. Por
exemplo, se um usuário não tiver acesso à visualização do modelo de apresentação, mas tiver acesso de
editor a um modelo de apresentação, ele ainda poderá visualizar, mas não editar, o modelo de
apresentação na visualização Todos os itens.
Designando Funções para Usuários Anônimos ou Autenticados
Ao acessar um Web site, os usuários fazem login como usuários anônimos ou usuários do portal
autenticado.
Os grupos predefinidos a seguir podem ter funções designadas em uma biblioteca.
Tabela 72. grupos predefinidos
Group
Detalhes
Usuário do Portal Anônimo Selecione esse usuário para designar uma função a usuários anônimos.
Todos os Usuários
Autenticados no Portal
Selecione esse grupo para designar uma função aos usuários que efetuaram logon no
servidor.
Usuários e Grupos de
Usuários
Selecione esse grupo para atribuir uma função a todos os usuários e grupos.
Todos os Grupos de
Usuários do Portal
Selecione esse grupo para designar uma função a todos os grupos.
Funções e Acesso do Usuário
Diferentes usuários terão diferentes acessos a itens e funções no sistema, dependendo da função a eles
designada. As funções podem ser designadas no nível de biblioteca, e também designadas em itens
individuais.
Designando o Acesso a Itens
Existem dois métodos utilizados para designar funções a controles de acesso em itens:
v Selecionar usuários ou grupos diretamente na seção de acesso de um item.
v Permitir que funções designadas sejam herdadas de itens pai até, e incluindo, a biblioteca. As funções
de acesso são herdadas nas seguintes hierarquias:
– Biblioteca/área de site/item de conteúdo
– Biblioteca/taxonomia/categoria
– Biblioteca/pasta/componente
–
–
–
–
248
Biblioteca/pasta/modelo de autoria
Biblioteca/pasta/modelo de apresentação
Biblioteca/fluxo de trabalho
Biblioteca/estágio do fluxo de trabalho
– Biblioteca/ação do fluxo de trabalho
É possível parar a herança em qualquer ponto de uma hierarquia de heranças. Por exemplo, você
poderia permitir herança para uma área do site, mas designar funções de acesso manualmente para
cada item de conteúdo sob essa área do site.
A herança de uma biblioteca baseia-se na função designada à biblioteca geral, não na função designada
a tipos de itens específicos. Por exemplo, é possível não ter acesso à visualização do modelo de
apresentação em uma biblioteca, mas se herdar a função de editor para um modelo de apresentação,
poderá visualizar e editar esse modelo de apresentação da visualização Todos os Itens (All Items).
A herança não se aplica a itens de rascunho.
Nota: Por padrão, a herança é ativada para todas as funções e itens.
Visualizando Definições de Segurança de um Item
As seções a seguir são exibidas na seção segurança de cada item.
Tabela 73. Definições de segurança
Seção
Detalhes
Definido pelo Usuário
Se o item não estiver participando de um fluxo de trabalho, o usuário poderá editar o
acesso em definido pelo usuário.
Fluxo de Trabalho
(Workflow)
Se um item estiver participando de um fluxo de trabalho, a opção definido pelo
usuário não aparecerá e as definições do fluxo de trabalho serão exibidas. Isso não
pode ser editado. O acesso definido pelo fluxo de trabalho é definido em estágios do
fluxo de trabalho.
Itens publicados e segurança do item definida pelo fluxo de trabalho:
v Se você conceder um acesso de editor de usuário a um item em um estágio do
fluxo de trabalho que utiliza uma ação de publicação, os usuários conseguirão
editar o item publicado diretamente. Nenhum rascunho é criado. Isso também é
verdade para segurança definida pelo administrador quando aplicada a itens
publicados.
v Se você conceder um acesso de gerente de usuário a um item em um estágio do
fluxo de trabalho que utiliza uma ação de publicação, os usuários conseguirão
editar e excluir o item publicado diretamente. Nenhum rascunho é criado. Isso
também é verdade para segurança definida pelo administrador quando aplicada a
itens publicados.
v Se você conceder a um usuário acesso de aprovação para um item em um estágio
do fluxo de trabalho que utilize uma ação de publicação, esse usuário poderá criar
rascunhos do item publicado.
Definido pelo
Administrador
Os administradores podem editar o acesso do usuário a um item a qualquer
momento, alterando as configurações definidas pelo administrador.
Herança
É possível também optar por herdar o acesso designado na biblioteca de conteúdo da
Web atual ou a partir do pai de um item. A herança para todas as funções do usuário
é ativada por padrão.
Como a Segurança é Configurada
Quando um novo item é criado, o criador recebe automaticamente acesso de gerenciador para o item.
Segurança adicional para usuário e grupo poderá ser incluída nas configurações definidas pelo usuário e
definidas pelo sistema.
Se um item estiver participando de um fluxo de trabalho, o criador receberá acesso de gerenciador para o
item apenas no primeiro estágio do fluxo de trabalho. Conforme o item progride em um fluxo de
trabalho, a segurança do item é determinada pelo fluxo de trabalho combinado com a segurança definida
pelo sistema.
249
Tabela 74. Matriz de segurança
Nível de Segurança
Nenhum Fluxo de
Trabalho
1º Estágio do Fluxo de
Trabalho
Estágios Adicionais do
Fluxo de Trabalho
Usuário
v Definido pelo Usuário
v Definido pelo
administrador
v Definido pelo
administrador
v Fluxo de trabalho
definido
v Fluxo de trabalho
definido
v Definido pelo
administrador
v Definido pelo
administrador
v Definido ou herdado
pelo fluxo de trabalho
v Definido pelo
administrador
v Definido pelo
administrador
v Definido pelo
administrador
v Definido pelo
administrador
v Definido pelo
administrador
v Herdada
Colaborador
v Definido pelo
administrador
v Herdada
Editor
v Definido pelo
administrador
v Herdada
Manager
v Definido pelo
administrador
v Herdada
Aprovar
Não se aplica.
Administrator
Se você tiver designado a
função de administrador a
uma biblioteca, poderá
herdar automaticamente
todo o acesso de
administração abaixo no
nível do item. Isso não
pode ser desativado.
todo o acesso de
todo o acesso de
Excluindo Itens:
Quando um novo item é criado, o criador também pode excluir o item. Se um item estiver participando
de um fluxo de trabalho, o criador poderá excluir somente o item no primeiro estágio do fluxo de
trabalho.
Designando Acesso a Diferentes Tipos de Usuários ou Grupos
Ao acessar um Web site ou um portlet de renderização, os usuários efetuam login como usuários
anônimos ou usuários do portal autenticado.
Os usuários e grupos a seguir podem ser utilizados para conceder acesso aos itens.
Tabela 75. Usuários e Grupos
Usuário ou Grupo
Detalhes
usuário do portal anônimo
Selecione esse usuário para conceder acesso aos usuários anônimos
[todos os usuários]
Selecione esse grupo para conceder acesso a todos os usuários, aos anônimos e aos
autenticados.
[todos os usuários
autenticados do portal]
Selecione esse grupo para conceder acesso a todos os usuários autenticados.
250
Tabela 75. Usuários e Grupos (continuação)
Usuário ou Grupo
Detalhes
[todos os grupos de
usuários do portal]
Selecione esse grupo para conceder acesso a todos os grupos de usuários.
[criador]
Selecione essa opção para conceder acesso ao criador do item.
[autores]
Selecione essa opção para conceder acesso a usuários que foram selecionados como
um "autor" do item.
[proprietários]
Selecione essa opção para conceder acesso a usuários que foram selecionados como
um "proprietário" do item.
O Acesso Necessário para Visualizar um Item Renderizado
Para visualizar um item em uma página renderizada, é necessário o seguinte:
1. Você precisa de pelo menos acesso de usuário ao modelo de apresentação utilizado para exibir o item
de conteúdo atual.
2. Você precisa de pelo menos acesso de usuário a cada item no caminho para o item de conteúdo atual:
v biblioteca/área de site/item de conteúdo
3. Você precisa de pelo menos acesso de usuário a cada item no caminho para todos os elementos ou
componentes referidos no modelo de apresentação:
v biblioteca/pasta/componente
v biblioteca/elemento
v biblioteca/área de site/elemento
v biblioteca/área de site/item de conteúdo/elemento
Esses caminhos não precisam ser iguais ao caminho para o item de conteúdo atual.
4. Deve haver um mapa de modelos válido.
A configuração "wcm.path.traversal.security":
O comportamento do item renderizado variará, dependendo do modo de especificação da propriedade
wcm.path.traversal.security no serviço WCM WCMConfigService. Se a propriedade não for especificada, o
valor-padrão será false.
Se configurada como false:
v Os menus exibirão conteúdo independentemente de um usuário ter acesso a todas as áreas de site no
caminho do conteúdo.
v Os navegadores não exibirão áreas de site às quais um usuário não tenha acesso, mas poderão mostrar
conteúdo nessas áreas em circunstâncias específicas, como em navegadores de trilhas de navegação.
v As URLs são verificadas apenas em relação a acesso de conteúdo, não a acesso de área de site.
Se configurada como true:
v Os menus e os navegadores não exibirão conteúdo em áreas de site seguras se o usuário não tiver
acesso a todas as áreas de site no caminho do conteúdo.
v O acesso direto ao conteúdo em áreas de site seguras usando uma URL falhará se o usuário não tiver
acesso a todas as áreas de site no caminho de conteúdo.
O desempenho da renderização será menor se configurada como true.
251
Acesso ao Botão
Você designa o acesso no nível do item, designando aos usuários e grupos diferentes funções para cada
item. A função designada determina a quais ações um usuário tem acesso para cada item. A tabela a
seguir descreve o acesso mínimo necessário para acesso a cada botão da interface com o usuário. Se você
tiver ativado a herança no nível de biblioteca, o nível de acesso da biblioteca será herdado por acesso em
nível de item, por padrão. Por exemplo, fornecer a um editor de usuário acesso a uma biblioteca será
aplicado automaticamente a novos itens criados se a herança estiver ativada.
Tabela 76. Controles de Acesso a Item
Acesso mínimo ao
item
Acesso mínimo à
função aos recursos
da biblioteca
Acesso mínimo à
biblioteca
Incluir ou Mover
Filhos
Acesso de
contribuidor ou
superior.
Acesso de editor ou
superior ao tipo de
recurso da biblioteca.
Acesso de
contribuidor ou
superior.
Incluir ou Remover
Links Filhos
Acesso de
contribuidor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Incluir ou Remover
Fluxos de Trabalho
Acesso de
gerenciador ou
superior.
Acesso de
Quando criado pela
contribuidor ou
primeira vez, é
superior.
necessário acesso de
gerenciador ao
recurso da biblioteca
em qualquer
biblioteca. Depois de
salvo, será necessário
acesso de gerenciador
ao recurso do item e
da biblioteca na
biblioteca em que o
item está
armazenado.
Aplicar modelo de
autoria
Acesso de
contribuidor ou
superior.
Acesso de editor ou
superior ao recurso
da biblioteca do
modelo de autoria.
Acesso de
contribuidor ou
superior.
Aprovar
Aprovador ou
administrador.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Aprovar Projeto
Aprovador.
Não obrigatório.
Acesso de
contribuidor ou
superior.
Controles de Acesso
de Edição em Lote
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Cancelar Rascunho
Acesso de
gerenciador ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Copiar
Acesso de
contribuidor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Ações
252
Status do item
Tabela 76. Controles de Acesso a Item (continuação)
Ações
Acesso mínimo ao
item
Acesso mínimo à
da biblioteca
Acesso mínimo à
biblioteca
Status do item
Apenas itens
publicados ou
expirados.
Criar Rascunho
Acesso de
Acesso de editor ou
gerenciador ou
superior ao tipo de
superior, ou acesso de recurso da biblioteca.
aprovador.
Acesso de
contribuidor ou
superior.
Excluir
Acesso de
gerenciador ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Editar
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Vincular a
Acesso de editor ou
Acesso de
contribuidor ou
superior ao tipo de
superior ou acesso de recurso da biblioteca.
aprovador.
Acesso de
contribuidor ou
superior.
Gerenciar Elementos
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Mover
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Próximo Estágio
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Visualizar Item e
Visualizar Item
Renderizado
Acesso de usuário ou Não obrigatório.
aprovador.
Acesso de
contribuidor ou
superior.
Processar Agora
Acesso de
Administrador
Não obrigatório.
Acesso de
contribuidor ou
superior.
Limpar
Acesso de
gerenciador ou
superior.
Não obrigatório.
Acesso de
gerenciador ou
superior.
Ler
aprovador.
Acesso de
contribuidor ou
superior.
Referência
aprovador.
Acesso de
contribuidor ou
superior.
Rejeitar
Acesso de aprovador
ou administrador.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Rejeitar Projeto
Aprovador.
Não obrigatório.
Acesso de
contribuidor ou
superior.
Reiniciar Fluxo de
Trabalho
Acesso de
Acesso de editor ou
gerenciador ou
superior ao tipo de
superior, ou acesso de recurso da biblioteca.
aprovador.
Acesso de
contribuidor ou
superior.
Apenas itens
publicados ou
expirados.
253
Tabela 76. Controles de Acesso a Item (continuação)
Acesso mínimo ao
item
Ações
Acesso mínimo à
da biblioteca
Acesso mínimo à
biblioteca
Restaurar
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Salvar Versão
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Mostrar Campos
Ocultos
Acesso de
Administrador
Não obrigatório.
Acesso de
contribuidor ou
superior.
Submeter para
revisão (Fluxos de
Trabalho)
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Submeter para
revisão (Projetos)
Acesso de editor ou
superior.
Acesso de editor ou
superior ao tipo de
Acesso de
contribuidor ou
superior.
Segurança do
Sistema
Acesso de
Administrador
Não obrigatório.
Acesso de
contribuidor ou
superior.
Desbloquear
Acesso de
gerenciador ou
superior.
Não obrigatório.
Acesso de
gerenciador ou
superior.
Visualizar
Referências
aprovador.
Acesso de
contribuidor ou
superior.
Visualizar Versões
aprovador.
Acesso de
contribuidor ou
superior.
Retirar aprovação
Aprovador.
Acesso de
contribuidor ou
superior.
Não obrigatório.
Status do item
Apenas quando um
projeto está em um
estado ativo.
Apenas quando um
projeto está no estado
de revisão.
Apenas quando a
Aprovação em
Conjunto está
selecionada.
Retirar da revisão
Aprovador.
Não obrigatório.
Acesso de
contribuidor ou
superior.
Apenas quando um
projeto está no estado
de revisão.
Criando Novos Itens:
A capacidade para criar novos itens é configurada no nível da biblioteca, não no nível do item. É
necessário ter pelo menos acesso de contribuidor a uma biblioteca e acesso de editor a um tipo de item
para criar um novo item. Se você tiver acesso a qualquer tipo de item, poderá também criar pastas e
projetos.
Acesso a Botões em Itens de Conteúdo:
254
É possível escolher para ocultar os botões selecionados nos formulários de item de conteúdo ao criar um
modelo de autoria. Isso significa que um usuário pode não ter acesso a todos os botões em um
formulário de item de conteúdo, independentemente de sua função. Os administradores podem optar por
exibir botões ocultos, se necessário.
Traçando Perfil Versus Segurança:
Utilizar o traçado de perfis para personalizar um site é diferente de utilizar a segurança para limitar
quais itens um usuário pode acessar. Em um perfil baseado em site personalizado, embora um usuário
possa não ser capaz de acessar todas as páginas através de menus personalizados, ele ainda pode acessar
outras páginas utilizando navegadores ou procurando conteúdo. Em um site seguro, um usuário pode
visualizar somente os itens para os quais seu acesso foi concedido.
Interface de Autoria
A função principal de um sistema de autoria de conteúdo da Web é permitir que os criadores de
conteúdo criem conteúdo na forma de itens de conteúdo. Há vários recursos que você pode usar para
customizar a interface com o usuário do Web Content Manager para simplificar o processo de criação de
conteúdo para criadores de conteúdo.
Páginas de Portal Customizadas para Autoria
Você não precisa usar a página do Web Content Manager padrão para criar o conteúdo. É possível criar
uma nova página de portal para agir como a página inicial de seu sistema de autoria.
É possível criar subpáginas separadas em uma página inicial de autoria. Exemplo:
v inclua um portlet de autoria em uma subpágina
v inclua portlets do visualizador de conteúdo da Web em outras subpáginas para permitir que você
visualize rapidamente partes do seu Web site
Também é possível criar páginas especificamente para diferentes tipos de usuários. Por exemplo, é
possível criar uma página separada para os designers de site e criadores de conteúdo. Os portlets de
autoria incluídos em cada página podem ser configurados especificamente para cada tipo de usuário.
Criando Novas Páginas
Ao criar novas páginas que contêm um portlet de autoria, inclua o parâmetro de metadados a seguir nas
configurações avançadas nas propriedades da página:
v Parâmetro: resourceaggregation.profile
v Valor: profiles/profile_full.json
Exemplo de autoria de página inicial
Neste exemplo, há dois grupos de usuários; designers de site e criadores de conteúdo. O Web site é
dividido entre uma biblioteca de design e uma biblioteca de conteúdo.
Para criar um ambiente de autoria compartilhado para os dois conjuntos de usuários, você criaria uma
página inicial pai com subpáginas separadas para cada grupo, além de uma subpágina de terceiro que
será usada para visualizar o site:
255
Tabela 77. Exemplo de autoria de subpáginas
Página de designers de site
Página de criadores de conteúdo
Cabeçalho
v Inclui um portlet de autoria
configurado para usar as
bibliotecas de design e de
conteúdo
v Inclui um portlet de autoria
configurado para usar apenas a
biblioteca de conteúdo
v Inclui um portlet de visualizador
de conteúdo da Web usado para
visualizar o Web site
v Apenas os criadores de conteúdo
podem acessar essa página
v Os designers de site e os criadores
de conteúdo podem acessar essa
página
v Apenas os designers de site podem
acessar essa página
organização.
Estratégias de Acesso ao Sistema de Autoria
As funções que você designa a cada biblioteca em seu sistema de autoria determinarão quais
visualizações e recursos em um portlet de autoria estão acessíveis para seus usuários.
Você deve conceder a cada usuário ou grupo acesso apenas a funções e tipos de itens para corresponder
ao tipo de trabalho que eles executarão. Por exemplo:
v Somente designar aos designers de website o acesso de editor aos modelos de autoria e de
apresentação, já que eles não precisam criar novos modelos de autoria.
v Designar aos designers de website e aos autores de conteúdo o acesso de editor aos componentes, se
ambos precisarem criar componentes.
v Os aprovadores de conteúdo receberão somente acesso de contribuidor ao conteúdo, já que não são
obrigados a criar novos itens de conteúdo, mas precisam de acesso do aprovador para itens de
conteúdo durante um fluxo de trabalho.
Customização do Portlet de Autoria
É possível editar as configurações compartilhadas de cada portlet de autoria em seu sistema de autoria
para customizar cada portlet de autoria para as pessoas que os usam.
Por exemplo:
v Selecione apenas as bibliotecas que serão usadas por seus usuários. Por exemplo, se você estiver
configurando um portlet de autoria a ser usado apenas pelos criadores de conteúdo, selecione apenas
as bibliotecas usadas para armazenar itens de conteúdo.
v Edite as opções de visualização para melhor adequar seus usuários e o tipo de Web site que eles estão
criando. É possível optar pela visualização de páginas em um Web site padrão, uma visualização do
conteúdo da Web local no mesmo servidor do portlet de autoria ou um portlet de visualizador de
conteúdo da Web remoto em um servidor diferente.
v Customize a aparência e a impressão do portlet de autoria definindo várias configurações da interface
com o usuário. Você pode usar essas configurações para alterar algumas das configurações padrão de
um portlet de autoria ou selecionar uma página de ativação customizada para usar no lugar da
interface com o usuário padrão.
v Selecione um editor de rich text apropriado para seus usuários.
256
“Configurações do Portlet de Autoria”
Um portlet de autoria é usado para criar e gerenciar conteúdo da Web. É possível editar as configurações
de um portlet de autoria de dentro da seção Preferências do portlet de autoria.
Configurações do Portlet de Autoria
Um portlet de autoria é usado para criar e gerenciar conteúdo da Web. É possível editar as configurações
de um portlet de autoria de dentro da seção Preferências do portlet de autoria.
Use o modo Configurar para especificar configurações para todos os usuários de todas as instâncias do
portlet de autoria, independentemente da página na qual a instância do portlet aparece.
Use o modo Configurações Compartilhadas para especificar configurações para a instância atual de um
portlet de autoria.
Selecionando Bibliotecas de Conteúdo da Web:
Você seleciona quais bibliotecas estarão disponíveis aos usuários ao usar esse portlet de autoria na seção
Seleção de Bibliotecas.
1. Selecione Mostrar Bibliotecas Selecionadas para selecionar as bibliotecas que deseja tornar visíveis no
portlet de autoria.
a. Para incluir uma biblioteca, selecione uma biblioteca na lista de bibliotecas disponíveis e clique em
Incluir.
b. Para remover uma biblioteca, selecione uma biblioteca na lista de bibliotecas selecionadas e clique
em Remover.
c. Utilize os botões de seta para alterar a ordem das bibliotecas selecionadas. Isso determina a ordem
em que as bibliotecas aparecem no portlet de autoria.
2. Selecione Mostrar novas bibliotecas no explorador de bibliotecas se desejar que todas as bibliotecas
recém-criadas sejam mostradas automaticamente no explorador de bibliotecas.
3. Ou então, para tornar todas as bibliotecas visíveis no portlet de autoria, selecione Mostrar Todas as
Bibliotecas. É possível selecionar bibliotecas individuais para serem ocultas no portlet de autoria.
a. Para ocultar uma biblioteca, selecione-a na lista de bibliotecas disponíveis e clique em Incluir.
b. Para remover uma biblioteca da lista, selecione uma biblioteca na lista de bibliotecas selecionadas
e clique em Remover.
Definindo ou editando as configurações compartilhadas de um portlet de autoria:
As bibliotecas selecionadas usando a visualização "configurar" estão disponíveis para todas as instâncias
do portlet de autoria, independentemente da página na qual o portlet aparece. As bibliotecas selecionadas
com a visualização "editar configurações compartilhadas" estão disponíveis apenas para a instância atual
de um portlet de autoria.
As bibliotecas disponíveis nos diálogos "inserir links" e "inserir imagens" são baseadas nas bibliotecas
selecionadas na visualização "configurar". Se você selecionar uma biblioteca na visualização "editar
configurações compartilhadas" que não esteja selecionada na visualização "configurar", não poderá
selecionar itens dessa biblioteca ao usar os diálogos "inserir links" e "inserir imagens".
É possível selecionar bibliotecas especificamente para os diálogos "inserir links" e "inserir imagens",
fazendo o seguinte:
1.
2.
3.
4.
Vá para Administração > WebSphere Portal > Interface do Usuário do Portal > Gerenciar Páginas >.
Procure a página com o nome exclusivo com.ibm.wps.hiddenpage.wcm.Authoring_Portlet.
Edite o layout da página.
Edite as configurações compartilhadas do portlet de Autoria de Conteúdo da Web.
257
5. Selecione as bibliotecas requeridas e clique em OK.
6. Clique em Concluído.
Bibliotecas Organizadas e Importadas:
Se você organizar ou importar uma biblioteca, ela não será automaticamente incluída na lista de
bibliotecas configuradas para um portlet de autoria no servidor de destino. Será necessário incluir a
biblioteca organizada ou importada em cada portlet de autoria em cada servidor.
As bibliotecas Site do Portal e Conteúdo da Web:
Quando o portlet de autoria é acessado pela primeira vez, a biblioteca Site do Portal e a biblioteca
Conteúdo da Web são exibidas por padrão. Quando você editar pela primeira vez a lista de itens
selecionados, o Site do Portal não será mais exibido a menos que especificamente selecionado. A
biblioteca Conteúdo da Web continuará sendo exibida até que seja removida da lista de bibliotecas
selecionadas.
Definindo Opções de Visualização:
As opções de visualização determinam como o conteúdo pode ser visualizado. As opções de visualização
são definidas na seção Opções de Visualização.
1. Selecione Permitir que Autores Visualizem o Conteúdo em uma Página da Web para permitir que os
usuários visualizem páginas usando o servlet Web Content Manager.
2. Para permitir que os usuários visualizem o conteúdo em páginas de portal, você deve selecionar
páginas de portal específicas na lista localizada em Permitir que Autores Visualizem o Conteúdo nas
Páginas de Portal Locais Selecionadas. As páginas de portal exibidas aqui são as páginas disponíveis
na mesma instância de portal na qual seu aplicativo Web Content Manager é instalado. As páginas
selecionadas devem conter um visualizador de conteúdo da Web para exibir o conteúdo.
3. Para permitir que os usuários visualizem o conteúdo em um portlet localizado em um servidor de
portal diferente, você deve inserir a URL na página de portal remoto no campo Permitir que Autores
Visualizem o Conteúdo Usando as Seguintes URLs. As páginas do portal inseridas aqui devem
conter um visualizador de conteúdo da Web para exibir o conteúdo.
Nota: Ao usar um visualizador de conteúdo da Web para visualizar conteúdo, assegure-se de que o
visualizador de conteúdo da Web esteja configurado para receber links de Outros portlets e deste portlet.
Caso contrário, a visualização não funcionará.
Definindo Opções da Interface com o Usuário:
Utilize a seção Opções de Interface com o Usuário para definir as opções da interface com o usuário de
um portlet de autoria.
1. Selecione uma opção de visibilidade para a barra de navegação. Essa é a seção do portlet de autoria
que exibe links de navegação para visualizações de itens, grupo por visualizações e visualizações
pessoais.
Mostrar
Se essa opção for selecionada, a barra de navegação ficará visível quando a página inicial, a
página de ativação ou os formulários de itens forem exibidos.
Ocultar
Se essa opção for selecionada, a barra de navegação ficará oculta quando a página inicial, a
página de ativação ou os formulários de itens forem exibidos. Essa é a opção recomendada
para usuários que só precisam executar tarefas básicas de gerenciamento de conteúdo da web.
Ocultar quando a página inicial ou a página de ativação for aberta
Se essa opção for selecionada, a barra de navegação ficará oculta quando a página inicial ou a
258
página de ativação for exibida, mas ficará visível quando os formulários de itens forem
exibidos. Isso significa que a interface inicial fica mais simples, ao mesmo tempo em que
ainda tem a barra de navegação disponível em outras visualizações. Essa é a opção
recomendada para usuários que precisam executar tarefas mais complexas de gerencimento de
conteúdo da web.
Nota: A barra de navegação é sempre exibida ao usar o explorador de bibliotecas.
2. Selecione uma visualização padrão:
Página Inicial Básica
Se selecionada, a página inicial básica é exibida quando você acessa pela primeira vez o
portlet de autoria. A página inicial básica é projetada para autores de conteúdo que só
precisam criar itens de conteúdo e outros tipos de itens simples, e que normalmente não
precisariam de acesso ao explorador de biblioteca mais avançado. A página inicial básica
permitirá a criação de conteúdo usando até seis modelos de autoria diferentes. Os modelos de
autoria exibidos são os favoritos do usuário atual e os mais recentemente usados pelo usuário
atual.
É possível definir um conjunto de modelos de autoria a ser exibido na página inicial quando
um usuário não tem nenhum item favorito ou usado recentemente. Para fazer isso, inclua o
parâmetro wcm.authoringui.homePageTemplates nas opções de autoria do serviço WCM
WCMConfigService usando o WebSphere Integrated Solutions Console. Os caminhos dos
modelos devem ser especificados, separados por dois-pontos. Exemplo:
Biblioteca 1/Nome do Modelo:Biblioteca 2/pasta/Nome do Modelo 2:Biblioteca 3/Nome do Modelo 3
Página Inicial
Se selecionada, a página inicial padrão é exibida quando você acessa pela primeira vez o
portlet de autoria. Uma seção da página inicial é usada para criar itens e abrir seus locais
favoritos. Outra seção da página inicial é usada para visualizar atividade recente. Essa
interface é projetada para autores de conteúdo que precisam executar tarefas, como criar
conteúdo, editar conteúdo de rascunho e aprovar e recusar conteúdo, mas que normalmente
não precisariam de acesso ao explorador de biblioteca mais avançado.
Página de Ativação
Se tiver criado uma página de ativação customizada para ser utilizada no lugar da interface
com o usuário padrão, selecione Ativar Página. Por exemplo, file.jsp.
Uma página de ativação customizada é um arquivo JSP e deve ser armazenada no diretório
de arquivos do WAR para o portlet de Autoria. was_profile_root/installedApps/cellname/
PA_WCM_Authoring_UI.ear/ilwwcm-authoring.war/jsp/html, em que cellname é exclusivo da
sua instalação. Digite o nome do arquivo JSP no campo de página de ativação customizada.
Explorador de Bibliotecas
Para usar a interface com o usuário padrão, selecione Explorador de Bibliotecas.
3. Selecione Ocultar o item aberto e visualizar listas para ocultar essas funções dos usuários no portlet
de autoria.
4. Para aprimorar o desempenho, é possível limitar o número de tarefas que um usuário pode abrir ao
mesmo tempo no portlet de autoria, digitando um número no campo Máximo de tarefas abertas por
instância do Portlet de Autoria (Máximo de tarefas abertas por instância do Portlet de Autoria).
5. Para aprimorar o desempenho, é possível limitar o número de itens que um usuário pode selecionar
em um índice ao mesmo tempo no portlet de autoria inserindo um número nos campos Máximo de
itens selecionados por ação antes de avisar e Máximo de itens selecionados por ação antes de negar
a ação.
6. O número de linhas que aparecem em um índice é definido no campo Máximo de linhas por tabela.
v Se o valor for omitido, essa configuração será padronizada como 10.
v Se o valor for configurado, ele se tornará o número padrão de itens mostrados por página no
explorador da biblioteca e outras visualizações ativadas a partir do navegador de visualização.
259
v Se o valor configurado for 50 ou superior, esse número será mostrado no seletor rápido de tamanho
de página em cada visualização.
v Um máximo de 250 linhas pode ser configurado, mas configurar um valor alto pode reduzir o
desempenho de seu sistema.
v Essa configuração não se aplica ao diálogo pop-up e seletores. Eles sempre assumem, por padrão,
10 itens por página.
7. Para ativar o Reconhecimento de Pessoas, selecione Ativar reconhecimento de pessoas. O
Reconhecimento de Pessoas permite selecionar nomes de usuários que aparecem nas visualizações e
formulários dentro do Portlet de Autoria e enviar a esses usuários um e-mail ou uma mensagem no
Sametime.
8. Selecione o modo de exibição padrão do explorador de bibliotecas.
Modo de visualização de lista:
Esse modo exibe apenas listas de itens à medida que você navega por uma biblioteca.
Modo de visualização em árvore:
Esse modo exibe listas de itens e uma árvore navegacional à medida que você navega por
uma biblioteca.
9. Selecione o comportamento padrão do botão "Salvar". Essa configuração se aplicará apenas aos tipos
de itens que não requerem um modelo e áreas de site criadas usando o modelo da área de site
padrão.
Definindo Opções de Texto Formatado:
É possível configurar o IBM Web Content Manager para usar o editor Rich Text padrão, um editor Rich
Text avançado ou um editor Rich Text de terceiros em campos Rich Text.
Há três opções disponíveis ao configurar o editor Rich Text padrão para criar portlet:
Padrão
Selecione essa opção para usar o editor JavaScript padrão. Isso não requer um Java Runtime
Environment em funcionamento no computador cliente.
EditLive! Java Editor
Selecione essa opção para usar o EditLive! Java Editor. Isso requer um Java Runtime Environment
em funcionamento no computador cliente.
Customizado
Selecionar Customizado permitirá o uso de um editor Rich Text de terceiros como o editor
padrão. Antes de usar um editor de RTF de terceiros compatível, leia as instruções de instalação e
configuração do editor. Essas devem incluir instruções para ativar o editor de RTF de terceiros a
ser utilizado numa solução do Web Content Manager.
Ao configurar um editor Rich Text de terceiros, será preciso copiar um arquivo JSP fornecido por
tal editor. Esse arquivo é usado para ativar o editor Rich Text de terceiros. Digite o nome desse
arquivo JSP na seção Opções do RTF da configuração do portlet de autoria.
Se o editor Rich Text de terceiros não estiver disponível, será usado o editor Rich Text padrão.
Armazenando Arquivos JSP:
Arquivos JSP podem ser localizados:
v dentro do diretório was_profile_root/installedApps/node-name/wcm.ear/ilwwcm.war do seu
servidor.
A página JSP também é armazenada no diretório war do cliente do portlet de renderização
local ou do servlet ou portlet que chama a JSP, se estiver utilizando a API do Web Content
Manager. Por exemplo, para renderizar uma página JSP em um portlet de renderização local,
260
também seria necessário armazenar uma cópia do arquivo JSP em was_profile_root/
installedApps/node-name/PA_WCMLocalRendering.ear/ilwwcm-localrende.war
v em qualquer outro aplicativo da Web em execução no portal. Ao fazer referência aos arquivos
JSP em outro aplicativo da Web, utilize o caminho a seguir: contextPath;jspPath
Por exemplo: /wps/customapplication;/jsp/editor.jsp
Interfaces de Autoria Customizadas
É possível usar a API do Web Content Manager e parâmetros de ação remota para criar interfaces de
autoria customizadas especificamente para seus criadores de conteúdo.
Talvez você não deseje usar um portlet de autoria como a interface com o usuário para todos os seus
usuários. Em alguns casos, pode ser melhor criar uma interface de autoria customizada usando a API do
Web Content Manager e os parâmetros de ação remota. Por exemplo, você poderá criar uma interface de
autoria de conteúdo muito simples para uma equipe de criação de conteúdo específica.
Páginas de Ativação Customizadas
É possível configurar um portlet de autoria para utilizar uma página de ativação com seu próprio design,
em vez da interface com o usuário padrão. Uma página de ativação customizada pode ser um arquivo
JSP ou HTML. Use ações remotas para chamar visualizações e funções diferentes a partir da interface
com o usuário do portlet de autoria. Também é possível usar a API de conteúdo da Web para incluir
outras funções em sua página de ativação. Uma vez criada uma página de ativação customizada,
configure seu portlet de autoria de modo a utilizar a página de ativação customizada em vez da interface
com o usuário padrão do portlet de autoria.
Ações Remotas
As ações remotas são utilizadas na cadeia de consultas de uma URL para disparar ações do aplicativo
Web Content Manager. É possível usar ações remotas para incluir funções padrão do Web Content
Manager em uma interface com o usuário customizada.
organização.
“Criando uma Página de Ativação Customizada” na página 619
É possível configurar um portlet de autoria para utilizar uma página de ativação com seu próprio design,
em vez da interface com o usuário padrão.
“Utilizando Ações Remotas” na página 608
Ações remotas são usadas para acionar ações a partir do aplicativo IBM Web Content Manager.
“A API do IBM Web Content Manager” na página 599
Você pode utilizar a API do Web Content Manager para estender funções do Web Content Manager.
Estratégias de Edição Sequencial do Conteúdo da Web
Um sistema de edição sequencial é usado para entregar sites da Web editáveis, como uma intranet ou um
wiki. Ele combina os recursos de um sistema de autoria e um sistema de entrega.
Utilizando um Elemento da Authoring Tool
O elemento de ferramenta de autoria é usado para incluir funções do portlet de autoria para páginas da
Web. Ao criar um elemento de ferramenta de autoria, você precisa definir o layout da ferramenta de
autoria e quaisquer ações necessárias e selecionar parâmetros para cada layout de ação, conforme
necessário.
261
“Elementos da Authoring Tool”
Web.
Elementos da Authoring Tool:
Web.
É possível incluir as seguintes funções do portlet de autoria em uma página da Web:
v Criar um novo item de conteúdo.
v Executar edição sequencial de um item de conteúdo exibido em uma página da Web.
v Excluir o item de conteúdo exibido em uma página da Web.
v Aprovar ou rejeitar o conteúdo atual que está sendo visualizado. Esses botões são visíveis apenas para
aprovadores quando visualizam um item de rascunho ou abrindo a URL enviada por uma ação de
e-mail durante um fluxo de trabalho.
As ferramentas de autoria podem ser referidas dentro de modelos de apresentação, designs de elemento
de menu e designs de elemento de navegador. Quando incluída nos menus e navegadores, as funções
editar, excluir e aprovar são aplicadas a cada item exibido num menu ou navegador.
Criando um Elemento de Ferramenta de Autoria
Você apenas pode utilizar um elemento da authoring tool criando um componente authoring tool. Você
não pode incluir um elemento de ferramenta de autoria em modelos de autoria, áreas de site ou itens de
conteúdo.
Utilizando uma ferramenta de autoria
Ao visualizar o conteúdo, usuários com acesso a uma ferramenta de autoria são capazes de executar
diversas funções do portlet de autoria.
Nota: Cuidados devem ser tomados ao visualizar os itens de conteúdo que utilizam um modelo de
apresentação que inclua uma ferramenta de autoria. Algumas funções ativas e prontas para serem
utilizadas com outras funções podem não funcionar normalmente.
A ferramenta de autoria também estará visível ao visualizar um site publicado.
Utilizando uma ferramenta de autoria em vários servidores
Ao utilizar uma ferramenta de autoria em mais de um servidor, utilize uma afiliação de duas vias para
manter sincronizado cada servidor que está sendo utilizado como autor de conteúdo. Isso pode conduzir
a um conflito de "salvamento" ocasional em que um item atualizado no servidor será substituído pelas
alterações no mesmo item em outro servidor quando ocorrer a sindicação.
Acesso do usuário a uma ferramenta de autoria
As ferramentas de autoria disponíveis para usuários em uma página da Web são determinadas por:
v Se um usuário possui acesso ao componente de ferramenta de autoria.
v Quais ferramentas foram ativadas no elemento da ferramenta de autoria.
v O nível de acesso do usuário ao item de conteúdo exibido em uma página da Web.
262
v Se um usuário tiver acesso ao portlet de autoria. Recomenda-se que sejam designados aos usuários,
pelo menos, o acesso de contribuidor a cada biblioteca de conteúdo da Web em um site para garantir
que tenham acesso ao portlet de autoria.
v Você concede acesso de "editor" ou acima apenas a usuários que precisam editar a ferramenta de
autoria.
v O acesso de "usuário" é concedido somente aos usuários que também possuem acesso ao servidor de
autoria e que utilizarão a ferramenta de autoria.
v Na maioria dos casos, os usuários com acesso apenas ao site publicado não receberão acesso a uma
ferramenta de autoria visto que tal ferramenta destina-se a ser utilizada num servidor de autoria, não
em um site publicado.
“Utilizando um Elemento da Authoring Tool” na página 261
Web. Ao criar um elemento de ferramenta de autoria, você precisa definir o layout da ferramenta de
autoria e quaisquer ações necessárias e selecionar parâmetros para cada layout de ação, conforme
necessário.
Trabalhando com Componentes de Ferramentas de Autoria no Visualizador de Conteúdo da Web:
Ao renderizar componentes da ferramenta de autoria no visualizador de conteúdo da web, você deve
levar em conta algumas mudanças na maneira como tags de marcador são especificadas e na maneira
como usuários navegam até páginas contendo componentes da ferramenta de autoria. As tarefas de
autoria acessadas por meio de um visualizador de conteúdo da web, como edição sequencial, requerem o
uso de uma instância do portlet de autoria do IBM Web Content Manager que está reservada
especificamente para essas tarefas.
Controlando o Comportamento dos Componentes de Ferramentas de Autoria:
Os componentes das ferramentas de autoria renderizados em um visualizador de conteúdo da web
permitem criar, ler, editar, excluir, aprovar ou rejeitar itens de conteúdo diretamente no visualizador de
conteúdo da web, em vez de requererem que você navegue para o portlet de autoria do IBM Web
Content Manager para executar a mesma ação. O visualizador de conteúdo da web ativa uma janela
pop-up que é aberta na página atual ou redireciona o usuário para outra página de portal que contém o
portlet de autoria.
Você pode especificar qual comportamento usar no design de elementos das ferramentas de autoria.
Geralmente, as tags de marcador são usadas para exibir elementos das ferramentas de autoria. O valor do
atributo format da tag de marcador determina que tipo de URL é criada para executar uma tarefa de
autoria:
format="tag"
O marcador é renderizado como uma URL que abre uma janela pop-up que contém o portlet de
autoria.
format="url"
O marcador é renderizado como uma URL que redireciona o usuário para uma outra página de
portal que é usada pelo visualizador de conteúdo da web para edição sequencial.
Nota: As tarefas de autoria executadas no visualizador de conteúdo da web são realizadas por meio de
uma instância especial do portlet de autoria que é reservada especificamente para essas tarefas e está
instalada em uma página que é oculta da navegação de página disponível para usuários típicos. Você
pode customizar a experiência de autoria para essas tarefas configurando o portlet de autoria reservado e
a página usada para exibi-lo.
263
Usando Componentes de Ferramentas de Autoria ao Ativar uma Janela Pop-up
Ao usar uma janela pop-up para executar uma tarefa de autoria, a janela pop-up é aberta na página de
portal e pode ser movida dentro dos limites da janela do navegador enquanto ainda mostra a página de
portal. Depois que você conclui a tarefa acionada pelo elemento de ferramentas de autoria, a janela
pop-up fecha automaticamente e a página de portal é atualizada, atualizando a visualização no
visualizador de conteúdo da web. Você pode cancelar a tarefa de autoria clicando no ícone de fechamento
na barra de título da janela pop-up. Ao cancelar a tarefa, nenhuma informação de conteúdo da web é
salva, a menos que você salve explicitamente as mudanças antes de fechar manualmente a janela.
O valor-padrão do atributo format para uma tag de marcador é tag. Dessa forma, para usar janelas
pop-ups para edição sequencial, não é necessário especificar um valor para o atributo format. Qualquer
um dos seguintes exemplos de design cria uma URL que abre uma janela pop-up para tarefas de autoria:
<Placeholder tag="namelink"/>
<Placeholder tag="namelink" format="tag"/>
<a href="<Placeholder tag="href"/> ">
<Placeholder tag="name"/>
</a>
<a href="<Placeholder tag="href" format="tag"/>">
</a>
Nota: Não é possível ativar a janela pop-up em uma janela separada do navegador incluindo
target="_blank" na tag âncora HTML no design.
Usando Componentes de Ferramentas de Autoria ao Navegar para Outra Página
Em vez de executar tarefas de elementos de ferramentas de autoria em uma janela pop-up acima da
página atual, é possível executar tarefas de autoria navegando para uma página de portal oculta que
contenha um visualizador de conteúdo da web contendo o portlet de autoria reservado. Clicar em um
link para um elemento de ferramentas de autoria o redireciona, automaticamente, para a outra página,
mas após você concluir a tarefa de autoria, é necessário navegar manualmente de volta à página original.
Se a página com o portlet de autoria reservado tiver sido aberta em uma nova janela ou guia do
navegador, você deverá fechar a janela ou a guia e atualizar, manualmente, a página original para ver
quaisquer mudanças.
Para redirecionar usuários à outra página para tarefas de autoria, especifique um valor de url para o
atributo format na tag de marcador do design de elemento das ferramentas de autoria. Qualquer um dos
seguintes exemplos de design cria uma URL que redireciona usuários para outra página de portal para
tarefas de autoria:
<Placeholder tag="namelink" format="url"/>
<a href="<Placeholder tag="href" format="url"/>">
</a>
<a href="<Placeholder tag="href" format="url"/>" target="_blank">
</a>
Nota: É possível abrir a página de portal em uma janela separada do navegador incluindo
target="_blank" na tag âncora HTML no design.
264
“Configurando o Portlet de Autoria Reservado” na página 100
O portlet de autoria reservado é essencial para a operação adequada de páginas de conteúdo da web e
do visualizador de conteúdo da web, portanto, é importante que a configuração do portlet de autoria
reservado reflita as configurações semelhantes para executar tarefas de autoria como a configuração de
outras instâncias do portlet de autoria do IBM Web Content Manager.
Referenciando uma Ferramenta de Autoria:
Um componente de ferramenta de autoria pode ser referenciado dentro de modelos de apresentação,
designs de elementos de menu e designs de elementos de navegador. Quando for incluído nos menus e
navegadores, as funções editar e excluir serão aplicadas em cada item exibido em um menu ou
navegador.
Referenciando um componente de ferramenta de autoria em um modelo de apresentação
Um elemento de ferramenta de autoria é referenciado em uma tag do componente de conteúdo da Web:
[Component name="authoringtoolname" ]
Referenciando um elemento de ferramenta de autoria em um design de menu ou do navegador
Ao referenciar um componente de ferramenta de autoria nos designs do menu ou navegador, use uma
tag do componente com um parâmetro igual a compute="always". Por exemplo:
[Component name="authoringtoolname" compute="always" ]
Conteúdo
O IBM WebSphere Portal fornece maneiras diferentes de inclusão de conteúdo no site. É possível incluir
marcação padrão, como HTML, portlets e conteúdo de outras origens.
IBM Web Content Integrator
Para usar o Web Content Integrator, é necessário:
1. criar uma alimentação em seu sistema de origem usando a especificação de formato de alimentação
do Web Content Integrator.
2. configurar o WebSphere Portal para consumir a alimentação.
Especificação do Formato de Alimentação
RSS, ou Really Simple Syndication, é um formato baseado em XML que é amplamente usado para
organizar o conteúdo de origens como Web sites e blogs para leitores que assinaram as alimentações. A
entrada no Web Content Integrator é uma alimentação de conteúdo que está em conformidade com o
formato RSS 2.0. O formato de alimentação principal é relativamente simples, com apenas um número
limitado de elementos que precisam ser especificados para cada item na alimentação. Entretanto, a
especificação RSS 2.0 permite que o formato base seja estendido usando espaços de nomes XML para
265
suportar funcionalidade adicional. Para ativar um nível mais profundo de controle sobre como os itens
são criados no Web Content Manager, uma extensão RSS foi definida contendo elementos que mapeiam
para vários dos atributos do modelo de objeto do Web Content Manager.
Visão Geral do Formato de Alimentação
RSS 2.0 é um dialeto de XML e todos os arquivos RSS devem estar em conformidade com a especificação
XML 1.0 conforme publicado pelo World Wide Web Consortium (W3C). Os arquivos de alimentação RSS
geralmente possuem extensões de arquivo iguais a .rss ou .xml. O Web Content Integrator não impõe
nenhuma convenção de nomenclatura do arquivo no produtor de alimentação.
Formato de Arquivo de Alimentação RSS 2.0
As opções de tipo de mídia mais comumente usadas são "text/xml" e "application/rss+xml". A opção de
tipo de mídia impacta em como o Web Content Integrator consegue determinar a codificação de caractere
da alimentação. Se a codificação de caractere não puder ser determinada corretamente, o Web Content
Integrator produzirá erros ao analisar a alimentação. Portanto, é importante escolher um tipo de mídia
apropriado para seu ambiente.
Seguindo o prólogo de XML, um arquivo RSS 2.0 começa com um único elemento <rss>. Este elemento
possui um atributo necessário, "version", que deve ser configurado como "2.0". O arquivo também deve
conter um único elemento <channel> que contém vários subelementos que fornecem alguns metadados
sobre a alimentação como um todo. O elemento <channel> deve conter um ou mais elementos <item>.
Os elementos <item>, por sua vez, contêm subelementos que fornecem informações sobre o conteúdo que
está sendo organizado. Por exemplo:
<?xml version="1.0"?>
<rss version="2.0">
<channel>
<title>Alimentação de Amostra</title>
<link>http://www.ibm.com/feeds/sample.rss</link>
<description>Um exemplo de alimentação RSS</description>
<lastBuildDate>Terça-feira, 31 de outubro de 2006 10:31:00 EST</lastBuildDate>
<item>
<title>Item de Notícias Dois</title>
<link>http://www.ibm.com/news/two.htm</link>
<description>
Este é um resumo do segundo artigo de notícias
</description>
<pubDate> Terça-feira, 31 de outubro de 2006 10:31:00 EST</pubDate>
</item>
<item>
<title>Item de Notícias Um</title>
<link>http://www.ibm.com/news/one.htm</link>
<description>
Este é um resumo do primeiro artigo de notícias.
</description>
</item>
</channel>
</rss>
Nota: Se dados não ascii forem usados em uma alimentação, encoding="UTF-8" deverá ser especificado
na alimentação: <?xml version="1.0" encoding="UTF-8"?>
Elementos no Nível do Canal
Cada arquivo de alimentação RSS deve conter apenas um elemento de canal. Há vários subelementos
permitidos do canal que fornecem alguns metadados sobre o próprio canal. Os elementos a seguir são
necessários ou usados pelo Web Content Integrator.
266
title
Este elemento é usado para fornecer o nome da alimentação. Este elemento é necessário para a
especificação RSS 2.0, mas não é usado pelo Web Content Integrator.
link
Este elemento contém uma URL que aponta para a página da web que contém o feed. Este
elemento é necessário pela especificação RSS 2.0, mas não é usada pelo Web Content Integrator.
description
Este elemento contém uma breve descrição do conteúdo do canal. Este elemento é necessário pela
especificação RSS 2.0, mas não é usada pelo Web Content Integrator.
lastBuildDate
Este elemento contém um registro de data e hora que representa a última vez que o conteúdo do
feed foi alterado. Esta data, bem como quaisquer outras na alimentação, deve estar em
conformidade com o formato RFC 822. Este é um elemento opcional de acordo com a
especificação RSS 2.0, entretanto, alguns aplicativos do leitor de alimentação podem depender
dele. Em determinados casos, o Web Content Integrator armazenará o valor no elemento
lastBuildDate e, em seguida, o transmitirá de volta ao produtor de alimentação no próximo
pedido como uma maneira de indicar qual versão da alimentação ele já organizou.
Elementos no Nível do Item
Para os propósitos do Web Content Integrator, cada item na alimentação representa um tipo de item. Os
seguintes tipos de itens podem ser criados ou atualizados através da alimentação:
v Itens de conteúdo
v Áreas de site
v Taxonomias
v Categorias
v Componente
Os seguintes subelementos são necessários ou usados pelo Web Content Integrator:
title
O valor deste elemento será armazenado no campo Nome dos itens de conteúdo da Web. Para
itens de conteúdo, isso se tornará parte da URL para a página de conteúdo. Como isto será usado
no campo Nome dos itens de conteúdo da Web, o título poderá conter apenas caracteres
alfanuméricos (a-z, A-Z, 0-9), espaços e os seguintes caracteres: $ - _ . ! ( ) , Este é um
subelemento necessário.
link
Esta é a URL para o conteúdo de origem. Em alguns casos, isso será usado como a URL base a
partir da qual quaisquer links relativos integrados no conteúdo são resolvidos.
description
O valor deste elemento será armazenado no campo Descrição dos itens de conteúdo da Web.
Embora a especificação RSS permita que HTML codificado por entidade ou com escape seja
colocado neste elemento, o campo Descrição nos itens de conteúdo da Web não é projetado para
armazenar HTML. Para os propósitos do Web Content Integrator, este elemento deve conter
apenas texto simples.
pubDate
O valor deste elemento deve ser um registro de data e hora de RFC 822 que represente o horário
em que o item foi incluído ou atualizado no feed. O Web Content Integrator usará esta data em
combinação com o elemento <guid> para determinar se ele já processou, ou não, o item. Toda
vez que um item é atualizado através da alimentação, o valor de <pubDate> na entrada de
alimentação também será atualizado para indicar se algo foi alterado. Este é um subelemento
necessário.
guid
O elemento <guid> deve conter um ID para identificar exclusivamente o item. Este muitas vezes
será um ID exclusivo do sistema de gerenciamento de conteúdo de origem. O Web Content
Integrator manterá um mapeamento deste ID para o ID do Web Content Manager interno do
item. Isso é necessário para poder atualizar ou excluir corretamente os itens que já existem no
267
Web Content Manager. Esse campo faz distinção entre maiúsculas e minúsculas e pode conter
qualquer sequência de caracteres até um máximo de 256 caracteres. O atributo isPermaLink será
ignorado. Esse é um elemento necessário.
categoria
Cada elemento <category> conterá uma tag de metadados hierárquicos que descreve o conteúdo.
O valor deste elemento será convertido em itens de taxonomia e categoria no Web Content
Manager. Se a árvore de categorias especificada no elemento <category> ainda não existir no Web
Content Manager, ela será criada automaticamente pelo Web Content Integrator quando a entrada
da alimentação for processada. A especificação RSS 2.0 define um atributo de domínio opcional
para o elemento de categoria. Os produtores de feed podem usar esse atributo para armazenar o
nome da biblioteca de conteúdo da web na qual a árvore de categorias será criada. Este elemento
se aplica apenas aos itens de conteúdo. Um único <item> podem conter múltiplos elementos de
categoria. Como isso será usado no campo Nome dos itens de taxonomia e categoria do conteúdo
da Web, o título pode conter apenas caracteres alfanuméricos (a-z, A-Z, 0-9), espaços e os
seguintes caracteres: $ - _ . ! ( ) , Este é um subelemento necessário.
autor
De acordo com a especificação RSS 2.0, esse elemento contém o endereço de email do autor. A
especificação permite apenas um único elemento <author> por item. Geralmente, este será o
autor do item de conteúdo no sistema de gerenciamento do conteúdo de origem. O Web Content
Integrator tentará resolver o endereço de e-mail no nome comum de um usuário do portal e, em
seguida, armazenar o nome desse usuário no campo de autor, no item do Web Content Manager.
Se esse elemento não estiver presente na alimentação, ou se o endereço de e-mail não puder ser
resolvido, o nome do usuário do sistema será armazenado no campo de autor do item do Web
Content Manager.
Extensão de Espaço de Nomes RSS para Conteúdo da Web
Itens do Web Content Manager contêm um conjunto de controles que são usados para armazenar
informações para vários propósitos. Os elementos neste espaço de nomes mapeiam, aproximadamente,
para os campos que estão disponíveis nesses controles. Dependendo do tipo do item, ele pode, ou não,
conter determinados controles, de forma que alguns dos elementos no espaço de nomes sejam relevantes
apenas para tipos de itens específicos. Todos os elementos neste espaço de nomes são subelementos de
<item>, nenhum é usado no nível de <channel>.
Incluindo a Definição de Espaço de Nomes Customizada na Alimentação:
O primeiro requisito é incluir a referência de namespace no elemento <rss> no início da alimentação.
A URL do espaço de nomes é especificada usando a seguinte tag:
<rss version="2.0" xmlns:ibmwcm="http://purl.org/net/ibmfeedsvc/wcm/1.0" >
Este é um valor de propriedade fixo que o analisador de alimentação usa como a chave para identificar
elementos que pertencem ao espaço de nomes do Web Content Integrator customizado.
Por exemplo:
<channel>
<item>
<description>
</description>
268
<ibmwcm:itemType>Content</ibmwcm:itemType>
</item>
</channel>
</rss>
O rótulo do espaço de nomes "ibmwcm" pode ser alterado enquanto o rótulo especificado na declaração
de espaço de nomes corresponder ao rótulo usado nos elementos estendidos na alimentação.
Elementos de Controle de Processo:
Estes elementos são usados para fornecer ao Web Content Integrator algumas informações sobre como
tratar os dados contidos no <item>.
action
Este elemento indica a ação a ser executada no item representado por <item>.
Tabela 78. Elemento action
Parâmetros de elemento:
Detalhes para este elemento:
Aplica-se aos tipos de itens
Todos
Necessário para tipos de itens
Todos
Valores Permitidos
"add", "update" ou "delete".
Atributos Necessários
Nenhum
Atributos Opcionais
Nenhum
Subelementos Necessários
Nenhum
Subelementos Opcionais
Nenhum
Por exemplo:
<ibmwcm:action>update</ibmwcm:action>
itemType
O elemento itemType indica o tipo de item representado pela entrada de alimentação. Isto corresponde
aos tipos de itens do Web Content Manager que podem ser criados ou atualizados através da
alimentação. Em alguns casos, o valor deste elemento é combinado com o valor no elemento
<ibmwcm:path> para determinar qual tipo de item do Web Content Manager criar.
Tabela 79. Elemento itemType
Todos
Todos
Valores Permitidos
"siteArea" para áreas de site.
"content" para itens de conteúdo.
"component" para componentes.
"category" para taxonomias e categorias.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
269
Por exemplo:
Área do Site
<ibmwcm:itemType>siteArea</ibmwcm:itemType> + qualquer outro valor para <ibmwcm:path> ou a falta de um elemento <ibmwcm:path>.
Taxonomia
<ibmwcm:itemType>category</ibmwcm:itemType> + <ibmwcm:path>/</ibmwcm:path>
Categoria (Category)
<ibmwcm:itemType>category</ibmwcm:itemType> + qualquer outro valor para <ibmwcm:path> ou a falta de um elemento <ibmwcm:path>.
Componente
<ibmwcm:itemType>component</ibmwcm:itemType>
Conteúdo
<ibmwcm:itemType>content</ibmwcm:itemType>
Elementos de Controle do Local:
Estes elementos são usados para fornecer o Web Content Integrator com algumas informações sobre um
local relativo do item.
library
É necessário especificar um nome de biblioteca de conteúdo da Web padrão ao configurar uma tarefa
para consumir uma alimentação de entrada. O Web Content Integrator executará todas as operações nessa
biblioteca, incluindo a criação de novos itens do Web Content Manager, à procura por versões existentes
de itens e à procura por qualquer artefato de design associado como modelos de autoria e fluxos de
trabalho. Também é possível substituir esta configuração de forma que uma única alimentação possa ser
usada para criar conteúdo em múltiplas bibliotecas.
Há três maneiras como o Web Content Integrator verificará se um valor foi especificado neste elemento:
v Se a biblioteca especificada no elemento de biblioteca corresponder a uma biblioteca de conteúdo da
Web existente, todas as operações durante o processamento desta entrada de alimentação serão
processadas no contexto da biblioteca especificada no elemento de biblioteca.
v Se nenhum elemento de biblioteca estiver presente na entrada de alimentação, ou se o elemento de
biblioteca estiver presente, mas nenhum valor foi especificado, a biblioteca padrão da configuração da
tarefa será usada.
v Se um valor for especificado no elemento de biblioteca, mas nenhuma biblioteca de conteúdo da Web
correspondente for localizada, uma mensagem de erro será registrada e a entrada de alimentação não
será processada.
Tabela 80. Elemento library
Todos
Nenhum
Valores Permitidos
O nome de uma biblioteca de conteúdo da Web existente.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
270
Tabela 80. Elemento library (continuação)
Nenhum
Por exemplo:
<ibmwcm:library>LibraryName</ibmwcm:library>
path
O elemento de caminho é usado para indicar o caminho hierárquico para o item de conteúdo da Web.
Para áreas de site e itens de conteúdo, este elemento contém o caminho da área de site pai. Para
categorias, o valor é o caminho de categoria pai.
As áreas de site e categorias podem ter apenas um único elemento de caminho. Se mais de um elemento
de caminho for especificado, apenas o primeiro será usado. Os itens de conteúdo podem ter múltiplos
pais, de forma que múltiplos elementos de caminho possam ser usados. O primeiro elemento de caminho
é usado como o item de conteúdo principal e os elementos de caminho seguintes serão tratados como
links de conteúdo. Um parâmetro "library" opcional pode ser especificado para elementos de caminho
que se referem ao conteúdo vinculado localizado em uma biblioteca diferente do item de conteúdo
principal.
Novos itens serão incluídos no final da lista atual de itens no Web Content Manager.
Tabela 81. Elemento path
Área de Site, Categoria, Conteúdo
Áreas de Site e Taxonomias
Valores Permitidos
Todos os valores devem iniciar com um caractere "/" de
barra inicial. Para itens de área de site e taxonomia, o
valor deve ser apenas uma única barra "/".
Nenhum
Atributos Opcionais
"library"
Contém o nome de uma biblioteca na qual o caminho do
site reside. Este atributo é usado onde o conteúdo
vinculado reside em uma biblioteca diferente a partir do
conteúdo principal. Este atributo é ignorado no primeiro
elemento de caminho listado na entrada da alimentação.
Nenhum
Nenhum
Exemplos:
<ibmwcm:path>/</ibmwcm:path>
<ibmwcm:path>/IBM/Products</ibmwcm:path>
<ibmwcm:path library="en_US">/Intranet/Home/News</ibmwcm:path>
271
createLinks
Isto é usado para especificar a quais itens pais se vincular ao criar itens de conteúdo.
Tabela 82. Elemento createLinks
Conteúdo
Nenhum
Valores Permitidos
O elemento createLinks é um contêiner para capacidade
de leitura e não possui atributos ou valores esperados.
Nenhum
Atributos Opcionais
Nenhum
parentGuid
O elemento parentGuid deve conter o ID
exclusivo de outro item na alimentação que
descreve o item pai.
Nenhum
Exemplos:
<ibmwcm:createLinks>
<ibmwcm:parentGuid>8234ad23fb29</ibmwcm:parentGuid>
</ibmwcm:createLinks>
O Contêiner Órfão
Se nenhum pai ou caminho válido for especificado na alimentação, o item será colocado em um contêiner
órfão até ele poder ser atualizado com um caminho válido. O Web Content Integrator criará,
automaticamente, um contêiner de órfãos em cada biblioteca de conteúdo da Web conforme ele
necessário. Para áreas de site e itens de conteúdo, o contêiner órfão será um nome de caminho de área de
site "WCI/Orphans". Para categorias, o contêiner órfão será um caminho de taxonomia e de categoria
com o nome "WCI/Orphans". O nome dos contêiners órfãos podem ser controlados através de uma
configuração no arquivo WCMConsumerPlugin.properties.
children
O elemento children é usado para especificar os filhos do item atual. O valor deste elemento deve ser o
GUID de outra entrada na alimentação que descreve um filho do item atual.
O item filho referenciado deve ser de um tipo apropriado. Para áreas de site, os filhos devem ser áreas de
site ou itens de conteúdo. Para taxonomias e categorias, os filhos devem ser categorias. Se o tipo não for
válido, o item pai ainda será incluído ou atualizado, mas a referência filha não será criada.
Múltiplos subelementos childGuid podem estar contidos no elemento filho. Se múltiplos filhos forem
especificados, eles serão incluídos na ordem na qual eles estão listados na alimentação. Isto permite que o
produtor de alimentação controle a ordem na qual áreas de site e itens de conteúdo são vinculados às
suas áreas de site pais, o que pode ser útil para configurar exibições de navegação.
Há dois atributos do elemento children que controlam como os filhos especificados na alimentação são
combinados com quaisquer filhos que já podem estar contidos pelo item pai. O atributo de ação controla
se a lista de filhos na alimentação substituirá, ou não, a lista existente de filhos. Se o valor desse atributo
for configurado como "incluir", os filhos especificados na alimentação serão combinados com a lista
existente de filhos. Qualquer outro valor, incluindo uma cadeia vazia ou a ausência deste atributo, fará
com que a lista de filhos especificados na alimentação substituam completamente a lista pré-existente.
272
O atributo de posição é relevante apenas quando o atributo de ação é configurado como "incluir". Este
atributo controla se os filhos especificados na alimentação são incluídos no início ou no final da lista de
filhos pré-existente. Se este atributo não for especificado, os filhos serão incluídos no final da lista
pré-existente. Se o elemento filho não estiver presente na alimentação, a lista de filhos pré-existentes
permanecerá intacta.
As áreas de site e categorias podem ter apenas um pai imediato, quaisquer relacionamentos pais
pré-existentes serão removidos antes de incluí-los como um filho deste item. Como os itens de conteúdo
podem ter múltiplos pais, incluir um item de conteúdo como um filho deste item não o remove de
qualquer um de seus outros pais
Tabela 83. Elemento children
siteArea, Categoria.
Nenhum
Valores Permitidos
O elemento children é apenas um contêiner para
capacidade de leitura, ele não possui os valores
esperados.
Nenhum
Atributos Opcionais
action
O atributo de ação pode ter um valor igual a
"add" ou "replace". Estes valores indicam se
deve substituir, ou não, filhos que já existem ou
incluir neles.
position
Este atributo pode ter o valor "start" ou "end".
Estes valores indicam se os filhos serão
colocados na ordem de irmão conforme eles são
processados.
childGuid
O elemento childGuid deve conter o ID
exclusivo de outro item na alimentação que
descreve o item filho.
Nenhum
Exemplos:
<ibmwcm:children action="add" position="start">
<ibmwcm:childGuid>8234cb51df43</ibmwcm:childGuid>
</ibmwcm:children>
defaultContent
O elemento defaultContent se aplica apenas a áreas de site. Ele permite que o produtor da alimentação
especifique qual item de conteúdo será usado como o conteúdo padrão para uma área de site. Se este
elemento estiver ausente, possuir um valor em branco ou não puder ser resolvido, o conteúdo padrão da
área de site será limpo.
Tabela 84. Elemento defaultContent
siteArea.
Nenhum
273
Tabela 84. Elemento defaultContent (continuação)
Valores Permitidos
O valor deve ser o GUID de outro item na alimentação
que descreve um item de conteúdo.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Exemplos:
<ibmwcm:defaultContent>8234cb5</ibmwcm:defaultContent>
templateMap
O elemento templateMap se aplica apenas a áreas de site. Ele permite que o produtor de alimentação
especifique os mapas de modelo a serem usados ao renderizar o conteúdo que está contido na área de
site designada. Use múltiplas instâncias do elemento templateMap para criar múltiplos mapeamentos de
modelo em uma área de site.
Ao executar uma atualização de uma área de site existente, as etapas a seguir serão executadas para cada
elemento <ibmwcm:templateMap /> especificado na alimentação:
1. Obtenha os nomes dos modelos de autoria e apresentação especificados no elemento templateMap.
2. Tente localizar um modelo de autoria que corresponde ao nome especificado na alimentação.
3. Se um item do modelo de autoria correspondente não puder ser localizado, registre um erro e inicie o
processamento do próximo elemento templateMap.
4. Tente localizar um modelo de apresentação que corresponda ao nome especificado na alimentação.
5. Se um modelo de apresentação correspondente não pode ser localizado, registre um erro e inicie o
processamento do próximo elemento templateMap.
6. Verifique se a área de site já contém um mapeamento para o modelo de autoria especificado:
a. Se contiver, verifique se ele mapeia para o mesmo modelo de apresentação conforme especificado
na alimentação;
1) Em caso afirmativo, acesse o próximo elemento templateMap.
2) Se não, remova o mapeamento e substitua-o por um para o modelo de apresentação
especificado.
b. Se não, crie um novo mapeamento do modelo de autoria especificado para o modelo de
apresentação especificado.
7. Processe o próximo elemento templateMap
As APIs do WCM não fornecem um mecanismo para obter uma lista completa de mapeamentos de
modelo que existem para uma área de site. Como resultado, não é possível remover um mapeamento de
modelo através da alimentação. Quando um mapeamento tiver sido configurado em uma área de site, ele
poderá ser atualizado por meio da alimentação, mas só poderá ser removido manualmente por meio do
portlet de autoria do WCM.
Tabela 85. Elemento templateMap
siteArea.
Nenhum
274
Tabela 85. Elemento templateMap (continuação)
Valores Permitidos
Este elemento não utiliza nenhum valor. Os dados são
especificados nos atributos.
authoring
O valor deste atributo deve ser uma cadeia que
corresponde exatamente ao nome de um modelo
de autoria existente.
apresentação
O valor deste atributo deve ser uma cadeia que
corresponde exatamente ao nome de um modelo
de apresentação existente.
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Exemplos:
<ibmwcm:templateMap authoring="AT News" presentation="PT News" />
<ibmwcm:templateMap authoring="AT Announcement" presentation="PT Announcement" />
Elementos de Controle de Identidade:
A maioria dos campos de identificação nos itens do Web Content Manager mapeia diretamente para
elementos RSS principais; <title> mapeia para o campo de nome, <description> mapeia para o campo de
descrição e <author> mapeia para o campo de autores. Outros campos de identificação podem ser
preenchidos usando os seguintes elementos de controle de identidade.
displayTitle
O elemento displayTitle permite que o produtor de alimentação especifique um valor separado para o
campo Título de Exibição no Web Content Manager. Se este elemento não estiver presente na entrada de
alimentação, o Web Content Manager configurará automaticamente o valor do campo Título de Exibição
para corresponder ao campo Nome quando o item é salvo.
Tabela 86. Elemento displayTitle
Todos
Nenhum
Valores Permitidos
Uma cadeia a ser usada como o Título de Exibição no
Web Content Manager. Diferente do campo Nome, este
campo pode conter caracteres de byte duplo e não ASCII.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Por exemplo:
<ibmwcm:displayTitle>
Press Release dos Resultados do Último Trimestre
</ibmwcm:displayTitle>
275
owner
O elemento owner fornece um mecanismo para configurar o valor do campo Proprietários através da
alimentação. Múltiplos elementos owner podem ser especificados. Cada elemento owner deve conter o
nome comum de um único usuário ou grupo do WebSphere Portal. Se o Web Content Integrator não
puder resolver um nome especificado para um usuário ou grupo real, esse usuário ou grupo não será
incluído no campo Proprietários mas todos os outros processamentos continuarão normalmente.
Tabela 87. Elemento owner
Todos
Nenhum
Valores Permitidos
[todos os usuários autenticados do portal]
O nome comum de qualquer usuário ou grupo do
WebSphere Portal válido
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Por exemplo:
<ibmwcm:owner>[all authenticated portal users]</ibmwcm:owner>
<ibmwcm:owner>jsmith</ibmwcm:owner>
Elementos de Controle de Perfil:
Os campos de taxonomias e categoria são preenchidos usando o elemento RSS <category>. Para
preencher o campo Palavras-chave, um elemento keywords é necessário.
keywords
O elemento keywords deve conter uma lista delimitada por vírgula de tags de metadados que descrevam
o conteúdo. A lista será armazenada no estado em que se encontra no campo Palavras-chave dos itens de
conteúdo.
Tabela 88. Elemento keywords
Conteúdo
Nenhum
Valores Permitidos
Uma lista delimitada por vírgulas de palavras-chave em
formato de texto simples.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Por exemplo:
276
<ibmwcm:keywords>software,testing</ibmwcm:keywords>
O Elemento authoringTemplate:
O elemento authoringTemplate é usado para especificar o modelo de autoria que será aplicado a um item
de conteúdo ou uma área de site. O valor deste elemento deve ser o nome de um modelo de autoria
existente.
authoringTemplate
Se o modelo de autoria estiver localizado em uma biblioteca diferente do item, será possível especificar o
nome da biblioteca também. Se nenhuma biblioteca for especificada, o Web Content Integrator procurará
a biblioteca que foi especificada no elemento <ibmwcm:library>. Se nenhum elemento <ibmwcm:library>
estiver presente, o Web Content Integrator procurará a biblioteca padrão especificada na configuração da
tarefa.
Nota: Uma vez criado um item, não é possível alterar o modelo de autoria dele. Portanto, ao processar
uma atualização, se o authoringTemplate especificado na entrada de feed não corresponder ao nome do
modelo de autoria que foi originalmente usado para criar o item, o Web Content Integrator gerará uma
mensagem de erro.
Tabela 89. Elemento authoringTemplate
Conteúdo, área de site
Nenhuma
Valores Permitidos
O nome de um modelo de autoria existente ou o nome
de uma biblioteca e um modelo de autoria existentes
separados por uma barra. Por exemplo:
v News-AT
v TmpltLib/News-AT
Nenhuma
Atributos Opcionais
Nenhuma
Nenhuma
Nenhuma
Por exemplo:
<ibmwcm:authoringTemplate>News</ibmwcm:authoringTemplate>
<ibmwcm:authoringTemplate>TmpltLib/News</ibmwcm:authoringTemplate>
Elemento de Controle do Elemento:
O elemento de controle do elemento é usado para preencher elementos armazenados em componentes,
áreas de site e itens de conteúdo.
Visão Geral do Elemento
O Web Content Integrator usa a seguinte lógica de negócios para processar cada elemento do componente
na entrada de alimentação:
1. Ele verifica se a área de site do componente ou o item de conteúdo possui um campo cujo nome
corresponda ao valor no atributo de nome do elemento de alimentação. Esta é uma comparação que
faz distinção entre maiúsculas e minúsculas, portanto, os nomes devem corresponder exatamente.
277
Se um campo correspondente for localizado, ele verificará se o tipo de dado corresponde ao que foi
especificado no subelemento do elemento de alimentação.
3. Se o nome e o tipo de dado corresponderem, o elemento na área de site ou item de conteúdo será
atualizado para corresponder aos dados contidos no elemento de alimentação.
4. Se for localizado um elemento que corresponda ao nome do elemento de alimentação, mas não seu
tipo de dado, o Web Content Integrator removerá o campo antigo da área de site ou item de conteúdo
e tentará substituí-lo por um novo campo que corresponda ao tipo de dado especificado na
alimentação.
5. Se nenhum campo correspondente puder ser localizado no conteúdo, o Web Content Integrator
tentará criar um novo elemento.
2.
Nota: Ao criar elementos no Web Content Manager usando um portlet de autoria, é possível especificar
vários critérios de validação de campo como o tamanho máximo de um campo de texto ou o intervalo
permitido de um campo de data. Eles são validados durante a operação de salvamento. Se os dados no
campo não atenderem os critérios de validação, a operação de salvamento inteira falhará, significando
que nenhuma das mudanças na entrada da alimentação será aplicada. O Web Content Integrator não tem
a capacidade de verificar se os dados no elemento de alimentação são válidos antes de tentar a operação
de salvamento. Portanto, se você escolher implementar validações em seus modelos de autoria, é
importante para o produtor de alimentação garantir que o conteúdo seja válido durante a geração da
alimentação.
Elemento de Texto
Tabela 90. Elemento text
Áreas de site e itens de conteúdo
Nenhum.
Valores Permitidos
Um componente de texto deve conter um valor de texto
simples.
Atributos Opcionais
name
O valor deste atributo deve corresponder ao
nome de um elemento de texto existente em
uma área de site ou item de conteúdo.
Nenhum
type
O valor deste subelemento deve ser "text". Este
valor não faz distinção entre maiúsculas e
minúsculas.
value
O valor deste subelemento deve ser texto
simples.
Nenhum
Por exemplo:
<ibmwcm:element name="Headline">
<ibmwcm:type>text</ibmwcm:type>
<ibmwcm:value>Novo Produto Liberado</ibmwcm:value>
</ibmwcm:element>
Elemento HTML
Tabela 91. Elemento HTML
Componentes HTML, áreas de site e itens de conteúdo
278
Tabela 91. Elemento HTML (continuação)
Componentes HTML.
Valores Permitidos
O valor do subelemento de valor deve ser HTML, que
será armazenado no elemento HTML correspondente. O
HTML pode ser codificado por entidade ou estar contido
em um elemento CDATA. Alternativamente, o produtor
da alimentação pode fornecer uma URL a um arquivo
HTML cujo conteúdo será recuperado pelo Web Content
Integrator
Atributos Opcionais
name
nome de um elemento HTML existente em uma
área de site ou item de conteúdo.
Nenhum
type
O valor deste subelemento deve ser "html".
value
Usado ao incluir marcação HTML que é
codificada pela entidade ou está contida em um
elemento CDATA.
source
Usado com uma URL completa para um
arquivo HTML. Quando o Web Content
Integrator processar a alimentação, ele
recuperará o arquivo e armazenará seu
conteúdo no elemento HTML na área de site ou
item de conteúdo.
Nenhum
Exemplos:
<ibmwcm:element name="footer">
<ibmwcm:type>html</ibmwcm:type>
<ibmwcm:value>
<strong>Copyright 2006</strong>
</ibmwcm:value>
</ibmwcm:element>
<ibmwcm:value>
<![CDATA[<strong>Copyright 2006</strong>]]>
</ibmwcm:value>
</ibmwcm:element>
<ibmwcm:source>
http://sourcecms.yourco.com/pages/footer.htm
</ibmwcm:source>
</ibmwcm:element>
Elemento Rich Text
Tabela 92. Elemento Rich Text
279
Tabela 92. Elemento Rich Text (continuação)
Nenhum
Valores Permitidos
O valor do subelemento de valor deve ser HTML, que
será armazenado no elemento de rich text
correspondente. O HTML pode ser codificado por
entidade ou estar contido em um elemento CDATA.
Atributos Opcionais
name
nome de um elemento de rich text existente em
Nenhum
type
O valor deste subelemento deve ser "rich text".
Estes valores não fazem distinção entre
maiúsculas e minúsculas.
value
O valor deste subelemento deve ser marcação
HTML que é codificada por entidade ou está
contida em um elemento CDATA.
Nenhum
Exemplos:
<ibmwcm:element name="body">
<ibmwcm:type>rich text</ibmwcm:type>
<ibmwcm:value>
&ltp>Este é o conteúdo&ltp/p>
</ibmwcm:value>
</ibmwcm:element>
<ibmwcm:element name="body">
<ibmwcm:value>
<![CDATA[<p>Este é o conteúdo</p>]]>
</ibmwcm:value>
</ibmwcm:element>
Elemento de Recurso do Arquivo
Tabela 93. Elemento de Recurso do Arquivo
Componentes de recurso do arquivo, áreas de site e itens
de conteúdo
Componentes do recurso do arquivo.
Valores Permitidos
O valor deve ser uma URL completa que aponta para o
arquivo binário que deve ser transferido por upload no
elemento do recurso do arquivo.
Atributos Opcionais
280
name
Nenhum
nome de um elemento de recurso do arquivo
existente em uma área de site ou item de
conteúdo.
Tabela 93. Elemento de Recurso do Arquivo (continuação)
type
O valor deste subelemento deve ser "file". Estes
valores não fazem distinção entre maiúsculas e
minúsculas.
source
O valor deve ser uma URL completa que aponta
para o arquivo binário que deve ser transferido
por upload em um elemento do recurso do
arquivo.
Nota: Se a URL contiver caracteres não ascii,
eles deverão ser codificados. Por exemplo:
http://server:port/wps/wcm/%E4%B8%AD
%E6%96%87/%E7%BB%84%E4%BB%B6.pdf
fileName
O valor deste subelemento deve ser o nome do
arquivo e extensão a serem aplicados ao anexo
do arquivo quando incluído no elemento de
recurso do arquivo. Se este subelemento estiver
presente na entrada de alimentação, este valor
será usado como o nome do arquivo do anexo
no Web Content Manager, independentemente
de qual era o nome do arquivo no servidor de
origem. Isto é útil se a URL para o arquivo
binário não incluir o nome do arquivo como é o
caso com alguns sistemas de gerenciamento de
conteúdo. Se o subelemento fileName não
estiver presente na alimentação, o Web Content
Integrator tentará determinar o nome do
arquivo a partir da URL no subelemento do
valor utilizando todos os caracteres após a
última barra na URL.
Exemplos:
<ibmwcm:element name="attachment">
<ibmwcm:type>file</ibmwcm:type>
<ibmwcm:source>
http://sourcecms.yourco.com/files/plan.doc
</ibmwcm:source>
</ibmwcm:element>
<ibmwcm:element name="attachment">
<ibmwcm:source>
http://sourcecms.yourco.com/files/plan.doc
</ibmwcm:source>
<ibmwcm:fileName>MktgPlan.doc</ibmwcm:fileName>
</ibmwcm:element>
Elemento de Imagem
Tabela 94. Elemento de Imagem
Componentes de imagem, áreas de site e itens de
conteúdo
Componentes da imagem.
281
Tabela 94. Elemento de Imagem (continuação)
Valores Permitidos
O valor deve ser uma URL completa que aponta para o
arquivo binário que deve ser transferido por upload no
elemento de imagem.
Atributos Opcionais
Exemplos:
<ibmwcm:element name="image">
<ibmwcm:type>image</ibmwcm:type>
<ibmwcm:source>
http://sourcecms.yourco.com/images/logo.gif
</ibmwcm:source>
</ibmwcm:element>
<ibmwcm:element name="image">
<ibmwcm:source>
http://sourcecms.yourco.com/images/logo.gif
</ibmwcm:source>
<ibmwcm:fileName>yourco_logo.doc</ibmwcm:fileName>
</ibmwcm:element>
282
name
nome de um elemento de imagem existente em
Nenhum
type
O valor deste subelemento deve ser "image".
Estes valores não fazem distinção entre
source
O valor deve ser uma URL completa que aponta
para o arquivo binário que deve ser transferido
por upload em um elemento de imagem.
Nota: Se a URL contiver caracteres não ascii,
eles deverão ser codificados. Por exemplo:
http://server:port/wps/wcm/%E4%B8%AD
%E6%96%87/%E7%BB%84%E4%BB%B6.jpg
fileName
O valor deste subelemento deve ser o nome do
arquivo e extensão a serem aplicados ao anexo
do arquivo quando incluído no elemento de
imagem. Se este subelemento estiver presente na
entrada de alimentação, este valor será usado
como o nome do arquivo do anexo no Web
Content Manager, independentemente de qual
era o nome do arquivo no servidor de origem.
Isto é útil se a URL para o arquivo binário não
incluir o nome do arquivo como é o caso com
alguns sistemas de gerenciamento de conteúdo.
Se o subelemento fileName não estiver presente
na alimentação, o Web Content Integrator
tentará determinar o nome do arquivo a partir
da URL no subelemento do valor utilizando
todos os caracteres após a última barra na URL.
Elemento Date
Tabela 95. Elemento date
Componentes de data e hora, áreas de site e itens de
conteúdo
Componentes de data e hora.
Valores Permitidos
Um valor de data ou hora a ser armazenado em um
elemento de data e hora.
Atributos Opcionais
name
nome de um elemento de data e hora existente
em uma área de site ou item de conteúdo.
Nenhum
type
O valor deste subelemento deve ser "date". Este
minúsculas.
value
O valor deste subelemento deve ser um valor de
data e hora no formato RFC 822.
format Isto permite que o produtor de alimentação
especifique o formato da data ou hora. Um
valor igual a "date" fará com que o elemento de
data e hora seja configurado para exibir somente
a parte da data dos dados. Da mesma maneira,
um valor igual a "time" exibirá apenas a parte
da hora dos dados. Qualquer outro valor, ou a
ausência deste subelemento, resultará em ambas
as partes dos dados sendo exibidas. Os valores
para este subelemento não fazem distinção entre
Por exemplo:
<ibmwcm:element name="StartDate">
<ibmwcm:type>date</ibmwcm:type>
<ibmwcm:value>
Quinta-feira, 14 de abril de 1966 15:15:00 EDT
</ibmwcm:value>
<ibmwcm:format>date</ibmwcm:format>
</ibmwcm:element>
Elemento de Link
Tabela 96. Elemento link
Componentes de link, áreas de site e itens de conteúdo
Componentes de link.
Valores Permitidos
Este componente contém as informações que são
necessárias para configurar um elemento de link. Há
vários subelementos opcionais que podem ser usados
para configurar os vários parâmetros do campo Link.
283
Tabela 96. Elemento link (continuação)
Atributos Opcionais
name
nome de um elemento de link existente em uma
área de site ou item de conteúdo.
Nenhum
type
O valor desse subelemento deve ser "link". Este
minúsculas.
format
v ExternalLink: cria um link para uma URL
externa ao seu sistema Web Content Manager.
v ManagedContent: cria um link para outro
item do Web Content Manager.
v ExistingLink: cria um link para um
componente de link pré-existente
value
O valor deste subelemento depende do que foi
especificado no subelemento "format":
v ExternalLink: uma URL.
v ManagedContent: o GUID de um item do
Web Content Manager existente.
v ExistingLink: o GUID de um componente de
link existente.
284
Tabela 96. Elemento link (continuação)
linkText
Este subelemento permite que o produtor de
alimentação especifique o que será renderizado
entre as partes <a href=""> e </a> da tag
âncora. Os valores possíveis incluem:
v uma cadeia de texto simples
v uma cadeia de marcação HTML que é
codificada pela entidade ou está contida em
uma tag CDATA
v o GUID de uma entrada de alimentação que
descreve um componente de imagem
Um atributo de tipo necessário indica quais dos
tipos de valores anteriores usar. Ele pode ser
configurado como "text", "html" ou
"imageGuid".
Se o subelemento linkText não estiver incluído
na alimentação, o padrão de texto do link será o
valor configurado em "ExternalLink",
"ManagedContent" ou "ExistingLink".
linkDescription
Este subelemento fornece um mecanismo para
especificar uma descrição para o elemento do
link. Se este subelemento não estiver presente, a
descrição no elemento de link assumirá por
padrão o valor da descrição da área de site ou
item de conteúdo.
linkTarget
O subelemento é usado para configurar a janela
do navegador de destino na qual o link será
exibido quando for clicado. Os valores
permitidos são: "none", "_blank", "_top", "_self",
"_parent" e "{NEW_WINDOW_NAME}". Se este
elemento não estiver presente na alimentação, o
destino do link será padronizado como "none",
significando que o link será aberto na mesma
janela do navegador que a página que a contém.
queryString
Se presente, o valor deste subelemento será
anexado ao HREF gerado do link. Este valor
deve ser encapsulado em uma tag CDATA para
evitar problemas de análise.
additionalAttributes
O valor deste subelemento será inserido na tag
<a> como atributos HTML adicionais.
allowClear
Este subelemento controla se o valor no
elemento do link pode ser excluído. Ele deve ser
configurado como "true" ou "false". Seu padrão
será "true" se este elemento não estiver presente
na alimentação.
285
Link Simples para a URL Externa para o IBM.com
<ibmwcm:element name="Link">
<ibmwcm:type>link</ibmwcm:type>
<ibmwcm:value>http://www.ibm.com</ibmwcm:value>
<ibmwcm:format>ExternalLink</ibmwcm:format>
<ibmwcm:linkText type="text">IBM</ibmwcm:linkText>
</ibmwcm:element>
Link expandido para a URL externa para o IBM.com
<ibmwcm:value>http://www.ibm.com/search</ibmwcm:value>
<ibmwcm:format>ExternalLink</ibmwcm:format>
<ibmwcm:linkText type="text">Recursos de Formato de Alimentação RSS</ibmwcm:linkText>
<ibmwcm:linkDescription>Procura pelo Formato de Alimentação RSS</ibmwcm:linkDescription>
<ibmwcm:queryString><![CDATA[?q=rss+feed+format]]></ibmwcm:queryString>
<ibmwcm:linkTarget>_blank</ibmwcm:linkTarget>
<ibmwcm:additionalAttributes>class="extLink"</ibmwcm:additionalAttributes>
</ibmwcm:element>
Link simples para um componente de recurso do arquivo
<ibmwcm:value>63000001</ibmwcm:value>
<ibmwcm:format>ManagedContent</ibmwcm:format>
<ibmwcm:linkText type="imageGuid">290df293e20a</ibmwcm:linkText>
<ibmwcm:allowClear>true</ibmwcm:allowClear>
</ibmwcm:element>
Link Simples para outro item de conteúdo
<ibmwcm:format>ManagedContent</ibmwcm:format>
<ibmwcm:linkText type="html"><![CDATA[<b>Marketing Plan</b>]]></ibmwcm:linkText>
</ibmwcm:element>
Elemento de Número
Tabela 97. Elemento Número
Componentes de número, áreas de site e itens de
conteúdo
Componentes de número.
Valores Permitidos
Um valor numérico a ser armazenado em um elemento
de número.
Atributos Opcionais
286
name
nome de um elemento de número existente em
Nenhum
type
O valor deste subelemento deve ser "number".
Este valor não faz distinção entre maiúsculas e
minúsculas.
value
Um valor numérico a ser armazenado em um
elemento de número.
Tabela 97. Elemento Número (continuação)
format Isto permite que o produtor de alimentação
especifique o formato para o elemento de
número. Por exemplo, se um valor igual a
"integer" for especificado, apenas os dados no
formato de números inteiros serão importados.
Por exemplo:
<ibmwcm:element name="FileSize">
<ibmwcm:type>number</ibmwcm:type>
<ibmwcm:format>integer</ibmwcm:format>
</ibmwcm:element>
Elemento de Seleção de Opção
Tabela 98. Elemento de Seleção de Opção
Nenhum
Valores Permitidos
Este componente contém uma lista de valores que serão
configurados como as opções selecionadas em um
elemento de seleção de opção.
Atributos Opcionais
name
nome de um elemento de seleção de opção
conteúdo.
Nenhum
type
O valor deste subelemento deve ser "option".
minúsculas.
287
Tabela 98. Elemento de Seleção de Opção (continuação)
optionType
Isso é usado para definir o tipo de elemento de
seleção de opção.
v Especifique user ao referenciar de uma lista
de opções definidas pelo usuário.
v Especifique taxonomy ao referenciar opções de
uma taxonomia existente.
Só é possível especificar um tipo de opção por
elemento de seleção de opção. Se nenhum tipo
de opção for definido, "usuário" será usado por
padrão.
selectedCategory
Isso é usado com o tipo de opção "taxonomia" e
é usado para especificar o caminho para uma
categoria que você deseja usar no elemento de
seleção de opção. É possível usar quantos
elementos selectedCategory forem necessários.
Se a taxonomia existir em uma biblioteca
diferente do elemento de seleção de opção, será
possível também especificar o nome da
biblioteca. Exemplo:
<ibmwcm:selectedCategory library="shared">
Days/Monday</ibmwcm:selectedCategory>
Você deve especificar o nome de cada categoria
e taxonomia que deseja referenciar. Se elas não
existirem, serão criadas quando o feed for
processado.
selectedOption
Isso é usado com o tipo de opção "usuário" e é
usado para especificar uma lista de opções
definidas pelo usuário. É possível usar quantos
elementos selectedOption forem necessários.
Exemplo 1:
Selecionando uma única categoria em que a categoria esteja na mesma biblioteca que o item.
Neste exemplo, "Days" é o nome de uma taxonomia e "Monday" é o nome de uma categoria.
<ibmwcm:element name="DayOfTheWeek">
<ibmwcm:type>option</ibmwcm:type>
<ibmwcm:optionType>taxonomy</ibmwcm:optionType>
<ibmwcm:selectedCategory>Days/Monday</ibmwcm:selectedCategory>
</ibmwcm:element>
Exemplo 2:
Selecionando diversas categorias em que as categorias estejam na mesma biblioteca que o item.
<ibmwcm:selectedCategory>Days/Monday</ibmwcm:selectedCategory>
<ibmwcm:selectedCategory>Days/Tuesday</ibmwcm:selectedCategory>
< ;/ibmwcm:element>
Exemplo 3:
Selecionando uma única categoria em que a categoria esteja em uma biblioteca diferente do item.
288
<ibmwcm:selectedCategory library="shared">Days/Monday</ibmwcm:selectedCategory>
</ibmwcm:element>
Exemplo 4:
Selecionando uma opção definida pelo usuário. Neste exemplo, "False" é uma opção definida por
um usuário no Modelo de Autoria para um item.
<ibmwcm:element name="Enable">
<ibmwcm:optionType>user</ibmwcm:optionType>
<ibmwcm:selectedOption>False</ibmwcm:selectedOption>
</ibmwcm:element>
Elemento de Referência de Componente
Tabela 99. Elemento de Referência de Componente
Nenhum
Valores Permitidos
Este componente contém o GUID de um componente.
Atributos Opcionais
name
nome de um elemento de referência de
componente existente em uma área de site ou
item de conteúdo.
Nenhum
type
O valor deste subelemento deve ser "reference".
minúsculas.
value
Este componente contém o GUID de um
componente.
Nenhum
Por exemplo:
<ibmwcm:element name="Footer">
<ibmwcm:type>reference</ibmwcm:type>
<ibmwcm:value>29bc2daf3289</ibmwcm:value>
</ibmwcm:element>
Elemento de Seleção de Usuário
Tabela 100. Elemento de Seleção de Usuário
Componentes de seleção de usuário, áreas de site e itens
de conteúdo
Componentes de seleção de usuário.
Valores Permitidos
Uma lista de nomes de usuários a serem selecionados em
um elemento de seleção de usuário.
289
Tabela 100. Elemento de Seleção de Usuário (continuação)
Atributos Opcionais
name
nome de um elemento de seleção de usuário
conteúdo.
Nenhum
type
O valor deste subelemento deve ser "userSelect".
minúsculas.
value
O valor deste subelemento deve ser uma lista
separada por vírgula de nomes de usuários.
Quando processado, o Web Content Integrator
tentará resolver cada nome para um usuário do
portal válido. Se um nome não puder ser
resolvido, ele será ignorado.
Nenhum
Por exemplo:
<ibmwcm:element name="Users">
<ibmwcm:type>userSelect</ibmwcm:type>
<ibmwcm:value>wpsadmin,John Smith</ibmwcm:value>
</ibmwcm:element>
Elemento de Folha de Estilo
Tabela 101. Elemento de Folha de Estilo
Componentes de folha de estilo
Componentes de folha de estilo
Valores Permitidos
Uma URL que aponta para um arquivo CSS que será
transferido por upload para um componente de folha de
estilo.
Nenhum
Atributos Opcionais
Nenhum
290
type
O valor deste subelemento deve ser "styleSheet".
minúsculas.
source
Uma URL que aponta para um arquivo CSS que
será transferido por upload para o componente
da folha de estilo.
Tabela 101. Elemento de Folha de Estilo (continuação)
format Este subelemento é usado para especificar o tipo
da folha de estilo. As opções válidas são:
"preferred", "alternate" e "persistent". Se esse
subelemento não estiver presente na
alimentação, ou se algum valor diferente dos
valores anteriores for especificado, o tipo será
padronizado como "preferencial".
mediaType
Este subelemento especifica o tipo de mídia da
folha de estilo. Os valores válidos são: "all",
"aural", "braille", "handheld", "print",
"projection", "screen", "tty", "tv" e "unspecified".
Se o subelemento mediaType não estiver
presente na alimentação, ou se algum valor
diferente dos valores anteriores for especificado,
o tipo de mídia será padronizado como "não
especificado".
cssTitle
O valor deste subelemento deve ser uma cadeia
que será configurada como o valor do atributo
de título quando o link para o arquivo CSS for
renderizado.
Por exemplo:
<ibmwcm:element name="cssFile">
<ibmwcm:type>styleSheet</ibmwcm:type>
<ibmwcm:source>http://www.yourco.com/styles/news.css</ibmwcm:source>
<ibmwcm:format>alternate</ibmwcm:format>
<ibmwcm:mediaType>print</ibmwcm:mediaType>
</ibmwcm:element>
Elementos de Controle do Fluxo de Trabalho:
Os elementos de fluxo de trabalho permitem que você especifique parâmetros relacionados ao fluxo de
trabalho ao criar itens de conteúdo que usam um fluxo de trabalho.
Elemento Workflow
Este elemento especifica o nome do fluxo de trabalho e estágio no qual um item de conteúdo deve ser
criado. O valor no atributo de nome deve corresponder àquele de um fluxo de trabalho existente.
Se o fluxo de trabalho estiver localizado em uma biblioteca diferente do item de conteúdo, você poderá
especificar o nome da biblioteca também. Se nenhuma biblioteca for especificada, o Web Content
Integrator procurará a biblioteca que foi especificada no elemento <ibmwcm:library>. Se nenhum
elemento <ibmwcm:library> estiver presente, o Web Content Integrator procurará a biblioteca padrão
especificada na configuração da tarefa.
Tabela 102. Elemento workflow
Itens de conteúdo
Nenhum
291
Tabela 102. Elemento workflow (continuação)
Valores Permitidos
Nome do fluxo de trabalho e estágio do fluxo de
trabalho relacionado.
O nome de um fluxo de trabalho existente ou a
biblioteca e nome de uma biblioteca e fluxo de trabalho
existentes separados por uma barra. Por exemplo:
v 3-Stage-Workflow
v Library1/3-Stage-Workflow
Atributos Opcionais
Nenhum
workflowStage
O valor deste subelemento deve ser o nome de
um estágio do fluxo de trabalho que está
incluído no fluxo de trabalho nomeado.
Nenhum
Exemplos:
<ibmwcm:workflow name="StdWorkflow">
<ibmwcm:workflowStage>Live</ibmwcm:workflowStage>
</ibmwcm:workflow>
<ibmwcm:workflow name="DesignLib/StdWorkflow">
</ibmwcm:workflow>
Elementos Date
Este elemento é usado para especificar uma data formatada RFC 822 que será usada como a data de um
dos campos de data no item de conteúdo.
Tabela 103. Elementos Date
Itens de conteúdo
Nenhum
292
Tabela 103. Elementos Date (continuação)
Valores Permitidos
publishDate
Usado para configurar a data publicada de um
item. Se este elemento não estiver presente no
<item>, o valor no elemento <pubDate> será
usado para configurar a data de publicação do
item de conteúdo. Isto requer que uma ação de
publicação tenha sido incluída em um estágio
do fluxo de trabalho no fluxo de trabalho
especificado.
expirationDate
Usado para configurar a data de expiração de
um item. Isto requer que uma ação de expiração
tenha sido incluída em um estágio do fluxo de
trabalho no fluxo de trabalho especificado.
genDateOne e genDateTwo
Usados para preencher os campos de data
gerais de um item.
Uma data formatada do RFC 822.
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Exemplos:
<ibmwcm:publishDate>
Sexta-feira, 31 de outubro de 2008 15:32:00 EST
</ibmwcm:publishDate>
<ibmwcm:expirationDate>
Domingo, 1 de novembro de 2009 12:00:00 EST
</ibmwcm:expirationDate>
<ibmwcm:genDateOne>
Quarta-feira, 1 de novembro de 2006 09:30:00 EST
</ibmwcm:genDateOne>
<ibmwcm:genDateTwo>
Quinta-feira, 2 de novembro de 2006 09:30:00 EST
</ibmwcm:genDateTwo>
Elemento additionalViewer
Este elemento permite que o campo de visualizadores adicionais seja preenchido através da alimentação.
Ele deve conter o nome comum de um único usuário ou grupo que deve ser incluído no campo. Para
especificar múltiplos usuários e grupos, use múltiplos elementos additionalViewer.
Tabela 104. Elemento additionalViewer
Itens de conteúdo
293
Tabela 104. Elemento additionalViewer (continuação)
Nenhum
Valores Permitidos
v [todos os usuários]
v [todos os usuários autenticados do portal]
v O nome comum de qualquer usuário ou grupo de
portal válido.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Exemplos:
<ibmwcm:additionalViewer>[all users]</ibmwcm:additionalViewer>
<ibmwcm:additionalViewer>Sales</ibmwcm:additionalViewer>
<ibmwcm:additionalViewer>jsmith</ibmwcm:additionalViewer>
Elementos de Controle de Segurança:
O elemento de controle de segurança é usado para configurar controles de acesso no item que está sendo
criado.
Elemento access
O elemento access fornece um mecanismo para configurar os controles de acesso nos itens do Web
Content Manager através da alimentação. Uma entrada de alimentação pode conter múltiplos
subelementos de acesso. Cada elemento de acesso deve conter o nome comum de um único usuário ou
grupo de portal válido. Os usuários e grupos especificados no elemento de acesso são incluídos nos
campos de segurança definidos pelo sistema nos itens do Web Content Manager.
Tabela 105. Elemento access
Conteúdo
Nenhum
Valores Permitidos
v [todos os usuários]
v [todos os usuários autenticados do portal]
v O nome comum de qualquer usuário ou grupo de
portal válido.
294
Nenhum
Tabela 105. Elemento access (continuação)
Atributos Opcionais
type
Este atributo permite que o produtor de
alimentação especifique o nível de acesso exato
que deve ser concedido ao usuário ou grupo. Os
valores permitidos para o atributo de tipo
correspondem aos níveis de acesso disponíveis
no Web Content Manager: "user", "contributor",
"editor" e "manager". Se o atributo de tipo não
for especificado, o acesso "user" será aplicado.
herança
É possível especificar se a herança será ativada
ou desativada incluindo inheritance="enabled"
ou inheritance="disabled". Se não for
especificada, será usada a configuração de
herança padrão ou atual de um item.
Nenhum
Exemplos:
<ibmwcm:access type="user">
</ibmwcm:access>
<ibmwcm:access type="editor" inheritance="enabled">
Sales
</ibmwcm:access>
Elemento de Controle de Associação:
O elemento de associação é usado para criar uma associação entre dois ou mais itens de conteúdo
separados. Ele é usado para suportar alguns relacionamentos de itens de conteúdo que não são nativos
no Web Content Manager, mas que são localizados em alguns outros sistemas de gerenciamento de
conteúdo da web. Um exemplo seria um artigo técnico de diário que precisa incluir alguns dados de um
ou mais itens de conteúdo de biografia de autor.
Um elemento de associação está ligado a um elemento de texto. O valor do elemento na associação é uma
lista delimitada por vírgula de GUIDs que representam os outros itens de conteúdo externos que serão
associados ao elemento de texto. Quando o Web Content Integrator processar a alimentação, ele tentará
resolver os GUIDs com os itens do Web Content Manager correspondentes. Um componente JSP
customizado é usado, então, no modelo de apresentação para localizar os itens de conteúdo vinculados
no momento da renderização e exibi-los no contexto do item de conteúdo do contêiner.
Como esse tipo de ligação não é um recurso natural do Web Content Manager, ele depende de um
componente JSP customizado para sua implementação e há algumas restrições relacionadas ao uso de um
elemento de associação:
v Como os DocumentIds do Web Content Manager são usados para criar a associação com os outros
itens de conteúdo, não é garantido que o formato do DocumentId seja constante de versão para versão,
portanto, há algum risco de que as ligações sejam quebradas após um upgrade ou migração do Web
Content Manager
v A integridade referencial do Web Content Manager não se aplica a links de elementos de associação.
295
Tabela 106. Elemento de Associação
Conteúdo
Nenhuma
Valores Permitidos
Uma lista de GUIDs que são mapeados para outras
entradas de alimentação que estão vinculadas a itens de
conteúdo associados.
Atributos Opcionais
nome
O valor do atributo deve corresponde ao nome
de um elemento de texto existente.
Nenhuma
tipo
O valor desse subelemento deve ser
"association". Ele não faz distinção entre
value
O valor deste subelemento deve ser uma lista
delimitada por vírgula de GUIDs que apontam
para as entradas de alimentação que estão
vinculadas a itens de conteúdo associados.
Nenhuma
Por exemplo:
<ibmwcm:element name="authors">
<ibmwcm:type>association</ibmwcm:type>
<ibmwcm:value>234ed298cf,7023bc23f1e</ibmwcm:value>
</ibmwcm:element>
Manipulando Links Integrados
De tempos em tempos, o conteúdo que está sendo recuperado pelo Web Content Integrator conterá links
integrados para imagens, arquivos e outro conteúdo na alimentação. É possível usar a tag do link em sua
alimentação para representar links integrados de forma que eles sejam convertidos em links para outros
itens do Web Content Manager que são criados quando a alimentação é processada.
Há três tipos de links integrados que podem ser processados: imagens, arquivos e conteúdo. Em todos os
casos, a tag do link deve incluir um GUID que aponta para outro item na alimentação que descreve o
item de destino.
Links de Conteúdo
Neste exemplo, o seguinte conteúdo de alimentação contém um link para outra página da Web:
<p>
<a href="http://cmsserver.ibm.com/news/one.htm">Press Release</a>
</p>
Para assegurar que o link integrado seja convertido em um link para um item de conteúdo relacionado
que está sendo criado quando a alimentação é processada, inclua o código a seguir em sua alimentação.
Ele contém um GUID para o arquivo HTML que também está sendo processado pelo Web Content
Integrator:
<![CDATA[<p>
<a href=’<link type="content" guid="80000002"/>’>Press Release</a>
Eis algum texto.
</p>]]>
296
Quando o conteúdo da alimentação é salvo no Web Content Manager, um link para um item de conteúdo
é incluído no conteúdo.
<p>
<a href="wps/wcm/myconnect/Portal/Press/Announcement1?contentIDR=29e04295034efb">Press Release</a>
Eis algum texto.
</p>
Feed de Exemplo
<channel>
<item>
<description>
</description>
<guid>80000001</guid>
<ibmwcm:action>add</ibmwcm:action>
<ibmwcm:path>/Portal/News</ibmwcm:path>
<ibmwcm:workflow name="Std Workflow">
</ibmwcm:workflow>
<ibmwcm:component name="BODY">
<ibmwcm:value>
<![CDATA[<p>
<a href=’<link type="content" guid="80000002" />’>um link de conteúdo</a>
Eis algum texto.
</p>]]>
</ibmwcm:value>
</ibmwcm:component>
</item>
<item>
<title>Announcment1</title>
<link>http://cmsserver.ibm.com/news/one.htm</link>
<description>Este é um press release de anúncio.</description>
<guid>80000002</guid>
<ibmwcm:authoringTemplate>Press Release</ibmwcm:authoringTemplate>
<ibmwcm:path>/Portal/Press</ibmwcm:path>
</ibmwcm:workflow>
<ibmwcm:value>Eis mais algum texto.</ibmwcm:value>
</ibmwcm:component>
</item>
</channel>
</rss>
Links de Arquivo
Neste exemplo, o conteúdo de alimentação a seguir contém um link para um arquivo PDF:
297
<p>
<a href="http://cmsserver.ibm.com/files/spec.pdf">Product Spec</a>
Eis algum texto.
</p>
Para assegurar que o link integrado seja convertido em um link para um componente do recurso do
arquivo relacionado que está sendo criado quando a alimentação é processada, inclua o código a seguir
em sua alimentação. Ele contém um GUID para o arquivo PDF que também está sendo processado pelo
Web Content Integrator:
<![CDATA[<p>
<a href=’<link type="file" guid="50000002"/>’>Especificação do Produto</a>
Eis algum texto.
</p>]]>
Quando o conteúdo da alimentação é salvo no Web Content Manager, uma tag do componente é incluída
no conteúdo.
<p>
<a href="<Component name="ProductSpec" />">Product Spec</a>
Eis algum texto.
</p>
Feed de Exemplo
<channel>
<item>
<description>
</description>
<guid>80000001</guid>
</ibmwcm:workflow>
<ibmwcm:value>
<![CDATA[<p>
<a href="<link type="file" guid="50000002" />">some file link</a>
Eis algum texto.
</p>]]>
</ibmwcm:value>
</ibmwcm:component>
</item>
<item>
<title>Product Spec</title>
<link>http://cmsserver.ibm.com/files/spec.pdf</link>
<description>Este é o documento do produto spec.</description>
<guid>50000002</guid><ibmwcm:action>add</ibmwcm:action>
<ibmwcm:component name="File">
298
<ibmwcm:value>
http://cmsserver.ibm.com/files/spec.pdf
</ibmwcm:value>
</ibmwcm:component>
</item>
</channel>
</rss>
Links de Imagem
Neste exemplo, o conteúdo de alimentação a seguir contém um link para um arquivo de imagem:
<p>
<img src="http://cmsserver.ibm.com/images/mylogo.gif" />
Eis algum texto.
</p>
Para assegurar que o link de imagem integrado seja convertido em um link para um componente de
imagem relacionado que está sendo criado quando a alimentação é processada, inclua o código a seguir
em sua alimentação. Ele contém um GUID para o arquivo de imagem que também está sendo processado
pelo Web Content Integrator:
<![CDATA[<p>
<link type=“image“ guid=“50000001“ />
Eis algum texto.
</p>]]>
Quando o conteúdo da alimentação é salvo no Web Content Manager, uma tag do componente é incluída
no conteúdo.
<p>
<Component name="My Logo" />
Eis algum texto.
</p>
Feed de Exemplo
<channel>
<item>
<description>
</description>
<guid>80000001</guid>
</ibmwcm:workflow>
<ibmwcm:value>
<![CDATA[<p>
<link type="image" guid="50000001" />
Eis algum texto.
299
</p>]]>
</ibmwcm:value>
</ibmwcm:component>
</item>
<item>
<title>Meu Logotipo</title>
<link>http://cmsserver.ibm.com/images/mylogo.gif</link>
<description>Esta é a nossa imagem de logotipo.</description>
<guid>50000001</guid><ibmwcm:action>add</ibmwcm:action>
<ibmwcm:component name="Image">
<ibmwcm:value>
http://cmsserver.ibm.com/images/mylogo.gif
</ibmwcm:value>
</ibmwcm:component>
</item>
</channel>
</rss>
Processamento da Tag de Imagem Automático
O Web Content Integrator possui um recurso opcional que pode ser usado no lugar da tag <link
type="image" />. Se ativado, o Web Content Integrator analisará automaticamente os valores de qualquer
elemento html ou rich text e procurará tags HTML <img/> integradas no conteúdo. Se qualquer um for
localizado, o Web Content Integrator tentará recuperar o arquivo de imagem referenciado, criar um
componente de imagem e, em seguida, regravar a referência para que ela aponte para o novo
componente de imagem.
Este recurso pode ser ativado editando a configuração de disable.img.proc no arquivo
WCMConsumerPlugin.properties e configurando-o como "false". O processamento de tag de imagem
automático é desativado por padrão.
Se ativado:
v apenas o conteúdo que está sendo importado nos elementos e componentes HTML ou elementos e
componentes Rich Text serão processados.
v todas as referências de imagem correspondentes ao padrão “<img src= ..." são processadas. As
referências de imagem que estão incluídas no código Javascript ou estilos CSS não serão processadas.
v as URLs especificadas nos atributos "src" dessas tags de imagem são convertidas em URLs completas
usando outras informações sobre o item de conteúdo na alimentação. Os links relativos devem ser
relativos à URL no elemento <link> da alimentação seguindo as regras padrão para links relativos.
v os arquivos de imagem são armazenados como componentes de imagem compartilhada. Os controles
de acesso no componente de imagem são configurados para corresponder àqueles do item de conteúdo
que eles referenciam. O nome do componente de imagem será baseado no caminho relativo ao servidor
na imagem. Por exemplo, uma imagem localizada em http://<host_name>/resources/images/
sm_logo.gif será denominada resources.images.sm_logo.gif.
Processando Imagens
O Web Content Integrator possui um recurso de processamento de imagens que permite que as imagens
referenciadas nos elementos de HTML e de rich text sejam criados como componentes da imagem
durante o processamento de uma alimentação.
Configuração do Processamento de Imagens
Os parâmetros a seguir podem ser configurados no serviço WCM WCMConfigService usando o WebSphere
Integrated Solutions Console:
300
Ativar e desativar o processamento de imagens
Por padrão, o processamento de imagens está ativado. Para desativar o processamento de
imagens, configure a propriedade: disable.img.processing=true
Ativar e desativar imagens de rich text integradas
As imagens podem ser integradas diretamente nos elementos de rich text em vez de primeiro
criar um componente da imagem. Essa funcionalidade faz com que as imagens dos elementos de
rich text consumidas pelo Web Content Integrator sejam processadas de forma idêntica nas
imagens incluídas nos elementos de rich text na UI de autoria. Por padrão, as imagens de rich
text integradas estão desativadas. Para ativá-las, configure as propriedades:
v disable.img.processing=false
v richtext.embedded.images.enabled=true
Usando URLs de Origem da Imagem Absoluta
As imagens nos elementos de HTML e de rich text podem ser especificadas usando URLs de HTTP
absolutas no atributo de origem da imagem. O Web Content Integrator processará URLs de origem da
imagem absoluta, conforme especificado na alimentação.
Exemplo de item de alimentação:
<item>
<title>RichText Component With Image 1</title>
<pubDate>Thu, 30 Mar 2011 16:00:00 EDT</pubDate>
<guid>Image_Example_1</guid>
<ibmwcm:itemType>Component</ibmwcm:itemType>
<ibmwcm:element>
<ibmwcm:value>
<![CDATA[
<p>Image 1:</p><img src="http://wci-feed-server/img/f/flower.jpg"/>
<p>Image 2:</p><img src="http://wci-feed-server/img/g/guitar.jpg"/>
]]>
</ibmwcm:value>
</ibmwcm:element>
</item>
Usando URLs de Origem da Imagem Relativa
As imagens nos elementos de HTML e de rich text podem ser especificadas usando URLs de HTTP
relativas no atributo de origem da imagem e uma URL base no elemento de link do item. O Web Content
Integrator processará URLs de origem da imagem relativa como uma concatenação do elemento de link
do item e atributos de origem da imagem no HTML.
<item>
<link>http://wci-feed-server</link>
<ibmwcm:element>
<ibmwcm:value>
<![CDATA[
<p>Image 1:</p><img src="/img/p/penguin.jpg"/>
<p>Image 2:</p><img src="/img/s/sunset.jpg"/>
301
]]>
</ibmwcm:value>
</ibmwcm:element>
</item>
Usando URLs de Origem das Imagens Absoluta e Relativa
As imagens nos elementos de HTML e de rich text podem ser especificadas usando uma combinação de
URLs de HTTP relativas e absolutas nos atributos de origem da imagem. O Web Content Integrator
processará URLs de origem da imagem relativa como uma concatenação do elemento de link do item e
atributos de origem da imagem no HTML. O Web Content Integrator processará URLs de origem da
imagem absoluta, conforme especificado na alimentação.
<item>
<link>http://wci-feed-server</link>
<ibmwcm:element>
<ibmwcm:value>
<![CDATA[
<p>Image 1:</p><img src="http://www.ibm.com/favicon.ico"/>
<p>Image 2:</p><img src="/img/f/fish.jpg"/>
<p>Image 3:</p><img src="/img/g/grapes.jpg"/>
]]>
</ibmwcm:value>
</ibmwcm:element>
</item>
Resultados Esperados – Componente de Rich Text
Exemplo de item de alimentação do componente de rich text:
<item>
<ibmwcm:element>
<ibmwcm:value>
<![CDATA[
<p>Image 1:</p><img src="http://wci-feed-server/img/l/leaf.jpg"/>
]]>
</ibmwcm:value>
</ibmwcm:element>
</item>
Componente de Rich Text com processamento da imagem desativado:
v Um componente de rich text chamado: “RichText Component With Image 4” é criado na
biblioteca de alimentação.
v Origem de HTML do Componente de rich text: <p>Image 1:</p><img src="http://wci-feedserver/img/l/leaf.jpg">
v O HTML de rich text não é modificado.
v A origem da imagem não é gerenciada, pois o Web Content Manager não pode detectar uma
origem da imagem quebrada.
302
Componente de Rich Text com processamento da imagem ativado:
v Um Componente da Imagem chamado “img.l.leaf.jpg” é criado na biblioteca de alimentação
v Origem de HTML do componente de rich text: <p>Image 1:</p><img src="/wps/wcm/
myconnect/[IMAGE COMPONENT ID]/leaf.jpg?MOD=AJPERES">
v A origem da imagem é substituída por uma URL que aponta para a imagem recém-criada.
v A origem da imagem é gerenciada por Web Content Manager e será atualizada à medida que o
componente da imagem é atualizado.
Componente Rich Text com imagens integradas ativadas:
v Origem de HTML do Componente de rich text: <p>Image 1:</p><img src="/wps/wcm/
myconnect/[RT COMPONENT UUID]/1/img.l.leaf.jpg?MOD=AJPERES">
v O HTML de rich text é modificado substituindo a origem da imagem por uma URL da imagem
integrada no Componente de rich text.
rich text é alterado.
Resultados Esperados – Componente de HTML
<item>
<title>HTML Component With Image 1</title>
<ibmwcm:element>
<ibmwcm:value>
<![CDATA[
<p>Image 1:</p><img src="http://wci-feed-server/img/l/leaf.jpg"/>
]]>
</ibmwcm:value>
</ibmwcm:element>
</item>
Elemento de HTML com processamento da imagem desativado
v O Componente de HTML chamado “HTML Component With Image 1” é criado na biblioteca
de alimentação.
v Origem de HTML do Componente de HTML: <p>Image 1:</p><img src="http://wci-feedserver/img/l/leaf.jpg"/>
v O HTML não é modificado.
v A origem da imagem não é gerenciada, pois o Web Content Manager não pode detectar uma
origem da imagem quebrada.
O elemento de HTML com processamento da imagem ativado
v O Componente de HTML chamado “HTML Component With Image 1” é criado na biblioteca
de alimentação.
v O Componente da Imagem chamado “img.l.leaf.jpg” é criado na biblioteca de alimentação
v Origem de HTML do Componente HTML: <p>Image 1:</p><img src="<Component id="[IMAGE
COMPONENT ID]" name="img test 1/img.l.leaf.jpg" format="url"/>"/>
303
v A origem da imagem é substituída por uma tag do componente que aponta para a imagem
recém-criada.
componente da imagem é atualizado.
Alimentações de Exemplo
Visualize algumas alimentações de exemplo que ilustram como representar os vários tipos de itens em
uma alimentação.
Nota: Se dados não ascii forem usados em uma alimentação, encoding="UTF-8" deverá ser especificado
na alimentação: <?xml version="1.0" encoding="UTF-8"?>
Alimentação da Área de Site
<channel>
<description>um exemplo de alimentação RSS</description>
<item>
<title>Notícias</title>
<link>http://www.ibm.com/news/index.htm</link>
<description>Esta é uma Área de Site.</description>
<guid>20000001</guid>
<author>[email protected]</author>
<ibmwcm:itemType>siteArea</ibmwcm:itemType>
<ibmwcm:path>/SiteAreaName</ibmwcm:path>
<ibmwcm:owner>jsample</ibmwcm:owner>
<ibmwcm:defaultContent>80000002</ibmwcm:defaultContent>
<ibmwcm:children>
<ibmwcm:childGuid>20000011</ibmwcm:childGuid>
</ibmwcm:children>
<ibmwcm:templateMap authoring="AT News" presentation="PT News" />
<ibmwcm:access type="user">[all users]</ibmwcm:access>
</item>
</channel>
</rss>
Alimentação da Taxonomia
<channel>
<item>
<title>Público</title>
<link>http://www.ibm.com/index.htm</link>
<description>Esta é a Taxonomia de nível superior.</description>
<guid>30000001</guid>
<ibmwcm:itemType>category</ibmwcm:itemType>
<ibmwcm:path>/</ibmwcm:path>
304
</item>
</channel>
</rss>
Alimentação de Categoria
<channel>
<item>
<title>Funcionários</title>
<link>http://www.ibm.com/index.htm</link>
<description>Esta é uma Categoria de segundo nível.</description>
<guid>40000001</guid>
<ibmwcm:itemType>category</ibmwcm:itemType>
<ibmwcm:path>/Audience</ibmwcm:path>
<ibmwcm:parentGuid>30000001</ibmwcm:parentGuid>
<ibmwcm:children>
</ibmwcm:children>
</item>
</channel>
</rss>
Alimentação de Componente
<channel>
<item>
<title>IBM Footer</title>
<link>http://www.ibm.com/files/footer.htm</link>
<description>Esta é uma parte compartilhada de HTML.</description>
<guid>53000001</guid>
<ibmwcm:value>
<![CDATA[<span style="font-size: 8pt;">Copyright 2006 <a href="http://www.ibm.com">International Business Machines, Inc.</a> Todos os Direitos Reservados.</span>]]>
</ibmwcm:value>
</ibmwcm:element>
</item>
</channel>
</rss>
305
Alimentação de Conteúdo
<channel>
<item>
<title>Comunicado do Release 2.0</title>
<link>http://www.ibm.com/news/Rel2Announce.htm</link>
<description>Este é um item de conteúdo.</description>
<guid>80000001</guid>
<category>/Audience/Employees</category>
<category>/Audience/Customers</category>
<ibmwcm:path>/SiteAreaName/News</ibmwcm:path>
<ibmwcm:parentGuid>20000001</ibmwcm:parentGuid>
<ibmwcm:keywords>software,content management</ibmwcm:keywords>
</ibmwcm:workflow>
<ibmwcm:publishDate>
Quarta-feira, 1 de novembro de 2006 06:00:00 EST
</ibmwcm:publishDate>
<ibmwcm:expirationDate>
Domingo, 31 de dezembro de 2006 23:59:00 EST
</ibmwcm:expirationDate>
<ibmwcm:genDateOne>Quinta-feira, 15 de dezembro de 2006 09:00:00 EST</ibmwcm:genDateOne>
<ibmwcm:additionalViewer>Todos os Revendedores</ibmwcm:additionalViewer>
<ibmwcm:element name="Headline">
<ibmwcm:value>Release 2.0 Ships Today</ibmwcm:value>
</ibmwcm:element>
<ibmwcm:element name="Summary">
<ibmwcm:value>
A longa e prevista Liberação 2.0 do nosso produto carro-chefe se tornou disponível hoje cedo.
</ibmwcm:value>
</ibmwcm:element>
<ibmwcm:element name="Body">
<ibmwcm:value>
<![CDATA[<p>Suspendisse posuere commodo turpis.</p>
<p>Vivamus nunc nulla, volutpat in, luctus a, facilisis eu, mi.</p>]]>
</ibmwcm:value>
</ibmwcm:element>
<ibmwcm:element name="Image">
<ibmwcm:source>
http://cmsserver.ibm.com/images/rel20box.gif
</ibmwcm:source>
</ibmwcm:element>
</item>
</channel>
</rss>
306
Extensão de Espaço de Nomes RSS para o Serviço de Alimentação
A extensão de espaço de nomes RSS é usada para trocar informações de controle entre os aplicativos
produtor e consumidor de alimentação.
Para implementar este espaço de nomes, especifique o elemento <rss> conforme a seguir:
<rss version="2.0" xmlns:ibmwcm="http://purl.org/net/ibmfeedsvc/wcm/1.0"
xmlns:ibmfs="http://purl.org/net/ibmfeedsvc/feedsvc/1.0" />
As alimentações de entrada precisam apenas incluir este espaço de nomes em determinados cenários nos
quais informações de controle serão transmitidas na própria alimentação em vez de nos cabeçalhos HTTP.
O Protocolo de Handshake:
Em muitas implementações do Web Content Integrator, as alimentações de conteúdo de entrada são
produzidas por um aplicativo que as gera dinamicamente em resposta a pedidos do aplicativo
consumidor da alimentação. Nesses casos, é útil para o consumidor poder indicar ao aplicativo produtor
quais versões de uma alimentação o Consumidor já viu, para que o produtor possa tomar algumas
decisões inteligentes sobre o que incluir na próxima alimentação.
O protocolo de handshake consiste na troca de dois atributos de alimentação: uma Data da Última
Modificação e uma Tag de Entidade arbitrária. Os valores de ambos os atributos são gerenciados
exclusivamente pelo produtor. O consumidor simplesmente recebe os valores do produtor, os armazena e
os transmite de volta inalterados no próximo pedido. Estes atributos podem ser transmitidos de uma de
duas maneiras:
1. Como campos de cabeçalho HTTP:
v Os pedidos do consumidor contêm:
If-Modified-Since : {last-modified_value}
If-None-Match: {etag_value}
v Respostas do produtor contêm:
ETag: {etag_value}
Last-Modified: {last-modified_value}
2. Como elementos na alimentação e parâmetros de cadeia de consulta:
v Os pedidos do consumidor estão no formato:
http://cmsserver.example.org/ProducerApp?etag={etag_value}&lastMod={last-modified_value}
v As alimentações enviadas de volta ao produtor contêm os seguintes elementos de nível de canal:
<lastBuildDate>{last-modified_value}</lastBuildDate>
<ibmfs:etag>{etag_value}</ibmfs:etag>
Como o Handshake Funciona
1. O consumidor faz seu primeiro pedido para o produtor. Este pedido não contém nenhum campo de
cabeçalho especial.
2. O produtor recebe o pedido e, como não havia cabeçalhos especiais, ele responde com uma
alimentação que contém itens que representam todas as transações que ocorreram até esse ponto.
Antes de enviar a resposta, ele configura o cabeçalho Last-Modified com a hora atual e o cabeçalho
ETag com um valor que permite ao produtor identificar esta instância específica da alimentação.
Last-Modified: Thu, 7 Sep 2006 12:00:00 GMT
ETag: ABC0011
3. O consumidor recebe a resposta, processa a alimentação e armazena os valores Last-Modified e ETag
apenas se a alimentação foi processada com êxito.
4. Na próxima vez que o consumidor for acionado, ele fará novamente um pedido para o produtor para
a alimentação da transação. Neste momento, ele configura o cabeçalho If-Modified-Since com a data
de Last-Modified que ele recebeu no último pedido e o campo If-None-Match com o valor da ETag
que ele recebeu no último pedido.
307
If-Modified-Since: Thu, 7 Sep 2006 12:00:00 GMT
If-None-Match: ABC0011
5. O produtor recebe o pedido e verifica os valores dos campos de cabeçalho. Em seguida, ele usa sua
própria lógica interna para gerar uma nova alimentação que contém apenas alterações que ocorreram
desde a última alimentação que ele enviou a este consumidor. Ele envia de volta uma alimentação
com os seguintes valores de cabeçalho:
Last-Modified: Thu, 7 Sep 2006 13:00:00 GMT
ETag: ABC0032
6. O consumidor recebe a resposta, processa a alimentação e atualiza seus valores armazenados para a
data Last-Modified e ETag.
De maneira ideal, se nenhuma mudança ocorreu desde a última vez que o consumidor solicitou a
alimentação, o produtor deverá responder com um código de resposta HTTP 304 (Não Modificado). Isto
sinalizará ao consumidor que não há mudanças e, portanto, ele não precisa tentar analisar a alimentação
e fazer o processamento subsequente. Entretanto, se o produtor não puder implementar esse recurso, isto
não afetará nenhum dos outros processamentos.
O consumidor sempre enviará um pedido contendo o rótulo Etag da última alimentação de transação que
ele recebeu com êxito. Neste caso, o aplicativo produtor será responsável por reenviar quaisquer entradas
que possam ter sido perdidas devido a uma falha na comunicação entre os servidores.
Alimentações de Resultados:
Quando o processamento da alimentação for iniciado através de uma chamada ao servlet do serviço de
alimentação, o Web Content Integrator responderá com uma alimentação de saída. A primeira entrada
nesta alimentação conterá informações de status para a alimentação como um todo. Cada uma das
entradas subsequentes na alimentação de saída corresponderá a um item que estava na alimentação de
entrada. Essas entradas posteriores conterão informações de status sobre os resultados do processamento
de cada item. Os produtores da alimentação poderão usar essas informações para tentar se recuperar
automaticamente de determinados tipos de erros.
Cada entrada na alimentação de saída terá o seguinte formato geral:
<item>
<title>Results for: [INPUT_TITLE]</title>
<link>[INPUT_LINK]</link>
<pubDate>[CREATION_TIME_OF_OUTPUT_FEED_ENTRY]</pubDate>
<guid permalink="false">[INPUT_GUID]</guid>
<ibmfs:resultCode>[ OK | WARN | ERROR | FAIL ]</ibmfs:resultCode>

<ibmfs:resultMsg level="[ WARN | ERROR ]" code="[ERR_CODE]">[MESSAGE_TEXT]</ibmfs:resultMsg>
<ibmfs:resultMsg level="[ WARN | ERROR ]" code="[ERR_CODE]">[MESSAGE_TEXT]</ibmfs:resultMsg>
<ibmfs:documentId>[WCM_DOCUMENT_ID]</ibmfs:documentId>
<description>[LIST_OF_PROGRESS_MESSAGES]</description>
</item>
Elementos no Nível do Canal:
O elemento a seguir deve ser um filho direto do elemento <channel /> de alimentação, pois ele se aplica
à alimentação como um todo em vez de a um item individual na alimentação.
etag
Alguns aplicativos do produtor não podem manipular os cabeçalhos HTTP para configurar os dados de
handshake. Para suportar esses aplicativos, há um método alternativo que vincula a transmissão das
mesmas informações diretamente na alimentação usando o elemento RSS <lastBuildDate>, bem como um
elemento de espaço de nomes customizado, <ibmfs:etag>.
308
Tabela 107. Elemento etag
Valores Permitidos
Um valor de cadeia que representa algum rótulo
significativo para a instância específica da alimentação.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Por exemplo:
<ibmfs:etag>ABC0012</ibmfs:etag>
Elementos no Nível do Item:
Os elementos a seguir são aplicados no nível do <item /> pois eles contêm informações que são
específicas para cada entrada de alimentação individual. Esses elementos são usados apenas na
alimentação de saída. Eles não possuem significado no contexto de uma alimentação de entrada.
resultCode
Tabela 108. Elemento resultCode
Valores Permitidos
Este elemento terá um dos valores a seguir, dependendo
do que aconteceu quando a entrada da alimentação de
entrada foi processada:
OK
A entrada foi processada completamente sem
avisos ou erros.
WARN A entrada foi processada completamente mas
um ou mais avisos foram registrados.
ERRO
Uma ou mais mensagens de erro foram
registradas. A entrada pode não ter sido salva
em Web Content Manager.
FAIL
O item de conteúdo não pôde ser salvo ou
atualizado.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Por exemplo:
<ibmfs:resultCode>OK</ibmfs:resultCode>
<ibmfs:resultCode>WARN</ibmfs:resultCode>
resultMsg
Tabela 109. Elemento resultMsg
Valores Permitidos
Cada instância deste elemento conterá os detalhes de
uma mensagem de aviso ou erro.
309
Tabela 109. Elemento resultMsg (continuação)
level
O valor deste atributo indica a gravidade da
mensagem. Os valores permitidos são: "WARN"
e "ERROR".
code
Este atributo deve conter o código de erro que
está associado à mensagem.
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Exemplos:
<ibmfs:resultMsg level="WARN" code="WCM0014">
GUID de Conteúdo Padrão não aponta para um item de conteúdo. Conteúdo padrão configurado para nulo.
</ibmfs:resultMsg>
<ibmfs:resultMsg level="ERROR" code="WCM0030">
Uma WCMException foi lançada ao tentar mover o conteúdo.
</ibmfs:resultMsg>
documentId
Tabela 110. Elemento documentId
Valores Permitidos
Este elemento contém o ID que foi gerado pelo Web
Content Manager.
Nenhum
Atributos Opcionais
Nenhum
Nenhum
Nenhum
Por exemplo:
<ibmfs:documentId>
com.ibm.workplace.wcm.api.WCM_Content/Connections Announcement/f6f60a00498c0d759ee9ffe695695374/PUBLISHED
</ibmfs:documentId>
WebDAV
Com o WebDAV para IBM WebSphere Portal, é possível usar ferramentas do sistema operacional padrão
para criar, modificar e excluir o conteúdo da Web em vez do portlet de autoria padrão.
Antes de poder usar o WebDAV com conteúdo da web, você precisará configurar um cliente WebDAV.
Depois que seu cliente estiver configurado, você poderá acessar as bibliotecas de conteúdo da web com o
WebDAV usando a seguinte URL:
http://server:port/portal_context_root/mycontenthandler/dav/content/libraries/
Exemplo:
http://www.example.com:10039/wps/mycontenthandler/dav/content/libraries/
Alavancando ferramentas como os exploradores de sistema de arquivos, o WebDAV permite trabalhar
com seus itens de conteúdo da web por meio de ações familiares, diárias. Segue alguns exemplos:
310
v É possível criar componentes ou modelos de apresentação simplesmente arrastando um arquivo em
uma pasta correspondente.
v É possível executar ações em vários itens de uma vez. Por exemplo, é possível criar cinco imagens ao
mesmo tempo arrastando cinco arquivos de imagem na pasta do componente de imagem. Isso cria
cinco componentes de imagem separados e, para cada componente de imagem, o nome do arquivo é
usado para o nome e título do componente.
v A modificação de itens também é direta através de um cliente WebDAV. Por exemplo, é possível abrir
um modelo de apresentação usando seu editor HTML preferencial, fazer alterações nele e, em seguida,
salvar as alterações. O cliente WebDAV é responsável pelo acesso à biblioteca de conteúdo da web,
fazendo o download do modelo e depois atualizando as mudanças.
Além de modificar o conteúdo real de um item, também é possível modificar as configurações de
metadados e controle de acesso do item modificando arquivos XML que definem as características de
metadados e controle de acesso do item. Também é possível arrastar um arquivo XML existente na pasta
apropriada, permitindo que você configure facilmente os mesmos dados para diferentes itens.
É possível criar, modificar ou excluir os seguintes itens: bibliotecas, taxonomias, categorias, áreas de site,
pastas, componentes e modelos de apresentação.
Nota: Esteja ciente de que os seguintes recursos não são suportados ao usar o WebDAV com o conteúdo
da web:
v Itens de conteúdo, com exceção do gerenciamento de metadados e de controle de acesso
v Modelos de autoria, com exceção do gerenciamento de metadados e de controle de acesso
v Itens aninhados dentro de áreas de site
v Cópia e movimentação do lado do servidor
v Usuários não autenticados
v A exportação de bibliotecas de conteúdo da web com o WebDAV que serão importadas em outro
servidor de conteúdo da web
Ao usar o WebDAV com conteúdo da web, esteja ciente das seguintes considerações.
Suporte ao item bloqueado
O bloqueio ou desbloqueio de um item através do WebDAV bloqueará ou desbloqueará o item no
Web Content Manager e no banco de dados JCR. Como alguns itens são representados por
múltiplos arquivos e pastas, o bloqueio ou desbloqueio de um destes arquivos causa o bloqueio
ou desbloqueio dos outros arquivos associados ao mesmo tempo. Se você bloquear um item, as
pastas e arquivos relacionados ao conteúdo do item, seus metadados e suas configurações de
controle de acesso também serão bloqueados.
Suporte ao Fluxo de Trabalho
Não há representação de um fluxo de trabalho em si na árvore do WebDAV, mas se um arquivo
fizer parte de um fluxo de trabalho e o fluxo de trabalho indicar que o arquivo está em um
estado que permite aos usuários modificá-lo, o WebDAV permitirá que você modifique o arquivo
também.
Nomes do Arquivo e Sufixos de Tipo de Arquivo
Os arquivos que representam itens de dados são sempre denominados exatamente como o item
de conteúdo correspondente. Por exemplo, se você tiver um componente de imagem denominado
myImage, o arquivo de imagem correspondente também será denominado myImage, sem qualquer
sufixo indicando o tipo de arquivo, tal como .gif ou .jpg. Isto pode, às vezes, causar um
problema ao abrir o arquivo através do WebDAV porque o aplicativo apropriado para editar o
arquivo não pode ser escolhido automaticamente. Para lidar com isso, é possível renomear o
próprio componente para incluir o tipo de arquivo (por exemplo, myImage.gif) ou é possível
iniciar, manualmente, o aplicativo de edição e abrir o arquivo a partir do cliente.
311
Itens Ausentes
Se um item não for mais exibido ou não puder ser mais modificado, pode ser devido a um
estado alterado do item no servidor de conteúdo da web no qual o item está armazenado. Por
exemplo, criar ou modificar um item no servidor poderia levar a um estado alterado que o
impede de acessar esse item com o WebDAV, dependendo de como o fluxo de trabalho está
configurado. A expiração é outra razão para que o estado de um item possa alterar e, portanto,
afetar, se você pode acessar o item com o WebDAV.
Configurando um Frontend do Servidor HTTP
Ao usar o frontend do servidor HTTP para trabalhar com o WebDAV, você precisará configurar
Aceitar Conteúdo para Todas as Solicitações como true para o plug-in de servidor da web no
WebSphere Integrated Solutions Console em Servidores da Web > webserver1 > Propriedades de
Plug-in > Solicitação e Resposta.
Itens de Conteúdo da Web na Árvore do WebDAV
A árvore do WebDAV que contém seus itens de conteúdo da Web inicia na raiz do WebDAV /libraries/,
que exibe todas as bibliotecas para as quais você possui acesso. Todos os itens de conteúdo da Web nas
bibliotecas são organizados com pastas e arquivos.
Os itens que não pertencem ao conteúdo, tais como áreas de site ou categorias, são representados como
pastas que contêm apenas a pasta de metadados do item e quaisquer itens filhos como outras áreas de
site ou categorias. Nenhum arquivo de dados está presente.
sites
- wcm.siteArea.siteArea1
- meta-data
- wcm.siteArea.siteArea1.1
- meta-data
- wcm.siteArea.siteArea1.1.1
- meta-data
- wcm.siteArea.siteArea1.1.2
- meta-data
- meta-data
Itens orientados a dados como componentes de imagem ou modelos de apresentação são representados
como arquivos de forma que você possa manipulá-los com operações de arrastar e soltar. Os metadados
correspondentes para o item são gerenciados da mesma maneira que para os itens que não são dados,
mas em subpastas separadas na pasta de metadados.
wcm.comps.image
image1.jpg
image2.jpg
- meta-data
- wcm.comp.image1.jpg
Além de pastas que representam itens de conteúdo da Web reais, há pastas na árvore do WebDAV para
estruturar os dados ou para permitir melhor escalabilidade. Para cada biblioteca há pastas para
componentes, modelos de apresentação, sites e taxonomias.
libraries
- wcm.library.my_library
- authoringTemplates
- components
- presentationTemplates
- sites
- taxonomies
- wcm.library.contentlibrary
- components
- sites
- taxonomies
312
Dentro da pasta de componentes há subpastas para os tipos de componentes para melhor escalabilidade
e gerenciamento dos diferentes tipos de componentes..
libraries
- components
- wcm.comps.authoring.tools
- wcm.comps.component.references
- wcm.comps.data.and.time
- wcm.comps.federated.content
- wcm.comps.file
- wcm.comps.html
- wcm.comps.image
- wcm.comps.jsp
- wcm.comps.link
- wcm.comps.menu
- wcm.comps.navigator
- wcm.comps.number
- wcm.comps.page.navigation
- wcm.comps.personalization
- wcm.comps.richt.text
- wcm.comps.search
- wcm.comps.short.text
- wcm.comps.style.sheet
- wcm.comps.taxonomy
- wcm.comps.text
- wcm.comps.user.name
- wcm.comps.user.selection
Para organizar seus modelos de autoria, modelos de apresentação e componentes, é possível criar pastas
de conteúdo da Web customizadas. Essas pastas de conteúdo da Web são representadas como pastas no
WebDAV e contêm um conjunto de tipos de componentes estruturados da mesma maneira que na pasta
components raiz. Este é um exemplo de uma estrutura de pasta de componente:
- components
- CustomComponentFolder1
- wcm.comps.file
.
.
.
- wcm.comps.file
.
.
.
- wcm.comps.file
.
.
.
313
Metadados e Controle de Acesso para Itens de Conteúdo da Web no WebDAV
O WebDAV usa arquivos XML para representar metadados e informações de controle de acesso para um
item de conteúdo da Web. É possível fazer alterações nas configurações de metadados e controle de
acesso de um item modificando esses arquivos e é possível especificar configurações para múltiplos
arquivos copiando os arquivos XML em seus locais apropriados na árvore do WebDAV.
Metadados
Os metadados de um item são representados pelo arquivo meta-data.xml, que descreve informações de
identificação para o item, incluindo o nome e o título para o item e a lista de autores e proprietários
associados ao item.
A seguir, há um arquivo meta-data.xml de amostra:
<meta-data>
<item>
<title lang="en" value="test1.JPG"/>
<description lang="en" value="description"/>
<wcm-group id="authors">
<member DN="all_auth_portal_users" type="group"/>
<member DN="uid=wpsadmin,o=defaultWIMFileBasedRealm" type="user"/>
</wcm-group>
<wcm-group id="owners">
<member DN="all_users" type="group"/>
</wcm-group>
</item>
</meta-data>
Controle de Acesso
As informações de controle de acesso de um item são representadas pelos seguintes arquivos:
v access-control-system.xml: Contém definições de controle de acesso para o sistema especificado pelo
administrador.
v access-control-user.xml: Contém definições de controle de acesso definidas pelo usuário.
Além destes arquivos específicos do item, o arquivo access-control.xml é fornecido para pastas que
representam tipos de recursos, como a pasta components, e contém definições de controle de acesso para o
tipo de recurso.
A seguir, há um arquivo access-control.xml de amostra para definições de controle de acesso do
recurso:
<access-control>
<resource-config>
<role-block role-type="Editor" type="inheritance"/>
<role-block role-type="User" type="inheritance"/>
<role-block role-type="Editor" type="propagation"/>
<role-block role-type="User" type="propagation"/>
</resource-config>
<role-list>
<role type="Administrator">
</role>
<role type="Contributor">
</role>
<role type="Manager">
314
</role>
</role-list>
</access-control>
A seguir, há um arquivo access-control-system.xml de amostra para definições de controle de acesso
definidas pelo administrador de um item:
<access-control>
<resource-config>
<role-block role-type="Contributor" type="inheritance"/>
<role-block role-type="Manager" type="inheritance"/>
</resource-config>
<role-list>
<role type="Editor">
<member DN="authors" type="virtual"/>
</role>
<role type="User">
</role>
</role-list>
</access-control>
A seguir, há um arquivo access-control-user.xml de amostra para definições de controle de acesso
definidas pelo usuário de um item:
<access-control>
<role-list>
<role type="Contributor">
<member DN="owners" type="virtual"/>
</role>
<role type="Editor">
</role>
<role type="Manager">
</role>
</role-list>
</access-control>
“Gerenciando Metadados e Configurações de Controle de Acesso para Modelos de Autoria com
WebDAV” na página 320
Com o WebDAV, é possível alterar as informações de metadados de um portlet de autoria ou atualizar as
configurações de controle de acesso do modelo.
Criando Taxonomias e Categorias com o WebDAV
As taxonomias e categorias são métodos de criação de perfil usados para agrupar itens de conteúdo e
você pode trabalhar com taxonomias e categorias diretamente através do WebDAV. As taxonomias e
categorias são representadas no WebDAV como pastas e você pode configurar sua taxonomia criando e
aninhando pastas.
Todas as taxonomias e categorias para uma determinada biblioteca são listadas na pasta taxonomies para
essa biblioteca.
taxonomias
- wcm.taxonomy.taxonomy1
- meta-data
access-control-system.xml
access-control-user.xml
meta-data.xml
- wcm.category.category1
- meta-data
315
meta-data.xml
- wcm.category.category1.1
- meta-data
meta-data.xml
- wcm.category.category1.2
- meta-data
meta-data.xml
- wcm.taxonomy.taxonomy2
- meta-data
meta-data.xml
access-control.xml
Para criar uma nova taxonomia ou categoria para sua biblioteca, crie uma nova pasta usando o prefixo
wcm.taxonomy ou o prefixo wcm.category. As taxonomias podem ser criadas apenas na pasta taxonomies
genérica, enquanto as categorias podem ser criadas em uma pasta wcm.taxonomy.* ou uma pasta
wcm.category.*.
Importante: Alguns clientes WebDAV criam uma pasta com um nome padrão, tal como Nova Pasta, e
assim que você insere o nome da nova pasta, o cliente envia um pedido para renomear a pasta já criada.
Como as pastas de taxonomia e categoria requerem um prefixo correspondente para criação, esse
comportamento do cliente não funciona. Se seu cliente WebDAV usar esse método para criar novas
pastas, você poderá, primeiro, criar a nova pasta de taxonomia ou categoria localmente e, em seguida,
copiá-la na árvore do WebDAV.
Excluindo Taxonomias e Categorias: Para excluir taxonomias ou categorias basta excluir a pasta
correspondente. Observe que as taxonomias ou categorias contendo categorias não podem ser excluídas
até que você também tenha excluído primeiro os itens filhos. Além disso, se uma categoria ainda estiver
sendo referenciada por outro item, ela não poderá ser excluída até que você tenha removido, primeiro, as
referências correspondentes usando o portlet de autoria.
Gerenciando Conteúdo com Áreas de Site no WebDAV
As áreas de site são usadas para organizar itens de conteúdo em seu sistema de conteúdo da Web. No
WebDAV, as áreas de site são representadas como pastas e você pode configurar sua estrutura de site
criando e aninhando pastas. Um item de conteúdo dentro de uma área de site é representado como uma
pasta contendo os metadados e as configurações de controle de acesso do item de conteúdo.
Todas as áreas de site e itens de conteúdo de uma determinada biblioteca são listados na pasta sites
dessa biblioteca.
sites
- meta-data
meta-data.xml
- meta-data
meta-data.xml
- wcm.content.content1.1.1
- meta-data
316
meta-data.xml
- meta-data
meta-data.xml
access-control.xml
Nota: O suporte para itens de conteúdo é limitado para modificar os metadados e as configurações de
controle de acesso. Não é possível criar ou excluir itens de conteúdo usando o WebDAV.
Para criar uma nova área de site para sua biblioteca, crie uma nova pasta usando o prefixo wcm.siteArea.
Importante: Alguns clientes WebDAV criam uma pasta com um nome padrão, como Nova Pasta e, assim,
que você insere o nome da nova pasta, o cliente envia um pedido para renomear a pasta já criada. Como
as pastas de área de site exigem um prefixo correspondente para criação, esse comportamento do cliente
não funciona. Se seu cliente WebDAV usar esse método para criar novas pastas, será possível primeiro
criar a nova área de site localmente e, em seguida, copiá-la na árvore do WebDAV.
Excluindo áreas de site: Para excluir áreas de site, basta excluir a pasta correspondente. Observe que as
áreas de site que contêm áreas de site ou itens de conteúdo não podem ser excluídas até que você tenha
primeiro excluído os itens filhos. Para excluir itens de conteúdo filhos, é necessário usar o portlet de
autoria em vez do WebDAV.
Criando Componentes com WebDAV
Os componentes são usados para armazenar elementos em seu sistema de conteúdo da Web e você pode
usar o WebDAV para criar e gerenciar componentes. Cada tipo de componente é representado como uma
pasta no WebDAV, com componentes individuais sendo representados como arquivos na pasta de
componente apropriada.
Todos os componentes de uma determinada biblioteca são listados como pastas na pasta components
dessa biblioteca. Dentro da pasta components, é possível criar também pastas customizadas que você pode
usar para organizar seus componentes. Como a pasta components raiz, as pastas customizadas contêm
pastas para cada tipo de componente.
libraries
- components
.
.
.
.
.
.
- wcm.comps.file
- wcm.comps.html
- wcm.comps.image
- wcm.comps.jsp
317
- wcm.comps.link
- wcm.comps.menu
- wcm.comps.number
- wcm.comps.page.navigation
- wcm.comps.personalization
- wcm.comps.rich.text
- wcm.comps.search
- wcm.comps.short.text
- wcm.comps.style.sheet
- wcm.comps.taxonomy
- wcm.comps.text
- wcm.comps.user.name
access-control.xml
Componentes são itens orientados a dados e representados como arquivos e pastas de metadados.
libraries
- components
- wcm.comps.file
- wcm.comps.html
- wcm.comps.image
image1.jpg
image2.jpg
- meta-data
meta-data.xml
meta-data.xml
- wcm.comps.jsp
- wcm.comps.link
- wcm.comps.menu
.
.
.
access-control.xml
Importante: Embora exibido no WebDAV, os seguintes componentes não podem ser criados ou
modificados por meio do WebDAV e são representados por arquivos vazios:
v Ferramentas de Autor
v Referências de Componente
v Conteúdo Federado
v
v
v
v
v
v
v
JSP
Menu
Navegador
Navegação de Página
Personalização
Procura
Taxonomia
318
v Nome do Usuário
v Seleção do Usuário
Para fazer alterações nesses componentes, você deve usar o portlet de autoria.
Limitação do Componente de Link: Atualmente, os componentes de link não são totalmente suportados
pelo WebDAV. O arquivo WebDAV que representa o componente do link contém apenas a URL do link
em si, mas nenhuma outra informação, como o texto do link. Por exemplo, se você usar WebDAV para
modificar um componente do link contendo uma representação de HTML de <a
href=’www.lotus.com’>lotus software</a> e alterar a URL para www.ibm.com, o texto do link ainda será
renderizado como lotus software, porque essas informações não podem ser modificadas com o WebDAV.
Para criar componentes para sua biblioteca, arraste um ou mais arquivos na pasta do tipo de componente
apropriada. Quando você criar um novo componente desta maneira, o nome do arquivo do objeto será
usado como o nome e título do novo componente e o conteúdo do arquivo será armazenado como os
dados do componente. Além disso, o usuário autenticado com o cliente WebDAV é especificado como o
autor e proprietário do novo componente.
Por exemplo, você poderá arrastar um arquivo HTML na pasta wcm.comps.html para um novo
componente HTML ou para a pasta wcm.comps.rich.text para um novo elemento rich text.
Importante: Colocar um arquivo incompatível em uma pasta de tipo de componente (por exemplo,
colocar um arquivo JPEG na pasta wcm.comps.html) pode causar erros durante a criação do componente e
pode resultar em um componente inutilizável.
Atualizando Componentes: Para atualizar um componente existente, é possível, simplesmente, substituir
o arquivo correspondente na árvore do WebDAV por um novo arquivo que possui o mesmo nome. Por
exemplo, você pode colocar myCoolPic.jpg na pasta dos componentes de imagem que já contém
myCoolPic.jpg, e o componente será atualizado automaticamente com o conteúdo do novo arquivo. Se
você colocar um arquivo com um nome diferente, um novo componente com esse nome será criado.
Criando Modelos de Apresentação no WebDAV
Com o WebDAV, é possível criar e manter modelos de apresentação para definir as características de
layout e aparência de páginas da Web usadas para exibir o conteúdo. Também é possível criar
componentes de imagem aninhados para usar com os modelos de apresentação. Os modelos de
apresentação são armazenados em uma pasta com componentes de imagem aninhados em uma pasta
associada.
Todos os modelos de apresentação para uma determinada biblioteca são listados na pasta
presentationTemplates para essa biblioteca. Como eles são itens orientados a dados, os modelos de
apresentação são representados como arquivos e pastas meta-data. Os componentes de imagem
aninhados são armazenados em uma pasta nomeada após seu modelo de apresentação associado – por
exemplo, template_name_files.
libraries
template1.html
myTemplate.html
- meta-data
- wcm.presentationTemplate.template1.html
meta-data.xml
- wcm.presentationTemplate.myTemplate.html
meta-data.xml
319
access-control.xml
- template1.html_files
nested_image.jpg
- myTemplate.html_files
1. Para criar modelos de apresentação para sua biblioteca, arraste um ou mais arquivos na pasta
presentationTemplates. Quando você criar um novo modelo de apresentação desta maneira, o nome
do arquivo do objeto será usado como o nome e o título do novo modelo e o conteúdo do arquivo é
armazenado como os dados do modelo. Além disso, o usuário autenticado com o cliente WebDAV é
especificado como o autor e proprietário do novo modelo.
Importante: Colocar um arquivo incompatível na pasta presentationTemplates (por exemplo, um
arquivo JPEG) pode causar erros durante a criação do modelo e pode resultar em um modelo de
apresentação inutilizável.
Excluindo Modelos de Apresentação: Para excluir um modelo de apresentação, basta excluir o
arquivo correspondente. Se o modelo de apresentação estiver sendo referenciado por outro item, tal
como uma área de site, ele não poderá ser excluído até que você tenha removido primeiro as
referências correspondentes usando o portlet de autoria.
Atualizando Modelos de Apresentação: Para atualizar um modelo de apresentação existente, é
possível, simplesmente, substituir o arquivo correspondente na árvore do WebDAV por um novo
arquivo que possui o mesmo nome. Por exemplo, você pode colocar o myTemplate.html na pasta
presentationTemplates, substituindo o arquivo myTemplate.html que já está lá e o modelo de
apresentação será atualizado automaticamente com o conteúdo do novo arquivo. Se você colocar um
arquivo com um nome diferente, um novo modelo com esse nome será criado.
2. Crie qualquer componente de imagem aninhado para seu modelo de apresentação incluindo os
arquivos de imagem na pasta template_name_files para seu modelo. Por exemplo, se seu modelo for
template1.html, você incluirá os arquivos de imagem na pasta template1.html_files.
Nota: Quando você inclui uma imagem na pasta de componentes aninhados, uma imagem
temporária é criada inicialmente e a imagem é apenas incluída permanentemente na lista de
componentes aninhados quando uma referência a essa imagem é incluída no código HTML do
modelo de apresentação. Isto é feito para evitar componentes órfãos no modelo de apresentação.
3. Se você tiver incluído um componente de imagem aninhado, atualize o código HTML do modelo de
apresentação para referenciar o componente de acordo com o caminho do WebDAV relativo para o
componente.
Por exemplo, para referenciar um componente de imagem aninhado, você atualizaria o arquivo
template1.html com o seguinte código:
<img src="./template1.html_files/nestedImage.jpg" border="0"
title="my nested image"/>
Para referenciar um componente de imagem padrão, você usaria código HTML semelhante ao
exemplo a seguir:
<img src="../components/wcm.comps.image/test2.jpg" border="0"
title="my test image"/>
Gerenciando Metadados e Configurações de Controle de Acesso para Modelos de
Autoria com WebDAV
Com o WebDAV, é possível alterar as informações de metadados de um portlet de autoria ou atualizar as
configurações de controle de acesso do modelo.
Todos os modelos de autoria de uma determinada biblioteca são listados na pasta authoringTemplates
dessa biblioteca. Como eles são itens orientados a dados, os modelos de autoria são representados como
arquivos e pastas meta-data.
libraries
- authoringTemplates
320
auth_template1.html
myAuthTemplate.html
- meta-data
- wcm.presentationTemplate.auth_template1.html
meta-data.xml
- wcm.presentationTemplate.myAuthTemplate.html
meta-data.xml
access-control.xml
Nota: Não é possível modificar o próprio modelo de autoria no WebDAV. Para fazer alterações no
modelo de autoria, use o portlet de autoria.
1. Para alterar as configurações de controle de acesso de um modelo de autoria, edite o arquivo
access-control-system.xml para configurações do administrador ou o arquivo access-controluser.xml para configurações definidas pelo usuário.
2. Para alterar os metadados de um modelo de autoria, edite o arquivo meta-data.xml do modelo de
autoria.
“Metadados e Controle de Acesso para Itens de Conteúdo da Web no WebDAV” na página 314
O WebDAV usa arquivos XML para representar metadados e informações de controle de acesso para um
item de conteúdo da Web. É possível fazer alterações nas configurações de metadados e controle de
acesso de um item modificando esses arquivos e é possível especificar configurações para múltiplos
arquivos copiando os arquivos XML em seus locais apropriados na árvore do WebDAV.
Blogs
Use blogs e bibliotecas de blogs para fornecer notícias e comentários sobre uma variedade de assuntos
pertinentes aos seus sites de intranet e extranet. Os blogs e as bibliotecas de blogs geralmente combinam
texto com gráficos e link para outros blogs e websites. As entradas que você cria e a postagem são
organizadas em ordem cronológica inversa, com a entrada mais recente exibida primeiro. Os leitores
podem postar comentários sobre suas entradas, promovendo discussões e redes de relacionamentos
on-line. Você pode gerenciar suas próprias entradas de blog e fazer comentários sobre outras entradas de
blog. Também é possível incorporar identificação e classificação da forma usual, como seria feito com
outro conteúdo do WebSphere Portal.
Dica: Use um blog para compartilhar informações sobre um único assunto. Use uma biblioteca de blogs
para compartilhar informações sobre múltiplas discussões.
Tag e Classificação
Saiba Sobre as Bibliotecas de Modelos Usadas por Blogs e Bibliotecas de Blogs
Os blogs e as bibliotecas de blogs usam as bibliotecas de modelos fornecidas pelo IBM Web Content
Manager. As bibliotecas de blogs usam as bibliotecas Web Resources v70 e Blog v70. Os blogs usam as
bibliotecas Web Resources v70 e Blog Solo v70. A hierarquia da página que é fornecida para esses
componentes é a comum, definida pelas bibliotecas de modelos do Web Content Manager.
Nota: As bibliotecas do Web Content Manager descritas neste tópico funcionam apenas com o
customizador de temas usado no tema padrão. A customização dessas bibliotecas afetará todos os blogs e
bibliotecas de blogs no site.
321
Biblioteca Web Resources v70
A biblioteca Web Resources v70 fornece os modelos de autoria e de apresentação para blogs e bibliotecas
de blogs. Todos os blogs no site usam essa única biblioteca compartilhada. As alterações na biblioteca
compartilhada principal afetam todos os blogs.
Biblioteca Blog Solo v70
Quando você inclui um blog em uma página, uma cópia da biblioteca Blog Solo v70 é criada usando o
nome fornecido ao incluir um blog em uma página. Essa cópia da biblioteca Blog Solo v70 é usada para
armazenar postagens e comentários.
Biblioteca Blog v70
Quando você inclui uma biblioteca de blogs em uma página, uma cópia da biblioteca Blog v70 é criada
usando o nome fornecido ao incluir a biblioteca de blogs em uma página. A cópia da biblioteca Blog v70
é usada para armazenar postagens e comentários quando novas páginas forem incluídas na biblioteca de
blogs.
Incluindo um Blog ou uma Biblioteca de Blogs em uma Página
Com o acesso do Editor ao portal ou à página do portal, é possível incluir um blog ou uma biblioteca de
blogs em uma página. Escolha um blog para colaborar com sua equipe em um único tópico. Escolha a
biblioteca de blogs para colaborar com sua equipe em vários tópicos em uma visualização centralizada.
Consulte o Wiki do WebSphere Portal Family para obter um exemplo de como é possível modificar seu
tema customizado para ativar o recurso de incluir blogs e wikis em uma página.
1. Crie um projeto ou acesse um projeto existente e abra o projeto no modo de edição.
2. Se ainda não tiver feito isso, crie uma página para o blog ou para a biblioteca de blogs ou abra uma
página existente.
3. Clique na guia Conteúdo e, em seguida, clique em Comunicações.
4. Clique em Biblioteca de Blogs para incluir um blog de equipe ou clique em Blog para criar um blog
com um único tópico.
5. Clique em Incluir na página.
6. Forneça um nome. Em seguida, clique em Incluir.
O nome é usado para o título do portlet, o título de exibição da biblioteca e o nome da biblioteca. Ele
pode conter caracteres alfanuméricos, espaços e os seguintes caracteres: $ - _ . ! ( ) ,. Se você usar
outros caracteres, eles serão substituídos por aqueles que são suportados pela biblioteca do Web
Content Manager.
7. Clique em Salvar Rascunho.
Esta ação copia a biblioteca de modelos de blog apropriada do IBM Web Content Manager e coloca
uma instância do visualizador de conteúdo da web na página.
Após a publicação do site com uma biblioteca de blogs, clique em Criar Blog e Criar Postagem para
incluir conteúdo. Clique em Editar para modificar o conteúdo. Para excluir uma postagem, clique em
Excluir.
Após a publicação do site com um blog, clique em Criar Postagem para incluir conteúdo. Clique em
Editar para modificar o conteúdo. Para excluir uma postagem, clique em Excluir.
Nota: O conteúdo da web identificado exibido no visualizador de conteúdo da web estará disponível
apenas quando houver uma única instância desse portlet na página. Quando você clica em um resultado
de tag, o Centro de Tags transmite as informações sobre o que o conteúdo deve exibir no visualizador
322
usando um parâmetro de renderização pública. Se houver várias instâncias de conteúdo da web exibidas
no visualizador de conteúdo da web, elas exibirão o conteúdo que foi identificado, em vez de exibir o
conteúdo original dessas instâncias.
Melhores Práticas e Limitações do Visualizador de Conteúdo da Web
Incluindo Blogs ou Bibliotecas de Blogs Existentes em uma Página
Se você criou um blog ou uma biblioteca de blogs para outra página e agora deseja utilizá-la novamente,
inclua um visualizador de conteúdo da web na nova página e edite suas configurações para apontar para
o blog ou a biblioteca de blogs existente.
2. Se ainda não tiver feito isso, crie uma página para o blog ou para a biblioteca de blogs existente ou
abra uma página existente.
3. Clique na guia Conteúdo.
4. Clique em Todos na lista de categorias e procure o portlet Visualizador de Conteúdo da Web (JSR
286).
5. Inclua o visualizador de conteúdo da web na página clicando no sinal de mais (+) ou arrastando o
visualizador para a página.
7. Clique no menu suspenso localizado na barra de título do visualizador de conteúdo da web e
selecione Editar Configurações Compartilhadas.
8. Em Tipo de Conteúdo, selecione Item de Conteúdo.
9. Em Conteúdo, clique em Editar.
10. Clique em Bibliotecas.
11.
12.
13.
14.
15.
Clique na biblioteca que contém o blog ou a biblioteca de blogs que você deseja incluir.
Expanda a biblioteca selecionada para ver o blog ou a biblioteca de blogs que deseja usar.
Selecione o blog ou a biblioteca de blogs e clique em OK.
Clique em Aplicar para salvar suas mudanças no visualizador de conteúdo da web.
Clique em Opções Avançadas.
16. Assegure-se de que a opção Transmitir Links para esteja configurada como Nenhuma ou Esta
Página do Portal.
17. Assegure-se de que a opção Receber links de esteja configurada como Este Portlet apenas ou
Outros Portlets e este Portlet.
18. Clique em OK.
apenas quando houver uma única instância desse portlet na página. Ao clicar em um resultado da
identificação, o Tag Center transmite as informações sobre o que o conteúdo deve exibir no visualizador
usando um parâmetro de renderização público. Se houver várias instâncias de conteúdo da web sendo
exibidas no visualizador de conteúdo da web, elas exibirão o conteúdo que foi identificado, em vez de
exibir seu conteúdo original.
Designando Acesso ao Blog para Usuários
O administrador do portal pode designar acesso de editor para você caso seja necessário criar e gerenciar
blogs nesse site. Se o acesso de editor for designado a você em um blog, você poderá criar ou modificar
postagens nesse blog. Se direitos de editor forem concedidos a você em uma biblioteca de blogs, você
poderá criar e modificar blogs, bem como criar e modificar postagens nessa biblioteca de blogs. Se você
323
tiver direitos de gerenciador em um blog, poderá criar, modificar e excluir postagens, bem como excluir
comentários, nesse blog. Se você tiver direitos de gerenciador em uma biblioteca de blogs, poderá criar,
modificar e excluir blogs, além de criar, modificar e excluir postagens e comentários nos blogs.
Para obter um exemplo de designação de acesso a usuários, consulte as seguintes instruções para incluir
usuários à função de Editor:
1. Acesse Administração > Conteúdo do Portal > Bibliotecas de Conteúdo da Web.
2. Navegue até a biblioteca que contém o blog que você deseja gerenciar e clique em Configurar
Permissões.
3. Clique em Editar Função para a função Editor.
4. Clique em Incluir para designar a usuários ou grupos a função Editor. Procure os usuários ou grupos
que pertencem a esta função.
Por exemplo, as configurações na tabela a seguir permitem que todos os usuários autenticados criem
novos blogs, mas os restringe a postar apenas em blogs criados por eles. Use as opções Configurar
Permissões e Recursos da Biblioteca da página Biblioteca de Conteúdo da Web para designar as
seguintes configurações:
Tabela 111. Um Exemplo das Configurações de Acesso para um Blog
Configurações de Acesso
Grupo
Nível de Acesso
Outras Configurações
Todos os Usuários
Colaborador
Não selecione "Permitir
Propagação"
Todos os Usuários
Usuário
Content
Todos os Usuários
Editor
Visualizando Blogs e Postagens do Blog
Você pode visualizar os blogs criados em uma biblioteca específica e visualizar as postagens em um blog
por ordem decrescente. Se você for um contribuidor, poderá visualizar as páginas do blog. Por padrão,
todos os usuários do portal podem visualizar o conteúdo ou a postagem de um blog depois que ele é
criado.
Execute as seguintes etapas para visualizar blogs e postagens de blogs:
1. Navegue até a página que contém o blog ou a biblioteca de blogs.
2. (Apenas biblioteca de blogs) Clique em Lista de Blogs para visualizar todos os blogs criados em
uma biblioteca específica. Blogs são listados em ordem decrescente, do primeiro para o último, e
exibem o nome da pessoa que o criou (Editor) e a data e hora nas quais ele foi criado.
a. Movimente-se pela lista de blogs usando os controles da página.
b. Especifique quantos blogs deseja listar em uma página, escolhendo Mostrar 10, 20, 50 100.
c. Se você tiver acesso de Editor, poderá clicar em Criar Blog.
d. Clique no título de um blog para abri-lo.
3. (Blog ou Biblioteca de Blogs) Visualize as postagens, listadas em ordem decrescente, da primeira à
última, e exiba o nome da pessoa que criou a postagem (Usuário) e a data e hora em que a postagem
foi criada.
a. Clique em Postagens do Blog Mais Recentes para visualizar o conteúdo do blog mais recente.
b. Movimente-se pela lista de postagens usando os controles da página.
c. Especifique quantas postagens deseja listar em uma página, escolhendo Mostrar 10, 20, 50 ou 100.
d. Se você tiver acesso de Editor, poderá Criar Postagem. Você pode editar e excluir postagens de
sua propriedade.
324
e. Se você tiver acesso de Usuário, poderá fazer um comentário em uma postagem.
Depois de visualizar as postagens, você pode incluir comentários para compartilhar suas ideias. Para
incluir um comentário, clique em Incluir um Comentário.
Excluindo Blogs ou Bibliotecas de Blogs
Se você for o proprietário de um site de blog, terá acesso de gerenciador e poderá excluir blogs, páginas,
comentários ou postagens desse site.
Para excluir um blog individual, abra o projeto que contém a biblioteca de blogs em um projeto. Para
excluir uma biblioteca de blogs inteira, use a página Administração do Portal.
1. Para excluir um blog de uma biblioteca, navegue até a página que contém a biblioteca de blogs.
2. Clique em Lista de Blogs.
3. Navegue até a biblioteca de blogs que contém o blog que você deseja excluir.
4. Clique em Excluir e em OK.
5. Para excluir uma biblioteca de blogs inteira, acesse Administração > Conteúdo do Portal >
Bibliotecas de Conteúdo da Web.
6. Navegue até a biblioteca que você deseja excluir e clique em Excluir biblioteca e em OK.
Wikis
Use wikis para compartilhar o conteúdo da comunidade sobre uma variedade de assuntos pertinentes aos
seus sites de intranet e extranet. Os wikis geralmente combinam texto com gráficos e links com outros
wikis e websites. Você pode monitorar e gerenciar seus próprios artigos do wiki.
Saiba sobre as Bibliotecas de Modelos Usadas por Wikis
Os wikis usam as bibliotecas de modelos fornecidas pelo IBM Web Content Manager. Os wikis usam a
biblioteca Web Resources v70 e a biblioteca Wiki v70. A hierarquia de página fornecida para wikis é a
hierarquia comum definida pelas bibliotecas de modelos do Web Content Manager.
Nota: As bibliotecas do Web Content Manager descritas neste tópico funcionam apenas com o
customizador de temas usado no tema padrão. A customização dessas bibliotecas afeta todos os wikis do
site.
Biblioteca Web Resources v70
A biblioteca Web Resources v70 fornece os modelos de autoria e de apresentação para wikis. Todos os
wikis no site usam essa única biblioteca compartilhada. As mudanças na biblioteca compartilhada
principal afetam todos os wikis.
Modelo do Wiki
Ao incluir um wiki em uma página, uma cópia da biblioteca Wiki v70 é criada usando o nome fornecido
ao incluir o wiki em uma página. A cópia da biblioteca Wiki v70 é usada para armazenar conteúdo de
página do wiki quando novas páginas forem incluídas nesse wiki.
Incluindo um Wiki em uma Página
Com o acesso do Editor ao portal ou à página do portal, é possível incluir um wiki em uma página para
criar e editar rapidamente conteúdo sequencial.
Consulte o Wiki do WebSphere Portal Family para obter um exemplo de como é possível modificar seu
tema customizado para ativar o recurso de incluir blogs e wikis em uma página.
2. Se ainda não tiver feito isso, crie uma página para o wiki ou abra uma página existente.
325
Clique na guia Conteúdo e, em seguida, clique em Comunicações.
Clique em Wiki.
Clique em Incluir na página.
Forneça um nome. Em seguida, clique em Incluir.
O nome é usado para o título do portlet, o título de exibição da biblioteca e o nome da biblioteca. Ele
pode conter caracteres alfanuméricos, espaços e os seguintes caracteres: $ - _ . ! ( ) ,. Se você usar
outros caracteres, eles serão substituídos por aqueles que são suportados pela biblioteca do IBM Web
Content Manager.
7. Clique em Salvar Rascunho.
Esta ação copia o biblioteca de modelos de wiki apropriada do Web Content Manager e coloca uma
instância do visualizador de conteúdo da web na página.
3.
4.
5.
6.
Após a publicação no site, clique em Nova Página para incluir conteúdo ou clique em Editar para
modificar o conteúdo. Para excluir uma página de wiki, clique em Excluir.
apenas quando houver uma única instância desse portlet na página. Quando você clica em um resultado
de tag, o Centro de Tags transmite as informações sobre o que o conteúdo deve exibir no visualizador
usando um parâmetro de renderização pública. Se houver várias instâncias de conteúdo da web exibidas
Incluindo Wikis Existentes em uma Página
Se você criou um wiki para outra página e agora deseja utilizá-la novamente, inclua um visualizador de
conteúdo da web na nova página e edite suas configurações para apontar para o wiki existente.
Consulte as etapas a seguir apenas quando estiver incluindo um portlet visualizador de conteúdo da web
do menu Propriedades da Página e configurando esse visualizador de conteúdo da web para apontar
para um wiki existente. Para criar um novo wiki, use o link Customizar para incluir um wiki em uma
página.
2. Se ainda não tiver feito isso, crie uma página para o wiki existente ou abra uma página existente.
3. Clique na guia Conteúdo.
4. Clique em Todos na lista de categorias e procure o portlet Visualizador de Conteúdo da Web (JSR
286).
5. Inclua o visualizador de conteúdo da web na página clicando no sinal de mais (+) ou arrastando o
visualizador para a página.
7. Clique no menu suspenso localizado na barra de título do visualizador de conteúdo da web e
selecione Editar Configurações Compartilhadas.
8. Em Tipo de Conteúdo, selecione Item de Conteúdo.
9. Em Conteúdo, clique em Editar.
10. Clique em Bibliotecas.
11. Clique na biblioteca que contém o wiki que você deseja incluir.
12. Expanda a biblioteca selecionada para localizar o wiki que você deseja usar.
13. Selecione o wiki e clique em OK.
14. Clique em Aplicar para salvar suas mudanças no visualizador de conteúdo da web.
15. Clique em Opções Avançadas.
326
16. Assegure-se de que a opção Transmitir Links para esteja configurada como Nenhuma ou Esta
Página do Portal.
17. Assegure-se de que a opção Receber links de esteja configurada como Este Portlet apenas ou
Outros Portlets e este Portlet.
18. Clique em OK.
apenas quando houver uma única instância desse portlet na página. Ao clicar em um resultado da
identificação, o Tag Center transmite as informações sobre o que o conteúdo deve exibir no visualizador
usando um parâmetro de renderização público. Se houver várias instâncias de conteúdo da web exibidas
Designando Acesso ao Wiki para Usuários
Se você for o administrador, terá acesso de Gerenciador e poderá designar acesso de Editor a outros
usuários que precisam criar e gerenciar dentro do site. Se você for o proprietário de um site de wikis, terá
acesso de Gerenciador. Como Gerenciador de site de wikis, você pode também excluir qualquer página
do wiki ou qualquer wiki. Se você tiver acesso de Editor, poderá criar e editar qualquer site de wikis e
páginas do wiki. Todos os editores de wikis podem modificar todas as páginas de um site de wikis.
Se você for um contribuidor, poderá visualizar as páginas do wiki. Por padrão, todos os usuários do
portal podem visualizar o conteúdo em um wiki, uma vez que ele tenha sido criado.
Para obter um exemplo de designação de acesso a usuários, consulte as seguintes instruções para incluir
usuários à função de Editor:
1. Acesse Administração > Conteúdo do Portal > Bibliotecas de Conteúdo da Web.
2. Navegue até a biblioteca que contém o wiki que você deseja gerenciar e clique em Configurar
Permissões.
3. Clique em Editar Função para a função Editor.
4. Clique em Incluir para designar a usuários ou grupos a função Editor. Procure os usuários ou grupos
que pertencem a esta função.
Excluindo Wikis
Se você for o proprietário de um site de wikis, terá o acesso de Gerenciador e poderá excluir qualquer
wiki ou páginas do wiki desse site.
É possível excluir um wiki e todas as suas páginas, excluindo-o de um projeto.
1.
2.
3.
4.
5.
Crie um projeto ou acesse um projeto existente e abra o projeto no modo de edição.
Abra a página que contém o wiki.
Na barra de ferramentas do site, clique em Mais > Excluir Página.
Clique OK.
Publique o projeto.
Limpando Páginas de Wiki Excluídas
Ao excluir uma postagem de wiki, ele é removido do site, mas permanece na visualização de exclusão no
IBM Web Content Manager. Os usuários com acesso de administrador às bibliotecas podem limpar essas
páginas de wiki excluídas, o que otimiza o desempenho da biblioteca de wikis. Limpar as páginas de
wiki excluídas removerá todas as ocorrências, incluindo todas as versões. Você não pode restaurar itens
excluídos após limpá-los.
327
Para limpar as páginas de wiki excluídas, conclua as seguintes etapas:
1. Selecione Aplicativos > Conteúdo > Web Content Management.
2. No Explorador de Biblioteca, selecione a biblioteca de wikis que contém as páginas que você deseja
limpar.
Dica: Se você não vir sua biblioteca, clique em Preferências > Configurar > Seleção de Biblioteca
para incluir a biblioteca na lista de seleção.
3. Selecione Visualizações de Itens > Itens Excluídos.
4. Selecione a página de wiki adequada e clique em Limpar. Clique OK.
Gerenciamento de Itens
Trabalhando com Pastas
Você usa pastas para agrupar conjuntos de tipos de itens em agrupamentos lógicos.
As pastas são usadas para agrupar conjuntos de tipos de item em agrupamentos lógicos. Isso é útil
quando você tem vários itens em sua biblioteca e deseja distinguir entre diferentes grupos de itens dentro
de cada visualização de tipo de item.
Por exemplo, você poderia criar as seguintes pastas de componentes para distinguir entre tipos diferentes
de componentes de imagem:
v Fotos
v Logotipos
v Diagramas
v Imagens de design
É possível criar pastas para os seguintes tipos de itens:
v modelos de autoria
v modelos de apresentação
v componentes
As pastas criadas são exibidas no portlet de autoria dentro de cada visualização de tipo de item.
v Apenas um único tipo de item pode ser armazenado por pasta. Por exemplo, se você criar uma pasta
na visualização Modelo de Apresentação, apenas os modelos de apresentação poderão ser salvos nesta
pasta.
v É possível criar pastas em pastas existentes, permitindo criar uma estrutura hierárquica de pastas.
v Inclua os itens às pastas selecionando uma pasta como um local quando você criar um item ou
movendo ou copiando um item para uma pasta existente.
Gerenciando Versões de Itens
for publicado, ou permitir que os usuários selecionem quando salvar uma versão de um item. É possível
restaurar itens individualmente ou optar por restaurar um conjunto de itens dentro de uma biblioteca que
tenha o mesmo rótulo ou com versão na data e hora especificadas, ou antes delas. A versão é controlada
por meio dos serviços de configuração do Web Content Manager no WebSphere Integrated Solutions
Console e é ativada por padrão.
328
Controle de Versão no Nível de Item
v Se a versão automática estiver ativada, uma versão será salva sempre que um item for salvo, ou se o
item estiver participando de um fluxo de trabalho, sempre que o estado do item mudar para
publicado. Não é possível salvar as versões dos itens de rascunho.
v Se o desenvolvimento de versões manual estiver ativado, os usuários com acesso ao editor ou superior
poderão salvar manualmente versões de itens publicados. Você pode restaurar uma versão
visualizando o histórico de versão de um item e selecionando uma versão a ser restaurada.
v Quaisquer relacionamentos hierárquicos com outros itens não são salvos. Por exemplo, se você salvar
uma versão de uma área de site que tenha áreas de site filhas e excluí-las, as áreas de site filhas não
serão restauradas se a área de site pai for restaurada.
v Se você tiver links para recursos externos dentro de um item, uma cópia do item externo não será salva
quando uma versão for criada. Se você excluir o recurso externo, não será possível usar o recurso de
versão do Web Content Manager para restaurar o recurso externo.
Nomes de Itens: Um nome de item é independente do controle de versão. Por exemplo, alterar o nome
da versão 4 alterará também o nome de todas as versões desse item.
Controle de Versão no Nível da Biblioteca
v Não é possível optar por salvar uma versão de uma biblioteca inteira. Apenas aqueles itens que tinham
versões salvas usando controles de versão de nível de item são salvos em uma biblioteca.
v É possível restaurar um conjunto de itens em uma biblioteca que tenha o mesmo rótulo ou com versão
na data e hora especificadas, ou antes delas.
É possível aplicar um rótulo ao conjunto mais recente de versões salvas em uma biblioteca a qualquer
momento e, então, restaurar todos os itens com o mesmo rótulo em uma data posterior.
Nota: Os rótulos que você aplica a versões não são organizados para assinantes.
Limpando Histórico da Versão
A ferramenta de limpeza de versões pode ser usada para limpar históricos de versões de itens. Ela é
configurável e pode ser usada para limpar versões em um intervalo de data específico, para tipos de itens
ou bibliotecas específicos, ou para um determinado número de versões mais recentes.
“Limpando Histórico da Versão” na página 580
Use a ferramenta limpar versões para limpar o histórico da versão de um item.
Itens Bloqueados e de Rascunho
À medida que você trabalha em colaboração com outros usuários, encontrará itens que estão bloqueados
por outros usuários, porque estão sendo editados por outro usuário ou porque um item de rascunho foi
criado.
Trabalhando com Itens Bloqueados
Quando um usuário estiver editando um item, o item ficará bloqueado para outros usuários. Isso
significa que outros usuários não poderão editar o item até que o usuário atual feche o item que está
sendo editado. Um símbolo de bloqueio
é exibido nos itens que estão bloqueados no momento.
Os usuários com acesso de administrador podem desbloquear itens que estão sendo editados atualmente
por um usuário selecionando um item e, em seguida, clicando no botão Desbloquear.
Os usuários com acesso de gerente também podem desbloquear itens desde que tenham acesso de
gerente ao item e à biblioteca em que ele está armazenado.
329
Opções de Bloqueio de Item Hierárquico
O bloqueio de áreas de site, taxonomias e categorias são configuráveis e não está ativado por padrão.
Quando o bloqueio estiver ativado para áreas de site, não será possível criar nenhum filho dentro da área
de site bloqueada. Por exemplo, se uma área de site estiver bloqueada, não será possível criar nenhuma
área de site ou item de conteúdo nessa área de site até que ela seja desbloqueada. Isso se aplica apenas
aos filhos diretos de um pai bloqueado. Itens descendentes de um filho de um pai bloqueado não são
afetados.
Trabalhando com Itens de Rascunho
Quando um novo rascunho de um item publicado for criado, um visto será exibido no item publicado.
Excluindo um Item
Nem sempre é possível excluir imediatamente os itens. Às vezes, é necessário executar etapas para
preparar um item para exclusão.
Para excluir um item:
1. Selecione um item em um índice.
2. Clique em Excluir.
É possível visualizar uma lista de itens excluídos nas visualizações Visualizações de Itens > Itens
Excluídos ou Visualizações Pessoais > Meus Itens Excluídos.
Integridade Referencial
Ao excluir itens que são referenciados por outros itens, é necessário resolver todas as referências que
serão interrompidas pela exclusão do item. Será aberto um diálogo listando os itens que não podem ser
excluídos:
v Selecione um item na lista e clique em Editar Referências.
– Selecione um item e clique em Substituir Referência para substituir o item que está sendo excluído
atualmente por um item diferente. Por exemplo, se você estiver excluindo um componente de texto
referido em um modelo de apresentação, poderá substituir a referência ao componente de texto que
está sendo excluído por um componente diferente.
– Selecione um item e clique em Limpar Referência para remover a referência ao item que você está
excluindo. Por exemplo, se você estiver excluindo um modelo de apresentação mapeado de um
modelo de autoria, poderá optar por limpar a referência para o modelo de autoria.
Nota:
v As opções de integridade referencial disponíveis ao excluir itens dependerão do nível de integridade
referencial aplicada aos diferentes itens.
v Haverá ocasiões em que apenas uma opção estará disponível.
v Outros itens podem não estar aptos a serem excluídos de forma alguma.
v Referências aos modelos de autoria podem ser alterados apenas usando o recurso Aplicar Modelo no
próprio item.
Restaurando Itens
Você pode restaurar um item excluído restaurando uma versão de um item. Consulte Gerenciando
Versões de Itens para obter informações adicionais.
330
Limpando Itens
Os usuários que receberam acesso de gerenciador ou acima para uma biblioteca poderão limpar itens
excluídos, selecionando-os na visualização "Todos os Itens" e, em seguida, clicando em Limpar. Isso
removerá todas as ocorrências do item selecionado, incluindo todas as versões. Não é possível restaurar
itens limpos.
Visualizando Referências de Item
A ferramenta "Visualizar Referências" ajuda você a visualizar e gerenciar todos os links entre os itens.
Há duas maneiras de acessar o botão Visualizar Referências (View References):
1. Abra um item e clique no botão Visualizar Referências (View References).
2. Selecione um item em um índice e clique em Mais Ações > Visualizar Referência.
Para visualizar referências:
Clique no botão Visualizar Referências (View References).
1. Para visualizar os itens que fazem referência a um item, selecione Mostrar Referências ao Item (Show
references to item).
2. Para visualizar os itens que são referidos por um item, selecione Mostrar Referências do Item (Show
references from item).
Personalização
O Portal Personalization fornece customização automática de conteúdo do website para usuários e grupos
de usuários individuais.
O Personalização pode reconhecer um usuário específico com base em um perfil ou determinar as
características de um usuário com base em compras anteriores, produtos ou páginas visualizadas, e assim
por diante. O Personalização então seleciona o conteúdo apropriado para esse perfil. Se uma pessoa
estiver em uma faixa alta de salário, o Personalização pode ser configurado para recuperar informações
sobre um produto comercial especial do website. Se um indivíduo pertencer a uma região geográfica
específica, o conteúdo específico para essa região pode ser destinado ao indivíduo. A página é montada
com as informações personalizadas apropriadas e o usuário vê sua página personalizada.
O Personalização é formado por
v Navegador do Personalização - A interface com o usuário do Personalização:
– registra coletas de recursos
– cria regras, campanhas e pontos e conteúdo
– mapeia regras para pontos de conteúdo de uma campanha específica
Como os objetos são criados através do servidor do Personalização, o navegador do Personalização
pode exibir regras de produção e pode também visualizar regras em um ambiente de migração de
dados.
v Mecanismo de regras - O mecanismo de regras executa regras criadas no navegador do Personalização.
Uma interface de programação existe para que o Personalização chame regras, as regras do
Personalização podem ser chamadas através do portlet Lista Personalizada ou as regras podem ser
chamadas através de componentes do Web Content Manager Personalização. As regras associadas a
páginas ou portlets por meio de Administração do Portal (Portal Administration) também são
automaticamente disparadas.
v Mecanismo de Recomendação do LikeMinds - O mecanismo de recomendação avalia as regras de
recomendação criadas no navegador do Personalização.
331
v Mecanismo de Recurso - O mecanismo de recurso resolve as consultas produzidas por regras em
partes de conteúdo a serem retornadas. O conteúdo do Personalização é criado e aprovado utilizando
qualquer ferramenta de gerenciamento de conteúdo escolhida ou pode vir de um LDAP ou de
qualquer outro banco de dados. O conteúdo é acessado através de um conjunto de classes de Coleta de
Recursos.
v Uma estrutura de criação de log - A estrutura de criação de log é usada para gravar informações sobre
o uso do website no banco de dados de feedback e no mecanismo de recomendação. É total
responsabilidade dos desenvolvedores do site decidir quais informações são registradas.
Os mecanismos são, às vezes, referidos coletivamente como servidores de tempo de execução do
Personalização.
O mecanismo identifica o usuário específico. O Personalização recupera o perfil dessa pessoa. Por
exemplo, uma pessoa pode ter sua faixa de salário incluída em seu perfil. O Personalização então
seleciona o conteúdo apropriado para esse perfil. Se uma pessoa estiver em uma faixa alta de salário,
tiver um código de região, ou outras informações, o Personalização pode ser configurado para recuperar
informações sobre um produto comercial especial do website. A página é montada com as informações
personalizadas apropriadas. O usuário vê sua página personalizada.
Tipos de Personalização
Há três tipos de Personalização:
Filtragem Simples
Um site exibe conteúdo baseado em grupos pré-definidos de visitantes do site. Por exemplo, se
um visitante do site pertencer ao departamento de Recursos Humanos, o site oferece acesso a
URLs contendo manuais de política de Recursos Humanos.
Mecanismos de Regras
Em um sistema baseado em regras, o proprietário do site define um conjunto de regras de
negócios que determinam qual categoria de conteúdo é mostrada quando um determinado tipo
de perfil visita o site. Por exemplo: Exibir todos os utilitários esportivos com tração nas quatro
rodas para visitantes de região nordeste na faixa de 21 a 35 anos.
Essa abordagem tem a vantagem de orientar o comportamento do site pelos objetivos de negócios
do proprietário do site. O proprietário do site é geralmente o proprietário de uma campanha de
marketing ou é gerente de alguma empresa.
Filtragem Colaborativa
Um visitante do site classifica uma seleção de produtos, explícita ou implicitamente. Essas
classificações são comparadas às classificações oferecidas por outros visitantes. Algoritmos de
software detectam semelhanças. Por exemplo, um visitante recebe recomendações de livros com
base em compras semelhantes de outros.
Filtragem de Regras Versus Colaborativa
Quando uma filtragem complexa é necessária, o sistema baseado em regras pode ter melhores resultados
que a filtragem colaborativa e vice-versa. Os detalhes da tabela a seguir mostram exemplos nos quais um
tipo de personalização é melhor que o outro.
Tabela 112. Quando utilizar filtragem de regras versus filtragem colaborativa.
Cenário
Qual tipo de filtragem utilizar
Razão
Se o número de itens oferecidos e de
usuários que os compram for
consideravelmente baixo.
Regras
Pouco espaço para computar
semelhanças de usuários necessárias
para filtragem colaborativa.
Se os preços estiverem altos ou a
frequência de compra for baixa.
Regras
Áreas finitas e limitadas - filtragem
colaborativa falha devido à falta de
diversidade inerente.
332
Tabela 112. Quando utilizar filtragem de regras versus filtragem colaborativa. (continuação)
Cenário
Qual tipo de filtragem utilizar
Razão
Se houver uma dependência
pré-existente entre itens. Exemplo:
Seguro por invalidez solicitado para
proprietário de casa
Regras
Recomendar um seguro por invalidez
só porque a filtragem colaborativa
indica que vários outros "usuários
como este" também compraram um
seguro é incorreto--é necessário ter
primeiro o seguro residencial.
Se o número de itens oferecidos e de
usuários que os compram for
consideravelmente alto.
Colaborativa
Impossível criar regras abrangendo
todos os itens.
Se os preços forem baixos, muito
diferentes ou se os produtos
oferecidos forem de interesse para
uma grande variedade de usuários.
Colaborativa
Variedade grande adapta-se à
abordagem de filtragem colaborativa.
A filtragem colaborativa também
reduz o risco de se fazer
recomendações "erradas".
Quando não há muitas informações
reunidas sobre o usuário, mas é
possível identificá-lo,provavelmente
através de um login ou de um
cookie.
Colaborativa
Nesse caso, pode haver falta de
atributos nos quais as regras devam
ser baseadas. A filtragem colaborativa
pode comparar as experiências do
usuário no site com outros usuários.
“Desenvolvimento de um Portlet Personalizado” na página 439
Este exercício demonstra como utilizar os recursos do Personalization do WebSphere Portal e do Rational
Application Developer para construir seu primeiro portlet personalizado. O resultado final será um
portlet em pleno funcionamento que utiliza regras e pontos de conteúdo do Personalization para exibir
notícias pessoais com base em atributos do usuário (ou perfis).
Notas Técnicas para Personalização
Como um Site é Personalizado
Use este tópico para entender como definir uma lista personalizada de novos artigos para um website,
como uma seção de um site de intranet para boletins de funcionários de destino ou onde o conteúdo do
site é adequado ao usuário específico.
Desenvolvendo um Portlet ou Website Personalizado
1. Um desenvolvedor da web define uma área de um site que precisa do Personalização. Essa área pode
ser uma lista personalizada de novos artigos que aparecem em um website, um local em um site de
intranet para boletins de funcionários de destino, como mudanças nos planos de benefícios, uma lista
de produtos em um website de comércio ou qualquer outro local no qual o conteúdo do site deve ser
adequado ao usuário específico.
2. Um conjunto de Coletas de Recursos e Objetos de Aplicativos é definido. Juntos, esses objetos formam
um vocabulário de negócios que representa os termos e objetos nos quais serão baseadas as decisões
do Personalização. Esses objetos podem ser definidos na página da web que apontam para um tipo de
item do IBM Java Content Repository. Esses objetos podem ser gerados através de um conjunto de
assistentes do Personalização, fornecidos com o IBM Rational Application Developer; ou podem ser
desenvolvidos de acordo com um conjunto de interfaces de programação públicas.
3. As Coletas de Recursos e os Objetos de Aplicativos são registrados no servidor do Personalização
através do navegador do Personalização importando-se arquivos .hrf. Esses arquivos definem Coletas
de Recursos. O desenvolvedor também pode criar manualmente as referências da Coleta de Recursos
e Objeto de Aplicativo no Navegador de Personalização.
333
Nota: As classes usadas para Coleções de Recursos e Objetos de Aplicativos devem estar no caminho
de classe dos dois aplicativos que estão sendo personalizados e para o aplicativo da web do
navegador do Personalização. Uma forma de realizar essa tarefa é usar uma biblioteca compartilhada
inserida no servidor de aplicativos ou nos aplicativos da web individuais. Se você estiver utilizando
coletas de recursos fornecidas com o IBM WebSphere Portal, como Coleta de Recursos do Usuário do
Portal (Portal User Resource Collection) ou Coleta de Recursos (Resource Collection) do Java Content
Repository, esses caminhos de classe já estarão registrados corretamente.
4. Programadores utilizam agora objetos e termos definidos através das Coletas de Recursos e dos
Objetos de Aplicativos para gravar regras e mapear essas regras para pontos de conteúdo utilizando
campanhas.
5. Os desenvolvedores de portlet e do website podem configurar um portlet Rule Display ou spot de
conteúdo do Personalização ou podem fazer chamadas nas interfaces de programação do
Personalização para executar as regras ou spots de conteúdo adequados que os programadores
definiram.
Nota: O Ponto de Conteúdo oferece meios para desenvolvedores de site desenvolverem páginas
personalizadas antes das regras serem criadas, além de meios de relacionar de modo mais livre uma
determinada regra a uma página. O programador deve, então, "mapear" o Ponto de Conteúdo para uma
Regra utilizando um Mapeamento de Regra de uma Campanha de um navegador do Personalização.
Usando Regras do Personalização
1. Um usuário navega nas páginas contendo regras do Personalização ou pontos de conteúdo.
2. O aplicativo chama o Personalização para localizar conteúdo ou tomar decisões.
3. O Personalização identifica as regras corretas a serem executadas. Se um Ponto de Conteúdo com o
nome determinado para executar não for encontrado, procura-se uma regra diretamente com esse
nome.
4. O servidor Personalização procura todos os Mapeamentos de Regras para o Ponto de Conteúdo. O
servidor procura Regras de Mapeamentos que foram iniciadas, mas ainda não encerradas.
5. Os Mapeamentos de Regra são ordenados com base nos valores de prioridade e de divisão. As regras
associadas a cada mapeamento são executadas sucessivamente, até que uma regra retorne conteúdo.
Nota: É possível configurar o Personalização para que apenas a primeira regra (prioridade mais alta)
seja executada.
6. Para cada regra executada, o Personalização recupera o perfil do usuário e avalia a regra para
selecionar o conteúdo que atende as condições da regra. O mecanismo de regras irá chamar o
mecanismo do recurso da maneira necessária para recuperar partes do conteúdo.
7. O conteúdo é retornado à página da web e exibido para o usuário.
“Desenvolvimento de um Portlet Personalizado” na página 439
Este exercício demonstra como utilizar os recursos do Personalization do WebSphere Portal e do Rational
Application Developer para construir seu primeiro portlet personalizado. O resultado final será um
portlet em pleno funcionamento que utiliza regras e pontos de conteúdo do Personalization para exibir
notícias pessoais com base em atributos do usuário (ou perfis).
Termos do Personalização
Os conceitos e princípios para trabalhar com o Portal Personalization requerem um entendimento da
terminologia.
Recursos, Instâncias de Recursos e Coletas de Recursos
Antes de poder personalizar recursos do IBM WebSphere Portal, você precisa entender os termos para
objetos do portal armazenados no repositório de conteúdo.
334
Um recurso é uma classe Java que define as propriedades de um objeto de usuário ou de conteúdo. Em
termos de banco de dados, é análogo ao esquema de banco de dados que define os nomes de colunas e
tipos para uma tabela de banco de dados. As classes de recursos devem implementar a interface
com.ibm.websphere.personalization.resources.Resource
Uma instância de recursos é uma instância da classe de recursos. Novamente, utilizando uma comparação
com um banco de dados, a instância de recurso é semelhante a uma linha de banco de dados porque
contém valores reais para cada propriedade definida pelo recurso.
Uma coleta de recursos é uma classe Java que representa e permite o acesso a uma coleta de instâncias de
recursos. É semelhante a uma tabela de banco de dados com um esquema fixo e um número de linhas.
As classes de coleta de recursos devem implementar a interface
com.ibm.websphere.personalization.resources.ResourceDomain3. O Rational Application Developer
fornece um assistente que pode criar coletas de recursos que armazenam dados em bancos de dados SQL
ou repositórios LDAP. As classes que podem constituir a coleta de recursos são as seguintes:
Classe de Recurso
Uma instância de com.ibm.websphere.personalization.resources.
Classe de Gerenciador de Recursos
Uma instância de com.ibm.websphere.personalization.resources.ResourceManager3.
Classe de Domínio
Uma instância de com.ibm.websphere.personalization.resources.ResourceDomain3.
Classe de Conversor
Uma instância de com.ibm.websphere.personalization.resources.AuthIDTranslator.
Para obter mais detalhes, consulte a documentação da API Javadoc para APIs de Personalização. É
possível fornecer sua própria implementação dessas classes ou usar o Assistente de Personalização RAD
para gerar classes que sejam consultadas em repositórios SQL ou LDAP.
Embora recursos, instâncias de recursos e coletas de recursos possam ser facilmente mapeados para
conceitos conhecidos de banco de dados, é importante observar que o armazenamento de conteúdo real a
que eles se referem não precisa ser uma tabela de banco de dados. Pode ser um sistema de arquivos, um
repositório LDAP, um armazenamento XML ou praticamente qualquer armazenamento de conteúdo
acessível pelo Java.
Recursos do Usuário
Os visitantes de seu Web site desejam acessar rapidamente o conteúdo da Web que atende às suas
necessidades e aos seus interesses. As necessidades e os interesses dos visitantes do site são armazenados
como propriedades no data store de perfis de usuários.
Muitos sites obtém as necessidades e preferências do usuário utilizando um formulário de entradas em
HTML. O formulário de entradas inclui informações que raramente são alteradas (como nome e endereço
do usuário) e informações que devem ser atualizadas periodicamente (como listas de presentes
desejados). Além das informações explícitas fornecidas pelo visitante do site no formulário de entrada em
HTML, uma empresa também pode atualizar o data store de perfis de usuários de modo programático
com informações obtidas de outras fontes. Essas fontes podem incluir uma análise das ações de um
usuário no Web site e dados a partir de interações não realizadas na Web de um usuário com a empresa.
Embora os usuários sejam exclusivos, a personalização do conteúdo da Web normalmente não requer a
criação do conteúdo totalmente exclusivo para cada usuário. Os usuários podem ser classificados em
perfis ou agrupados em categorias que facilitam a personalização. Por exemplo, em um site interno da
Web, determinadas informações podem ser apropriadas para gerentes, enquanto outro conteúdo pode ser
adequado para vendedores.
335
Nota: A coleta de recursos Coleta de Usuários do Portal incluída com o Personalization não pode ser
atualmente utilizada para selecionar listas de usuários em regras de conteúdo de seleção. A coleta de
recursos pode ser utilizada para criar o perfil do usuário em uma regra do gerenciador de perfis. Isso se
aplica tanto a coleta de recursos de usuários, a qual é instalada com o Personalization, quanto a
quaisquer coletas de recursos personalizados criados com a classe do gerenciador
com.ibm.websphere.personalization.resources.wps.UserManager.
Recursos de Conteúdo
Os recursos de conteúdo da Web consistem em dados que são formatados e exibidos nas páginas da Web.
Os exemplos incluem artigos de notícias, produtos, estatísticas e materiais educativos.
O conteúdo é exibido quando um usuário solicita uma JSP ou um servlet que gera e formata
dinamicamente uma página da Web no formato apropriado, como HTML ou XML. Ao personalizar o seu
Web site, você apenas precisa personalizar o conteúdo que deseja exibir (ou ocultar) seletivamente com
base no usuário. Por exemplo, uma determinada página pode consistir em 40% de conteúdo estático e
60% de conteúdo variável com base em características de usuários ou condições de negócios específicas,
enquanto outras páginas podem ter 100% de conteúdo estático.
Os recursos de conteúdo podem ser um conteúdo de arquivo ou um conteúdo estruturado.
Administração Baseada em Atributo
A administração baseada em atributo fornece um recurso para customizar o layout de uma página para
usuários individuais autenticados, utilizando regras para mostrar ou ocultar páginas ou portlets. Essa
implementação informa o portal para mostrar ou ocultar páginas e portlets com base em características
dinâmicas que são determinadas no tempo de execução. Administração Baseada em Atributo está
disponível apenas para usuários autenticados. Para usuários anônimos, todas as páginas são mostradas.
As regras do Portal Personalization podem ser utilizadas para controlar se uma página é exibida na
navegação do site; isso é gerenciado escolhendo uma regra apropriada para o atributo do usuário que
você deseja ativar para ver a página. Se a regra retornar true, a página ou o portlet será mostrado; do
contrário, será ocultado. Se o Personalização não estiver instalado ou se não estiver ativado nas
configurações de propriedades, você não verá essa opção.
Controle de Acesso e Regras de Visibilidade
O Controle de Acesso (Access Control) e as Regras de Visibilidade (Visibility Rules) influenciam no que
aparece em uma página de portal ou portlet. Controle de Acesso (Access Control) determina o que um
usuário tem permissão para ver em uma página ou em um portlet. Para ver páginas e portlets, um
usuário deve ser explicitamente definido como um membro do grupo que tem acesso. Os grupos são
organizados em uma hierarquia e são designadas funções para cada grupo como administradores ou
editores.
As regras de visibilidade determinam o que um usuário verá ou o que foi destinado para ele, e o
Controle de Acesso (Access Control) baseia-se na associação de grupo, regras de visibilidade utilizam
qualquer tipo de informação, incluindo atributos LDAP ou hora do dia. Por exemplo, se você desejar
ocultar um portlet para um indivíduo em determinada geografia, armazene o local como um atributo em
LDAP e designe uma regra de visibilidade que oculte o portlet. Por exemplo, um usuário pode precisar
acessar os números da renda de todas as divisões em todo o ano, mas esses números não devem ser
exibidos proeminentemente, exceto quando forem liberados primeiro. Durante uma semana depois que os
números forem liberados pela primeira vez, os números para a divisão do funcionário deverão mostrar
proeminente em suas páginas iniciais. A regra de visibilidade oculta estatísticas para divisões em que o
funcionário não está e somente mostra as estatísticas do funcionário na semana depois que elas foram
liberadas.
O Controle de Acesso (Access Control) tem precedência sobre as regras de visibilidade. Você deve ter
acesso a uma página ou portlet antes de aplicar regras de visibilidade. O Controle de Acesso (Access
336
Control) também determinará se uma página ou um portlet será retornado em uma procura; se um
usuário não tiver acesso, ele não poderá ver o portlet ou a página em resultados da procura. Se um
usuário tiver acesso a um portlet ou uma página, mas tiver a regra de visibilidade configurada para
ocultar a página ou o portlet, ele será mostrado em resultados da procura.
Designando um atributo com base nas regras de administração para páginas e portlets:
As regras de administration baseadas em atributo podem ser designadas manualmente no portal, nos
portlets Edit Properties e Edit Layout ou por meio da interface de configuração do XML. A regra deve
estar presente no sistema para que seja designada a uma página ou portlet. Para realizar isso, geralmente
você pode usar Publicação de Personalização.
v Para mapear regras, os usuários que não são administradores devem receber pelo menos acesso de
usuário à regra que está sendo mapeada e acesso de edição à página ou ao portlet em que a regra está
sendo mapeada.
v Páginas ou portlets em páginas derivadas mostrarão uma regra de visibilidade herdada se nenhuma
regra for definida para eles. Não é possível limpar as regras de visibilidade herdadas nas páginas
derivadas.
Utilizando a interface de configuração do XML, você pode designar uma regra para uma página ou um
portlet. Configure o parâmetro com.ibm.portal.navigation.rule para indicar a regra a ser designada
para a página ou o portlet. O valor do parâmetro deve ser o ID ou UUID exclusivo da regra. O UUID
pode ser localizado exportando a regra na interface com o usuário do Personalização e inspecionando o
XML exportado para o parâmetro jcr:uuid.
Por exemplo, para designar uma regra com o UUID 7ce9d5004ee31f41b0d3b944c9f7965c para uma página
ou um portlet, inclua o seguinte parâmetro ao content-node no script de acesso de XML:
<parameter name="com.ibm.portal.navigation.rule" type="string"
update="set"><![CDATA[7ce9d5004ee31f41b0d3b944c9f7965c]]</parameter>
Alterando o Comportamento da Condição de Erro:
Se um erro ocorrer ao localizar ou usar uma regra designada para uma página ou portlet, por padrão,
essa página ou portlet será oculta. Se um usuário ou aplicativo esperado não existir, o sistema continuará.
Esse comportamento pode ser adequado, mas em um ambiente de desenvolvimento, você pode precisar
alterá-lo para fins de teste. Atualize o arquivo PersonalizationService.properties para substituir esse
comportamento globalmente.
A propriedade rulesEngine.visibilityDefault especifica se haverá renderização de uma página ou portlet
caso haja um problema com a regra designada. Alterar o valor de propriedade para exibição significa que
a página ou o portlet será exibido mesmo se a regra designada não puder ser localizada ou se houver um
problema com ela.
A propriedade rulesEngine.throwObjectNotFoundException especifica o que ocorrerá se um objeto, por
exemplo um usuário, não for localizado quando necessário durante a execução da regra. Isso poderá
ocorrer quando o Personalização não conseguir localizar o usuário atual ou quando um objeto de
aplicativo esperado não existir na sessão ou pedido na chave esperada. Quando configurada como false,
um usuário ou objeto nulo não é tratado como um erro, em vez disso, é simplesmente impresso para os
registros como um aviso. O Personalização continuará como se o próprio atributo solicitado do objeto
nulo também fosse nulo.
Por exemplo, se nenhum objeto de usuário for encontrado e rulesEngine.throwObjectNotFoundException
estiver configurado como false, uma regra, por exemplo, Mostrar página ou portlet quando user.name
for nulo (Show page or portlet when user.name is null), retornará show. Um usuário nulo será tratado
como se o nome do usuário fosse nulo. Contudo, se nenhum objeto de usuário for encontrado e
rulesEngine.throwObjectNotFoundException estiver configurado como true, a mesma regra emitirá uma
337
exceção. Se tal regra for utilizada para determinar a visibilidade de uma página ou portlet, o resultado
definitivo dependerá do valor da propriedade rulesEngine.visibilityDefault, que decidirá o que ocorrerá
quando uma exceção for emitida durante o processamento de uma regra na administração baseada em
atributos.
1. Abra o arquivo PersonalizationService.properties. Esse arquivo está localizado no seguinte
diretório:wp_profile_root/PortalServer/config/config/services/PersonalizationService.properties.
2. Localize a propriedade rulesEngine.visibilityDefault.
3. Configure o valor dessa propriedade como show para permitir que os portlets ou páginas sejam
renderizados se ocorrer um erro.
4. Ajuste a propriedade rulesEngine.throwObjectNotFoundException.
5. Configure o valor dessa propriedade como true para lançar uma exceção se o objeto não for
localizado
Regras
As regras são utilizadas para definir como seu Web site vai interagir com indivíduos e grupos de
visitantes do Web site. As regras são compostas de instruções lógicas de fácil leitura que, em sua forma
final, especificam como avaliar várias condições e quais ações tomar com base nessas condições.
Ações:
As ações utilizam instruções simples de avaliação para selecionar o conteúdo a utilizar ou exibir, ou para
definir informações. Cálculos aritméticos básicos (soma, subtração, multiplicação, divisão), que seguem
uma ordem de operações, podem ser utilizados em ambos os lados da avaliação; parênteses não são
suportados. As ações podem ser combinadas com gerenciadores de perfil em ligações.
Os seguintes itens de ação são suportados:
Ações de Seleção
Selecione dados ou conteúdo. As ações de seleção recuperam dados de um armazenamento de
dados, geralmente para exibição em uma página da web. As ações de seleção também podem ser
usadas dentro de ligações para excluir certos conteúdos, por exemplo, para filtrar um
subconjunto do conteúdo retornado de um superconjunto.
Ações de Atualização
Atualize conteúdo ou objetos sob pedido. As ações de atualização não podem selecionar
conteúdo. As ações atualizar são utilizadas para armazenar conteúdo ou dados no perfil do
usuário, um objeto de aplicativo ou outros data stores.
Ações de Email
Envie mensagens de email usando uma página da web como o corpo. As ações de email não
podem selecionar conteúdo. Uma ação de email envia uma mensagem de email para um
destinatário ou uma lista de destinatários. Uma ação de email designada a um ponto de conteúdo
envia uma mensagem de email quando o ponto de conteúdo é acionado. Por exemplo, no
momento em que um visitante do website visualiza uma página com o ponto de conteúdo.
O editor da ação de email permite que os campos que identificam os destinatários (principal,
cópia e cópia oculta), a linha de assunto e o emissor sejam identificados por texto explícito ou por
atributos de recursos. O corpo do email é um arquivo separado, como um arquivo de texto, um
arquivo HTML ou uma JSP, que devem estar acessíveis no servidor de email por meio de um
URI. Uma JSP enviada por email pode conter pontos de conteúdo para personalizar a mensagem
de email do usuário que aciona o ponto de conteúdo.
Embora as ações de email são um pouco diferentes das promoções de email, ambas possuem
pré-requisitos que devem ser adequados e estar operacionais para que o email possa ser enviado.
Exemplo: Ação Simples de Seleção de Conteúdo:
338
Visualize um exemplo de uma ação simples de seleção de conteúdo.
A ação selecionar conteúdo mostrada aqui, Obter Notícias do Banco por Função, consulta todos os
registros em um recurso de conteúdo intitulado Notícias e retorna aqueles marcados como sendo para a
função do usuário atual.
O recurso de conteúdo YourCoNews representa artigos de notícias no data store. Cada registro possui
vários campos diferentes (por exemplo, Título, Abstrato, Autor, Corpo), incluindo um campo intitulado
Função. No data store, esse campo é marcado para indicar a função do visitante ao qual ele se aplica.
Ação Selecionar Conteúdo Simples
Select NewsArticle
whose Role is current User.Role
order as is
Exemplo: Ação Simples de Atualização:
Visualize um exemplo de uma ação de atualização que faz parte de um Web site que permite que
visitantes gerenciem determinadas informações e preferências sobre eles próprios.
Quando executada, esta ação de atualização gravará nos campos (Grupo de Rendimentos, Função) no
datastore do registro associado ao usuário atual (o visitante atual do Web site), utilizando dados contidos
nas variáveis de sessão do usuário atual, como incomeGroup e role.
Ação de Atualização
Update
current
current
current
current
Portal
Portal
Portal
Portal
Users.Income Group set to current Session.incomeGroup
Users.Role set to current Session.role
Users.Last Name set to current Session.lastName
Users.Title set to current Session.title
Exemplo: Ação Simples de Email:
Esse exemplo de regra de ação de email é típico de um que poderia ser usado depois que um visitante
do website submete um formulário indicando interesse em um item ou serviço.
A regra de ação de email pode ser anexada a um spot de conteúdo que, quando acionado pelo visitante
que visualiza a página com o spot, envia o email indicado pelo campo bodyURI para esse visitante. Esse
email também é enviado como cópia oculta para alguém na empresa de amostra.
Regra de Ação de Email
To: current Portal Users.Email Address
From: [email protected]
bcc: [email protected]
Subject: Today’s Mortgage Rates
Body URI /email/mortgage-rates.jsp
“Administração de Email” na página 354
Visualize as etapas que precisam ser concluídas para que o servidor de tempo de execução envie email
personalizado.
Perfis:
Definidores de perfil são normalmente utilizados para categorizar um indivíduo (em geral, o visitante
atual do site) de acordo com as suas propriedades de usuário.
339
Ao lado das propriedades de um usuário, os definidores de perfis podem ser usados para definir outras
condições, com base em fatores como data e hora atuais, tipo de navegador que o visitante usa ou outras
propriedades de objetos de aplicativos implícitas ou explícitas. Os definidores de perfil também podem
tomar decisões com base nos atributos de sessão do usuário atual e atributos e parâmetros de solicitação,
juntamente com contagens de categorias e ações.
Os definidores de perfil podem ser construídos para definir as condições de perfis denominados
arbitrariamente ou podem ser definidos em termos de outros definidores de perfil. Por exemplo, é
possível criar um definidor de perfil que será avaliado como verdadeiro se um perfil estiver em qualquer
ou nenhum grupo de outros perfis ou em todos esses grupos.
Exemplo: Gerenciador de Perfil Simples:
Visualize um exemplo de um gerenciador de perfis simples que determina se novos artigos confidenciais
da empresa serão mostrados ao visitante atual do site da Web.
O gerenciador de perfil Autorização do Usuário baseia-se em um recurso do usuário denominado
Pessoal. Quando o gerenciador de perfil foi criado, o nome Autorização do Usuário e as definições,
Confidencial e Normal, foram definidos arbitrariamente para referência posterior nas ligações. Um lado
da linha de comparação (current Personnel.Role) refere-se a um recurso de usuário denominado
Personnel criado a partir da tabela Pessoal em um banco de dados. Role é um valor mapeado, definido
quando o recurso foi criado, que aponta para a coluna Personnel.Role na tabela Personnel. Os valores na
coluna Função no banco de dados são Funcionário, Executivo ou Gerente.
Esse gerenciador de perfil concluído é utilizado em uma ligação como um meio de determinar se artigos
de notícias confidenciais da empresa serão mostrados ao visitante atual do Web site.
Gerenciador de Perfis Simples
User Clearance is
Confidential when
current Personnel.Role is Executive or
current Personnel.Role is Manager
Otherwise Regular
Exemplo: Gerenciador de Perfil Aninhado:
Visualize um exemplo de um gerenciador de perfis aninhado.
Um gerenciador de perfil aninhado será verdadeiro se algum, todos ou nenhum dos gerenciadores de
perfil no gerenciador de perfil for(em) verdadeiro(s). Você pode categorizar uma condição como uma
combinação de outras condições. Por exemplo, o perfil de um visitante do Web site pode ser definido
como um homem jovem se um gerenciador de perfis de gênero pré-existente classificar o visitante como
homem e um gerenciador de perfis de idade pré-existente classificar o visitante como adolescente ou na
faixa dos 20 anos.
Gerenciador de Perfis Aninhado
AgeGenderProfiler is
YoungMale when
GenderProfiler is Male and
AgeProfiler is any of Teenager or Twenties
Otherwise NotInTargetAudience
Exemplo: Contagem de Categorias (Criação de Perfil Implícita):
Obtenha uma visão geral da implementação de contagens de categorias de um gerenciador de perfis que
conterá definições de perfil para filmes, culinária e esportes; essa visão geral configura o perfil para a
categoria com a contagem mais alta.
340
Para o exemplo Contagem de Categorias, suponha que um repositório de artigos sobre esportes, filmes e
culinária esteja disponível para visualização pelo usuário. Toda vez que o usuário exibe um artigo, um
registro é gravado para mostrar sua preferência por esse tópico. Para que isso ocorra, cada artigo deve ser
uma JSP que implementa beans de categoria. Por exemplo, o código a seguir apareceria em um artigo
sobre esportes:
<jsp:useBean class="com.ibm.wcp.analysis.beans.Category" id="category"
scope="session">
</jsp:useBean>
<% category.log(request, "Articles/Sports"); %>
Esses valores foram digitados no campo de texto Atributo durante a criação desse definidor de perfil,
após a seleção da Contagem de Categorias atual.
Nota: Uma versão completa desse gerenciador de perfis conterá definições de perfil para filmes e
culinária nos casos em que essas contagens de categorias forem maiores que esportes e uma à outra.
Contagem de Categoria
ArticlePreference is
Sports when
current Category Count.Articles.Sports is greater than current Category Count.Articles.Cooking and
current Category Count.Articles.Sports is greater than current Category Count.Articles.Movies
Exemplo: Capacidade do Navegador:
O objeto do estoque capacidade do navegador permite fazer o perfil do navegador que o visitante atual
da Web está utilizando para visualizar seu site. Visualize um exemplo de gerenciador de perfis que
verifica a versão do navegador para determinar se ele é suportado.
Ao usar o objeto de estoque de capacidade do navegador, há uma lista finita de atributos disponíveis,
mas você deve digitar os valores para um lado da avaliação. Os arquivos de script de capacidade do
navegador e a imagem SinglePixel.gif devem ser configurados corretamente no aplicativo da Web.
O seguinte exemplo de gerenciador de perfis verifica a versão do navegador para determinar se ela é
suportada. Outras verificações possíveis incluem plug-ins disponíveis, se o Java está ativado e se os
cookies estão ativados.
Check Browser is
supported when
(
(
current Browser
current Browser
) or
(
current Browser
current Browser
)
)
Otherwise unsupported
Capability.BrowserType is Netscape and
Capability.FullVersion is greater than or equal to 6.2
Capability.BrowserType is Internet Explorer and
Capability.FullVersion is greater than or equal to 6.0
Exemplo: "Contagem de" (Condição Quantificável):
Visualize um exemplo demonstrando o uso de "Contagem de".
Um gerenciador de perfil de condição quantificável é semelhante à definição de perfil implícito porque
um perfil é definido de acordo com números de itens. Os gerenciadores de perfil de condição
quantificável não requerem o uso de beans de registro, mas requerem que os atributos de recursos que
serão quantificados sejam organizados uniformemente.
341
No seguinte gerenciador de perfis, as contagens são feitas para itens no objeto de sessão shoppingCart
usado pelo comprador de recursos do usuário. Aqui, shoppingCart é análogo a uma tabela em um banco
de dados e color seria uma coluna de dados. Cada item na tabela seria uma linha. Por exemplo:
Tabela 113. Contagens Feitas dos Itens no Objeto de Sessão shoppingCart Usados pelo Comprador de Recursos do
Usuário
Item
Quantidade
Tamanho
Cor
Preço
Gadget
1
L
red
$1.99
Gizmo
3
S
green
$0.95
Gerenciador de Perfis da Condição Quantificável para o Objeto de Sessão shoppingCart
ColorPreference is
Vermelho quando o número de itens correspondentes (Shopper.shoppingCart.color
for vermelho) for maior que 5
Verde quando o número de itens correspondentes (Shopper.shoppingCart.color is green) é maior que 5
Exemplo: Atributos de Solicitações e Atributos de Sessões:
Os valores de pedidos transmitidos à JSP ou armazenados na sessão HTTP podem ser referenciados a
partir de regras. Para consultá-los em uma regra, você deve conhecer as variáveis e seus valores
possíveis.
O exemplo a seguir faz o perfil de artigos de notícias como lidos ou não lidos pelo usuário atual, com
base no pedido de página gerado por um formulário em uma JSP.
Atributos de Solicitação e Atributos de Sessão
User News is
ReadNews when
current Request.ProcessNews is Read
UnreadNews when
current Request.ProcessNews is Unread
UnreadAllNews when
current Request.ProcessNews is UnreadAll
Exemplo: Operação Aritmética:
Visualize um exemplo de um perfil que usa operações aritméticas.
Para construir uma operação, selecione uma combinação de Recurso.Atributo e outros operandos. Você
pode fazer isso em qualquer lado da avaliação.
A ordem das operações é importante, mas parênteses não podem ser usados
AgeProfiler is
Youth when
current Date.Year - current User.BirthDate.Year is less than or equal to 25
Adult when
current Date.Year - current User.BirthDate.Year is between 25 and 65
Senior when
current Date.Year - current User.BirthDate.Year is greater than or equal to 65
Ligações:
Ligações combinam ações e perfis para especificar ações a serem desempenhadas quando condições
definidas são encontradas. O conteúdo retornado pode ser classificado ou filtrado antes da exibição ou
uso. As ações podem ser definidas para serem executadas por blocos always, exclude e otherwise. Além
disso, o número total de itens utilizados pode ser limitado.
342
Os blocos always e exclude sempre serão executados não importa qual o resultado da execução do
definidor de perfil, porém o bloco otherwise será executado apenas se nenhum dos definidores de perfil
for correspondente. Um bloco otherwise funciona da mesma forma que um bloco always no que se refere
a incluir itens aos resultados, mas para um bloco exclude, você realmente escolhe uma ação que
determina os itens que você não deseja incluir nos resultados. Por exemplo, em um site de compras, você
talvez queira excluir itens que já foram comprados.
Exemplo: Ligação Simples:
Como as ligações unem o processamento condicional de um gerenciador de perfis com a capacidade
funcional de uma ação, a forma mais simples de uma ligação funciona como uma cláusula condicional
“if-then”.
Considere um exemplo simples de ligação. Se o usuário atual não for um cliente anterior, mostre um
número limitado de ofertas atuais. Se o usuário atual for um cliente conhecido, mostre as ofertas
adequadas para seu nível de status.
Por exemplo, o gerenciador de perfis Tipo de Cliente é usado para verificar se o usuário atual é um
cliente conhecido. Se o cliente não for conhecido, a ação Obter Número Limitado de Ofertas será
executada. Se o gerenciador de perfil indicar que o usuário é um cliente conhecido, com um status de
Ouro ou Platina, uma ação diferente será executada e diferentes ofertas serão recuperadas para exibição.
Ligação Simples
When Customer Type is
Not A Customer
do Get Limited Number of Offers
Gold or
Platinum
do Get Offers For User
order as is
Exemplo: Vários Gerenciadores de Perfis e Ações Opcionais:
Visualize um exemplo que demonstra o uso de uma condição "if-then" com uma cláusula adicional.
Considere um exemplo: Se o usuário atual não tem status confidencial, a ação GetNonConfidentialNews é
executada. Os mesmos resultados poderiam ser obtidos neste exemplo colocando a ação
GetNonConfidentialNews sob Otherwise porque estes são os únicos dois perfis possíveis neste gerenciador
de perfil.
O campo de ação em Otherwise permanece no no estado em que se encontra. Como o gerenciador de
perfil Autorização do Usuário coloca todos os usuários em uma das duas categorias (Normal ou
Confidencial), qualquer ação colocada aqui nunca seria executada.
A regra Obter Notícias do Site sempre será executada. Qualquer conteúdo que a regra recupera do data
store é incluído no conjunto total de retorno.
A ação Obter Notícias Já Lidas funciona como qualquer outra ação porque recupera o conteúdo do
data store. No entanto, quando a ação é colocada sob Excluir, qualquer conteúdo recuperado por esta
ação é removido do conjunto total de retorno.
Nota: Deve ser possível indicar um artigo que foi lido por um usuário específico. Ao clicar no menu
Selecionar Ação, você verá somente as regras designadas a um tipo de opção Selecionar Ação. As regras
de ligação também são regras do tipo Selecionar Ação. Uma vez que um resourceCollectiontype esteja
configurado para a ligação, todas as regras de ação serão bloqueadas e usarão o mesmo tipo de coleção.
343
A ordem do conjunto total de retorno é aleatória e o número truncado para não mais que 10 itens. Esse
efeito ocorre todas as vezes que a regra é executada, portanto, os artigos de notícias exibidos na página
da Web serão alterados uma visualização de página para outra.
Condição "if-then" com uma cláusula adicional
When UserClearance is
Confidential
do GetConfidentialNews
Regular
do GetNonConfidentialNews
Always
GetSiteNews
Exclude
GetNewsAlreadyRead
order randomly
show 10 items
Exemplo: Ligações Aninhadas (Simples):
Ao criar uma ligação, é possível utilizar uma ligação em qualquer uma das áreas executar ação. Isto é
conhecido como uma ligação aninhada.
Neste exemplo, a ação Always (Get Top Products) em Get Products By Location é, na verdade, outra
ligação. Quando a ligação aninhada for inserida com Always, ela terá efeito do operador booleano or.
Por exemplo: A regra total retorna o conteúdo que atende às condições na parte anterior da ligação or
que atende às condições na parte posterior.
Nota: É possível que a ligação aninhada contenha ligações aninhadas.
Get Products By Location:
Ligação Aninhada
When User Location is
Lab
do Get Test Products
Factory
do Get Available Products
Field
do Get All Products
Otherwise
do Get Future Products
Always
Get Top Products
order as is
Get Top Products:
When User Role is
Manager
do Get Top Selling Products
Exec
do Get Top Selling Products
Employee
do Get Top Overstocked Products
order as is
Exemplo: Ligações Aninhadas (Avançadas):
Visualize um exemplo que demonstra ligações aninhadas avançadas.
344
Este exemplo é semelhante ao exemplo de Ligações aninhadas (simples), com exceção da inclusão da
ligação Obter Principais Produtos nas ações executadas quando o gerenciador de perfil Localização do
Usuário é Laboratório. Várias ações podem ser agrupadas, selecionando várias ações ou ligações
simultaneamente no editor de regras. A seleção de várias ações ou ligações aqui tem o efeito do operador
booleano “and”, que retorna a interseção dos conjuntos de dados.
Por exemplo: o local do usuário atual deve estar no lab e ser um executivo. No entanto, além de testar
produtos, executivos e gerentes no lab receberão informações sobre os melhores produtos de venda, e os
funcionários no lab obterão os itens mais populares em estoque. A fábrica ou trabalhadores de campo não
verão o melhor produto de venda ou mais populares em estoque.
Get Products By Location modificado:
Ligações Aninhadas Avançadas
When User Location is
Lab
do Get Top Products and
do Get Test Products
Factory
do Get Available Products
Field
do Get All Products
Otherwise
do Get Future Products
order as is
Recomendação de Conteúdo:
Utilize as regras de Recomendação de Conteúdo (também chamado de regras de recomendação) para
recomendar o conteúdo para os visitantes do Web site. As regras de recomendação, desenvolvidas pelo
LikeMinds, recomendam o conteúdo baseado nas interações anteriores do usuário com seu Web site.
Ao criar uma regra de Recomendação de Conteúdo, você especifica um dos três métodos de
recomendação. Os métodos de recomendação são:
Como o Usuário Atual Navegou no Site
Este método está associado ao LikeMinds Clickstream Engine.
preferências expressas explicitamente pelo usuário
Utilize esse método de recomendação para gerar recomendações com base nas classificações de
itens dos usuários. Esse método está associado ao mecanismo Preferência do LikeMinds.
Os itens são mapeados para uma parte do conteúdo e são representados por recursos e coletas de
recursos. O Web site captura classificações utilizando o bean de classificação. O bean de
Classificação coleta a classificação, o recurso de item e a coleta de recursos e, em seguida, registra
os dados para serem utilizados posteriormente pelo LikeMinds.
associação com o conteúdo retornado de uma regra
Utilize esse método de recomendação para gerar recomendações com base na análise da cesta de
compras. Esse método associa os itens que um usuário atual do Web site está interessado (como
um item em seu carrinho de compras) com itens que outros usuários tenham se interessado ou
comprado. Este método está associado ao mecanismo de Afinidade de Itens do LikeMinds.
As regras de afinidade de itens utilizam os dados de transação do LikeMinds que estão sendo
coletados. Elas oferecem um método para gerar recomendações a partir de um conjunto
conhecido de recursos (na realidade, os resultados de uma outra regra que retornam o mesmo
tipo de recurso).
345
Nota: Antes de utilizar as regras de Conteúdo Recomendado, confira com o administrador do sistema se
os mecanismos do LikeMinds estão configurados e em execução no servidor de tempo de execução de
produção.
Visualizando uma Regra de Conteúdo Recomendado:
Para visualizar os resultados, o banco de dados de produção do LikeMinds deve conter dados, incluindo
itens, usuários e transações (classificações ou ações). O problema de disparo de dados inicial é
normalmente denominado coldstart.
Regras de Visibilidade:
As regras de visibilidade determinam o que um usuário verá ou o que foi destinado a um usuário. As
regras de visibilidade podem ser designadas a páginas e portlets e serão disparados automaticamente
pelo portal conforme necessário.
Elas utilizam qualquer tipo de informação, incluindo atributos LDAP, hora do dia ou informações de
sessão. Por exemplo, se você desejar ocultar um portlet para um indivíduo em determinada geografia,
armazene o local como um atributo em LDAP e designe uma regra de visibilidade que oculte o portlet.
Um usuário pode ter acesso a números da renda de todas as divisões em todo o ano, mas esses números
não devem ser exibidos proeminentemente, exceto quando forem liberados primeiro. Durante uma
semana depois que os números forem liberados pela primeira vez, os números para a divisão do
funcionário deverão mostrar proeminente em suas páginas iniciais. A regra de visibilidade oculta
estatísticas para divisões em que o funcionário não está e somente mostra as estatísticas do funcionário
na semana depois que elas foram liberadas.
As regras de visibilidade podem ser designadas a páginas e portlets e serão disparados automaticamente
pelo portal conforme necessário. Por meio das APIs, as regras de visibilidade funcionam como regras de
gerenciador de perfis em que os únicos dois perfis possíveis são show e hide. Isto permite que as regras
de visibilidade sejam chamadas de maneira programada e utilizadas em qualquer aplicativo customizado
assim como você chama uma regra de gerenciador de perfis.
“Administração Baseada em Atributo” na página 336
A administração baseada em atributo fornece um recurso para customizar o layout de uma página para
usuários individuais autenticados, utilizando regras para mostrar ou ocultar páginas ou portlets. Essa
implementação informa o portal para mostrar ou ocultar páginas e portlets com base em características
dinâmicas que são determinadas no tempo de execução. Administração Baseada em Atributo está
disponível apenas para usuários autenticados. Para usuários anônimos, todas as páginas são mostradas.
Exemplo: Mostrar Página ou Portlet:
Visualize um exemplo de regra de visibilidade, Mostrar Página, que exibe a página ou portlet
especificado apenas durante o período de tempo especificado e apenas para usuários no meio-oeste. Para
todas as outras datas e usuários, a página ou o portlet é ocultado.
Regra de Visibilidade
Show page or portlet when
current Date.Date is between December 12, 2006 and December 19, 2006
current LdapUsers.Geography is Midwest Region
Otherwise hide
Elementos de Regras:
Obtenha informações sobre as opções no editor de regras para tipos de regras diferentes.
Expressões Aritméticas:
346
As expressões aritméticas permitem executar operações aritméticas em atributos de recursos como parte
da regra. Ao escolher essa opção, você pode selecionar vários atributos de recurso, valores e operadores
(adição, subtração, multiplicação ou divisão) para uso entre essas expressões.
Um exemplo de uso de uma expressão aritmética é um definidor de perfil que faça o perfil de visitantes
do Web site de acordo com suas idades. Nos dados registrados para cada visitante, é mais prático
armazenar a data de nascimento (que não muda) do que armazenar a idade. Na avaliação do definidor
de perfil, é possível utilizar uma expressão aritmética para calcular a idade do visitante subtraindo a ano
de nascimento do usuário atual a partir do ano atual (ano da Data atual).
As expressões aritméticas são calculadas de acordo com a ordem tradicional de operações (a
multiplicação e a divisão são calculadas antes da adição e da subtração. Por exemplo, 3+2*2–1/2 tem
como resultado 6,5). Não é possível agrupar expressões usando parênteses.
Contagem de (Condições Quantificáveis):
Crie uma avaliação baseada em uma contagem ou soma de atributos que atendem aos seus critérios.
No menu drop-down Especificar um Atributo de Recurso (Specify a Resource Attribute), você tem a
opção de selecionar Utilizar Número de Itens na Lista (Use Number of Items in List). A seleção dessa
opção permite criar uma avaliação com base em uma contagem ou soma de atributos que atendem a
determinados critérios. Ao selecionar esta opção, é necessário selecionar um recurso e o atributo desse
recurso que deve ser ajustado durante a execução da regra.
Nota: Essa opção pode ser utilizada apenas no gerenciador de perfis e nas regras de visibilidade.
Como a soma é calculada no momento de disparo da regra, poderá gerar resultados diferentes em
períodos distintos durante a sessão de um usuário se for utilizada em um objeto aplicativo ou em um
recurso atual. Por exemplo, você pode gerar o perfil de preferência de cor de um visitante como
vermelho criando uma avaliação que verifica se o número de itens vermelhos no carrinho de compras do
usuário é maior que 5. A sintaxe da regra para essa avaliação seria:
A contagem de (shoppingCart.item.color is red) é maior que 5
Embora seja possível fazer contagens de quaisquer tipos de dados, a soma deve ser comparada a um
valor ou atributo de recurso que possua tipos de dados equivalentes a números, números decimais ou
números inteiros.
Contagem Atual da Ação ou Nome da Ação:
A contagem de ações atual, como a contagem de categorias atual, é uma maneira de basear um
definidor de perfil ou uma regra no número de vezes que o visitante de um Web site desempenhou
determinadas ações. Essas ações devem ser registradas usando os beans de registro de ações para que
estejam acessíveis à regra. O nome da ação atual inspeciona os nomes das ações registradas.
Capacidade Atual do Navegador:
Recurso do Navegador é um objeto de aplicativo que permite determinar o perfil de um visitante do Web
site com base nos atributos ou recursos do navegador que está sendo utilizado. Quando aplicável, ele
aparece no editor de regras como uma opção ao selecionar Resource.Attribute.
Propósito
Atualmente, a Capacidade do Navegador oferece suporte para estes atributos:
AcceptLanguage
Retorna o valor do cabeçalho 'accept-language' do objeto do pedido.
347
AcceptMimeTypes
Retorna o valor do cabeçalho 'accept' do objeto de pedido.
Agent
Retorna o valor do cabeçalho 'user-agent' do objeto do pedido. É uma cadeia de letras minúsculas
que contém informações sobre o software cliente, geralmente o nome ou a versão do navegador.
BrowserType
Retorna o tipo de navegador. As opções estão disponíveis para navegadores suportados.
FullVersion
Retorna a versão do navegador para um ponto de precisão. Por exemplo, tanto a 6.1 quanto a
6.1.1 são retornadas para 6.1.
MajorVersion
Retorna o primeiro digito da versão do navegador. Por exemplo, as versões 6.0, 6.1 e 6.1.1 são
todas retornadas como 6.
Data Atual:
O recurso de Data Atual contém vários atributos que podem ser utilizados para comparação (data, dia,
mês, hora, data e hora, dia da semana e ano). Para definir valores, você pode informar um valor
específico ou referenciar o valor de um atributo específico do mesmo tipo.
Atributos Atuais da Solicitação:
Utilize Atributos de Solicitação Atuais para inspecionar os atributos de solicitação que podem ser
definidos no atual JSP. Você deve conhecer o nome do atributo de solicitação para utilizá-lo em uma
regra. Esse pedido é o pedido transmitido ao ponto de conteúdo que está executando a regra. Por
exemplo, você usa o pedido de portlet para configurar o Atributo de Pedido atual para portlets. O pedido
de portlet não é compartilhado entre os portlets. Para jsps que estão diretamente dentro de um aplicativo
da Web, o Atributo de Pedido atual é o pedido de HTTP do aplicativo da Web.
Considere o seguinte código que pode ser inserido em uma JSP para configurar um atributo de pedido:
<%
request.setAttribute("user", userObject);
%>
em que userObject é de qualquer tipo de Objeto
Uma condição de regra de exemplo criada para avaliar o exemplo anterior pode ser:
quando current Request Attributes.user é igual a rob
Todos os tipos de dados são suportados.
Parâmetros Atuais da Solicitação:
Utilize os Parâmetros de Solicitação Atuais para inspecionar os dados contidos na cadeia de consulta (as
variáveis e os valores exibidos após um ponto de interrogação em uma URL).
Para entender os parâmetros de pedidos atuais, considere a URL de exemplo http://hostname/
page.jsp?var1=rob&var2=expert. Neste exemplo, os parâmetros de pedidos são var1 e var2.
Normalmente, esses parâmetros são transmitidos por métodos GET e POST associados a formulários. É
preciso saber o nome do parâmetro do pedido que é transmitido pela página para utilizá-lo em uma
regra.
Considerando o seguinte comando <jsp:forward>:
<jsp:forward page="/servlet/login">
<jsp:param name="user" value="rob" />
</jsp:forward>
348
uma condição de regra de exemplo construída para avaliar este exemplo pode ser:
quando Request.user atual é rob
Somente os tipos de dados Texto e Lista são suportados.
Atributos Atuais da Sessão:
Utilize os Atributos de Sessão Atuais para inspecionar os parâmetros armazenados no objeto sessão
atual para o visitante do Web site. É preciso saber o nome do parâmetro para utilizá-lo em uma regra.
Todos os tipos de dados são suportados. O objeto de sessão atual é a sessão associada ao pedido
transmitido ao ponto de conteúdo que está executando a regra. Por exemplo, o objeto de sessão atual é a
sessão de portlet, que é exclusiva para o portlet. Para as jsps dentro de um WAR, o objeto de sessão atual
é a sessão http.
efetuar Ação:
Em uma ligação, é possível combinar ações com definidores de perfil para que determinadas tarefas
sejam desempenhadas quando certas condições forem atendidas. Também é possível indicar ações a
serem executadas sob outras condições. Use os elementos Do action, Otherwise do action, Always do
action e Exclude do action.
Executar a Ação permite escolher uma ou mais ações no projeto. Também é possível selecionar outro
definidor de perfil e perfil para definir uma combinação de condições a avaliar. Essas ações são
executadas quando a condição no perfil (ou conjunto de perfis) anterior for satisfeita.
Nota: Se existirem várias ações em uma ligação, todas essas ações deverão trabalhar com recursos do
mesmo tipo.
Caso Contrário Executar a Ação permite escolher uma ou mais ações que serão executadas quando
nenhuma das condições anteriores no perfil (ou conjunto de perfis) for satisfeita. Dentro da cláusula caso
contrário, também é possível selecionar outro definidor de perfil e perfil para definir uma combinação de
condições a avaliar.
Sempre Executar a Ação permite escolher uma ou mais ações no projeto que serão executadas seja ou
não satisfeita alguma das condições anteriores.
A Ação Executar de Exclusão permite identificar uma ou mais ações no projeto que serão executadas e
cujos resultados retornados serão removidos do conjunto de resultados gerado por outras ações na
ligação.
Nota: Exclusão tem prioridade sobre Sempre.
Apenas Inclusão:
Apenas Inclusão é uma opção dentro das estruturas Selecionar Ação e Regra de Recomendação. É
possível selecionar a ação ou regra de ligação a ser usada como a causa apenas inclusão. Quando o
conteúdo for selecionado para a ação de seleção principal ou regra recomendada, ele só será retornado se
for selecionado pela regra de ação da cláusula Apenas Inclusão.
é:
Selecione é para avaliar o relacionamento entre os dois lados de uma instrução condicional.
349
Ao usar is, um dos lados da instrução condicional geralmente poderá ser o conteúdo retornado por um
atributo de recurso, valor ou expressão aritmética. Se o atributo de recurso for do tipo de dados Lista
(matriz, vetor ou enumeração), as avaliações disponíveis se tornarão inclui e inclui qualquer de. Caso
contrário, as opções são:
v incluir
v incluir qualquer um
v está entre
v
v
v
v
v
está entre mas não é igual a
está vazio
é
é maior que
é maior que ou igual a
v está incluído em
v é menor que ou igual a
v é menor que
v não está vazio
v não é
Está Vazio/Não Está Vazio
As avaliações está vazio e não está vazio permitem que uma regra verifique a existência de um valor
nulo ou de uma lista vazia. Ao usar uma destas avaliações, uma parte dela será desnecessária e será
removida.
Tabela 114. Exemplos de Avaliações Is Empty ou Is not Empty
Lado Esquerdo da Avaliação
Avaliação
Resultado
Atributo do Recurso (tipo não de
lista)
está vazio
verdadeiro se o atributo for nulo, caso
contrário falso
Atributo do Recurso (tipo não de
lista)
não está vazio
falso se o atributo for nulo, caso
contrário verdadeiro
Atributo do Recurso (tipo de lista)
está vazio
verdadeiro se a lista estiver vazia, caso
contrário falso
Atributo do Recurso (tipo de lista)
não está vazio
falso se a lista estiver vazia, caso
contrário verdadeiro
Atributos de Solicitação ou Atributos está vazio
de Sessão (tipo não-Lista)
falso se o atributo/parâmetro existir e
o valor não for nulo; verdadeiro se o
atributo/parâmetro não existir ou se o
valor for nulo
Atributos de Solicitação ou Atributos não está vazio
de Sessão (tipo não-Lista)
verdadeiro se o atributo/parâmetro
existir e o valor não for nulo; falso se
o atributo/parâmetro não existir ou se
o valor for nulo
Atributos de Solicitação ou Atributos está vazio
de Sessão (tipo Lista)
não existir ou se a lista estiver vazia;
falso se o atributo/parâmetro existir e
a lista tiver dados
Atributos de Solicitação ou Atributos não está vazio
de Sessão (tipo Lista)
falso se o atributo/parâmetro não
existir ou se a lista estiver vazia;
existir e a lista tiver dados
350
Avaliações de gerenciador de perfil
Se você optar por avaliar um gerenciador de perfis em vez de um atributo de recurso na janela
Especificar um Atributo de Recurso, as avaliações disponíveis serão:
v é
v são todos de
v é qualquer um de
v não é
v não é qualquer um de
Em uma parte da avaliação, as possíveis opções são os perfis que estão definidos nesse gerenciador de
perfis. Você pode selecionar um ou mais perfis para o resultado da avaliação.
Como Está:
Ordenar como está é utilizado para especificar a ordem em que você deseja que o conteúdo selecionado
seja retornado e utilizado. O padrão, ordenar como está, retornará os dados na ordem em que estão
armazenados no repositório. Ao clicar no link ordenar como está, você também pode escolher ordenar
aleatoriamente ou ordenar por.
Ordenar por permite classificar o conteúdo de acordo com qualquer um de seus atributos, classificar de
acordo com mais de um atributo (e especificar a ordem em que os atributos são utilizados para a
classificação) e especificar se você deseja cada atributo em ordem crescente ou decrescente. Ordenar
aleatoriamente retorna dados em uma ordem diferente, sempre que a regra é executada.
Perfil:
Perfil é um nome arbitrário (de sua escolha) que fornece informações sobre o visitante do Web site, a
data e a hora da visita ou outras circunstâncias ou condições.
Para entender melhor os perfis, considere um exemplo. Suponha que você queira diferenciar seus
visitantes da Web de acordo com as informações confidenciais que eles poderão visualizar. Você poderá
usar dois perfis neste cenário: Confidencial e Regular.
Ao criar um perfil em um gerenciador de perfil, digite um nome arbitrário, mas descritivo. Seja o mais
exato possível para evitar duplicação ou confusão com outros perfis. Ao selecionar um perfil (por
exemplo, em uma ligação), você escolhe em uma lista de nomes de perfil disponíveis que corresponda à
regra do gerenciador de perfis.
Gerador de Perfil:
O Definidor de Perfil é uma opção na estrutura de regras de ligação e na janela Especifique um Atributo
de Recurso durante a construção de um definidor de perfil. Em uma ligação, você identifica ações
específicas a serem desempenhadas com base em um perfil dentro de um definidor de perfil que é
avaliado como verdadeiro.
Também é possível selecionar um definidor de perfil rápido e especificar uma avaliação simples em linha
em vez de utilizar um definidor de perfil distinto.
A seleção do Definidor de Perfil em um perfil permite identificar outros definidores de perfil (efetivados
e aninhando definidores de perfil uns dentro dos outros) para criar um definidor de perfil que possa ser
avaliado como verdadeiro quando diversos definidores de perfil ou outras avaliações forem verdadeiros.
Perfil Rápido:
351
Os definidores de perfil rápidos são criados em ligações para desempenhar avaliações simples.
Utilizando um definidor de perfil rápido, você pode evitar a criação de definidores de perfil simples
como regras separadas.
Quando você seleciona o link do definidor de perfil dentro de uma ligação e escolhe a opção definidor de
perfil rápido, a estrutura da linha mudará para uma avaliação. A linha subseqüente da ligação será a ação
a ser executada se o definidor de perfil rápido for avaliado como verdadeiro.
emissor:
emissor deve ser um endereço de email válido, uma lista de endereços de email (separados por vírgula)
ou um atributo de recurso contendo endereços de email válidos para quem o email será enviado.
definir como:
Aprenda sobre a ação definir como e alternativas para essa ação definir como.
Definir como é a ação padrão em uma regra de ação Atualizar. Definir como modificará o atributo de
um recurso, objeto solicitação ou objeto sessão de acordo com o valor especificado na expressão.
As alternativas para definir como incluem:
v anexar
v decrementar por
v dividir por
v incrementar por
v multiplicar por
v anexar ao início
v remover
v remover tudo
value:
Value é o marcador para o resultado de uma avaliação. Esse valor pode ser um que você informar, o
valor de outro atributo do recurso ou uma expressão aritmética.
O valor deve ser compatível com o tipo de dados do outro lado da expressão ou avaliação. Por exemplo,
se estiver avaliando um atributo de tipo Número, você poderá compará-lo somente aos atributos de
recurso de tipo Número ou Número Decimal. O editor de regras impedirá a escolha de outros atributos
do recurso com tipos incompatíveis.
Nota: Ao fazer comparações entre recursos em um banco de dados, o tipo e tamanho de coluna são
respeitados. Portanto, para comparar um valor com uma coluna digitada como CHAR(10), é necessário
incluir todos os 10 caracteres. Por exemplo, suponha que você possua uma tabela com uma coluna DIA
digitada como CHAR(10). Uma linha na tabela possui o valor 'Segunda-feira
' em vez de
'Segunda-feira' estar na coluna DIA porque DIA é comparado a uma condição de gerenciador de perfis e
deve ter todos os 10 caracteres definidos. Entretanto, se a coluna for digitada como VARCHAR, o valor
na condição do gerenciador de perfil poderá ser 'Segunda-feira' (sem os quatro espaços em branco
adicionais).
Valores Mapeados
É possível criar recursos com o uso de valores mapeados em vez de valores reais especificados no data
store. Isso facilita a criação de regras mais fáceis de serem compreendidas. Por exemplo, se uma coluna
no campo de dados contiver os valores de número inteiro 1, 2 ou 3 indicando Sim, Não ou Talvez, o
352
recurso poderá ser configurado para fazer o mapeamento de valores de número inteiro para palavras. Se
os valores mapeados tiverem sido criados para um recurso, esses valores serão utilizados no editor de
regras no lugar dos valores reais. Para obter mais informações sobre como criar mapeamentos de valores,
consulte a documentação no Rational Application Developer referente à criação de recursos utilizando o
assistente de recursos do Personalização.
Propriedades dinâmicas
Além das propriedades de recurso predefinidas, você pode digitar propriedades de um recurso que não
esteja na lista. Se você sabe que o recurso identifica dinamicamente, especifique o nome da propriedade.
Se o recurso gerenciar propriedades dinamicamente, os valores serão recuperados quando a regra for
avaliada.
Email:
Visualize os pré-requisitos de criação de uma ação ou promoção por email na área de trabalho do
Personalização.
Uma promoção por email é uma mensagem de email enviada automaticamente para uma lista definida
de destinatários por uma regra de execução. As promoções por email podem ser enviadas uma vez, ou
repetidamente, em intervalos regulares. O corpo da mensagem de email é derivado de um arquivo no
servidor, como um arquivo de texto, um arquivo HTML ou até mesmo uma JSP contendo pontos de
conteúdo para regras. Esse arquivo pode ser escolhido no repositório de autoria. A lista de destinatários
pode ser derivada dinamicamente a partir de uma regra. As promoções por email são implementadas
usando um evento de regra para acionar uma regra de email em um planejamento.
Antes de poder criar uma ação ou promoção de email na área de trabalho do Personalização, você precisa
dos seguintes itens:
v
Um Recurso de Usuário. Este recurso contém informações sobre os possíveis destinatários de email e
pode ser criado com o assistente para recurso do Personalizaçãono Rational Application Developer. O
recurso deve incluir uma sequência representando o endereço de email dos destinatários (na forma
“username@domain”) e deve ser publicado no servidor da área de trabalho e no ambiente de tempo de
execução.
v
Um corpo de email. O corpo do email é um texto simples, HTML ou arquivo JSP que deve existir em
um servidor acessível a partir do ambiente de tempo de execução. Normalmente, esse arquivo é criado
em Rational Application Developer. O local do arquivo no ambiente de tempo de execução deve ser
especificado como um URI ao criar a regra de email. O HTML ou a página JSP do corpo do email deve
estar no servidor que está enviando o email.
v Uma regra de email. A regra de email especifica para quem o email deve ser enviado, quem o está
enviando e identifica o corpo do email como um URI.
v
Uma regra para determinar destinatários (para emails acionados em um planejamento ou
periodicamente, opcional para ações de email). Essa regra pode ser uma ação selecionar conteúdo ou
uma ligação, mas deve retornar uma coleção de destinatários a partir do recurso de usuário
mencionado anteriormente. A ação ou regra criada torna-se uma opção da lista Para. Se as suas ações
ou regras não estiverem corretamente definidas, a lista Para exibirá “Nenhuma Regra Correspondente”.
É possível criar ações ou promoções por email que sejam enviadas para um endereço ou uma lista de
endereços predefinidos, bastando digitá-los no campo Para ao criar a ação ou a promoção por email.
v Um evento de regra (para emails acionados em um planejamento ou periodicamente). O evento de
regra liga a regra de email à regra que determina os destinatários. O evento de regra informa que em
um determinado horário ou horários futuramente, uma regra específica deve ser executada uma vez
para cada usuário em uma lista. Essa lista é determinada pela regra, para estabelecer destinatários.
353
Para obter mais informações sobre como configurar atividades de email, consulte Configurando Contas
de Atividade de Email.
Administração de Email:
Visualize as etapas que precisam ser concluídas para que o servidor de tempo de execução envie email
personalizado.
Para que o servidor de tempo de execução possa enviar email personalizado:
v Verifique se pznscheduler.ear está como um Aplicativo Corporativo.
v Tenha um servidor de email SMTP configurado e operando.
JavaMail fornece o SMTP necessário para enviar email. É possível gerenciar respostas de email de
clientes e condições de erro de saída (como um endereço de email desconhecido) usando um cliente de
email padrão.
v Configure um provedor de correio usando o WebSphere Integrated Solutions Console.
1. Clique em Recursos > Correio > Provedores de Correio.
2. Crie uma sessão de correio para utilizar com Personalização. Por padrão, o Personalização procura
uma sessão de correio em mail/personalizationMailSession/jndi. O nome de JNDI utilizado é
configurável no arquivo PersonalizationService.properties se você quiser utilizar Personalização
com uma sessão de correio existente configurada. Se você estiver criando uma nova sessão de
correio, será necessário especificar um Host de Transporte de Correio. Esse é o servidor de correio
Personalização usado para enviar email. Se seu servidor de correio estiver seguro, será necessário
especificar um ID de Usuário e a Senha de Transporte de Correio.
3. Reinicie o servidor no qual as regras de email são executadas, para que as alterações sejam
efetivadas.
v Configuração adicional está disponível através do arquivo PersonalizationService.properties.
Utilizando esse arquivo, configure com que freqüência o Personalizaçãoprocura eventos de regras que
executam emails planejados ou de repetição. Também é possível configurar a sessão de correio sendo
utilizada.
Pontos de Conteúdo
Um ponto de conteúdo é um sinalizador de substituição ou um slot para uma regra em uma página da
Web. Quando a página é visualizada, o ponto de conteúdo utiliza seu mapeamento de regra para
determinar qual regra executar. Quando a regra é executada, quaisquer ações definidas dentro da regra
acontecem. Cada ponto de conteúdo tem um nome exclusivo. O tipo de conteúdo de um ponto de
conteúdo deve ser definido durante sua criação e não deve ser alterado.
Os pontos de conteúdo são criados por desenvolvedores utilizando o assistente Ponto de Conteúdo no
Rational Application Developer e também no espaço de trabalho do Personalização selecionando Novo >
Ponto de Conteúdo. Após a criação do ponto, o desenvolvedor pode colocá-lo em uma JSP ou chamá-lo
de modo programático a partir de qualquer classe Java.
Para disponibilizar o ponto para o mecanismo do Personalização, ele deve estar no caminho de classe de
qualquer aplicativo que o chame. Se você estiver utilizando um portlet ou um projeto da Web no Rational
Application Developer, as informações do caminho de classe serão automaticamente atualizadas quando
o aplicativo for implementado.
Para disponibilizar o ponto de conteúdo para os portlets de autoria do Personalização, o ponto de
conteúdo deve ser criado no espaço de trabalho selecionando Novo > Ponto de Conteúdo. O nome dado
ao ponto de conteúdo no portlet de autoria deve corresponder ao nome de exibição dado a ele no
assistente do Rational Application Developer ou ao nome pelo qual ele é chamado utilizando a interface
de programação com.ibm.websphere.personalization.ContentSpot. Os pontos de conteúdo devem ser
colocados em pastas utilizando um nome de exibição que qualifique totalmente essa pasta ou
configurando o escopo de execução para corresponder à pasta no tempo de execução. Portanto, se quiser
354
que seu ponto de conteúdo seja chamado de MyDataSpot em uma pasta denominada ProductData, o nome
de exibição do ponto de conteúdo deverá ser especificado no assistente como ProductData/MyDataSpot.
Os usuários da área de trabalho do Personalização especificam a regra que deve ser colocada em um
ponto de conteúdo. Isso também é conhecido como mapeamento de regra para o ponto de conteúdo ou
criação de mapeamento de regra. Ao concluir, um usuário de espaço de trabalho com autoridade para
publicar regras e mapeamentos de regra as publica do servidor do espaço de trabalho para o ambiente de
tempo de execução. A publicação é opcional e é utilizada para mover objetos entre os servidores. Pontos
de conteúdo, regras e todos os outros objetos criados no Personalização estarão ativos assim que forem
criados. Os mapeamentos de regra podem ser alterados a qualquer momento e estarão efetivos
imediatamente após sua publicação ou após a data de início do mapeamento de regra, dependendo de
qual ocorrer primeiro. Os mapeamentos de regras expiram na data final do mapeamento da regra.
Os pontos de conteúdo podem ser acessados no espaço de trabalho através dos portlets de autoria do
Personalização. Você pode ver uma lista de todos os pontos de conteúdo do projeto, junto com seu tipo
de conteúdo e nome de suas regras mapeadas, navegando na visualização do navegador.
O uso de pontos de conteúdo é opcional. A classe com.ibm.websphere.personalization.ContentSpot pode
ser utilizada para executar diretamente uma regra pelo nome da regra.
Para obter informações adicionais, consulte “Chamando Regras de Modo Programático” na página 513.
Mapeamentos de Ponto de Regra
Para que uma regra seja utilizada no Web site, ela deve ser mapeada para um ponto de conteúdo
existente. Um mapeamento de ponto de regra é simplesmente uma associação entre um ponto de
conteúdo e uma regra. A alteração da regra que é executada no ambiente de tempo de execução é tão
fácil quando o mapeamento de uma regra diferente para uma área de conteúdo.
Você pode criar mapeamentos de ponto de regra dentro do espaço de trabalho do Personalização.
Existem duas visualizações para mapeamentos de regra: Mapeamentos de Regra por Campanha (Rule
Mappings by Campaign) e Mapeamentos de Regra por Ponto de Conteúdo (Rule Mappings by
Content Spot). A visualização Mapeamentos de Regra por Campanha (Rule Mappings by Campaign)
mostra todos os mapeamentos de regra em uma campanha selecionada de um menu drop-down e suas
regras e pontos de conteúdo mapeados. Essa visualização inclui a opção Mapeamentos Padrão (Default
Mappings) que simplesmente mostra todos os mapeamentos padrão de cada ponto de conteúdo. A
visualização Mapeamentos de Regra por Ponto de Conteúdo (Rule Mappings by Content Spot) mostra
todos os mapeamentos de regra em um ponto de conteúdo específico, incluindo o mapeamento padrão e
quaisquer mapeamentos sob campanhas. É possível alterar o comportamento de personalização do Web
site mapeando uma regra diferente para um determinado ponto de conteúdo.
Embora apenas uma regra seja executada quando um bean de ponto de conteúdo é chamado, você pode
fazer com que várias regras sejam simultaneamente mapeadas para um ponto de conteúdo utilizando
campanhas. Quando uma campanha é criada, você pode criar um conjunto separado de mapeamentos de
pontos de regra para qualquer ou para todos os pontos de conteúdo no projeto.
Quando várias campanhas estão ativas simultaneamente, as prioridades e as divisões das campanhas são
utilizadas para determinar a regra a ser executada. Quando várias campanhas ativas possuem a mesma
prioridade, as divisões são utilizadas para calcular uma porcentagem da chance de que um mapeamento
seja utilizado no lugar dos outros mapeamentos.
As divisões podem ser alteradas para cada mapeamento de ponto de regra.
Os mapeamentos de ponto de regra podem ser duplicados e movidos de uma campanha para outra. A
data de início e a data de encerramento do mapeamento de ponto de regra poderão ser modificadas se
não se encaixarem na faixa de datas da campanha para a qual o mapeamento de pontos foi movido.
Podem ser incluídos vários mapeamentos no mesmo ponto em uma campanha.
355
Campanhas
As campanhas são um meio de organizar e implementar conjuntos de comportamento de personalização.
Uma analogia útil é uma campanha publicitária direcionada a públicos específicos com informações de
alta prioridade durante um período de tempo especificado. As campanhas obtêm isso permitindo a
exibição preferencial de um conteúdo relacionado a campanhas nos pontos de conteúdo de um Web site.
Para atingir essa meta, uma campanha contém um conjunto de mapeamentos de pontos de regras para
conteúdo, datas de início e datas de término.
Os usuários podem criar e gerenciar campanhas através do Portlet Authoring do Personalização. As
campanhas entram em vigor a partir de sua data de início e elas podem ser publicadas para outros
servidores junto com regras. Para criar uma campanha, selecione Nova > Campanha. Para incluir
mapeamentos de regras em uma campanha, selecione a campanha e selecione Nova > Mapeamento de
Regras.
Quando uma campanha está ativa no ambiente de tempo de execução, os mapeamentos de regras têm
prioridade sobre os mapeamentos de regras padrão dos pontos de conteúdo aos quais a campanha faz
referência. Por exemplo, uma campanha periódica pode conter determinados mapeamentos de regra que
resultem na exibição de ofertas especiais para o visitante de um Web site. Uma campanha pode conter
mapeamentos de regras para alguns ou para todos os pontos de conteúdo em um site.
É possível ter várias campanhas ativas simultaneamente. Quando isso acontece, as definições de
prioridades nas campanhas ativas ditam de qual campanha o mapeamento de regras será utilizado. A
campanha com a maior prioridade 'vence' e seus mapeamentos de regras serão utilizados. No caso de
várias campanhas ativas terem a mesma definição de prioridade, o mapeamento de regras utilizado para
um determinado ponto de conteúdo será determinado aleatoriamente de acordo com as proporções
relativas de divisão.
Objeto de Aplicativo
Um objeto de aplicativo é um objeto Java existente em um local conhecido no contexto do pedido. A
definição de um objeto de aplicativo envolve a especificação do nome de classe do objeto (como uma
classe Java) e a especificação de uma chave (chave de cadeia em um atributo de sessão) para localizá-lo
no contexto do pedido. A personalização chama métodos nesses objetos durante a execução da regra e
usa seus resultados na tomada de decisões. Os objetos de aplicativo que implementam a interface
SelfInitializingApplicationObject são instanciados automaticamente conforme necessário pelo
Personalization.
Contexto de Pedido
Esta é a interface utilizada para acessar vários atributos para regras. Para contextos HTTP, ela fornece
acesso aos atributos HttpRequest e HttpSession. Para contextos não-HTTP, ela fornece a mesma interface
para um substituto para a solicitação e sessão.
O contexto de solicitação e quaisquer valores de solicitação acessados por meio do contexto de solicitação
são válidos apenas no período de duração da solicitação.
A cadeia Contexto de Solicitação é utilizada em consultas do cache. A consulta é criada utilizando uma
cadeia especificada pelo usuário combinada com valores da consulta, como a chave de consulta. A cadeia
especificada pelo usuário deve representar unicamente o Contexto de Solicitação atual. Essa chave é
armazenada em ibm.wcp.cache.user.key como um atributo de solicitação ou como um atributo de sessão
com o atributo de solicitação tendo precedência.
Acessando o Contexto do Pedido
O Request Context fornece ao mecanismo de regras Personalization os dados e informações ambientais
necessários para o processamento de regras. Ou seja, o Request Context contém todas as entradas para
executar pontos de conteúdo e regras do Personalization. Isso inclui entradas simples como dados sobre
pedidos e sessões e entradas mais avançadas como o objeto do usuário.
356
Você pode acessar o Request Context a partir de um ponto de conteúdo utilizando primeiro o método
setRequest do ponto de conteúdo para voltar o ponto de conteúdo com um pedido e, em seguida,
chamando o getContext para recuperar o contexto. Você pode também utilizar o Request Context para
chamar diretamente nas APIs do ResourceDomain3 e do ResourceManager3.
O Request Context permite recuperar sessões, solicitações, atributos do portlet, datas, cookies e outros
dados e informações sobre ambientes a partir da camada do recurso.
O Request Context inclui:
v Sessão
As informações sobre a sessão identificam o objeto HttpSession associado ao usuário atual.
v Data do pedido
Esta data de pedido é a data em que o pedido do HTTP foi recebido. Estas informações suportam
regras com ações dependentes de datas.
Como o Personalização utiliza o Request Context para conter toda entrada de regra, o Request Context
deve ser definido no ponto de conteúdo antes da execução da regra. O código com a tag useBean do
ponto de conteúdo deve ser semelhante a:
<jsp:useBean id="gold_promo_bean"
class="yourco.goldpromo.BannerSpot" />
<% gold_promo_bean.setRequest (request); %>
Na seção anterior, a identificação jsp:useBean cria a classe yourco.goldpromo.BannerSpot e armazena uma
instância dela na variável local gold_promo_bean. A próxima linha chama setRequest para colocar o
HttpServletRequest ou o PortletRequest no bean de ponto de conteúdo que acaba de ser construído. O
ponto de conteúdo, então, cria implicitamente um Request Context, que é suportado pelo
HttpServletRequest ou pelo PortletRequest. Esse Request Context, então, fornece acesso aos parâmetros e
atributos desse pedido da sessão através da interface com.ibm.websphere.personalization.RequestContext.
Em alguns casos, pode ser útil chamar um ponto de conteúdo sem ter acesso a um HttpServletRequest ou
a um PortletRequest. A interface com.ibm.websphere.personalization.PznRequestObjectInterface pode ser
utilizada nessas situações. Uma implementação dessa classe chamada
com.ibm.websphere.personalization.PznRequestObjectImplementor é fornecida para conveniência.
Estrutura de Consulta
A estrutura de consulta é uma representação de objeto de uma consulta. A estrutura não é orientada
especificamente para a consulta de objetos ou bancos de dados relacionais. Um conjunto de operadores
comuns é definido, mas o que um atributo representa é determinado pelo interpretador da consulta.
Como a estrutura não faz suposições sobre como o nome de um atributo é convertido para o objeto que
ele representa, árvores e gráficos de objetos, modelos relacionais ou quase todas as outras estruturas de
dados podem ser consultadas com a estrutura. A estrutura da consulta é utilizada para passar
informações sobre a consulta do mecanismo de tempo de execução para o mecanismo de recursos. A
coleta de recursos que deve interpretar a consulta. Tradicionalmente, essa interpretação do objeto de
consulta é feita através de uma classe de retorno de chamada que é essencialmente um conversor da
estrutura da consulta para uma linguagem de consulta específica de um protocolo.
A Interface do Personalização
A interface com o usuário do Portal Personalization consiste em três portlets: o Personalization Navigator,
o Personalization Editor e a Lista Personalizada.
Esses portlets são automaticamente instalados com o IBM WebSphere Portal. Embora os serviços de
personalização possam ser utilizados em portlets que suportam servidores WSRP remotos, os portlets de
personalização não suportam serem utilizados como um serviço WSRP remoto.
357
Personalização Navigator
O Personalização Navigator é a interface de navegação principal. Os usuários exploram o repositório com
uma estrutura em árvore - diretórios são exibidos em uma lateral da janela e elementos em um diretório
selecionado são exibidos na outra parte dela. A visualização pode ser modificada para eliminar o lado da
janela com a estrutura em árvore, em vez de listar todos os diretórios e elementos em uma lista
hierárquica. Uma lista drop-down permite aos usuários mostrar todos os elementos do Personalização ou
filtrar a visualização para exibir um único tipo de elemento (como regras ou campanhas). A tabela a
seguir mostra quais visualizações estão disponíveis:
Tabela 115. Visualizações Disponíveis no Navegador de Personalização
Visualização da Lista
Descrição
Propriedades Mostradas
Navegar em Recursos do
Personalização (árvore)
Essa visualização em árvore irá
Nome, Criador, Última Modificação,
mostrar apenas artefatos criados pelo Tipo de Nó
Personalização. Por exemplo, regras,
campanhas, coletas de recursos.
Navegar em Regras (árvore)
Esta visualização em árvore mostrará Nome, Criador, Última Modificação,
apenas as regras do Personalização.
Tipo de Regra
Essa visualização também mostrará
cada tipo de regra; por exemplo,
Selecionar Ação ou Gerenciador de
Perfis.
Campanhas (lista)
As campanhas serão uma
visualização em lista especializada.
Na barra de ação da visualização,
haverá um drop-down de escopo. O
drop-down de escopo permitirá ao
usuário escolher um escopo de
execução. As campanhas do contexto
de escopo desse escopo de execução
serão mostradas. Quando a
configuração de escopo é global,
como no padrão, não haverá
drop-down e todas as campanhas
serão mostradas. Como em todas as
visualizações, a ação Editar
Mapeamentos estará disponível
quando uma campanha for
selecionada.
Nome, Prioridade, Divisão, Data de
Início, Data de Encerramento
Mapeamentos de Regras por
Campanha (lista)
Essa visualização é ativada através
do drop-down para escolha de uma
visualização ou através da ação
Editar Mapeamentos de uma
campanha. A visualização mostra
uma lista de mapeamentos para uma
campanha especificada.
Nome do Ponto, Nome da Regra,
Tipo de Conteúdo, Divisão, Data de
Início, Data de Encerramento
Coletas (lista)
Essa visualização permitirá que um
usuário veja todas as coletas de
recursos e objetos de aplicativo
criados sob uma coleta.
Nome da Coleta, IBM Java Content
Repository (Verdadeiro / Falso), Tipo
de Coleta (Usuário / Conteúdo)
Eventos
Essa visualização permitirá que um
usuário veja todos os eventos de
regra no sistema.
Além da navegação, o Personalização Navigator é onde os usuários controlam o conteúdo do repositório.
Os usuários podem mover, copiar, importar e excluir elementos e criar novos elementos. Quando
358
usuários criam um novo elemento - selecionando Novo no menu do Personalização Navigator - eles são
levados automaticamente para o Personalização Editor.
Você também pode acessar o portlet Resource Permissions para configurar o controle de acesso em itens
de personalização individual no Personalization Navigator clicando em Editar Acesso > Ações Extras.
Personalização Editor
Nesse portlet os usuários editam conteúdo ou informações de um elemento. Selecionar um novo
elemento no Personalização Navigator ativa o modo de edição, onde usuários podem digitar dados,
dependendo do elemento escolhido. Para editar um elemento existente, usuários destacam o item no
Personalização Navigator. Eles são retornados para o Personalização Editor e devem clicar em Edit na
guia Editar Item (Edit item).
Lista Personalizada
O portlet Lista Personalizada permite a um usuário exibir conteúdo personalizado sem a necessidade de
construir um portlet JSP customizado. Cada portlet pode exibir uma lista de recursos e mostrar detalhes
de cada recurso retornado. Grupos de recursos relacionados podem ser categorizados para facilitar a
visualização. Quando uma visualização mais detalhada de uma parte do conteúdo é requerida, é possível
especificar uma JSP de detalhes customizada. Instâncias diferentes do portlet podem ser utilizadas no
âmbito do WebSphere Portal para implementar de maneira rápida e fácil informações personalizadas para
usuários.
Visão Geral da Publicação de Regras de Personalização
O WebSphere Portal Personalização envia regras publicadas via HTTP para um servlet que reside em
cada servidor de personalização. Esse servlet poder receber dados de publicação ou iniciar novas tarefas
de publicação. Quando um usuário começa uma tarefa de publicação no ambiente de autoria do
Personalization, o servlet local recebe o conjunto de informações necessárias para a conclusão da tarefa. O
servlet local entra em contato com o servlet do nó de extremidade de destino (que pode ser o mesmo
servlet) e envia seus dados para ele. O servlet de destino relatará o êxito ou a falha.
Publicando Considerações
Se você estiver publicando regras de personalização em uma configuração do servidor em cluster, para
um host IPv6, ou usando classes de coleções de recursos de conteúdo da web, haverá considerações
exclusivas com as quais deve-se estar familiarizado.
Clusters
A publicação para/de um ambiente em cluster não requer nenhuma configuração especial. O membro de
cluster específico que executará a tarefa de publicação é escolhido pelas mesmas regras que se aplicam a
pedidos de entrada da Web (visto que o mecanismo de publicação utiliza mensagens HTTP). No final de
uma tarefa de publicação bem-sucedida, o Personalização esvazia suas caches nesse espaço de trabalho
para assegurar que qualquer conteúdo personalizado subsequente esteja o mais atualizado possível.
Ao utilizar primeiramente os portlets de autoria do Personalização em um cluster para publicar objetos, o
diálogo Status da Publicação (acessado por meio de Mais Ações > Publicar > Visualizar Status) mostra
somente informações sobre as tarefas de publicação iniciadas nesse membro de cluster. Para tornar todas
as tarefas de publicação visíveis, configure o parâmetro pzn.publishServlet.url descrito anteriormente
como sendo um membro de cluster específico. Configure a URL para apontar para uma única máquina
na porta HTTP interna: o número da porta padrão para HTTP é 10040 e para HTTPS é 10035.
Por exemplo, suponha que o cluster principal esteja visível no endereço http://intranet.yourco.com e
que os membros do cluster estejam acessíveis nos endereços http://intranet01.yourco.com e
http://intranet02.yourco.com. Se você configurar o parâmetro de URL do servlet de publicação como
359
http://intranet01.yourco.com:10040/wps/pznpublish/pznpublishservlet todos os pedidos de
publicação serão forçados a serem executados nesta única máquina.
Nota: Publique em um único nó no cluster, em oposição à extremidade do cluster, certificando-se de não
passar por um servidor da Web.
Hosts IPv6
O servidor que inicia o comando publish deve ter a pilha de protocolo IPv6 instalada e disponível. Ao
publicar a partir de uma linha de comandos por meio do pznload para um host IPv6, pode ser necessário
configurar a variável do ambiente do sistema IBM_JAVA_OPTIONS para um valor igual a
-Djava.net.preferIPv4Stack=false -Djava.net.preferIPv6Addresses=true no sistema em que o pznload está em
execução.
Classes da Coleta de Recursos
As coletas de recursos são utilizadas no Personalização para acessar o LDAP, IBM Content Manager,
objeto de usuário do Portal ou outras origens personalizadas de dados.
A edição de tempo de execução do DB2 Content Manager e as classes de coleta de recursos do usuário
do WebSphere Portal são instaladas na biblioteca compartilhada do Personalização. Portanto, não é
necessário mover essas classes entre os sistemas porque já foram instaladas com o Personalização.
Para os recursos LDAP, o Rational Application Developer apresenta um assistente para gerar classes que
implementam as interfaces de coleta de recursos.
Para utilizar o portlet de autoria, todas as classes de coleta de recursos devem estar no caminho de classe
do portlet de autoria Personalização. O editor de regras utiliza essas classes para exibir a lista de
atributos pertencente à coleta. Se as classes de coleta de recursos não forem localizadas pelo editor de
regras, você poderá ver a seguinte mensagem em um alerta JavaScript.
Figura 24. Mensagem Exibida quando não é Possível Localizar as Classes de Recursos
As classes de coleta de recursos também devem existir no caminho de classe do aplicativo que chama as
regras do Personalização. O mecanismo de regras do Personalização localiza as classes de coleta de
recursos utilizando o caminho de classe do aplicativo que chama as regras. Se você utilizar o portlet Lista
Personalizada para exibir os resultados da regra, esse aplicativo será o aplicativo pznruleportlet.war da
Lista Personalizada no Personalização Lists.ear.
Portanto, as classes devem estar acessíveis a ambos, o editor de regras e o aplicativo personalizado. Uma
biblioteca compartilhada do servidor de aplicativos é a maneira mais fácil de realizar isso. Você pode
configurar a biblioteca compartilhada usando o WebSphere Integrated Solutions Console. Para obter
informações adicionais, consulte as seções sobre a biblioteca compartilhada no Centro de Informações do
WebSphere Application Server.
As atualizações e inclusões nas classes da coleta de recursos são manipuladas da mesma forma que as
atualizações feitas a qualquer binário ou JSP do aplicativo. Essas classes não são afetadas pela publicação
do Personalização. A definição da coleta de recursos utilizada pelo Personalização para associar uma
coleta de recursos a suas classes é armazenada no repositório do Content Manager. Representada
360
inicialmente pelo arquivo .hrf, essa definição é publicada juntamente com as regras e campanhas.
Publicando Regras de Personalização
Depois de desenvolver regras de personalização, publique-as.
1. Para começar a publicar regras de personalização, você cria um objeto no ambiente de autoria que
descreve o terminal de destino. Essa definição de terminal é referida como um servidor de publicação
e é criada e gerenciada de forma semelhante à criação e ao gerenciamento de regras e campanhas.
Figura 25. Criando um Novo Servidor de Publicação
O servidor requer um campo que é a URL associada ao servlet de publicação desse nó de
extremidade. O servidor de publicação também pode definir qual espaço de trabalho receberá os
dados de publicação. O Personalização opera no espaço de trabalho de edição de tempo de execução
padrão do Content Manager após a instalação. Se o campo do espaço de trabalho de destino estiver
vazio, o servidor de publicação utilizará o espaço de trabalho padrão. (Você precisará configurar o
campo de área de trabalho se estiver configurando o cenário três descrito anteriormente.)
A última opção é se você deseja ou não excluir objetos remotos que foram excluídos no sistema local.
O padrão é Exclusão Inteligente, que remove apenas os itens que não estão mais presentes. Se você
não tiver permissão para exclusão no servidor remoto, selecione a opção Deixar Recursos Excluídos
no Servidor.
2. Após a criação de um servidor de publicação, você poderá publicar todo o espaço de trabalho ou um
conjunto de objetos dentro dele. Especifique uma dessas opções selecionando o submenu Mais Ações
> Publicar
361
Figura 26. Iniciar uma Tarefa de Publicação
A página Publicar exibe o que será publicado. Essa página requer que o usuário escolha um servidor
de publicação de destino e todas as informações de autenticação necessárias. Se o sistema remoto
estiver protegido e não for um membro do domínio de Conexão Única do servidor atual, será preciso
digitar um nome de usuário e uma senha nos campos fornecidos. Os valores para usuário e senha são
armazenados na segurança da credencial do WebSphere Portal e não estão acessíveis para nenhum
outro usuário.
3. Finalmente, clique em Publicar para ativar a tarefa de publicação.
362
Figura 27. Página Publicação
Se o sistema local puder localizar e autenticar com o servidor de publicação remoto, você será
retornado à visualização do navegador principal e verá a mensagem EJPVP20001I do Personalização.
Em seguida, a tarefa de publicação será executada como processo de segundo plano no servidor local.
4. Clique no link Visualizar os Detalhes dessa Tarefa para abrir a janela de status da publicação e ver
informações relacionadas ao progresso e ao êxito ou falha da tarefa de publicação.
363
Figura 28.
Publicando e Excluindo Regras de Personalização Usando um Script
Você pode usar um script fornecido pelo WebSphere Portal Personalização, pznload, para exportar,
publicar e excluir regras do Personalização nos servidores remotos ou locais. Isso permite a entrega de
regras e de campanhas por script de migração de dados para a produção ou a publicação off-line entre
sistemas desconectados (como quando servidores de produção são protegidos por um firewall). É
possível utilizar essa função para reverter rapidamente os servidores de produção para um estado
anterior.
A publicação através da linha de comandos é um processo de duas etapas. Primeiro, você exporta as
regras de personalização que deseja transferir do ambiente de autoria para um sistema remoto. Depois de
exportar e salvar os objetos necessários, use o script pznload para enviar esses dados para o servidor
apropriado.
1. É possível exportar as regras de personalização no site ou executar o comando pznload. Selecione um
dos seguintes métodos para exportar objetos de personalização do site:
v Clique em Mais Ações > Exportar no navegador de personalização. Você será solicitado a fornecer
o local para salvar um arquivo de nós. Esse arquivo contém uma representação XML de todos os
objetos de personalização selecionados atualmente. É possível exportar pastas inteiras.
364
Figura 29. Exportando uma Pasta para o Sistema de Arquivo
v Abra um prompt de comandos e execute o seguinte comando, em que out designa o local dos
dados exportados em seu sistema local e targetPath é o objeto (e filho) que será exportado:
pznload --export --out filename --serverUrl url --targetPath path --targetWorkspace
workspace --username username --password password
2. Escolha a opção apropriada para enviar esses dados para o servidor apropriado:
O script pznload está localizado no diretório PortalServer_root/pzn/prereq.pzn/publish/.
Dica: Este programa aceita várias opções de linha de comandos e um conjunto de arquivos de nós a
ser publicado. Chame pznload com a opção --help para ver uma lista de todas as opções. Os
argumentos mais importantes estão descritos aqui:
serverUrl
A URL do servlet de publicação remota. Se você não especificar um valor, o programa tentará
conectar-se a um servidor WebSphere Portal em execução na máquina local.
targetWorkspace
O nome do espaço de trabalho no qual publicar. O nome da área de trabalho padrão em todas
as instalações de edição de tempo de execução do IBM Content Manager é
ROOTWORKSPACE.
targetPath
O local no espaço de trabalho de destino que será o pai para os nós publicados. O caminho de
destino deve existir antes da publicação. Exemplo: Se a função Exportar tiver sido usada na
pasta /Projects/HR website, o caminho de destino deverá ser especificado como /Projects
para que os recursos publicados estejam novamente localizados em /Projects/HR website.
username
Um usuário válido no sistema de destino com direitos de acesso suficientes.
senha A senha para o usuário
v Janelas: pznload.bat --serverUrl url --targetPath path--targetWorkspace workspace
--username username --password password
365
v AIX,SolarisLinux: ./pznload.sh --serverUrl url --targetPath path --targetWorkspace
v IBM i: pznload.sh --serverUrl url --targetPath path --targetWorkspace workspace --username
username --password password
v z/OS: Conclua as seguintes etapas para enviar esses dados para o servidor apropriado:
Nota: Antes de executar esta tarefa, você pode querer visualizar e imprimir as planilhas adequadas
do IBM WebSphere Portal Enable para z/OS, localizadas no wiki para ajudá-lo a definir suas
variáveis.
a.
b.
c.
d.
Inicie o diálogo de customização do WebSphere Portal.
No painel de configuração do Portal, selecione Tarefas de configuração do aplicativo.
Selecione Configurar Personalização.
Selecione Definir Variáveis. Lembrete: Pressione F1 para exibir o painel de ajuda se precisar de
ajuda ao definir as variáveis.
e. Gere as tarefas de customização.
f. Siga as instruções no Diálogo de Customização para enviar as tarefas de customização.
3. Para excluir objetos, execute o seguinte comando, em que TargetPath é o objeto (e todos os filhos
associados) que será excluído.
pznload --delete --targetPath path -serverUrl url --targetPath path --targetWorkspace
Após o início de uma publicação, as mensagens de status são vistas no console de comandos.
Planilhas do WebSphere Portal Enable para zOS
Publicando Regras de Personalização Sobre SSL
O WebSphere Portal Personalização utiliza os recursos internos de SSL do WebSphere Application Server
para fornecer publicação segura entre as redes desprotegidas. O portal personalizado pode obter
benefícios com a variedade de repositórios de autenticação suportados pela segurança do WebSphere
Application Server.
Em alguns ambientes, até mesmo a publicação de SSL pode não ser segura o suficiente. O programa de
linha de comandos pznload permite controle total do transporte das regras e das campanhas durante a
publicação. É possível criptografar o arquivo .nodes exportado e enviá-lo usando email, ou usar outro
canal seguro, como uma mídia física transportada entre os servidores temporário e de produção.
1. Ative SSL entre os servidores de personalização. Para ativar a publicação do Personalização sobre SSL,
consulte a ajuda sequencial do navegador do Personalização: clique no ponto de interrogação e role
para baixo até o final da página para localizar o link para o tópico de ajuda na publicação.
2. Altere a URL do servlet de publicação para uma publicação segura. Se o servidor remoto não estiver
utilizando a porta HTTPS padrão 443, modifique a URL incluindo dois pontos e o número da porta
imediatamente depois do nome do host.
366
Figura 30. Alterando a URL de servlet de publicação para uma publicação segura ao incluir dois pontos e o número
de porta após o nome do host para servidores remotos que não usam a porta 443 dos HTTPs padrão.
3. Configure o servidor de personalização do qual você fará a publicação para usar o protocolo HTTPS.
Para saber se uma determinada URL é válida, aponte seu navegador para esse local e digite seu nome
do usuário e sua senha para o sistema. Se você vir a mensagem Publicar Servlet Disponível e todos os
certificados SSL tiverem sido importados corretamente, você poderá publicá-los. É possível alterar essa
URL para redirecionar todas as tarefas de publicação por meio de um membro de cluster específico.
Se você encontrar uma mensagem de erro que indique que o serviço de publicação não estava
disponível, o servlet de publicação local poderá não estar configurado corretamente. Para configurar a
URL de servlet de publicação local:
a. Na página Administração do Portal, selecione Gerenciamento do Portlet > Portlets.
b. Localize a documentação do Personalização Navigator na lista.
c. Clique em Configurar Portlet para configurar o portlet.
d. Inclua um novo parâmetro de portlet cujo nome é pzn.publishServlet.url e especifique o valor
apropriado.
367
Figura 31. Configurando o Serviço de Publicação Local
Se um servidor Personalização estiver configurado para usar uma porta ou uma raiz de contexto HTTPS
não padrão, ou se você vir mensagens como EJPVP20002E: O serviço de publicação local não estava
disponível ao publicar a partir do ambiente de autoria, a URL do servlet de publicação local pode esta
incorreta.
Monitorando o Status da Publicação
Depois de iniciar uma tarefa para publicar uma regra de personalização, você poderá monitorar o status
para certificar-se de que a publicação seja concluída com êxito.
Todas as tarefas de publicação atualmente em execução ou que foram concluídas são exibidas na
visualização de status. Se ocorrer algum erro, obtenha informações adicionais ativando o rastreio do Java
Runtime Environment para o WebSphere no sistema cliente ou examinando os logs de erro e de rastreio
no sistema servidor.
1. Para ver o status de todas as tarefas de publicação atuais, selecione Mais Ações > Publicar >
Visualizar Status.
368
Figura 32. Janela Status da Publicação
2. Depois que uma tarefa é concluída (com êxito ou não), um ícone de fechamento é exibido informando
que você pode clicar para remover a tarefa da lista de tarefas monitoradas. Se você clicar neste ícone,
não poderá mais visualizar o status dessa tarefa.
A Coleta de Recursos do Conteúdo da Web
A Coleta de Recursos do Conteúdo da Web é instalada e configurada de modo a estar prontamente
disponível. Essa coleta predefinida permite gravar regras que selecionam listas de conteúdo do IBM Web
Content Manager. As regras especificam qual conteúdo da Web deve ser exibido em um componente
Portal Personalization, no Web Content Manager.
O componente Personalização é similar a um componente de menu em que o conteúdo é decidido por
uma regra. O componente Personalização especifica como o conteúdo retornado da regra é apresentado e
aponta para uma regra para decidir qual conteúdo exibir. A regra pode fazer uso da coleta de recurso do
Conteúdo da Web para selecionar uma lista de conteúdos da Web.
As regras do Personalização que você cria usando o editor do Personalização não são gerenciadas no Web
Content Manager e, portanto, não estão disponíveis para versão ou incluídas na organização. Essas regras
devem ser publicados usando pznload ou publicando com o Personalização.
A coleta de recursos do Conteúdo da Web permite regras que se baseiam nos seguintes atributos:
Tabela 116. Atributos Utilizados nas Regras do Personalization para Coletas de Recursos do Conteúdo da Web. Os
nomes e descrições dos atributos do Conteúdo da Web que você pode utilizar nas regras do Personalization
Atributo
Descrição
Autor
O autor do conteúdo conforme configurado em Web
Content Manager. Esse valor de atributo é armazenado
como um Nome Distinto; por exemplo,
uid=wpsadmin,o=defaultWimFileBasedRealm.
Modelo de Autoria (Authoring template)
O modelo de autoria utilizado para criar o conteúdo da
Web. O valor pode ser selecionado utilizando um
selecionador de modelo de autoria.
Propriedades do Modelo de Autoria
Todas as propriedades do modelo de autoria disponíveis
para serem usadas dentro das regras.
369
Tabela 116. Atributos Utilizados nas Regras do Personalization para Coletas de Recursos do Conteúdo da
Web (continuação). Os nomes e descrições dos atributos do Conteúdo da Web que você pode utilizar nas regras
do Personalization
Atributo
Descrição
Categoria (Category)
As categorias às quais parte do conteúdo da Web
pertence. Se estiver correspondendo esse atributo a um
valor de outra coleta de recurso ou objeto de aplicativo,
o formato do valor deve ser /parentcategory/
childcategory.
Data de Criação (Creation date)
A data na qual parte do conteúdo da Web foi criado.
Autor (Creator)
A pessoa que primeiro criou essa parte do conteúdo da
Web. Esse valor de atributo é armazenado como um
Nome Distinto; por exemplo,
uid=wpsadmin,o=defaultWimFileBasedRealm.
Descrição
A descrição fornecida para a parte do conteúdo da Web.
Data de Expiração (Expiration date)
A data em que o conteúdo está configurado a expirar no
Web Content Manager.
Texto Completo
Utilize esse atributo para procurar o texto completo de
uma parte do conteúdo da Web. Isso deve ser utilizado
com parcimônia. Pode ser que esse atributo não execute
tão rapidamente quanto os outros ao ser utilizado nas
regras, especialmente quando utilizado em conjunto com
outros atributos.
Palavras-chave
As palavras-chave armazenadas na parte do conteúdo da
Web.
Data da Última Modificação
A data em que ocorreu a última modificação na parte do
conteúdo.
Último Modificador
A última pessoa a modificar a parte do conteúdo. Esse
valor de atributo é armazenado como um Nome Distinto;
por exemplo, uid=wpsadmin,o=defaultWimFileBasedRealm.
Nome
O nome da parte do conteúdo da Web conforme
especificado no Web Content Manager.
Essa propriedade utiliza correspondência sem distinção
entre maiúsculas e minúsculas. Por exemplo, um
fragmento de conteúdo com um nome "SampleContent"
corresponde a "SampleContent," "samplecontent,"
"SAMPLECONTENT" e outras variações.
Posição
A posição numérica baseada em zero da parte do
conteúdo entre seus irmãos nos nós da hierarquia do
conteúdo. As coletas de recursos do Conteúdo da Web
utilizam posicionamento absoluto e posicionamento
relativo para suportar a ordem dos itens de conteúdo. O
algoritmo utilizado para gerar resultados de números de
posição em valores fracionais e negativos que controlam
a ordem de exibição de um conjunto filho de itens sob
uma área determinada de um site.
Para obter informações adicionais, consulte a descrição
do atributo de posição em Referência de Comando para a
Interface de Script do Portal.
Data de Publicação
370
A data de publicação, conforme especificado em Web
Content Manager.
Tabela 116. Atributos Utilizados nas Regras do Personalization para Coletas de Recursos do Conteúdo da
Web (continuação). Os nomes e descrições dos atributos do Conteúdo da Web que você pode utilizar nas regras
do Personalization
Atributo
Descrição
Local
A biblioteca de documentos ou a área de site da qual
selecionar conteúdo. Se especificado como uma cadeia,
deverá estar no formato /Library/Site/SiteArea. Você
também pode especificar */Site/SiteArea para procurar
por área de site em todas as bibliotecas de documento.
As regras das versões anteriores com o atributo Área de
Site farão referência automaticamente ao Local. Se a área
de site tiver sido especificada como uma cadeia,
assegure-se de que a cadeia comece com /Library ou um
asterisco (*).
Título
O título de exibição conforme especificado no Web
Content Manager.
Identificador Exclusivo
Utilize esse atributo para selecionar partes do conteúdo
da Web.
Quando um componente de texto, de texto abreviado, numérico ou de data for incluído em um modelo
de autoria no Web Content Manager, esse componente aparecerá como um atributo numa coleta de
recursos sob o item de item Propriedades do Modelo de Autoria. Por exemplo, se um modelo de autoria
for criado para "Anúncio de Benefício" o que inclui um componente de data "enrollment begin", você terá
um atributo "Início da Inscrição" na coleta de recursos do Conteúdo da Web. Esse novo atributo aparecerá
num submenu para "Anúncio de Benefício". Isso permitirá gravar regras com base nos metadados
customizados anexados ao conteúdo da Web. O desempenho dos metadados padrão serão melhor
comparados ao desempenho das regras que utilizam os atributos incluídos nos modelos de autoria. A
utilização das palavras-chave e categorias deve ser considerada visto que faz dos metadados padrão do
conteúdo da Web.
Se excessivas propriedades do modelo de autoria tiverem sido designadas, o menu Propriedades do
Modelo de Autoria poderá se tornar muito grande para ser usado com facilidade. Assim que houver mais
de 15 propriedades do modelo de autoria, elas serão substituídas por um seletor para a seleção de
propriedades. Esse limite pode ser ajustado, alterando o valor de wcm.authoringTemplate.menu.threshold
em wp_profile_root/PortalServer/config/config/services/PersonalizationService.properties.
As regras de personalização que consultam texto curto são executadas mais rapidamente que aquelas que
consultam texto. Os componentes de texto curto podem armazenar apenas 254 caracteres. Os
componentes de texto podem armazenar um número ilimitado de caracteres, mas as regras de loja só
verão os primeiros 254 caracteres. Tudo o que vier depois será ignorado quando a regra for executada.
Nota: Todos os atributos que armazenam uma referência a uma pessoa são armazenados como nomes
distintos. Esse formato corresponderá ao valor do atributo Nome Distinto na coleta de recursos do
Usuário do Portal. Por exemplo, para selecionar todos os documentos redigidos pelo usuário que está
visualizando o portlet, escreva "Author is current Portal Users.Distinguished Name".
A Coleta de Recursos do Usuário do Portal
Portal Personalization vem com uma coleta de recursos Usuário do Portal. Essa coleta utiliza APIs
públicas fornecidas pelo IBM WebSphere Portal para acessar as informações do usuário.
A coleta permite que regras sejam gravadas com base em todas as propriedades do usuário do
WebSphere Portal.
371
Você também pode utilizar a coleta de recursos do Usuário do Portal para perfil, com base no banco de
dados de extensão de propriedade. Utilize a opção de menu Gerenciar Propriedades (Manage
Properties) no editor de regras para incluir ou remover propriedades do Lookaside ou propriedades
dinâmicas a partir da coleta. Você pode incluir qualquer propriedade nessa coleta, mas para que elas
funcionem no tempo de execução, alguns valores deverão ser armazenados no Gerenciador de Membro
Virtual das propriedades que estão sendo utilizadas e do usuário que está executando a regra. A tela
Gerenciar Propriedades também poderá ser utilizada se o servidor no qual você criar as regras tiver uma
configuração de Gerenciador de Membro Virtual diferente daquela em que as regras estão
implementadas.
A coleta de recursos não é nova para WebSphere Portal Versão 8.0, contudo agora ela mostra a lista de
atributos do Usuário do Portal automaticamente. Não é mais necessário incluir cada propriedade do
WebSphere Portal que deseja utilizar como uma propriedade dinâmica no editor de regras do
Personalização. Não é necessário gerar código Java para usar essa coleta ou configurar um conversor de
ID de segurança, já que isso é muitas vezes requerido pelas coletas do Usuário do Personalização. No
momento, não é possível redigir regras para selecionar ou recomendar uma lista de usuários a partir
dessa coleta. Essa coleta funciona com regras de atualização, desde que seu repositório permita
gravações. A coleta funciona como se fosse uma coleta LDAP configurada automaticamente para o
servidor LDAP.
É possível continuar a utilizar as coletas de recursos de usuários do LDAP ou customizadas existentes, e
até utilizá-las nas mesmas regras como Coleta do Usuário do Portal. Isso será útil se você tiver vários
repositórios de usuários, se possuir um repositório que não é normalmente utilizado pelo Portal e é
utilizado apenas para as regras do Personalização, ou se precisar da conversão do valor do atributo
(interpretar 'CHI' como 'Chicago', por exemplo).
Utilizando o Atributo de Grupos
O Atributo de Grupos no objeto Usuário do Portal expõe os dns (nomes distintos) dos grupos. Um
exemplo de nome distinto de um grupo é cn=wpsadmins,o=defaultWimFileBasedRealm, embora a forma
exata varie de acordo com a sua instalação. O uso de nome distinto permite a correspondência mais exata
de grupos, pois é possível que dois grupos compartilhem um nome comum, como wpsadmins. O operador
includes pode ser utilizado para correspondência inexata de cadeia, mas terá um desempenho um pouco
372
mais lento. Quando possível, utilize o operador is e compare com o nome distinto do grupo.
Incluindo e Estendendo Atributos do Usuário
É possível tornar os atributos de seu registro do usuário disponíveis para o portlet de personalização,
conforme necessário. Entretanto, na maioria dos casos, o esquema para seu registro do usuário não
corresponde ao esquema padrão do Virtual Member Manager (VMM). Por esse motivo, é necessário
primeiro estender o esquema padrão do VMM, incluindo atributos que você deve mapear do esquema do
VMM para seu registro do usuário.
Execute o seguinte para tornar os atributos do usuário disponíveis:
1. Estenda o esquema padrão do VMM, incluindo atributos que você pode mapear para seu registro do
usuário. Para obter instruções, consulte o seguinte tópico na seção Instalação deste Centro de
Informações: Incluindo Atributos. Consulte o tópico que corresponde à configuração de seu sistema
operacional e ambiente.
2. Mapeie os atributos que você incluiu no esquema do VMM para os atributos em seu registro do
usuário. Para obter instruções, consulte o seguinte tópico na seção Instalação deste Centro de
Informações: Mapeando Atributos. Consulte o tópico que corresponde à configuração de seu sistema
operacional e ambiente.
Configurando Quais Propriedades Apresentar para a Coleta do Usuário do Portal
O editor de regras do Personalização descobre a lista de propriedades a serem exibidas nas regras por
meio de uma API pública (com.ibm.portal.um.PumaProfile). A lista exibida por essa API é configurável
na configuração do Gerenciador de Membro.
Pode ser que você tenha uma lista longa de propriedades disponíveis no usuário do portal, mas não
queira que toda ela seja apresentada no editor de regras do Personalização. Com esse objetivo, configure
a propriedade wmm.property.hide no arquivo wp_profile_root/PortalServer/config/config/services/
PersonalizationService.properties conforme ilustrado nesse exemplo:
# Utilize essa propriedade de configuração para controlar quais propriedades do WMM mostrar
# no editor de regras do Personalization. wmm.property.hide ocultará apenas
# aquelas propriedades que são observadas a partir da configuração do WMM.
wmm.property.hide=mobile,pager,roomNumber,secretary,carLicense,telephoneNumber,facsimileTelephoneNumber,
seeAlso,userPassword,ibm-firstWorkDayOfWeek,ibm-alternativeCalendar,ibm-preferredCalendar,
ibm-firstDayOfWeek,ibm-primaryEmail,ibm-otherEmail,ibm-generationQualifier,labeledURI,createTimestamp,
modifyTimestamp,ibm-middleName,ibm-timeZone,initials,jpegPhoto,WCM\:USERDATA,groups
A Coleta do Usuário do Portal e do Servidor de Personalização Instalada Sem o
Portal
A coleta do Usuário do Portal pode ser utilizada nas regras executadas dentro de uma instalação do
WebSphere Portal. O sistema não impedirá a publicação de regras utilizando essa coleta em um
Personalização Server instalado fora do WebSphere Portal, mas as regras não funcionarão nesse ambiente,
já que o Gerenciador de Membro Virtual não está disponível. Quando o WebSphere Portal está instalado,
o contexto de segurança do usuário on-line deve ter acesso (por meio das permissões de recursos do
Portal) às informações dos usuários que estão sendo acessadas por meio da coleta.
Recomendações do LikeMinds
Personalização contém um sistema de recomendação dinâmico baseado em LikeMinds. O software
LikeMinds é utilizado com os aplicativos e-commerce. O LikeMinds analisa as interações do usuário que
ocorrem no Web site e gera previsões e recomendações em tempo real para os usuários do seu Web site.
As previsões em tempo real são geradas pelos três mecanismos do LikeMinds, utilizando as regras de
recomendação do Personalização. Essas regras, chamadas conteúdo recomendado, baseiam suas previsões
nas transações registradas pelos beans de classificação e ação do Personalização.
373
Quando um usuário visita o seu site da Web, os beans de classificação e ação registram os dados de
transações capturados. Se o seu site da Web de e-commerce Web estiver configurado para que os usuários
possam classificar o conteúdo (ou produtos), você utilizará os beans classificação para capturar dados de
classificação. Da mesma forma, se você utilizar a tecnologia de carrinho de compras, utilizará os beans
registro da ação para capturar o comportamento de afinidade do conteúdo com a finalidade de capturar
atividades de compra. Os dados de classificação e de transações são armazenados em seu banco de
dados. Por exemplo, os seguintes tipos de transações podem ser registrados:
v Produtos adquiridos por um usuário
v Os itens incluídos ou removidos de uma cesta de compras
v Um histórico da navegação do usuário por todo o aplicativo
v Produtos que combinam melhor com um produto já selecionado pelo usuário
v Qualquer ação ou série de ações que sejam significativas para um site
Utilizando as regras de conteúdo de recomendação, o LikeMinds apresenta resultados através de
mecanismos de recomendação. Esses mecanismos prevêem conteúdo relevante aos usuários com base nos
seus hábitos passados de navegação pela Web.
Geralmente, depois que um usuário classificou um número mínimo de itens ou concluiu um número
mínimo de atividades de transação, um conjunto de mentores é atribuído a esse usuário. Um mentor é
um usuário especialmente designado que visitou o aplicativo de e-commerce diversas vezes e cujo perfil
é semelhante ao do usuário. O LikeMinds utiliza uma técnica que se chama filtragem colaborativa para
construir um perfil do mentor para prever o quanto um usuário gostará de determinados itens e quais
itens ele apreciará, comprará ou incluirá em seu carrinho de compras.
A previsão de um produto correspondente para acompanhar um produto selecionado pelo usuário,
independente das preferências reais do usuário, é realizada pela descoberta de pares prováveis de
correspondências de produtos para recomendação. Este conceito chama-se afinidade de itens e utiliza uma
família de algoritmos diferentes da filtragem colaborativa. Enquanto a filtragem colaborativa utiliza seus
algoritmos para discernir as afinidades altamente variáveis entre navegadores individuais na Web, a
abordagem de afinidade do item verifica os relacionamentos que podem existir entre os itens.
Você pode utilizar o LikeMinds em várias situações, incluindo:
v Web sites de promoção e personalização de eRetailer
v Web sites de recomendação e personalização de conteúdo do portal financeiro
v Help desk e/ou Web sites de recomendação de conteúdo de suporte técnico on-line
v Recomendações de presentes para o eRetailer
v Música, cinema, livro ou outras classificações e recomendações de produtos
v Planos de viagem da agência de viagens
Arquitetura do Mecanismo de Recomendação LikeMinds
Obtenha uma visão geral do funcionamento e arquitetura do Mecanismo de Recomendação do
LikeMinds. Para construir seu próprio aplicativo de recomendação, é necessário personalizar as definições
do Mecanismo de Recomendação do LikeMinds para que funcionem com o seu banco de dados e com
aplicativos da Web.
O Mecanismo de Recomendação do LikeMinds captura dados com base em ações do usuário. A partir
desse conjunto de ações, o LikeMinds baseia sua construção de conjuntos de mentores e previsões
subsequentes. As ações do usuário podem incluir:
v Um histórico da navegação do usuário por todo o aplicativo
v Produtos que combinam melhor com um produto já selecionado pelo usuário
v Produtos comprados
v Itens incluídos ou removidos de uma cesta de compras
374
As preferências do usuário atuais são coletadas pelo mecanismo no suposto vetor de classificação e
utilizadas para identificar as pessoas que se assemelham ao usuário atual.
As pessoas com um comportamento semelhante ao do usuário atual tornam-se mentores desse usuário. O
Mecanismo de Recomendação do LikeMinds designa uma importância numérica a cada mentor com base
no nível de similaridade de seu vetor de classificação aos seus. Quanto mais valores de classificação do
mentor se assemelham a um usuário e mais produtos foram classificados pelo mentor, maior será o peso.
O Mecanismo de Recomendação do LikeMinds monta um conjunto de recomendações, localizando os
produtos que cada mentor recomenda e criando um vetor de previsão que contém a classificação prevista
de cada produto. Com cada classificação prevista, ele também armazena um valor numérico que
representa a confiança da classificação.
Os valores de confiança determinam a qualidade das previsões. O Mecanismo de Recomendação do
LikeMinds designa um nível de confiança a cada recomendação com base em quantos usuários avaliaram
o item recomendado e na semelhança das classificações entre si.
Um usuário é atribuído a um conjunto de mentores apenas depois de ter classificado um número mínimo
de itens ou concluído um número mínimo de atividades de transação.
Para que o aplicativo preveja um produto correspondente para acompanhar o produto selecionado por
um usuário, você pode configurar prováveis pares de correspondências de produtos para serem
recomendados. Esse conceito é chamado de afinidade de itens.
Dependendo do tipo de recomendação que você deseja extrair, deve-se configurar os mecanismos
específicos, como o Mecanismo de Preferência ou Mecanismo de Afinidade de Itens. A imagem a seguir
mostra os detalhes da arquitetura geral do Mecanismo de Recomendação LikeMinds.
375
Como o LikeMinds Gera Recomendações
Aprenda como o LikeMinds gera recomendações quando um usuário efetua logon e navega pelo seu Web
site.
Quando um usuário efetua logon e navega pelo Web site, o LikeMinds segue essas etapas para gerar
recomendações para esse usuário:
1. Os beans de registro de classificação e ação do Personalização criam um registro para novos usuários
na tabela Lps_User_Data. A tabela Lps_User_Data armazena os seguintes tipos de informações sobre o
usuário: o ID de recurso do usuário, um ID do usuário, o número de itens que o usuário classificou
ou selecionou, etc.
2. Os beans classificação do e registro de ação do Personalização registram dados para esse usuário à
medida que esse usuário navega pelo seu Web site.
Os dados do perfil são armazenados primeiro no cache do servidor e, em seguida, o servidor grava
todos os novos dados no banco de dados. A tabela Lps_User_Rating armazena as preferências
explícitas do usuário; a tabela Lps_User_Trx armazena a sequência de cliques e o comportamento de
compra do usuário. A tabela Lps_User_Trx também armazena dados de entrada de afinidade de itens.
3. O aplicativo pode então consultar o LikeMinds para obter as recomendações. As consultas de
recomendações são específicas dos dados da transação.
v As recomendações de preferência são baseadas na regra de recomendação de conteúdo. Para
receber as recomendações de Preferência, o aplicativo deve registrar as preferências explícitas dos
usuários (classificações) utilizando o bean de Classificação.
376
v As recomendações de Sequência de Cliques são baseadas na regra de recomendação de conteúdo.
Para receber recomendações de Sequência de Cliques, o seu aplicativo deve gravar os
comportamentos de sequência de cliques do usuário (ou seja, visualizações de detalhes do produto,
inserções na cesta de compras, etc.), utilizando o bean de ação.
v As recomendações de Afinidade de Itens estão na forma: “esse protetor de boca é um produto
que provavelmente acompanhará o disco de hóquei que o usuário acabou de incluir ao
carrinho de compra”. Para receber recomendações de Afinidade de Itens, o aplicativo deve gravar
as correspondências de pares de produtos prováveis dos usuários. Ou seja, o aplicativo deve
capturar o contexto atual "content/product" utilizando o bean de Ação, para retornar os itens mais
associados a esse "content/product".
4. Dependendo do mecanismo que você estiver utilizando, a próxima etapa será a seguinte:
v Mecanismos de Preferência e de Fluxo de Cliques: Para um novo usuário, se seu aplicativo
consultar o LikeMinds para obter recomendações antes da designação de mentores a esse tipo de
dados (ou seja, Preferência, Fluxo de Cliques ou Afinidade de Item), o servidor designará mentores
de um conjunto de mentores armazenados em cache.
Se, por falta de dados do perfil, o servidor não puder corresponder os mentores em cache com esse
usuário, ele fornecerá um conjunto vazio de recomendações. Uma distinção importante, os dados
do perfil significam os dados da transação para o usuário atual e não os atributos desse usuário.
v Mecanismo de Afinidade de Itens: Se o o aplicativo estiver prevendo correspondências de pares de
produtos com afinidade de itens, ele coletará dados com base em um conjunto de definições criadas
por você, denominado conjunto de afinidades de itens. Para dados de entrada, o conjunto de
afinidade de itens utiliza transações de uma tabela de entrada especificada.
5. Dependendo do mecanismo, a próxima etapa será a seguinte:
v Mecanismos de Preferência e Sequência de Cliques: Depois que um perfil de usuário estiver
armazenado no banco de dados, o utilitário sifter poderá calcular mentores para esse usuário. O
sifter é um utilitário de segundo plano que atribui um conjunto de mentores a cada usuário.
– As atribuições de mentores são específicas para cada tipo de dados.
– As atribuições de mentores são armazenadas na tabela de mentores associada a este tipo de
dados.
v Mecanismo de Afinidade de Itens: O accumulator gera correspondências de pares de produtos
com afinidades de itens, analisando os dados no conjunto de afinidades de itens (como a tabela de
transações) e gravando suas descobertas em uma tabela de saída.
6. Dependendo do mecanismo, a próxima etapa será a seguinte:
v Mecanismos de Preferência e Sequência de Cliques: À medida que novos dados são gravados
para um usuário, o sifter prioriza o novo processamento do usuário para calcular novas
atribuições de mentores. Os usuários são priorizados por uma 'prioridade sift' calculada, refletindo
a porcentagem de dados novos ou alterados do perfil desse visitante.
v Mecanismo de Afinidade de Itens: À medida que novos comportamentos de seleção de produto
forem gravados na tabela de entrada da transação especificada na definição do conjunto de
afinidades de itens, o accumulator utilizará esses dados para calcular novas recomendações de
afinidades de itens.
7. Quando seu aplicativo executa regras do LikeMinds, ocorre o seguinte, dependendo do mecanismo:
v Mecanismos de Preferência e de Fluxo de Cliques: O LikeMinds consulta os mentores desse
usuário e calcula recomendações.
v Mecanismo de Afinidade de Item: O LikeMinds calcula os pares de item-conteúdo mais prováveis,
com base no histórico de transação de item acumulado.
Mecanismos de Recomendação LikeMinds
Os Mecanismos de Recomendações do LikeMinds se comunicam com um banco de dados relacional e
geram recomendações. Aprenda sobre os três tipos de mecanismos de recomendação, mecanismo de
preferência, mecanismo Clickstream e mecanismo de afinidade de itens.
377
A seguir, há uma descrição dos três tipos de mecanismos de recomendação:
v Mecanismo de Preferência: Esse mecanismo gera recomendações utilizando algoritmos de filtragem
colaborativos patenteados com base nas classificações de itens dos usuários.
v Mecanismo de Sequência de Cliques: Este mecanismo, que também acessa informações de transações,
gera recomendações baseadas nas ações dos usuários quando eles navegam por um website, isto é, o
histórico de “cliques” do usuário durante visitas ao website e os itens que eles visualizam, clicam e
incluem em seus carrinhos de compras.
v Mecanismo de Afinidade de Itens: Esse mecanismo gera recomendações com base no histórico da
atividade de navegação no site do usuário. Ele corresponde um produto atualmente selecionado com
um segundo produto que o usuário provavelmente gostaria de comprar com o primeiro produto. Por
exemplo, se um usuário estiver comprando mantimentos e incluir sopa de cebola francesa ao carrinho
de compras, o mecanismo Afinidade de Itens pode recomendar o queijo Gruyere para acompanhar.
Mecanismo de Preferência:
O Mecanismo de Preferência usa preferências do usuário indicadas explicitamente para fazer
recomendações altamente precisas sobre produtos e conteúdo que os visitantes de seu website gostam.
O Mecanismo de Preferência permite que itens que os clientes poderiam esquecer sejam apresentados a
ele. Por exemplo, os usuários que compram presentes podem receber recomendações com base nas
preferências de compras do receptor do presente.
O enviado com o Mecanismo de Recomendação do LikeMinds apresenta uma implementação típica do
Mecanismo de Preferência:
v Um usuário pode classificar um filme e o LikeMinds retorna uma classificação prevista para esse filme.
Por exemplo, um usuário pode atribuir o filme Fantasia com uma classificação "Eu adorei esse filme".
Internamente, a classificação corresponde a um valor numérico.
v Um usuário pode solicitar uma recomendação sobre a melhor aposta, que é fornecida por uma regra
do LikeMinds. Isso corresponde a perguntar que filme um usuário gostaria mais entre todos os filmes
disponíveis.
Mecanismo de Fluxo de Cliques:
Com base nos dados de navegação reunidos enquanto os clientes navegam pelo Web site, o Mecanismo
de Seqüência de Cliques rastreia o comportamento de seqüência de cliques (ou classificação) e gera
recomendações com base nos mentores que apresentam afinidades de conteúdo/produto semelhantes.
O Mecanismo de Seqüência de Cliques monitora as páginas vistas pelos usuários. Depois de analisar os
padrões de tráfego de todos os usuários, são feitas as recomendações de conteúdo para cada usuário
específico, utilizando os dados dos subconjuntos relevantes da base de usuários.
Mecanismo de Afinidade de Itens:
O Mecanismo de Afinidade de Itens gera recomendações baseadas em qualquer histórico transacional
disponível, como a atividade de carrinho de compras, transações externas herdadas e transações de Web
totalmente sem relação com a atividade de carrinho de compras (visualizações de páginas, consultas de
produtos, procuras, etc).
Um Mecanismo de Afinidade de Itens pode, por exemplo, prever que um usuário que compra uma
câmera digital provavelmente deseja comprar placas de flash compactas ou um leitor de cartão USB. O
Mecanismo de Afinidade de Itens identifica também as conexões menos óbvias, que os usuários que
compram cervejas provavelmente compram fraldas ao mesmo tempo, por exemplo.
O mecanismo Afinidade de Itens permite que você acompanhe o curso de mais do que simples compras
medidas no momento do registro de saída. Ele pode identificar itens que usuário apenas considerou para
378
compra. Por exemplo, ele pode saber quando um usuário apenas considerou comprar pão de centeio ao
invés de realmente comprá-lo. (Isto é medido por uma inclusão no carrinho de compras, seguida por uma
eliminação no carrinho de compras, do pão de centeio.) Nesse caso, o comerciante não poderia saber que
o usuário considerou comprar pão de centeio durante a sessão de compras, já que o pão de centeio não
estava no carrinho de compras no momento do registro de saída. Embora uma compra que foi
considerada não indique necessariamente o mesmo nível de afinidade de itens do que uma compra
efetuada, ela transmite informações sobre afinidade de itens.
Diferente dos outros mecanismos, as recomendações do Mecanismo de Afinidade de Itens estão baseadas
nas estatísticas de Análise da Cesta de Compras, não na filtragem colaborativa. A Análise da Cesta de
Compras permite previsões de afinidade de conteúdo, mesmo quando situações de inicialização a frio
prejudicam a relevância da filtragem colaborativa. O Mecanismo de Afinidade de Itens pode ser utilizado
para fornecer recomendações automatizadas aprimoradas, como vendas cruzadas, mesmo para os
visitantes que entram pela primeira vez no Web site.
Os Utilitários de LikeMinds
Obtenha uma visão geral de sifter, buildstats, buildvisit e accumulator, os utilitários que suportam a
execução de processos de segundo plano junto com o servidor LikeMinds.
Os seguintes utilitários suportam os processos de segundo plano que operam no banco de dados quando
o servidor LikeMinds está em execução:
v sifter: Esse utilitário é executado continuamente para identificar mentores para os novos usuários e
recalcula o melhor conjunto de mentores para os usuários existentes. O conjunto de mentores para um
usuário pode alterar à medida que o sifter reúne mais informações sobre o usuário ou os mentores. O
sifter identifica mentores para os mecanismos de Preferência e de Sequência de Cliques.
v buildstats: Esse utilitário é executado uma vez ao dia para atualizar as estatísticas de cada item, como
o número de classificações ou transações, a classificação média, o desvio padrão na classificação média
e as informações de recomendação padrão. Os mecanismos de Sequência de Cliques e de Preferências
utilizam buildstat. O mecanismo Afinidade de Itens não o utiliza.
v buildvisit: Esse utilitário, utilizado pelo mecanismo Preferência, é executado diariamente para
construir listas de itens a serem apresentados aos usuários para classificação. Se os aplicativos não
utilizam o mecanismo Preferência, o buildvisit não é necessário.
v accumulator: Para o mecanismo Afinidade de Itens, o accumulator (listado como lpsIAA no diretório
util) acumula o número de vezes que ocorre cada combinação possível de item a item e grava suas
descobertas em uma tabela de saída especificada pelo conjunto de afinidades de itens. Um conjunto de
afinidade de itens define o tipo de dados requerido para construir uma combinação de item a item.
Configurando o LikeMinds
Use uma ferramenta de modificação de banco de dados adequada ou edite o arquivo
likemindsdb.properties para configurar sua instalação do servidor LikeMinds.
Configure as informações gerais do parâmetro lps_cfg para a instalação do servidor LikeMinds:
v Informações básicas do servidor
v Planejando os eventos do LikeMinds
v Gerenciamento de carga do servidor
v Comportamento do cache
v Comportamento de recomendação
Todos esses parâmetros são configurados no arquivo likemindsdb.properties. Este arquivo está
localizado no diretório wp_profile_root/pzn/config/runtime/likemindsdb.properties. O arquivo está em
ASCII. Para editá-lo, utilize um editor ASCII.
O LikeMinds armazena suas informações de configuração na tabela lps_cfg de seu banco de dados, que é
inicializado com os dados no arquivo likemindsdb.properties. Para atualizar essa configuração, é
379
possível atualizar esse arquivo e recarregar os dados de configuração, ou usar qualquer ferramenta de
modificação do banco de dados, para modificar os parâmetros de configuração do LikeMinds. Para
atualizar valores de configuração, conclua estas etapas:
1. Pare o servidor WebSphere_Portal.
2. Edite o arquivo likemindsdb.properties.
3. Escolha a tarefa apropriada para atualizar a configuração:
v Janelas: ConfigEngine.bat likeminds-load-config -DWasPassword=password
v AIX,SolarisLinux: ./ConfigEngine.sh likeminds-load-config -DWasPassword=password
v IBM i: ConfigEngine.sh likeminds-load-config -DWasPassword=password
v Execute a tarefa de customização EJPSPZLL, criada pelo Diálogo de Customização no conjunto de
dados de controle de destino. Essa tarefa executa a tarefa de configuração likeminds-load-config.
v Use a ferramenta de modificação do BD para atualizar a configuração diretamente.
4. Inicie o servidor WebSphere_Portal.
Avaliando o Tamanho do Banco de Dados:
O tamanho de seu banco de dados depende do seu aplicativo, assim como do número de usuários e
itens. Visualize algumas diretrizes gerais para obter estimativas de tamanho de seu banco de dados, mas
os resultados poderão variar.
Um banco de dados contendo os dados iniciais fornecidos com o aplicativo Movie Site pode utilizar
apenas 250 MB, enquanto as tabelas do LikeMinds para um grande site com milhões de usuários podem
utilizar até 10 GB. A seguir, algumas diretrizes gerais:
As tabelas que mais contribuem com o tamanho do banco de dados são as seguintes:
v Lps_User_Rating: Esta tabela geralmente domina as considerações de espaço. Os usuários geralmente
produzem a média de 50 a 100 avaliações. Os usuários semeadores fornecidos com o Site de Filmes
produzem em média, aproximadamente, 500 avaliações.
v Lps_User_Trx: Esta tabela pode vir a ser muito grande, dependendo do número de atividades de
afinidade de itens, sequência de cliques ou compras registradas a partir dos aplicativos.
v Lps_MBA_Scored: Esta tabela pode vir a ser bastante grande, dependendo do número de produtos
que seu site vende e do número de relações que você deseja configurar para cada produto. Por
exemplo, se você tem 1000 produtos relacionados em sua tabela Lps_Item_Data e deseja armazenar 10
relações para cada produto, uma tabela Lps_MBA_Scored pode vir a ter até 10.000 linhas.
v Lps_User_Mentor: O tamanho desta tabela depende do número de usuários e do números de mentores
associados a cada usuário (50 por padrão).
v Lps_User_Data: Esta tabela pode contribuir em muito no tamanho do banco de dados se você tiver
números grandes de usuários cada um com poucas avaliações. Esta tabela é fortemente indexada, o
que pode afetar o desempenho.
v Lps_Item_Data: Esta tabela é geralmente bastante pequena, mas pode ser significativa se você
armazenar grandes quantias de dados sobre cada item.
As tabelas restantes são geralmente inferiores a 100 KB cada.
A tabela a seguir fornece números de linhas, tamanhos de linhas e tamanhos de índices comuns para um
banco de dados Microsoft SQL Server "comum" com 5000 itens e 100.000 usuários. Os tamanhos das
linhas incluem apenas os campos requeridos pelo LikeMinds e são considerados os campos nulos típicos
e o cabeçalho de índice armazenado em cluster. Os tamanhos variam para outros sistemas de banco de
dados, especialmente para índices.
380
Tabela 117. Exemplos de Tamanhos de Tabelas para um Banco de Dados Comum
Tabela
Linhas em Site
Normal
Tamanho da
Linha (Bytes)
Tamanho Total
Tamanho do
Tamanho Total
Índice (Bytes Por
Linha)
Lps_User_Rating
8.000.000
25
200 MB
cerca de 20
160 MB
Lps_User_Trx
8.000.000
32
256 MB
cerca de 20
160 MB
Lps_User_Mentor 5.000.000
25
125 MB
cerca de 20
100 MB
Lps_User_Data
normal: 100
100-400MB
cerca de 100
10 MB
136 (para campos
obrigatórios
apenas)
68 MB
4
2 MB
Lps_MBA_Scored 10.000
32
32 MB
cerca de 20
1MB
Lps_Genre_Data
10-1000
116
1160 KB-116 MB
N/D
Lps_Item_Genre
5000-20.000
12
60-240MB
N/D
12
30-120MB
100.000
máximo: 400
Lps_Item_Data
5000
Lps_User_Selector 25.000-100.000
4
100-400 MB
Em sua estimativa de tamanho, lembre-se de incluir espaço para as áreas de registro da transação e de
rollback. Como o servidor LikeMinds é consolidado com frequência, a área de rollback não precisa ser
especificamente grande em relação ao banco de dados. Deixe espaço igual ao tamanho do banco de dados
para registros de transações, pois o servidor LikeMinds executa atualizações frequentes.
Desempenho do Banco de Dados:
Visualize algumas diretrizes para otimização de desempenho em seu banco de dados LikeMinds.
O modo como o banco de dados é configurado durante a instalação tem um impacto significativo no
desempenho. Utilize as diretrizes a seguir para obter o desempenho máximo em seu banco de dados do
LikeMinds:
v Configuração do hardware: Teoricamente, você deve ter uma máquina (com duas CPUs), de
preferência a mais rápida dedicada ao banco de dados, e o software do WebSphere Portal em uma
máquina separada. Consulte os requisitos do sistema no WebSphere Portal Information Center para
obter informações adicionais.
v distribuição de carregamento: Você pode instalar os utilitários do LikeMinds em máquinas separadas
para distribuir o carregamento. Consulte o WebSphere Portal Information Center para obter informações
sobre a instalação de utilitários em várias máquinas.
v configuração do sifter: Você pode configurar o sifter para acomodar cargas extensas ou sites
movimentados. Esteja ciente de que o sifter faz uma intensa utilização da memória.
v configuração do accumulador: Do mesmo modo que o sifter, o accumulador faz uma intensa
utilização da memória, por isso, você deve programar para que seja executado em horários fora do
pico.
Planejando Eventos do LikeMinds:
381
Utilize a definição lps.schedule para planejar que eventos sejam lançados em datas e horas específicas.
A sintaxe para usar a configuração lps.schedule é a seguinte:
lps.schedule.<event name> = <schedule><event type><event args>
em que:
event name: Refere-se a um nome exclusivo para o evento.
schedule: Refere-se ao horário do planejamento, em cinco campos separados por espaços ou tabulações, e
são padrões de inteiros. Esses campos são:
Tabela 118. Valores de Horários do Planejamento
Campo
Valores
minuto
0–59
hora
0–23
dia da semana
0-6, com 0 sendo Domingo
dia do mês
1–31
mês do ano
1–12
Para especificar todos os valores de um campo específico (por exemplo, para planejar eventos todos os
dias da semana), utilize um asterisco (*), na ordem relacionada nesta tabela. Exemplo:
Quando você especificar valores reais, você pode digitar o valor (como 1 para planejar um evento na
segunda-feira) ou uma série de valores (por exemplo, 1-2 para planejar eventos para segunda-feira e
terça-feira). Para especificar dias, é preciso incluir o campo dia ou semana e o campo dia do mês. Para
obter exemplos de uso desses valores, consulte
tipo de evento e argumentos do evento: Consulte qualquer um dos seguintes eventos e seus argumentos:
Tabela 119. Tipos e Argumentos de Eventos
Tipo de Evento
Argumento
lazyDBWrite
N/D
Descrição
Determina quando todas as informações alteradas desde a
última leitura são gravadas no banco de dados. A definição
padrão é:
12,24,36,48,00 **** lazyDBWrite
purgeUserCache
timeval
Determina o período, em segundos, após usuários permanentes
não terem sido utilizados, antes de eliminá-los do cache. Se
timeval não estiver especificado, a definição de
db.tune.user_cache_age_time é utilizada.
382
Tabela 119. Tipos e Argumentos de Eventos (continuação)
Tipo de Evento
Argumento
purgeItemCache
timeval
Descrição
Determina o período, em segundos, após itens não terem sido
utilizados, antes de eliminá-los do cache. Se timeval não estiver
especificado, a definição de db.tune.item_cache_age_time é
utilizada.
syncCache
runBuildstats
user
Atualiza todos os objetos de usuários permanentes no cache.
item
Atualiza todos os objetos de itens no cache.
engine
Atualiza todo o cache do mecanismo.
verbose
Executa o utilitário buildstats. Se verbose estiver especificado,
informações adicionais serão impressas no registro de rastreio.
runBuildvisit
verbose
Executa o utilitário buildvisit. Se verbose estiver especificado,
runAccumulator
verbose
Executa o utilitário accumulator. Se verbose estiver especificado,
Configurando os Mecanismos de LikeMinds:
Você pode configurar os mecanismos de recomendação do LikeMinds para controlar aspectos como
possibilidade de prognóstico, número de mentores utilizados, qual conjunto de classificações, de
transações ou de mentores utilizar e assim por diante, para as recomendações retornadas.
Os mecanismos de Preferência e Seqüência de Cliques contam com o utilitário sifter para atribuir
mentores aos usuários. O Mecanismo de Afinidade de Itens faz uso do utilitário accumulator para coletar
os dados de afinidade de itens.
Configurando o Mecanismo de Preferência:
O Mecanismo de Preferência gera recomendações com base nas classificações de itens dos usuários. Você
pode definir as seguintes configurações para o Preference Engine.
Número de Mentores a Utilizar:
Defina <eng_instance_name>.db.engine.tune.num_mentors com o número máximo de mentores a ser
designado a um determinado usuário. O padrão é 50. Por exemplo:
movie_pref.db.engine.tune.num_mentors = 60
Se você não definir esse parâmetro, o Mecanismo de Preferência utilizará o valor definido em
<mentor_set>.max_mentors = <number>.
Mentores a Serem Procurados no Cache:
Se um usuário solicitar recomendações antes do sifter ter localizado mentores para ele, o Mecanismo de
Preferência procurará tais mentores no cache. Defina
<eng_instance_name>.db.engine.tune.max_cached_mentors para o número de possíveis mentores que
devem ser considerados para um determinado usuário. O padrão é 500. Por exemplo:
movie_pref.db.engine.tune.max_cached_mentors = 600
Utilização de "Usuário Médio" para Aprimorar a Confiança da Recomendação:
O Mecanismo de Preferência pode utilizar um "usuário médio" cujas classificações sejam a média das
classificações de todos os usuários. O utilitário buildstats computa as avaliações médias. A configuração
383
de um usuário médio melhora o nível de confiança de recomendações para este usuário. Para isso,
configure eng_instance_name.db.engine.tune.disable.avg_user como false.
No entanto, lembre-se que este recurso pode ser dispendioso nos recursos do sistema. Para desativá-lo,
defina-o para true. (A definição padrão é true.)
Arquétipos:
Para gerar recomendações para itens não classificados por nenhum mentor, o Mecanismo de Preferência
utiliza usuários sintéticos denominados "arquétipos". Esses usuários possuem uma característica específica
muito nítida. Por exemplo, um arquétipo que gosta apenas de filmes de ações pode dar uma classificação
muito alta a todos os filmes de ação. As recomendações dos arquétipos são acrescentadas às
recomendações produzidas pelos mentores.
A configuração do arquétipo inclui:
v “Definindo o Número de Arquétipos no Cache”
v “Ativando ou Desativando o Uso de Arquétipos”
Diretrizes para Dinâmicas de Recomendação Configuráveis:
Você pode utilizar os seguintes parâmetros de configuração para controlar ou pelo menos equilibrar
efeitos de fatores externos.
v O número de mentores a serem utilizados nas recomendações, utilizando os seguintes parâmetros de
configuração:
– <mentor_set_name>.min_mentor_ratings
– <mentor_set_name>.max_mentor_ratings
– <mentor_set_name>.min_mentor_transactions
– <mentor_set_name>.max_mentor_transactions
v Equilibrando o processo de seleção de mentores com os seguintes parâmetros de configuração:
– <mentor_set_name>.mentor.pool.size
– <mentor_set_name>.max_mentors
Definindo o Número de Arquétipos no Cache:
A lista de arquétipos é mantida no cache por um número especificado de usos antes de ser recarregada.
Para alterar o número de usuários, defina <eng_instance_name>.db.engine.tune.max_archetype_list_use
. O padrão é 100000.
Exemplo:
movie_pref.db.engine.tune.max_archetype_list_use = 150000
Ativando ou Desativando o Uso de Arquétipos:
Para ativar ou desativar o uso de arquétipos, configure
<eng_instance_name>.db.engine.tune.consult.archetype_for_list como true ou false. O padrão é
false. Exemplo:
movie_pref.db.engine.tune.consult.archetype_for_list = true
Possibilidade de Prognóstico do Usuário:
Esta seção contém as seguintes informações relacionadas à possibilidade de prognóstico do usuário:
Número Máximo de Mentores Designados a Cada Usuário:
Utilize a definição a seguir para especificar o número de mentores a ser atribuído a cada usuário. O
número de mentores em si pode ser inferior à definição máxima mas nunca superior ao valor
especificado. Exemplo:
<mentor_set_name>.max_mentors = 50
384
Nota: Utilize um valor entre 50-100. Consulte “Máximo de Classificações de que um Usuário Precisa
Antes de se Tornar um Mentor” para obter orientação para configurar <mentor_set_name>.max_mentors
Máximo de Classificações de que um Usuário Precisa Antes de se Tornar um Mentor:
A definição a seguir especifica o número máximo de classificações que um usuário pode ter para
tornar-se um mentor. O sifter utilizará essa definição se o Mecanismo de Preferência estiver utilizando
esse conjunto de mentores. O valor pode ser especificado como um dos seguintes:
v Uma porcentagem do número total de itens no banco de dados. Exemplo:
<mentor_set_name>.max_mentor_ratings = 75%
v O número máximo de classificações (ou seja, sem uma porcentagem). Exemplo:
<mentor_set_name>.max_mentor_ratings = 18
Utilize as seguintes diretrizes para definir <mentor_set_name>.max_mentor_ratings:
Tabela 120. Diretrizes para Definir o Máximo de Classificações
Número Total de Itens no Banco de Dados
Definição Sugerida
< 1000
<= 100
1000–5000
<= 500
5000–10.000
<= 1500
10.000+
<= 1500
Nota: Para obter informações adicionais sobre como o sifter utiliza o
<mentor_set_name>.max_mentor_ratings, consulte “Número Máximo de Mentores Designados a Cada
Usuário” na página 384.
Máximo de Transações de que um Usuário Precisa Antes de se Tornar um Mentor:
A definição a seguir especifica o número máximo de transações que um usuário pode ter para tornar-se
um mentor. O sifter utilizará essa definição se o Mecanismo de Compra ou de Seqüência de Cliques
estiver utilizando esse conjunto de mentores. O valor pode ser especificado como um dos seguintes:
v Uma porcentagem do número total de itens no banco de dados. Exemplo:
<mentor_set_name>.max_mentor_xactions = 75%
v O número máximo de transações (ou seja, sem uma porcentagem). Exemplo:
<mentor_set_name>.max_mentor_xactions = 18
Utilize as seguintes diretrizes para definir <mentor_set_name>.max_mentor_transactions
Tabela 121. Diretrizes para Definir o Máximo de Transações
Número Total de Itens no Banco de Dados
Definição Sugerida
< 1000
<= 100
1000–5000
<=500
5000–10.000
<= 1500
10.000+
<= 1500
Nota: Para obter informações adicionais sobre como o sifter utiliza o
<mentor_set_name>.max_mentor_xactions, consulte “Diretrizes para Dinâmicas de Recomendação
Configuráveis” na página 384.
Número Mínimo de Avaliações para Recomendações do Usuário:
385
Defina <eng_instance_name>.engine.titan.predictable.min_ratings_cutoff o número mínimo de
classificações que um usuário deve fazer antes que o Mecanismo de Preferência faça recomendações a ele.
O padrão é 2. Por exemplo:
movie_pref.engine.titan.predictable.min_ratings_cutoff = 3
Recalculando Previsões do Mecanismo de Preferência:
O parâmetro de configuração <eng_instance_name>.engine.titan.recomputation_bound especifica a
alteração de porcentagem permitida nas classificações de um usuário antes do servidor LikeMinds
recalcular as previsões do usuário. Por exemplo:
music_pref.engine.titan.recomputation_bound = 10.0
Geralmente, o servidor LikeMinds gera previsões com base nos mentores de um usuário, que o sifter
calcula e disponibiliza para o banco de dados. Quando um usuário não possui nenhum mentor, talvez
porque tenha acabado de chegar ao site ou quando as classificações ou transações do usuário foram
alteradas além da porcentagem aqui especificada, o servidor LikeMinds seleciona mentores de um
conjunto reduzido de candidatos e recalcula as previsões do usuário.
Tenha cuidado ao utilizar esta definição, já que a seleção de mentores é uma operação relativamente
dispendiosa: uma definição de baixa porcentagem pode levar a uma carga excessiva da CPU com pouco
ou nenhum ganho na qualidade do prognóstico. Uma definição mais alta irá melhorar o desempenho,
mas os prognósticos podem ser menos precisos.
Recomendações do Mecanismo de Preferência Padrão:
O Mecanismo de Preferência lê o valor do campo de score na tabela Lps_Item_Data para determinar
quais itens são populares. Portanto, uma pontuação melhor significa que o item é mais popular. Quando
o buildstats é executado, ele atualiza o campo de pontuação com a classificação média para aquele item;
ele gera este valor com base no conjunto de avaliações definido no parâmetro db.applic.rating.source.
Para obter recomendações padrões seguras, execute o utilitário buildstats regularmente. Por padrão, o
instalador ajusta o buildstats para ser executado uma vez por dia. Alguns aplicativos utilizam suas
próprias lógicas de negócios para atribuir a pontuação aos itens. Se quiser substituir o valor do campo de
pontuação para utilizar em seu lugar a pontuação do seu aplicativo, execute buildstats utilizando o
argumento -noscore.
Configurando Utilitários de LikeMinds: Você pode configurar as seguintes definições para os utilitários de
plano de fundobuildstats e buildvisit:
v Parâmetros de Classificação
v Itens repetidos na lista de visitas
Você pode usar o utilitário buildstats para todos os mecanismos de Recomendação, exceto para o
Mecanismo de Afinidade de Itens. O utilitário buildvisit é utilizado apenas pelo o Mecanismo de
Preferência.
Configurando o Sifter para Seleção de Mentores:
O sifter encontra mentores para usuários, utilizando as informações dos dados de classificações ou
transações para os mecanismos do servidor LikeMinds. O sifter é utilizado por todos os mecanismos do
servidor LikeMinds, exceto pelo Mecanismo de Afinidade de Itens, que utiliza o utilitário accumulator
Figura 33 na página 387 ilustra como o sifter funciona:
386
Figura 33. Funcionamento do Sifter
Configuração do Conjunto de Mentores Específicos do Sifter:
Você pode especificar as seguintes categorias dos parâmetros de configuração específicos do sifter para
os conjuntos de mentores:
v O mecanismo a ser utilizado para a reconstrução de tabelas de mentores
v Intervalo de tempo de verificação da prioridade de examinação
v
v
v
v
v
v
Número de usuários de prioridade da examinação por batch
Número máximo de mentores atribuídos a cada usuário
Mínimo de avaliações que um usuário deve ter para tornar-se um mentor
Máximo de avaliações que um usuário deve ter para tornar-se um mentor
Mínimo de transações que um usuário deve ter para tornar-se um mentor
Máximo de transações que um usuário deve ter para tornar-se um mentor
v Como definir o tamanho do conjunto de mentores
v O período de inatividade do sifter quando o campo sift_pri da tabela Lps_User_Data é 0
v
v
v
v
Executando vários sifters
Número de encadeamentos para examinar usuários
Recalculando (reconstruindo) o conjunto de mentores
Pausando o sifter durante acesso pesado ao banco de dados
Nota: Para obter informações adicionais sobre o sifter, consulte “Configurando o Sifter para Seleção de
Mentores” na página 386.
Como Funciona o Processo de Seleção de Mentores:
Para compreender plenamente o sifter, é importante ter uma idéia clara sobre como o processo de
seleção de mentores funciona e sobre como definir os parâmetros de configuração que aumentam a
exatidão da sua recomendação. É preciso compreender os seguintes termos antes de continuar:
v Filtragem Colaborativa -- Filtragem Colaborativa (CF) é uma tecnologia que calcula a semelhança entre
os usuários. Ela utiliza as condutas dos usuários que mais se parecem com algum usuário específico,
como base funcional para realização de prognósticos e recomendações para esse usuário. Apresentada
esta definição, o processo através do qual "...a população inteira de usuários é analisada, a competência
387
dos mesmos como mentores é calculada e eles são designados como mentores a usuários individuais..."
é decisivamente importante para as recomendações definitivas que surgem da abordagem da filtragem
colaboradora. Todos os mecanismos do servidor LikeMinds, exceto o Mecanismo de Afinidade de Itens,
utilizam a filtragem colaborativa.
Os dados utilizados para determinar os níveis de similaridade podem vir em uma variedade de
formatos. De um fluxo de avaliações auto-fornecidas realizadas explicitamente para receber
recomendações, a eventos de seqüência de cliques que compõem a seqüência, duração e resultado de
uma sessão de um usuário da Web, a dados de bancos de dados do legado de uma empresa (como
eventos de transações, demográficos ou de crédito)-- todos podem formar a base necessária para
realização de cálculos de similaridade. A partir dessas mensurações de similaridade, esses dados
podem resultar nas recomendações mensuradas dos usuários considerados mais semelhantes a algum
usuário específico.
v Mentor -- Um usuário com a mesma opinião utilizado como base para recomendações para novos
usuários. A cada usuário são atribuídos mentores pelo programa sifter, cujas preferências
armazenadas são julgadas como atraentes para o novo usuário.
v Conjunto de Mentores -- Embora o objetivo dos mentores seja formar a base para recomendações dos
usuários considerados mais semelhantes a eles, em sua forma mais básica, ele deve refletir uma
amostra representativa de usuários no conjunto de transações para o qual as recomendações são
necessárias. E apesar da ênfase obviamente exigida na similaridade, nenhum processo de
recomendação pode fazer sugestões lúcidas sem um espaço concomitante de dessemelhança. Podemos
basear nossas recomendações finais nas propensões compartilhadas similares descobertas em nossas
análises dos usuários sendo considerados para entrada no conjunto de mentores, mas é
verdadeiramente a confluência de similaridade em compras, com alguma diferença nos itens
comprados, que torna possível as recomendações baseadas na filtragem colaborativa do servidor
LikeMinds.
v Sifter -- Cria mentores analisando dados transacionais de usuários armazenados. O sifter é executado
em segundo plano quando você executa o servidor LikeMinds.
v Cobertura -- O volume ou o número de itens classificados ou de transações executadas.
Seleção e Atribuição de Mentores:
Diversos fatores determinam a adequação de algum usuário como mentor. A similaridade com algum
outro usuário é o fator decisivo final da adequação de qualquer mentor para fazer recomendações a um
usuário específico. Contudo, é a extensão (o volume do número de itens avaliados ou transações
realizadas) que é mais importante para a formação do conjunto de mentores. (O conjunto de mentores é
um superconjunto dos mentores finais escolhidos para fazer as recomendações.) Embora se possa
considerar usar a extensão do espaço de compra não compartilhado como outra dimensão de
dessemelhança, o espaço compartilhado é onde encontramos a maioria dos dados (e os dados mais
prognosticadores) para fazer as distinções de similaridade exigidas dentro da população de usuários.
Resumidamente, mesmo sendo importante a similaridade com o usuário, é a capacidade de um mentor
contribuir com itens, fora do espaço comum de compras de um usuário, no conjunto final de possíveis
recomendações, que qualifica o usuário como um possível mentor.
Com esse objetivo, a primeira etapa que o sifter utiliza na atribuição de mentores é criar periodicamente
um novo grupo de mentores (consulte lps_rtg_poole lps_trx_pool), uma tentativa para coletar uma
amostra representativa de usuários experientes que serão considerados mentores em potencial para
qualquer usuário que solicitar recomendações.
A segunda etapa no processo de seleção de mentores é designar mentores, do conjunto de mentores, para
serem mentores para usuários específicos. O desafio é criar um equilíbrio justo entre a similaridade e a
extensão de usuários sendo considerados como mentores. Você pode configurar o sifter para enfatizar
semelhanças, abrangências ou para determinar automaticamente qual dinâmica enfatizar a cada usuário
no final da atribuição de mentores a usuários.
Número de Usuários de Prioridade de Análise por Batch:
388
Para especificar quantos usuários examinar durante um único batch, por exemplo:
<mentor_set_name>.pri_list_size = 10
Pausando o Sifter Durante Uso Intenso do Banco de Dados:
Você pode pausar o sifter durante horas de acessos intensos ao banco de dados. Isto libera recursos do
banco de dados para outras atividades durante atividade intensa do banco de dados. Por exemplo, para
tornar o sifter inativo às 11:00:
<mentor_set_name>.pause_sifting_at= 0 11 * * *
Se definir <mentor_set_name>.pause_sifting_at, utilize a seguinte definição para despertar o sifter mais
tarde. Por exemplo, para ativar o sifter às 16:00:
<mentor_set_name>.resume_sifting_at= 0 16 * * *
Considerações sobre o Desempenho do Separador:
O sifter estabelece processamentos de alta demanda no sistema em qual executa. Por essa razão, é
importante ajustá-lo levando em consideração a sua utilização e o ambiente. Utilize as seguintes diretrizes
simples ao ajustar o separador:
v Planeje o separador para construir os conjuntos do mentor durante horas do dia em que há um baixo
volume de tráfego, por exemplo, às 3h00.
v Ajuste o número de encadeamentos de processamento utilizados pelo processo. Você pode configurar
essa definição para cada conjunto de mentores.
Para otimizar a utilização de recursos do separador, configure o número de encadeamentos para se
expandir para o dobro do número de CPUs na máquina em que o acumulador está sendo executado. O
valor de configuração do Mecanismo de Recomendação do LikeMinds que controla isto é
item_affinity_set.item_affinity.num_threads.
v Distribua o separador em um servidor separado do LikeMinds Recommendation Engine.
v Execute vários processos do separador distribuídos entre várias máquinas para maior escalabilidade.
Recalculando (reconstruindo) o conjunto de mentores:
Para obter melhores recomendações, é preciso recalcular ou reconstruir o conjunto de mentores, pelo
menos, uma vez por dia, idealmente, no horário em que o banco de dados é pouco utilizado. Isto permite
que novos usuários tornem-se mentores e remove mentores atuais que não são mais bons mentores. Se
você estiver executando várias instâncias do sifter, utilize o seguinte procedimento para recalcular o
conjunto de mentores:
1. Desative todas as instâncias do sifter exceto uma, que você irá utilizar como a instância mestre do
sifter. A reconstrução do conjunto de mentores utiliza uma grande quantidade de recursos do banco
de dados, portanto, seria melhor utilizar apenas um sifter para reconstruir o conjunto de mentores.
Para que a instância do sifter seja utilizada como mestre, digite o seguinte:
<mentor_set_name>.disable_build_mentor_pool = false
Para que cada instância do sifter seja desativada, digite o seguinte:
<mentor_set_name>.disable_build_mentor_pool = true
2. Reconstrua o conjunto de mentores na instância mestre do sifter especificando um horário para
ocorrência do recálculo.
Como a reconstrução do conjunto de mentores requer acesso intenso ao banco de dados, programe-o
para um horário em que o banco de dados é pouco utilizado. Por exemplo, a definição a seguir é para
as 2:00:
<mentor_set_name>.build_mentor_pool_at = 0 2 * * *
As horas são interpretados assim:
389
3. Para cada instância do sifter desativada, defina uma hora para recarregar o conjunto de mentores
após ter sido reconstruído.
O sifter irá destruir o conjunto de mentores atual e recarregar o conjunto da tabela de conjuntos de
mentores especificada na definição <mentor_set_name>.mentor_pool.table. Normalmente, você deve
defini-lo para aproximadamente um hora depois que a instância do sifter foi recarregada.
Por exemplo, para recarregar o conjunto de mentores às 3:00:
<mentor_set_name>.reload_mentor_pool_at= 0 3 * * *
Executando Vários Sifters:
Utilize as definições a seguir para executar várias instâncias do sifter e para que todos os sifters
compartilhem alguns parâmetros de configuração e substituam outros. A execução de múltiplas sifters
simultaneamente permite distribuir carga em sistemas bem grandes.
Para substituir um determinado parâmetro padrão, adicione um prefixo ao parâmetro. Por exemplo, para
recarregar o conjunto de mentores para a instância MovieSift do sifter às 4:00:
MovieSift.<mentor_set_name>.reload_mentor_pool_at = 0 4 * * *
Se você executar um sifter com a seguinte definição,
sifter -config MovieSift -conf <lps config file>
that sifter will use theMovieSift.<mentor_set_name>.
setting.
reload_mentor_pool_at = 0 3 * * *
Impedindo que Vários Sifters Examinem o Mesmo Usuário:
Ao executar vários sifters simultaneamente para distribuir carga, utilize a seguinte definição para
impedir que os vários sifters examinem o mesmo usuário na tabela Lps_User_Data. Esta definição
limita o sifter a examinar apenas um determinado grupo de usuários ou elimina um grupo de usuários
da examinação. Por exemplo, para permitir que o sifter examine somente usuários cujos IDs sejam
maiores que 100000 e ignore aqueles que são menores:
<mentor_set_name>.constraint = user_id > 100000
Você pode especificar qualquer campo na tabela Lps_User_Data para esse parâmetro. Por exemplo,
supondo que há uma coluna de idade na tabela Lps_User_Data, você poderia utilizar a seguinte definição
para limitar o sifter a observar todos os usuários cujos IDs são superiores a 10000 e que têm mais de 25
anos de idade:
<mentor_set_name>.constraint = user_id > 100000 and age > 25
Número de encadeamentos para examinar usuários:
Para definir o número de encadeamentos a serem usados para examinar usuários no lpsconfig:
<mentor_set_name>.num_sift_threads = 3
Período de Inatividade do Sifter Quando o Campo Lps_User_Data sift_pri É 0:
390
Os valores do campo Lps_User_Data sift_pri devem ser maiores que 0 para que o sifter obtenha dados
úteis (ou seja, mentores atualizados) para os usuários. Se definida para true, a definição a seguir fará
com que o sifter fique inativo pelo número de segundos especificados por
<mentor_set_name>.pri_check_interval se os valores do campo sift_pri na tabela Lps_User_Data forem 0.
Se você definir o parâmetro para false, o sifter examinará os usuários aleatórios quando não houver
usuários com sift_pri maior que 0.
<mentor_set_name>.sleep_on_no_sift_pri = true
Nota: Para obter informações sobre <mentor_set_name>.pri_check_interval, consulte “Intervalo de
Tempo para Verificação de Prioridade de Análise”.
Intervalo de Tempo para Verificação de Prioridade de Análise:
Para especificar o intervalo, em segundos, para o sifter verificar o valor da prioridade de examinação de
um usuário, utilize a seguinte definição. O padrão é 20 segundos.
<mentor_set_name>.pri_check_interval = 40
Nota: Adicionalmente, você pode utilizar essa definição quando está especificando o tempo de
inatividade do sifter durante períodos movimentados de acesso ao banco de dados. Consulte a seção
“Considerações sobre o Desempenho do Separador” na página 389.
Parâmetros de Classificação: O utilitário de plano de fundo buildvisit calcula um valor de Parâmetros de
classificação para cada item no banco de dados. Ele é utilizado apenas pelo o Mecanismo de Preferência.
O servidor LikeMinds apresenta itens para classificação em ordem decrescente de capacidade para
classificação; itens com a mesma capacidade para classificação são apresentados em ordem aleatória.
O valor de classificação é calculado como
ratability = Ai+Bi+Ci
em que Ai é a popularidade do item i:
Ai=Kx(log10(num_rating))rpow
num_rating é o número de avaliações para o item.
Para especificar K, defina db.ratability.num_rating.coefficient (o padrão é 1.0):
db.ratability.num_rating.coefficient = 1.0
Para especificar rpow, o poder de classificação, defina db.ratability.num_rating.power (o padrão é 1.0):
db.ratability.num_rating.power= 1.0
Bi é uma medição de quão controverso o item é:
Bi=Kx(rating_std_dev)sdpow
rating_std_dev é o desvio padrão das classificações para o item.
Para especificar K, defina db.ratability.stddev.coefficient (o padrão é 1.0):
db.ratability.stddev.coefficient = 1.0
Para especificar stdpow, o poder de desvio padrão, defina db.ratability.stddev.power (o padrão é 1.0):
db.ratability.stddev.power= 1.0
Cié uma importância com base no tempo de existência do item:
Ci=Kxexp(-(current_year - release_year)) exp ^ apow
391
release_year é o valor do campo ano na tabela Lps_Item_Data para o item.
Para especificar K, defina db.ratability.age.coefficient. Você pode definir isto como zero se não
quiser considerar a tempo de existência na determinação da capacidade de classificação (o padrão é 2.7):
db.ratability.age.coefficient = 2.7
Para especificar
apow
, defina db.ratability.age.power (o padrão é 0.5):
db.ratability.age.power= 0.5
Itens Repetidos na Lista de Visitas: Para especificar se o utilitário buildvisit deve repetir um item na lista
de visitas a ser mostrada para um usuário, defina db.visitlist.ratability.duplication_threshold.
Itens com valores de classificação superiores a este limite podem ser repetidos.
Exemplo:
db.visitlist.ratability.duplication_threshold = 6
Configurando o Mecanismo de Sequência de Cliques:
O Mecanismo de Sequência de Cliques gera recomendações com base em um registro do comportamento
de compras do usuário conforme ele navega por um website, isto é, um histórico de "cliques" do usuário
durante a visita no website. Ele usa dados, como os itens que os usuários visualizam, clicam e incluem
em seus carrinhos de compras.
É possível usar a configuração “Previsibilidade do Usuário para o Mecanismo de Sequência de Cliques”
para especificar o comportamento de recomendação do Mecanismo de Sequência de Cliques.
Previsibilidade do Usuário para o Mecanismo de Sequência de Cliques:
Esta seção contém as seguintes informações relacionadas à possibilidade de prognóstico do usuário:
v O número mínimo de atividades de seqüência de cliques exigido para um usuário antes que ele possa
receber recomendações
v O número de mentores que o Mecanismo de Seqüência de Cliques examinará antes de verificar se o
usuário pode receber prognósticos.
v A alteração de porcentagem permitida em transações de um usuário antes que o servidor LikeMinds
recalcule as previsões do usuário.
v As recomendações padrão.
Número Mínimo de Atividades de Fluxo de Cliques para um usuário:
Defina <eng_instance_name>.engine.saturn.tune.predictable.min_xactions_cutoff o número mínimo
de transações que um usuário deve fazer antes que o Mecanismo de Seqüência de Cliques faça
recomendações para ele. O padrão é 10.
Por exemplo:
movie_click.engine.saturn.tune.predictable.min_xactions_cutoff = 2
Mínimo de Mentores que o Mecanismo Examina Quanto à Possibilidade de Prognóstico: Depois de determinar
se pode fazer recomendações para um determinado usuário, o Mecanismo de Sequência de Cliques deve
examinar os mentores do usuário. <eng_instance_name>.engine.titan.predictable.loop_check_cutoff
especifica o número de mentores examinados pelo Mecanismo de Seqüência de Cliques antes de verificar
se o usuário é previsível. O padrão é 10.
Por exemplo:
movie_pref.engine.titan.predictable.loop_check_cutoff = 12
392
Se o usuário não for previsível, o mecanismo examinará outro grupo de mentores
<eng_instance_name>.engine.titan.predictable.loop_check_cutoff e, em seguida, verificará se o
usuário é previsível. Ele continuará até descobrir que o usuário pode receber prognóstico ou até acabarem
os mentores.
Recalculando Previsões do Mecanismo de Fluxo de Cliques:
O parâmetro de configuração <eng_instance_name>.engine.saturn.recomputation_bound especifica a
alteração de porcentagem permitida em transações de um usuário antes do servidor LikeMinds recalcular
as previsões do usuário. Por exemplo:
music_click.engine.saturn.recomputation_bound = 10.0
Geralmente, o servidor LikeMinds gera previsões com base nos mentores de um usuário, que o sifter
calcula e disponibiliza para o banco de dados. Quando um usuário não possui nenhum mentor, talvez
porque tenha acabado de chegar ao site, ou quando as classificações ou transações do usuário foram
alteradas além da porcentagem aqui especificada, o servidor LikeMinds seleciona mentores de um
conjunto reduzido de candidatos e recalcula as previsões do usuário.
Tenha cuidado ao utilizar esta definição, já que a seleção de mentores é uma operação relativamente
dispendiosa: uma definição de baixa porcentagem pode levar a uma carga excessiva da CPU com pouco
ou nenhum ganho na qualidade do prognóstico. Uma definição mais alta irá melhorar o desempenho,
mas os prognósticos podem ser menos precisos.
Recomendações do Mecanismo de Fluxo de Cliques Padrão:
O Mecanismo de Seqüência de Cliques utiliza os dados de transações armazenados com um usuário
especial para gerar os prognósticos padrão. O utilitário buildstats gera dados de transações da seqüência
de cliques, com base no conjunto de transações designado no parâmetro db.applic.transaction.source.
Esses dados de transações são um resumo de todos os dados de transações de seqüência de cliques de
usuários, baseados em dados de transações de todos os conjuntos de transações configurados. buildstats,
o servidor LikeMinds e outros utilitários identificam o usuário especial como um usuário cujo campo
Lps_User_Data mentor_type está definido como "z". Deve haver exatamente um usuário com esta
definição, não mais que isso. buildstats gera automaticamente este usuário se IDs customizados não
estiverem configurados; do contrário, é preciso criar o usuário manualmente, já que o buildstats não
pode saber quais restrições se aplicam aos IDs customizados.
Execute o utilitário buildstats regularmente. Por padrão, o instalador ajusta o buildstats para ser
executado uma vez por dia. Alguns aplicativos utilizam suas próprias lógicas de negócios para atribuir a
pontuação aos itens. Se quiser substituir o valor do campo de pontuação para utilizar em seu lugar a
pontuação do seu aplicativo, execute buildstats utilizando o argumento -noscore.
Configurando o Mecanismo de Afinidade de Itens:
Para cada transação de venda cruzada no histórico de compras do usuário, o Mecanismo de Afinidade de
Itens extrai seus cálculos a partir das seguintes estatísticas:
v Suporte: Este é o número de vezes que um par de itens está envolvido no conjunto de afinidades de
itens definido por você, dividido pelo número total de eventos de afinidades de itens em pares. Os
eventos de afinidades de itens podem ser visualizações de página, compras, inclusões ou eliminações
no carrinho de compras decisivos ou combinações desses eventos. Em outras palavras, o suporte é a
porcentagem da vez em que o par de itens ocorreu conjuntamente, em relação a todas as transações.
v Prognóstico: Utilizando a estatística do suporte como base, o prognóstico é o número de vezes que um
par de item-a-item ocorre conjuntamente, divido pelo suporte singular do primeiro item desse par de
itens. Em outras palavras, o prognóstico é a probabilidade do par de itens, conhecido o primeiro item
do par.
v Confiança: Utilizando a estatística doprognóstico como base, a confiança é o prognóstico dividido pelo
suporte singular do segundo item do par para o qual o prognóstico é calculado. Ou seja, a confiança é
a probabilidade do par de itens conhecendo-se o primeiro e o segundo item no par de itens.
393
Em termos gerais, você utiliza o Mecanismo de Afinidade de Itens como segue:
1. Defina os requisitos de análise do carrinho de compras.
Isto refere-se ao escopo e aos filtros para prognósticos que você pretende usar para a análise do
carrinho de compras. Essa definição é bastante flexível. Por exemplo, o carrinho de compras pode
basear-se no histórico inteiro de compras do usuário, em vendas de produtos sazonais, na atual sessão
do usuário, em visualizações de página do usuário cruciais para a compra de um item e assim por
diante.
O tipo de compras que você espera de seus usuários irá determinar o tipo de cesta de compras que
você define. Por exemplo, um carrinho de compras baseado em sessão seria adequado para o site de
uma mercearia, onde os usuários tendem a comprar uma variedade de itens de uma vez. Um carrinho
de compras vitalício é adequado para um site onde os usuários tendem a comprar, ocasionalmente,
um item grande, como um equipamento eletrônico caro.
2. Configure um conjunto de afinidades de itens para a análise do carrinho de compras.
O conjunto de afinidades de itens define os requisitos de análise do carrinho de compras. Semelhante
aos conjuntos de mentores ou conjuntos de transações, o conjunto de afinidade de itens define o tipo
de dados que você deseja coletar. O conjunto de afinidades de itens inicia por coletar as transações de
uma tabela de entrada de transações semelhante à Lps_User_Trx. Você pode incluir filtros para
campos de consulta na tabela de entrada, especificar os tipos de transações de consulta, o número de
itens altamente associados que serão considerados, etc, para a definição de carrinho de compras. Por
fim, especifique uma tabela de saída na qual os resultados da análise serão gravados. A tabela de
saída deve ter os mesmos campos e tipos de dados que a tabela Lps_MBA_Scored.
3. Execute o utilitário accumulator para coletar os dados do conjunto de afinidades de itens e coloque-os
na tabela de saída especificada no conjunto de afinidades de itens.
Semelhante ao sifter, que é utilizado para os outros mecanismos do servidor LikeMinds, o
accumulator utiliza os dados do conjunto de afinidade de itens para fazer cálculos de suporte,
previsão e confiança (descritos anteriormente). Ela grava suas descobertas na tabela de saída
especificada no conjunto de afinidades de itens.
O accumulator deve ser configurado para operar em horários de baixa utilização do banco de dados,
já que ele pode fazer uso intenso dos recursos do sistema.
Especificando o Comportamento da Recomendação:
Você pode configurar vários parâmetros que afetam o modo como o servidor LikeMinds gera
recomendações.
Você pode definir o seguinte procedimento de recomendação:
v Valores de Classificação Admissíveis
v Níveis de Confiança Admissíveis
v Qualidade do prognóstico
v Melhores apostas
Os parâmetros nesta seção afetam a forma que o servidor LikeMinds gera recomendações. Se você
alterá-los, verifique se os resultados ainda continuam apropriados para seu aplicativo. Como o aplicativo
Site de Filmes espera que estes parâmetros sejam definidos com seus valores padrões, os desenvolvedores
do aplicativo Site de Filmes devem ter muito cuidado ao modificá-los.
Os parâmetros que aplicam-se aos aplicativos no plano de fundo também podem afetar a forma como as
recomendações são geradas. Consulte o “Configurando o Sifter para Seleção de Mentores” na página 386.
Valores de Classificação Admissíveis:
Aprenda sobre os parâmetros que controlam o intervalo de classificações permitido.
394
Especifique a série admissível de classificações definindo db.applic.param. lowestrating (o padrão é 0)
com a classificação mais baixa admissível e db.applic.param.numberratingvalues(o padrão é 13) com o
número de classificações possíveis. Esta definição também determina o valor de recomendação. Este
exemplo especifica uma escala de classificação de zero a doze:
db.applic.param.lowestrating = 0
db.applic.param.numberratingvalues = 13
Os parâmetros db.applic.param.wontrate (o padrão é -1) e db.applic.param.unrated (o padrão é -2)
definem valores de classificação admissíveis especiais que não fazem pare da escala de classificação
normal. A definição de um item como não-classificado marca a classificação para exclusão. wontrate
significa que o usuário indicou, especificamente, que não pretende classificar o item.
db.applic.param.wontrate = -3
db.applic.param.unrated = -2
O servidor LikeMinds ignora classificações que não estão no intervalo especificado de valores de
classificação nem são iguais a db.applic.param.wontrate ou db.applic.param.unrated.
Nota: Você pode utilizar esses parâmetros para todos os mecanismos de Recomendação, exceto para o
Mecanismo de Afinidade de Itens.
Níveis de Confiança Admissíveis:
O servidor LikeMinds designa um nível de confiança a cada recomendação com base em quantos
usuários avaliaram o item recomendado e na semelhança das classificações entre si. "Confiança" refere-se
à precisão do prognóstico. Aprenda como configurar níveis de confiança permitidos.
Você pode especificar a série de valores de confiança definindodb.applic.param.lowestconfidence (o
padrão é 1) com o nível de confiança mais baixo e db.applic.param.numberconfidenceLevels (o padrão é
4) com o número de níveis de confiança. Você pode definir níveis de confiança para todos os mecanismos
de Recomendação.
db.applic.param.lowestconfidence = 1
db.applic.param.numberconfidencelevels = 4
Valores de Qualidade de Prognóstico:
O valor "qualidade" refere-se ao grau de apreciação do usuário em relação a um item. O servidor
LikeMinds apresenta previsões em ordem de qualidade decrescente.
A qualidade de recomendação é calculada utilizando esta equação:
quality = confidencempowx (pred rating —mean pred rating) + K x confidencepow
sendo que:
v confidence é o valor de confiança para o item recomendado.
v pred rating é a classificação prognosticada para o item.
v mean pred rating é a classificação média recomendada ao usuário para todos os itens.
Para especificar
mpow
, definadb.applic.param.BestBets.MultPower:
db.applic.param.BestBets.MultPower = 0.5
Para especificar K, defina db.applic.param.BestBests.Coefficient:
db.applic.param.BestBets.Coefficient = 0
Para especificar pow, defina db.applic.param.BestBets.Power:
db.applic.param.BestBets.Power = 1.0
395
Nota: Você pode utilizar esses parâmetros para todos os mecanismos de Recomendação, exceto para o
Mecanismo de Afinidade de Itens.
Valores Melhores Apostas:
O servidor LikeMinds gera vetores de recomendação que incluem todas as recomendações a um
determinado usuário, na ordem da melhor qualidade para a pior. Você pode configurar o número de
itens a ser retornado como Melhores Apostas e a porcentagem máxima do vetor de recomendação para
incluir na lista Melhores Apostas.
O servidor LikeMinds produz Melhores Apostas começando com o item de mais qualidade no vetor de
recomendação e listando itens na ordem decrescente de qualidade de classificação.
Para especificar quantos itens o servidor LikeMinds deve retornar como Melhores Apostas, defina
db.applic.param.BestBets.Threshold. O valor-padrão deste parâmetro é o número de níveis de
classificação (especificado pelo parâmetro db.applic.param.NumberRatingValues) dividido por 2. Por
exemplo, se db.applic.param.NumberRatingValues estiver definido com 12, o padrão seria 6. Você pode
especificar um valor diferente, por exemplo:
db.applic.param.BestBets.Threshold = 7
Defina db.applic.param.BestBets.list.cutoff com a porcentagem máxima do vetor total de
recomendação para incluir na lista Melhores Apostas. Exemplo:
db.applic.param.BestBets.list.cutoff = 50
Amostra de MovieSite
A documentação do MovieSite enfoca seis aspectos dos recursos do LikeMinds:
Melhores Apostas
A tarefa Melhores Apostas fornece uma lista de filmes recomendados para cada usuário. Essas
recomendações são calculadas com base em uma classificação anterior do usuário, bem como em
classificações de outros usuários semelhantes, utilizando a filtragem de colaboração. O sistema
determina semelhanças dos usuários, comparando o histórico de classificações entre todos os
usuários. Por exemplo, se o usuário A e o usuário B tiverem muitas classificações semelhantes,
mas o usuário B classificou muito mais filmes diferentes; o usuário B pode ser um grande mentor
para o usuário A. É a partir do conjunto de mentores (usuário B e outros usuários semelhantes)
que o LikeMinds faz recomendações; nesse caso, uma recomendação de filme para o usuário A.
Obter Itens para Classificação
A tarefa Obter Filmes para Classificação recupera filmes, que o usuário ainda não classificou, a
partir do banco de dados. Esses filmes são selecionados com base no impacto que a classificação
do usuário teria na capacidade do LikeMinds em recomendar filmes (Melhores Apostas).
(Consulte o exemplo da tarefa.)
Visualizar as Classificações Anteriores do Usuário
Essa tarefa recupera as classificações que um usuário inseriu anteriormente a partir do banco de
dados do LikeMinds. Um item que foi classificado anteriormente sempre pode receber uma
classificação diferente. (Consulte o exemplo da tarefa.)
Registrar Classificações do Item
O bean de classificação do Personalização registra cada classificação do usuário no banco de
dados do LikeMinds. Há poucos requisitos a serem lembrados ao utilizar o bean de classificação:
v O atributo de sessão "pzn.userName" deve ser definido com o ID de recurso do usuário. É
dessa modo que o LikeMinds emparelha o usuário com uma classificação de item.
v Se você registrar um item que não existia anteriormente na tabela do banco de dados do
LikeMinds, uma entrada será automaticamente criada para esse item.
396
v Da mesma forma, se um item estiver registrado para um usuário inexistente na tabela do banco
de dados do LikeMinds, o LikeMinds criará uma entrada para esse usuário. É dessa modo que
um "novo usuário" deve ser inserido no sistema do LikeMinds.
v A coleta de recursos que é enviada como um parâmetro ao bean de classificação faz distinção
entre maiúsculas e minúsculas.
Acesso ao Banco de Dados
Os desenvolvedores são responsáveis pela manutenção das tabelas em seus bancos de dados. No
caso do MovieSite, isso inclui a tabela de usuários do MovieSite, a tabela de itens e também as
tabelas de gêneros. Todas as tabelas do MovieSite começam com MS* e as tabelas do LikeMinds
começam com Lps*. Para implementar a filtragem, as colunas de ID de filtro devem ser
adicionadas à tabela LPS_ITEM_DATA. Esses IDs de filtros são populados quando um filme é
registrado pela primeira vez ou os IDs são definidos diretamente. Para obter informações
adicionais sobre filtragem, consulte a seção sobre recomendações de filtragem, a seguir.
Recomendações de Filtragem com Base em IDs do Filtro
O LikeMinds implementa um sistema de filtragem para cada uma das regras do Personalização
que consultam o LikeMinds. Esse sistema filtra itens como o nível do LikeMinds, de acordo com
qualquer número de ID de filtro associado a cada item. Apenas os itens que satisfazem o filtro
são nivelados ao ponto do conteúdo na JSP.
Explorando o Movie Site: Movie Site demonstra o LikeMinds Recommendation Engine, orientando você
por um cenário de personalização que baseia-se nos dados reais de um site popular na Internet. O
website usa uma solução de personalização para analisar o comportamento do visitante e para
recomendar informações e serviços de conteúdo individualizado enquanto o visitante está envolvido
ativamente no site.
Notas:
v As Coleções de Recursos fornecidas são apenas para o IBM DB2 Universal Database Enterprise Server
Edition e para o DB2 para z/OS. Para usar a amostra em outros tipos de banco de dados, é possível
gerá-los novamente usando RAD. Para obter informações sobre Coleções de Recursos, consulte o tópico
Recursos, Instâncias de Recursos e Coleções de Recursos.
v Supõe-se que você seja o usuário Movie Site, likeminds. Esse usuário classificou anteriormente alguns
filmes e registrou preferências conforme configurado na instalação.
Para configurar a amostra de Movie Site, escolha a opção apropriada:
v AIX,SolarisLinux: ./ConfigEngine.sh cfg-likeminds-samples -DWasPassword=password
-DLikemindsDbPassword=password
v Janelas: ConfigEngine.bat cfg-likeminds-samples -DWasPassword=password
v IBM i: ConfigEngine.sh cfg-likeminds-samples -DWasPassword=password
v z/OS: A amostra de Movie Site é instalada como parte da configuração dos utilitários e das amostras
do LikeMinds. A configuração do Diálogo de Customização para o Portal fornece os painéis para
Tarefas de configuração do aplicativo, nos quais você configura o Personalization, que inclui a
instalação e configuração das amostras do LikeMinds. Consulte as planilhas para Configurar as
Amostras do LikeMinds antes de iniciar a configuração da amostra Movie Site. O Diálogo de
Customização para instalação e configuração de amostras do LikeMinds gera as tarefas EJPSPZLC e
EJPSPZLR para você enviar. Após a conclusão da tarefa EJPSPZLC, você poderá iniciar o aplicativo da
amostra Movie Site.
Nota: Verifique se há mensagens de erro na saída antes de prosseguir com a tarefa seguinte. Se alguma
das tarefas de configuração falhar, verifique os valores no arquivo wkplc.properties.
Conclua as seguintes etapas para iniciar o aplicativo:
397
1. Abra o WebSphere Integrated Solutions Console.
2. Acesse http://machine:port_number/ibm/console, em que port_number é o número da porta do
WebSphere Portal.
3. Clique em Aplicativos > Tipos de Aplicativos > Aplicativos Corporativos WebSphere.
4. Selecione Aplicativo Movie Site e clique em Iniciar.
5. Classifique filmes utilizando a página inicial do Movie Site.
Tabela 122. Uma demo rápida de como classificar filmes utilizando a página inicial do Movie Site
Número da Etapa
Descrição
Ação a ser executada
1
Navegue para a página inicial do
Movie Site.
Abra uma janela do navegador
separada para a home page do Movie
Site. A URL é http://hostname:port/
MovieSite em que port é o número da
porta para o WebSphere Portal
Para esta demonstração, nos
concentraremos no mecanismo de
recomendação que utiliza algoritmos
matemáticos para fornecer filtragem
colaborativa.
2
3
Efetue login como usuário do
LikeMinds.
1. Digite likeminds no campo de
login.
Efetue logon como o usuário
likeminds. Este nome de login é o
usuário padrão que registrou-se no
site e classificou alguns filmes.
2. Digite likeminds no campo de
senha
Classificações anteriores de amostra.
1. Clique em Classificações
Anteriores de Amostra.
Consulte as classificações de filmes
selecionando Classificações
Anteriores de Amostra. Esta seção
do site contém algumas classificações
de filmes de amostra feitas
anteriormente pelo usuário
likeminds.
398
3. Clique em Enter.
2. Selecione Obter Mais Filmes no
menu.
3. Clique no ícone Para Lobby.
Você pode mostrar todos os filmes ou
apenas determinados filmes
classificados, selecionando uma das
classificações. Você pode examinar as
classificações de outros filmes
clicando em Obter Mais Filmes. Esta
demo permite classificar filmes. Para
obter mais filmes, digite o nome de
um filme no painel de procura para
verificar se os filmes específicos estão
armazenados no banco de dados.
Tabela 122. Uma demo rápida de como classificar filmes utilizando a página inicial do Movie Site (continuação)
Número da Etapa
Descrição
Ação a ser executada
4
Utilize o SuperRater para classificar
um filme.
1. Clique em Para Lobby.
2. Clique em Classificar mais
filmes.
No modo Super-Rater, clicar no menu
suspenso associado a cada filme
3. Clique em Ativar Superrater.
revelará uma opção de classificação.
4. Clique no menu suspenso
É possível classificar qualquer filme
da lista e clicar em Submeter para
registrar sua opção de classificação.
associado à classificação para ver
as opções.
5. Clique em Título do Filme.
Nota: Isso abre uma nova janela.
Se você clicar no título do filme, ele o
vinculará às informações sobre o
filme que está usando o site
imdb.com.
Observe a previsão do mecanismo de
recomendação do quanto você, como
usuário de login do LikeMinds,
gostaria desse filme.
5
Demonstração final.
Clique em Para Lobby.
A tecnologia de filtragem colaborativa do LikeMinds considera cada usuário como o centro de seu
próprio cluster de preferência, em vez de tentar localizar a melhor categoria de preferência
preestabelecida para cada usuário, que é típica de abordagens baseadas em perfil. As recomendações do
LikeMinds podem adaptar-se a essas alterações muito mais rapidamente do que as técnicas agregadas,
baseadas em perfil.
Escolha a tarefa apropriada para remover o aplicativo:
Janelas: ConfigEngine.bat remove-likeminds-samples -DWasPassword=password
AIX,SolarisLinux: ./ConfigEngine.sh remove-likeminds-samples -DWasPassword=password
IBM i: ConfigEngine.sh remove-likeminds-samples -DWasPassword=password
z/OS: ./ConfigEngine.sh remove-likeminds-samples -DWasPassword=password
Nota: Verifique se há mensagens de erro na saída antes de prosseguir com a tarefa seguinte. Se alguma
das tarefas de configuração falhar, verifique os valores nos arquivos wkplc.properties,
wkplc_dbdomain.properties e wkplc_dbtype.properties.
Utilizando dos utilitários do LikeMinds
Aprenda sobre os quatro utilitários que o LikeMinds usa para atualizar o banco de dados, buildvisit
(para o mecanismo de preferência), sifter, buildstats e lpsIAA (para o utilitátio acumulador do
mecanismo de afinidade de itens).
Os utilitários do LikeMinds são executados a partir do servlet de utilitário do LikeMinds.
Você deve configurar esses utilitários para que sejam executados nos momentos apropriados. Consulte a
seção “Planejando Eventos do LikeMinds” na página 381 para obter mais informações.
Sifter:
399
O sifter, que é utilizado por todos os mecanismos de recomendação, exceto pelo de Afinidade de Itens,
designa mentores a usuários e atualiza suas designações como itens de classificação de usuários. Quando
nenhum usuário está classificando itens, o sifter atualiza as atribuições do mentores de todos os usuários
com base nas alterações do conjunto de mentores disponíveis.
O sifter deve estar em execução sempre que o servidor LikeMinds estiver em execução. No entanto,
você pode instalar o sifter em diversas máquinas para distribuir a carga.
Buildstats:
O utilitário buildstats atualiza as estatísticas do banco de dados. Você pode utilizar buildstats para
todos os Mecanismos de Recomendação, exceto para o Mecanismo de Afinidade de Itens.
Quando instalar os utilitários do LikeMinds, o instalador define buildstats para ser executado uma vez
por dia, às 03:30. Isto ocorre porque a melhor hora para executar buildstats é diariamente, na hora em
que o servidor LikeMinds recebe relativamente pouca utilização. O utilitário buildstats conecta-se
diretamente ao banco de dados do LikeMinds e processa os dados transacionais ou de classificações que
são constantemente gravados no banco de dados do LikeMinds. Como este utilitário não consome muitos
recursos, ele geralmente é instalado na mesma máquina que o servidor LikeMinds. buildstats executa
várias funções de análise de dados nas informações no banco de dados do LikeMinds e grava
persistentemente os resultados no esquema do LikeMinds. No entanto, a funcionalidade desse utilitário e
o número de funções a serem testadas diferem, dependendo do tipo de mecanismo do LikeMinds que
está em uso. Se os Mecanismos de Preferência e de Seqüência de Cliques estiverem em uso, buildstats
analisará, por padrão, os dados de classificação e de transações.
Para os dados de classificação, o buildstats grava os seguintes campos na tabela Lps_Item_Data:
v num_rtg: Número total de classificações para o item.
v total_rtg: Soma de todas as classificações para o item.
v total_square_rtg: Soma dos quadrados de todas as classificações para o item.
v ratability: Prioridade de apresentação de um item para os usuários classificarem. A capacidade de
classificação não é um valor negativo. Números maiores indicam uma prioridade de classificação
maior.
v score: Popularidade ou impopularidade de um item. Se preferir que seu próprio aplicativo atualize
esse campo, você pode desabilitar o buildstats de gravar o score.
Para os dados de transações, o buildstats grava esses campos na Lps_User_Trx:
v value: Valor dos dados associados à transação.
v adj_count: Contagem ajustada de transações. Se uma nova atividade for registrada na tabela de
transações, esse valor aumentará. Ele poderá diminuir com o passar do tempo.
Accumulator:
Use o utilitário accumulator se estiver utilizando o Mecanismo de Afinidade de Itens. Esse utilitário
acumula o número de vezes que cada combinação item a item possível ocorre.
Da mesma forma que o sifter para outros mecanismos do LikeMinds, o accumulator é executado nos
dados do evento de itens de processamento em segundo plano. Ele grava esses dados na tabela
especificada na definição <item_affinity_set>.item_affinity.output.table. O accumulator é instalado
como parte do PZN_Utilities.ear. Ele é executado por meio do mecanismo de planejamento do LikeMinds
(consulte “Planejando Eventos do LikeMinds” na página 381).
Filtrando as Recomendações do LikeMinds
Quando o LikeMinds faz recomendações, ele pode fazê-las com base em todos os itens em sua coleta de
recursos ou pode limitar os prognósticos apenas a itens que tenham determinadas características.
400
Instrua o LikeMinds sobre um item, incluindo pares de chave/valor descrevendo suas características, à
medida que você registra ações e classificações ocorridas nele. O formato do par chave/valor é
Key = LMFilter.<item_characteristic>
value = <value>
Por exemplo, para instruir o LikeMinds de que a cor do item é azul e sua categoria é esporte, você
incluiria os 2 pares chave/valor:
LMFilter.cor,azul
LMFilter.categoria,esporte
Especifique quais características desejaria que o LikeMinds utilizasse ao fazer prognósticos, definindo
atributos de solicitações no objeto Requ

Web Content Manager Versão 8.0

Transcrição

Documentos relacionados

Op. Manutenção Elétrica - CASE NEW HOLLAND

São do competidor nosso PyMEs

Plantas de Curitiba e Contagem conquistam Bronze no WCM

Radiação Ionizante

Autoria, trabalho e técnica Luciana Salazar Salgado Se vemos a

Clique!

Como utilizar Web Content Filter (WCF) ?

Exemplos de estudos de caso de pilhas de virtualização e

PATCHVIEW - DIO GERENCIAVEL MODULAR MPO/LC 96F 1U

DECRETO Nº 24075