Extra Table Fields konfigurieren

Definieren Sie mit Extra Table Fields die vollständige Spaltenstruktur für unterstützte Employee Hub-Tabellen sowie die Filter, die Mitarbeiter darüber verwenden können. Konfigurieren Sie jede Spalte und jeden Filter mit flair__Extra_Table_Field__mdt.

Wer kann diese Funktion verwenden?

Salesforce-Admins, die Felder und den Custom Metadata Type Flair Extra Table Field in Salesforce Setup verwalten. Mitarbeiter sehen die Spalten und Filter im Employee Hub.

Bevor Sie beginnen

• Erstellen Sie das Salesforce-Feld, bevor Sie es als Tabellenspalte oder Filter hinzufügen, außer Sie verwenden eine unterstützte $custom-Spalte.
• Notieren Sie den API-Namen des Objekts und den API-Namen des Feldes.
• Ermitteln Sie die Table ID, wenn die Spalte oder der Filter nur in einer Tabelle erscheinen soll.
• Erteilen Sie dem Employee Hub-Integrationsbenutzer Lesezugriff auf jedes Feld, das Sie hinzufügen, bei einem Filter außerdem auf das referenzierte Objekt und dessen Feld Name. Ein selbst erstelltes Feld ist nicht im ausgelieferten Permission Set Flair Hub enthalten.

Unterstützte Tabellen prüfen

Tabelle	Table ID
My Absences	flair__Absence__c.MyAbsences
Manager Absences	flair__Absence__c.ManagerAbsences
My Expenses	flair__Expense__c.MyExpenses
Manager Expenses	flair__Expense__c.ManagerExpenses
Directory	flair__Employee__c.Directory
Kollegen-Übersicht (Manager)	flair__Employee__c.TeamPeople
Abwesenheiten → Kollegen-Kalender	flair__Employee__c.TeamCalendar
Zeiterfassung Verlauf & Überstunden (Mitarbeiter)	flair__Time_Entry__c.HistoryEmployee
Zeitmanagement-Timesheets (Manager)	flair__Time_Entry__c.ControllingManager

Nur Directory, My Absences und der Kalender Abwesenheiten → Kollegen (TeamCalendar) werten Filterdatensätze aus. Filterdatensätze für andere Tabellen haben keine Wirkung.

Die beiden Time-Entry-Tabellen verhalten sich anders als die übrigen: Ihre Spalten sind standardmäßig ausgeblendet. Jede Person blendet sie pro Tabelle über das Zahnrad-Symbol oberhalb der Tabelle unter Spalten personalisieren ein. Die Werte werden pro Tag angezeigt; hat ein Tag mehrere Zeiteinträge, stehen die unterschiedlichen Werte gemeinsam in einer Zelle.

Extra Table Field erstellen

1. Geben Sie in Salesforce Setup unter Quick Find Custom Metadata Types ein.

2. Öffnen Sie Custom Metadata Types.

3. Klicken Sie neben Flair Extra Table Field auf Manage Records.

4. Optional: Filtern Sie unter View die vorhandenen Datensätze nach einem Objekt wie Absence oder Expense.

   

5. Klicken Sie auf New.

6. Geben Sie unter Objekt-API-Name das Zielobjekt ein, zum Beispiel flair__Absence__c oder flair__Expense__c.

7. Geben Sie unter Feld-API-Name das Feld oder eine unterstützte $custom-Spalte ein.

8. Konfigurieren Sie optionale Einstellungen unter Extra Table Field-Einstellungen prüfen.

9. Klicken Sie auf Save.

   

Extra Table Field-Einstellungen prüfen

Einstellung	Funktion
Objekt-API-Name	Identifiziert das Salesforce-Objekt. Diese Einstellung ist erforderlich.
Feld-API-Name	Identifiziert das anzuzeigende Feld oder den $custom-Wert. Diese Einstellung ist erforderlich.
Filter	Bietet das Feld als Filter oberhalb der Tabelle an, anstatt als Spalte. Lookup- und Picklist-Felder können gefiltert werden. Nur die unten aufgeführten ausgelieferten $filter.-Werte erzeugen Filter, die der Employee Hub ohne Salesforce-Feld rendert.
Aktiv	Zeigt die Spalte oder den Filter an. Deaktivieren Sie die Option, um sie auszublenden, ohne den Metadatendatensatz zu löschen.
Tabelle ID	Beschränkt die Spalte oder den Filter auf eine Tabelle. Lassen Sie den Wert leer, um sie in allen unterstützten Tabellen des Objekts anzuzeigen.
Position	Legt die Reihenfolge von links nach rechts fest. Niedrigere Zahlen erscheinen zuerst; der typische Bereich ist 0 bis 9.
Titel der Spalte	Überschreibt das Feldlabel im Tabellenkopf oder den Platzhalter im Dropdown eines Filters. Lassen Sie den Wert leer, um das Salesforce-Feldlabel zu verwenden.

Weisen Sie jeder Spalte eine eindeutige Position zu. Felder mit derselben Position können in einer nicht definierten Reihenfolge erscheinen.

