IM-BIS for Accel Platform システム管理者 操作ガイド

«  IM-BIS 一覧画面   ::   コンテンツ   ::   IM-BIS の詳細カスタマイズ機能  »

データソース定義 登録画面

データソース－新規登録画面の機能と各部の説明

「データソース－新規登録」画面の内容は以下の通りです。
../../_images/soa_registration.png

  1. データソース種別

    データソースの種別を選択します。

  2. データソース名

    データソース定義の名称を入力します。
    ここで設定した名称がデータマッパーなどで表示されます。

  3. 備考

    登録するデータソースの説明を入力します。

  4. 他のロケール

    クリックすると表示しているロケール以外のロケールに個別にデータソース名や備考の入力欄を表示します。

コラム

データソース種別「ルール」は、「 OpenRules 」機能強化モジュールを導入した場合のみご利用できます。
ルールの設定などの詳細については「 OpenRules 簡易操作ガイド」を参照してください。

データソース－編集画面の機能と各部の説明

「データソース－編集」画面の内容は以下の通りです。

データソース種別：テナントDBクエリ

../../_images/tenant_query.png

  1. データソース名

    「データソース－新規登録」画面で設定したデータソース名を表示します。

  2. SQL

    データソースとして実行するSQLを入力します。
    記載するSQLはSELECT文のみとしてください。

    注意

    ここで指定するクエリは、サブクエリとして実行されます。
    そのため、クエリ内で ORDER BY句 を指定すると、SQLServerではエラーになります。
    SQLServer では、ORDER BY句 を指定しないようにしてください。

  3. 入力値

    • テスト実行値：「SQL」に記述したデータ処理の条件(WHERE句)に記述したカラム(テーブルの項目)に代入する値を入力します。アプリケーションの画面アイテムから入力されることが想定される値を入力します。
    • データ型：項目に対応するデータの形式を文字型(VARCHAR)、数値型(NUMBER)、日付型(DATE)、タイムスタンプ型(TIMESTAMP)のいずれかから選択します。
    • 論理名： IM-FormaDesigner の画面アイテムでデータソースを利用する際の「パラメータ設定」で表示する項目名として利用されます。20文字まで設定することができます。
    • 追加・削除：入力値の追加・削除ができます。

  4. 出力値

    • カラム名：「SQL」に記述したデータ処理がSELECT(データ抽出)の場合に出力する項目名を入力します。アプリケーションの画面アイテムに表示する項目を入力します。複数設定している場合には、画面アイテム「一覧選択」以外の項目にも検索結果を反映することができるようになります。
    • データ型：項目に対応するデータの形式を文字型(VARCHAR)、数値型(NUMBER)、日付型(DATE)、タイムスタンプ型(TIMESTAMP)のいずれかから選択します。
    • 論理名： IM-FormaDesigner の画面アイテムでデータソースを利用する際の「取得値設定」で表示する項目名として利用されます。20文字まで設定することができます。
    • 追加・削除：出力値の追加・削除ができます。

  5. テスト実行

    設定した情報を用いてデータが取得できるかをチェックします。
    取得できなかった場合にはエラーメッセージが表示されます。

  6. 登録

    設定した内容をデータソース定義として登録します。

コラム

入力値、出力値の論理名については、 IM-BIS を導入した環境の場合は、非推奨アイテムに設定されている画面アイテムで必要な設定となります。

データソース種別：シェアードDBクエリ

../../_images/shared_query.png

  1. データソース名

    「データソース－新規登録」画面で設定したデータソース名を表示します。

  2. 接続ID

    シェアードDBとして設定されている接続情報を選択します。

  3. SQL

    データソースとして実行するSQLを入力します。
    記載するSQLはSELECT文のみとしてください。

    注意

    ここで指定するクエリは、サブクエリとして実行されます。
    そのため、クエリ内で ORDER BY句 を指定すると、SQLServerではエラーになります。
    SQLServer では、ORDER BY句 を指定しないようにしてください。

  4. 入力値

    • テスト実行値：「SQL」に記述したデータ処理の条件(WHERE句)に記述したカラム(テーブルの項目)に代入する値を入力します。アプリケーションの画面アイテムから入力されることが想定される値を入力します。
    • データ型：項目に対応するデータの形式を文字型(VARCHAR)、数値型(NUMBER)、日付型(DATE)、タイムスタンプ型(TIMESTAMP)のいずれかから選択します。
    • 論理名：画面アイテムでデータソースを利用する際の「パラメータ設定」で表示する項目名として利用されます。 20文字まで利用することができます。
    • 追加・削除：入力値の追加・削除ができます。

  5. 出力値

    • カラム名：「SQL」に記述したデータ処理がSELECT(データ抽出)の場合に出力する項目名を入力します。アプリケーションの画面アイテムに表示する項目を入力します。複数設定している場合には、画面アイテム「一覧選択」以外の項目にも検索結果を反映することができるようになります。
    • データ型：項目に対応するデータの形式を文字型(VARCHAR)、数値型(NUMBER)、日付型(DATE)、タイムスタンプ型(TIMESTAMP)のいずれかから選択します。
    • 論理名：画面アイテムでデータソースを利用する際の「取得値設定」で表示する項目名として利用されます。20文字まで利用することができます。
    • 追加・削除：出力値の追加・削除ができます。

  6. テスト実行

    設定した情報を用いてデータが取得できるかをチェックします。
    取得できなかった場合にはエラーメッセージが表示されます。

  7. 登録

    設定した内容をデータソース定義として登録します。

