Versionsverwaltung

Übersicht

Versionsverwaltung bietet mehrere wichtige Vorteile:

• Sicheres Experimentieren: Erstellen und testen Sie Änderungen in einer neuen Version, ohne die live verwendete Version auf Ihren Seiten zu beeinflussen.

• Änderungsverfolgung: Führen Sie eine Historie der Komponentenänderungen.

• Einfache Rücksetzung: Stellen Sie bei Bedarf schnell auf eine vorherige, funktionierende Version zurück.

• Organisierte Entwicklung: Trennen Sie experimentelle und stabile Versionen.

Kernkonzepte

• Mehrere Versionen: Speichern Sie unbegrenzt viele Versionen einer einzelnen Dynamischen Komponente.

• Aktive Version: Es ist jeweils nur eine Version "aktiv". Diese Version wird angezeigt, wenn Sie die Komponente zu einer Salesforce-Seite hinzufügen.

• Unabhängige Versionen: Jede Version ist eine separate Kopie. Änderungen an einer Version wirken sich nicht auf andere aus, bis Sie eine andere Version aktivieren.

Anzeigen von Komponenten-Versionen (von der Startseite)

Sie können alle gespeicherten Versionen einer bestimmten Dynamischen Komponente direkt von der Avonni Dynamic Components-Startseite innerhalb der Avonni Components-App aus anzeigen. Diese Ansicht dient als Ausgangspunkt für die Verwaltung einzelner Versionen.

1. Zugriff auf die App: Öffnen Sie aus dem Salesforce App Launcher (Neuner-Gitter) die App "Avonni Components".

2. Finden Sie Ihre Komponente: Suchen Sie die Dynamische Komponente, die Sie verwalten möchten, in der Hauptliste.

3. Versionen anzeigen: Klicken Sie auf den Dropdown-Pfeil neben dem Namen der Komponente. Dadurch wird die Liste erweitert und alle gespeicherten Versionen dieser Komponente angezeigt.

4. Ermitteln Sie die aktive Version: Die derzeit aktive Version (die auf Lightning-Seiten verwendet wird) wird in der Liste gekennzeichnet (oft mit einem speziellen Statusetikett wie "Aktiv", einem Häkchen oder einer auffälligen Formatierung). Andere Versionen können Status wie "Entwurf" anzeigen.

Aus dieser Versionsliste können Sie in der Regel Aktionen wie das Bearbeiten einer bestimmten Version, das Aktivieren einer anderen Version oder das Archivieren der gesamten Komponente aufrufen (siehe nachfolgende Abschnitte für Details zu diesen Aktionen).

Speichern einer neuen Version

1. Öffnen und Bearbeiten: Öffnen Sie die Dynamische Komponente im Component Builder und nehmen Sie Ihre Änderungen vor.

2. Als neue Version speichern: Wählen Sie statt "Speichern" (was die aktuelle Version überschreiben würde) die Option, als neue Version zu speichern. Dadurch wird eine neue Version erstellt, während die aktive Version unverändert bleibt.

3. Automatische Nummerierung: Avonni weist automatisch eine neue Versionsnummer zu (z. B. Version 2, Version 3).

Aktivieren einer Version

Um eine bestimmte Version Ihrer Komponente live zu schalten (diejenige, die auf Seiten angezeigt wird):

1. Gehen Sie zur Startseite: Navigieren Sie zur Avonni Dynamic Components-Startseite.

2. Finden Sie Ihre Komponente: Suchen Sie Ihre Komponente in der Liste.

3. Versionen anzeigen: Erweitern Sie die Liste der Versionen.

4. Zielversion bearbeiten: Klicken Sie auf den Dropdown-Pfeil neben der Version, die Sie aktivieren möchten, und wählen Sie "Bearbeiten".

5. Aktivieren: Klicken Sie auf die Schaltfläche "Aktivieren". Dadurch wird die ausgewählte Version aktiv und die vorherige deaktiviert.

Löschen von Versionen Dynamischer Komponenten

Das Löschen von Versionen erfordert sorgfältiges Vorgehen aufgrund der zugrunde liegenden Speicherung als Custom Metadata Type in Salesforce. Während ein direktes Löschen innerhalb der Avonni-App nicht möglich ist, führt die App Sie durch den Prozess.

Wichtige Voraussetzung: Überprüfen Sie die Verwendung der Komponente!

Stellen Sie vor dem Löschen sicher, dass die Komponente NICHT auf einer Lightning-Seite verwendet wird. Das Löschen einer verwendeten Komponente würde diese Seiten beschädigen. Entfernen Sie sie zuerst von allen Seiten im Lightning App Builder.

Empfohlener Löschvorgang (über die Avonni-App):

1. Archivieren der Dynamischen Komponente:

   • Sie müssen zuerst die gesamte Dynamische Komponente (alle Versionen) archivieren.

   • Verwenden Sie das Aktionsmenü der Komponente auf der Avonni Dynamic Components-Startseite und wählen Sie "Archivieren".

   • Wirkung: Deaktiviert die Komponente und alle Versionen und verschiebt sie in den Archivbereich.

2. Navigieren Sie zum Archivbereich: Gehen Sie zum Archivordner/Archivbereich innerhalb der Avonni Components-App.

3. Finden Sie die archivierte Komponente & Version: Suchen und erweitern Sie die Komponente, um ihre archivierten Versionen anzuzeigen.

