ソリューションのバージョンを変更する

Automation Cloud でソリューションのデプロイを別のパッケージ バージョンにアップグレードまたはダウングレードする。

ヒント:

運用環境のデプロイをアップグレードする前に、まず専用のテスト デプロイでアップグレードを検証することをお勧めします。詳しくは、「 テスト環境でソリューションのアップグレードを検証する」をご覧ください。

[バージョンを変更] 操作では、デプロイを新しいパッケージ バージョンにアップグレードしたり、古いパッケージ バージョンにダウングレード (ロールバック) できます。

ソリューションをダウングレードしても、エンティティ、チョイス セット、Webhook は削除されません。

バージョン変更ワークフローを開きます

1. Orchestrator で、テナント レベルで [ ソリューション ] を選択します。

2. [デプロイ] タブで、更新するデプロイを見つけます。

   ヒント:

   デプロイで新しいパッケージ バージョンが利用可能になると、[ バージョン ] 列には現在のバージョン番号の横にアップグレード インジケーターが表示されます。行から直接 [ アップグレード ] を選択してフローを開始することもできます。

3. 行の端にある 3 点リーダー メニュー (⋮) を選択し、[ バージョンの変更] を選択します。

   [設定] フォームで [バージョンの変更] ワークフローが開きます。

セットアップ フォームに入力します

セットアップ フォームには、現在のデプロイの詳細が事前に入力されています。以下を確認して更新します。

フィールド	説明
パッケージ	このデプロイに関連付けられているソリューション パッケージ。読み取り専用です。
バージョン	対象のパッケージ バージョン。既定では、最新のパブリッシュ済みバージョン (または現在インストールされているバージョン以外の最新バージョン) が使用されます。ドロップダウンから別のバージョンを選択して、特定のバージョンにアップグレードまたはダウングレードします。
デプロイの名前	既存のデプロイの名前です。読み取り専用です。

[ バージョンを変更 ] を選択して続行するか、ドロップダウン矢印を選択して [ カスタマイズ ] を選択し、リソース エクスプローラーを開いてコンポーネントの変更を確認してから操作を実行します。

コンポーネントの変更を確認する

[カスタマイズ] を選択すると、リソース エクスプローラーに変更内容の概要が表示されます。

• 新たに追加されたコンポーネントです。プラス (+) アイコンでマークされています。これらのコンポーネントは、バージョンの変更後にターゲット環境で作成されます。

  If the target version adds a component with the same name as one this version change removes, the name conflict no longer blocks the operation: the name becomes available once the removal is confirmed. The conflict still blocks the version change if the resource with that name is not being removed.

• 削除されたコンポーネント。マイナス (−) アイコンのマークが付いています。これらのコンポーネントは、他のソリューションから参照されない限り、対象の環境から削除されます。その場合、コンポーネントは環境内に残りますが、ソリューションから削除されます。

  Removing a queue or storage bucket is blocked if something outside this version change still depends on it: a queue cannot be removed while a trigger that survives the version change still uses it, and a bucket cannot be removed while a queue, task catalog, or process that survives the version change still uses it as a retention target. Remove the dependent component in the same version change to proceed.

  If removing a queue or storage bucket would delete its last reference (it is not shared into any other folder), you must confirm the deletion before the version change can run. See Confirm the deletion of replaced resources below.

• 編集されたコンポーネント。アスタリスク (*) アイコンでマークされています。[ プロパティの違いを比較 ] パネルでは、プロパティ レベルのすべての変更が強調表示されます。

  設定可能なプロパティのみが変更されたコンポーネントは、編集されるコンポーネントとしてマークされません。編集されるコンポーネントは、設定可能なプロパティの既存の設定値を既定で保持しますが、パッケージ設定を使用するように切り替えることができます。プロパティ レベルの変更をすべて確認するには、[ プロパティの違いを比較 ] パネルを使用します。

必要に応じて、設定可能なコンポーネントのプロパティを編集し、[ 続行 ] を選択してバージョンを変更して操作を実行します。コネクション コンポーネントの場合、[認証の種類] プロパティはラジオ カードとして表示され、ドロップダウンではなく各カードにオプションのタイトルと説明が表示されます。

リソースのリンク、変更、リンク解除

リソース エクスプローラーが開いているときに、バージョン変更を実行する前に、コンポーネントを既存のリソースにリンクしたり、リンク先のリソースを変更したり、リンクを解除したりできます。リンクを解除すると、ソリューションと外部コンポーネントの間の接続が削除されます。アップグレード時に、リソースはリンクされたコンポーネントを再利用するのではなく、ソリューション フォルダー内に新たに作成されます。

This also applies to a resource that a previous version installed automatically: the link control no longer appears locked for these, and you can link them the same way as any other unlinked resource. Linking an installed resource is supported for the following resource types:

• プロセス
• アセット
• ストレージ バケット
• キュー
• Webhook
• コネクション
• インデックス

リンクされたコンポーネントには、リソース エクスプローラーで [リンク済み ] バッジが付けられます。リンクされたコンポーネントを選択すると、リンクされたリソースの情報を含むカードが表示されます。リソースがフォルダー内ではなくテナント レベルで存在する場合は、 テナント のチップが含まれます。

リソースをリンク、変更、またはリンク解除するには:

1. リソース エクスプローラーで、コンポーネントを選択します。
2. 以下のいずれかを選択します。
   • 既存のコンポーネントにリンク - リンクされていないコンポーネントをリンクします。
   • リンクされたコンポーネントを別のリソースにリンクするには、 を変更します。
   • リンクを解除 - 既存のリンクを削除します。

注:

A resource cannot be linked to its own installed copy.

[ 既存のピッカーにリンク ] ピッカーについて詳しくは、「ソリューションをデプロイする」の「 コンポーネントをリンク、変更、リンク解除 する」をご覧ください。

結果: リンク解除後、リソースは、バージョンの変更を適用する前に別の既存のコンポーネントにリンクしない限り、アップグレード時にソリューション フォルダー内に新たに作成されます。バージョンの変更が適用されると、リソースを再リンクできなくなります。

When you link a resource that a previous version installed automatically, the installed copy is retired: it's permanently deleted, together with its data, once the version change runs. See Confirm the deletion of replaced resources below.

Confirm the deletion of replaced resources

Linking an installed resource to an existing one, or removing a queue or storage bucket that has no other reference, permanently deletes the replaced resource and its data. Before the version change can run, you must confirm this loss.

An inline alert appears above the action buttons, listing the affected resources. Select Delete and deploy to confirm and continue, or use Validate or Save as draft to change the configuration instead. If you change the configuration after confirming, the alert reappears for a fresh confirmation.

If the version change is started without this confirmation (for example, through the API), the operation is rejected.

警告:

Deleted resources are not recovered by a later rollback. Rolling back re-creates the resource from the solution package as a new installed resource, without its previous data.

バージョン変更後

[ デプロイ ] タブでは、動作ステータスを監視できます。すべてのステータスについて詳しくは、「 デプロイのステータス」をご覧ください。

注:

バージョン変更後、デプロイのステータスは [非アクティブ] になります。非アクティブなデプロイは、アクティブ化する前に追加の構成が必要かどうかに応じて、 さらに [非アクティブ (アクティブ化の準備完了)] または [非アクティブ] (アクティブ化するには設定が必要) に分類されます。ソリューションを機能させるには、デプロイを手動でアクティブ化する必要があります。

結果: 選択したバージョンにデプロイがアップグレードまたはダウングレードされます。[デプロイ] タブに [バージョンを変更 - 前回の操作で成功] と表示され、[バージョン] 列には新しいバージョンが反映されます。