Skip to content

Commit 5f3a7f9

Browse files
sericks007sericks007
authored
Merge pull request #8914 from MicrosoftDocs/sitarampemmaraju-patch-1
Update mobile-deep-links.md
2 parents 3b7219b + abcf413 commit 5f3a7f9

File tree

1 file changed

+27
-24
lines changed

1 file changed

+27
-24
lines changed

‎powerapps-docs/mobile/mobile-deep-links.md

Lines changed: 27 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: How to configure deep links for Power Apps mobile.
44
author: trdehove
55
ms.component: pa-user
66
ms.topic: quickstart
7-
ms.date: 11/10/2023
7+
ms.date: 11/16/2023
88
ms.subservice: mobile
99
ms.author: trdehove
1010
ms.custom: ""
@@ -15,7 +15,8 @@ search.audienceType:
1515
searchScope:
1616
- "Power Apps"
1717
contributors:
18-
- anuitz
18+
- anuitz
19+
- sitarampemmaraju
1920
---
2021

2122
# Use deep links with the Power Apps mobile app
@@ -24,65 +25,67 @@ Deep links let users move from one application to another on computers and mobil
2425

2526
## Supported deep links in the Power Apps mobile app
2627

27-
You can open an `entityrecord` or an `entitylist` view in Power Apps mobile by using deep-link URLs from other apps. When you follow the link from an external app, the target element opens in Power Apps mobile
28+
You can open an `entityrecord` or an `entitylist` view in the Power Apps mobile app by using deep-link URLs from other apps. When you follow the link from an external app, the target element opens in Power Apps mobile
2829

29-
If you're already signed in to your instance in the app, the target record is displayed when you follow the link from an external app. Otherwise, you're prompted to sign in to your instance in the mobile app; after you're signed in, the target element is displayed. You must have Power Apps mobile installed on your mobile device to use this feature.
30+
If you're already signed in to your instance in the app, the target record is displayed when you follow the link from an external app. Otherwise, you're prompted to sign in to your instance in the mobile app; after you're signed in, the target element is displayed. You must have the Power Apps mobile app installed on your mobile device to use this feature.
3031

3132
## Supported Urls parameters for a model-driven app
3233

3334
Use the following application handler and query string parameters to compose the URL.
3435

35-
Deep links for Power Apps mobile should start with the following:
36+
Deep links for the Power Apps mobile app should start with the following:
3637

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

3940
| **Parameter** | **Description** |
4041
|----------------------|------------------------------------------------------------------------------|
4142
| &lt;targeted-app&gt; | <ul><li>`ms-dynamicsxrm` -> Dynamics 365 for phones</li><li> `ms-apps-fs` -> Field Service</li><li>`ms-apps` -> Power Apps</li><li>`ms-mobile-apps` -> wrapped native mobile apps</li> |
42-
| &lt;org-url&gt; | Connects to the correct org URL |
43-
| &lt;app-id&gt; | Opens the correct app module |
44-
| tenantId | Connects to the correct tenant |
45-
| forceOfflineDataSync | Ensures that data sync is triggered so that all the latest data is available |
43+
| &lt;org-url&gt; | Connects to the correct org URL. |
44+
| &lt;app-id&gt; | Opens the correct app module. |
45+
| tenantId | Connects to the correct tenant. |
46+
| forceOfflineDataSync | Ensures that data sync is triggered so that all the latest data is available. |
4647

4748

4849
If opening an `entityrecord` form or creating a new `entityrecord`, use the following parameters:
4950

5051
| **Parameter** | **Description** |
5152
|---------------------------------|--------------------------------------------------------------------------------------------------------|
52-
| etn=&lt;entity-logical-name&gt; | Designates which table to go to |
53-
| pagetype=entityrecord | Indicates that the target is a form |
54-
| extraqs=&lt;form-id&gt; | Designates which form to open for the `entityrecord`; if not specified, the default form will open. The `extraqs` parameter can also be used to default field values. |
55-
| id=&lt;record-id&gt; | Designates which specific record to go to; if left blank, the create form for the table will open |
53+
| etn=&lt;entity-logical-name&gt; | Designates which table to go to. |
54+
| pagetype=entityrecord | Indicates that the target is a form. |
55+
| extraqs=&lt;form-id&gt; | Designates which form to open for the `entityrecord`; if not specified, the default form opens. The `extraqs` parameter can also be used to default field values. |
56+
| id=&lt;record-id&gt; | Designates which specific record to go to; if left blank, the create form for the table opens. |
5657

5758
If the link goes to an `entitylist` view, add the following parameters:
5859

5960
| **Parameter** | **Description** |
6061
|--------------------------------------------------------------|---------------------------------------------------------------------|
61-
| etn=&lt;entity-logical-name&gt; | Designates which table to go to |
62-
| pagetype=entitylist | Indicates that we're going to a view |
63-
| viewid=&lt;view-id&gt; | Designates which view to open |
64-
| Viewtype= &lt;1039 if system view, 4230 if personal view&gt; | Designates whether we're going to a system view or a personal view |
62+
| etn=&lt;entity-logical-name&gt; | Designates which table to go to. |
63+
| pagetype=entitylist | Indicates that we're going to a view. |
64+
| viewid=&lt;view-id&gt; | Designates which view to open. |
65+
| Viewtype= &lt;1039 if system view, 4230 if personal view&gt; | Designates whether we're going to a system view or a personal view. |
6566

6667
## Supported Urls parameters for a canvas app
6768

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

7071
| **Parameter** | **Description** |
7172
|----------------------|----------------------------------------------------------------------------------------------|
72-
| &lt;app-id&gt; | Opens the correct app module |
73-
| &lt;tenantId&gt; | Connects to the correct tenant |
74-
| restartApp=true | Restarts the canvas app, needed to ensure parameters are passed when the app is already open |
75-
73+
| &lt;app-id&gt; | Opens the correct app module. |
74+
| &lt;tenantId&gt; | Connects to the correct tenant. |
75+
| restartApp=true | Restarts the canvas app, needed to ensure parameters are passed when the app is already open. |
76+
| autoLoginUpn=&lt;e-mail&gt; | Autopopulates e-mail and triggers sign-in. |
77+
7678
## Supported Urls parameters for a wrapped native mobile app
7779

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

8082
| **Parameter** | **Description** |
8183
|----------------------|----------------------------------------------------------------------------------------------|
82-
| &lt;app-id&gt; | Opens the correct app module |
83-
| &lt;tenantId&gt; | Connects to the correct tenant |
84+
| &lt;app-id&gt; | Opens the correct app module. |
85+
| &lt;tenantId&gt; | Connects to the correct tenant. |
8486
| restartApp=true | Restarts the canvas app to ensure parameters are passed when the app is already open. |
85-
87+
| autoLoginUpn=&lt;e-mail&gt; | Autopopulates e-mail and triggers sign-in. |
88+
8689
## Troubleshooting
8790

8891
Deeplinks may open in your browser depending on the company's organizational policies and the user's device settings. Mobile Device Management (MDM) tools and device operating systems have different options and settings that impact how deeplinks are handled. If deeplinks are opening in a browser instead of directly in Power Apps mobile, make sure your MDM policies and device settings are appropriately configured.

0 commit comments

Comments
 (0)