Categoria do Navegador de aplicações

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 15 min. de leitura
  • Verifique a funcionalidade de menus e módulos no navegador de aplicações.

    Visibilidade do menu de aplicação

    Verifica a visibilidade, ou a falta dela, dos menus da aplicação 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 para esse usuário.

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

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

    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação O escopo da aplicação no qual o sistema executa este teste ou pacote de testes.
    Teste 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 depois que a etapa de teste é enviada.
    Anotações Anotações sobre a etapa de teste.
    Navegador Versão do navegador a ser declarada
    • IU principal (UI16): se você estiver criando novas etapas, terá IU principal por padrão.
    • Next Experience: se você tiver Next Experience habilitado, Next Experience será o navegador padrão. Se estiver desabilitado, IU principal será o navegador padrão.
    Tipo de asserção visível Especifica como os menus da aplicação selecionados no campo Menus da aplicação visíveis devem ser testados quanto à visibilidade no navegador de aplicações.
    • Pelo menos estes menus da aplicação estão visíveis: no mínimo, todos os menus da aplicação selecionados estão visíveis no navegador de aplicações.
    • Somente estes menus da aplicação estão visíveis: somente os menus da aplicação selecionados estão visíveis no navegador de aplicações.
    Menus da aplicação visíveis Menus da aplicação 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 selecionados no campo Menus da aplicação não visíveis devem ser testados quanto à falta de visibilidade no navegador de aplicações.
    • Pelo menos estes menus da aplicação não estão visíveis: no mínimo, todos os menus da aplicação selecionados não estão visíveis no navegador de aplicações.
    • Somente 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 de aplicações.
    Menus da aplicação não visíveis Menus da aplicação cuja falta de visibilidade no navegador de aplicações está sendo verificada.

    Criar um menu de aplicações

    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 aparecem 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é Todos > 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 está 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 sobre o que esta aplicação faz.
      Outros campos
      Ordem Define a posição relativa do menu da aplicação no navegador de aplicações. 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 do aplicativo para dispositivos móveis em uma tabela separada.
      Nota:
      Pode ser necessário configurar 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 são exibidos no navegador de aplicações.

    Criar um módulo

    Os módulos são os secundários ou as opções de navegação de segundo nível 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 da aplicação.

    Assista a este vídeo de cinco minutos para saber 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 edição da 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é a lista relacionada 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 de aplicação Especifica o nome do menu da aplicação sob o qual o módulo aparece.
      Dica Define a dica da ferramenta que aparece quando um usuário aponta para o nome do módulo.
      Nota:
      As dicas do módulo estão obsoletas no IU principal
      Ordem A ordem na qual o módulo é exibido em relação a outros módulos.
    4. Na guia 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 o contém. Os usuários ainda devem atender aos requisitos de função para este módulo.
    5. Na guia Tipo de lista, preencha os campos.

      Os campos exibidos dependem do tipo de Link escolhido. 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 como codificar URIs de módulo, consulte Codificação de URIs de módulo.

      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 do 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.
      Filtrar 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 como codificar URIs de módulo, consulte Codificação de URIs de módulo.
      Ordem Especifica a ordem em que os módulos aparecem na aplicação.

    Tipos de link do módulo

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

    Tabela 5. Tipos de link do módulo
    Tipo de Link Descrição
    Avaliação Links para a pesquisa baseada em avaliação selecionada no campo Referência de avaliação. Consulte Criar um módulo de pesquisa.
    Página com conteúdo Exibe a página de conteúdo selecionada no campo de referência da página de conteúdo. Consulte Como criar uma página de conteúdo.
    Link de documentação Vincula-se a 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 o tipo de link do módulo URL (de Argumentos).
    Página inicial Exibe a página inicial selecionada no campo de referência Página inicial.
    HTML (de argumentos) Insere o HTML no navegador de aplicações. Este tipo de link é usado para links mais complexos, em que uma URL simples não é personalizável o suficiente.
    Nota:
    • O tipo de link HTML (de argumentos) é compatível somente com as interfaces UI15 e UI11 legadas. Em IU principal, use o tipo de link URL (de Argumentos).
    • Insira um valor para o campo Argumentos.
    Filtro de lista Exibe uma exibição de lista não preenchida para a tabela selecionada no campo Tabela. Permite que os usuários especifiquem um filtro sem carregar a lista primeiro. Use o campo Filtro para definir o filtro padrão da lista. Use o campo Nome de exibição para especificar um gerenciamento de exibição.
    Lista de registros Exibe a exibição de lista da tabela selecionada no campo Tabela. Use o campo Filtro para definir o filtro padrão da lista. Use o campo Nome de exibição para especificar uma exibição.
    Página de Mapa Exibe a página do mapa selecionada no campo de referência da página do mapa.
    Novo registro Exibe um formulário para criar um registro na tabela selecionada no campo Tabela.
    Executar um relatório Executa o relatório salvo selecionado no campo Relatório.
    Script (de argumentos) Executa um script, conforme definido no campo Argumentos.
    Nota:
    Insira um valor para o campo Argumentos.
    Tela de pesquisa Link que exibe um formulário em branco para pesquisar registros na tabela. Use o campo Nome de exibição para especificar uma exibição.
    Nota:
    Use o parâmetro &sysparm_result_view=view_name para definir a exibição em que os resultados são renderizados.

    Todas as pesquisas usam uma consulta [começa com] para pesquisar texto correspondente. Outros tipos de consulta não são compatíveis com as telas de pesquisa.

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

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

    Nota:
    • Para links internos, sempre use um link relativo, como ./catalog_home.do?sysparm_view=catalog_default ou catalog_home.do?sysparm_view=catalog_default. Não use um link absoluto para uma instância ServiceNow. 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 o URL ainda faz referência à instância de desenvolvimento.
    • Insira um valor para o campo Argumentos.

    URIs do módulo de codificação

    Clicar no nome de um 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 será quebrado.

    Nota:
    Se você estiver atualizando para a versão New York ou posterior de uma versão anterior a New York, as IUs do módulo poderão falhar 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 na guia Tipo de link.

    Guia de tipo de link

    A definição de argumento em Argumentos e as condições de filtro definidas em Filtro se tornam parte do URI do módulo e devem ser codificadas por URL. ServiceNow codifica automaticamente as condições de filtro por URL e as anexa ao URI do módulo usando sysparm_query. Por exemplo, adicionar a condição de filtro Ativo é verdadeiro anexa sysparm_query=active%3Dtrue ao URI do módulo; %3D é a codificação de URL para o sinal de igual (=).

    A tabela a seguir mostra quando você deve codificar em URL o argumento no campo Argumentos e quando ServiceNow codifica em URL o argumento.

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

    ServiceNow

    Remove o acento circunflexo (^) 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 O 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ê A URL codifica a definição do filtro e usa sysparm_query para anexá-la e aos argumentos (inalterados) ao URI do módulo.

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

    Exemplos

    Os exemplos a seguir demonstram quando você precisa codificar por URL a definição do argumento em Argumentos:
    • Não há condições de filtro e a definição do 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 evita que ServiceNow codifique o argumento por URL. Codifique o argumento em URL: &sysparm_fixed_query=assigned_to%3Djavascript%3Ags.user_id().

    • Há condições de filtro e a definição do argumento em Argumentos não começa com um acento circunflexo (^), por exemplo, sysparm_name=Barnes & Noble's.

      Este argumento quebra o URI do módulo porque o e comercial e os espaços não são codificados por URL. Codifique o argumento em URL: sysparm_name=Barnes%20%26%20Nobel's

    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 para esse usuário.

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

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

    Ativo Opção para ativar esta etapa de teste para uso.
    Aplicação O escopo da aplicação no qual o sistema executa este teste ou pacote de testes.
    Teste 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 depois que a etapa de teste é enviada.
    Anotações Anotações sobre a etapa de teste.
    Navegador Versão do navegador a ser declarada
    • IU principal (UI16): se você estiver criando novas etapas, terá IU principal por padrão.
    • Next Experience: se você tiver Next Experience habilitado, Next Experience será o navegador padrão. Se estiver desabilitado, IU principal será o navegador padrão.
    Tipo de asserção visível Especifica como os módulos selecionados no campo Módulos visíveis devem ser testados quanto à visibilidade no navegador de aplicações.
    • Pelo menos estes módulos estão visíveis: no mínimo, os módulos selecionados no campo Módulos visíveis estão visíveis no navegador de aplicações.
    • Somente estes módulos estão visíveis: somente os módulos específicos selecionados no campo Módulos visíveis estão visíveis no navegador de aplicações.
    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 selecionados no campo Módulos não visíveis devem ser testados quanto à falta de visibilidade no navegador de aplicações.
    • Pelo menos esses módulos não estão visíveis: no mínimo, os módulos selecionados no campo Módulos não visíveis não estão visíveis no navegador de aplicações.
    • Somente estes módulos não estão visíveis: somente os módulos específicos selecionados no campo Módulos não visíveis não estão visíveis no navegador de aplicações.
    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:
    Nem todas as páginas podem ser testadas no momento. Onde quer que o módulo o leve, é de sua responsabilidade.
    Tabela 8. Entradas
    Campo Descrição
    Ordem de execução Número inteiro que especifica a ordem na qual o teste executa esta etapa.

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

    Ativo Opção para ativar esta etapa de teste para uso.
    Tempo limite Número de segundos permitidos antes que a etapa falhe. Se a validação falhar, o sistema repetirá 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 no qual o sistema executa esta etapa.
    Teste 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 depois que a etapa de teste é enviada.
    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 de aplicações.
    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 são vinculados a uma página específica, mas executam o JavaScript do lado do cliente (como o Studio e o Depurador de script)
    • Módulos que vinculam a sites externos, como o site de documentação da ServiceNow (docs.servicenow.com)
    • Módulos que recarregam ou redirecionam toda a página