---
sourceDocument: Yokohama Mobile Configuração e navegação
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/mobile

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Mobile Configuração e navegação

ft:clusterId :

    - mobile

bundleId :

    - mobile

workflow :

    - Platform


---

# Estrutura de deep link para celular

# Estrutura de deep link para celular {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

Familiarize-se com como criar e usar links diretos para celular em qualquer tipo de tela em um app para celular.
Os Deep Links para celular consistem essencialmente em três componentes. O nome da variável, uma referência a um app para celular e o método público usado para extrair o link direto para celular. O link direto para celular a seguir tem uma variável com o nome `DeepLinkGen `, onde uma tela especificada é aberta no Mobile Agent.  

    var deepLinkGen= new global.MobileDeepLinkGenerator('Agent');
     return deepLinkGen.getScreenLink('73f3d135532033002d96ddeeff7b1212');

Nome da variável
:   Você pode dar qualquer nome de variável para o link direto para celular, embora ele deva ser identificável para referência futura.

Chamada do app para celular
:   Insira um dos apps para celular para os quais o link direto para celular aponta. Você pode inserir qualquer uma delas `Solicitação `para Now Mobileapp ou `Agente `para Mobile Agentapp. Por exemplo, para gerar um link usando o gerador de link profundo para celular que aponta para o app Now Mobile, use o seguinte código: `Novo global.MobileDeepLinkGenerator('Request'); `

Método público
:   Use um dos métodos públicos que podem ser usados para criar um link direto para celular. Consulte a tabela para obter uma explicação de cada método e o motivo de seu uso.  
    {#deep-link-mobile-structure__table_nm2_jwd_ypb__entry__3}

    | Método | Motivo do uso | Parâmetros do 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 para 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)` | ObtFormScreenLink é usado para vincular a qualquer tela de formulário não parametrizada. | formScreenId (obrigatório): sys_id da tela do formulário obrigatório tableName (obrigatório): nome da tabela da tela do formulário obrigatório 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 app 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 <kbd class="ph userinput">verdadeiro </kbd>para que o sistema preencha previamente os detalhes de login da instância do usuário. Insira <kbd class="ph userinput">falso </kbd>, para que o usuário insira manualmente os detalhes de login. |
    | `GetScreenLink(documentId, uiParams)` | GetScreenLink é usado para vincular a qualquer tela de lista, incluindo tipos parametrizados e não parametrizados. Também pode ser usado para qualquer tipo de tela não parametrizado. 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) identificado pelo `sys_id `parâmetro. Este link pode ser usado para autenticar usuários finais que usam IdPs diferentes. Por exemplo, as pré-contratações podem usar Microsoft AzureComo o IdP e os funcionários integrados podem usar OktaComo o IdP. Um uso comum desses links pré-preenchidos de SSO (single sign-on) é incorporá-los em e-mails enviados aos funcionários. Esses e-mails contêm um link que pode ser usado para fazer login com segurança em um ServiceNowusando seus apps para celular. Importante: Você deve ativar o plug-in de SSO de vários provedores e ter um IdP ativo para usar este método. Para obter mais informações, consulte [Ative o plug-in de SSO de vários provedores](https://www.servicenow.com/docs/access?context=t_ActivateMultipleProviderSSO&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) | 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é TudoSSO MultiprovedorProvedores de Identidade. 2. Clique com o botão direito em um registro de provedor de identidade e selecione Copiar sys_id. {#deep-link-mobile-structure__ol_srz_cr3_wrb} |
    | `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 celular](https://servicenow-prod.fluidtopics.net/CpDb6dZxTPfatwR8CXL5dg "Os links universais para dispositivos móveis permitem que você direcione os usuários para telas específicas em um app para dispositivos móveis, que eles não conseguiriam acessar por meio do ServiceNowexperiência na web da plataforma."). | url (obrigatório): um link para um recurso em uma instância |
    [ ]

    {#deep-link-mobile-structure__table_nm2_jwd_ypb}