snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,122 @@
---
title: Felder
description: Verstehen Sie die Rolle von Feldern und wie Sie sie verwalten.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Über Felder
Felder sind wie Spalten in einer Tabelle. Sie speichern verschiedene Datentypen wie Text, Zahlen oder Daten. Felder können standardmäßig (eingebaut) oder benutzerdefiniert (selbst erstellt) sein.
### Standardfelder
Standardfelder sind in Twenty integriert, um gängige geschäftliche Anforderungen abzudecken.
Zum Beispiel sind `Vorname` und `Nachname` Standardfelder im `Personen` Objekt. Sie speichern Textdaten für individuelle Namen.
Sie können Standardfelder nicht löschen, aber deaktivieren, wenn Sie sie nicht benötigen.
Sie können auch die Optionen der standardmäßigen Felder vom Typ `SELECT` anpassen, zum Beispiel die Optionen für die `Stage` bei Deals.
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
### Benutzerdefinierte Felder
Benutzerdefinierte Felder können zu jedem Objekt hinzugefügt werden. Sie können Text, Zahlen, Daten, Dropdown-Auswahlen und mehr speichern. Verwenden Sie benutzerdefinierte Felder, um Informationen zu verfolgen, die für Ihr Unternehmen spezifisch sind.
Ein benutzerdefiniertes Feld für SpaceX könnte zum Beispiel `Rakete Aktivstatus` sein, das anzeigt, ob eine Rakete in Betrieb ist.
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
## Feldtypen
Twenty unterstützt verschiedene Feldtypen:
| Typ | Beschreibung | Beispiel |
| ----------------- | ----------------------------------------------------------------------- | ---------------------------- |
| Adresse | Strukturierte Adresse mit Straße, Stadt, Bundesland, Land, Postleitzahl | Büroadresse |
| Array | Liste von Textwerten | Tags |
| Boolesch | Ankreuzfeld für Wahr/Falsch | Aktiv |
| Währung | Geldbetrag mit Währungscode | Deal-Betrag (USD) |
| Datum | Datumswerte | Abschlussdatum |
| Datum und Uhrzeit | Datum mit Uhrzeit | Besprechungszeit |
| Domäne | Website-Domain (für Unternehmen verwendet) | acme.com |
| E-Mail | E-Mail-Adressen (mit primärer und zusätzlichen) | E-Mail des Kontakts |
| JSON | Strukturierte JSON-Daten | Benutzerdefinierte Metadaten |
| Links | URLs mit Bezeichnungen (primär + sekundär) | Website, LinkedIn |
| Langer Text | Mehrzeiliger Text | Beschreibung, Notizen |
| Mehrfachauswahl | Mehrere Optionen aus einer vordefinierten Liste | Tags, Kategorien |
| Nummer | Numerische Werte (Ganzzahlen oder Dezimalzahlen) | Menge, Punktzahl |
| Telefon | Telefonnummern mit Ländervorwahl | Geschäftstelefon |
| Bewertung | Sternebewertung (1–5) | Priorität, Punktzahl |
| Beziehung | Verknüpfungen zu Datensätzen in anderen Objekten | Unternehmen → Personen |
| Auswahl | Einzelauswahl aus einer vordefinierten Liste | Phase, Status |
| Text | Einzeiliger Text | Name, Titel |
## Ein benutzerdefiniertes Feld erstellen
Um ein benutzerdefiniertes Feld zu einem Objekt hinzuzufügen, folgen Sie diesen Schritten:
1. Gehen Sie zu `Einstellungen` in der linken Seitenleiste.
2. Gehen Sie zu `Datenmodell`, und wählen Sie das Objekt, das Sie anpassen möchten.
3. Fahren Sie fort, indem Sie auf `+ Neues Feld` klicken.
4. Wählen Sie einen Feldnamen und -typ, der Ihren Anforderungen entspricht. Erwägen Sie, eine Feldbeschreibung hinzuzufügen, um ein besseres Verständnis zu erzielen.
Ihr neu erstelltes Feld ist jetzt in den Feldern der Applikation verfügbar. Um es in einer bestimmten Ansicht anzuzeigen, klicken Sie auf das Optionsmenü und wählen Sie dann `Felder`.
<VimeoEmbed videoId="927628219" title="Video-Demonstration" />
**Schnellweg:** Klicken Sie auf den **+**-Button oben rechts in einer Objekttabelle und wählen Sie dann `Felder anpassen`. Dies führt Sie direkt zu den Einstellungen des Datenmodells.
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
## Ein Feld deaktivieren
Sie können ein Feld deaktivieren, um es in der App zu verbergen, ohne Ihre Daten zu verlieren. Denken Sie an ein Verstecken des Feldes, anstatt es zu löschen.
So können Sie es tun:
1. Suchen Sie das Feld, das Sie in Ihren Objekteinstellungen deaktivieren möchten.
2. Klicken Sie auf die drei Punkte `⋮` neben dem Feld, um das Menü zu öffnen.
3. Wählen Sie `Deaktivieren` im Dropdown-Menü aus.
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
Was passiert, wenn Sie ein Feld deaktivieren?
1. **In der App:** Das Feld verschwindet und Sie können ihm keine neuen Werte hinzufügen.
2. **Bestehende Beziehungen:** Wenn es ein Relationsfeld ist, bleiben bestehende Verbindungen bestehen, aber Sie können keine neuen anlegen.
3. **API-Zugriff:** Sie können weiterhin über die API auf das Feld und seine Daten zugreifen.
Sie können Standard- und benutzerdefinierte Felder reaktivieren oder sie dauerhaft löschen.
## Felder einzigartig machen
Machen Sie ein Feld einzigartig, um sicherzustellen, dass sich keine verschiedenen Datensätze mit demselben Wert befinden. sind E-Mail-Adressen für jede Person einzigartig.
Wenn beim Einstellen der Einzigartigkeit ein Fehler auftritt, überprüfen Sie auf doppelte Werte in Ihren Daten (einschließlich gelöschter Datensätze).
## Indizes (Erweitert)
Datenbankindizes werden automatisch verwaltet – eigene hinzuzufügen ist selten erforderlich und kann leicht schiefgehen. Wenn der Erweiterte Modus aktiviert ist, hat jedes Objekt unter `Einstellungen → Datenmodell → <object>` einen Abschnitt **Indizes** für die Fälle, in denen du weißt, dass du einen brauchst.
## Beste Praktiken zur Feldkonfiguration
### Benennungskonventionen und Einschränkungen
* **Singular- und Pluralnamen müssen unterschiedlich sein**: Unsere GraphQL API benötigt unterschiedliche Namen für Mutationen
* **Geschützte Feldnamen**: Einige Namen sind für die Systemnutzung reserviert (z. B. `Type`, `Application`)
### Währungs- und Telefonfelder
* **Standardwährung**: kann über das Datenmodell konfiguriert werden
* **Standardlandesvorwahlen**: können für Telefonfelder über das Datenmodell konfiguriert werden
### Auswahlfelder
* **Eine Standardoption kann ausgewählt werden** für jedes Auswahlfeld
### Feld für Aufzeichnungstext
* **Jedes Objekt hat ein Hauptanzeigefeld**: Dieses Feld erscheint in der ganz linken Spalte und stellt den Datensatz dar, wenn er mit anderen Objekten verknüpft ist. Es muss ein Textfeld sein. Zum Beispiel verwendet `Personen` `Name` als Hauptfeld, so dass Sie, wenn Sie eine Person mit einem Unternehmen verknüpfen, deren Namen in der Unternehmensansicht sehen.

