1. Einführung
Was kann coudworx.list?
Mit cloudworx.list hast du folgende Möglichkeiten:
- Anzeige von Themenlisten auf Datensatzseiten, ohne dass eine direkte Objektbeziehung notwendig ist, beispielsweise Anzeige aller Opportunities von untergeordneten Accounts. Zudem können in einer Liste mehrere Objektbeziehungen referenziert werden.
- Anzeige von Themenlisten auf Datensatzseiten, ohne dass eine Objektbeziehung besteht, so können beispielsweise eine Liste aller verfügbaren Produkte auf einer Opportunity angezeigt werden.
- Erstellung von Themenlisten, die nach mehreren Auswahllistenwerten gefiltertwerden.
2. Voraussetzungen
Für die Installation von cloudworx.compose benötigst du Salesforce in der Professional, Enterprise, Performance, Unlimited oder Developer Edition. Außerdem muss dein Benutzer Administratorenrechte besitzen.
3. Installation und Setup
3.1. Installation
Die Installation von cloudworx.list erfolgt mittels eines von cloudworx bereitgestellten Links.
1. Wenn du auf der Installations-Seite bist, wähle „Nur für Administratoren“. Du kannst später über Berechtigungssätze (Permission Sets) die Rechte für andere User vergeben.
2. Gehe auf „Installieren“
3. Kreuze „Ja, Zugriff auf diese Drittanbieter-Websites gewähren“ an, damit cloudworx.list mit unserem Server kommunizieren kann.
Sobald deine Installation abgeschlossen ist, findest du alle dem Package zugehörigen Komponenten in deiner Org. Du kannst sie an dem Namespace-Präfix „cwls“ erkennen.
Vielleicht bekommst du eine Benachrichtigung mit folgendem Inhalt: „Die Installation dieser Anwendung nimmt einige Zeit in Anspruch.” Wenn es das erste Mal ist, dass so eine Meldung bei dir erscheint, keine Sorge. Klicke einfach auf „Fertig“.
3.2. Setup
Nach beendeter Installation empfehlen wir die Überprüfung der Installation im Bereich „Anwendungen“ unter „Installierte Pakete“ im Salesforce Setup.
Als Allererstes müssen die Nutzungsrechte für cloudworx.list vergeben werden. Die Nutzung der Applikation setzt die Vergabe bestimmter Rechte an gewünschte Salesforce-Benutzer voraus. Grundsätzlich wird hierbei nach der Art der gewünschten Nutzung unterschieden:
- cloudworx.list-User: für die Erstellung von Listen benötigt
1. Suche dafür im Setup nach „Berechtigungssätze“.
2. Suche in der Liste nach „cloudworx.list User“ und klicke darauf
3. Gehe auf „Zuweisungen verwalten“ und füge die gewünschten Benutzer mittels Setzen des Kontrollkästchens hinzu.
Anschließend muss noch die App Page aktiviert werden.
1. Suche dafür im Setup nach „Lightning App Builder“
2. Klicke auf die App Page „cloudworx.list“
3. Gehe auf „Aktivierung“, fülle das Dialogfenster entsprechend aus und speichere die Änderungen abschließend.
4. Konfiguration
4.1. Anlegen einer cloudworx.list Listenansicht
Um eine Listenansicht mit cloudworx.list zu erstellen, muss Du auf das gewünschte Objekt in Salesforce navigieren, auf dem du die Listenansicht anzeigen lassen möchtest. Gehe dann auf das Setup Einstellungsrädchen und wähle Seite bearbeiten bzw. Edit Page.
Sobald sich die Lightning Component Web App geöffnet hat, kannst Du auf dem Komponenten (Component) Spaltenmenü auf der linken Seite nach ganz unten scrollen und unter Benutzerdefiniert (Custom) die Komponente cloudworx.list auswählen. Anschließend einfach per Drag and Drop cloudworx.list Komponente auswählen und in der Anzeige des Objektes in der Mitte der Seite einfach an der Stelle wo die Listenansicht auf dem Objekt gewünscht wird, platzieren.
Anschließend öffnen sich in der Spalte auf der rechten Seite eine Reihe an Feldern, auf diesen Feldern können die Parameter für die Listenansicht festgelegt werden.
Feld | Beschreibung |
---|---|
Object | Hier kannst du das Object, dessen Datensätze du in der Listenansicht anzeigen möchtest, auswählen. Dir wird eine Auswahl aller verfügbaren Standard und Custom Objects angezeigt. Ein Hinweis: Bitte achte auf die entsprechende Groß-/Kleinschreibung. |
Icon | Hier kannst Du ein gewünschtes Icon, das du für die Anzeige der Liste verwenden möchtest, auswählen. Beispielsweise fügt {standard:contact} das Standard Kontakt Logo hinzu und {standard:account} das vom Account ({iconkategorie:iconname}). Natürlich können auch Custom Icons hinzugefügt werden. Du kannst jedes verfügbare SLDS-Icon nehmen, eine Liste der verfügbaren Icons findest du hier https://www.lightningdesignsystem.com/icons/. Wenn du das Feld leer lässt, wird automatisch das für den Tab hinterlegte Icon genommen. |
List Name | Hier kannst du einen Namen für die Liste eintragen. |
Context Fields | Hier kannst du das Id Feld eintragen, in dessen Kontext die Object Felder der Relation Fields angezeigt werden sollen. Standardmäßig ist hier die Id hinterlegt. Es wäre aber auch möglich, beispielsweise die Parent Id einzutragen. |
Relation Fields (Optional) | Hier kannst du die Entwicklernamen der Object Felder eintragen, die den Kontext der Beziehung des Objects auf dem die Liste angezeigt wird zu dem Datensatz den du in der Liste anzeigst, herstellt. Gibt es mehrere Felder, kannst du diese kommasepariert eintragen. Wichtig ist, dass diese Felder eine Id beinhalten. Es kann sich hierbei um Look-Up oder Master Detail Beziehungen handeln. Wenn du eine Liste von Datensätzen, die keinen direkten Bezug zu dem Anzeigeobjekt haben erstellen möchtest, kannst du ein Formelfeld oder Textfeld verwenden, welches die entsprechende Id enthält. Wichtiger Hinweis: Hierbei muss es sich um die Long Id handeln. |
Filter Statement (Optional) | Hier kannst du Filterbedingungen für die in der Liste anzuzeigenden Datensätze einstellen. Es werden nur die Datensätze in die Scope aufgenommen, die dem hier eingetragenen Filter entsprechen. So kann z. B. nach einem Status gefiltert werden. |
Order Statement (Optional) | Gibt die Reihenfolge vor, nach der die Datensätze in der Liste angezeigt werden. So kann z. B. nach Erstellungsdatum sortiert werden. |
Column Fields | Bestimme hier deine Listenspalten, indem du die Entwicklernamen der Objekte in der von dir gewünschten Reihenfolge einträgst. |
Record Limit | Bestimme hier die maximale Anzahl an Datensätzen, die in der Liste auf dem Datensatz angezeigt werden, ohne auf „View All“ zu klicken. |
Force Table View | Hier kannst du einstellen, dass dir die Liste immer in tabellarischer Ansicht angezeigt wird, ungeachtet der von dir gewählten Größe deiner Listenkomponente. |
Wrap Text | Ermöglicht dir einen Zeilenumbruch einzustellen, sodass der gesamte Zeileninhalt angezeigt wird. |
Enable Inline Editing | Ermöglicht dir bearbeitbare Felder in der Listenansicht zu aktualisieren und zu speichern. |
Allow Batch Editing | Ermöglicht dir mehrere bearbeitbare Felder in verschiedenen Zeilen in zu aktualisieren und in einem Vorgang zu speichern. |
5. Anwendungsbeispiele
5.1. Beispiel 1: Anzeigen aller aktiven Produkte auf einer Opportunity
In diesem Beispiel werden Datensätze (Produkte) ohne Beziehung zu dem Object (Opportunity) als Liste auf einem Opportunity Datensatz eingeblendet. Es werden nur aktive Produkte eingeblendet. Dies ermöglicht dem Sales Mitarbeiter eine einfache und schnelle Übersicht, über Produkte die er in der Opportunity anbieten könnte.
Listenansicht: Ansicht der Datensatzseite im Lightning-Anwendungsgenerator mit cloudworx.list
Komponente:
Wenn in den cloudworx.list Optionen „Enable Inline Editing“ ausgewählt ist, können die in der Liste angezeigten Datensätze bearbeitet werden:
Wenn in den cloudworx.list Optionen „Allow Batch Editing“ ausgewählt ist, können mehrere der in der Liste angezeigten Datensätze in einem Schritt bearbeitet werden. In dem folgenden Beispiel wird die Mengeneinheit aller in der Liste ausgewählten Produkte auf „Stück“ gesetzt.
5.2. Beispiel 2: Gefilterte Listenansicht von Datensätzen
Hier ein Beispiel einer gefilterten Listenansicht von Datensätzen (Opportunities), die direkt mit dem Object (Account) auf dem sie angezeigt werden sollen, verbunden sind. Hier wurden zwei Listenansichten jeweils nach der entsprechenden Opportunity Phase gefiltert.
Entsprechend die Lightning-Anwendungsgenerator Ansicht mit cloudworx.list Komponente:
5.3. Beispiel 3: Ansicht auf Parent Account
Beispiel 3 zeigt eine mögliche Ansicht auf einem übergeordneten Parent Account. Durch cloudworx.list können hier alle Opportunities auf dem Parent Account angezeigt werden, die den untergeordneten Accounts zugehörig sind. So hat man einen vollständigen Überblick über alle einem Unternehmen zugehörigen Opportunities.
Entsprechend die Lightning-Anwendungsgenerator Ansicht mit cloudworx.list Komponente:
Impressum | Datenschutz