Usando widgets do portal

  • Versão de lançamento: Australia
  • Atualizado 21 de abr. de 2026
  • 4 min. de leitura

    • Os widgets são o que definem o conteúdo das páginas do portal. Você pode usar os widgets do sistema 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, adicione 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 Tudo > Portal de serviços > Widgets.

    Widgets do sistema base

    Você pode usar os widgets do sistema base incluídos com Portal de serviços para começar a configurar 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 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 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 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 incluem nenhuma informação por padrão, você deve configurar as opções para suas instâncias de widget antes que elas sejam exibidas em uma página do portal.

    Menu de contexto do widget

    Em qualquer página do Portal de serviços renderizado, 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. 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 de í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ê 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 do widget 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ágina 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 dos widgets na página para que você possa diagnosticar problemas na página. Para obter mais informações, consulte Diagnóstico do 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 do 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 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 copiar widgets do sistema base. No entanto, os widgets copiados são considerados personalizados e não se beneficiam de atualizações futuras nos widgets dos quais foram copiados. Você também pode criar widgets do zero. Para saber mais sobre como copiar ou criar widgets, consulte Desenvolvendo widgets personalizados.