キャンバスアプリでの Download、Launch、および Param 関数Download, Launch, and Param functions in canvas apps

パラメーターを使用して、Web ページまたはアプリをダウンロードまたは起動します。Downloads or launches a webpage or an app with parameters.

説明Description

Download 関数は、Web からローカル デバイスにファイルをダウンロードします。The Download function downloads a file from the web to the local device. ユーザーは、ファイルを保存する場所の入力を求められます。The user is prompted for a location to save the file. Download は、ファイルが格納されているローカルの場所を文字列として返します。Download returns the location where the file was stored locally as a string.

Launch 関数は、Web ページまたはアプリを起動します。The Launch function launches a webpage or an app. この関数では、必要に応じて、アプリにパラメーターを渡すことができます。Optionally, this function can pass parameters to the app.

Internet Explorer と Microsoft Edge では、起動機能によって web サイトまたはアプリが開かれるのは、そのセキュリティ設定が、その機能を含むアプリの設定と同じかそれよりも大きい場合のみです。In Internet Explorer and Microsoft Edge, the Launch function opens a website or app only if its security settings are the same or higher than those of the app that contains the function. たとえば、信頼済みサイトのセキュリティゾーンで実行されるアプリにLaunch関数を追加する場合、その機能を開く web サイトまたはアプリが、信頼済みサイトまたはローカルイントラネットゾーンにあることを確認します ( 制限付きサイト)。If, for example, you add the Launch function to an app that will run in the Trusted sites security zone, ensure that the website or app that you want the function to open is in the Trusted sites or Local intranet zone (not in Restricted sites). 詳細情報:Internet Explorer 11 のセキュリティとプライバシーの設定を変更します。More information: Change security and privacy settings for Internet Explorer 11.

Param 関数は、アプリに渡されたパラメーターをアプリの起動時に取得します。The Param function retrieves a parameter passed to the app when it was launched. 名前付きパラメーターが渡されていなかった場合、Param は "空白" を返します。If the named parameter wasn't passed, Param returns blank.

構文Syntax

Download( Address )Download( Address )

  • Address - 必須。Address - Required. ダウンロードする Web リソースのアドレス。The address of a web resource to download.

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

  • Address - 必須。Address - Required. 起動する Web ページのアドレスまたはアプリの ID。The address of a webpage or the ID of an app to launch.
  • ParameterName(s) - 省略可能。ParameterName(s) - Optional. パラメーター名。Parameter name.
  • ParameterValue(s) - 省略可能。ParameterValue(s) - Optional. アプリまたは Web ページに渡す、対応するパラメーター値。Corresponding parameter values to pass to the app or the webpage.

Param( ParameterName )Param( ParameterName )

  • ParameterName - 必須。ParameterName - Required. アプリに渡されるパラメーターの名前。The name of the parameter passed to the app.