Navegação de página em Portal de serviços por URL

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Você pode navegar até um portal ou uma página em Portal de serviços usando um URL.

    Portal de serviços Os URLs têm a seguinte estrutura:

    https://<instance>/<portal suffix>/<guest language>/<keywords>?id=<page id>&lang=<language>&<page parameters>
    Elemento Descrição
    instância Endereço da Web exclusivo e seguro para cada instância. O formato padrão é https://<instance name> .service-now.com .
    sufixo do portal Sufixo estabelecido para o portal. Por exemplo, /sp.
    idioma convidado O ID do idioma do portal. Por exemplo, es para espanhol. A página retorna no idioma especificado se o idioma estiver ativo e o usuário que acessa a página for um usuário convidado.
    palavras-chave

    Palavras-chave legíveis que melhoram a otimização do mecanismo de pesquisa (SEO) e as taxas de cliques para páginas públicas. URLs legíveis também ajudam os usuários a entender o que esperar de uma página para páginas públicas e não públicas. Por exemplo, https://<instance> /kb/en/faq/what-is-a-cookie?id=kb_article_view&sysparm_article=KB0000007 .

    Para obter mais informações, consulte Adicionar palavras-chave legíveis a URLs de página.
    id O ID da página para a qual navegar dentro do quadro do portal. Por exemplo, ?id=index.
    idioma O ID do idioma do portal. Por exemplo, lang=es para espanhol. A página retornará no idioma solicitado se o idioma estiver ativo e o usuário que acessar a página for um usuário convidado ou um usuário autenticado sem um conjunto de preferências de idioma.
    parâmetros de página

    Parâmetros adicionais são necessários para algumas páginas carregarem conteúdo dinâmico pesquisando um registro (tabela, sys_id). Encontre as chamadas $sp.getParameter em um script de servidor de widget para ver os parâmetros que um widget usa. Para obter mais detalhes sobre esse método, consulte GlideSPScriptable - Scoped.

    Se você não incluir esses parâmetros adicionais quando necessário, poderá receber uma mensagem de erro Você não está autorizado ou o registro não é válido.

    Por exemplo, o URL de uma página da base de conhecimento pública em espanhol em Portal de serviços pode ser https://<instance> /sp/es/faq/what-is-a-cookie?id=kb_article&sys_id=KB0000007 .

    Nota:
    Se você usar o controle de versões de artigo com o plug-in Gestão de conhecimento - Portal de serviços (com.snc.knowledge_serviceportal), deverá adicionar o número da versão do artigo ao URL para abrir um artigo de conhecimento no sistema de base ou nos portais de conhecimento. Por exemplo, em vez de acessar um artigo usando o URL https://<instance> /sp?id=kb_article&sys_id=KB0000005 , você deve incluir o número da versão do artigo: https:///sp?id=kb_article&sys_id=KB0000005%20V1.0 . Para saber mais, consulte Controle de versões do artigo.

    Como fazer referência a um ID de página

    Widgets e opções de instância de widget fazem referência a páginas Portal de serviços usando o ID de página. Por exemplo, um link para a página sc_home em um modelo HTML de widget pode aparecer da seguinte forma:

    <div><a href="?id=sc_home">${Order something...}</a></div>