---
title: "Eigenschaften von Mitarbeitenden"
description: "Jedes Feld einer Person, die Beziehungen zwischen Mitarbeitenden, die externen IDs, die ein Profil an seine Quellen binden, wie die Lebenszyklusphase bestimmt und wie eine Zeitzone aufgelöst wird."
sidebar:
  order: 3
area: directory
feature: employees
appPath: /directory/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - directory/employees/fix-missing-details
  - directory/employees/upload-employees-from-a-spreadsheet
  - directory/employee-groups/reference-group-types
intercom:
  - id: "6024089"
    title: "How does Pyn determine a message recipient's time zone?"
    url: https://intercom.help/pyn/en/articles/6024089-how-does-pyn-determine-a-message-recipient-s-time-zone
    note: draws on
translation:
  source: directory/employees/reference-employee-properties.mdx
  sourceSha: 26c518f755f0f65bd8a7a9d1ee1045b6b8884d0a
---

Ein Mitarbeitendenprofil ist ein fester Satz von Eigenschaften plus alle benutzerdefinierten Felder, die dein HRIS hinzufügt. Der Schlüssel in der ersten Spalte ist der Name, den ein Token verwendet; wo **Upload-Spalte** Ja sagt, ist er auch die Überschrift, die ein Employee-File-Upload liest.

## Eigenschaften

| Schlüssel | Bezeichnung | Upload-Spalte | Hinweise |
| --- | --- | --- | --- |
| `displayName` | Display Name | Ja | Der volle Name, der überall angezeigt wird. |
| `preferredName` | Preferred Name | Ja | Von Tokens verwendet, etwa dem Vornamen in einer Begrüßung. |
| `legalName` | Legal Name | Ja | Für Dokumente. |
| `jobTitle` | Job Title | Ja | |
| `primaryEmail` | Primary Email Address | Ja, Pflicht | Die Arbeitsadresse, an die Nachrichten gehen. |
| `personalEmail` | Personal Email Address | Ja | In Listen kursiv angezeigt, wenn es keine Arbeitsadresse gibt. |
| `secondaryEmail` | Secondary Email Address | Ja | |
| `avatarUri` | Avatar Image | Ja | Eine URL. Initialen werden angezeigt, wenn leer. |
| `startDate` | Start Date | Ja | Letzter oder bevorstehender Start. `yyyy-MM-dd` oder `yyyy/MM/dd`. Steuert Onboarding- und Jubiläums-Trigger und die Ansicht Upcoming. |
| `terminationDate` | Termination Date | Ja | `yyyy-MM-dd` oder `yyyy/MM/dd`. |
| `tenureDate` | Tenure Date | Ja | Ursprünglicher Start für die Betriebszugehörigkeit, wenn er vom Start Date abweicht. `yyyy-MM-dd` oder `yyyy/MM/dd`. |
| `probationEndDate` | Probation End Date | Nein | Nur angezeigt, wenn eine Quelle es liefert. |
| `birthday` | Birthday | Ja | `MM-dd` im Profil; ein Upload akzeptiert auch `dd/MM`, `yyyy-MM-dd` und eine Datums-Zeit-Angabe nach ISO 8601. |
| `businessUnit`, `department`, `division`, `location`, `team` | Business Unit, Department, Division, Location, Team | Ja | Freitext. Department, Division, Location und Country sind von Anfang an Demografien. |
| `employmentType` | Employment Type | Nein | Freitext wie Full-Time oder Contractor, aus deinem HRIS. Von Anfang an eine Demografie. |
| `jobClass` | Job Class | Nein | Freitext aus ADP; kann eine Demografie werden. |
| `country` | Primary Country | Ja | ISO-Code im Profil; ein Upload akzeptiert einen Namen. |
| `postalCode` | Postal Code | Ja | Wird verwendet, um eine Zeitzone für die USA, Kanada und Australien aufzulösen. |
| `timeZone` | Time Zone | Ja | IANA-Name. |
| `locale` | Locale | Nein | BCP-47-Tag wie `en-US`. Wird aus dem Land abgeleitet, wenn er fehlt. |
| `active` | Active status | Ja, als `status` | **Active**, **Inactive**, **On Leave** oder **Removed**. Leer bedeutet bei einem Upload aktiv. |
| `stage` | Lifecycle | Nein | Von Pyn ermittelt; siehe unten. |
| `exempt` | Exempt Status | Nein | **Exempt** oder **Non-Exempt** (USA). |
| `workerType`, `employeeType`, `timeType` | Worker Type, Employee Type, Time Type | Nein | **Contingent Worker** / **Employee**; **Fixed Term** / **PEO** / **Regular**; **Full-Time** / **Part-Time**. Aus Workday und Rippling. |
| `removed` | Removed | Nein | Gesetzt, wenn die Person aus dem Quellsystem verschwunden ist. |
| `returningEmployee` | Returning Employee | Nein | Nach einem Austritt wieder eingestellt (BambooHR). |
| `missingSsn` | Missing Social Security Number | Nein | Ja/Nein, aus Workday. Diese und die vier Zeilen darunter erscheinen im Profil nur in Workspaces, in denen Pyn sie eingeschaltet hat. |
| `orientationDate` | Orientation Date | Nein | Das Datum der Einführungsveranstaltung für einen Neuzugang, aus Workday. |
| `orientationEligible` | Orientation Eligible | Nein | Ja/Nein, aus Workday. |
| `over401kLimit` | Over-contribution to 401k | Nein | Ja/Nein, aus Workday. |
| `surveyLink` | Survey Link | Nein | URL der aktiven Befragung der Person, aus Workday. |

