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

機能概要

プロセスにおいて、システムが処理する自動工程を表します。
指定したURLに、HTTPリクエストを送信します。
外部システムまたはDataSpider BPMの他のプロセスへのデータ送信が可能となります。

アプリ管理権限を持つユーザが対象です。

機能一覧

ワークフロー図 ワークフロー図の作成を行います。
スイムレーンや各アイテムを配置し、フローを作成して、作業の順序を定義します。
ヒューマンタスク プロセスにおいて、処理担当者が作業する手動工程を表します。
プロセス実行時に、データを入力するフォーム(タスク処理画面)が表示されます。
サービスタスク
(データ設定)
プロセスにおいて、システムが処理する自動工程を表します。
数値型、日付型/日時型、文字型、選択型データ項目に、動的な値や演算結果を代入します。
サービスタスク
(PDF生成)
プロセスにおいて、システムが処理する自動工程を表します。
業務データ(各データ項目に保持されている値)を埋め込んだPDF帳票を生成します。
サービスタスク
(選択肢マスタ更新)
プロセスにおいて、システムが処理する自動工程を表します。
指定の選択型データ項目の内容を、アプリ共有アドオンの[選択型データ項目で使用する選択肢マスタ]として更新します。
スクリプトタスク プロセスにおいて、システムが処理する自動工程を表します。
ECMAスクリプトを使用して、業務データ(各データ項目に保持されている値)を編集します。
受信タスク
(フォーム)
プロセスにおいて、システムが処理する自動工程を表します。
アカウントを持たないユーザに対して、プロセスの途中での入力フォームを提供します。
メッセージ開始イベント(フォーム)を使用してユーザにWeb入力フォームを提供したあとに、メールによる本人確認を経て、詳細情報を入力するようなWeb入力フォームを表示します。
受信タスク
(Webhook)
プロセスにおいて、システムが処理する自動工程を表します。
外部サービス側のWebhook通知の受信まで待機し、受信後にトークンが進みます。
サービスタスク
(Add-on)
プロセスにおいて、システムが処理する自動工程を表します。
ユーザ独自定義のサービスタスクを処理します。
タイマー開始イベント プロセスにおいて、システムが処理する自動工程を表します。
設定した日時にプロセスを自動的に開始します。
タイマー中間イベント プロセスにおいて、システムが処理する自動工程を表します。
指定した日時まで待機し、指定日時を経過するとトークンが進みます。
メッセージ開始・
受信中間イベント(HTTP)
プロセスにおいて、システムが処理する自動工程を表します。
メッセージ開始イベント(HTTP): 外部システムまたはDataSpider BPMの他のプロセスから受け取ったメッセージをもとにプロセスを開始します。
メッセージ受信中間イベント(HTTP): プロセスの実行途中で、外部システムまたはDataSpider BPMの他のプロセスから受け取ったメッセージをもとにデータを入力できます。
メッセージ開始イベント
(フォーム)
プロセスにおいて、システムが処理する自動工程を表します。
Webページの入力フォームから受け取ったメッセージをもとにプロセスを開始します。
入力フォームは、データ項目のレイアウトをWebページに埋め込んで使用します。
メッセージ開始イベント
(Webhook)
プロセスにおいて、システムが処理する自動工程を表します。
外部サービス側のWebhook通知の受信を起点とし、プロセスを自動的に開始します。
メッセージ送信中間イベント
(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]を指定することで、プロセスの実行途中で他のプロセスへデータを送信することができます。
実行時での有効な文字数は、最大10,000文字となります。
メッセージ開始イベント(HTTP)およびメッセージ受信中間イベント(HTTP)の[URL]に関する詳細は、「メッセージ開始・受信中間イベント(HTTP)」を参照してください。

[データの参照を挿入する...]アイコンを使用することにより、保持データをアクセスURLの一部として使用することができます。
HTTP Method 必須 送信するHTTPリクエストのMethodを選択します。
  • GET
  • POST(application/x-www-form-urlencoded)
  • POST(multipart/form-data)
  • POST(リクエストボディを指定)
  • PUT(リクエストボディを指定)
  • PATCH(リクエストボディを指定)
  • DELETE
「リクエストボディを指定」のMethodを選択した場合は、[リクエストボディ]タブが使用可能となり、任意のBody部に指定するデータ項目およびContent-Typeを選択することができます。
「GET」または「POST(application/x-www-form-urlencoded)」の場合は、ファイル型のデータ項目に保持した添付ファイルを送信することはできません。ファイル名のみが送信されます。
「DELETE」の場合は、Body部がなく、GETリクエストと同様に送信パラメータはURLに埋め込まれて送信されます。
リクエストボディとして送信する
データ項目
任意 送信するHTTPリクエストのリクエストボディに含める値を以下のデータ項目から選択します。
  • 文字型(複数行)のデータ項目: 選択した場合、[リクエストボディのContent-Type]を指定します。
  • ファイル型のデータ項目: 添付したファイル自体のContent-TypeがリクエストのContent-Typeとなります。
ファイル型のデータ項目を選択した場合、実行時に複数の添付ファイルが存在する場合はエラーとなります。
リクエストボディの
Content-Type
任意 文字型(複数行)のデータ項目に保持されている値のContent-Typeを、直接入力します。
初期値にはapplication/jsonが入力されています。
レスポンスを保存するデータ項目
(文字複数行 / ファイル)
任意 送信したHTTPリクエストのレスポンスデータを受け取るデータ項目を選択します。
ファイル型または文字型(複数行)のデータ項目が必要となります。
[エラー内容を保存するデータ項目(文字複数行)]と異なるデータ項目を選択してください。
エラー内容を保存するデータ項目
(文字複数行)
任意 HTTPリクエスト送信時にエラーが発生した場合に、そのエラー内容を格納する文字型データ項目を選択します。
エラー内容を保存するデータ項目は、エラーが発生しない場合に値は空となります。
[レスポンスを保存するデータ項目(文字複数行 / ファイル)]と異なるデータ項目を選択してください。
ヘッダ Authorization ヘッダ 任意 送信するHTTPリクエストのAuthorization ヘッダを選択します。
  • 使用しない: 認証方式によるアクセスを行いません。
  • Basic 認証: [ユーザ名]および[パスワード]を設定し、Basic認証を用いてアクセスします。
[ユーザ名]および[パスワード]を合わせた形式での有効な文字数は、最大500文字となります。
ヘッダ 任意 送信するHTTPリクエストのHTTPヘッダを指定します。
  • ヘッダ名: HTTPヘッダの名前を指定します。
  • ヘッダの値: HTTPヘッダに対する値を指定します。
対応しているHTTPヘッダ
  • BoxApi
  • Dropbox-API-Arg
  • 「X-」で始まるHTTPヘッダ
  • Accept
HTTPヘッダに変換された形式での有効な文字数は、最大1,000文字となります。
HTTPヘッダを指定できる数は、最大10個となります。
以下の「X-」で始まるHTTPヘッダは使用できません。
  • X-Requested-With
  • X-Forwarded-For
  • X-Forwarded-Host
  • X-Forwarded-Proto
  • X-Csrf-Token
送信パラメータ パラメータ名 任意 受信側が受け取るパラメータ名を入力および選択します。
例) data[0].input(他のアプリ: データ項目番号指定)、q_name(他のアプリ: フィールド名指定)、param(任意) など
データの受信が受信側で必須の場合は、必ず指定してください。
受信パラメータ名として指定する[パラメータ名の書式]に関する詳細は、「メッセージ開始・受信中間イベント(HTTP)」を参照してください。
パラメータの値 任意 パラメータに渡す値を入力および選択します。
固定値を直接入力するか、送信側(このアプリ)のデータ項目をリストから選択します。
  • 固定値: フィールドに渡したい値を直接入力します。
  • プロセスID: 実行時のプロセスIDを値として送信します。
  • 件名: 実行時のプロセスの件名を値として送信します。
  • データ項目の値: 実行時のデータ項目に保持している値を送信します。
  • 変数指定: [参照を挿入する...]アイコンにて選択した変数名の参照を指定します。「${var[<変数名>]}」
    [参照を挿入する...]アイコンに関する詳細は、こちらを参照してください。
数値型データ項目の「標準フォーマット」は、以下のフォーマットでデータを送信します。
  • 小数点はピリオド
  • 桁区切りなし
データの受信が受信側で必須の場合は、必ず指定してください。

操作メニュー説明

表示
(HTML5版)
表示
(Flash版)
操作メニュー 説明
[ヘルプ]アイコン
[ヘルプ]ボタン
このマニュアルページを表示します。
[適用して閉じる]ボタン
[閉じる]ボタン
設定した値を適用して、メッセージ送信中間イベント(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)」を参照してください。
- [並び替え]アイコン 送信パラメータまたはヘッダを並び替えます。
- [編集]アイコン 送信パラメータまたはヘッダを編集します。
[削除]アイコン
[-]ボタン
送信パラメータまたはヘッダを削除します。
[+]アイコン
[+]ボタン
送信パラメータまたはヘッダを新規追加します。
[参照を挿入する...]アイコン
[参照を挿入する...]リストボックス
[アクセスURL]および[保存する際のファイル名]に、プロセス情報や変数の参照を挿入します。
  • [件名]: #{processInstanceTitle}
  • [プロセスID]: #{processInstanceId}
  • [プロセス開始ユーザ]: #{processInstanceInitQuserName}
  • [プロセス開始組織]: #{processInstanceInitQgroupName}
  • [プロセス開始日時]: #{processInstanceStartDatetime}
  • [プロセス連番]: #{processInstanceSequenceNumber}
  • [アプリID]: #{processModelInfoId}
  • [アプリ名]: #{processModelInfoName}
  • [<データ項目>]: #{#<データ項目の[フィールド名]>}
  • [アプリ変数]: ${var[<変数名>]}
  • [システム変数]: ${var[applicationRoot]}
アプリ変数に関する詳細は、「変数設定(アプリ変数)」を参照してください。
システム変数に関する詳細は、「設定ファイル(qbpms.config)」を参照してください。
[参照を挿入する...]アイコン
[変数の利用]ボタン
[ユーザ名]、[パスワード]、[ヘッダ名]、[ヘッダの値]、[パラメータ名]および[パラメータの値]に、変数の参照を挿入します。
  • [プロセス開始日時]: processInstanceStartDatetime
  • [<データ項目>]: #<データ項目の[フィールド名]>
  • [アプリ変数]: ${var[<変数名>]}
  • [システム変数]: ${var[applicationRoot]}
アプリ変数に関する詳細は、
「変数設定(アプリ変数)」を参照してください。
システム変数に関する詳細は、「設定ファイル(qbpms.config)」を参照してください。

仕様制限