メッセージ開始イベント（HTTP）

/ BPMNアイコン
メッセージ開始イベント（HTTP）

HTTP リクエストを待ち受ける URL を発行します。HTTP リクエストを受信すると、新規プロセスが自動開始されます。受信パラメータで受け取った値を業務データにセットすることができます。

Configs: 共通設定
  • 工程名
  • メモ
Configs: 編集の可否
  • データ項目
    • 編集の可否
      • （編集可）
      • （表示なし）
Configs: API キー
  • API キー
受信パラメータ、IP アドレス制限（別タブで開く）
アプリ
  • アプリ名
名前
  • イベント名
ノード番号
  • 番号
URL
  • 起動/受信URL
    • https://{YOUR_DOMAIN}/System/Event/MessageStart/{APP_ID}/{NODE_NUMBER}/start?key={API_KEY}
    • ${var[applicationRoot]}System/Event/MessageStart/{APP_ID}/{NODE_NUMBER}/start?key={API_KEY}
接続が許可されているネットワーク
  • （関連するIPアドレス制限の概要）
受信パラメータ
    • 受信パラメータ名 / 詳細 / 必須 / 受信する値について / 固定値
自動処理ログ
  • view_column （表示カラム）
    • drag_handledelete 日時（デフォルト）
    • drag_handledelete プロセスID（デフォルト）
    • drag_handledelete バージョン（デフォルト）
    • drag_handledelete 種別（デフォルト）
    • 追加
      • （全て追加）
      • ログ ID
      • アプリ ID
      • アプリ名
      • ノード番号
      • 工程名
      • ユーザ ID
（ログ一覧）
    • 日時 / プロセス ID / バージョン / 種別
  • （表示コントロール）
    • （ページサイズ）
      • 10, 20, 50, 100, 200, 500, 1000
    • ページ
親プロセスからのデータ可視性
  • データ項目
    • 親プロセスからのデータ可視性
      • （許可）
      • （不許可）

Capture

Notes

  • ワークフロー基盤の初期設定では、外部ネットワークからの通信は許可されていません
    • 外部ネットワークからの通信を許可するには、［システム設定］>［IPアドレス制限］の設定を変更してください（要システム管理権限）
    • 起動 URL ごとに、アクセス元のIPアドレスを制限することが可能です
  • 起動 URL は［URL（編集不可）］からクリップボードにコピーできます
  • 受信パラメータや IPアドレス制限の詳細は、プロパティ画面の［URL、受信パラメータ］ボタンから表示される別画面で確認します
  • 「API キー（key）」の値は、半角英数 / 最大100文字で任意に設定できます
    • API キーを空にすることも可能ですが、セキュリティ向上のため API キーを設定してください
  • 演算式が設定されている数値型データ項目は「編集可」に設定できません
  • リクエストは POST (application/x-www-form-urlencoded または multipart/form-data) で行ってください
  • ファイルを送信する場合、次のいずれかの方法で行ってください
    • プリアップロード API を利用して、プロセス開始の前にファイルをアップロード
      • API エンドポイント: /System/Event/MessageStart/{アプリID}/{ノード番号}/File/upload?key={APIキー}
      • HTTP メソッドとContent-Type: POST (multipart/form-data)
      • レスポンスで取得した “ファイルID” をプロセス開始時のリクエストの際にファイル型データ項目のパラメータ（q_XXX）の値として渡す
        • 添付ファイル（ファイルID）が複数ある場合は、パラメータを複数指定（選択型と同じ）
      • 1ファイルの最大（通信）サイズは 100MB だが、合計で 100 MBを超えるファイル群を送信できる
    • プリアップロードは行わず、プロセス開始のリクエスト時にファイルも送信
      • HTTP メソッドとContent-Type: POST (multipart/form-data)
      • リクエスト時の合計サイズは 100MB まで
  • 受信リクエストに “Questetra-Debug: true” ヘッダがついている場合、デバッグプロセスとして開始されます
    • 呼び出し元がデバッグプロセスの場合、あるいは明示的にヘッダを付加した場合
    • デバッグプロセスでのヒューマンタスク処理担当はアプリの最終編集者に割り当てられます
  • 正常に処理されると新規開始されたプロセスのID（数字）が返されます
    • HTTP レスポンスコードは 200、Content-Type は text/plain となります
  • 処理に失敗すると HTTP レスポンスコード 200 以外が返されます
    • 以下の場合、HTTP レスポンスコード 400、XML フォーマット (text/xml) でエラー内容が返されます
    • 以下の場合、400 番台の HTTP レスポンスコードが返されますが、レスポンス内容は規定されていません
      • 受信した HTTP リクエストが、受信できるデータのサイズ制限を超えている
      • HTTP リクエストの形式（メソッド / Content-Type）が指定の形式以外である
  • 同一環境内の［メッセージ送信中間イベント (HTTP)］ 等から、このイベントを呼び出してプロセスが開始された場合、「開始されたプロセスを子」「呼び出し元プロセスを親」とする、プロセスの親子関係が成立します
    • 子プロセスは親プロセスの ID を、プロセスの属性情報として持ちます
  • ［サービスタスク(子プロセス開始)］は、この開始イベントに HTTP リクエストを送信して子プロセスを開始するためのアイテムです
    • ［メッセージ開始イベント（HTTP）］が設置されると、それに対応した［サービスタスク(子プロセス開始)］が１つずつモデラのパレットに登場します

See also

「メッセージ開始イベント（HTTP）」への1件のフィードバック

  1. ピンバック: メッセージ開始イベント（HTTP） – Questetra Support

コメントは受け付けていません。

上部へスクロール

Questetra Supportをもっと見る

今すぐ購読し、続きを読んで、すべてのアーカイブにアクセスしましょう。

続きを読む