$custom-Spalte verwenden

$custom-Spalten sind berechnete oder spezielle Employee Hub-Werte, die nicht als Salesforce-Felder vorhanden sind.

Objekt	Feld-API-Name	Wert
Absence	$custom.name	Name oder Titel der Abwesenheit.
Absence	$custom.absenceCategory	Abwesenheitskategorie.
Absence	$custom.approver	Informationen zum Genehmiger.
Absence	$custom.comments	Kommentare.
Absence	$custom.employee	Mitarbeiterinformationen.
Absence	$custom.loom	Loom-Videolink.
Expense	$custom.comments	Kommentare.

Konfigurieren Sie zum Beispiel diese Werte, um Mitarbeiter unter Manager Absences anzuzeigen:

Einstellung	Wert
Feld-API-Name	$custom.employee
Objekt-API-Name	flair__Absence__c
Tabelle ID	flair__Absence__c.ManagerAbsences

Filter oberhalb einer Tabelle konfigurieren

Ein Datensatz mit aktivierter Option Filter wird zu einem Dropdown in der Zeile Filtern nach: der Tabelle statt zu einer Spalte. Mitarbeiter schränken die Tabelle damit anhand der ausgewählten Lookup-Datensätze oder Picklist-Werte ein. Ein $filter.-Wert ist ein spezieller Filter, dessen Optionen und Zuordnungsverhalten vom Employee Hub bereitgestellt werden.

Bei einem feldbasierten Filter muss Feld-API-Name ein Lookup- oder Picklist-Feld benennen. Jedes Lookup-Feld des Objekts funktioniert, auch Felder, für die es bisher keinen Filter gab, sofern der Employee Hub-Integrationsbenutzer das Feld und das referenzierte Objekt lesen darf. Lookup-Optionen stammen aus Datensätzen, die von Mitarbeitern verwendet werden; Picklist-Optionen aus den Werten des Feldes. Ein Filterdatensatz mit einem Namen $filter. verweist nicht auf ein Salesforce-Feld.

Erstellen Sie einen Datensatz mit diesen Werten, damit Mitarbeiter das Directory nach Manager filtern können:

Einstellung	Wert
Objekt-API-Name	flair__Employee__c
Feld-API-Name	flair__Manager__c
Tabelle ID	flair__Employee__c.Directory
Filter	Aktiviert
Position	4

Position legt die Reihenfolge der Filterzeile von links nach rechts fest, und Titel der Spalte benennt ein Dropdown um, sodass Office das Feldlabel Standort ersetzen kann. Wenn Sie Aktiv deaktivieren, verschwindet das Dropdown, und ein ausgeblendeter Filter filtert die Tabelle auch dann nicht mehr, wenn seine Datensatz-IDs noch in der Seiten-URL stehen.

Dasselbe Feld kann sowohl Spalte als auch Filter sein. Erstellen Sie dafür zwei Datensätze: einen mit aktivierter Option Filter, einen ohne.

Directory-Filter prüfen

flair liefert drei Filter für das Directory aus, alle aktiv, sodass die Filterzeile unverändert aussieht, bis Sie sie bearbeiten:

Filter	Feld-API-Name
Standort	flair__Location__c
Abteilung	flair__Department__c
Team	$filter.team

Team verwendet $filter.team, weil die Teamzugehörigkeit auf flair__Team_Member__c liegt und nicht in einem Feld auf flair__Employee__c. Filter dieser Art benennt flair, Sie können sie also ausblenden, neu anordnen und umbenennen, aber keine neuen erstellen. Organisationen ohne Teams deaktivieren Aktiv in diesem Datensatz.

Ein Dropdown erscheint, sobald sein Datensatz aktiv ist, auch wenn es nichts zur Auswahl gibt. Wenn Sie Aktiv für alle Filter einer Tabelle deaktivieren, verschwindet die gesamte Zeile Filtern nach: einschließlich Filter löschen. Die Tabelle und ihr Suchfeld funktionieren weiterhin.

Filter für Abwesenheitstabellen konfigurieren

Filter für My Absences konfigurieren

Die Tabelle My Absences verwendet zwei ausgelieferte $filter.-Datensätze. Sie können deren Werte für Aktiv, Position und Titel der Spalte bearbeiten und ein Lookup- oder Picklist-Feld als weiteren Filter für flair__Absence__c hinzufügen.

Filter	Feld-API-Name	Standardlabel
Abwesenheitskategorie	$filter.absenceCategory	Abwesenheitsart
Abwesenheitsstatus	$filter.status	Status

Die vorhandenen URL-Parameter type und status funktionieren weiterhin, wenn Sie diese Filter umbenennen oder neu anordnen.

Filter für den Kalender Abwesenheiten → Kollegen konfigurieren

Der Kalender Abwesenheiten → Kollegen verwendet flair__Employee__c.TeamCalendar. Seine ausgelieferte Filterzeile kann über dieselben Metadatensätze konfiguriert werden, sodass Sie die Filter ohne Hub-Release ausblenden, umbenennen oder neu anordnen können.

