Shopify Flow: Actionの破壊的変更が減少

7月 21, 2026

FLOW UPDATE

Shopify Flow Action拡張:
破壊的変更が大幅に減少

フィールド変更時も旧ワークフローが継続実行、サーバー側で差異を柔軟にハンドリング可能に

2026年7月7日より、Shopify Flow Actionの設定フィールドを変更しても、旧バージョンを使用している既存のワークフローが実行停止になることがなくなりました。FlowランタイムはスキーマのMismatchを許容しエンドポイントにリクエストを送信し続けるため、パートナーサーバー側で差異を適切に処理する実装が求められます。

BACKGROUND

01従来の問題と今回の変更

これまでは、Action拡張のフィールド設定に少しでも変更があると、それを利用しているマーチャントの既存ワークフロー全てが「破壊的変更」として扱われていました。ランタイム検証が失敗し、パートナーサーバーにはリクエストすら届かない状態でした。新しい必須フィールドの追加・既存フィールドの削除どちらの場合でも、マーチャントのワークフローは即座に失敗していました。

USE CASES

02業務に活かせる具体ユースケース

課題: 必須フィールドを新たに追加したAction改訂版をリリースしたところ、旧バージョンを使い続けているマーチャントのワークフローが全て停止してしまった。
打ち手: エンドポイントで新しい必須フィールドが欠落している場合にデフォルト値を自動適用するロジックを実装する。ワークフローのリクエストはそのまま受信されるため、サーバー側だけで対応完結。
効果: マーチャントのワークフローがダウンタイムなしで継続稼働。Action改訂時のマーチャントサポート対応コストを削減できる。
技術メモ: 受信ペイロードをJSONスキーマで検証し、不足フィールドに対してdefault値を補完するミドルウェアを挟む構成が有効。

課題: 廃止したフィールドを削除した新しいAction設定に更新後、古いフィールドを送信してくる旧ワークフローのリクエストを正しく処理できるか不安があった。
打ち手: エンドポイントのリクエストハンドラーを「未知・余分なフィールドは無視する」ポリシーで実装する。Strict modeを無効にするか、ホワイトリスト外フィールドを除去してから処理する。
効果: 旧フィールドが含まれていてもエラーにならず処理が継続。フィールド削除による影響範囲を最小化できる。
技術メモ: Node.jsなら余分プロパティを無視するJSONスキーマバリデーター設定（additionalProperties: true）が参考になる。

課題: 複数のマーチャントが異なるバージョンのActionを並行利用しており、どのバージョンのペイロードが来るか予測しづらく、処理ロジックが複雑化していた。
打ち手: 受信ペイロードのフィールド構成を検査し、バージョンを自動判定するルーターロジックを実装。バージョンごとに適切なハンドラーに振り分ける。
効果: 全バージョンのワークフローに対して適切な処理を保証でき、移行期間中の安定稼働を維持できる。
技術メモ: ペイロードに明示的なバージョンフィールドがない場合は、特定フィールドの有無をセンティネルとして使うフィンガープリント判定が有効。

DEVELOPER NOTES