データ・アクション拡張機能をアップグレードしてデータ・アクション・コードを改善するか、メタデータをアップグレードして既存のデータ・アクションで新しいデータ・アクション・コードを操作できるようにします。
データ・アクション拡張機能をアップグレードするには、アップグレード・ハンドラを使用します。
- データ・アクションのバージョン番号を増やします。
たとえば、データ・アクション名がcompany.MyDataActionである場合、mydataaction.jsでmydataaction.MyDataAction.VERSIONプロパティを検索します。 これが現在1.0.0に設定されている場合、1.0.1に変更します。
static upgrade(oOldDataActionJS)メソッドをデータ・アクション・クラスに追加します。
VERSIONプロパティがデータ・アクション・メタデータに格納されているsVersion値と異なる場合、データ・アクション・マネージャは、データ・アクション・クラスのstatic upgrade()メソッドをコールします。
- スーパークラスの
upgrade()メソッドをコールすることでupgrade()メソッドを実行し、そのレスポンスを取得します。
- 最新のKnockoutモデルで必要とされる適切なプロパティ・セットにオブジェクトが一致するまで、スーパークラスから返される部分的にアップグレードされたデータ・アクションJSONに編集を加えることで
upgrade()メソッドを実行し続けます。
var oUpgradedDataAction = dataaction.AbstractDataAction.createFromJS(fDataActionClass, sFullyQualifiedDataActionClassName, oUpgradedDataActionJS)をコールして終了します。
このコマンドは、アップグレードされたデータ・アクションJSONからデータ・アクションの新しいインスタンスを構築し、oUpgradedDataAction.getSettings()を返します。