Power Apps の Launch および Param 関数

Web ページまたはキャンバス アプリを起動し、起動パラメーターへのアクセスを提供します。

Launch

Web ページまたはキャンバス アプリを起動します。 関数は次のものをサポートしています。

  • Address (必須)、Web ページの URL またはキャンバス アプリのアプリ ID。
  • Parameters (オプション) Web ページまたはキャンバス アプリに渡す名前付きの値。 キャンバス アプリでは、Param 関数によってパラメーターを読み込みます。
  • Target (オプション)、Web ページまたはキャンバス アプリを起動するブラウザー タブ。

Launch は、動作の数式 内でのみ使用できます。

アドレス

Web ページは URL アドレスを介して起動されます。 たとえば、次のようなものです。

Launch( "https://bing.com" )

Web リンク または アプリ ID を使用してキャンバス アプリを起動できます。 アプリのこれらの値を検索するには、次を実行してください。

  1. Power Apps に移動します。

  2. 左側のナビゲーション ウィンドウから、アプリ を選択します。

  3. アプリを選択します。

  4. 上部メニューから 詳細 を選択します。
    また、... (その他のコマンド) を選択し、ドロップダウン メニューから 詳細 を選択します。

    アプリの詳細オプション

  5. Web リンク または アプリ ID をコピーします。

    Web リンクとアプリ ID を含むアプリの詳細

Web リンク はすべての Web ページで使用することができ、キャンバス アプリを起動できます。 Launch 関数を使用することもできます。

アプリ IDLaunch 関数で使用できますが、先頭に /providers/Microsoft.PowerApps/apps/ を付ける必要があります。 たとえば、次のようなものです。

Launch( "/providers/Microsoft.PowerApps/apps/f342faaf-5f82-4ace-a64b-7c1b01499231" )

デバイス上のネイティブ アプリを直接起動することはできません。 特定の Web サイトにオプションを提供するためのカスタム URL スキームのインストール、または Web ブラウザーへの登録を行うネイティブ アプリなど、一部のプラットフォームでは間接的なオプションが利用可能な場合があります。

パラメーター

Launch は Web ページまたはキャンバス アプリにパラメーターを渡すことができます。 パラメーターは 2 つの方法で提供されます。

  • 名前値のペアの引数リスト。 たとえば、次のようなものです。

    Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )
    
  • フィールド値のレコード。 たとえば、次のようなものです。

    Launch( "http://bing.com/search", { q: "Power Apps", count: 1 } )
    

    このフォームにより、名前と値の関連付けが明確になり、操作が簡単になります。 オプションの LaunchTarget 引数をサポートする唯一のフォームです。

注意

現在、パラメーターのレコード オプションは プレビュー段階 で、間もなくすべてのリージョンでリリースされます。 プレビュー機能の詳細については、実験、プレビュー、および廃止された Power Apps の機能について に移動してください。

アドレスおよびパラメーターは渡される前に URL エンコードされ、EncodeUrl 関数が使用されたかのように英数字以外の文字および % と 16 進数で置き換えられます。

Web ページを起動するとき、パラメーターの クエリ文字列 が URL アドレスの最後に含められます。 Launch に提供される追加のパラメーターすべては、クエリ文字列の最後に追加されます。 キャンバス アプリの起動時は、クエリ文字列は機能しません。

対象

注意

現在、LaunchTarget 引数は プレビュー段階 で、間もなくすべてのリージョンでリリースされます。 プレビュー機能の詳細については、実験、プレビュー、および廃止された Power Apps の機能について に移動してください。

LaunchTarget 引数を使用して、Web ページまたはアプリを開くターゲット ブラウザー ウィンドウを指定します。 次の LaunchTarget 列挙値またはカスタムウィンドウ のいずれかを使用します。

LaunchTarget enum 内容
新規 Web ページまたはアプリは、新しいウィンドウまたはタブで開かれます。
置換 Web ページまたはアプリは、現在のウィンドウまたはタブを置き換えます。
名前 列挙値の代わりに、独自のテキスト文字列を使用してウィンドウまたはタブに 名前 を付けます。自分 は、Launch 関数でのみ使用される内部専用の名前です。 ユーザーに表示されるウィンドウのタイトルには影響せず、照合もしません。 指定された 名前 のウィンドウまたはタブは既に存在しているので、その内容は置き換えられます。 それ以外の場合、新しいウィンドウまたはタブが作成されます。 name は、アンダースコア文字で始まることはできません。

