Hinweise zur Umstellung auf appero quote Lightning

In diesem Bereich finden Sie Informationen, die für eine Migration von appero quote Classic auf appero quote Lightning hilfreich sind.

Initialisierung und Setup

Featureappero quote Classicappero quote LightningHandlungsbedarf / Tipps
Installation

Für den Funktionsumfang von appero quote Classic muss Adobe Flash im Browser aktiviert werden. 

Für den Funktionsumfang von appero quote Lightning ist kein Flash Plug-In mehr notwendig.

Benutzereinstellungen

Für die Verwendung von appero quote ist das Permission Set appero quote User erforderlich. Alternativ kann beim Installieren von appero quote die Option “Für alle Benutzer installieren” gewählt werden.

Wir empfehlen die Installation ab Version 20.100 zunächst nur für Administratoren, um anschließend die unterschiedlichen Berechtigungssätze zu vergeben.

Für den Zugriff auf die neue Produktversion appero quote Lightning ist zusätzlich die Aktivierung des neuen Lightning-Editors auf Unternehmens-Ebene erforderlich..  

Details


Neue Felder am Objekt AngebotspositionDie zu den appero quote Objekten gehörenden Felder sind auch im Permission Set appero quote User hinterlegt.

Mit dem Spring19 Release enthält das Objekt sf42_quotefx__SF42_GenLineItem__c 8 neue Felder. Es handelt sich um Checkboxen, die die Sichtbarkeit der Spalten im Dokument steuern:

sf42_quotefx__SF42_QuoLi_HideBuyPriceDist__c
sf42_quotefx__SF42_QuoLi_HideBuyPricePartner__c
sf42_quotefx__SF42_QuoLi_HideDescription__c
sf42_quotefx__SF42_QuoLi_HideDiscountDist__c
sf42_quotefx__SF42_QuoLi_HideDiscountPartner__c
sf42_quotefx__SF42_QuoLi_HideProductcode__c
sf42_quotefx__SF42_QuoLi_HideSpecialDiscountDist__c
sf42_quotefx__SF42_QuoLi_HideSpecialDiscountPartner__c

Überprüfen Sie über das Objekt Angebotsposition die Hide-Felder an den Summen-Elementen Ihrer Angebotsvorlagen , d.h. Angebotspositionen vom Objekt-Typ 7, 8, 9, 11, 12.

Für alle Summenelemente (ausgenommen Summenrabatte) müssen sämtliche Hide-Felder bis auf Hide Description und hide Sum auf 'True' gestellt werden.

Öffnen Sie Ihre Angebotsvorlagen im neuen Lightning Editor und prüfen Sie die Summen- und Rabattzeilen. Sie können manuell alle Zellen ausblenden, die Sie hier nicht benötigen.

Dasselbe gilt für Bricks, die Summenelemente enthalten.

EinstellungenÜber den Reiter "Admin" können im Classic-Editor die grundlegenden Einstellungen aufgerufen werden.Die Einstellungen finden sich außerhalb des Editors in einer eigenen Registerkarte der neuen App appero quote Einstellungen.
BricksBricks werden in appero quote Classic als Setup-Text vom Typ Textblock abgespeichert.In appero quote Lightning werden Bricks als QuoteLineItems im Objekt Bricks abgespeichert.Um Ihre vorhandenen Bricks in appero quote Lightning nutzen zu können müssen Sie diese zunächst konvertieren.

Angebotsvorlage

Featureappero quote Classicappero quote LightningHandlungsbedarf / Tipps
Spaltenbezeichnungen

Die Spaltennamen werden global in den Dokumenteinstellungen festgelegt, auf Zeilenebene können sie individuell geändert werden

Die Angebotsspalten werden global im Menü im Kopf des Angebots konfiguriert, auf Ebene der Angebotspositionen im Element "Spaltenbezeichnung".

Bitte überprüfen Sie die Spaltenbezeichnungen Ihrer Vorlage im globalen Menü und auf Positionsebene.

Bei den Spaltenüberschriften kann es sein, dass ausgeblendete Spalten zunächst keinen Wert zugewiesen haben. Dies kann zu fehlerhaften Ansichten im Produkt-Detail-Dialog führen. Vergeben Sie für jede Spalte das gewünschte Label, sofern es vom globalen Menü abweicht.

Unterschiedliche Verhaltensmuster