Filter	Feld-API-Name	Einschränkung des Kalenders
Standort	flair__Location__c	Filtert Kollegen über das Lookup-Feld.
Abteilung	flair__Department__c	Filtert Kollegen über das Lookup-Feld.
Team	$filter.team	Filtert nach Teamzugehörigkeit.
Berichtslinie	$filter.reportingLine	Filtert nach Mein Team, Direkte Reports oder Indirekte Reports.
Abwesenheitsart	$filter.absenceCategory	Filtert die im Kalender angezeigten Abwesenheiten.
Status	$filter.absentStatus	Filtert Kollegen, die heute oder in diesem Monat abwesend sind.

Um einen weiteren Filter hinzuzufügen, erstellen Sie einen aktiven Extra Table Field-Datensatz mit Objekt-API-Name flair__Employee__c, Tabelle ID flair__Employee__c.TeamCalendar, aktivierter Option Filter und dem API-Namen eines Lookup- oder Picklist-Feldes. Verwenden Sie Position, um ihn in der Zeile zu platzieren, und Titel der Spalte, um seine Bezeichnung zu überschreiben. Der neue feldbasierte Filter schränkt den Kalender auf dem Server ein.

Der Kalender behält die URL-Parameter locations und departments für bestehende Kalenderabonnements bei. Andere feldbasierte Filter verwenden ihre Feld-API-Namen in der Seiten-URL.

Spalten für bestimmte Tabellen konfigurieren

Verwenden Sie Tabelle ID, wenn zwei Tabellen desselben Objekts unterschiedliche Spalten benötigen, etwa My Absences und Manager Absences oder die Mitarbeitertabelle Verlauf & Überstunden und die Manager-Timesheets im Zeitmanagement.

Erstellen Sie für My Absences einen Datensatz mit diesen Werten:

Einstellung	Wert
Objekt-API-Name	flair__Absence__c
Feld-API-Name	flair__Amount__c
Tabelle ID	flair__Absence__c.MyAbsences
Position	3

Erstellen Sie für Manager Absences einen weiteren Datensatz:

Einstellung	Wert
Objekt-API-Name	flair__Absence__c
Feld-API-Name	flair__Approval_Status__c
Tabelle ID	flair__Absence__c.ManagerAbsences
Position	3

Um ein Time-Entry-Feld nur Mitarbeitern und nicht Managern anzuzeigen:

Einstellung	Wert
Objekt-API-Name	flair__Time_Entry__c
Feld-API-Name	flair__Onsite_or_Home_Office__c
Tabelle ID	flair__Time_Entry__c.HistoryEmployee
Position	3

Salesforce-Standardfeld hinzufügen

Salesforce-Standardfelder wie CreatedDate können ebenfalls in einer Employee Hub-Tabelle erscheinen. Beispiel:

Einstellung	Wert
Objekt-API-Name	flair__Absence__c
Feld-API-Name	CreatedDate
Position	9
Titel der Spalte	Created Date oder leer

Fehlerbehebung

Eine Spalte erscheint nicht

1. Prüfen Sie, ob Aktiv aktiviert ist.
2. Prüfen Sie, ob Objekt-API-Name und Feld-API-Name API-Namen und keine Labels verwenden.
3. Prüfen Sie, ob das Salesforce-Feld vorhanden oder der $custom-Wert unterstützt ist.
4. Prüfen Sie, ob Tabelle ID zur angezeigten Tabelle passt.
5. Prüfen Sie in einer Time-Entry-Tabelle, ob die Spalte unter Spalten personalisieren aktiviert ist, und klappen Sie eine Woche auf, um die Tageswerte zu sehen.

Ein Filter erscheint nicht

1. Prüfen Sie, ob der Employee Hub-Integrationsbenutzer Lesezugriff auf das Feld, auf das referenzierte Objekt und auf dessen Feld Name hat. Ohne diesen Zugriff kann der Employee Hub keinen Extra-Field-Wert der Tabelle lesen, sodass neben dem Filter auch Spalten verschwinden können.
2. Prüfen Sie, ob Filter und Aktiv beide aktiviert sind.
3. Prüfen Sie, ob Feld-API-Name ein Lookup- oder Picklist-Feld oder einen unterstützten $filter.-Wert benennt.
4. Prüfen Sie, ob Tabelle ID der erwarteten Tabelle entspricht, zum Beispiel flair__Employee__c.Directory, flair__Absence__c.MyAbsences oder flair__Employee__c.TeamCalendar.
5. Prüfen Sie bei einem Lookup-Filter, ob mindestens ein Mitarbeiter über dieses Feld auf einen Datensatz verweist. Prüfen Sie bei einem Picklist- oder $filter.-Filter, ob die zugrunde liegenden Zeilen Werte enthalten, die der Employee Hub anbieten kann.

Verwandte Artikel

• Extra Fields konfigurieren
• Extra Form Fields konfigurieren
• flair Tabellenspalten konfigurieren