Power Apps モバイル アプリとのディープリンクを使用する
ディープ リンクを使用すると、ユーザーはコンピューターやモバイル デバイスで、あるアプリケーションから別のアプリケーションに移動できます。 簡単な例には、モバイル アプリの Facebook へログインするためのディープリンク、メール アプリがメッセージを作成するためのメール アドレスのディープリンク、または関連するモバイル アプリをダウンロードするためのウェブサイトからアプリ ストアへのディープリンクがあります。
Power Apps モバイル アプリで対応しているディープリンク
他のアプリからのディープ リンク 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
| パラメーター | 説明設定 |
|---|---|
| <対象アプリ> |
|
| <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 で直接開くようにします。