Categoria do Navegador de aplicações

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 15 min. de leitura
  • Verifique a funcionalidade dos menus e módulos no navegador de aplicações.

    Visibilidade do menu de aplicação

    Verifica a visibilidade, ou a falta dela, dos menus de aplicações selecionados no navegador de aplicações (barra de navegação esquerda). Por exemplo, você cria um teste que primeiro representa um usuário e, em seguida, verifica se os menus da aplicação especificados (como Autoatendimento e Relatórios) estão visíveis ou não estão visíveis para esse usuário.

    Tabela 1. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.

    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação O escopo da aplicação em que o sistema executa este teste ou pacote de testes.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Navegador Versão do navegador para declarar
    • IU principal(UI16): Se você estiver criando novas etapas, você terá IU principalpor padrão.
    • Next Experience: Se você tiver Next Experiencehabilitado, Next Experienceé o navegador padrão. Se estiver desabilitado, IU principalé o navegador padrão.
    Tipo de asserção visível Especifica como os menus da aplicação são selecionados no Menus da aplicação visíveis o campo deve ser testado quanto à visibilidade no navegador de aplicações.
    • Pelo menos esses menus de aplicações estão visíveis : No mínimo, todos os menus da aplicação selecionados estão visíveis no navegador da aplicação.
    • Apenas estes menus de aplicações estão visíveis : Somente os menus da aplicação selecionados estão visíveis no navegador da aplicação.
    Menus da aplicação visíveis Menus de aplicações cuja visibilidade no navegador de aplicações está sendo verificada.
    Tipo de asserção não visível Especifica como os menus da aplicação são selecionados no Menus da aplicação não visíveis o campo deve ser testado quanto à falta de visibilidade no navegador da aplicação.
    • Pelo menos esses menus de aplicações não estão visíveis : No mínimo, todos os menus da aplicação selecionados não estão visíveis no navegador da aplicação.
    • Apenas estes menus da aplicação não estão visíveis : Somente os menus da aplicação selecionados não estão visíveis no navegador da aplicação.
    Menus da aplicação não visíveis Menus de aplicações cuja falta de visibilidade no navegador de aplicações está sendo verificada.

    Criar um menu de aplicação

    Os menus da aplicação definem o conteúdo principal que os usuários podem acessar no navegador de aplicações. Você pode configurar quais aplicações serão exibidas no navegador de aplicações.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Ao criar um menu de aplicações, considere agrupar módulos semelhantes em um menu de aplicações consolidado. Ao editar um menu existente, adicione mais módulos úteis ao menu da aplicação e remova os desnecessários.

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Menus da aplicação.
    2. Clique em Nova.
    3. Preencha o formulário.
      Campo Descrição
      Título Define o nome de exibição do menu da aplicação.
      Funções Restringe o acesso às funções especificadas. Todos os usuários podem exibir o menu da aplicação quando ele estiver ativo.
      Categoria Especifica a categoria de menu que define o estilo do menu de navegação (o valor padrão é Aplicações personalizadas ).
      Dica Define o texto que aparece em uma dica de ferramenta quando um usuário aponta para este menu da aplicação.
      Ativo Marque a caixa de seleção para ativar o menu da aplicação. Somente menus de aplicações ativos aparecem no navegador de aplicações.
      Descrição Forneça uma explicação mais detalhada do que esta aplicação faz.
      Outros campos
      Ordem Define a posição relativa do menu da aplicação no navegador da aplicação. Se você não especificar uma ordem, a ordem padrão da categoria de menu será usada.
      Tipo de dispositivo padrão Este campo não é usado. Você pode definir menus de aplicações para dispositivos móveis em uma tabela separada.
      Nota:
      Talvez seja necessário configure o formulário para ver todos os campos.
    4. Clique em Enviar.
    5. Crie módulos para aparecer no menu da aplicação.
      Somente menus de aplicações que contêm módulos aparecem no navegador de aplicações.

    Criar um módulo

    Os módulos são secundários ou as opções de navegação de segunda camada para as aplicações no navegador de aplicações. Os módulos geralmente são vinculados a outras páginas ou registros na plataforma. Você pode configurar quais módulos aparecem no navegador de aplicações usando o módulo Menus de aplicações.

    Assista a este vídeo de cinco minutos para saber mais sobre como adicionar menus e módulos de aplicações ao navegador de aplicações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Abra o registro do menu da aplicação usando um dos métodos a seguir.
      • Navegar até Definição do Sistema > Menus da aplicação e selecione o menu da aplicação na lista.
      • Aponte para o menu da aplicação e clique no ícone de editar aplicação (lápis).
      Figura 1. Dois métodos para criar um módulo
      Gif mostrando o primeiro e o segundo métodos para criar um módulo
    2. Role para baixo até Módulos e clique em Novo .
    3. Defina o módulo preenchendo os campos no formulário Módulo.
      Tabela 2. Formulário do módulo
      Campo Descrição
      Título Define o nome do módulo. Escolha um título que identifique claramente o módulo.
      Menu da aplicação Especifica o nome do menu da aplicação no qual o módulo aparece.
      Dica Define a dica de ferramenta que aparece quando um usuário aponta para o nome do módulo.
      Nota:
      As Dicas do módulo estão obsoletas em IU principal
      Ordem A ordem em que o módulo é exibido em relação a outros módulos.
    4. Em Visibilidade preencha os campos.
      Tabela 3. Guia Visibilidade
      Campo Descrição
      Funções Restringe o acesso ao módulo às funções especificadas. Se este campo for deixado em branco, o módulo ficará visível para todos os usuários que têm acesso ao menu da aplicação.
      Ativo Define se o módulo aparece no navegador de aplicações.
      Substituir funções do menu da aplicação Permite que os usuários acessem este módulo mesmo que não tenham permissão para exibir o menu da aplicação que contém. Os usuários ainda devem atender aos requisitos de função deste módulo.
    5. Em Tipo de lista preencha os campos.

      Os campos exibidos dependem de Tipo de link você escolhe. Todos os URIs do módulo devem ser codificados. Se você fornecer argumentos para o URI do módulo, você ou ServiceNow. Para obter mais informações sobre URIs do módulo de codificação, consulte URIs do módulo de codificação .

      Tabela 4. Guia Tipo de lista
      Campo Descrição
      Tipo de link Especifica que tipo de link este módulo abre. Você deve especificar informações adicionais com base no tipo de link. Consulte Tipos de link de módulo .
      Tabela Especifica a tabela usada pelo módulo.
      Nota:
      A lista mostra somente tabelas e exibições de banco de dados que estão no mesmo escopo do módulo.
      Filtro Condições para os itens apresentados no módulo, por exemplo, Ativo é verdadeiro .
      Argumento Cadeia de caracteres anexada ao URI para criar o URI do módulo. Pode ser um sysparm_query. Esses valores devem ser codificados por você ou ServiceNow. Para obter mais informações sobre URIs do módulo de codificação, consulte URIs do módulo de codificação .
      Ordem Especifica a ordem em que os módulos aparecem na aplicação.

    Tipos de link de módulo

    . Tipo de link O campo no formulário Módulo especifica o tipo de link que o módulo abre.

    Tabela 5. Tipos de link de módulo
    Tipo de Link Descrição
    Avaliação Links para a pesquisa baseada em avaliação que você seleciona no Avaliação campo de referência. Consulte Crie um módulo de pesquisa .
    Página com conteúdo Exibe a página de conteúdo selecionada no Página de conteúdo campo de referência. Consulte Crie uma página de conteúdo .
    Link de documentação Links para uma página de documentação e abre em uma nova guia ou janela. Este tipo de link é usado com metadados incorporados em tópicos de documentação. Para abrir um documento interno de um módulo, use URL (dos argumentos) tipo de link do módulo.
    Página inicial Exibe a página inicial selecionada no Página inicial campo de referência.
    HTML (dos argumentos) Coloca o HTML no navegador de aplicações. Este tipo de link é usado para links mais complicados, em que um URL simples não é personalizável o suficiente.
    Nota:
    • . HTML (dos argumentos) O tipo de link é compatível somente nas interfaces UI15 e UI11 legadas. Em IU principal, use o. URL (dos argumentos) em vez disso, tipo de link.
    • Insira um valor para Argumentos campo.
    Filtro de lista Exibe uma exibição de lista não preenchida para a tabela selecionada no Tabela campo. Permite que os usuários especifiquem um filtro sem carregar a lista primeiro. Use o. Filtro campo para definir o filtro padrão para a lista. Use o. Nome da exibição campo para especificar um Gestão de exibição .
    Lista de registros Exibe a exibição de lista da tabela selecionada no Tabela campo. Use o. Filtro campo para definir o filtro padrão para a lista. Use o. Nome da exibição campo para especificar uma exibição.
    Página de Mapa Exibe a página de mapa selecionada no Página do mapa campo de referência.
    Novo registro Exibe um formulário para criar um registro na tabela selecionada no Tabela campo.
    • Use o. Nome da exibição campo para especificar uma exibição.
    • Use o. Argumentos campo para aplicar um modelo. Consulte Crie um módulo para um modelo .
    Executar um relatório Executa o relatório salvo selecionado no Relatório campo.
    Script (dos argumentos) Executa um script, conforme definido em Argumentos campo.
    Nota:
    Insira um valor para Argumentos campo.
    Tela de pesquisa Link que exibe um formulário em branco para pesquisar registros na tabela. Use o. Nome da exibição campo para especificar uma exibição.
    Nota:
    Use o parâmetro &sysparm_result_view=view_namepara definir a exibição na qual os resultados serão renderizados.

    Todas as pesquisas usam um [começa com] consulta para pesquisar texto correspondente. Não há suporte para outros tipos de consulta nas telas de pesquisa.

    Separador Cria uma divisão entre módulos. Insira um nome no Título campo para adicionar um nome de seção que os usuários podem recolher ou expandir.
    Registro único Exibe um formulário para um único registro na tabela. Use o. Nome da exibição campo para especificar uma exibição.
    Pesquisa Links para a pesquisa legada que você seleciona no Pesquisa campo de referência. Use o. Substituição da pesquisa caixa de seleção para determinar se a pesquisa pode ser realizada várias vezes.
    Nota:
    . Pesquisa o tipo de link é para uso somente com pesquisas legadas, que as pesquisas baseadas em avaliação substituem. Selecione Avaliação tipo de link para vincular o módulo a uma pesquisa baseada em avaliação.
    Página da linha do tempo Exibe a página da linha do tempo selecionada no Linha do tempo campo de referência. Consulte Páginas da linha do tempo .
    URL (dos argumentos) Abre qualquer URL, conforme definido em Argumentos campo.

    [Opcional] Use o. Nome da janela campo para definir um link que abre em uma nova janela.

    Nota:
    • Para links internos, sempre use um link relativo, como ./catalog_home.do?sysparm_view ou catálogo_home.do?sysparm_view_catalog_default . Não use um link absoluto para A. ServiceNowinstância. Isso cria problemas quando você move um conjunto de atualizações de uma instância de desenvolvimento para uma instância de produção porque a URL ainda faz referência à instância de desenvolvimento.
    • Insira um valor para Argumentos campo.

    URIs do módulo de codificação

    Clicar em um nome de módulo no painel de navegação executa um URI que abre a página do módulo no painel de conteúdo. Todos os caracteres nos URIs do módulo devem ser codificados por URL ou o link deve quebrar.

    Nota:
    Se você estiver atualizando para a versão de Nova York ou posterior a partir de uma versão anterior a Nova York, as IU do módulo poderão quebrar se não seguirem as convenções apresentadas neste tópico.

    Ao criar módulos, você tem a opção de adicionar argumentos e condições de filtro que classificam e/ou reduzem o número de resultados exibidos no painel de conteúdo. Quando você clica em um nome de módulo em Definições do Sistema > Definições da aplicação, você pode ver essas condições e argumentos no Tipo de Link .

    Guia de tipo de link

    A definição do argumento em Argumentos e condições de filtro definidas em Filtro Torne-se parte do URI do módulo e deve ser codificado por URL. ServiceNowURL-codifica automaticamente as condições de filtro e as anexa ao URI do módulo usando sysparm_query. Por exemplo, adicionando a condição de filtro, Ativo é verdadeiro anexa SYsparm_query_active%3dtrue Para o URI do módulo; %3d é a codificação de URL para o sinal de igual.

    A tabela a seguir mostra quando você deve codificar o argumento com URL no Argumentos e quando ServiceNowURL-codifica o argumento.

    Tabela 6. Regras para argumentos de codificação
    Tem uma condição de filtro? A definição do argumento começa com Quem codifica o argumento? Como o argumento é tratado
    Não ^

    ServiceNow

    Remove o cursor do argumento, codifica-o e usa sysparm_query para anexá-lo ao URI do módulo.
    Não & Você Remove o e comercial (&) do argumento e o anexa ao URI do módulo.
    Não Qualquer outra coisa ServiceNow Codifica o argumento e usa sysparm_query para anexá-lo ao URI do módulo.
    Sim . ServiceNow URL-codifica a definição do filtro e o argumento e usa sysparm_query para anexar a combinação ao URI do módulo.
    Sim Qualquer outra coisa Você URL-codifica a definição do filtro e usa sysparm_query para anexá-la e os argumentos (inalterados) ao URI do módulo.

    Você pode ativar (o padrão) e desativar o requisito de codificação de URL para IUs do módulo usando o. glide.ui.encode_module_uripropriedade.

    Exemplos

    Os exemplos a seguir demonstram quando você precisa codificar a definição de argumento em URL Argumentos :
    • Não há condições de filtro e a definição de argumento em Argumentos começa com um e comercial, por exemplo, _sysparm_fixed_query_assigned_to_javascript:gs.user_id() .

      Este argumento quebra o URI do módulo porque o sinal de igual e os dois pontos não são codificados por URL e o e comercial impede ServiceNowDa URL - codificação do argumento. URL - Codificar o argumento: Assigned_to%3Djavascript%3Ags.user_id() .

    • Há condições de filtro e a definição de argumento em Argumentos não começa com um acento (), por exemplo, Sysparm_name: Barnes & Noble .

      Este argumento quebra o URI do módulo porque o E comercial e os espaços não são codificados por URL. URL - Codificar o argumento: Barnes%20%26%20Nobes

    Visibilidade do Módulo

    Verifique a visibilidade, ou a falta dela, dos módulos selecionados no navegador de aplicações (barra de navegação esquerda). Por exemplo, crie um teste que primeiro represente um usuário e, em seguida, verifique se os módulos especificados (como Página inicial e Minhas solicitações) estão visíveis ou não estão visíveis para esse usuário.

    Tabela 7. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.

    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação O escopo da aplicação em que o sistema executa este teste ou pacote de testes.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Navegador Versão do navegador para declarar
    • IU principal(UI16): Se você estiver criando novas etapas, você terá IU principalpor padrão.
    • Next Experience: Se você tiver Next Experiencehabilitado, Next Experienceé o navegador padrão. Se estiver desabilitado, IU principalé o navegador padrão.
    Tipo de asserção visível Especifica como os módulos são selecionados no Módulos visíveis o campo deve ser testado quanto à visibilidade no navegador de aplicações.
    • Pelo menos esses módulos estão visíveis : No mínimo, os módulos selecionados no Módulos visíveis os campos estão visíveis no navegador da aplicação.
    • Apenas estes módulos estão visíveis : Somente os módulos específicos selecionados no Módulos visíveis os campos estão visíveis no navegador da aplicação.
    Módulos visíveis Módulos cuja visibilidade no navegador de aplicações está sendo verificada.
    Tipo de asserção não visível Especifica como os módulos são selecionados no Módulos não visíveis o campo deve ser testado quanto à falta de visibilidade no navegador da aplicação.
    • Pelo menos esses módulos não estão visíveis : No mínimo, os módulos selecionados no Módulos não visíveis o campo não está visível no navegador da aplicação.
    • Apenas estes módulos não estão visíveis : Somente os módulos específicos selecionados no Módulos não visíveis o campo não está visível no navegador da aplicação.
    Módulos não visíveis Módulos cuja falta de visibilidade no navegador de aplicações está sendo verificada.

    Navegue até o Módulo

    Abra um módulo no navegador de aplicações, como se um usuário tivesse clicado nele. O módulo deve estar visível para o usuário em execução no momento para navegar até ele.

    Nota:
    No momento, nem todas as páginas são testáveis. Onde o módulo leva você é sua responsabilidade.
    Tabela 8. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem em que o teste executa esta etapa.

    À medida que você cria etapas, o sistema atribui automaticamente a cada etapa um valor incremental. Este valor faz com que o teste execute etapas na ordem em que você as criou. Você pode mudar esta ordem padrão editando o. Ordem de execução valores.

    Ativo Opção para ativar esta etapa de teste para uso.
    Tempo limite Número de segundos permitidos antes de a etapa falhar. Se a validação falhar, o sistema repete a etapa até atingir a duração do tempo limite. Se a validação falhar após a duração do tempo limite, a etapa falhará.
    Aplicação Escopo da aplicação em que o sistema executa esta etapa.
    Testar Nome somente leitura do teste ao qual você está adicionando a etapa.
    Configuração da etapa Nome somente leitura da etapa.
    Descrição Descrição da etapa de teste. Este valor de campo é definido automaticamente com base nos valores de campo da etapa de teste. Este campo aparece após o envio da etapa de teste.
    Anotações Anotações sobre a etapa de teste.
    Módulo Módulo que deve ser aberto. Para navegar até o módulo selecionado, o módulo deve estar visível para o usuário em execução no navegador da aplicação.
    Os seguintes módulos não são compatíveis e não podem ser testados:
    • Módulos que são separadores
    • Módulos que não vinculam a uma página específica, mas executam JavaScript no lado do cliente (como Studio e o Depurador de scripts)
    • Módulos vinculados a sites externos, como o site de documentação da ServiceNow (servicenow.com/docs)
    • Módulos que recarregam ou redirecionam toda a página