Configurando o gadget HTML

O gadget HTML possibilita:

• Obter conteúdo de páginas HTML
• Subdividir e personalizar páginas
• Usar o recurso de preenchimento de indicadores
• Usar um login único
• Subdividir tabelas

Para registrar-se apenas uma vez em um aplicativo da Web baseado em login de formulário, defina a configuração DO POST como Verdadeiro. Além disso, adicione os seguintes parâmetros de formulário:

• loginName=%nome_de_usuário%
• password=%senha%

Após adicionar esses parâmetros, verifique se a autenticação básica do Secret Store está desativada (o que corresponde ao padrão).

Com o gadget HTML, você pode subdividir e personalizar páginas.

O gadget HTML não reconhece páginas que utilizam frames. Quando a página usa frames, o Novell Portal Services automaticamente acessa o gadget iFrame. Consulte Configurando o gadget iFrame.

NOTA:  Para acessar gráficos em bitmap, é preciso que eles não estejam protegidos por autenticação básica. A caixa de login da autenticação básica é exibida até que você digite um nome de usuário e senha válidos.

1. No gadget de administração, clique em Gadgets.

2. Localize e selecione o gadget HTML e clique em Editar.

3. Especifique as configurações necessárias para a implementação. O gadget HTML dispõe das seguintes configurações:

   • Configurar manualmente URL. Indica se o gadget HTML deve usar a URLLIST ou o URL para localizar o conteúdo para o gadget. Verdadeiro indica que o gadget é configurado manualmente e deve usar os valores de URL, PARAM e DOPOST. Falso indica que o gadget é configurado pelo Assistente e deve usar o valor de URLLIST. O padrão é desativado.
   • URL da Web simples.Aplica-se apenas quando MANUALCONFIG é Verdadeiro. Especifica o URL que será usado para encontrar o conteúdo para o gadget. O URL deve ser completo.
   • Parâmetros transferidos para o URL. Aplica-se apenas quando MANUALCONFIG é Verdadeiro. Este é um parâmetro que contém valores múltiplos e parâmetros definidos manualmente. Essa configuração aceita macros do portal e seu formato é NOME=VALOR.
   • Analisar URL para corrigir links relativos. Parâmetro ativado por padrão. Nesse caso, o portal analisa o HTML a ser exibido para verificar se os bitmaps e os links estão funcionando corretamente. Para otimizar o servidor, você pode desativá-lo e ver se a página ainda pode ser visualizada através do gadget.
   • URL em cache para exibição mais rápida. Parâmetro desativado por padrão. Quando ativado, o portal armazena a página HTML em cache para todos os usuários. O armazenamento das páginas em cache pode melhorar o seu desempenho. Porém, quando elas são personalizadas ou contêm outras informações específicas dos usuários, não é recomendável armazená-las em cache.
   • Tratar solicitação como um POST. Aplica-se apenas quando MANUALCONFIG é Verdadeiro. Esta configuração indica que o gadget deve transmitir os parâmetros como entradas de um formulário. O padrão é desativado.
   • Redirecionar links pelo portal. Especifica uma função de link, Se ativado, os links clicados voltam através do portal. Os links continuam a aparecer no portal como gadgets. O padrão é desativado.
   • Solicitações de autenticação básica usarão nome de usuário do portal. Especifica se o NPS usará o nome de usuário do portal com a autenticação básica.
   • Solicitações de autenticação básica usarão senha do portal. Especifica se o NPS usará a senha do portal com a autenticação básica.
   • Encaminhar cookies de volta ao browser. Especifica se o NPS encaminhará os cookies de volta ao browser. O padrão é desativado.
   • Mostrar links do URL em uma nova janela. Especifica uma função de link, Se ativado, o link do gadget clicado é aberto em uma nova janela. O portal continua na última janela ativa. O padrão é desativado.
   • Mostrar links como página inteira em vez de dentro da janela do gadget. Especifica uma função de link, Se ativado, os links continuam a ser mostrados no portal, mas aparecem numa janela inteira. O padrão é desativado.
   • Host de URL a ser usado ao analisar caminhos relativos. Especifica uma função de link, a qual determina um link alternativo para a análise de links. Isso é útil quando há um proxy entre o portal e o browser.
   • Protocolo de URL a ser usado ao analisar caminhos relativos. Especifica o protocolo que será usado na análise de um caminho relativo quando ele for diferente do que está no próprio URL. Por exemplo, HTTP ou HTTPS.
   • Usar este nome de usuário de autenticação básica em todas as instâncias do gadget. Especifica uma função de autenticação básica. Quando está ativado e o recurso de backend suporta autenticação básica, o portal usa o nome de usuário de quem estiver conectado naquele momento para autenticar o recurso.
   • Usar esta senha de autenticação básica em todas as instâncias do gadget. Especifica uma função de autenticação básica. Quando ativado e o recurso de backend suporta autenticação básica, o portal usa a senha de quem estiver conectado naquele momento para autenticar o recurso.
   • Codificação de caracteres para URL. Especifica a codificação de caracteres para esse site se os caracteres não estiverem aparecendo corretamente.
   • Habilitar cache de strings de procura e substituição. Especifica as strings de procura e substituição a serem colocadas em cache.
   • Procurar e substituir strings no conteúdo do URL. Procura e substitui strings no conteúdo do URL.

