Workato EDI - ポーリングバケット内の新規トランザクショントリガー
ポーリングバケット内の新規トランザクショントリガーは、指定したポーリングバケットでOrderfulの新規トランザクションを監視します。 このトリガーは、取得した各トランザクションのデリバリーを自動的に承認し、データの重複を防ぐため、取得直後にバケットをクリアします。 取得したトランザクションのDelivery statusは、DeliveredではなくSentとして表示されます。 これは、承認が完了する前の取得時点でステータスがキャプチャされるためです。
ANY FILEトランザクション
Any Fileトランザクションには、Messageオブジェクト出力にDownload URLデータピルを含むネストされたDownloadオブジェクトが含まれます。 ファイルの内容を取得するには、このデータピルをトランザクションファイルのダウンロードアクションにマッピングします。
Any Fileトランザクションの詳細については、Orderfulのドキュメントを参照してください。
トランザクションサイズの制限
このトリガーは、50 MBを超えるトランザクションをスキップします。 これらのDelivery statusはDeliveredに更新されずSentのままとなり、スキップされた各トランザクションは、出力に表示されないまま、トリガーに設定されたバッチサイズにカウントされます。
実際には、このサイズのトランザクションは非常にまれです。 発生した場合は、OrderfulとWorkatoで手動で処理してください。
入力
| 入力フィールド | 説明 |
|---|---|
| バケットID | 新規トランザクションを監視する予定のポーリングバケットのIDを指定します。 ポーリングバケットIDを取得するには、Orderfulにサインインし、Communication Channelsに移動して通信チャネルを選択し、Retrieval URLを見つけます。 ポーリングバケットIDは、URL内の最後の数字シーケンスです。 たとえば、チャネルの取得URLが https://api.orderful.com/v3/polling-buckets/12345の場合、バケットIDは12345です。 |
| トリガーポーリング間隔 | 新規イベントをチェックする頻度を決定します。 空白のままにした場合、デフォルトは5分です。 許可される最小値は5分です。 |
| バッチサイズ | バッチごとに取得するトランザクション数を指定します。 1～100の値を指定できます。 空白のままにすると、デフォルトで100になります。 |
出力
| 出力フィールド | 説明 |
|---|---|
| トランザクションID | 取引の一意の識別子。 |
| URL | Transactionリソースの完全なAPIエンドポイントURL。 |
| バージョン | 使用されたAPIバージョン。 例：v3。 |
| 送信者 | 送信者取引先に関する詳細を含むオブジェクト。 |
| Interchange control header（ISA）ID（Sender） | 送信者のインターチェンジ制御ヘッダーID。 |
| Interchange control header（ISA）ID qualifier（Sender） | 送信者のインターチェンジ制御ヘッダーIDの修飾子。 |
| テストインターチェンジ制御 ヘッダー（ISA）ID（送信者） | テスト送信者インターチェンジ制御ヘッダーID。 |
| テストインターチェンジ制御 ヘッダー（ISA）ID修飾子（送信者） | テスト送信者のインターチェンジ制御ヘッダーIDの修飾子。 |
| 受信者 | 受信者取引先に関する詳細を含むオブジェクト。 |
| 名前（送信者） | 送信者取引先の名前。 |
| Interchange control header（ISA）ID（Receiver） | 受信者のインターチェンジ制御ヘッダーID。 |
| Interchange control header（ISA）ID qualifier（Receiver） | 受信者のインターチェンジ制御ヘッダーIDの修飾子。 |
| テストインターチェンジ制御 ヘッダー（ISA）ID（受信者） | テスト受信者インターチェンジ制御ヘッダーID。 |
| テストインターチェンジ制御 ヘッダー（ISA）ID修飾子（受信者） | テスト受信者のインターチェンジ制御ヘッダーIDの修飾子。 |
| 名前（受信者） | 受信者取引先の名前。 |
| タイプ | トランザクションタイプを説明するオブジェクト。 |
| 名前（タイプ） | 850_PURCHASE_ORDERなどのTransactionタイプ。利用可能なトランザクションタイプの詳細については、Orderfulのドキュメントを参照してください。 |
| ストリーム | トランザクションがプロダクション通信チャネルとテスト通信チャネルのどちらに送信されたかを示します。 テスト通信チャネルの場合はTEST、プロダクション通信チャネルの場合はLIVEを返します。 |
| ビジネス番号 | トランザクションの主要なビジネスドキュメント識別子。 値はトランザクションタイプによって異なります。 たとえば、850の場合は発注番号、810の場合は請求書番号と同じ値です。 |
| 参照識別子 | 処理済みトランザクションからOrderfulがキャプチャするEDIエンベロープヘッダー（インターチェンジ、機能グループ、トランザクションセット）のコントロール番号。 |
| 値（参照識別子） | EDIエンベロープから取得された制御番号の値。 |
| タイプ（参照識別子） | 制御番号の取得元であるEDIエンベロープヘッダー。 INTERCHANGE、GROUP、またはTRANSACTIONを返します。 |
| 所有者（参照識別子） | 参照識別子を所有する当事者。 SENDERまたはRECEIVERを返します。 |
| メッセージ | トランザクションメッセージの詳細を含むオブジェクト。 Any Fileトランザクション用のネストされたDownloadオブジェクトも含みます。 |
| URL（Message） | トランザクションメッセージを取得するためのAPIエンドポイントURL。 |
| トランザクションメッセージ（Message） | 標準EDIトランザクションは、配信されたトランザクションの完全なトランザクションメッセージをJSONで返します。 データを元のEDI形式に変換するConvert data formatアクションなどのダウンストリームステップにトランザクションメッセージデータピルをマッピングしたり、JSONツール by Workatoなどの別のコネクターを使用して、完全なメッセージの詳細なデータピルを解析したりできます。 Any Fileトランザクションでは、このフィールドに値が入力されません。 ファイルの内容を取得するには、ダウンロードURLデータピルを使用し、トランザクションファイルのダウンロードアクションに渡します。 |
| ダウンロード（メッセージ） | トランザクションファイルのダウンロード詳細を含むオブジェクト。 Any Fileトランザクションに対して入力されます。 |
| ダウンロードURL（Download） | トランザクションファイルのダウンロードURL。 ファイルの内容を取得するには、ダウンロードURLデータピルをDownload transaction fileアクションにマッピングします。 URLは取得から24時間後に期限切れになり、バケットがポーリングされるたびに更新されます。 |
| 検証ステータス | VALIDまたはINVALIDなどのEDI検証のステータス。トランザクションステータスの詳細については、Orderfulのドキュメントを参照してください。 |
| 配信ステータス | SENTまたはFAILEDなどの取引パートナーへのDeliveryのステータス。トランザクションステータスの詳細については、Orderfulのドキュメントを参照してください。 |
| 確認ステータス | ACCEPTED、REJECTED、NOT_ACKNOWLEDGEDなどの確認応答のステータス。詳細については、Orderfulのトランザクションステータスドキュメントを参照してください。 |
| 作成日時 | トランザクションが作成された日時のタイムスタンプ。 |
| 最終更新日時 | トランザクションが最後に更新された日時のタイムスタンプ。 |
| 確認 | 確認応答の詳細を含むオブジェクト。 |
| URL（確認） | 利用可能な場合、確認応答のAPIエンドポイントURL。 |
| 配信 | 配信の詳細を含むオブジェクト。 |
| 配信ID（Delivery） | Deliveryの一意の識別子。 |
| URL（Delivery） | 配信のAPIエンドポイントURL。 |
| 承認（Delivery） | 配信を承認するためのAPIエンドポイントURLを含むオブジェクト。 |
| URL（Approve） | 配信を承認するためのAPIエンドポイントURL。 |
| 失敗（Delivery） | 配信を失敗にするためのAPIエンドポイントURLを含むオブジェクト。 |
| URL（Fail） | 配信を失敗にするためのAPIエンドポイントURL。 |
最終更新日: