データベースを検索して、複数件の結果を返す処理をRESTのWebサービスとして公開したい

キーワード:Webサービス,Webアプリケーション,HTTPトリガー,REST,データベース
シナリオ一覧に戻る

概要

データベース検索処理をRESTのWebサービスとして公開したい場合、HTTPトリガーを使用して公開します。

サンプルプロジェクトの説明

HTTPトリガーで検索キーワードを受け取り、データベースの検索結果をXMLで返します。
本スクリプトは逆引きリファレンス「RESTでデータベース検索のWebサービスを実行し、XML型の検索結果を取得したい」よりWebアプリケーションとして呼び出されます。

処理の流れ

サンプルプロジェクトの処理の流れは以下の通りです。
  1. 検索系SQL実行処理」で検索キーワードをもとにデータベースから検索を行います。
実行結果のイメージについて

ポイントとなる機能

名前 説明
HTTPトリガー HTTPトリガーは、指定したURLに対しHTTPクライアントからリクエストを送ることで、スクリプトを実行するトリガー機能です。

処理のポイント

HTTPクライアントからHTTPトリガーで値を受け取る場合、スクリプト入力変数を使用します。
HTTPクライアントへHTTPトリガーから値を返す場合、スクリプト出力変数を使用します。

サンプルプロジェクトの使用方法

上記処理を実装したサンプルプロジェクトを用意しています。サンプルプロジェクトを使用する場合の手順は、以下の通りです。

サンプルプロジェクトファイル名 rl_reference_055.zip
  1. サンプルプロジェクトの展開
    サンプルプロジェクトファイル「rl_reference_055.zip」を展開します。

  2. プロジェクトのアップロード
    「rl_reference_055.zip」を展開後に作成される「rl_reference_055プロジェクト」ディレクトリがプロジェクトファイルとなります。
    DataSpider Studioを起動し、マイプロジェクトの画面から[ファイル]-[ローカルからアップロード]で展開したディレクトリ「rl_reference_055プロジェクト」をアップロードしてください。

  3. グローバルリソースの設定
    コントロールパネルの[グローバルリソースの設定]から、[新しいグローバルリソースの追加]を選択し、SQL Serverのグローバルリソースを追加します。
    グローバルリソースの設定方法については、「グローバルリソースのプロパティ」を参照してください。

  4. プロジェクトをサービスとして登録
    スクリプトをHTTPトリガーより実行するため、プロジェクトをサービスとして登録します。
    デザイナの[ファイル]-[プロジェクトをサービスとして登録]を選択して登録します。
    サービス名は、「root@rl_reference_055プロジェクト」を設定してください。

  5. HTTPトリガーの設定
    マイトリガーの画面から[ファイル]-[新規トリガー作成]を選択し、HTTPトリガーを追加します。
    HTTPトリガーの詳細については、「HTTPトリガー」を参照してください。
    HTTPトリガーの設定は、以下のように行います。

    [HTTPトリガーの設定]



    処理のポイント
    • 戻り値がXMLであるため、[レスポンス設定]-[Content-Type]には「text/xml」を選択してください。
      [Content-Type]は戻り値に応じて適切な値に設定してください。

    [実行内容の設定]



    処理のポイント
    • HTTPクライアントからHTTPトリガーに値を渡す場合のパラメータ名は[スクリプト引数]に設定された変数名を使用してください。
    • HTTPクライアントへHTTPトリガーから値を返す場合は[スクリプト出力]に設定された変数の[値]に「${trigger.outputData}」を入力してください。

スクリプトの作成手順

プロセスフローおよびデータフローは、「サンプルプロジェクトの説明」のスクリプト画像を参照して適宜設定してください。
  1. HTTPトリガーの入出力変数として使用するスクリプト変数を作成します。

  2. デザイナのツールパレット「データベース」-「SQL Server」-「検索系SQL実行」から、検索系SQL実行処理をスクリプトキャンバスに配置します。

  3. 検索系SQL実行処理からスクリプト出力変数「response」にデータフローを引きます。

    処理のポイント
    • XML型のスクリプト出力変数にデータフローを引く場合は、対象コンポーネントからend処理に左クリックドラッグ&ドロップを行ってください。

  4. スクリプトを実行し、正常終了すれば成功です。