新着 は、利用可能なオプションとして 交換 そして 名前 で Web ブラウザーで実行する場合のデフォルトの列挙型です。 モバイル プレーヤーでは、利用可能なオプションとして 名前 を持つ 新着 を含む Web ページのデフォルトです。一方、現在のキャンバス アプリは常に別のキャンバス アプリに置き換えられます。

注意

  • 組み込みシナリオ (たとえば、Power BI や SharePoint) で 新着 以外の値を持つ LaunchTarget を使うことはサポートされておらず、予期しない動作が発生する可能性があります。 将来的には、この挙動が更新される可能性もありますが、依然としてエラーとなる可能性もあります。

セキュリティ ゾーン

Internet Explorer およびクラシック Microsoft Edge では、セキュリティ設定が呼び出しアプリ以上の場合にのみ、Launch 関数は Web サイトまたはキャンバス アプリを開きます。

たとえば、Launch 関数を 信頼済みサイト セキュリティ ゾーンで実行するアプリに追加する場合、関数を開きたい Web サイトまたはアプリが (制限付きサイト ではなく) 信頼済みサイト または ローカル イントラネット ゾーンにあることを確認してください。 詳細については、Internet Explorer 11 のセキュリティとプライバシーの設定を変更する を参照してください。

Param

Param 関数は、アプリに渡されたパラメーターをアプリの起動時に取得します。 名前付きパラメーターが渡されていなかった場合、Param空白 を返します。

  • 別のキャンバス アプリからキャンバス アプリを起動する場合、Launch 関数に Parameter 引数を使用します。 パラメーターの名前と値は自動的に URL エンコードされます。
  • Web ページからキャンバス アプリを起動する場合、パラメーターを キャンバス アプリの Web リンククエリ文字列 に追加します。 これには、クエリ文字列がすでに tenantId に対して開始されていると仮定した &parametername=parametervalue を追加することが含まれます。 たとえば、&First%20Name=Vicki&category=3 を追加すると、値が "Vicki"First Name と値が "3" (値の型は テキスト) の category の 2 つのパラメーターを渡します。 空白または特殊文字が含まれている場合、EncodeURL 関数の使用と同じように、パラメーターの名前および値を URL エンコードする必要があります。
  • Param 名は大文字と小文字が区別されます。
  • Param 名および値は、アプリで使用できるように自動的に URL デコードされます。
  • パラメーターに数値が含まれている場合でも、Param から返される型は常にテキスト文字列になります。 その他の型への変換は自動的に行われるか、または明示的に数値に変換する Value 関数などの、明示的な変換を使用します。

構文

Launch( Address [, ParameterName1, ParameterValue1, ... ] )

  • Address – 必須。 起動する Web ページのアドレスまたはアプリ ID。
  • ParameterName(s) – 省略可能。 パラメーター名。
  • ParameterValue(s) – 省略可能。 アプリまたは Web ページに渡す、対応するパラメーター値。

Launch( Address, { [ ParameterName1: ParameterValue1, ... ] } [, LaunchTarget ] )

  • Address – 必須。 起動する Web ページのアドレスまたはアプリ ID。
  • ParameterName(s) – 省略可能。 パラメーター名。
  • ParameterValue(s) – 省略可能。 アプリまたは Web ページに渡す、対応するパラメーター値。
  • LaunchTarget – 省略可能. LaunchTarget 列挙値またはカスタム

Param( ParameterName )

  • ParameterName - 必須。 アプリに渡されるパラメーターの名前。

簡単な起動

キャンバス アプリから Web ページへ。

計算式 内容
Launch( "http://bing.com/search", 
"q", "Power Apps", "count", 1 )
Web ページ http://bing.com/search?q=Power%20Apps&count=1 を開きます。 新しいウィンドウまたはブラウザー タブが開かれます。
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 } )
同等のレコード表記を使用している前の例と同じです。 新しいウィンドウまたはブラウザー タブが開かれます。
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 }, 
LaunchTarget.Self )
前の例と同じで、Web ブラウザーで実行している場合、現在のウィンドウまたはタブを結果で置き換えます。
Launch( "http://bing.com/search", 
{ q: "Power Apps", count: 1 }, 
"Search Results" )
前の例と同じように、検索結果 という名前のウィンドウまたはタブのコンテンツを作成または置換します。

キャンバス アプリからキャンバス アプリへ

必要に応じて、アプリ ID、画面名、およびレコード番号を更新します。

