メッセージ送信中間イベント(HTTP)

機能概要

指定したURLに、HTTPリクエストを送信します。
外部システムまたはDataSpider BPMの他のプロセスへのデータ送信が可能となります。

プロセスモデル編集権限を持つ管理者が対象です。

機能一覧

プロセス図 プロセス図の作成を行います。
スイムレーンやタスクを配置し、フローを作成して、作業の順序を定義します。
タスク プロセス実行時に、データを入力するフォームが表示されます。
サービスタスク
(データ設定)
数値型、日付型/日時型、文字型プロセスデータ項目に、動的な値や演算結果を代入します。
サービスタスク
(PDF生成)
業務データ(各プロセスデータ項目に保持されている値)を埋め込んだPDF帳票を自動生成します。
サービスタスク
(選択肢マスタ更新)
指定の選択型プロセスデータ項目の内容を、共有プロセスモデルファイルの[選択型プロセスデータで使用する選択肢マスタ]として更新します。
スクリプトタスク ECMAスクリプトを使用して、業務データ(各プロセスデータ項目に保持されている値)を編集します。
タイマー開始イベント 設定した日時にプロセスを自動的に開始します。
タイマー中間イベント 指定した日時まで待機し、指定日時を経過するとトークンが進みます。
メッセージ開始・
受信中間イベント(HTTP)
メッセージ開始イベント(HTTP): 外部システムまたはDataSpider BPMの他のプロセスから受け取ったメッセージをもとにプロセスを開始します。
メッセージ受信中間イベント(HTTP): プロセスの実行途中で、外部システムまたはDataSpider BPMの他のプロセスから受け取ったメッセージをもとにプロセスデータを入力できます。
メッセージ開始イベント
(フォーム)
Webページの入力フォームから受け取ったメッセージをもとにプロセスを開始します。
入力フォームは、プロセスデータ項目のレイアウトをWebページに埋め込んで使用します。
メッセージ送信中間イベント
(HTTP)
指定したURLに、HTTPリクエストを送信します。
外部システムまたはDataSpider BPMの他のプロセスへのデータ送信が可能となります。
メッセージ送信中間イベント
(メール)
設定した内容でメールを送信します。
送信先は任意に設定できます。
メール本文に、プロセスデータの入力内容を埋め込むことができます。
メッセージ送信中間イベント
(DataSpider Servista)
指定したDataSpider Servistaのスクリプトを実行することができます。
イベントの実行時には、DataSpider BPM側のプロセスデータ項目の値を、DataSpider Servista側で定義されている入力変数へ渡すことができます。
スクリプト終了時には、DataSpider Servista側で定義されている出力変数の値を、DataSpider BPM側のプロセスデータ項目の値として受け取ることができます。
スクリプトの実行結果(結果の戻り値:ExitStatusおよびエラー内容)を受け取り、その後のタスクや条件分岐処理等で使用することができます。
分岐 プロセス図に分岐がある場合、分岐・遷移先の設定を行います。

項目説明

メッセージ送信中間イベントのプロパティダイアログ表示例


項目名 必須 説明
基本 名称 任意 イベントの名称を入力します。
メモ 任意 イベントの注意点や目的などに関するメモを入力します。
詳細 通信設定 アクセスURL 必須 送信するHTTPリクエストのURLを入力します。
  • 外部のシステムが提供するサービスに対してHTTPリクエストを送信することができます。
  • メッセージ開始イベント(HTTP)の[URL]を指定することで、他のプロセスを開始することができます。
  • メッセージ受信中間イベント(HTTP)の[URL]を指定することで、プロセスの実行途中で他のプロセスへデータを送信することができます。
メッセージ開始イベント(HTTP)およびメッセージ受信中間イベント(HTTP)の[URL]に関する詳細は、「メッセージ開始・受信中間イベント(HTTP)」を参照してください。

[プロセスデータの参照を挿入する...]リストを使用することにより、以下の保持データをアクセスURLの一部として使用することができます。
  • 件名: #{processInstanceTitle}
  • プロセスID: #{processInstanceId}
  • プロセス開始ユーザ: #{processInstanceInitQuserName}
  • プロセス開始組織: #{processInstanceInitQgroupName}
  • プロセス開始日時: #{processInstanceStartDatetime}
  • プロセス開始連番: #{processInstanceSequenceNumber}
  • プロセスモデルID: #{processModelInfoId}
  • プロセスモデル名: #{processModelInfoName}
  • プロセスデータ項目: #{data['<プロセスデータ定義番号>']}
HTTP Method 必須 送信するHTTPリクエストのMethodを選択します。
  • GET
  • POST
  • POST (multipart/form-data)
「POST」を選択した場合のエンコードは、「application/x-www-form-urlencoded」となります。
「GET」または「POST(application/x-www-form-urlencoded)」の場合は、ファイル型のプロセスデータ項目に保持した添付ファイルを送信することはできません。ファイル名のみが送信されます。
エラー発生時に
エラー内容を格納する
文字型データ項目
任意 HTTPリクエスト送信時にエラーが発生した場合に、そのエラー内容を格納する文字型プロセスデータ項目を選択します。
指定する文字型プロセスデータ項目のデータサブタイプは、「複数行」とします。
セキュリティ 必須 送信するHTTPリクエストのセキュリティを選択します。
  • 使用しない: 認証方式によるアクセスを行いません。
  • Basic 認証で接続する: [ユーザ名]および[パスワード]を設定し、Basic認証を用いてアクセスします。
