Usar links profundos para o aplicativo móvel Field Service

  • Artigo

Links profundos permitem que os usuários mudem de um aplicativo para outro em computadores e dispositivos móveis. Exemplos simples incluem um link profundo de aplicativo móvel para o Facebook para fazer login, um link profundo de endereço de email para um aplicativo de email para redigir uma mensagem ou um link profundo de um site para uma loja de aplicativos para baixar um aplicativo móvel relacionado. Como vários aplicativos podem ser necessários para concluir o trabalho no local, uma organização pode permitir que os técnicos criem links profundos no aplicativo móvel Dynamics 365 Field Service para outros aplicativos e vice-versa.

Abrir um registro da entidade ou exibição da lista de entidades no aplicativo móvel

Você pode abrir uma exibição entityrecord ou entitylist no aplicativo móvel Dynamics 365 Field Service usando URLs de link profundo de outros aplicativos. Quando você segue o link de um aplicativo externo, o elemento de destino é aberto na experiência móvel do Field Service.

Se você já estiver conectado à sua instância no aplicativo, o registro de destino será exibido quando você seguir o link de um aplicativo externo. Caso contrário, você será solicitado a efetuar login em sua instância no aplicativo móvel; depois que você entrar, o elemento de destino será exibido. Você deve ter o aplicativo móvel Field Service para usar esse recurso.

Parâmetros de cadeia de consulta para o URL

Use o seguinte manipulador de aplicativos e parâmetros de cadeia de consulta para compor o URL.

Os links profundos para o Field Service devem começar com o seguinte:

ms-apps-fs://<org-url>_<app-id>?tenantId=<tenant-id>&isShortcut=true&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

Parâmetro Descrição
<org-url> Conecta-se ao URL da organização correto
<app-id> Abre o módulo de aplicativo correto
tenantId Conecta-se ao locatário correto
forceOfflineDataSync Garante que a sincronização de dados seja acionada para que todos os dados mais recentes estejam disponíveis

Ao abrir um formulário entityrecord ou criar um novo entityrecord, use os seguintes parâmetros.

Parâmetro Descrição
etn=<entity-logical-name> Designa a qual entidade ir
pagetype=entityrecord Indica que o destino é um formulário
extraqs=<form-id> Designa qual formulário abrir para o entityrecord; se não for especificado, o formulário padrão será aberto. O parâmetro extraqs também pode ser usado para valores de campo padrão.
id=<record-id> Designa para qual registro específico ir; se deixado em branco, o formulário de criação da entidade será aberto

Se o link for para um exibição entitylist, adicione os seguintes parâmetros.

Parâmetro Descrição
etn=<entity-logical-name> Designa a qual entidade ir
pagetype=entitylist Indica que estamos indo para uma exibição
viewid=<view-id> Designa qual exibição abrir
Viewtype= <1039 se for uma exibição do sistema e 4230 se for uma exibição pessoal> Determina se estamos indo para uma exibição do sistema ou exibição pessoal

URLs de exemplo

Ação Exemplo de URL de link profundo
Abrir um formulário de criação para reserva de recursos que podem ser reservados ms-apps-fs:// <org-url>_<app-id>?tenantId=<tenant-id>&isShortcut=true&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true&etn=bookableresourcebooking&pagetype=entityrecord&id=
Abrir uma reserva de recurso que pode ser reservado com id=xyz ms-apps-fs:// <org-url>_<app-id>?tenantId=<tenant-id>&isShortcut=true&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true&etn=bookableresourcebooking&pagetype=entityrecord&id=xyz