受信タスク（HTTP）

/ BPMNアイコン
受信タスク（HTTP）

トークンを滞留させ、特定の URL で HTTP リクエストを待ち受けます。HTTP リクエストを受け取ると、トークンを先に進めます。パラメータで値を受け取り、業務データを上書きすることができます。

Configs: 共通設定
  • 工程名
  • メモ
Configs: 編集の可否
  • データ項目
    • 編集の可否
      • （編集可）
      • （表示なし）
Configs: 全般
  • API キー
  • 締め切り
    • arrow_drop_down
      • 締め切りなし
      • ［トークンが到達した時/プロセス開始日時］から
        • expand_all （数字を選択　1~9999）
          • arrow_drop_down ［分/時間/日/箇月］後
      • ［（日付型）の 00:00/（日時型）］から
        • expand_all（数字を選択　1~9999）
          • arrow_drop_down ［（空白：指定を解除）/分/時間/日/箇月］後
    • toggle_off 式（設定内容を EL式で表示）
受信パラメータ、IP アドレス制限（別タブで開く）
アプリ
  • アプリ名
名前
  • 工程名
ノード番号
  • 番号
URL
  • 起動/受信URL
    • https://{YOUR_DOMAIN}/System/ReceiveTask/HttpPost/{APP_ID}/{NODE_NUMBER}/receive?key={API_KEY}
    • ${var[applicationRoot]}System/ReceiveTask/HttpPost/{APP_ID}/{NODE_NUMBER}/receive?key={API_KEY}
接続が許可されているネットワーク
  • （関連するIPアドレス制限の概要）
受信パラメータ
    • 受信パラメータ名 / 詳細 / 必須 / 受信する値について
受信可否確認 API
  • https://{YOUR DOMAIN}/System/ReceiveTask/HttpPost/{APP ID}/{NODE NUMBER}/receive/check?processInstanceId={PROCESS ID}
自動処理ログ
  • view_column （表示カラム）
    • drag_handledelete 日時（デフォルト）
    • drag_handledelete プロセスID（デフォルト）
    • drag_handledelete バージョン（デフォルト）
    • drag_handledelete 種別（デフォルト）
    • 追加
      • （全て追加）
      • ログ ID
      • アプリ ID
      • アプリ名
      • ノード番号
      • 工程名
      • ユーザ ID
      • ユーザ名
（ログ一覧）
    • 日時 / プロセス ID / バージョン / 種別
  • （表示コントロール）
    • （ページサイズ）
      • 10, 20, 50, 100, 200, 500, 1000
    • ページ

Capture

Notes

  • 待ち受け URL は［URL（編集不可）］からクリップボードにコピーできます
  • 受信パラメータや IPアドレス制限の詳細は、プロパティ画面のボタンから表示される別画面で確認します
  • API キーを空にすることも可能ですが、セキュリティ向上のため、API キーを半角英数 / 最大100文字で設定してください
  • 演算式が設定されている数値型データ項目は「編集可」に設定できません
  • リクエストは POST (application/x-www-form-urlencoded または multipart/form-data) で行ってください
  • 正常に処理されると HTTP レスポンスコード 200 が返されます
    • レスポンス内容は「空」（text/plain）です
  • 処理に失敗すると HTTP レスポンスコード 200 以外が返されます
    • この場合トークンは滞留し、待ち受け状態が続きます
    • 以下の場合、HTTP レスポンスコード 400、XML フォーマット (text/xml) でエラー内容が返されます
      • 受信したデータが、データを格納するデータ項目の必須設定や最小/最大文字数、入力チェック内容を満たしていない
      • アプリID などが間違っている
      • トークンが工程に到達しておらず、API が受信可能な状態となっていない
      • R2212 HTTP リクエスト受信エラー時の XML フォーマット
    • 以下の場合、400 番台の HTTP レスポンスコードが返されますが、レスポンス内容は規定されていません
      • 受信した HTTP リクエストが、受信できるデータのサイズ制限を超えている
      • HTTP リクエストの形式（メソッド / Content-Type）が指定の形式以外である
  • HTTP リクエストにパラメータを指定することで、工程を終了させずにデータ項目の値を更新できます
    • パラメータ名：saveOnly、値：true
    • saveOnly=true が追加された HTTP リクエストでデータ受信した際には、必須チェックは行われません（タスク処理の「保存して中断」と同じ動作）
    • トークンは工程に滞留したままになります
      • トークンを進めるにはリクエストにsaveOnly=falseを指定するか、saveOnlyパラメータを付けずにリクエストを送信します
  • 締め切りを設定することができます
    • 締め切り時刻はプロセスの詳細や一覧に表示され、フィルター時の絞り込み条件として指定できます
    • 「締め切りなし」以外を指定すると、「トークンが到達した時」などの対象時刻の「1日後」がデフォルトで設定されます
    • 日付型データ項目を指定する場合は、「《データ項目》の 00:00」 から 「1日後（24時間後）」がデフォルトとなります
      • Ver.16.2 以前で、日付型が［締め切り］に適用された場合に当該日の 23:59 が締め切り時刻として処理されていたことと同様の動作となります
      • 「日後」のドロップダウンで「空白」を指定すれば、指定日の 00:00 が締め切り時刻となります
    • 計算された締め切りが「2101-01-01」以降になる場合、強制的に「2100-12-31」になります
    • ［toggle_off 式］をオンにすると、設定内容が EL式で表現されます
      • EL式を編集して、高度な設定も可能です
        • 例：processInstanceStartDatetime.addMonths(1).getFirstTimeInMonth() （プロセス開始日時の翌月1日の 00:00）
    • 締め切り到達時にトークンを先に進めることもできます
  • ［メッセージ受信中間イベント（HTTP）］の後継となるモデリング要素です
    • ［メッセージ受信中間イベント（HTTP）］で利用していた URL も当面は継続して利用できます
    • 旧 URL 形式：/System/Event/IntermediateMessage/{アプリID}/{ノード番号}/receive
    • 旧形式 URL にアクセスがあった場合、プロセスログに警告のメッセージが記録されます
      • リクエスト送信元の通信設定にて、送信先 URL を［受信タスク（HTTP）］の待ち受け URL に書き換えてください
      • Ver. 19.0（2027年4月）にて廃止予定

See also

上部へスクロール

Questetra Supportをもっと見る

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

続きを読む