對 Power Apps 行動應用程式使用深層連結

  • 發行項

深層連結可讓使用者在電腦和行動裝置上從一個應用程式移到另一個應用程式。 簡單的範例包括行動應用程式深層連結至 Facebook 以登入、電子郵件地址深層連結至郵件應用程式以撰寫訊息，或網站深層連結至應用程式市集以下載相關的行動應用程式。

您可以使用其他應用程式的深層連結 URL，在 Power Apps 行動應用程式中開啟 entityrecord 或 entitylist 檢視表。 當您從外部應用程式連入連結時，目標元素會在 Power Apps 行動版中開啟

如果您已經登入應用程式中的執行個體，則會在您從外部應用程式連入連結時顯示目標記錄。 否則，系統會提示您登入您在行動應用程式中的執行個體；登入後，會顯示目標元素。 您必須已在行動裝置上安裝 Power Apps 行動應用程式，才能使用此功能。

模型導向應用程式支援的 URL 參數

使用下列應用程式處理常式和查詢字串參數來撰寫 URL。

Power Apps 行動應用程式的深層連結必須以下列參數開頭：

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

重要

組織 url 不能包含 https://。 以下是模型導向應用程式深層連結的範例：
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

參數 Description
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 for phones
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> 裝合原生行動應用程式
<org-url> 連接至正確的組織 URL。
<app-id> 開啟正確的應用程式模組。
tenantId 連接至正確的租用戶。
forceOfflineDataSync 確保已觸發資料同步，讓所有的最新資料皆可使用。

如果要開啟 entityrecord 表單或建立新的 entityrecord，請使用下列參數：

參數 Description
etn=<entity-logical-name> 指定要移至哪個資料表。
pagetype=entityrecord 表示目標是表單。
extraqs=<form-id> 指定要為 entityrecord 開啟哪個表單；如果未指定，則開啟預設表單。 extraqs 參數還可以用於預設欄位值。
id=<record-id> 指定要移至哪個特定記錄；如果保留空白，則開啟實體的建立表單。

如果連結會前往 entitylist 檢視表，請新增下列參數：

參數 Description
etn=<entity-logical-name> 指定要移至哪個資料表。
pagetype=entitylist 表示我們要移至檢視表。
viewid=<view-id> 指定要開啟哪個檢視表。
Viewtype= <1039 (若為系統檢視表)、4230 (若為個人檢視表)> 指定要前往的是系統檢視表還是個人檢視表。

畫布應用程式支援的 URL 參數

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

參數 Description
<app-id> 開啟正確的應用程式模組。
<tenantId> 連接至正確的租用戶。
restartApp=true 重新啟動可確保已在應用程式開啟時傳遞參數所需的畫布應用程式。
autoLoginUpn=<電子郵件> 自動填入電子郵件並觸發登入。

裝合原生行動應用程式支援的 URL 參數

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

參數 Description
<app-id> 開啟正確的應用程式模組。
<tenantId> 連接至正確的租用戶。
restartApp=true 重新啟動畫布應用程式，以確保參數在應用程式已開啟時傳遞。
autoLoginUpn=<電子郵件> 自動填入電子郵件並觸發登入。

疑難排解​​

根據公司的組織原則和使用者的裝置設定，Deeplinks 可能會在您的瀏覽器中打開。 行動裝置管理 (MDM) 工具和裝置作業系統具有會影響 deeplinks 處理方式的不同選項和設定。 如果 deeplinks 是在瀏覽器中打開，而不是直接在行動裝置版 Power Apps 中打開，請確認您的 MDM 原則和設備設定已正確設定。

例如，在某些 Android 裝置上，請移至設定 > 應用程式 > Power Apps > 預設打開，並新增 apps.powerapps.com ，讓 deeplinks 直接在行動裝置版 Power Apps 中打開。