4. Clique em OK > Gravar > Fechar.

Usando macros de portal em um documento HTML

O gadget HTML suporta o recurso de preenchimento de indicadores HTML. Isso permite que o HTML seja personalizado para o usuário. Para isso, o gadget procura indicadores <NPS> nas páginas HTML. Dentro do indicador <NPS>, o portal busca macros do portal para analisar e as substitui pelos dados dessas macros. Abaixo, um exemplo de código de uma macro de portal:

<TABLE>
<TR>
<TD>
Bom dia, <NPS>%nome%</NPS>
</TD>
</TR>
</TABLE>

Se o atributo de nome do usuário for Pedro, a saída HTML desse código conteria o texto "Bom dia, Pedro".

Integrando uma página HTML usando o Secret Store

1. No gadget de administração, clique em Gadgets.

2. Selecione o gadget HTML e clique em Editar > Configuração > Assistente de Configuração.

3. Configure o URL inicial como http://www.myrealbox.com e clique em Próximo.

4. Efetue o login usando as devidas credenciais.

   Por exemplo: npsdemo1, novell

5. Clique em Sign In (Registrar) > Próximo > Editar.

6. Especifique %nome_de_usuário% (macro do NPS) com o valor para nome de usuário.

7. Especifique %senha% (macro do NPS) com o valor para senha.

8. Clique em Atualizar Parâmetros > Terminar > Continuar > Gravar.

9. Efetue o login como novo usuário e digite as credenciais do Secret Store.

   O nome de usuário e a senha digitados são as credenciais, porém elas podem variar conforme o sistema.

Abrindo links em uma nova janela do browser

1. No gadget de administração, clique em Gadgets.

2. Selecione o gadget HTML e clique em Editar > Todas as Configurações.

   Para obter informações sobre cada campo, clique em Descrições.

3. Ative Mostrar links do URL em uma nova janela.

4. Clique em Continuar > Gravar.

Forçando os links a permanecer dentro da área herdável do NPS

1. No gadget de administração, clique em Gadgets.

2. Selecione o gadget HTML e clique em Editar > Todas as Configurações.

3. Desative Mostrar links do URL em uma nova janela.

4. Ative Direcionar links pelo portal (Permitir que os links continuem aparecendo dentro do portal).

5. Clique em Continuar > Gravar.

Para obter instruções sobre como atribuir esse gadget a uma página, consulte Atribuindo um gadget a um tema ou página.