4. Einleitung der Versionslöschung: Wählen Sie die spezifische Version, die Sie löschen möchten, und wählen Sie im Aktionsmenü die Option "Löschen".

5. Weiterleitung zur Salesforce-Einrichtung:

   • Wichtig: Das Klicken auf "Löschen" in der Avonni-App leitet Sie zur Datensatzseite des Custom Metadata Type in der Salesforce-Einrichtung weiter.

6. Bestätigen Sie das Löschen in der Salesforce-Einrichtung: Klicken Sie auf den standardmäßigen Salesforce-Link/Knopf "Löschen" auf der weitergeleiteten Seite und bestätigen Sie.

Verständnis des Prozesses: Avonni verwaltet "Versionen", die jeweils einem Datensatz des Custom Metadata Type entsprechen. Die App leitet Sie zur Salesforce-Einrichtung für die permanente Löschung weiter.

Direktes Löschen über Setup (Erweitert - mit äußerster Vorsicht verwenden):

Technisch können Sie direkt aus der Salesforce-Einrichtung löschen:

1

Gehen Sie zu Setup > Custom Metadata Types

Klicken Sie auf das Einrichtung Zahnrad-Symbol, dann wählen Einrichtung. Geben Sie im Feld "Schnellsuche" ein Custom Metadata Types und wählen Sie es aus den Ergebnissen aus.

2

Finden Sie den Avonni Dynamic Components Custom Metadata Type (z. B. avonnidc__Dynamic_Component__mdt).

In der Liste der Custom Metadata Types lokalisieren Sie den spezifischen, von Avonni Dynamic Components verwendeten Typ. Der API-Name wird typischerweise etwa lauten avonnidc__Dynamic_Component__mdt

3

Klicken Sie auf "Manage Records".

Auf der Detailseite des Custom Metadata Type finden Sie den Abschnitt für die Datensätze selbst und klicken auf die "Manage Records" Schaltfläche. Diese zeigt eine Liste aller einzelnen Datensätze an, von denen jeder eine bestimmte Version einer Avonni Dynamic Component darstellt.

4

Suchen Sie den Datensatz der spezifischen Version (kann schwierig sein).

• Dies ist der wichtigste und potenziell komplexeste Schritt. Sie müssen penibel den genauen Custom Metadata-Datensatz identifizieren, der der spezifischen Komponenten-Version entspricht, die Sie dauerhaft löschen möchten.

• Datensätze sind möglicherweise durch ihr "Label" (oft der Komponentenname und Versionsinformationen) oder den "API-Namen" identifizierbar. Es gibt keine visuelle "Versionsliste" wie in der Avonni-App, was es viel einfacher macht, den falschen Datensatz auszuwählen.

• Überprüfen Sie zweifach und dreifach die Details (Name, Letzte Änderungsdatum, alle identifizierenden Informationen), um sicherzustellen, dass Sie den richtigen Datensatz haben, bevor Sie fortfahren. Das versehentliche Löschen des falschen Datensatzes kann erhebliche Folgen haben.

5

Klicken Sie auf den "Del"-Link.

• Sobald Sie absolut sicher sind, dass Sie den richtigen Datensatz für die Version, die Sie löschen möchten, identifiziert haben, klicken Sie auf den "Del" (Löschen)-Link in der Spalte "Aktion" neben diesem spezifischen Datensatz.

• Salesforce wird Sie dann auffordern, das Löschen zu bestätigen. Nach Bestätigung ist diese Aktion unmittelbar und dauerhaft über diese Oberfläche und umgeht jegliche Lebenszyklusverwaltung oder Schutzmechanismen innerhalb der Avonni-App.

Abschließende Anmerkung: Die Löschung ist dauerhaft. Stellen Sie vor dem Löschen sicher, dass die Version nicht mehr benötigt wird und nicht verwendet wird. Ziehen Sie in Betracht, archivierte Versionen beizubehalten.

Wichtige Hinweise zum Löschen

• Dauerhafte Löschung (Erweitert): Nur erfahrene Administratoren mit Backups sollten Custom Metadata Type-Datensätze direkt löschen. Archivierung ist in der Regel ausreichend.

Beispiel: Testen einer neuen Schaltfläche

Sie haben eine Dynamische Komponente namens "ContactForm" mit Version 1 aktiv.

1. Neue Funktion hinzufügen: Sie möchten eine neue Schaltfläche hinzufügen. Sie öffnen "ContactForm" und fügen die Schaltfläche hinzu.

2. Als neue Version speichern: Sie speichern dies als Version 2. Version 1 bleibt aktiv.

3. Neue Version testen: Sie testen Version 2 (möglicherweise auf einer Testseite).

4. Neue Version aktivieren: Wenn Sie zufrieden sind, aktivieren Sie Version 2 von der Avonni Dynamic Components-Startseite. Version 1 ist nun inaktiv und Version 2 ist live.

Avonni Dynamic Components beinhalten eine integrierte Versionsverwaltung, mit der Sie mehrere Versionen Ihrer Komponenten speichern, Änderungen verfolgen und problemlos zwischen verschiedenen Versionen wechseln können. Diese Funktion ähnelt der Versionskontrolle im Salesforce Flow Builder, ist jedoch auf Dynamische Komponenten zugeschnitten.