View File

@@ -0,0 +1,92 @@
---
title: Objekte
description: Erfahren Sie mehr über Standard- und benutzerdefinierte Objekte in Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Standardobjekte
Standardobjekte sind vordefinierte Entitäten in Ihrem Arbeitsbereich, um Ihnen den Einstieg zu erleichtern. Sie sind Teil eines gemeinsamen Datenmodells, das allen Nutzern von Twenty zugänglich ist. Sie können sie so verwenden, wie sie sind, anpassen oder deaktivieren.
<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
### Personen
Das `Personen`-Objekt speichert Ihre Kontakte. Es umfasst Kontaktdaten und Interaktionshistorie, sodass Sie alle Ihre Kundeninteraktionen an einem Ort sehen können.
### Unternehmen
Das `Unternehmen`-Objekt speichert Ihre Geschäftskonten. Es umfasst Details wie Branche, Größe und Standort. Unternehmen sind sowohl mit den Objekten `People` als auch `Opportunities` verknüpft.
### Opportunities
Das Objekt `Opportunities` speichert Daten zu Deals. Es verfolgt den Fortschritt potenzieller Verkäufe, vom Interessenten bis zum Abschluss, und zeichnet Phasen, Deal-Größen, zugehörige Konten und erwartetes Abschlussdatum auf. Sie können Ihre Verkaufspipeline in einem Kanban-Layout anzeigen.
### Notizen
Das Objekt `Notes` speichert Freitext-Notizen, die an People, Companies, Opportunities und andere Datensätze angehängt werden können. Verwenden Sie Notizen, um Besprechungszusammenfassungen, wichtige Details oder sonstige Kontextinformationen festzuhalten.
### Aufgaben
Das Objekt `Tasks` speichert To-dos und Maßnahmen. Aufgaben können mit People, Companies, Opportunities und anderen Datensätzen verknüpft werden. Verfolgen Sie Fälligkeiten, Verantwortliche und den Abschlussstatus, um bei Ihren Nachverfolgungen den Überblick zu behalten.
## Benutzerdefinierte Objekte
Benutzerdefinierte Objekte lassen Sie Informationen speichern, die einzigartig für Ihre Organisation sind und die Standardobjekte nicht verarbeiten können. Wenn Sie zum Beispiel SpaceX sind, möchten Sie vielleicht ein benutzerdefiniertes Objekt für Raketen und Starts erstellen.
<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
### Ein neues benutzerdefiniertes Objekt erstellen
Um ein neues benutzerdefiniertes Objekt zu erstellen:
1. Gehen Sie zu Einstellungen in der Seitenleiste auf der linken Seite.
2. Unter Arbeitsbereich gehen Sie zum Datenmodell. Hier sehen Sie eine Übersicht aller vorhandenen Standard- und Benutzerdefinierte Objekte (sowohl aktiv als auch deaktiviert).
<VimeoEmbed videoId="926288174" title="Video-Demonstration" />
3. Klicken Sie oben auf `+ Neues Objekt`. Geben Sie den Namen (sowohl im Singular als auch im Plural) ein, wählen Sie ein Symbol aus und fügen Sie eine Beschreibung für Ihr benutzerdefiniertes Objekt hinzu und drücken Sie Speichern (oben rechts). Als Beispiel für ein benutzerdefiniertes Objekt wäre der Singular "Eintrag" und der Plural "Einträge" zusammen mit einer Beschreibung wie "Einträge, die Gastgeber erstellt haben, um ihre Immobilie zu präsentieren."
4. Ihr benutzerdefiniertes Objekt ist jetzt erstellt und wird in Ihrer Seitenleiste angezeigt. Sie können sofort damit beginnen, Datensätze hinzuzufügen.
## Objekte verwalten
### Objekte deaktivieren
Wenn Sie ein Standard- oder benutzerdefiniertes Objekt nicht benötigen:
1. Gehen Sie zu Einstellungen → Datenmodell
2. Finde das Objekt, das du deaktivieren möchtest und klicke es
3. Gehe zur Registerkarte **Einstellungen** des Objekts
4. Klicke auf "Deaktivieren"
5. Das Objekt wird in Ihrem Arbeitsbereich ausgeblendet, die Daten bleiben jedoch erhalten
### Objekte reaktivieren
So stellen Sie ein deaktiviertes Objekt wieder her:
1. Gehen Sie zu Einstellungen → Datenmodell
2. Aktiviere `Deaktiviert` Filter
3. Suche nach deaktivierten Objekten (sie haben `Deaktiviert` neben ihrem Namen)
4. Klicken Sie auf `⋮` und dann auf `Aktivieren`, um es zu reaktivieren
5. Das Objekt und all seine Daten werden wiederhergestellt
## Beste Praktiken
### Wann Sie benutzerdefinierte Objekte erstellen sollten
* **Einzigartige Geschäftsobjekte**: Aspekte, die spezifisch für Ihre Branche oder Ihren Prozess sind
* **Komplexe Beziehungen**: Wenn Sie Verbindungen zwischen mehreren Objekten nachverfolgen müssen
* **Skalierbare Daten**: Wenn es viele Instanzen von etwas geben kann
### Wann Sie stattdessen Felder verwenden sollten
* **Einfache Attribute**: Eigenschaften, die bestehende Objekte beschreiben
* **Kategorien oder Labels**: Möglichkeiten, bestehende Datensätze zu klassifizieren
* **Einzelwerte**: Informationen, die keinen eigenen Lebenszyklus benötigen
### Benennung von Objekten
* **Verwenden Sie klare, beschreibende Namen**: Machen Sie deutlich, was das Objekt repräsentiert
* **Halten Sie sich an Konventionen**: Verwenden Sie den Singular für den Objektnamen, den Plural für die Sammlung
* **Denken Sie an Ihr Team**: Wählen Sie Namen, die alle verstehen

