Estrutura de link profundo para dispositivos móveis

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

    • Familiarize-se com a forma de construir e usar links profundos móveis em qualquer tipo de tela em um aplicativo para celular.

    Os links profundos móveis consistem essencialmente em três componentes. O nome da variável, uma referência a um aplicativo para celular e o método público usado para extrair o link profundo para celular. O link profundo móvel a seguir tem uma variável com o nome de "deepLinkGen", em que uma tela especificada é aberta no Mobile Agent.

    var deepLinkGen= new global.MobileDeepLinkGenerator('Agent');
 return deepLinkGen.getScreenLink('73f3d135532033002d96ddeeff7b1212');
    Nome da variável
    Você pode fornecer qualquer nome de variável para o link profundo móvel, embora ele deva ser identificável para referência futura.
    Chamada do aplicativo para celular
    Insira um dos aplicativos para celular para os quais o link profundo para celular aponta. Você pode inserir Solicitação para o app Now Mobile ou Agente para o app Mobile Agent. Por exemplo, para gerar um link usando o gerador de link profundo móvel que aponta para o aplicativo Now Mobile, use o seguinte código: new global.MobileDeepLinkGenerator('Request');
    Método público
    Use um dos métodos públicos que podem ser usados para criar um link profundo móvel. Consulte a tabela para obter uma explicação de cada método e o motivo de seu uso.
    Método Motivo do uso Parâmetros de método
    getButtonLink(buttonId, tableName, recordSysId) getButtonLink é usado para vincular a qualquer tela de formulário de entrada. buttonId (obrigatório): sys_id do botão no qual você deseja iniciar a tela do formulário de entrada

    tableName (opcional): nome da tabela para o contexto atual

    recordSysId (opcional): sys_id do registro de contexto atual
    getFormScreenLink (formScreenId, tableName, recordSysId) getFormScreenLink é usado para vincular a qualquer tela de formulário sem parâmetros. formScreenId (obrigatório): sys_id da tela do formulário obrigatória

    tableName (obrigatório): nome da tabela da tela do formulário obrigatória

    recordSysId (obrigatório): sys_id do registro de tableName
    getLauncherScreenLink(launcherScreenId) getLauncherScreenLink é usado para vincular a qualquer tela do inicializador. launcherScreenId (obrigatório): sys_id da tela do inicializador necessária.
    getPrefillLink(forceLocalLogin) getPrefillLink é útil para usuários móveis da ServiceNow pela primeira vez. Este formato de link preenche previamente o link da instância para usuários que ainda não adicionaram uma instância ao aplicativo para celular. Este método é a experiência de autenticação padrão.

    Este método não gera um link para uma tela específica.

    		 forceLocalLogin (obrigatório):

    Insira verdadeiro para que o sistema preencha previamente os detalhes de login da instância do usuário.

    Insira falsopara que o usuário insira manualmente os detalhes de login.
    getScreenLink(documentId, uiParams) getScreenLink é usado para vincular a qualquer tela de lista, incluindo tipos com e sem parâmetros. Também pode ser usado para qualquer tipo de tela sem parâmetros. Um parâmetro de IU opcional pode ser passado para este método. documentId (obrigatório): sys_id da tela desejada

    uiParams (opcional): parâmetro de um item de dados
    getSSOPrefillLink(sys_id) getSSOPrefillLink gera um link que usa o provedor de identidade (IdP) que é identificado pelo parâmetro sys_id. Este link pode ser usado para autenticar usuários finais que usam IdPs diferentes. Por exemplo, pré-contratados podem usar Microsoft Azure como IdP e funcionários integrados podem usar Okta como IdP. Um uso comum desses links pré-preenchidos de SSO (single sign-on) é incorporá-los em e-mails enviados para funcionários. Esses e-mails contêm um link que pode ser usado para fazer login com segurança em uma instância ServiceNow usando seus aplicativos para celular.
    Importante:
    Você deve ativar o plug-in SSO de vários provedores e ter um IdP ativo para usar este método. Para obter mais informações, consulte Ativação do plug-in SSO de vários provedores
    		 sys_id (obrigatório): insira o sys_id do IdP que você deseja usar na tabela Provedores de identidade [sso_properties].
    Para obter o sys_id do IdP:
    1. Navegar até Tudo > SSO Multiprovedor > Provedores de Identidade.
    2. Clique com o botão direito em um registro de provedor de identidade e selecione Copiar sys_id.
    getUniversalLink (URL) getUniversalLink gera um link em uma lista, formulário ou navegador. Uma tela é gerada com base no conteúdo deste URL. Consulte Vinculação universal para dispositivos móveis. url (obrigatório): um link para um recurso em uma instância