データ・アクション拡張機能のアップグレード

データ・アクション拡張機能をアップグレードしてデータ・アクション・コードを改善するか、メタデータをアップグレードして既存のデータ・アクションで新しいデータ・アクション・コードを操作できるようにします。

データ・アクション拡張機能をアップグレードするには、アップグレード・ハンドラを使用します。

1. データ・アクションのバージョン番号を増やします。

   たとえば、データ・アクション名がcompany.MyDataActionである場合、mydataaction.jsでmydataaction.MyDataAction.VERSIONプロパティを検索します。これが現在1.0.0に設定されている場合、1.0.1に変更します。

2. static upgrade(oOldDataActionJS)メソッドをデータ・アクション・クラスに追加します。

   VERSIONプロパティがデータ・アクション・メタデータに格納されているsVersion値と異なる場合、データ・アクション・マネージャは、データ・アクション・クラスのstatic upgrade()メソッドをコールします。

3. スーパークラスのupgrade()メソッドをコールすることでupgrade()メソッドを実行し、そのレスポンスを取得します。
4. 最新のKnockoutモデルで必要とされる適切なプロパティ・セットにオブジェクトが一致するまで、スーパークラスから返される部分的にアップグレードされたデータ・アクションJSONに編集を加えることでupgrade()メソッドを実行し続けます。
5. var oUpgradedDataAction = dataaction.AbstractDataAction.createFromJS(fDataActionClass, sFullyQualifiedDataActionClassName, oUpgradedDataActionJS)をコールして終了します。

   このコマンドは、アップグレードされたデータ・アクションJSONからデータ・アクションの新しいインスタンスを構築し、oUpgradedDataAction.getSettings()を返します。