View File

@@ -0,0 +1,94 @@
---
title: Relationsfelder
description: Verbinden Sie Datensätze über verschiedene Objekte hinweg mithilfe von Beziehungsfeldern.
---
## Arten von Beziehungen
### Eins-zu-Viele
Ein Datensatz in Objekt A kann mit vielen Datensätzen in Objekt B verknüpft werden.
**Beispiel:** Ein Unternehmen kann viele Personen (Mitarbeitende) haben.
### Viele-zu-Eins
Viele Datensätze in Objekt A können mit einem Datensatz in Objekt B verknüpft werden.
**Beispiel:** Viele Personen können zu einem Unternehmen gehören.
### Beziehungen zu mehreren Objekttypen
Einige Objekte können auf einer Seite der Beziehung mit mehreren Objekttypen verknüpft werden.
**Beispiel:** Eine Notiz kann gleichzeitig einer Person UND einem Unternehmen UND einer Opportunity zugeordnet werden. Die Notiz befindet sich auf der "Viele"-Seite und verbindet sich mit mehreren "Eins"-Seiten.
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
Ähnlich könnte ein Projekt (auf der "Eins"-Seite) Verknüpfungen von mehreren Personen, mehreren Unternehmen und mehreren Notizen erhalten.
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**Einschränkung beim Import/Export**: Beziehungen, die auf mehrere Objekttypen zeigen, werden für den CSV-Import/-Export noch nicht unterstützt. Dies steht auf unserer Roadmap.
</Warning>
### Viele-zu-Viele
Viele Datensätze in Objekt A können mit vielen Datensätzen in Objekt B verknüpft werden.
**Beispiel:** Viele Personen können mit vielen Projekten verknüpft werden, und umgekehrt.
Viele-zu-viele-Beziehungen verwenden ein **Verknüpfungsobjekt**-Muster: ein Zwischenobjekt, das beide Seiten verbindet. Mit der Funktion für Verknüpfungsbeziehungen zeigt Twenty die endgültig verknüpften Datensätze direkt an und blendet das Zwischenobjekt in der Benutzeroberfläche aus.
<Warning>
**Beta-Eigenschaft**: Abzweigungsbeziehungen müssen vor der Verwendung unter **Einstellungen → Community → Funktionen** aktiviert sein.
</Warning>
Siehe [Viele-zu-Viele-Beziehungen erstellen](/l/de/user-guide/data-model/how-tos/create-many-to-many-relations) für eine vollständige Schritt-für-Schritt-Anleitung.
## Beziehungsfeld erstellen
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt aus, dem Sie die Beziehung hinzufügen möchten
3. Klicke **+ Neues Feld**
4. Wählen Sie **Relation** als Feldtyp
5. Wählen Sie die Zielobjekte aus, zu denen die Beziehung hergestellt werden soll
6. Konfigurieren Sie die Relationseinstellungen:
* **Feldname am Quellobjekt**: Der Name des Beziehungsfelds im Objekt, das Sie bearbeiten
* **Feldname am Zielobjekt**: Der Name des Beziehungsfelds, das im Zielobjekt angezeigt wird
* Beziehungstyp (Eins-zu-Viele, Viele-zu-Eins)
7. Klicken Sie auf **Speichern**
## Standardbeziehungen
Twenty enthält vordefinierte Beziehungen zwischen Standardobjekten:
| Ausgangsobjekt | Zielobjekt | Beziehungstyp |
| -------------- | ----------- | ------------- |
| Personen | Unternehmen | Viele-zu-Eins |
| Opportunities | Unternehmen | Viele-zu-Eins |
| Opportunities | Personen | Viele-zu-Eins |
## Beste Praktiken
### Beziehungen planen
* **Skizzieren Sie Ihr Datenmodell**: Planen Sie Beziehungen, bevor Sie sie erstellen
* **Berücksichtigen Sie die Richtung**: Überlegen Sie, welches Objekt die Beziehung "besitzt"
* **Vermeiden Sie zyklische Abhängigkeiten**: Halten Sie Ihr Datenmodell sauber
### Beziehungen benennen
* **Verwenden Sie klare Namen**: Machen Sie deutlich, was die Beziehung repräsentiert
* **Seien Sie konsistent**: Verwenden Sie ähnliche Benennungsschemata für alle Beziehungen
* **Berücksichtigen Sie beide Seiten**: Benennen Sie beide Seiten der Beziehung angemessen
### Leistung
* **Nicht übermäßig verknüpfen**: Zu viele Beziehungen können Ihren Arbeitsbereich verlangsamen
## Einschränkungen
* **Das Löschen von Beziehungen** entfernt die Verknüpfung, aber nicht die zugehörigen Datensätze
* **Zirkuläre Beziehungen** sollten zur Wahrung der Datenintegrität vermieden werden