ディープ リンクを使用すると、ユーザーはコンピューターやモバイル デバイスで、あるアプリケーションから別のアプリケーションに移動できます。 簡単な例には、モバイル アプリの 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>&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
| パラメーター | 説明 | 必須 |
|---|---|---|
| <対象アプリ> |
|
あり |
| <org-url> | 正しい組織の URL に接続します。 | あり |
| <app-id> | 正しいアプリ モジュールを開きます。 | あり |
| tenantId=<tenand-id> | 正しいテナントに接続します。 | あり |
| *environmentId=<environment-id> | テナント内の環境を一意に識別します。 | あり |
| *appLogicalName=<app-logical-name> | アプリの一意の名前。 モダン スタジオでアプリのこの一意の名前を見つける方法の詳細については、「アプリ デザイナーでモデル駆動型アプリ設定を管理する」を参照してください。クラシック エディターについては、アプリ デザイナー (クラシック) でモデル駆動型アプリのプロパティを管理するを参照してください | あり |
| appType=AppModule | ターゲット アプリがモデル駆動型アプリであることを示します。 | 可 |
| restartApp=true | モデル駆動型アプリを再起動します。 アプリが既に開いているときにパラメーターが渡されるようにするために必要です。 | いいえ |
| autoLoginUpn=<e-mail> | メールを自動入力し、サインインをトリガーします。 注: ユーザーが既にアプリにサインインしている場合、このパラメーターは無視されます。 |
いいえ |
| forceOfflineDataSync=true | すべての最新データが利用できるように、データ同期が確実にトリガーされます。 | いいえ |
* 考慮 事項
- すべての新しいディープ リンクには、環境 ID と appLogicalName が必須です。
- 環境 ID または appLogicalName のない既存のディープ リンクでは、2025 年 12 月までパフォーマンスが低下し、その後はサポートされません。
- パフォーマンスを向上させ、待機時間を短縮するために、環境 ID と appLogicalName を含むように、既存のすべてのディープ リンクを更新します。
entityrecord のフォームを開く場合、または entityrecord を新規に作成する場合は、以下のパラメータを使用します:
| パラメーター | 説明 | 必須 |
|---|---|---|
| etn=<エンティティ論理名> | どのテーブルに移動するかを指定します。 | あり |
| pagetype=entityrecord | 対象がフォームであることを示します。 | あり |
| id=<record-id> | 移動先の特定のレコードを指定します。空白のままにすると、テーブルの作成済みフォームが開きます。 | あり |
| extraqs=<form-id> |
entityrecord でどのフォームを開くかを指定します。指定しない場合は、既定のフォームが開きます。
extraqs パラメータは、フィールド値を既定とする目的でも使用できます。 |
いいえ |
リンクが entitylist ビューに行く場合、次のパラメータを追加します:
| パラメーター | 説明 | 必須 |
|---|---|---|
| etn=<エンティティ論理名> | どのテーブルに移動するかを指定します。 | あり |
| pagetype=entitylist | ビューに移動することを示します。 | あり |
| viewid=<view-id> | 開くビューを指定します。 | いいえ |
| システムビューの場合、Viewtype= <1039、パーソナルビューの場合 4230> | 対象ビューがシステム ビューか個人用ビューかを示します。 | いいえ |
キャンバス アプリでサポートされている URL パラメーター
ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&environmentId=<environment-id>&restartApp=true
| パラメーター | 説明 | 必須 |
|---|---|---|
| <アプリID> | 正しいアプリ モジュールを開きます。 | あり |
| tenantId=<tenantId> | 正しいテナントに接続します。 | あり |
| *environmentId=<environment-id> | テナント内の環境を一意に識別します。 | あり |
| restartApp=true | キャンバス アプリを再起動します。 アプリが既に開いているときにパラメーターが渡されるようにするために必要です。 | いいえ |
| autoLoginUpn=<e-mail> | メールを自動入力し、サインインをトリガーします。 注: ユーザーが既にアプリにサインインしている場合、このパラメーターは無視されます。 |
いいえ |
* 考慮 事項
環境 ID は、すべての新しいディープ リンクに必須です。
環境 ID のない既存のディープ リンクでは、2025 年 12 月までパフォーマンスが低下し、その後はサポートされません。
パフォーマンスを向上させ、待機時間を短縮するために、既存のすべてのディープ リンクを更新して環境 ID を含めます。
ラップされたネイティブ モバイル アプリでサポートされている URL パラメーター
ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true
重要
ラップされたアプリのディープ リンク URL は、ラップされた 1 つのアプリがモバイル デバイスにインストールされている場合にのみ機能します。 複数のラップされたアプリがインストールされている場合は機能しません。
| パラメーター | 説明 | 必須 |
|---|---|---|
| <app-id> | 正しいアプリ モジュールを開きます。 | あり |
| tenantId=<tenantId> | 正しいテナントに接続します。 | あり |
| restartApp=true | モデル駆動型アプリを再起動します。 アプリが既に開いているときにパラメーターが渡されるようにするために必要です。 | いいえ |
| autoLoginUpn=<e-mail> | メールを自動入力し、サインインをトリガーします。 注: ユーザーが既にアプリにサインインしている場合、このパラメーターは無視されます。 |
いいえ |
トラブルシューティング
会社の組織ポリシーとユーザーのデバイス設定に応じて、ブラウザーでディープ リンクを開くことができます。 モバイル デバイス管理 (MDM) ツールとデバイス オペレーティング システムには、ディープ リンクの処理方法に影響するさまざまなオプションと設定があります。 Power Apps モバイルで直接ではなく、ブラウザーでディープ リンクが開いている場合は、MDM ポリシーとデバイス設定が適切に構成されていることを確認します。
たとえば、一部の Android デバイスでは>Apps>Power Apps>既定で開く] に移動し、power Apps モバイルで直接ディープ リンクを開く apps.powerapps.com を追加します。