Featureappero quote Classicappero quote LightningHandlungsbedarf / Tipps
Validierung des Gültigkeitsdatums eines Angebots für die Funktion "Bearbeiten"Das Gültigkeitsdatum eines Angebots wird nicht validiert, die Bearbeitung ist nach Ablauf weiterhin möglich.

Die Bearbeitung eines Angebots im appero quote Lightning Editor ist nicht mehr möglich, sobald das Gültigkeitsdatum des Angebots abgelaufen ist. 

Sofern der Anwender das Gültigkeitsdatum anpassen können soll, kann hierfür eine Quick-Action konfiguriert oder das Feld im Page Layout bearbeitbar gemacht werden.
Preisbuch-PrüfungAngebotspositionen vom Typ Produkt werden beim Laden immer gegen das Preisbuch geprüft. Sofern der Preisbuch-Eintrag nicht mehr vorhanden und kein anderer, kompatibler Preisbuch-Eintrag gefunden wird, wird das Produkt automatisch aus dem Angebot entfernt.

Analog Classic, jedoch wird der Benutzer in diesem Fall über einen farbig hervorgehobenen Kommentar auf den Sachverhalt hingewiesen:

"Für diese Position konnte kein valider Preisbuch-Eintrag gefunden werden. Bitte überprüfen sie Ihre Konfiguration. Die Position wird beim nächsten Speichern entfernt."

Platzhalter / Mergefields

appero quote Classic unterstützt Custom Merge-Fields mit "toLabel" nicht, der Editor kann dann nicht mehr geladen werden.

Sofern im Salesforce Setup die einheitlichen Auswahllisten für Bundesstaat und Land aktiviert sind (→ 'Enable Country & State Picklists') und Übersetzungen für diese Werte vorhanden sind, werden für die entsprechenden Merge-Fields je nach Spracheinstellung die Übersetzungen ausgegeben.

Für benutzerdefinierte Merge-Fields muß im zugehörigen Setup-Text das entsprechende Feld mit 'toLabel' gekennzeichnet sein, z.B. 

accountFields → Textbaustein: toLabel(Industry)

Vorhandene Custom Mergefields sind zu überprüfen und ggf. nach der neuen Konfiguration zu aktualisieren.

Nutzen Sie dazu am besten die Mergefields Sidebar.

Die aktuelle Systematik für Mergefields in appero quote Lightning finden Sie hier.




MehrsprachigkeitDie Erweiterung für Sprachen und Übersetzungen werden über die Objekte "Language" und "Translation Manager" gesteuert.

Mehrsprachigkeit wird über die globale Auswahlliste "appero Language Locale" und einzelne Übersetzungen am Produktdatensatz gesteuert. 

Zur Dokumentation

Bitte kontaktieren Sie unseren Produkt-Support. Wir helfen Ihnen gerne bei der reibungslosen Umstellung Ihrer Daten.

Einstellungen / Setup-Texte

Featureappero quote Classicappero quote LightningHandlungsbedarf / Tipps
Einstellung der Breite der ProduktbeschreibungKann per Setup-Text "ProductDetailFullWidth" umgestellt werden, so dass die Produktbeschreibung die volle Seitenbreite annimmt.Dieser Setup-Text wird nicht nicht mehr berücksichtigt. Die Breite einer Produktbeschreibung reicht grundsätzlich von Beginn der Spalte "Description" bis Beginn der Spalte "Sum". Diese Breite wird auch für die Darstellung von Produkteigenschaften angewendet.
Editierbarkeit des Listenpreis für ProdukteKann per Setup-Text "changeListPrice" konfiguriert werden.

Der Setup-Text "changeListPrice" wird für appero quote Lightning nicht mehr benötigt und daher ignoriert.
Die Editierbarkeit des Listenpreis für Produkte kann über das Feld SF42_editableListprice__c auf dem Objekt Product2 für einzelne Produkte konfiguriert werden. 

Die betroffenen Produkte sind zu überprüfen, um ggf. die Checkbox SF42_editableListprice__c zu aktivieren.

Produkteigenschaften

Featureappero quote Classicappero quote LightningHandlungsbedarf / Tipps
Produkteigenschaften allgemeinProdukteigenschaften werden erst aktualisiert, wenn diese per Dialog aufgerufen werden.Produkteigenschaften werden mit jeder Form von Bearbeitung der Angebotspositionen aktualisiert.
Sofern die Variante "Inline-Editing" gewählt wurde und zu validierende Eigenschaften hinzugekommen sind, wird automatisch auf die Dialog-Variante umgeleitet.

