Launch 関数と Param 関数

[アーティクル]
03/22/2024

適用先: キャンバスアプリ

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

Launch

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

アドレス (必須)、Web ページの URL またはキャンバスアプリのアプリ URI (/providers/Microsoft.PowerApps/apps/が接頭辞のアプリ ID)。
Parameters (オプション) Web ページまたはキャンバスアプリに渡す名前付きの値。キャンバスアプリでは、Param 関数によってパラメーターを読み込みます。
Target (オプション)、Web ページまたはキャンバスアプリを起動するブラウザータブ。

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

アドレス

Web ページは URL アドレスを介して起動されます。例:

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

Web リンク または アプリ URI (/providers/Microsoft.PowerApps/apps/が接頭辞のアプリ ID) を使用してキャンバスアプリを起動できます。アプリのこれらの値を検索するには、次を実行してください。

Power Apps に移動します。
左側のナビゲーションウィンドウから、アプリを選択します。
アプリを選択します。
上部メニューから詳細を選択します。
また、... (その他のコマンド) を選択し、ドロップダウンメニューから詳細を選択します。
Web リンクまたはアプリ ID をコピーします。

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

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

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

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

パラメーター

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

名前値のペアの引数リスト。たとえば、次のようなものです。
```
Launch( "https://bing.com/search", "q", "Power Apps", "count", 1 )
```
フィールド値のレコード。たとえば、次のようなものです。
```
Launch( "https://bing.com/search", { q: "Power Apps", count: 1 } )
```
このフォームにより、名前と値の関連付けが明確になり、操作が簡単になります。オプションの LaunchTarget 引数をサポートする唯一のフォームです。

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

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

アプリがすでに実行されているモバイルデバイスでアプリを起動すると、実行中のアプリのパラメーターは更新されません。パラメーターを更新するにはアプリのリロードが必要です。

ターゲット

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

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

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

Note

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

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 関数などの、明示的な変換を使用します。

注意

カスタムページの場合、ページで受け入れられるパラメーターは、recordId と entityName だけです。

構文

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 - 必須。アプリに渡されるパラメーターの名前。

予約済みパラメーター

次のキーワードは内部使用のために予約されており (大文字と小文字に関係なく)、Param() 関数のカスタムパラメータとして使用しないでください:

amp%3Bauthmode
amp%3Benableonbehalfof
amp%3Bhidenavbar
amp%3Blocale
appmetadataversion
authmode
channeltype
cordovapath
correlationid
debug
delegatelaunchurl
delegatelaunchurl
disablepreviewredirect
embedderorigin
enableonbehalfof
groupid
hideappsplash
hidenavbar
ヒント
hostclienttype
hostmode
iframecontainerid
isfullscreen
ispreviewmode
loader
loaderType
locale
location
packagekind
packageproperties
playerresourcespath
playersessionid
powerappslanguage
screencolor
sdkversion
サイト
skipappmetadata
skipiframecreation
skiplaunchappcache
ソース
sourcetime
standaloneconsent
teamid
teamtype
tenantId
theme
uselocalpackagehostresources
userteamrole

使用例

簡単な起動

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

式	説明
Launch( "http://bing.com/search", "q", "Power Apps", "count", 1 )	Web ページ https://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.Replace )	前の例と同じで、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/e/YOUR-APP-ENVIRONMENT-ID/a/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 値が返されます。	blank

Launch および Param の例

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

例 - Launch

Power Apps に移動します。
左側のナビゲーションウィンドウから、アプリを選択します。
アプリを選択し、編集を選択します。
メニューから挿入を選択し、ラベルを選択します。
ラベルを画面右下に移動します。
右側のプロパティウィンドウから、色を白に選択し、境界線の太さを 1 に設定します。
右側から Text プロパティを選択し、テキストを Surface タブレットニュースとして入力します。
左上のプロパティリストから、OnSelect を選択します。
数式を Launch("https://www.bing.com/news/search","q","Microsoft Surface tablets") と入力します。その他の使用したい URL、パラメーター、およびキーワードを使用することもできます。
アプリを保存し、公開します。
アプリを再生します。
Surface タブレットニュースのラベルを選択し、Microsoft Surface tablets のキーワードでニュース検索を開始します。

チップ

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

例 - Param

Power Apps に移動します。
左側のナビゲーションウィンドウから、アプリを選択します。
アプリを選択し、編集を選択します。
メニューから挿入を選択し、ラベルを選択します。
ラベルを画面右下に移動します。
左上からラベルの Text プロパティを選択します。
数式を Param("browser") と入力します。使用したい異なるパラメーターを使用することもできます。
アプリを保存し、公開します。
Power Apps からアプリの Web リンクをコピーします。
新しいブラウザーを開きます。
ブラウザーにアプリの Web リンクを貼り付けて、最後に &browser=Microsoft%20Edge を追加します。
アプリが起動するとき、ラベルに渡されたパラメーター値が表示されます。
アプリプレーヤーを閉じ、アプリを編集します。
左側のナビゲーションのツリービューからアプリを選択します。
左上の StartScreen プロパティを選択します。
数式を If( Param("screen") = "techspecs", TechSpecs ) として入力します。

StartScreen プロパティの If 関数は、パラメーターが特定の値と等しいかどうかをチェックします。この場合は、値 techspecs です。一致する場合は、TechSpecs スクリーンコントロールを StartScreen プロパティに返します。

注意

製品ショーケース アプリのテンプレートを使用していない場合、If 関数の TechSpecs コントロール名を、自分のアプリの画面コントロールの名前で置き換えます。
アプリを保存し、公開します。
新しいブラウザーを開きます。
ブラウザーにアプリの Web リンクを貼り付けて、最後に &screen=techspecs を追加します。
アプリは、TechSpecs を startscreen として直接起動します。