Datenaktions-Plug-ins upgraden

Upgraden Sie Ihre Datenaktions-Plug-ins, um den Datenaktionscode zu verbessern. Sie können auch die Metadaten upgraden, damit vorhandene Datenaktionen mit neuem Datenaktionscode funktionieren.

Verwenden Sie einen Upgrade-Handler zum Upgrade eines Datenaktions-Plug-ins.
  1. Erhöhen Sie die Versionsnummer der Datenaktion.

    Beispiel: Wenn die Datenaktion den Namen "company.MyDataAction" hat, suchen Sie in mydataaction.js nach der Eigenschaft mydataaction.MyDataAction.VERSION. Wenn diese derzeit auf 1.0.0 gesetzt ist, ändern Sie den Wert in 1.0.1.

  2. Fügen Sie eine static upgrade(oOldDataActionJS)-Methode zur Klasse der Datenaktion hinzu.

    Wenn die Eigenschaft VERSION sich vom Wert sVersion in den Metadaten der Datenaktion unterscheidet, ruft der Datenaktionsmanager die static upgrade()-Methode für die Klasse Ihrer Datenaktion auf.

  3. Implementieren Sie die upgrade()-Methode durch Aufruf der upgrade()-Methode für die Superklasse, und erfassen Sie die Antwort.
  4. Fahren Sie mit der Implementierung der upgrade()-Methode fort. Dazu bearbeiten Sie die teilweise upgegradete Datenaktions-JSON, die von der Superklasse zurückgegeben wurde, bis das Objekt die richtigen Eigenschaften für das aktuelle Knockout-Modell aufweist.
  5. Rufen Sie abschließend var oUpgradedDataAction = dataaction.AbstractDataAction.createFromJS(fDataActionClass, sFullyQualifiedDataActionClassName, oUpgradedDataActionJS) auf.

    Mit diesem Befehl wird eine neue Instanz der Datenaktion aus der upgegradeten Datenaktions-JSON erstellt und oUpgradedDataAction.getSettings() zurückgegeben.