共用方式為


使用 Power Apps 行動裝置應用程式的深層連結。

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

您可以使用來自其他應用程式的深層連結 URL,在 Power Apps 行動裝置應用程式中開啟 entityrecordentitylist 檢視。 當您從外部應用程式點選連結時,目標元素會在 Power Apps 行動裝置應用程式中開啟。

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

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

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

Power Apps 行動裝置應用程式的深層連結應該以以下字串開始:

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

重要

組織 url 不能包含 https://。 以下是模型導向應用程式深層連結的範例:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=aaaabbbb-0000-cccc-1111-dddd2222eeee&environmentId=g67tfyufhkjfg&appLogicalName=cr12_e567

參數 描述 必填
<目標應用程式>
  • ms-dynamicsxrm - > 行動電話用 Dynamics 365
  • ms-apps-fs -> 現場服務
  • ms-apps -> Power Apps
  • ms-mobile-apps - > 包裝的原生行動應用程式。
.是
<組織網址> 連接至正確的組織 URL。 .是
<應用程式識別碼> 開啟正確的應用程式模組。 .是
tenantId=<tenand-id> 連接至正確的租用戶。 .是
*環境Id=<環境ID> 唯一識別租用戶內的環境。 .是
*appLogicalName=<應用程式邏輯名稱> 應用程式的唯一名稱。 如需如何在新式工作室中尋找應用程式的唯一名稱的詳細資訊,請參閱 在應用程式設計工具中管理模型導向應用程式設定 ,對於傳統編輯器,請參閱在 應用程式設計工具中管理模型導向應用程式屬性 (傳統) .是
appType=AppModule 指示目標應用程式是模型導向應用程式。 .是
restartApp=true 重新啟動模型導向應用程式。 需要確保在應用程式已開啟時傳遞參數。
autoLoginUpn=<電子郵件> 自動填入電子郵件並觸發登入。

注意:如果使用者已登入應用程式,則會忽略此參數。
forceOfflineDataSync=true 確保已觸發資料同步,讓所有的最新資料皆可使用。

* 注意事項

  • 環境 ID 和 appLogicalName 對於所有新的深層連結都是必要的。
  • 在 2025 年 12 月之前,沒有環境 ID 或 appLogicalName 的現有深層連結效能會變慢,之後將不再支援。
  • 更新所有現有的深層連結,以包含環境識別碼和 appLogicalName,以改善效能並減少等待時間。

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

參數 描述 必填
etn=<實體邏輯名稱> 指定要移至哪個資料表。 .是
pagetype=entityrecord 表示目標是表單。 .是
id=<記錄 ID> 指定要移至的特定記錄;如果留空,則會開啟表格的建立表單。 .是
extraqs=<表單 ID> 指定要為 entityrecord 開啟哪個表單;如果未指定,則開啟預設表單。 extraqs 參數還可以用於預設欄位值。

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

參數 描述 必填
etn=<實體邏輯名稱> 指定要移至哪個資料表。 .是
pagetype=entitylist 表示我們要移至檢視表。 .是
viewid=<視圖 ID> 指定要開啟哪個檢視表。
Viewtype= <1039 (若為系統檢視表)、4230 (若為個人檢視表)> 指示目標檢視是系統檢視還是個人檢視。

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

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

參數 描述 必填
<應用程式識別碼> 開啟正確的應用程式模組。 .是
tenantId=<租戶ID> 連接至正確的租用戶。 .是
*環境Id=<環境ID> 唯一識別租用戶內的環境。 .是
restartApp=true 重新啟動 Canvas 應用程式。 需要確保在應用程式已開啟時傳遞參數。
autoLoginUpn=<電子郵件> 自動填入電子郵件並觸發登入。

注意:如果使用者已登入應用程式,則會忽略此參數。

* 注意事項

  • 環境 ID 對於所有新的深層連結都是必要的。

  • 在 2025 年 12 月之前,沒有環境 ID 的現有深層連結效能會變慢,之後將不再支援。

  • 更新所有現有的深層連結,以包含環境 ID,以改善效能並減少等待時間。

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

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

重要

包裝應用程式的深層連結網址只有在行動裝置上安裝了一個包裝應用程式時才有效。 如果安裝了多個封裝應用程式,就無法使用。

參數 描述 必填
<應用程式識別碼> 開啟正確的應用程式模組。 .是
tenantId=<租戶ID> 連接至正確的租用戶。 .是
restartApp=true 重新啟動模型導向應用程式。 需要確保在應用程式已開啟時傳遞參數。
autoLoginUpn=<電子郵件> 自動填入電子郵件並觸發登入。

注意:如果使用者已登入應用程式,則會忽略此參數。

疑難排解​​

深層連結可以在瀏覽器中開啟,具體取決於公司的組織政策和使用者的裝置設定。 行動裝置管理 (MDM) 工具和裝置作業系統具有不同的選項和設定,會影響深層連結的處理方式。 如果深層連結是在瀏覽器中開啟,而不是直接在 Power Apps 行動版中開啟,請確定您的 MDM 原則和裝置設定已正確設定。

例如,在某些 Android 裝置上,移至 設定>應用程式>Power Apps>預設開啟 ,並新增 apps.powerapps.com 以直接在 Power Apps 行動版中開啟深層連結。

另請參閱

即將推出的重要變更 (停用) 於畫布應用程式中