Launch( "/providers/Microsoft.PowerApps/apps/YOUR-APP-ID",
        { Navigate: "Second Screen", Record: 34 }
)

Web ページからキャンバス アプリへ

必要に応じて、アプリ ID、テナント ID、画面名、およびレコード番号を更新します。

<html><body>
    <a href="https://apps.powerapps.com/play/YOUR-APP-ID?tenantId=YOUR-TENANT-ID&Navigate=Second%20Screen&Record=34">
        Launch canvas app
    </a>
</body></html>

単純な Param

上記の Web ページから または 別のキャンバス アプリから キャンバス アプリを起動する簡単な起動例は、Param 関数の簡単な例を示しています。

計算式 内容 結果
Param( "Navigate" ) Navigate パラメーターはアプリの起動時に指定され、返されます。 「2 番目の画面」
Param( "Record" ) Record パラメーターはアプリの起動時に指定されます。 Launch 関数に数字として渡されても、Param からの結果は、暗黙的または明示的にその他の型に変換できるテキスト文字列になります。 「34」
Param( "User" ) User パラメーターが指定されていません。 IsBlank 関数でテスト可能な blank 値が返されます。 空白

Launch および Param の例

製品ショーケース タブレット レイアウト テンプレートは、次の例で使用されました。 このテンプレートを使用してアプリを作成するには、アプリの作成 の記事の手順に従い、製品ショーケース テンプレートを選択します。 自分のアプリを使用することもできます。

例 - Launch

  1. Power Apps に移動します。

  2. 左側のナビゲーション ウィンドウから、アプリ を選択します。

  3. アプリを選択し、編集 を選択します。

  4. メニューから 挿入 を選択し、ラベル を選択します。

  5. ラベルを画面右下に移動します。

  6. 右側のプロパティ ウィンドウから、 に選択し、境界線の太さ1 に設定します。

  7. 右側から Text プロパティを選択し、テキストを Surface タブレット ニュース として入力します。

  8. 左上のプロパティ リストから、OnSelect を選択します。

  9. 数式を Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets") と入力します。 その他の使用したい URL、パラメーター、およびキーワードを使用することもできます。

    起動例

  10. アプリを保存し、公開します。

  11. アプリを再生します。

  12. Surface タブレット ニュース のラベルを選択し、Microsoft Surface tablets のキーワードでニュース検索を開始します。

ヒント

スケーラビリティのために、Launch 関数に手動で入力したキーワードを 変数 で置き換えることができます。

例 - Param

  1. Power Apps に移動します。

  2. 左側のナビゲーション ウィンドウから、アプリ を選択します。

  3. アプリを選択し、編集 を選択します。

  4. メニューから 挿入 を選択し、ラベル を選択します。

  5. ラベルを画面右下に移動します。

  6. 左上からラベルの Text プロパティを選択します。

  7. 数式を Param("browser") と入力します。 使用したい異なるパラメーターを使用することもできます。

    Param の例

  8. アプリを保存し、公開します。

  9. Power Apps からアプリの Web リンク をコピーします。

  10. 新しいブラウザーを開きます。

  11. ブラウザーにアプリの Web リンクを貼り付けて、最後に &browser=Microsoft%20Edge を追加します。

    Web アドレス

  12. アプリが起動するとき、ラベルに渡されたパラメーター値が表示されます。

    Param のラベル例

  13. アプリ プレーヤーを閉じ、アプリを編集します。

  14. 左側のナビゲーションのツリー ビューから アプリ を選択します。

  15. 左上の OnStart プロパティを選択します。

  16. 数式を If(Param("screen")="techspecs",Navigate(TechSpecs,Fade)) として入力します。

    ナビゲーションの Param の例

    OnStart プロパティの If 関数 は、パラメーターが特定の値に等しいかどうかをチェックします。この場合、値は techspecs です。 一致する場合、アプリは TechSpecs 画面に移動します。

    注意

    Product Showcase アプリのテンプレートを使用していない場合、Navigate 関数の TechSpecs 画面名を、自分のアプリの画面名で置き換えます。

  17. アプリを保存し、公開します。

  18. 新しいブラウザーを開きます。

  19. ブラウザーにアプリの Web リンクを貼り付けて、最後に &screen=techspecs を追加します。

    TechSpecs 画面の Web アドレス

  20. アプリは、TechSpecs または Navigate 関数で入力した画面で直接起動します。

関連項目

キャンバス アプリの数式のリファレンス