E.3.1 操作画面のAPI（login（帳票管理サーバに接続））

操作画面のAPIを利用したアプリケーションを開発するためのインターフェースについて、説明します。

操作画面のAPIは、WebクライアントからのHTTPリクエスト要求に応じて帳票管理サーバと通信し、結果をWebクライアントへ送信します。

注意

帳票管理サーバに接続した後は、必ず「空白画面」を表示しておく必要があります。空白画面を表示せずに、操作画面の表示および操作はできません。
空白画面を業務用の画面から遷移して表示する場合、操作画面で「Close」リンクをクリックすると空白画面も閉じられるため、業務用の画面に戻れません。このため、空白画面は、新規ウィンドウで表示することを推奨します。
なお、FORMタグのtarget属性に「LMLogin」を指定すると、空白画面を業務用の画面から遷移して表示することもできます。
「LMLogin」は空白画面を示すため、その他の画面の名前に「LMLogin」を使用しないでください。

コマンド名

機能

帳票管理サーバに接続し、操作画面（論理あて先一覧画面または帳票一覧画面）を表示します。

また、本コマンドの指定方法によっては、ログイン画面を省略して操作画面を表示できます。

パラメーターの説明

userID

帳票管理サーバに接続するユーザIDを指定します。必ず指定します。

文字列は、以下の半角記号を除く半角英数字および半角記号で、16バイト以内で指定します。文字列は、大文字小文字の区別はしません。

「*」、「+」、「,」、「/」、「:」、「;」、「<」、「=」、「>」、「?」、「[」、「\」、「]」、「|」、「'」、「」（空白）

password

ユーザIDに対応したパスワードを指定します。必ず指定します。

パスワードは、以下の半角記号を除く半角英数字および半角記号で、16バイト以内で指定します。文字列は、大文字小文字を区別して指定します。

「'」、「"」

firstRequestURL

ログイン後に表示する操作画面のURLを指定します。必ず指定します。FQDN形式で指定することもできます。

論理あて先一覧画面の場合

http://ホスト名[:ポート番号]/listmanager/LoList

帳票一覧画面の場合

http://ホスト名[:ポート番号]/listmanager/DocList

directLogin

ログイン画面を省略して操作画面を表示する場合は、「1」を指定します。「1」以外を指定すると、エラーになります。

本パラメーターは省略可能です。省略した場合は、ログイン画面が表示され、正常にログインできると、firstRequestURLで指定した画面が表示されます。

使用例

業務用の画面で「論理あて先一覧画面の表示」ボタンをクリックし、論理あて先一覧画面を表示します。論理あて先一覧画面は新規ウィンドウで表示されます。

ユーザIDは「LMuser」、パスワードは「LMpassword」、ホスト名は「hostname」を指定します。

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>

<HEAD>
<META http-equiv="Content-Script-Type" content="text/javascript">
<META http-equiv="Content-Style-Type" content="text/css">
<TITLE>ダイレクトログイン - ログイン画面を介さずに操作画面を表示します。</TITLE>
<SCRIPT type="text/javascript">

function DirectLogin()
{
//ユーザID、パスワードを指定
    loginform.userID.value   = "LMuser";
    loginform.password.value = "LMpassword";
    loginform.submit();
}

</SCRIPT>
</HEAD>

<!-- ログイン画面を非表示にして、「ダイレクトログイン」ボタンを表示します。 -->
<BODY>
    <FORM name="loginform" method="POST" action="http://hostname[:ポート番号]/listmanager/LoList" target="LMLogin">
        <INPUT name="command" type="hidden" value="login">
        <INPUT name="userID" type="hidden" value="">
        <INPUT name="password" type="hidden" value="">
        <INPUT name="firstRequestURL" type="hidden" value=" http://hostname[:ポート番号]/listmanager/LoList">
        <INPUT name="directLogin" type="hidden" value="1">
        <INPUT name="directbutton" type="button" value="ダイレクトログイン" onclick="DirectLogin()">
    </FORM>
</BODY>

</HTML>