ページの先頭行へ戻る
Interstage List Works for 大規模 V11.0.0 APIリファレンス
第3章 Web連携機能API > 3.2 ListGateway > 3.2.1 Httpリクエスト
前次

3.2.1 Httpリクエスト

Httpリクエストには、以下のコマンドがあります。

コマンド名

機能

getjsp

JSPファイルの取得(セションに関係なし)

getjspinsession

JSPファイルの取得(セションが有効な場合に限定する場合)

getkeepfolder

保管フォルダ一覧の表示

getkeeplist

帳票一覧の表示

listbrowser

帳票の表示

listprint

帳票の印刷

login

リスト管理サーバに接続

logout

リスト管理サーバから切断

openframe

保管フォルダ/帳票一覧の表示準備


リクエストコマンドの記述形式

List Works Web連携は、クライアントサイドからListGatewayに対してリクエストコマンドを送信することで動作しています。

リクエスト方式には、GET/POSTオペレーションの2つがあり用途に応じて使い分けます。


リクエスト形式
http://サーバ名/listworks/servlet/ListGateway?command=コマンド名&パラメタ名=パラメタ値 (注)

注：プロトコルが「https」の場合は、「http」を「https」に置き換えて参照してください。


以降の説明では、コマンド名に上記の「コマンド名」のみを記述しています。リクエスト形式については、各コマンドの説明ページの使用例を参照してください。

注意

新規に作成するJSPファイルにおいて、Httpリクエストのコマンドを使用する場合は、以下の行を追加してください。

  <%
  response.setHeader("Pragma","no-cache");
  response.setHeader("Cache-Control","no-cache");
  response.setDateHeader("Expires",0);
  %>

追加しない場合は、ブラウザにキャッシュされたリクエストコマンドが、ListGatewayに送信され、正しく動作しません。

ただし、ActiveXコントロールを使用しているJSPファイルには、追加しないでください。


ボタンのリンク先編集

以下のフォルダに格納されているJSPファイルを編集することにより、【ログイン】ボタン、または【ログアウト】ボタンをクリックしたあと、任意のURLに接続することができます。

保管フォルダの帳票一覧の表示/帳票の表示・印刷する機能の【ログイン】ボタン、および【ログアウト】ボタンのリンク先を編集する手順は以下のとおりです。

参照

【ログイン】ボタン、【ログアウト】ボタンの説明は、“操作ガイド Webクライアント編”を参照してください。

logout.jspファイルに接続したいURLを設定します。以下の例では、「/listworks/」に移動します。

～略～

<%
String strWinID = request.getParameter("winid");
String strCommand;
if(strWinID == null || strWinID.equals("") == true)
   strCommand = "/listworks/";
                        ↑
                    移動先のURL
else
   strCommand = "/listworks/jsp/login.jsp?winid=" + strWinID;
%>

～略～

3.2.1.1 getjsp(JSPファイルの取得)

コマンド名

getjsp

機能

セションに関係なくJSPファイルを取得します。


パラメタの説明

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
必ず指定します。


使用例

WWWサーバ「WebServer」経由で、「list.jsp」ファイルを取得します。

  http://WebServer/listworks/servlet/ListGateway?command=getjsp&jsp=list.jsp

3.2.1.2 getjspinsession(JSPファイルの取得)

コマンド名

getjspinsession

機能

セションが有効な場合に限定して、JSPファイルを取得します。


パラメタの説明

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
必ず指定します。


使用例

WWWサーバ「WebServer」経由で、「list.jsp」ファイルを取得します。

  http://WebServer/listworks/servlet/ListGateway?command=getjspinsession&jsp=list.jsp

注意

あらかじめリスト管理サーバに接続しておく必要があります。接続していない場合は、JSPファイルを取得できません。


3.2.1.3 getkeepfolder(保管フォルダの一覧の表示)

コマンド名

getkeepfolder

機能

保管フォルダの一覧を表示します。


パラメタの説明

range

保管フォルダの一覧を取得する範囲を0から4までの数値で指定します。

  0：すべての保管フォルダ
  1：ルート(最上位)階層の保管フォルダ
  2：表示中の階層の1階層上の保管フォルダ
  3：指定した保管フォルダの直下の保管フォルダ
  4：表示中の階層の保管フォルダ

省略可能です。省略すると「0」が指定されたものとみなします。

nodeid

保管フォルダの識別子を指定します。指定した保管フォルダの直下に存在する保管フォルダを取得します。
rangeパラメタに「3」を指定した場合のみ有効で、その場合は本パラメタかkeeptreenoパラメタのどちらかを必ず指定します。

keeptreeno

保管フォルダの番号を指定します。指定した保管フォルダの直下に存在する保管フォルダを取得します。
rangeパラメタに「3」を指定して、nodeidパラメタが指定されていない場合のみ有効で、その場合は必ず指定します。

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。

refresh

リスト管理サーバから保管フォルダ一覧を再取得するかどうかを指定します。ただし、保管フォルダの一覧を取得する範囲(rangeパラメタ)に「0」を指定した場合のみ有効となります。

  yes：取得する
  no：取得しない

省略可能です。省略すると「yes」が指定されたものとみなします。


使用例

WWWサーバ「WebServer」経由で、すべての保管フォルダの一覧を表示するために「folderlist.jsp」ファイルを要求します。

  http://WebServer/listworks/servlet/ListGateway?command=getkeepfolder&jsp=folderlist.jsp

注意


3.2.1.4 getkeeplist(帳票一覧の表示)

コマンド名

