> For the complete documentation index, see [llms.txt](https://help.aximo.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aximo.autify.com/features-ja/test-execution-and-plans/test-plan-specifications.md).

# プランの管理

Aximo のプランでは、複数のケースをまとめて実行し、APIトリガー、スケジュール、通知をプラン単位で管理できます。

## プランを作成する

プランは、同じワークスペース内のケースをまとめて実行する単位です。作成時には、プラン名と説明を設定できます。

<figure><img src="/files/tMyelGyPeAOXaSzjI8ER" alt="プラン一覧のスクリーンショット"><figcaption><p>プラン一覧</p></figcaption></figure>

{% hint style="warning" %}
**Title** は必須です。500 文字以内で入力してください。
{% endhint %}

1. ワークスペースで **プラン** タブを開きます。
2. **新規プラン** をクリックします。

<figure><img src="/files/dM3nR8XtyECR5GgRi1um" alt="新規プラン作成画面のスクリーンショット"><figcaption><p>新規プラン作成画面</p></figcaption></figure>

3. **Title** にプラン名を入力します。
4. （任意）**Description** にプランの説明を入力します。
5. **Create Plan** をクリックします。

## プランの基本情報を編集する

プラン作成後も、タイトルと説明を変更できます。

{% hint style="warning" %}
タイトルは必須です。空のままでは変更を保存できません。
{% endhint %}

1. プラン一覧で、編集するプランを開きます。
2. タイトルまたは説明の編集画面を開きます。
3. **タイトル** または **説明** を変更します。
4. **変更を保存** をクリックします。

## ケースをプランに追加する

プランには、同じワークスペース内のケースを追加できます。追加したケースはプランにリンクされるだけで、ケース本体は複製されません。追加できるケースの **タイプ** には Web、モバイル、デスクトップ、**マルチデバイス** が含まれます。

{% hint style="info" %}
すでにプランに追加済みのケースは、追加対象の一覧には表示されません。ケース名や作成者情報で検索できます。
{% endhint %}

1. プラン詳細で **ケースを追加** をクリックします。

<figure><img src="/files/pRvIL0Uje4EVnLN3aGdc" alt="プランにケースを追加ダイアログのスクリーンショット"><figcaption><p>プランにケースを追加ダイアログ</p></figcaption></figure>

2. （任意）検索ボックスに、ケース名や作成者情報を入力します。
3. 追加するケースの **追加** をクリックします。
4. 追加したケースが **リンクされたケース** に表示されていることを確認します。

## ケースをプランから削除する

プランからケースを削除しても、ケース本体は削除されません。削除されるのは、プランとケースのリンクだけです。

{% hint style="info" %}
この操作で削除されるのは、プランとケースのリンクだけです。ケース本体を削除する操作ではありません。
{% endhint %}

1. プラン詳細の **リンクされたケース** で、削除するケースを見つけます。
2. 対象ケースの削除アイコンをクリックします。
3. ケースが **リンクされたケース** から消えたことを確認します。

## プランを実行する

プランを実行すると、プランに含まれるケースごとにセッションが作成されます。実行開始時に選択したモデルは、プラン内のすべてのケースに適用されます。

{% hint style="warning" %}

* ケースが 0 件のプランは実行できません。
* モバイル ケースには、ケースまたはプランにデバイス設定が必要です。
* デスクトップ ケースには、プランに 1 台以上の登録済みデバイスが必要です。
* マルチデバイス ケースは、ケースに保存されたデバイス構成で実行されます。
  {% endhint %}

1. プラン詳細で **実行** をクリックします。

<figure><img src="/files/VqP6l6rEFCtGYiJ9xTYO" alt="プラン実行モーダルのスクリーンショット"><figcaption><p>プラン実行モーダル</p></figcaption></figure>

2. **モデル** で、実行に使うモデルを選択します。
3. **実行** をクリックします。
4. 実行進捗で、完了件数、成功件数、失敗件数を確認します。

{% hint style="info" %}
**実行進捗** は実行中のプランのリアルタイム状況を表示し、実行が完了すると非表示になります。完了した実行は **実行履歴** に記録され、あとから [プランの結果を確認する](#プランの結果を確認する) の手順で参照できます。
{% endhint %}

プラン実行は、各ケース種別に応じた実行枠で処理されます。組織の同時実行上限に空きがある場合、複数のケースが並列に実行されます。上限に達している場合、残りのケースは待機します。

## 実行中のプランをキャンセルする

実行中または待機中のプラン実行はキャンセルできます。

{% hint style="warning" %}
キャンセルすると、未開始のケースはスキップされ、実行中だったケースは **キャンセル済み** になります。完了済み、失敗済み、キャンセル済みのプラン実行はキャンセルできません。
{% endhint %}

1. プラン詳細の **実行進捗** で、実行中のプランを確認します。

<figure><img src="/files/qpSyfLnASGOi5LiOKE1I" alt="実行進捗と実行をキャンセルのスクリーンショット"><figcaption><p>実行進捗と実行をキャンセル</p></figcaption></figure>

2. **実行をキャンセル** をクリックします。
3. 実行ステータスが **キャンセル済み** になったことを確認します。

## プランの結果を確認する

プラン実行が完了すると、実行履歴と実行詳細で結果を確認できます。各ケースから作成されたセッション詳細にも移動できます。

{% hint style="info" %}
プラン全体の結果は **完了**、**失敗**、**キャンセル済み** などで表示されます。ケースごとの結果は成功件数、失敗件数、スキップされたケース、**キャンセル済み** のケースで確認できます。
{% endhint %}

1. プラン詳細で **実行履歴** を確認します。

<figure><img src="/files/BQAQjPFuNm4SyrY5do25" alt="実行履歴のスクリーンショット"><figcaption><p>実行履歴</p></figcaption></figure>

2. 対象の実行履歴で **表示** をクリックします。

<figure><img src="/files/XDIJcQfnv3WhmKoz74Q0" alt="プラン実行結果のスクリーンショット"><figcaption><p>プラン実行結果</p></figcaption></figure>

3. ケースごとのステータス、成功件数、失敗件数、総ケース数を確認します。
4. ケース単位の詳細を確認するには、対象ケースのセッションリンクを開きます。

## モバイル設定を管理する

プランにモバイル ケースが含まれる場合、プラン詳細に **アプリ & デバイス** が表示されます。iOS / Android ごとに、実行に使うデバイスとアプリを設定できます。

{% hint style="warning" %}
モバイル ケースにはデバイス設定が必要です。アプリは任意ですが、設定する場合はプラットフォームごとに最大 3 件まで選択できます。**期限切れ** または **更新中...** と表示されているアプリは選択できません。**期限切れ** のアプリは **アプリ** タブで再アップロードしてから選択してください。アプリの選択ルール（プライマリの扱いなど）は [アプリを管理する](https://help.aximo.autify.com/features-ja/test-execution-and-plans/pages/VDRNF7PVU4lIXN2ftKSW#モバイル-セッションやケースで使用する) を参照してください。
{% endhint %}

1. プラン詳細の **アプリ & デバイス** で、**iOS** または **Android** を選択します。

<figure><img src="/files/psYQvlWGwcXjbVn3WIB1" alt="アプリ &#x26; デバイスセクションのスクリーンショット"><figcaption><p>アプリ &#x26; デバイスセクション</p></figcaption></figure>

2. **デバイスを追加** をクリックします。

<figure><img src="/files/BmXTJoPW4Vf7Dxkno4RZ" alt="デバイスを追加ダイアログのスクリーンショット"><figcaption><p>デバイスを追加ダイアログ</p></figcaption></figure>

3. 追加するデバイスを選択します。
4. **完了** をクリックします。
5. （任意）**アプリ** で、既存のアプリを選択するか、新しいアプリをアップロードします。

{% hint style="info" %}
プランに複数のデバイスを設定すると、モバイル ケースは対象デバイスごとに実行されます。
{% endhint %}

## デスクトップ デバイスを管理する

プランにデスクトップ ケースが含まれる場合、プラン詳細に **Devices** が表示されます。プランで使う登録済みデバイスを選択します。

<figure><img src="/files/cZgS0HSuORNFNu8TaQPa" alt="プラン詳細のデバイス セクションのスクリーンショット"><figcaption><p>プラン詳細のデバイス セクション</p></figcaption></figure>

{% hint style="warning" %}
デスクトップ ケースには、プランに 1 台以上の登録済みデバイスが必要です。選択したデバイスが利用できない場合は、デバイスが利用可能になるまで待つか、選択を変更しないとプランを開始できません。
{% endhint %}

1. プラン詳細の **Devices** で **Add device** をクリックします。

<figure><img src="/files/NuegUnsOFPNd9NJdbDfO" alt="デバイスを選択モーダルのスクリーンショット"><figcaption><p>デバイスを選択モーダル</p></figcaption></figure>

2. モーダルで、1 台以上の登録済みデバイスを選択します。
3. **確定** をクリックします。
4. **Devices** に選択したデバイスが表示されることを確認します。

{% hint style="info" %}
プランに複数の登録済みデバイスを設定すると、各デスクトップ ケースは選択した各デバイスで 1 回ずつ実行されます。
{% endhint %}

## APIトリガーを有効にする

APIトリガーを有効にすると、外部の CI/CD パイプラインやスクリプトからプランを実行できます。具体的な手順、APIエンドポイントの確認方法、CI/CD への組み込みは、[APIトリガーでの実行](/features-ja/test-execution-and-plans/api-cicd-integration.md) を参照してください。

## スケジュールを設定する

スケジュールを設定すると、プランを定期的に実行できます。スケジュールはプランごとに 1 件だけ保持されます。スケジュールを保存すると、その時点で有効になります。

{% hint style="warning" %}
スケジュールの時刻は UTC で扱われます。毎週のスケジュールでは曜日が必須で、毎月のスケジュールでは日が必須です。
{% endhint %}

1. プラン詳細で **スケジュールを設定** をクリックします。

<figure><img src="/files/hlo07AT4LzZbH7i2t4YE" alt="スケジュール設定モーダルのスクリーンショット"><figcaption><p>スケジュール設定モーダル</p></figcaption></figure>

2. **頻度** を選択します。
3. 頻度に応じて、時刻、分、曜日、日を設定します。
4. **モデル** を選択します。
5. **スケジュールを保存** をクリックします。

{% hint style="info" %}
保存したスケジュールでは、ここで選択したモデルを使って定期実行します。
{% endhint %}

## 通知を設定する

プランには通知を設定できます。通知は Webhook で送信され、Slack、Microsoft Teams、Google Chat、カスタム Webhook に対応しています。プラン実行が終了したタイミングで送信されます。

{% hint style="warning" %}
通知を保存するには、名前と Webhook URL が必要です。通知先のレスポンスが 2xx 以外の場合、通知は失敗として記録されます。
{% endhint %}

1. プラン詳細の **通知** で、**Webhook を追加** をクリックします。

<figure><img src="/files/lwmlCZk0yMzxuvgZ5Xt8" alt="Webhook を追加モーダルのスクリーンショット"><figcaption><p>Webhook を追加モーダル</p></figcaption></figure>

2. 通知先の種別を選択します。
3. **名前** を入力します。
4. **条件** を選択します。
5. **Webhook URL** を入力します。
6. （任意）通知言語を選択します。
7. （任意）**Webhook をテスト** をクリックし、通知先にテスト通知が届くことを確認します。
8. **保存** をクリックします。

{% hint style="info" %}
カスタム Webhook では、JSON ペイロードや任意のシークレットを設定できます。シークレットを設定した場合、通知リクエストに `X-Aximo-Signature` ヘッダーが付与されます。
{% endhint %}

## プランを削除する

プランを削除しても、プランに含まれていたケースは削除されません。削除されるのは、プラン、ケースとのリンク、プランに紐づく設定です。

{% hint style="danger" %}
削除したプランは復元できません。ケース本体は削除されませんが、プランに紐づく設定は削除されます。
{% endhint %}

1. プラン一覧で、削除するプランを見つけます。
2. 対象プランの削除アイコンをクリックします。

<figure><img src="/files/Q2zYbNrvxvbbvMb36Gml" alt="プラン削除確認ダイアログのスクリーンショット"><figcaption><p>プラン削除確認ダイアログ</p></figcaption></figure>

3. 確認ダイアログで **削除** をクリックします。

## 参考情報

* [プランについて](/features-ja/test-execution-and-plans/plans-overview.md)
* [セッションとケースについて](/features-ja/test-case-creation/test-case-creation-overview.md)
* [ケースの作成](/features-ja/test-case-creation/create-test-case.md)
* [利用状況・クレジットの確認](/features-ja/settings/usage-and-credits.md)
* [アプリを管理する](/features-ja/memories/memor/memory-apps.md)