IBM FileNet P8, バージョン 5.2.1            

アドオンのアップグレード

Content Engine の API には、UpgradeAddOn インターフェースが用意されています。このインターフェースによって、あるアドオン・セットをオブジェクト・ストア上の別のアドオン・セットでアップグレードできます。 Addon オブジェクトと同様に、UpgradeAddon> オブジェクトをオブジェクト・ストア内にインストールするには、その前にまずドメインの Global Configuration Database (GCD) 内で登録しなければなりません。

UpgradeAddOn には、アップグレード元の AddOn オブジェクトとアップグレード先の AddOn オブジェクトを識別する 2 つのプロパティーが含まれます。FromVersions プロパティーは、アップグレードする 1 つ以上のインストール済み AddOn オブジェクトを指定します。ToVersions プロパティーは、アップグレード先である 1 つ以上の新規 AddOn オブジェクトとデータを指定します。UpgradeAddOn オブジェクトをオブジェクト・ストアにインストールすると、FromVersions プロパティーにリストされたアドオンが、ToVersions プロパティーにリストされたアドオンに置き換えられます。実際には、UpgradeAddOn は、次のように移行パスとして機能します。既存のオブジェクト・ストアを、UpgradeAddOn.ToVersions プロパティーにリストされている AddOn オブジェクトで作成された新しいオブジェクト・ストアと同等の状態にアップグレードします。

注: セット内の 1 つのアドオンのインポートが失敗すると、インストールが停止し、リスト内の残りのアドオンはインストールされません。

UpgradeAddOn オブジェクトにはインポート・データ・セット、インポート前スクリプト、インポート後スクリプトが含まれています。UpgradeAddOn オブジェクトは、AddOn オブジェクトと同じ API メソッド ObjectStore.installAddOn を使用してインストールされます。

ステップバイステップの例

次のステップでは、「v1.0to2.0UpgradeAddon」を使用して、オブジェクト・ストアを「v1.0Addon」から「v2.0Addon」にアップグレードする際に実行するアクションの要約を説明します。

  1. v2.0Addon の AddOn オブジェクトを作成します。このオブジェクトをドメインの GCD に登録します。(この例では、v1.0Addon は以前に GCD に登録済みで、オブジェクト・ストアにインストール済みであると仮定します。)v2.0Addon の XML インポート・データ・セットには、v1.0Addon のデータを置き換える更新済みデータを含むデータ・セット全体を含める必要があります。
  2. 「v1.0to2.0UpgradeAddon」の UpgradeAddOn オブジェクトを作成します。UpgradeAddOn.FromVersions プロパティーは「v1.0Addon」に、UpgradeAddOn.ToVersions プロパティーは「v2.0Addon」に設定します。UpgradeAddOn オブジェクトの XML インポート・データ・セットには、データ・セット全体ではなく、「v1.0Addon」から「v2.0Addon」への追加分または変更個所のみを含める必要があります。

    UpgradeAddOn オブジェクトは、保存されるとドメインの GCD に登録されます。

  3. UpgradeAddOn オブジェクトをオブジェクト・ストアにインストールします。UpgradeAddOn オブジェクトの XML インポート・データ・セットが使用されて、v1.0Addon の現在のデータが v2.0Addon の更新済みデータに変更されます。

インストールが正常に完了すると、v1.0Addon の AddOnInstallationRecord は、v2.0Addon の AddOnInstallationRecord で置き換えられ、v1.0to2.0UpgradeAddon の AddOnInstallationRecord は削除されます。

インストールが失敗すると、v1.0to2.0UpgradeAddon の AddOnInstallationRecord がそのまま残り、オブジェクトの InstallationReport プロパティーに、失敗の報告が設定されます。

v1.0Addon がインストールされているすべてのオブジェクト・ストアに v1.0to2.0UpgradeAddon が適用された後は、v1.0Addon と v1.0to2.0UpgradeAddon は両方とも GCD から削除できます。いずれも、どのオブジェクト・ストアの AddOnInstallationRecordList からも参照されないためです。



最終更新日: 2015 年 10 月
addon_upgrading_concept.htm

© Copyright IBM Corp. 2015.