Produkteigenschaften allgemeinProdukteigenschaften können nicht aktiviert oder deaktiviert werden. Sofern sie korrekt konfiguriert sind, greifen sie im AngebotseditorÜber die neue Checkbox "Inaktiv" sf42_quotefx__IsInactive__c können Produkteigenschaften ganz einfach deaktiviert werden. Standardmäßig ist diese Checkbox nicht ausgewählt.Die Verwendung der Checkbox sf42_quotefx__IsInactive__c hat keine Funktionalität im Classic Editor, sie wird hier ignoriert.
Staffelpreise

Wenn für ein selektiertes Produkt Staffelregeln gefunden werden, wird bei einer Mengeneingabe unterhalb der ersten Staffel der Rabatt automatisch auf 0% gesetzt, auch wenn vor der Mengenänderung bereits manuell ein Rabatt eingetragen wurde.

Manuell vergebene Rabatte bleiben erhalten, auch wenn die Menge eines Produkts auf eine Anzahl geändert wird, zu der noch keine Staffelregel greifen würde.

Sofern bis zum ersten Staffelrabatt kein Rabatt gegeben werden soll, einfach eine Regel mit 0% anlegen.
StaffelpreiseWenn für eine Angebotsposition sowohl Staffelregeln am Produkt als auch Staffelregeln über die Produktgruppe greifen, werden beide Varianten berücksichtigt und die naheliegendste Regel gewählt. In appero quote Lightning werden, sobald Staffelpreise auf Produktebene gefunden wurden, mögliche Staffelpreise für die passende Produktgruppe(n) ignoriert.

Es empfiehlt sich, weitere Regeln anzulegen, welche für das spezifische Produkt alle Anforderungen abdecken, die bisher in Produktgruppen abgebildet waren.

Zur Dokumentation
Produkteigenschaften vom Typ "Beziehung"Wenn das lt. Object Query anzuzeigende Feld bei einem Datensatz nicht gepflegt ist, wird als Label "Object" ausgegeben.Wenn das lt. Object Query anzuzeigende Feld bei einem Datensatz nicht gepflegt ist, wird der betreffende Datensatz herausgefiltert und ist nicht auswählbar.
Produkteigenschaften vom Typ "Tabelle" und "Beziehung"

Eine wie rechts beschriebene, reduzierte Objektabfrage erzeugt eine Fehlermeldung bei der Verwendung von appero quote Classic.

Das zweite Element der Objektabfrage, die Auflistung aller in der Abfrage verwendeten Felder, kann für appero quote Lightning entfallen.

Es empfiehlt sich, die Object Queries bis zur vollständigen Ablösung von appero quote Classic genauso sorgfältig aufzubauen wie bisher.

Zur Dokumentation

Preiskalkulation aus Summe

Die Berechnung einer Preiskalkulation aus Summe startet immer von 0 €, unabhängig davon, ob das zugehörige Produkt einen Listenpreis > 0 € hat.

Die Berechnung einer Preiskalkulation aus Summe startet immer vom vom Listenpreis des zugehörigen Produkts. 

Zur Dokumentation

Produkte mit dieser Produkteigenschaft müssen geprüft werden: Sofern bisher mit +/- gearbeitet wurde und der Preisbucheintrag > 0 ist, muss diese Regel auf den Operator = umgestellt werden. Alternativ kann, wenn möglich, auch der Preisbucheintrag des Produkts auf 0 € gesetzt werden.

Preiskalkulation, Zusatzfunktion "Preisuntergrenze"Der errechnete Wert der Produkteigenschaft wird im Editor als Preisuntergrenze  auf den Listenpreis geschrieben. Der Verkaufspreis wird davon nicht beeinflusst.

Der Listenpreis bleibt auch bei einer definierten Preisuntergrenze unverändert. Die Abweichung des Verkaufspreises vom Rabattlimit wird über die farbigen Badges am rechten Angebotsrand angezeigt.

Die Berechnung des Rabattlimits berücksichtigt auch Summenrabatte.


PreiskalkulationEs ist möglich, einen globalen Auf- oder Abschlag anzulegen, der auf alle Produkte greift, indem man der Preiskalkulation kein Produkt und keine Produktgruppe zuweist.Produkteigenschaften vom Typ Preiskalkulation benötigen zwingend die Zuordnung zu einem Produkt oder einer Produktgruppe. Ansonsten werden sie in der Kalkulation ignoriert.Bestehende "globale" Produkteigenschaften sind zu überprüfen und genauer zu spezifizieren.