cfexecute

説明

サーバーコンピュータ上で ColdFusion 開発者が指定したすべての処理を実行します。

カテゴリ

拡張タグ、フロー制御タグ

シンタックス

<cfexecute
   name = "application name"
   arguments = "command line arguments"
   outputFile = "output filename"
   variable = "variable name"
   timeout = "timeout interval">
   ...
</cfexecute>

関連項目

cfcollection、cfindex、cfobject、cfreport、cfsearch、cfwddx

ヒストリ

ColdFusion MX 6.1:

属性

属性 必須/
オプション 		デフォルト 説明

name

必須

 

実行するアプリケーションの絶対パスです。

Windows では、C:¥myapp.exe のように拡張子を指定する必要があります。

arguments

オプション

 

アプリケーションに渡されるコマンドライン変数です。文字列として指定された場合は、次のように処理されます。

  • Windows の場合 : プロセスコントロールサブシステムに渡されて、解析されます。
  • UNIX の場合 : 引数の配列に置き換えられます。デフォルトのトークンセパレータはスペースです。スペースが埋め込まれた引数を二重引用符 (") で区切ることもできます。

配列として渡された場合は、次のように処理されます。

  • Windows の場合 : 要素はトークンの文字列に連結され、スペースで区切られます。プロセスコントロールサブシステムに渡されて、解析されます。
  • UNIX の場合 : 要素は exec() 引数の配列にコピーされます。

outputFile

オプション

 

プログラム出力の送信先となるファイルです。outputFile 属性または variable 属性を指定しなかった場合は、出力は呼び出し元のページに表示されます。

絶対パス (ドライブ文字とコロン、あるいはスラッシュまたは円記号から始まるパス) を指定しなかった場合は、GetTempDirectory 関数から返される ColdFusion テンポラリディレクトリを基準とする相対パスになります。

variable

オプション

 

プログラム出力を保管するための変数です。outputFile 属性または variable 属性を指定しなかった場合、出力は呼び出し元のページに表示されます。

timeout

オプション

0

生成されたプログラムからの出力を ColdFusion が待機する時間を秒単位で指定します。

  • 0: 非ブロックモードに相当します。
  • 非常に大きい値: ブロックモードに相当します。

値が 0 の場合、次の処理が行われます。

  • 処理が開始され、すぐに返されます。プログラムの出力が表示される前に、呼び出しページに制御権が返される場合があります。プログラムの出力を確実に表示するには、値を 2 以上に設定してください。
  • outputFile 属性を指定しない場合、プログラムの出力は破棄されます。

使用方法

cfexecute の開始タグと終了タグの間には、他の ColdFusion のタグや関数を指定しないでください。cfexecute タグはネストできません。

例外

次の例外が発生します。

タイムアウト値は、0 から、オペレーティングシステムでサポートされる最大タイムアウト値までの値でなければなりません。

例

<h3>cfexecute</h3>
<p>この例では、Windows NT バージョンの netstat ネットワーク監視プログラムを実行し、その出力をファイルに格納します。

<cfexecute name = "C:¥WinNT¥System32¥netstat.exe"
   arguments = "-e" 
   outputFile = "C:¥Temp¥output.txt"
   timeout = "1">
</cfexecute>

ColdFusion MX 7 | ColdFusion MX 6.1 | ColdFusion MX* | ColdFusion 5* | フォーラム* | デベロッパーセンター | サポート情報 | バグ報告

バージョン7