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

Overview

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

Configs: 共通設定

  • mode_edit_outline 工程名
  • mode_edit_outline メモ
Configs: 編集の可否

  • データ項目
    • check_circle 編集の可否
      • edit（編集可）
      • visibility_off（表示なし）
Configs: API キー

  • mode_edit_outline 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アドレス制限の概要）
  • 受信パラメータ
    • format_list_bulleted
      • 受信パラメータ名 / 詳細 / 必須 / 受信する値について / 固定値
  • 自動処理ログ
    • view_column （表示カラム）
      • drag_handledelete 日時（デフォルト）
      • drag_handledelete ケースID（デフォルト）
      • drag_handledelete バージョン（デフォルト）
      • drag_handledelete 種別（デフォルト）
      • arrow_drop_down 追加
        • （全て追加）
        • ログ ID
        • アプリ ID
        • アプリ名
        • ノード番号
        • 工程名
        • ユーザ ID
  • （ログ一覧）
    • format_list_bulleted
      • 日時 / ケース ID / バージョン / 種別
    • （表示コントロール）
      • arrow_drop_down （ページサイズ）
        • 10, 20, 50, 100, 200, 500, 1000
      • navigate_before ページ navigate_next
親ケースからのデータ可視性

  • データ項目
    • check_circle 親ケースからのデータ可視性
      • visibility（許可）
      • visibility_off（不許可）

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

  • Questetra BPM Suite の外からケースを開始する
  • M221: 特定URIにHTTPリクエストがあった時に自動的に開始されるように設定する
  • M411: “納品ケース” から “請求ケース” が自動開始されるように設定する
  • BPMN Icon: サービスタスク（子ケース開始）
  • BPMN Icon: メッセージ送信中間イベント（HTTP）

    • 関連記事

    Support Site 内リンク

    コミュニティ

    最新バージョン

    • Ver. 18.0 「プロセス」を「ケース」に名称変更し、Markdown 対応を拡充

    Questetra Supportをもっと見る

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

    続きを読む