送信パラメータ パラメータ名 任意 受信側が受け取るパラメータ名を入力します。
例) processModelInfoId、data[0].input、data[2].selects、data[3].datetime など
データの受信が受信側で必須の場合は、必ず指定してください。
受信パラメータ名として指定する[パラメータ名の書式]に関する詳細は、「メッセージ開始・受信中間イベント(HTTP)」を参照してください。
任意 パラメータに渡す値を入力および選択します。
固定値を直接入力するか、送信側(このプロセスモデル)のプロセスデータ項目をリストから選択します。
  • 固定値: フィールドに渡したい値を直接入力します。
  • プロセスデータ項目の値: リストから選択します。
    プロセスデータ項目の他に、プロセスIDを選択することができます。
  • 固定変数値(keyのみ): セキュリティ鍵の値を固定値ではなく、「${var[key]}」で指定します。
    イベント実行時、自身の設定ファイル(qbpms.config)に設定しているAPIキー(qbpms.api.key)の値を取得して実行します。
    設定ファイル(qbpms.config)に関する詳細は、「設定ファイル(qbpms.config)」を参照してください。
  • 変数指定: [変数の利用]ボタンにて選択した変数名の参照を指定します。「${var[<変数名>]}」
    [変数の利用]ボタンに関する詳細は、こちらを参照してください。
データの受信が受信側で必須の場合は、必ず指定してください。
レスポンス レスポンスをプロセスデータに保存する 任意 送信したHTTPリクエストのレスポンスデータを受け取る場合は、チェックを入れます。
チェックを入れた場合のみ、[保存先のプロセスデータ項目]が表示されます。
保存先のプロセスデータ項目 任意 送信したHTTPリクエストのレスポンスデータを受け取るプロセスデータ項目を選択します。
ファイル型または文字型(複数行)のプロセスデータ項目が必要となります。

操作メニュー説明

表示 操作メニュー 説明
基本 [閉じる]ボタン メッセージ送信中間イベント(HTTP)のプロパティダイアログを閉じます。
詳細 [マニュアル表示]ボタン このマニュアルページを表示します。
[メッセージ開始/
受信中間イベント(HTTP)
に接続する場合]ボタン
他のプロセスへデータ送信する場合において、受信側のメッセージ開始イベント(HTTP)およびメッセージ受信中間イベント(HTTP)の[URL]および[パラメータ]の情報を確認することができます。

確認方法
  1. [メッセージ開始/受信中間イベント(HTTP)に接続する場合]ボタンを押下します。
  2. 表示されるリストから、以下のいずれかを選択します。
    • 同一サーバ内のイベントに接続する場合
    • 外部サーバのイベントに接続する場合

    同一サーバ内のイベントに接続する場合
    1. 同一サーバに存在するメッセージ送信中間イベントおよびメッセージ受信中間イベント(HTTP)の一覧が表示されます。
    2. 確認したいイベントのを押下します。
    3. 選択したイベントのURL・パラメータ詳細情報が表示されます。

    外部サーバのイベントに接続する場合
    1. [接続先のサーバのベースURL]を適宜入力します。
    2. [検索]ボタンを押下します。
    3. 指定したサーバのログイン画面が表示されます。
      参照したいプロセスに対して権限のあるユーザでログインしてください。
    4. 指定した外部サーバに存在するメッセージ送信中間イベントおよびメッセージ受信中間イベント(HTTP)の一覧が表示されます。
    5. 確認したいイベントのを押下します。
    6. 選択したイベントのURL・パラメータ詳細情報が表示されます。

  3. 表示される[URL]および[受信パラメータ]の情報を確認し、メッセージ送信中間イベント側の[アクセスURL]および[送信パラメータ]を設定してください。
メッセージ開始イベント(HTTP)およびメッセージ受信中間イベント(HTTP)の、URL・パラメータ詳細情報に関する詳細は、「メッセージ開始・受信中間イベント(HTTP)」を参照してください。
[+]ボタン 送信パラメータを新規追加します。
[-]ボタン 送信パラメータを削除します。
[変数の利用]ボタン 変数設定画面にて登録した変数を使用して、各設定項目の指定を変数指定することができます。

[変数の利用]ボタンを押下すると、変数の選択ダイアログが表示されます。


  1. 変数設定画面にて登録した変数がリスト表示されます。使用したい変数名をリストから選んでください。
  2. 選択した変数を指定する書式がリストの下に表示されます。
    例) ${var[<変数名>]}
  3. [クリップボードにコピー]ボタンを押下します。
  4. 変数の選択ダイアログを閉じ、変数指定したい項目でペーストします。
変数設定画面に関する詳細は、
「変数設定(プロセスモデル変数)」を参照してください。

メッセージ送信中間イベント(HTTP)の処理仕様

データ送信基本仕様

データ送信を行う際の基本仕様は以下のとおりです。
「GET」または「POST(application/x-www-form-urlencoded)」の場合は、ファイル型のプロセスデータ項目に保持した添付ファイルを送信することはできません。ファイル名のみが送信されます。
リダイレクトには対応していません。送信先サーバがリダイレクト処理を行っている場合は注意してください。

イベント実行時の応答メッセージ

レスポンスコードが「200」(処理成功)以外は、全てエラーとして処理します。
エラー発生時のリトライ処理は行いません。