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

ヒント:

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

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

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

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

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

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

   ヒント:

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

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

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

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

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

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

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

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

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

• Newly added components, marked with a plus (+) icon. These components will be created in the target environment after the version change.

• Removed components, marked with a minus (−) icon. These components will be removed from the target environment unless they are referenced by other solutions. In that case, the components remain in the environment but are removed from the solution.

• Edited components, marked with an asterisk (*) icon. The Compare property differences panel highlights all property-level changes.

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

必要に応じて、設定可能なコンポーネントのプロパティを編集し、[ 続行] を選択してバージョンを変更し 、操作を実行します。

リンクされたリソースのリンクを解除する

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

リソースのリンクを解除するには:

1. リソース エクスプローラーで、リンクを解除するリソースを選択します。リンクされたリソースには、 リンクされた バッジが表示されます。
2. リソースの詳細では、リソースがリンクされており、デプロイの一部として作成されないことを確認する情報バナーが表示されます。そのバナーの [ リンクを解除 ] を選択します。

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

バージョン変更後

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

注:

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

Result: The deployment is upgraded or downgraded to the selected version. The Deployments tab shows Change version - Successful in Last operation, and the Version column reflects the new version.