> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ワークフロー V1 移行ツール

> プラットフォーム内移行ツールを使用して、既存のワークフロー V1 をワークフロー V2 に移行します。

<Info>
  移行ツールは **2026年6月1日（v2.1.0）** より利用可能です。ワークフロー V1 は **2026年9月7日** に削除されます — 移行手順は以下をご確認ください。
</Info>

ワークフロー V1 は [ワークフロー V2](/tools/workflows-v2) に置き換えられ、リデザインされたビジュアルキャンバス、より多くのトリガータイプ、改善されたデバッグ機能、バージョン履歴が導入されています。ワークフローをゼロから再構築するのではなく、プラットフォーム内移行ツールを使用することで、既存の V1 ワークフローを V2 に直接移行できます。

非推奨のタイムラインと変更内容の詳細については、[ワークフロー V1 非推奨](/changelogs/feature-deprecations/workflows-v1-deprecation) ページをご参照ください。

## 事前に準備すること

<CardGroup cols={2}>
  <Card title="移行ツールが利用可能になりました" icon="circle-check">
    Migrate Flow ツールは 2026年6月1日より利用可能です。今日、任意の V1 ワークフローを移行できます — V1 ワークフローは 2026年9月7日まで通常通り動作し続けます。
  </Card>

  <Card title="下流の更新を計画してください" icon="triangle-exclamation">
    移行後、V1 ワークフローを呼び出しているすべてのエージェントやインテグレーションは、2026年9月7日の V1 削除前に新しい V2 ワークフローを指すように更新が必要です。
  </Card>
</CardGroup>

## ワークフローの移行方法

<Warning>
  移行後、ワークフローの **各ステップを個別に実行し検証** する必要があります。エンドツーエンドの実行だけでは不十分です。ステップごとの検証は、V1 と V2 の間の微妙な動作の違い（変数参照、トリガーペイロードの形状、分岐、リトライなど）を特定する唯一の信頼できる方法です。
</Warning>