getkeeplist

機能

帳票一覧を表示します。


パラメタの説明

folder

保管フォルダの選択方法を指定します。

  no：keeptreenoパラメタ(保管フォルダの番号)で指定
  current：getkeepfolderのrangeパラメタに「2」、「3」または「4」を指定したときのフォルダを指定

省略可能です。省略すると「no」が指定されたものとみなします。

keeptreeno

保管フォルダの番号を指定します。
folderパラメタで「no」を指定した場合のみ有効で、その場合は必ず指定します。

keepliststartno

帳票一覧に表示する先頭の帳票番号を指定します。
必ず指定します。

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。


使用例

WWWサーバ「WebServer」経由で、保管フォルダの番号[1]の帳票一覧で帳票番号[1]を先頭にして表示させるために「sheetlist.jsp」ファイルを要求します。

  http://WebServer/listworks/servlet/ListGateway?command=getkeeplist&keeptreeno=1&keepliststartno=1&jsp=sheetlist.jsp

注意

  • あらかじめリスト管理サーバに接続し、保管フォルダの一覧を表示しておく必要があります。 リスト管理サーバに接続し、保管フォルダの一覧を表示していない場合は、帳票一覧を表示できません。

  • 本コマンドを実行する前に、帳票一覧の表示準備(openframeコマンド)を行う必要があります。

  • 帳票一覧を絞り込んで表示するためには、あらかじめsession.setAttribute("[条件]","[値]")メソッドを使用して、セションに表示条件を設定しておく必要があります。
    表示条件の設定については、“E.2 帳票一覧の表示条件の設定”を参照してください。


3.2.1.5 listbrowser(帳票の表示)

コマンド名

listbrowser

機能

帳票を表示します。


パラメタの説明

sheetnodeid

表示中の帳票一覧に含まれる帳票の識別子を指定します。
本パラメタかkeepsheetnoパラメタのどちらかを必ず指定します。

keepsheetno

表示中の帳票一覧における帳票番号を指定します。
sheetnodeidパラメタを指定していない場合のみ有効で、その場合は必ず指定します。

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。


使用例

WWWサーバ「WebServer」経由で、表示中の帳票一覧における帳票番号「1」の帳票を表示するために「browse.jsp」ファイルを要求します。

  http://WebServer/listworks/servlet/ListGateway?command=listbrowser&keepsheetno=1&jsp=browse.jsp

注意

  • あらかじめリスト管理サーバに接続し、保管フォルダの一覧の表示、帳票一覧の表示をしておく必要があります。

  • リスト管理サーバに接続し、保管フォルダの一覧の表示、帳票一覧の表示をしていない場合は、帳票を表示できません。


3.2.1.6 listprint(帳票の印刷)

コマンド名

listprint

機能

帳票を印刷します。


パラメタの説明

sheetnodeid

表示中の帳票一覧に含まれる帳票の識別子を指定します。
本パラメタかkeepsheetnoパラメタのどちらかを必ず指定します。

keepsheetno

表示中の帳票一覧における帳票番号を指定します。
sheetnodeidパラメタを指定していない場合のみ有効で、その場合は必ず指定します。

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。


使用例

WWWサーバ「WebServer」経由で、表示中の帳票一覧における帳票番号「1」の帳票を印刷するために「print.jsp」ファイルを要求します。

  http://WebServer/listworks/servlet/ListGateway?command=listprint&keepsheetno=1&jsp= print.jsp

注意

  • あらかじめリスト管理サーバに接続し、保管フォルダの一覧の表示、帳票一覧の表示をしておく必要があります。

  • リスト管理サーバに接続し、保管フォルダの一覧の表示、帳票一覧の表示をしていない場合は、帳票を印刷できません。


3.2.1.7 login(リスト管理サーバへの接続)

コマンド名

login

機能

リスト管理サーバに接続します。


パラメタの説明

userid

接続するユーザIDを指定します。
必ず指定します。文字列は、半角36文字以内で指定します。

password

ユーザIDに対応したパスワードを指定します。
必ず指定します。
パスワードは、半角255文字以内で指定します。

servername

ホスト名を指定します。
必ず指定します。ホスト名は、半角64文字以内で指定します。

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。


使用例

3.2.1.8 logout(リスト管理サーバからの切断)

コマンド名

logout

機能

リスト管理サーバから切断します。


パラメタの説明

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。


使用例

WWWサーバ「WebServer」経由で、リスト管理サーバから切断して「logout.jsp」ファイルを要求します。

  http://WebServer/listworks/servlet/ListGateway?command=logout&jsp=logout.jsp

注意

あらかじめリスト管理サーバに接続しておく必要があります。接続していない場合は、本コマンドは実行されません。


3.2.1.9 openframe(保管フォルダ/帳票一覧の表示準備)

コマンド名

openframe

機能

保管フォルダ/帳票一覧の表示準備を行います。


パラメタの説明

jsp

本コマンド完了後に実行させるJSPファイル名を指定します。
省略可能です。省略すると何も表示されません。


使用例

WWWサーバ「WebServer」経由で、保管フォルダの一覧を表示するために、getkeepfolder(保管フォルダの一覧の表示)コマンドを含む「list.jsp」ファイルを要求します。

  http://WebServer/listworks/servlet/ListGateway?command=openframe&jsp=list.jsp

  list.jspの内容
        ：
http://WebServer/listworks/servlet/ListGateway?command=getkeepfolder&jsp=folderlist.jsp
        ：

注意


前次
Copyright 1995-2025 Fujitsu Limited