Release Notes - appero quote Summer Professional 25.200 / appero quote Summer Enterprise 25.201
Automatisches Setup-Skript nach Installation
Mit dem Sommer-Release von appero quote wird ein Post-Install Script eingeführt, das automatisch mit Installation des neuen Paketes ausgeführt wird. Dieses unterscheidet, ob es sich um eine Neuinstallation oder ein Upgrade handelt, und führt entsprechende Initialisierungs- oder Migrationsschritte durch.
Mit appero quote 25.200/25.201 werden folgende Anpassungen an Ihren Daten vorgenommen:
Datenmigration für „Ausgeblendete Spalten“
Beim Update von einer Produktversion kleiner als appero quote 25.100 auf das Summer Release wird automatisch die Apex-Klasse UpdateHiddenColumnsFieldOnPositionBatch ausgeführt, um die Kompatibilität mit der neuen Logik zur Spaltenanzeige sicher zu stellen:
Die bisherige Funktionalität einzelner „Hide“-Checkboxen für jede Spalte wird abgelöst.
Stattdessen wird nun das neue Feld sf42_quotefx__SF42_QuoLI_HiddenColumns__c verwendet. In diesem Feld werden die ausgeblendeten Spaltennamen komma-separiert gespeichert.
Dieses neue Feld steuert, welche Spalten im Angebotsdokument grundsätzlich vorhanden, aber für die jeweilige Angebotsposition ausgeblendet sind.
Damit vorhandene Angebote, Bricks und Angebotsvorlagen weiterhin korrekt funktionieren, ist eine Datenmigration von den bisherigen Checkboxen auf das neue Feld erforderlich. Diese wird automatisch durch das Post-Install Script durchgeführt und erfordert kein manuelles Eingreifen.
Wichtig vor der Installation
Während der Ausführung des UpdateHiddenColumnsFieldOnPositionBatch-Jobs dürfen keine Validierungsregeln, Prozesse, Flows oder sonstige Automatisierungen aktiv sein, die das Schreiben von Daten in Angebotspositionen verhindern.
Sollte die Ausführung fehlschlagen, finden Sie auf der Startseite der appero quote Setup App eine Kachel mit dem Deploymentstatus, einer detaillierten Fehlermeldung sowie der Möglichkeit, den Batch-Job nach Behebung der Fehlerquelle manuell erneut anzustoßen.
Da das Datenupdate einige Zeit in Anspruch nehmen kann, empfehlen wir, die Installation zu einem Zeitpunkt auszuführen, an dem länger nicht gearbeitet wird.
Link zur Dokumentation: Automatisches und manuelles Ein- und Ausblenden von Angebotsspalten
Walkthrough Grundeinstellungen
Beim ersten Öffnen des Angebotseditors wird eine geführte Tour angezeigt, die die wichtigsten Bereiche und Funktionen kurz vorstellt. Weitere Details dazu finden Sie im folgenden Abschnitt.
Damit dieser automatisch startet, wird bei einer Neuinstallation oder einem Produkt-Update von einer Version < 25.200 durch das Post-Install-Skript automatisch ein globaler Hierarchie-Datensatz in den Custom Settings „Quote Editor Walkthrough Views“ angelegt.
Dieser legt standardmäßig fest, dass der Walkthrough im Angebotseditor bis zu 5-mal pro Nutzer angezeigt wird. Damit ist die geführte Tour direkt nach Installation oder Update einsatzbereit, ohne dass ein manuelles Setup erforderlich ist.
Handlungsbedarf:
Keiner. Der Datensatz wird automatisch erstellt und kann bei Bedarf von Ihnen im Setup angepasst werden.
Link zur Dokumentation:
Konfiguration des appero quote Walkthrough
Initiale Einrichtung und Konfiguration
Walkthrough im Angebotseditor
Der Angebotseditor von appero quote bietet eine benutzerfreundliche Echtzeit-Vorschau („What You See Is What You Get“) sowie vielfältige Optionen zur Formatierung und Gestaltung von Angeboten.
Änderungen in appero quote 25.200 / 25.201:
Mit dem Summer Release von appero quote wird Nutzer:innen beim ersten Aufruf des Editors eine geführte Tour angezeigt, die die zentralen Funktionen des Editors in 6 Schritten erklärt – darunter Produktpositionen, Layout-Bereiche und die Dokumentvorschau.
Die Tour startet automatisch beim ersten Besuch, kann aber jederzeit geschlossen werden.
Die Anzeigehäufigkeit ist standardmäßig auf 5 Durchläufe pro Nutzer:in begrenzt.
Diese Begrenzung wird über die Custom Settings „Quote Editor Walkthrough Views“ gesteuert.
Technische Umsetzung:
Der globale Hierarchie-Datensatz der Custom Settings legt die Standardanzahl für die Anzeige fest.
Beim ersten Einstieg eines Benutzers wird automatisch ein benutzerspezifischer Datensatz erstellt, der die verbleibenden Einblendungen verwaltet.
Beide Datensätze können bei Bedarf durch Admins angepasst werden.
Handlungsbedarf:
Es besteht kein unmittelbarer Handlungsbedarf. Bei Bedarf können die Custom Settings manuell angepasst werden.
Link zur Dokumentation:
Erste Schritte im Angebotseditor - der appero quote Walkthrough
Feature-Assistenten in der Setup App
appero quote bietet eine Vielzahl an Funktionen und eine umfassende Dokumentation. Gerade deshalb ist es wichtig, zentrale Features schnell zu erfassen – hier setzen die neuen Feature-Assistenten an.
Änderungen in appero quote 25.200 / 25.201:
Um den Einstieg in zentrale Funktionen von appero quote zu erleichtern, werden ab diesem Release auf der Startseite der Setup App kontextabhängige Feature-Assistenten angezeigt. Die Assistenten bieten eine schrittweise Einführung in ausgewählte Funktionen – per Text und Video. Sie erklären die jeweilige Konfiguration, geben Tipps zur Anwendung und verlinken auf weiterführende Inhalte in der Hauptdokumentation.
In diesem Release enthalten:
Assistent für Produktgruppen
Einführung in das Anlegen und die Verwendung von Produktgruppen.Assistent zur Summenberechnung
Erklärung der Logik zur Berechnung von Summen und deren Konfiguration im Editor.
Wichtig: Die beiden Assistenten sind rein informativ – bestehende Daten oder Konfigurationen werden nicht verändert.
Weitere Feature-Assistenten folgen in den kommenden Releases.
Handlungsbedarf:
Keiner
Link zur Dokumentation:
Usability
Vereinfachte Löschfunktion für Angebote
Bisher war das Löschen eines Angebots in appero quote über die Schaltfläche auf der Angebotsseite oder in einer Angebotsliste mit mehreren Schritten verbunden und dadurch wenig intuitiv.
Änderungen in appero quote 25.200 / 25.201:
Der mehrschrittige Prozess wurde deutlich vereinfacht. Ab sofort steht Ihnen eine neue, geführte Löschaktion zur Verfügung, die wichtige Prüfungen direkt integriert und für mehr Klarheit sorgt:
Primäres Angebot: Wenn ein Angebot als primäres Angebot an der Opportunity hinterlegt ist, kann es nicht gelöscht werden. Es erscheint ein entsprechender Hinweis.
Aktive oder genehmigte Angebote: Bei aktiven oder genehmigten Angeboten erfolgt eine Sicherheitsabfrage mit der Option, den Löschvorgang abzubrechen oder fortzusetzen.
Alle anderen Angebote: Es erscheint eine standardisierte Bestätigungsabfrage, bevor das Angebot gelöscht wird.
Wenn der Löschvorgang bestätigt wird, wird das Angebot zunächst auf inaktiv gesetzt und anschließend gelöscht. Die Dialoge orientieren sich am Salesforce-Standarddesign.
Handlungsbedarf:
Keiner.
Link zur Dokumentation:
Stabile Anzeige der Aktionsbuttons im Angebotseditor
Die Anzeige der Aktionsbuttons im Angebotseditor wurde optimiert, um ungewollte Klicks durch springende Buttons zu vermeiden. Zuvor kam es vereinzelt vor, dass Buttons zeitverzögert eingeblendet wurden und sich dadurch während des Klickens verschoben.
Änderungen in appero quote 25.200 / 25.201:
Die Reihenfolge und das Ladeverhalten der Buttons wurde überarbeitet. Zunächst werden nun alle Aktionen angezeigt, die unabhängig von den Einstellungen verfügbar sind, z.B. Speichern, Vorschau, Aus Opportunity übernehmen. Erst danach folgen Buttons, die von spezifischen Konfigurationen abhängen, wie Email Versand und Produkte in die Opportunity kopieren. Dadurch bleibt die Button-Leiste stabiler und besser vor versehentlichen Klicks geschützt.
Handlungsbedarf:
Keiner. Die Anpassung erfolgt automatisch im Hintergrund.
Link zur Dokumentation:
Angebotsdokument
Überarbeitete Mandanten-Verwaltung für Angebotsdokumente
Das Layout eines Angebotsdokuments in appero quote wird über sogenannte Mandanten (Objekt sf42_quotefx__SF42_QuoteStyle__c) gesteuert. Ein Style umfasst die CSS-Datei zur Textformatierung sowie die Möglichkeit, zwei Hintergrundgrafiken (Briefpapier) hochzuladen – eines für das Deckblatt, eines für die Folgeseiten.
Bislang konnten als Briefpapier ausschließlich Salesforce-Dokumente verwendet werden. Diese Einschränkung wird mit dem aktuellen Release aufgehoben.
Änderungen in appero quote 25.200 / 25.201:
Salesforce Files statt Dokumente:
Neu hochgeladene Briefpapier-Grafiken werden nun automatisch als Salesforce Files gespeichert. Damit wird der moderne Salesforce-Standard unterstützt und zukünftige Entwicklungen besser abgebildet.Rückwärtskompatibilität gewährleistet:
Bestehende Styles mit Briefpapier-Grafiken, die als Dokumente gespeichert wurden, bleiben vollständig funktionsfähig und können weiterhin genutzt werden.Neues Lightning-Design der Style-Verwaltung:
Die Style-Seite wurde als Lightning Page komplett neu gestaltet.
Zu den wichtigsten Verbesserungen gehören:Neue Upload-Komponente für das Briefpapier mit integrierter Dateisuche für bestehende Files in der Org
Optimierte Darstellung des CSS-Feldes, um Formatierungen einfacher lesbar und editierbar zu machen
Bereinigung des Seiten-Layouts: Um die Übersichtlichkeit zu erhöhen, wurden Felder, die keine Funktion mehr haben, aus dem Seitenlayout entfernt. Dies betrifft insbesondere:
sf42_quotefx__SF42_HideSenderaddress__c
sf42_quotefx__SF42_IsActive__c
sf42_quotefx__SF42_IsStandard__c
sf42_quotefx__SF42_DocumentID__c
Wichtig: Bei der Verwendung von Salesforce Files ist besonders auf die Freigabeeinstellungen zu achten. Nach dem Upload ist die Datei zunächst nur für den hochladenden Benutzer sichtbar. Damit das Briefpapier in Angebotsdokumenten auch für alle appero quote Nutzer:innen verfügbar ist, muss die Datei manuell entsprechend freigegeben werden.
Handlungsbedarf:
Keiner. Vorhandene Styles und bestehendes Briefpapier auf Basis von Salesforce-Dokumenten bleiben vollständig nutzbar. Neue Uploads erfolgen automatisch im Format „Salesforce File“.
Prüfen Sie bei Update einer bestehenden Version, ob der Button "Edit CSS" auf der Seite angezeigt wird ist und fügen Sie ihn ansonsten dem Layout manuell hinzu.
Link zur Dokumentation:
Grundkonfiguration: Angebotsvorlagen und Mandanten
Erweiterung des Angebotsvorlagen-Assistenten: Briefpapier-Upload
Mit dem Angebotsvorlagen-Assistenten können Sie mit wenigen Klicks und ohne tiefere technische Kenntnisse eine individuelle Angebotsvorlage inklusive CSS-Formatierung erstellen.
Änderungen in appero quote 25.200 / 25.201:
Im Zuge der Überarbeitung der Style-Verwaltung wurde auch der Angebotsvorlagen-Assistent erweitert:
Es wurde ein neuer Screen zum Upload von Briefpapier-Grafiken integriert.
Sie können nun im Assistenten direkt ein Deckblatt sowie ein Briefpapier für Folgeseiten hochladen – nach dem gleichen Prinzip wie auf der neuen Mandanten-Seite.
Die hochgeladenen Dateien werden automatisch als Salesforce Files gespeichert und direkt am zugehörigen Style hinterlegt.
Damit wird der gesamte Einrichtungsprozess – vom Aufbau der Vorlage, über die CSS-Definition bis zum Briefpapier – vollständig im Assistenten abgebildet.
Eine weitere Verbesserung: Damit keine Eingaben verloren gehen, warnt der Assistent jetzt bei ungespeicherten Änderungen und bietet eine Auswahl zwischen Speichern und Verwerfen.
Handlungsbedarf:
Keiner. Achten Sie bei Verwendung des Assistenten darauf, die hochgeladenen Files anschließend für alle appero quote Nutzer freizugeben, damit das Briefpapier korrekt in den Angebotsdokumenten angezeigt wird.
Link zur Dokumentation:
Weitere Optimierungen und Bugfixes
Fehlende Kontaktangaben im Angebot werden nun durch eine orangefarbene Markierung hervorgehoben.
Benutzerdefinierte Spalten vom Typ Währung und Prozent, die an der jeweiligen Position keinen Wert haben, werden im Editor nicht mehr als "undefined" angezeigt.
Benutzerdefinierte Felder auf dem Preisbucheintrag werden wieder korrekt in der Berechnung berücksichtigt und die Hinweismeldung, wenn sich ein Listenpreis geändert hat, wird wieder im Angebotseditor eingeblendet.
Wenn Sie am Brick-Datensatz außerhalb des Editors selbst ein Spaltenlayout zuweisen möchten, stehen nur noch die Layouts von Templates zur Verfügung.
Eine individuell geänderte Spaltenkonfiguration bei Angebotsvorlagen aus dem Template-Wizard wird wieder korrekt übernommen.
Alle im Paket verwendeten Salesforce-API-Versionen wurden auf Version 63.0 aktualisiert, um Kompatibilität und Zukunftssicherheit sicherzustellen.