1. Was kann cloudworx.gantt?
cloudworx.gantt ist eine Salesforce-native App, über die Prozessabläufe visualisiert und geplant werden können.
Saleforce-nativ heißt, dass die App vollständig in Salesforce läuft und keine externen Komponenten beinhaltet.
Weitere Features:
- GANTT-Diagramme können für nahezu alle Standardobjekte und alle Custom-Objekte erstellt werden
- Einstellungen können komplett ohne Programmierkenntnisse vorgenommen werden
- Der kritische Pfad eines Prozesses kann automatisch ermittelt werden
- Vorgänge können in drei Ebenen übersichtlich gruppiert werden
- Einstellungen können komplett ohne Programmierkenntnisse vorgenommen werden
2. Voraussetzungen
Für die Installation von cloudworx.compose benötigst du Salesforce in der Group, Professional, Enterprise, Performance, Unlimited oder Developer Edition. Außerdem muss dein Benutzer Administratorenrechte besitzen.
3. Installation und Setup
Die Installation von cloudworx.
gantt erfolgt via AppExchange oder mittels eines von cloudworx bereitgestellten Links.
- Wenn du auf der Installations-Seite bist, wähle „Nur für Administratoren“.
- Bei Installation die nicht über den App Exchange erfolgt: Bestätige, dass du eine App installierst, die dir von cloudworx direkt zur Verfügung gestellt wurde und die du nicht über den App Exchange bezogen hast
- Gehe auf „Installieren“
X
Sobald deine Installation abgeschlossen ist, findest du alle dem Package zugehörigen Komponenten in deiner Org. Du kannst sie an dem Namespace-Präfix „cwgt“ 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“.
4. Erstellung eines GANTT-Diagramms
Die Erstellung eines Diagramms wird am Besten anhand eines Beispiels deutlich. Für das Beispiel treffen wir folgende Annahmen:
Beispiel:
Unser Beispiel-Unternehmen kauft Immobilien. Nach Kauf wird die Immobilie renoviert. Für die Renovierung wird das GANTT-Diagramm genutzt.
In der Org gibt es, neben den Standard-Objekten der Sales Cloud noch Custom-Objekte mit folgenden Feldern:
Custom-Objekt 'Maßnahme' (Api-Name: 'Action__c')
Die Maßnahme legt fest, was getan werden muss. Beispielsweise ein Bestandsgebäude abreißen, damit dort neu gebaut werden kann. Die für das Beispiel relevanten Felder sind:
| Feldname | Api-Name | Typ |
|---|---|---|
| Opportunity | Opportunity__c | Master-Detail-Beziehung |
Custom-Objekt 'Bauphase' (Api-Name: 'Building_Phase__c')
In der Bauphase wird, pro Maßnahme, festgelegt, wann genau welche Aktionen zu einer Maßnahme durchgeführt werden. Beispielsweise muss für die Maßnahme 'Abriss' vom 1.1.2021 bis 31.01.2021 der Verkehr gesperrt werden. Zwischen dem 15.01. und dem 25.01. wird das Haus abgerissen. Das wären dann zwei konkrete Bauphasen.
Folgende Felder sind für das Beispiel relevant:
| Feldname | Api-Name | Typ |
|---|---|---|
| Maßnahme | Action__c | Master-Detail-Beziehung |
| Fortschritt | Progress__c | Prozent |
| Ist-Anfang | Real_Start__c | Datum |
| Ist-Ende | Planned_End__c | Datum |
| Soll-Anfang | Real_Start__c | Datum |
| Ist-Ende | Real_End__c | Datum |
| Aktiv | Active__c | Kontrollkästchen |
| Deadline | Deadline__c | Datum |
| Action Name | Action_Name__c | Formelfeld (Name der Maßnahme) |
| Opportunity Name | Opportuniy_Name__c | Formelfeld (Name der Opportunity) |
| Opportunity Id | Opportunity_Id__c | Formelfeld (ID der Opportunity) |
Unterhalb der Opportunity gibt es also ein Objekt, dass Maßnahmen für die Renovierung abbildet. Zu jeder Maßnahme gibt es wiederum eine oder mehrere Bauphasen. Für diese Bauphasen wird sowohl der geplante Start- und Endtermin (Soll) und der tatsächliche Start- und Endtermin (Ist) angegeben. Zusätzlich kann für jede Bauphase ein Fortschritt in Prozent angegeben werden.
4.1. Erstellung des GANTT-Diagramms über den Lightning-Anwendungsgenerator
4.1.1. Erstellung einer neuen Lightning-Seite
Im Light-Anwendungsgenerator kann über die Schaltfläche ‚neu‘ eine neue Lightning-Seite erstellt werden.
Hier den Punkt ‚Anwendungsseite‘ auswählen:
X
Anschließend muss ein Name für die Lightning-Seite angegeben werden. Wir nennen unsere Seite ‚Übersicht Maßnahmen (GANTT-Diagramm)‘.
Formfaktor:
Der auszuwählende Formfaktor ist ‚Ein Bereich‘.
X
Es öffnet sich folgende Ansicht:
X
In der linken Spalte mit dem Titel Komponenten werden ganz unten die Benutzerdefinierten (Verwalteten) Komponenten angezeigt. Hier wird nun die cloudworx.gantt-Komponente angezeigt.
Diese kann durch Drag and Drop in die große, mittlere Spalte („Komponente(n) hier hinzufügen“) gezogen werden:
X
Da noch keine Daten angegeben sind, wird in der mittleren Spalte noch nichts angezeigt. In der rechten Spalte können nun die Einstellungen vorgenommen werden. Hier werden bereits Beispiele angezeigt. Folgende Einstellungen können vorgenommen werden:
| Feldname | Beschreibung |
|---|---|
| Object | Auswahl des Objekts das visualisiert werden soll. |
| Filter Statement | Setzen von Filtern um nur bestimmte Datensätze des in dem Feld ‚Object‘ definierten Objekts angezeigt zu bekommen. Die Filter werden mit SOQL-Syntax erstellt. |
| Text Field | Einfügen des Api-Name des Felds der als Bezeichnung des jeweiligen Balkens im GANTT-Diagramm angezeigt werden soll. |
| Start Date Field | Feld das als Startdatum des Balkens im GANTT-Diagramms angezeigt werden soll. Dieses kann per Drag and Drop im Diagramm geändert werden. |
| End Date Field | Feld das als Enddatum des Balkens im GANTT-Diagramm angezeigt werden soll. Dieses kann per Drag and Drop im Diagramm geändert werden. |
| Progress Field | Feld (Prozentwert) das für die Anzeige des Fortschritts angezeigt werden soll. Dieses Feld kann im Diagramm per Drag and Drop angepasst werden. |
| Planned Start Date Field | Feld das das geplante Startdatum enthält. |
| Planned End Date Field | Feld das das geplante Enddatum enthält. |
| Deadline Field | Feld das das Deadline-Datum enthält. |
| Group Level 1 Field | Feld nach dem gruppiert werden soll (1. Ebene). |
| Group Level 2 Field | Feld nach dem gruppiert werden soll (2. Ebene). |
| Group Level 3 Field | Feld nach dem gruppiert werden soll (3. Ebene). |
| Link Object Name | Name des Objekts das eine Verbindung zwischen den einzelnen Datensätzen herstellt. Wird auch für den kritischen Pfad benötigt. |
| Link Source Field | Feld im Link Object das auf den vorherigen Datensatz des Hauptobjekts verweist. |
| Link Target Field | Feld im Link Object das auf den nachfolgenden Datensatz des Hauptsobjekts verweist. |
| Show Menu | Kontrollkästchen: Ist es deaktiviert, wird das Menü im GANTT-Diagramm nicht angezeigt |
| Default Tree State | Definiert, in welcher Ausprägung der Datensatzbaum im GANTT-Diagramm angezeigt wird: Full: Alle Informationen werden angezeigt, Name: Nur der Name des Datensatzes wird angezeigt None: Nur die GANTT-Balken werden angezeigt. Zwischen diesen Einstellungen kann im GANTT-Diagramm auch manuell durchgeschaltet werden. |
| Start Collapsed | Der Datensatzbaum wird bei Aufruf des GANTT-Diagramms komplett eingeklappt angezeigt. |
| Show Critical Path | Definiert, ob der kritische Pfad angezeigt werden soll. |
| Dies ist nur relevant, wenn es ein Objekt gibt, das die einzelnen Datensätze verknüpft (Linked Object). | |
| Enable Critical Path | Definiert ob der kritische Pfad aktiv ist. |
| Dies ist nur relevant, wenn es ein Objekt gibt, das die einzelnen Datensätze verknüpft (Linked Object). | |
| Show Autoschedule | Definiert ob ein Button angezeigt werden soll, der das Datum der einzelnen Datensätze bei Überlappungen automatisch verschiebt |
| Enable Autoschedule | Definiert ob Autoscheduling aktiviert ist. |
| Read Only | Definiert ob das GANTT-Diagramm bearbeitet werden kann oder nicht. |
| Color | Definiert die Grundfarbe des GANTT-Diagramms als Hexadezimalwert. |
| Die Balken des Diagramms sind Schattierungen dieser Grundfarbe. | |
| Height | Höhe des Diagramms in Pixeln |
In unserem Beispiel haben wir folgende Werte eingetragen:
| Feldname | Beschreibung |
|---|---|
| Object | Objekt ‚Bauphase‘ ausgewählt. Für dieses Objekt wollen wir die Datensätze als Balken angezeigt bekommen. |
| Filter Statement | Folgenden Filter haben wir gesetzt um nur aktive Bauphasen im Diagramm anzuzeigen: |
| Active__c = TRUE | |
| Text Field | Hier geben wir den Api-Namen des Feldes an, der die Bezeichnung unseres Balkens sein soll: ‚Name‘ |
| Start Date Field | Api-Name des Startdatums das in dem Diagramm per Drag-and-Drop anpassbar sein soll: Real_Start__c |
| End Date Field | Api-Name des Startdatums das in dem Diagramm per Drag-and-Drop anpassbar sein soll: Real_End__c |
| Progress Field | Api-Name: Progress__c |
| Planned Start Date Field | Api-Name: Planned_Start__c |
| Planned End Date Field | Ape Name: Planned_Start_Date__c |
| Deadline Field | Api-Name: Deadline__c |
| Group Level 1 Field | Auf oberster Ebene wollen wir nach der Opportunity gruppieren. Hier haben wir in dem Objekt ‚Bauphase‘ ein Formelfeld angelegt das den Namen der Opportunity enthält die über der Maßnahme angesiedelt ist: Opportunity_Name__c |
| Group Level 2 Field | Auf zweiter Ebene wollen wir alle Maßnahmen anzeigen, die unter der Opportunity und über den Bauphasen existieren. Dafür haben wir in dem Objekt ‚Bauphase‘ ein Formelfeld angelegt, dass den Namen der darüberliegenden Maßnahme enthält: Action_Name__c |
| Group Level 3 Field | In unserem Beispiel haben wir keine dritte Ebene und lassen das Feld dementsprechend leer. |
| Link Object Name | Noch haben wir kein Objekt mit dem wir die einzelnen Bauphasen verknüpfen. Deshalb lassen wir dieses Feld leer. |
| Link Source Field | Auch dieses Feld lassen wir leer. |
| Link Target Field | Auch dieses Feld lassen wir leer. |
| Show Menu | Da wir das Menü anzeigen wollen, lassen wir das Auswahlkästchen aktiv. |
| Default Tree State | Hier lassen wir auch den Standardwert ‚Full‘ weil wir alle Informationen im Baum angezeigt bekommen wollen. |
| Start Collapsed | Wir wollen alle Informationen sofort sehen, deswegen bleibt dieses Feld deaktiviert. |
| Show Critical Path | Da wir kein ‚Link Object‘ haben ist dieser Wert für das Beispiel irrelevant. |
| Enable Critical Path | Da wir kein ‚Link Object‘ haben ist dieser Wert für das Beispiel irrelevant. |
| Show Autoschedule | Da wir kein ‚Link Object‘ haben ist dieser Wert für das Beispiel irrelevant. |
| Enable Autoschedule | Da wir kein ‚Link Object‘ haben ist dieser Wert für das Beispiel irrelevant. |
| Read Only | Wir wollen das Diagramm bearbeiten können, deswegen bleibt dieses Auswahlkästchen deaktivert. |
| Color | Als Grundfarbe wählen wir die Farbe rot mit dem Hex-Wert ‚ #ff0000‘ aus. |
| Height | Die Höhe des Diagramms belassen wir bei 800 Pixeln. |
Hinweis:
Unbedingt benötigt werden die folgenden Felder:
- Object
- Start Date
- End Date
Alle anderen Felder sind optional
Bereits nach Anlegen der unbedingt benötigten Felder aktualisiert sich die Ansicht und das Gantt-Diagramm wird angezeigt, sofern man bereits entsprechende Daten im System hat. Man sieht also in Echtzeit, wie sich Änderungen die man vornimmt auswirken.
In unserem Beispiel sieht der Lightning-Anwendungsgenerator nun so aus:
X
Nach dem Speichern muss die Anwendung nun noch aktiviert werden. Sie kann hier beispielsweise einer Anwendungsseite (App) hinzugefügt werden.
Die erstellte Anwendung kann über den Button zur Anwendungsauswahl aufgerufen werden. Dazu gibt man einfach in dem Suchfenster im App-Launcher (9-Punkte-Menü oben rechts) den Namen der Anwendung ein:
X
5. Erstellen und Verwenden eines Verknüpfungsobjekts
5.1. Erstellen eins Verknüpfungsobjekts
Das Verknüpfungsobjekt enthält zwei Nachschlagebeziehungsfelder, die beide auf das gleiche Objekt verweisen.
In unserem Beispiel wollen wir die Datensätze des Objekts ‚Bauphase‘ miteinander verknüpfen. wir erstellen also ein Objekt mit dem Namen ‚Bauphasenabhängigkeit‘ (Api-Name: Building_Phase_Dependency__c) und erstellen dort die beiden Felder:
Nachfolgende Bauphase (Api-Name: Following_Building_Phase__c)
Bezug zu: Bauphase
Name der untergeordneten Beziehung: Preceeding_Building_Phases
Erforderlich: Aktiviert
Bezeichnung für Themenliste: Vorausgehende Bauphase
Vorausgehende Bauphase (Api-Name: Preceeding_Building_Phase__c)
Bezug zu: Bauphase
Name der untergeordneten Beziehung: Following_Building_Phases
Erforderlich: Aktiviert
Bezeichnung für Themenliste: Nachfolgende Bauphase
Wichtig für die Logische Anordnung im Layout ist, dass der Name der untergeordneten Beziehung und der Bezeichnung für die Themenliste jeweils die gegensätzlichen Bauphasen abbildet. Die Liste der über das Feld ‚Vorausgehenden Bauphase‘ verknüpften Bauphasen enthält die nachfolgenden Bauphasen und andersrum.
Im Bauphasendatensatz kann man dann auf einen Blick erkennen, welche Bauphasen vor und welche nach dieser Bauphase kommen:
X
5.2. Referenzieren des Verknüpfungsdatensatzes im Lightning-Anwendungsgenerator
Im Lightning-Anwendungsgenerator müssen wir das eben erstelle Objekt noch referenzieren. Die folgenden, rot umrandeten Felder sind für die Verknüpfung relevant:
X
| Feldname | Beschreibung |
|---|---|
| Link Object Name | Das Objekt das die Bauphasen verbindet: Bauphasenabhängigkeit |
| Link Source Field | Das Beziehungsfeld zur vorherigen Bauphase: Preceeding_Building_Phase__c |
| Link Target Field | Das Beziehungsfeld zur nachfolgenden Bauphase: |
| Following_Buidling_Phase__c | |
| Show Critical Path | Wenn aktiviert wird der Button zum an- und ausschalten des kritischen Pfades angezeigt |
| Enable Critical Path | Aktiviert den kritischen Pfad bei Öffnung des Diagramms |
| Show Autoschedule | Wenn aktiviert wird der Button zum an- und ausschalten der automatischen Terminierung angezeigt |
| Enable Autoschedule | Aktiviert die automatische Terminierung standardmäßig für dieses Diagramm. |
| ACHTUNG: Die automatische Terminierung sollte mit Vorsicht angewendet werden, da hier automatisch Daten der Hauptdatensätze geändert werden könnten |
6. Bedienung des GANTT-Diagramms
Manche der hier dargestellten Bedienelemente können bei Erstellung des GANTT-Diagramms ausgeblendet werden oder sind nicht vorhanden, wenn nicht die nötigen Felder eingetragen wurden.
Folgende Bedienelemente gibt es in dem Diagramm:
X
(1) Menüansicht
Über den Button kann zwischen den Menüansichten umgeschaltet werden:
- Volles Menü (Ansicht in Screenshot): alle Informationen werden angezeigt. Nimmt den meisten Platz ein.
- Nur Bezeichnung: Es wird nur die Bezeichnungen der einzelnen Ebenen angezeigt
- Es wird kein Menü angezeigt
(2) Textfilter
Über die Eingabe eines Textes kann das Diagramm gefiltert werden. Es werden dann nur Zeilen angezeigt in deren Namen die im Filter eingegebene Zeichenfolge enthalten ist.
(3) Änderungshistorie
Über die Buttons können Änderungen die in der aktuellen Sitzung gemacht wurden Rückgängig gemacht werden und diese Rückgängigmachung wieder rückgängig gemacht werden.
(4) Ein- / Ausklappen
Klappt ebenenweise die einzelnen Ebenen ein bzw. aus
(5) Kritischer Pfad
Mit diesem Button lässt sich die Anzeige des kritischen Pfades an- bzw. ausschalten.
(6) Autoschedule (Automatisches Terminieren)
Beim Verschieben eines Vorgangs werden alle nachfolgenden Vorgänge (die direkt oder indirekt mit dem Vorgang verknüpft sind) auch verschoben, wenn sie sich ansonsten überlappen würden.
Achtung: Je nach Anzahl der Vorgänge kann es bei Aktivierung dieser Funktion zu vielen Änderungen an Datensätzen kommen.
(7) Tabellenüberschriften
Bei vollständig ausgeklapptem Menü sieht man alle Informationen des Diagramms:
Name: Der Name des Vorgangs oder der Ebene
Start Date: Der aktuelle (NICHT der geplante) Startzeitpunkt
End Date: Der aktuelle Endzeitpunkt
Duration: Die Dauer des Vorgangs in Tagen
Progress: Der Fortschritt in Prozent, falls in den Einstellungen ein Prozentfeld angegeben wurde.
Deadline: Das Datum der Deadline falls angegeben.
Bitte beachten: Bei Klick auf die jeweilige Überschrift werden die Vorgänge anhand der Auswahl angeordnet. Bei erneutem Klick werden sie erneut, aber in umgekehrter Reihenfolge angeordnet.
So kann z. B. nach der Dauer aufsteigend oder absteigend sortiert werden.
Auf der rechten Seite wird der aktuelle ausgewählte Kalenderausschnitt angezeigt. In der oberen Zeile wird das Jahr angezeigt. Darunter wird das Jahr in kleinere Einheiten aufgespalten. Welche Einheit dies ist hängt davon ab, wie weit ins Detail man geht.
INFO: Um den Detailgrad des Kalenders zu erhöhen oder zu verkleinern, kann per halten der Steuerungstaste (Strg) und dem Drehen am Mausrad hinein- bzw. rausgezoomt werden.
Auf kleinster Ebene werden die einzelnen Tage angezeigt (Wochentag, Tag, Monat). Die Wochenenden sind zur besseren Übersicht ausgegraut. Der aktuelle Tag ist dunkelgrau hinterlegt.
Eine Ebene darüber werden die Kalenderwochen des aktuellen Jahres angezeigt.
Wiederum einige Ebenen darüber werden nur noch die Monate angezeigt.
Auf der obersten Ebene werden die Quartale angezeigt.
(8) und (9) Ebene 1 und 2
Die oberste Ebene aggregiert die Daten der darunterliegenden Ebenen. Progress und Deadline werden hier nicht angezeigt.
Eine weitere Ebene ist möglich, ist hier im Beispiel aber nicht angelegt.
(10) Vorgangsebene
Die Vorgangsebene zeigt den tatsächlichen Vorgang.
Bei Klick auf den Vorgang oder in die Zeile wird die Zeile gelb hervorgehoben. Bei Doppelklick auf die Zeile kann man zu dem jeweiligen Salesforce-Datensatz navigieren. Wird eine Deadline überschritten wird hier, neben dem Datum der Deadline ein roter Kreis mit weißem Ausrufezeichen angezeigt als Warnung.
(11) Vorgangsleiste
Die Vorgangsleiste setzt sich aus verschiedenen Elementen zusammen.
Der dunklere Bereich zeigt den Zeitraum zwischen tatsächlichem Start- und Enddatum an. Er kann, sofern es sich um bearbeitbare Felder handelt und der Read-Only Mode nicht aktiviert ist, per Drag and Drop bearbeitet werden.
Der schmalere hellere Bereich untendrunter zeigt den Zeitraum zwischen geplantem Start- und Enddatum. Ist kein geplantes Datum eingetragen oder wurden hier keine Felder hinterlegt, wird dieser Bereich nicht angezeigt. er kann im Diagramm nicht angepasst werden.
Mit dem nach oben zeigende Pfeil am vorderen Rand des Balkens kann der Fortschritt geändert werden, sofern ein Fortschrittsfeld definiert wurde und dieses bearbeitbar ist. Hier kann der Fortschritt per Drag and Drop pro Vorgang angepasst werden. Dieser Pfeil wird nur angezeigt, wenn der Vorgang ausgewählt wurde, d. h. gelb hinterlegt ist.
Der schwarze Strich zeigt das Deadline-Datum an. Er kann im Diagramm nicht verschoben werden. Wird die Deadline überschritten, wird hinter diesem Balken angezeigt, um wie viele Tage die Deadline überschritten wurde (Z. B. „Overdue: 2 days“)
Die weißen Punkte vor und hinter dem Balken erscheinen nur, wenn der Vorgang ausgewählt wurde (einfacher Klick auf den roten Balken oder auf die Zeile im Menü) oder man mit der Maus über den Vorgang geht. Außerdem erscheinen sie nur, wenn es ein Verbindungsobjekt gibt.
Per Drag and Drop können die Punkte auf der rechten Seite mit den Punkten eines anderen Balkens auf der linken Seite verknüpft werden um so eine Abhängigkeit zwischen den beiden Vorgängen abzubilden. Hierdurch wird ein neuer Datensatz für des Verbindungsobjekts erstellt.
(12) Verbindungspfeil
Der Verbindungspfeil zeigt die Abhängigkeit der einzelnen Vorgänge untereinander an. pro Pfeil existiert ein Datensatz des Verbindungsobjekts.
Zum Löschen der Verbindung (und damit auch des Datensatzes) muss doppelt auf den Pfeil geklickt werden und die Aktion bestätigt werden.
Ist die Option ‚kritischer Pfad‘ aktiv und gehört die Verbindung von zwei Vorgängen zum kritischen Pfad, wird der Pfeil rot eingefärbt.
7. Dynamisches Befüllen von GANTT Diagramm
Alle Einstellungen, die man statisch im Lightning Anwendungsgenerator vorgenommen hat, kann man auch dynamisch über URL-Parameter vornehmen. Hierzu erstellt man zuerst ein GANTT-Diagramm über den Lightning Anwendungsgenerator und passt dann die Einstellungen über die URL-Parameter an.
URL-Parameter sind Informationen, die man beim Öffnen eines Diagramms (z. B. über einen Button) mitgibt und die den Inhalt des Diagramms beeinflussen.
7.1. Anlegen eines Buttons
Das GANTT-Diagramm kann man über den App Drawer anzeigen lassen. In diesem Fall werden die statischen Informationen zur Visualisierung genutzt, die man im Lightning Anwendungsgenerator eingetragen hat.
man kann das Diagramm aber auch über die von Salesforce zugewiesene URL öffnen und kann so dynamisch Inhalte und Verhalten beeinflussen.
Exemplarisch wird hier das Öffnen des Diagramms über einen Button gezeigt.
BEISPIEL:
Bisher haben wir im Diagramm immer alle Projekte (Opportunities) mit darin enthaltenen Vorgängen betrachtet. Wir wollen aber nun nur die Vorgänge einer Opportunity betrachten.
dafür erstellen wir in der Opportunity einen Button und bestimmen, das über diesen Button nur die Vorgänge unterhalb der aktuellen Opportunity im Diagramm angezeigt werden sollen.
Erstellen eines Buttons:
Der Button wird in der im Objekt-Manager im jeweiligen Objekt erstellt. Der Menüpunkt hierzu lautet „Schaltflächen, Links und Aktionen“:
X
Anschließend kann man rechts oben über den Button ‚Neue Schaltfläche / neuer Link' einen neuen Button erstellen.
Hier wählt man nun eine Bezeichnung (wird im Layout für den User angezeigt) und einen Namen (technischer Name) aus. Außerdem bestimmt man den Anzeigetyp. In unserem Fall ‚Schaltfläche für Detailseite‘.
Als Inhaltsquelle geben wir ‚URL‘ an.
In dem großen Textfeld können wir nun unsere URL eintragen. Hier tragen wird zuerst die URL des GANTT-Diagramms ein, das wir bereits erstellt haben. In unserem Fall ist das folgende:
https://gantt-demo-cloudworx-dev-ed.lightning.force.com/lightning/n/bersicht_Ma_nahmen_GANTT_Diagramm
Anschließend können an diese URL die Parameter gehängt werden, die das Standard-Diagramm anpassen. Wir möchten in unserem Fall folgende Sachen erreichen:
1. Nur die Bauphasen anzeigen, die zu der aktuellen Opportunity zugerechnet werden
2. Die Farbe der Balken ändern
Um die Bauphasen einer Opportunity zuordnen zu können, müssen wir die Opportunity eindeutig in der Bauphase identifizieren. In unserem Beispiel habe ich hierzu ein Formelfeld im Bauphasen-Objekt angelegt, dass die Opportunity Id enthält. Das Feld heißt dementsprechend ‚Opportunity_Id__c‘. In der URL wird nun über den Parameter ‚cwgt__filterStatement‘ geprüft, dass die Id im Feld Opportunity_Id__c in der Bauphase mit der Id der Opportunity übereinstimmt, in der der Button erstellt wurde:
cwgt__filterStatement= Opportunity_Id__c = '{!Opportunity__c.Id}'
(Wichtig: das Mergefeld für die Opportunity Id muss zwischen Anführungszeichen stehen)
Zusätzlich ändern wird noch die Farbe der Balken zu einem grün:
cwgt_color=0ffc03
Die einzelnen Parameter müssen verbunden werden. Den ersten Parameter eröffnet man mit einem ‚?‘. Alle anderen durch ein ‚&‘.
Die vollständige URL wie wir sie im Button eingegeben haben sieht dann so aus:
https://gantt-demo-cloudworx-dev-ed.lightning.force.com/lightning/n/bersicht_Ma_nahmen_GANTT_Diagramm?cwgt__filterStatement= Opportunity_Id__c = '{!Opportunity.Id}'&cwgt__color=0ffc03
Bitte beachten:
Nach Erstellen des Buttons muss dieser noch in das Seitenlayout übernommen werden, damit er angezeigt wird.
7.2. Liste von Parametern für dynamisches Erstellen von Diagramm
Folgende Parameter können genutzt werden um das GANTT-Diagramm anzupassen. Dabei werden die Angaben in den korrespondierenden Feldern im Lightning Anwendungsgenerator für dieses Diagramm temporär überschrieben.
Bei den Parametern die ein Feldname erwarten, muss der API-Name des Feldes eingetragen werden.
Bei Paramtern die ein Bool’schen Wert erwarten, muss ‚true‘ oder ‚false‘ eingetragen werden.
| Parameter | Beschreibung |
|---|---|
| cwgt__recordId | ID des zu referenzierenden Datensatzes |
| cwgt__objectName | API-Name des Objekts, dessen Datensätze als Balken angezeigt werden sollen. |
| cwgt__relationField | |
| cwgt__filterStatement | Über das Filter Statement können die Datensätze aus dem Objekt (siehe objectName) eingegrenzt werden. Hier wird SOQL erwartet. |
| cwgt__textField | Der API-Name des Feldes das zur Identifizierung in den Balken steht. |
| cwgt__startDateField | API-Name des Feldes für den tatsächlichen Startzeitpunkt eines Vorgangs. |
| cwgt__endDateField | API-Name des Feldes für den tatsächlichen Endzeitpunkt eines Vorgangs. |
| cwgt__progressField | API-Name des Feldes das den Fortschritt (in Prozent) anzeigt. |
| cwgt__plannedStartDateField | API-Name des Feldes für den geplanten Startzeitpunkt eines Vorgangs. |
| cwgt__plannedEndDateField | API-Name des Feldes für den geplanten Endzeitpunkt eines Vorgangs. |
| cwgt__deadlineField | API-Name desDeadline-Feldes. Hier wird ein Datumsfeld erwartet. |
| cwgt__groupLevel1Field | Feld das die Vorgänge auf der obersten Ebene gruppiert. |
| cwgt__groupLevel2Field | Feld das die Vorgänge auf der 2. Ebene gruppiert. |
| cwgt__groupLevel3Field | Feld das die Vorgänge auf der 3. Ebene gruppiert. |
| cwgt__linkObjectName | Der API-Name des Objekts, das zur Verknüpfung der einzelnen Vorgänge genutzt wird. |
| cwgt__linkSourceField | Beziehungsfeld zwischen einem vorausgegangenen Vorgang und dem Verknüpfungsobjekt. |
| cwgt__linkTargetField | Beziehungsfeld zwischen einem nachfolgenden Vorgang und dem Verknüpfungsobjekt. |
| cwgt__showFilter | Bool'scher Wert. Wenn 'true', dann werden die Filtermöglichkeiten (Suchfeld und Button angezeigt. |
| cwgt__defaultTreeState | Der Vorgangsbaum kann durch diesen Parameter in verschiedenen Status angezeigt werden: full -> Alle Informationen werden angezeigt, name -> nur die Namen der Vorgänge und Ebenen werden angezeigt, none-> der Vorgangsbaum wird nicht angezeigt. ACHTUNG: Kleinschreibung beachten. |
| cwgt__showCollapsed | Zeigt bei Aufruf des Diagramms nur die oberste Ebene des Verzeichnisbaums, wenn true. |
| cwgt__showCriticalPath | Zeigt den Button zum aktiveren und deaktivieren des kritischen Pfad wenn true. |
| cwgt__enableCriticalPath | Setzt den kritischen Pfad bei Aufruf des Diagramms auf aktiv, wenn true |
| cwgt__showAutoschedule | Zeigt den Button zu aktivieren und deaktivieren der automatischen Terminierung von Vorgängen, wenn true. |
| cwgt__enableAutoschedule | Aktiviert die automatische Terminierung bei Aufruf des Diagramms auf aktiv, wen ntrue. |
| cwgt__readOnlyFlag | Standard: ‚false‘. Wenn ‚true‘, dann können die Vorgänge nicht mehr verschoben werden oder Start- und Enddatum angepasst werden. Verbindungen zwischen Vorgängen (falls Verknüpfungsobjekt vorhanden ist) können weiterhin erstellt und auch gelöscht werden. |
| Auto-Scheduling ist in diesem Fall nicht möglich. | |
| cwgt__color | Ändert die Farbe. Hier wird ein Hexadezimalwert erwartet. |
| cwgt__height | Ändert die Höhe des gesamten Diagramms. Der Wert ist in Pixel anzugeben |
Impressum | Datenschutz