データソース種別：REST

../../_images/rest.png

  1. データソース名

    「データソース－新規登録」画面で設定したデータソース名を表示します。

  2. サービスタイプ

    データソース種別として選択した「REST」が表示されます。

  3. RESTのURL

    REST APIのエントリポイントとなるアドレスを記述します。
    右の clear をクリックすると、入力されているURLをクリアします。

  4. URI

    RESTのURLに続くリソースURIを記述します。
    先頭に”/”を記述する必要があります。

  5. メソッド

    RESTのメソッドを設定します。
    「GET」または「POST」が選択できます。

  6. 返却形式

    レスポンスの形式を設定します。
    「JSON」または「XML」が選択できます。

  7. 返却文字コード

    レスポンスの文字コードを設定します。

  8. リクエスト

    リクエストパラメータを設定します。

  9. レスポンス

    レスポンスフィールドを設定します。

  10. 登録

設定した内容をデータソース定義として登録します。

データソース種別：SOAP

../../_images/soap.png

  1. データソース名

    「データソース－新規登録」画面で設定したデータソース名を表示します。

  2. サービスタイプ

    データソース種別として選択した「SOAP」が表示されます。

  3. WSDLのURL

    WSDLの記述されている場所(URL)を指定します。
    右の clear をクリックすると、入力されているURLをクリアします。

  4. 読み込み

    クリックするとWSDLの内容を読み込み、サービス名、ポート、オペレーションを表示します。

  5. サービス名

    読み込んだWSDLに設定されているサービス名を表示します。

  6. ポート

    読み込んだWSDLに設定されているポートを表示します。
    複数のポートがある場合は、利用するポートを選択します。

  7. オペレーション

    読み込んだWSDLに設定されているオペレーションを表示します。
    複数のオペレーションがある場合は、利用するオペレーションを選択します。

  8. リクエスト

    リクエストパラメータを設定します。
    （SOAPの場合、WSDLの読み込み、サービス名、ポート、オペレーションを設定すると表示されます。）

  9. レスポンス

    レスポンスフィールドを設定します。
    （SOAPの場合、WSDLの読み込み、サービス名、ポート、オペレーションを設定すると表示されます。）

  10. 登録

設定した内容をデータソース定義として登録します。

データソース種別：JAVA

../../_images/java.png

  1. データソース名

    「データソース－新規登録」画面で設定したデータソース名を表示します。

  2. サービスタイプ

    データソース種別として選択した「JAVA」が表示されます。

  3. 実行ファイル

    JAVA連携として利用するクラスを含むJARファイルを指定します。

  4. 実行クラス

    JARファイルのクラス名を完全修飾クラス名で指定します。

  5. 読み込み

    クリックすると実行クラスに含まれるメソッドが表示されます。

  6. メソッド

    読み込んだクラスに含まれるメソッドを表示します。
    複数のメソッドがある場合は、利用するメソッドを選択します。

  7. リクエスト

    リクエストパラメータを設定します。

  8. レスポンス

    レスポンスパラメータを設定します。

リクエストパラメータ、レスポンスフィールドの機能と各部の説明

REST、SOAP、JAVAのリクエストパラメータ、レスポンスフィールドの設定は以下の通りです。

リクエストの設定項目

「リクエスト」の設定の内容は以下の通りです。
左の列番号をドラッグすることで、並び順を入れ替えることができます。
../../_images/request.png

  1. HEADER

    パラメータをリクエストヘッダに含めるかどうかを設定します。
    チェックをオンに設定したパラメータはリクエストヘッダとして扱います。
    （JAVAの場合には、この項目は表示されません。）

  2. パラメータ

    リクエストパラメータ名を設定します。

  3. データ型

    リクエストパラメータのデータ型を設定します。
    設定できるデータ型は、object / array / string / number / date / boolean です。

  4. フォーマット

    「データ型」に「date」を設定した場合、日付の書式を設定します。

  5. 親オブジェクト

    リクエストオブジェクトが階層化されている場合に、上位階層に相当するパラメータの列番号を指定します。
    親オブジェクトに指定可能なパラメータは、「型」が「object」、もしくは「array」となっているものが対象です。

  6. 削除

    クリックするとリクエストパラメータを1行削除します。

  7. 追加

    クリックするとリクエストパラメータの入力欄を1行追加します。

レスポンスの設定項目

「レスポンス」の設定の内容は以下の通りです。
左の列番号をドラッグすることで、並び順を入れ替えることができます。
../../_images/response.png

  1. フィールド

    レスポンスフィールド名を設定します。

  2. データ型

    レスポンスフィールドのデータ型を設定します。
    設定できるデータ型は、object / array / string / number / date / boolean です。

  3. フォーマット

    「型」に「date」を設定した場合、日付の書式を設定します。

  4. 親オブジェクト

    レスポンスオブジェクトが階層化されている場合に、上位階層に相当するフィールドの列番号を指定します。
    親オブジェクトに指定可能なパラメータは、「型」が「object」、もしくは「array」となっているものが対象です。

  5. 削除

    クリックするとレスポンスフィールドを1行削除します。

  6. 追加

    クリックするとレスポンスフィールドの入力欄を1行追加します。

«  IM-BIS 一覧画面   ::   コンテンツ   ::   IM-BIS の詳細カスタマイズ機能  »

Copyright © 2013 NTT DATA INTRAMART CORPORATION