<Steps>
  <Step title="V1 ワークフローの一覧を確認する">
    **Workflows** に移動し、引き続き使用されているすべての V1 ワークフローを一覧にします。以下をメモします：

    * **エージェント、API、または外部インテグレーション** によってトリガーされるワークフロー — 移行後に下流の更新が必要です。
    * 各ワークフローの **オーナー** — 移行後に正しい担当者が検証します。
    * 各ワークフローの最近の正常な V1 実行の **参照出力** — 後で V2 の出力と比較します。
  </Step>

  <Step title="V1 ビルダーでワークフローを開く">
    **Workflows** に移動し、移行したいワークフローを開きます。安定した動作状態であることを確認してください — まず公開済みでテスト済みのフローを移行します。
  </Step>

  <Step title="「Migrate Flow」をクリックする">
    V1 ビルダーの **右上隅** で **Migrate Flow** をクリックします。これにより、V2 カタログに対する自動バリデーションが開始されます。
  </Step>

  <Step title="移行サマリーを確認する">
    移行モーダルに **Pass** または **Fail** のステータスと、エラーや警告が表示されます。

    | 結果            | 意味                             | 対応方法                            |
    | :------------ | :----------------------------- | :------------------------------ |
    | **Pass**      | すべてのアクションと設定が V2 と互換性があります     | **Continue & Import** をクリックして続行 |
    | **Fail（警告）**  | 一部のアクションが V2 で異なる動作をする可能性があります | 自動移行是不可能 — サポートチケットを送信          |
    | **Fail（エラー）** | 互換性のないアクションが検出されました            | 自動移行是不可能 — サポートチケットを送信          |

    <Warning>
      バリデーションに失敗したワークフローは自動移行できません。Automation Anywhere アカウントマネージャーに連絡するか、[サポートポータル](https://apeople.automationanywhere.com/) でチケットを開いてアシスト付き移行を依頼してください。
    </Warning>
  </Step>

  <Step title="「Continue & Import」をクリックする">
    これにより、すべてのアクション、トリガー、設定が引き継がれた V2 バージョンのワークフローが作成されます。元の V1 ワークフローは削除も無効化も **されません**。
  </Step>

  <Step title="V2 ワークフローの各ステップを実行し検証する">
    単一のエンドツーエンド実行に **依存しない** でください。ワークフローをステップごとに確認します：

    1. **V2 ビルダーを開き** キャンバスを確認します — V1 のすべてのアクション、トリガー、分岐、ループ、接続が存在することを確認します。
    2. **各ステップの設定を検証します** — 資格情報、入力フィールド、マッピングされた変数、ドロップダウン選択、式参照がすべて V1 と一致することを確認します。
    3. 現実的な入力ペイロードを使用して、**テスト/デバッグモードでワークフローを実行** します。
    4. **各ステップで実行詳細を開き** 以下を確認します：
       * ステップが **正常に実行された** （エラーなし、スキップ状態なし）
       * ステップへの **入力** が V1 が送信した内容と一致する
       * ステップの **出力** が V1 の参照出力と一致する（形状と値）
       * 下流の **変数参照** が正しく解決される（`undefined` なし、未レンダリングの `{{...}}` なし）
       * **分岐/ループロジック** が V1 と同じパスに評価される
       * **リトライ、タイムアウト、エラーハンドラーステップ** が期待通りに動作する
    5. **エッジケースの入力** （空のフィールド、大きなペイロード、失敗パス）で再実行し、ステップごとのチェックを繰り返します。
    6. V1 の参照出力に対する **不一致を記録** し、公開前に V2 ビルダーで修正します。

    <Tip>
      V2 の **Executions log** を使用して、各ステップの入力/出力 JSON を詳しく確認します。これは V1 と V2 の間の変数マッピングやスキーマの違いを特定する最も速い方法です。
    </Tip>
  </Step>

  <Step title="V2 ワークフローを公開する">
    すべてのステップが検証された後にのみ公開します。**Publish** をクリックして移行されたワークフローを有効にします。V2 は完全な **バージョン履歴** を保持するため、必要に応じて以前のバージョンにロールバックできます。

    <Note>
      元の V1 ワークフローは引き続きアクセス可能で、**2026年9月7日** の V1 削除まで動作し続けます。その日までに、V1 ワークフローを呼び出していたエージェントやインテグレーションを新しい V2 ワークフローを指すように更新する必要がある場合があります。
    </Note>
  </Step>

  <Step title="下流の呼び出し元を更新する">
    **2026年9月7日** までに、V1 ワークフローを呼び出しているすべてのものを新しい V2 ワークフローを指すように更新します：

    * このワークフローを呼び出すエージェント
    * V1 のエンドポイントまたは ID を使用している外部インテグレーション
    * 自動化およびスケジュールジョブ
  </Step>

  <Step title="本番環境で V2 ワークフローを監視する">
    最初の数回の本番実行では：

    * **Executions log** を監視し、各ステップの出力を V1 の参照出力と照合します。
    * V1 ワークフローを有効な状態に保ちます（**2026年9月7日** までアクセス可能です）ため、リグレッションが発生した場合にトラフィックを再ルーティングできます。
    * 必要に応じて V2 の **バージョン履歴** でロールバックします。
  </Step>

  <Step title="残りの各 V1 ワークフローに対して繰り返す">
    移行は **ワークフローごと** に行います。一括操作はありません。ステップ 1 のインベントリを順番に処理し、すべての V1 ワークフローが移行、ステップ検証、公開されるまで続けます。
  </Step>
</Steps>

## バリデーション：Pass と Fail

移行ツールは移行前に V1 ワークフローを検証します。バリデーションの結果を理解することで、適切な対応を判断できます。

| 結果            | 意味                             | 対応方法                            |
| :------------ | :----------------------------- | :------------------------------ |
| **Pass**      | すべてのアクションと設定が V2 と互換性があります     | **Continue & Import** をクリックして続行 |
| **Fail（警告）**  | 一部のアクションが V2 で異なる動作をする可能性があります | 移行不可 — サポートチケットを送信              |
| **Fail（エラー）** | 互換性のないアクションが検出されました            | 移行不可 — サポートチケットを送信              |

<Warning>
  バリデーションに失敗したワークフローは自動移行できません。Automation Anywhere アカウントマネージャーに連絡するか、[Automation Anywhere サポートポータル](https://apeople.automationanywhere.com/) でチケットを開いてアシスト付き移行を依頼してください。
</Warning>

## 移行後

ワークフローが V2 で公開されると：

* **元の V1 ワークフローは引き続きアクセス可能で動作し続けます** — **2026年9月7日** の V1 削除まで。移行によって V1 ワークフローが無効化または削除されることはありません。
* V1 ワークフローのエンドポイントを呼び出していた **エージェント、インテグレーション、または自動化** は、2026年9月7日までに新しい V2 ワークフローを指すように再設定が必要です。
* V2 の **Executions log** を使用して実行を監視し、移行されたワークフローが期待通りに動作することを確認します。
* V2 の **バージョン履歴** は公開されたすべての状態を保存するため、必要に応じて以前のバージョンにロールバックできます。

## よくあるご質問

<AccordionGroup>
  <Accordion title="すべてのワークフローを一括で移行できますか？">
    いいえ。移行は V1 インターフェースの **Migrate Flow** ボタンを使用して、ワークフローごとに個別に実行されます。各ワークフローは個別に検証および移行する必要があります。
  </Accordion>

  <Accordion title="移行後に V1 ワークフローはどうなりますか？">
    元の V1 ワークフローは引き続きアクセス可能で、**2026年9月7日** まで動作し続けます。移行後も無効化または削除されることはありません。2026年9月7日には、すべての V1 ワークフローが削除され、移行されていないものは動作しなくなります。
  </Accordion>

  <Accordion title="移行後にインテグレーションを更新する必要がありますか？">
    はい。移行後、V1 ワークフローをエンドポイントまたは ID で呼び出しているエージェント、外部インテグレーション、または自動化プロセスを、新しい V2 ワークフローを指すように更新する必要があります。
  </Accordion>

  <Accordion title="ワークフローがバリデーションに失敗した場合はどうすればよいですか？">
    エラーまたは警告のあるワークフローは、ツールを使用して自動移行できません。[Automation Anywhere サポートポータル](https://apeople.automationanywhere.com/) でサポートチケットを送信して、アシスト付き移行を依頼してください。
  </Accordion>

  <Accordion title="ワークフローの設定は保持されますか？">
    移行ツールは、既存のワークフロー設定を V2 に引き継ぐように設計されています。移行後、V2 ビルダーですべてのステップ、トリガー、設定を確認し、公開前にテストしてください。
  </Accordion>

  <Accordion title="移行の期限はいつですか？">
    ワークフロー V1 は **2026年9月7日** に削除されます。移行ツールは 2026年6月1日から利用可能で、約3ヶ月間の移行期間があります。V1 ワークフローはこの期間中も動作し続けますが、下流のインテグレーションの更新と V2 での動作確認に十分な時間を確保するため、できるだけ早く移行することをお勧めします。完全なタイムラインについては [ワークフロー V1 非推奨](/changelogs/feature-deprecations/workflows-v1-deprecation) ページをご参照ください。
  </Accordion>
</AccordionGroup>

## サポート

移行に関する支援または互換性のないワークフローに関するご質問は、Automation Anywhere アカウントマネージャーに連絡するか、[Automation Anywhere サポートポータル](https://apeople.automationanywhere.com/) でチケットを開いてください。

<CardGroup cols={2}>
  <Card title="ワークフロー V1 非推奨" icon="triangle-exclamation" href="/changelogs/feature-deprecations/workflows-v1-deprecation">
    完全な非推奨タイムライン、影響の詳細、および変更内容。
  </Card>

  <Card title="ワークフロービルダー V2" icon="arrow-right" href="https://ai-kb.automationanywhere.com/tools/workflows-v2">
    ワークフロー V2 の新機能と更新されたキャンバスの使用方法を確認できます。
  </Card>
</CardGroup>
