Usando widgets do portal

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 4 min. de leitura

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

    Quando você cria ou atualiza uma página no Portal de serviços Designer, você adiciona widgets facilmente 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 Tudo > 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 páginas do portal. Os widgets do sistema de 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 de base que você adiciona 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
    Widgets de link de ícone da página inicial do Portal de serviços com ícones e títulos diferentes para cada instância
    Nota:
    Para widgets que não contêm informações 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 clicar com a tecla Ctrl pressionada e 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 e clique com o botão direito do mouse na Base de conhecimento nessa página.

    Figura 2. Menu de contexto do widget
    Menu de contexto do widget Link do ícone
    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 regular 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 carregar um widget
    Opções de instância Especifique um instância de um widget . As opções de instância de widgets variam dependendo do widget selecionado. Por exemplo, as opções de instância para o widget de relógio legal incluem fusos horários diferentes para cada instância, para que você possa ter o mesmo relógio quatro vezes em uma página, mas com todos os 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ção 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 widgets para configurar modelos HTML, CSS, scripts de cliente, scripts de serviço e dados de demonstração para o widget.
    Log no console: Escopo.data O objeto scope.data passa dados do servidor para o controlador do lado do cliente. Em vez de adicionar console.log mensagens ou alertas ao código do controlador, você pode registrar o objeto "scope.data" no console do navegador e exibir os dados lá.
    Log no console: Escopo Semelhante ao objeto scope.data, exceto que ele registra em log tudo no escopo 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 Desenvolvimento de widgets personalizados.