Funktionen des Änderungsmanagements

Prev Next

Who can use Functions

As of r380, Functions is generally available.

Read more in the Community thread.


Änderungen an Ein- oder Ausgängen

Breaking change alert:

Adding, removing, or renaming inputs and outputs requires changes to app trigger actions that call the function.

Befolgen Sie diesen Prozess, um eine Funktionssignatur zu ändern:

  1. Entwerfen Sie die Eingabe- und Ausgabestruktur sorgfältig, bevor Sie die Funktion flächendeckend einsetzen.
  2. Eingaben: Wenn Sie eine Funktion zum Anlegen eines neuen Tabelleneintrags erstellen, berücksichtigen Sie alle typischen Spalten, die die Funktion beim Anlegen des Eintrags füllen soll, nicht nur die Spalten für den ersten Anwendungsfall.
  3. Ausgaben: Zu den üblichen Ausgaben, die Sie in eine Funktion integrieren können, gehören:
    • Datensatz-IDs der von der Funktion erstellten Tabellendatensätze
    • Für den Betreiber sichtbare Meldungen (die von der Funktionslogik in eine Variable gesetzt werden)
  4. Informieren Sie alle App-Entwickler, bevor Sie Änderungen vornehmen.
  5. Aktualisieren Sie die Funktion systematisch:
  6. Ändern Sie die Funktion.
  7. Testen Sie die Funktion mit der Schaltfläche „Testen“ unter Verwendung repräsentativer Eingaben.
  8. Testen Sie die Funktion in einer Entwicklungs-App von Anfang bis Ende.
  9. Aktualisieren Sie jede App, um neue Eingaben und Ausgaben abzubilden.
    • Ab Version r351 ist nur eingeschränkt ersichtlich, wo eine Funktion verwendet wird (sowohl in welchen Apps als auch an welcher Stelle innerhalb einer App). Auf der Registerkarte „Versionen“ einer App können Sie sehen, welche Funktionen eine Version verwendet.
    • Klicken Sie bei Apps, die eine Funktion verwenden, im App-Editor auf die Schaltfläche „Fehler anzeigen“. In einem Modalfenster werden alle fehlerhaften Funktionsverweise in der App angezeigt.
  10. Testen Sie jede App im Entwicklermodus.
  11. Veröffentlichen Sie die Apps.

Alternativer Ansatz bei größeren Änderungen

Erstellen Sie eine neue Funktion mit einer aktualisierten Signatur und migrieren Sie die Apps schrittweise:

  1. Erstellen Sie eine neue Funktionsversion mit neuen Eingabewerten (z. B. „CreateSample_v2“).
  2. Migrieren Sie Apps mit hoher Priorität auf die neue Version.
  3. Migrieren Sie die verbleibenden Apps nach und nach.
  4. Die alte Funktionsversion als veraltet kennzeichnen und archivieren.

Ändern Sie die interne Funktionslogik

Info

Changes to internal function logic (decision trees, calculations, table operations) do not break apps. However, you need to publish apps with a new version to associate the new function logic.

Gehen Sie wie folgt vor:

  1. Aktualisieren Sie die Funktionslogik.
  2. Testen Sie die Funktion über die Schaltfläche „Test“ mit repräsentativen Eingaben.
  3. Testen Sie die Funktion in einer Entwicklungs-App von Anfang bis Ende.
  4. Veröffentlichen Sie eine neue „ version “ der Apps, um sie mit der aktualisierten Funktion zu verknüpfen.
  5. Überwachen Sie die Produktions-Apps auf unerwartetes Verhalten.

Bewährte Vorgehensweise: Verwenden Sie für Funktionen, die in Produktions-Apps verwendet werden, ein Genehmigungsverfahren.


Weitere Ressourcen

{{snippet.Haben Sie gefunden, wonach Sie gesucht haben?}}