Como usar widgets do portal

Widgets são o que define o conteúdo das páginas do portal. Você pode usar os widgets do sistema de base fornecidos com Portal de serviços, clonar e modificar widgets ou desenvolver widgets personalizados para atender às suas próprias necessidades.

Ao criar ou atualizar uma página no Portal de serviços Designer, você adiciona facilmente widgets pesquisando no filtro de widget e arrastando um widget para a página. Você também pode acessar todos os registros de widget da plataforma em Todos > Portal de serviços > Widgets.

Widgets do sistema de base

Você pode usar os widgets do sistema de base incluídos com Portal de serviços para começar a configurar as páginas do portal. Os widgets do sistema base são somente leitura para que você possa se beneficiar de atualizações futuras. No entanto, para cada instância de um widget do sistema base adicionada a uma página, você pode configurar as opções de instância disponíveis para esse widget.

Para obter uma lista de widgets do sistema de base e informações sobre suas opções de instância, consulte Biblioteca de widgets.

Instâncias de widget

Quando você adiciona um widget a uma página usando o Designer do Portal de serviços, ele cria uma instância de widget. Uma instância de widget é uma referência a um widget que contém um local, propriedades e CSS específicos para essa instância. Adicionar o mesmo widget várias vezes à mesma página cria várias instâncias.

Todas as instâncias de widget apontam para um widget. Se você editar esse widget, todas as suas instâncias de widget também receberão essa mudança. Você também pode fazer mudanças específicas em uma instância de widget e somente essa instância de widget será afetada.

Por exemplo, a imagem a seguir inclui quatro instâncias do sistema de base Widget de link de ícone com diferentes configurações específicas para cada instância.

Figura 1. Widgets de link de ícone

Nota:

Para widgets que não contêm nenhuma informação por padrão, você deve configurar as opções para suas instâncias de widget antes que elas apareçam em uma página do portal.

Menu de contexto do widget

Em qualquer página renderizada do Portal de serviços, você pode pressionar CTRL + clicar com o botão direito do mouse em um widget para ver mais opções de configuração em um menu de contexto.

Por exemplo, navegue até Portal de serviços > Página inicial do Portal de serviços para abrir uma página do portal de amostra. CTRL+clique com o botão direito do mouse na Base de conhecimento nessa página.

Figura 2. Menu de contexto do widget

Nota:

Você deve ter a função admin ou sp_admin para ver o menu de contexto do widget. Ao representar um usuário sem uma dessas funções, você ainda pode ver o menu. No entanto, um usuário comum conectado sem essas funções não pode ver o menu.

Tabela 1. Opções do menu de contexto do widget

Opção	Descrição
Desempenho do widget	Quanto tempo leva para um widget carregar
Opções de instância	Especifique uma instância de um widget. As opções de instância de widgets variam de acordo com o widget selecionado. Por exemplo, as opções de instância do widget de relógio legal incluem fusos horários diferentes para cada instância, portanto, você pode ter o mesmo relógio quatro vezes em uma página, mas com fusos horários diferentes.
Instância no Editor de páginas	Abre essa instância do widget no Editor de páginas
Designer de Páginas	Abre o widget no Designer do Portal de serviços, que permite adicionar contêineres, colunas e widgets. Você pode adicionar estilo do Designer do Portal de serviços ao widget ou à página em que o widget reside.
Exibir Personalizações de Widget	Mostra os níveis de personalização de widgets na página para que você possa diagnosticar problemas na página. Para obter mais informações, consulte Diagnóstico de widget.
Editar Plano de Fundo do Contêiner	Edite o layout no qual o widget está localizado.
Esquema de Opções de Widget	Defina as opções que você pode selecionar para uma instância de um widget. Para obter mais informações sobre como configurar suas próprias opções de instância, consulte Esquema de opções de widget.
Widget no Pop-up do Formulário	Abre o formulário de widget em uma janela pop-up para que você possa fazer mudanças rápidas no widget.
Widget no Editor	Abre o widget no Editor de widgets. Você pode usar o Editor de widget para configurar modelos HTML, CSS, scripts de cliente, scripts de serviço e dados de demonstração para o widget.
Registrar no console: $scope.data	O objeto $scope.data passa dados do servidor para o controlador do lado do cliente. Em vez de adicionar mensagens ou alertas do console.log ao código do controlador, você pode registrar o objeto $scope.data no console do navegador e exibir os dados lá.
Registrar no console: $scope	Semelhante ao objeto $scope.data, exceto que ele registra tudo em $scope no console.

Widgets personalizados

Os widgets do sistema base são somente leitura para que você possa se beneficiar de atualizações futuras. Para fazer mudanças, você pode clonar widgets do sistema de base. No entanto, os widgets clonados são considerados personalizados e não se beneficiam de atualizações futuras dos widgets dos quais foram clonados. Você também pode criar widgets do zero. Para saber mais sobre como clonar ou criar widgets, consulte Como desenvolver widgets personalizados.

• Configurar instâncias de widget
  Crie instâncias exclusivas de widgets configurando as opções para cada instância.
• Biblioteca de widgets
  Você pode usar os widgets do sistema de base como estão no seu Portal de serviços ou cloná-los para atender às suas próprias necessidades de negócio.