Share via

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

パラメーター 説明設定
<対象アプリ>
  • ms-dynamicsxrm -> 電話用 Dynamics 365
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> ラップされたネイティブ モバイル アプリ
<org-url> 正しい組織の URL に接続します。
<app-id> 正しいアプリ モジュールを開きます。
tenantId 正しいテナントに接続します。
forceOfflineDataSync すべての最新データが利用できるように、データ同期が確実にトリガーされます。

entityrecord のフォームを開く場合、または entityrecord を新規に作成する場合は、以下のパラメータを使用します:

パラメーター 説明設定
etn=<entity-logical-name> どのテーブルに移動するかを指定します。
pagetype=entityrecord 対象がフォームであることを示します。
extraqs=<form-id> entityrecord でどのフォームを開くかを指定します。指定しない場合は、既定のフォームが開きます。 extraqs パラメータは、フィールド値を既定とする目的でも使用できます。
id=<record-id> 移動する特定のレコードを指定します; 空白のままにすると、テーブルの作成フォームが開きます。

リンクが entitylist ビューに行く場合、次のパラメータを追加します:

パラメーター 説明設定
etn=<entity-logical-name> どのテーブルに移動するかを指定します。
pagetype=entitylist ビューに移動することを示します。
viewid=<view-id> 開くビューを指定します。
システムビューの場合、Viewtype= <1039、パーソナルビューの場合 4230> システム ビュー または個人的なビューに移動するかどうかを指定します。

キャンバス アプリでサポートされている URL パラメーター

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

パラメーター 説明設定
<app-id> 正しいアプリ モジュールを開きます。
<tenantId> 正しいテナントに接続します。
restartApp=true キャンバス アプリを再起動します。アプリがすでに開いているときにパラメーターが確実に渡されるようにするために必要です。
autoLoginUpn=<e-mail> メールを自動入力し、サインインをトリガーします。

ラップされたネイティブ モバイル アプリでサポートされている URL パラメーター

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

パラメーター 説明設定
<app-id> 正しいアプリ モジュールを開きます。
<tenantId> 正しいテナントに接続します。
restartApp=true キャンバス アプリを再起動して、アプリがすでに開いているときにパラメーターが確実に渡されるようにします。
autoLoginUpn=<e-mail> メールを自動入力し、サインインをトリガーします。

トラブルシューティング​​

会社の組織ポリシーやユーザーのデバイス設定に応じて、ディープリンクがブラウザーで開く場合があります。 モバイル デバイス管理 (MDM) ツールとデバイス オペレーティング システムには、ディープリンクの処理方法に影響を与えるさまざまなオプションと設定があります。 ディープリンクが直接 Power Apps モバイルではなくブラウザーで開かれている場合は、MDM ポリシーとデバイス設定が適切に構成されていることを確認してください。

例として、一部の Android デバイスでは、設定 > アプリ > Power Apps > デフォルトで開く に移動し、 apps.powerapps.com を追加して、ディープリンクを Power Apps Mobile で直接開くようにします。