リクエスタの使用

インターネットリクエスタは、ブラウザの上のHTMLファイルからMagicプログラムを実行したりブラウザにプログラム結果を返す際に使用されます。

注意：

リッチクライアントの場合も使用します。

以下の方法でリクエスタやパラメータを指定することができます。

リクエスタの参照

外部のHTMLページやブラウザから直接リクエスタを使用する方法について説明します。

Magicプログラムによって作成されたページからリクエスタを使用している場合、Magic xpaは自動的に適切なHTMLコードを作成します。

URLの中でリクエスタを参照するために使用された方法は、どのリクエスタが使用されるか、そしてそれがどのようにインストールされたかに依存します。いくつかの例を示します。

リクエスタ

URLの指定例

CGI

http://servername/scripts/mgrqcgixx.exe

ISAPI

http://servername/scripts/mgrqispixx.dll

パラメータ

インターネットリクエスタで指定可能なパラメータには、以下の通りです。

注意：

  • 上記のパラメータは、リクエスタ(mgrqispixx.dll、mgrqcgixx.exe)が内部で処理し、実行エンジンには渡されない予約キーワードです。

  • ARGUMENTSで指定するパラメータのデータタイプは、各パラメータ値の先頭に以下の文字を付加します。

-A

文字

-C

Unicode

-L

論理（True/False）

-N

-D

-F

数値

日付

時刻

-U

NULL

 

パラメータの指定

パラメータはHiddenフィールドやURLの一部として指定できます。

以下は、ISAPIリクエスタを使用した指定例です。

  1. PetShopDemoアプリケーション内のHTMLOrdersListプログラムを呼び出します。

  2. リクエストの優先順位を指定します。

  3. ユーザIDとパスワードを指定します。

Hiddenフィールドで指定する場合の例

<FORM action="/scripts/mgrqispi.dll" method="POST">
<INPUT type="hidden" name="APPNAME" value="PetShopDemo">
<INPUT type="hidden" name="PRGNAME" value="HTMLOrderList">
<INPUT type="hidden" name="PRIORITY" value="4">
<INPUT type="hidden" name="USERNAME" value="supervisor">
<INPUT type="hidden" name="PASSWORD" value="12345">
<INPUT type="submit" name="" value="Submit">
</FORM>

URLで指定する場合の例

 URLで指定する場合は、以下のようになります。

<A href="/scripts/mgrqispi.dll?APPNAME=PetShopDemo&PRGNAME=HTMLOrderList&PRIORITY=4&USERNAME=supervisor&PASSWORD=12345>
Call PetShopDemo - HTMLOrdersList
</A>

 

URLを使用してパラメータを指定する場合、使用できない文字がパラメータに含まれている場合、URLでエンコードする必要があります。

例えば、スペースを入力させる場合は、URLにエンコードされた文字列%20を指定します。

「Pet Shop Demo」をアプリケーション名とした場合のパラメータは以下のようになります。

APPNAME=Pet%20Shop%20Demo