Ein Upload braucht außerdem `employeeId`, deine eigene stabile ID für die Zeile, und akzeptiert die vier Beziehungsspalten unten. Pyn ignoriert jede andere Überschrift, eine Spalte wie `employmentType` in einer Tabelle setzt also nichts.

Ein HRIS kann benutzerdefinierte Felder hinzufügen; sie erscheinen auf **Details** vor den Standardfeldern, und Einfach- und Mehrfachauswahlfelder erscheinen in der Liste **Filters**. Eine Zeichenketten-, boolesche oder Einfachauswahl-Eigenschaft kann eine Demografie werden: [Eine Demografie erstellen](https://support.pyn.ai/de/directory/demographics/create-a-demographic/).

## Beziehungen

| Beziehung | Upload-Spalte | Verwendet für |
| --- | --- | --- |
| **Manager** | `managerId` | Den Empfänger Manager und Tokens; die Beziehungsgruppe **Managers**. |
| **Buddy** | `buddyId` | Den Empfänger Buddy; die Gruppe **Buddies**. |
| **HRBP** | `hrbpId` | Den Empfänger HRBP und Tokens; die Gruppe **HRBPs**. |
| **Mentor** | `mentorId` | Die Gruppe **Mentors**. |

Jede Upload-Spalte enthält die `employeeId` der anderen Person aus derselben Datei. Ein HRIS liefert seine eigenen IDs, und Pyn ordnet sie zu. Eine Beziehung zählt für eine Beziehungsgruppe nur, wenn die verbundene Person aktuell beschäftigt ist.

## Externe IDs und Quellen

Pyn ordnet Datensätze über die eigene ID des Systems (eine BambooHR-Mitarbeitenden-ID, eine Workday-Worker-ID, deine `employeeId` in einem Employee File) und die E-Mail der Person einem Profil zu, sodass eine Tabellenzeile und ein HRIS-Datensatz mit derselben Arbeits-E-Mail eine Person werden. Eine Anmeldung mit einer E-Mail, die zu einem Profil passt, verknüpft das Nutzerkonto damit.

Jeder Wert wird aus der ersten Quelle genommen, die ihn liefert, in dieser Reihenfolge: Formularantworten und Webhook-Einsendungen, dann Workday, BambooHR, ADP, Greenhouse, Ashby, Rippling, HiBob, dann Employee File. Slack kommt zuletzt, und nur für Anzeigename, bevorzugten Namen, primäre E-Mail, Zeitzone und benutzerdefinierte Felder. Der Avatar ist die Ausnahme: Das Bild aus Slack wird vor einem Bild aus einem HRIS verwendet. Der Tab **Sources** eines Profils listet die Datensätze, und **Disconnect** bei einem entfernt ihn aus der Zusammenführung.

## Wie die Lebenszyklusphase bestimmt wird

Pyn ordnet Startdatum, Austrittsdatum und das heutige Datum und liest die Phase aus der Reihenfolge ab:

| Datumsangaben | Phase |
| --- | --- |
| Aus der Quelle entfernt | **Terminated**, was auch immer die Datumsangaben sagen. |
| Startdatum in der Zukunft (Austritt fehlt oder liegt davor) | **Upcoming Joiner** |
| Startdatum in der Vergangenheit, kein Austritt oder Austritt in der Zukunft, nicht als inaktiv markiert | **Current Active Employee** |
| Startdatum in der Vergangenheit und als inaktiv markiert (oder keine Beschäftigungsquelle) | **Terminated** |
| Austrittsdatum in der Vergangenheit | **Terminated** |
| Gar keine Datumsangaben | **Current Active Employee**, wenn aktiv, sonst **Terminated** |

„Als inaktiv markiert“ bedeutet, dass die Quelle mit der höchsten Präferenz `inactive` sagt, oder dass keine Quelle ein Beschäftigungssystem ist. Slack, Microsoft Teams, Greenhouse und Ashby sind keines: Eine Person, die nur ihnen bekannt ist, gilt als inaktiv. Ein `active` von `leave` wird als **On Leave** auf dem Datensatz angezeigt, ändert die Phase aber nicht: Eine gestartete Person in Abwesenheit ist **Current Active Employee**.

## Wie eine Zeitzone aufgelöst wird

1. Die Zeitzone, die die Quelle liefert, wenn sie ein gültiger IANA-Name, eine bekannte Abkürzung oder ein Windows-Zeitzonenname ist.
2. Andernfalls Land und Postleitzahl, für die USA (ZIP), Kanada und Australien.
3. Andernfalls das Land, wenn es eine einzige Zeitzone hat.
4. Andernfalls keine. Nachrichten an die Person werden in der Zeitzone des Workspace aus **Settings** > **Account Settings** gesendet, und ein Employee-File-Upload meldet die Zeile, damit du eine Zeitzone oder Postleitzahl ergänzen kannst.

## Verwandte Seiten

- [Fehlende Führungskraft, Zeitzone oder E-Mail korrigieren](https://support.pyn.ai/de/directory/employees/fix-missing-details/), um einen Wert in Ordnung zu bringen.
- [Mitarbeitende aus einer Tabelle hochladen](https://support.pyn.ai/de/directory/employees/upload-employees-from-a-spreadsheet/) für die Datei, deren Spaltenüberschriften diese Schlüssel sind.
- [Gruppentypen](https://support.pyn.ai/de/directory/employee-groups/reference-group-types/) für die Gruppen, die aus diesen Eigenschaften gebaut werden.
