Share via

Dieptekoppelingen gebruiken met de mobiele Power Apps-app

  • Artikel

Met dieptekoppelingen kunnen gebruikers van de ene toepassing naar de andere gaan op computers en mobiele apparaten. Eenvoudige voorbeelden zijn onder meer een mobiele app die een dieptekoppeling tot stand brengt met Facebook om aan te melden, een e-mailadres dat een dieptekoppeling naar een mail-app maakt om een bericht op te stellen of een website die een dieptekoppeling naar een app store maakt om een gerelateerde mobiele app te downloaden.

U kunt een entityrecord of een entitylist-weergave openen in de mobiele Power Apps-app door URL's voor dieptekoppeling te gebruiken vanuit andere apps. Wanneer u de koppeling van een externe app volgt, wordt het doelelement geopend in Power Apps Mobile

Als u al bent aangemeld bij uw exemplaar in de app, wordt de doelrecord weergegeven wanneer u de koppeling volgt vanuit een externe app. Anders wordt u gevraagd om zich aan te melden bij uw exemplaar in de mobiele app. Nadat u bent aangemeld, wordt het doelelement weergegeven. U moet de mobiele Power Apps-app hebben geïnstalleerd op uw mobiele apparaat om deze functie te kunnen gebruiken.

Ondersteunde URL-parameters voor een modelgestuurde app

Gebruik de volgende toepassingshandler en querytekenreeksparameters om de URL samen te stellen.

Dieptekoppelingen voor de mobiele Power Apps-app moeten beginnen met het volgende:

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

Belangrijk

De org-URL mag niet https:// bevatten. Hier volgt een voorbeeld van een deeplink voor een modelgestuurde app:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Parameter Omschrijving
<doel-app>
  • ms-dynamicsxrm -> Dynamics 365 voor telefoons
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> verpakte native mobiele apps
<org-url> Maakt verbinding met de juiste organisatie-URL.
<app-id> Opent de juiste appmodule.
tenantId Maakt verbinding met de juiste tenant.
forceOfflineDataSync Zorgt ervoor dat gegevenssynchronisatie wordt geactiveerd, zodat alle nieuwste gegevens beschikbaar zijn.

Gebruik bij het openen van een entityrecord-formulier of het maken van een nieuwe entityrecord de volgende parameters:

Parameter Omschrijving
etn=<entity-logical-name> Geeft aan naar welke tabel moet worden gegaan.
pagetype=entityrecord Geeft aan dat het doel een formulier is.
extraqs=<form-id> Geeft aan welk formulier moet worden geopend voor de entityrecord. Indien niet opgegeven, wordt het standaardformulier geopend. De parameter extraqs kan ook worden gebruikt voor standaard veldwaarden.
id=<record-id> Geeft aan naar welk specifiek record moet worden gegaan. Indien leeg gelaten, wordt het formulier voor het maken van de entiteit geopend.

Als de koppeling naar een entitylist-weergave gaat, voegt u de volgende parameters toe:

Parameter Omschrijving
etn=<entity-logical-name> Geeft aan naar welke tabel moet worden gegaan.
pagetype=entitylist Geeft aan dat we naar een weergave gaan.
viewid=<view-id> Geeft aan welke weergave moet worden geopend.
Viewtype= <1039 bij een systeemweergave, 4230 bij een persoonlijke weergave> Geeft aan of we naar een systeemweergave gaan of naar een persoonlijke weergave.

Ondersteunde URL-parameters voor een canvas-app

ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Parameter Omschrijving
<app-id> Opent de juiste appmodule.
<tenantId> Maakt verbinding met de juiste tenant.
restartApp=true Start de canvas-app opnieuw op, dit is nodig om ervoor te zorgen dat parameters worden doorgegeven wanneer de app al is geopend.
autoLoginUpn=<e-mail> Vult e-mail automatisch in en activeert aanmeldingsgegevens.

Ondersteunde URL-parameters voor een verpakte native mobiele app

ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Parameter Omschrijving
<app-id> Opent de juiste appmodule.
<tenantId> Maakt verbinding met de juiste tenant.
restartApp=true Start de canvas-app opnieuw om ervoor te zorgen dat parameters worden doorgegeven wanneer de app al is geopend.
autoLoginUpn=<e-mail> Vult e-mail automatisch in en activeert aanmeldingsgegevens.

Probleemoplossing

Deeplinks kunnen in uw browser worden geopend, afhankelijk van het organisatiebeleid van het bedrijf en de apparaatinstellingen van de gebruiker. Mobile Device Management (MDM)-tools en besturingssystemen van apparaten hebben verschillende opties en instellingen die van invloed zijn op de manier waarop deeplinks worden afgehandeld. Als deeplinks in een browser worden geopend in plaats van rechtstreeks in Power Apps mobiel, moet u ervoor zorgen dat uw MDM-beleid en apparaatinstellingen correct zijn geconfigureerd.

Een voorbeeld, op sommige Android- apparaten, ga naar Instellingen > Apps > Power Apps > Standaard geopend en voeg apps.powerapps.com toe om deeplinks rechtstreeks in Power Apps mobiel te openen.