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,30 @@
---
title: KI-Agenten
description: Integrieren Sie KI-Funktionen direkt in Ihre Automatisierungs-Workflows.
---
## Überblick
Integrieren Sie KI-Funktionen direkt in Ihre Automatisierungs-Workflows für intelligente Datenverarbeitung und Entscheidungsfindung.
## Funktionen
| Funktion | Beschreibung |
| ------------------------------ | ------------------------------------------------------------- |
| **KI-Aktionen** | Fügen Sie jedem Workflow KI-gestützte Schritte hinzu. |
| **Datenanreicherung** | Reichern Sie Datensätze automatisch mit externen Daten an. |
| **Klassifizierung** | Kategorisieren Sie Datensätze auf Basis einer Inhaltsanalyse. |
| **Zusammenfassung** | Erstellen Sie Zusammenfassungen aus Textfeldern. |
| **Benutzerdefinierte Prompts** | Definieren Sie genau, wie die KI Ihre Daten verarbeitet. |
## Anwendungsfälle
* **Lead-Scoring**: Bewerten und priorisieren Sie eingehende Leads automatisch
* **Datenbereinigung**: Standardisieren Sie Unternehmensnamen und Kontaktdaten
* **E-Mail-Entwürfe**: Generieren Sie Follow-up-E-Mails auf Basis von Besprechungsnotizen
* **Datensatz-Routing**: Weisen Sie Datensätze auf Basis des Inhalts dem richtigen Teammitglied zu
## Verwandt
* [Workflows-Übersicht](/l/de/user-guide/workflows/overview) — Grundlagen der Automatisierung
* [KI-Berechtigungen](/l/de/user-guide/ai/capabilities/permissions-access-control) — Zugriffskontrolle für KI-Agenten

View File

@@ -0,0 +1,37 @@
---
title: KI-Chatbot
description: Ein intelligenter Assistent, der Ihnen hilft, mit Ihren CRM-Daten in natürlicher Sprache zu interagieren.
---
## Überblick
Stellen Sie Fragen in natürlicher Sprache und der Assistent holt und erklärt Ihre CRM-Daten für Sie.
## Funktionen
| Funktion | Beschreibung |
| ----------------------------------- | ----------------------------------------------------------------------------------------- |
| **Abfragen in natürlicher Sprache** | Stellen Sie Fragen in einfachem Englisch, anstatt Filter zu erstellen |
| **Vollständiger Datenzugriff** | Fragen Sie Datensätze, Beziehungen und Kennzahlen in Ihrem Arbeitsbereich ab |
| **Seitenkontext** | Verweisen Sie je nach aktueller Ansicht auf "dieses Unternehmen" oder "diese Opportunity" |
| **Dialogorientiert** | Nachfragen behalten den Kontext aus vorherigen Abfragen bei |
## Beispielinteraktionen
### Datensätze finden
* "Zeige mir alle Opportunities über $50,000"
* "Finde Kontakte, denen ich seit 2 Wochen keine E-Mail geschrieben habe"
* "Liste Unternehmen in der Gesundheitsbranche auf"
### Einblicke gewinnen
* "Wie hoch ist der Gesamtwert meiner Pipeline?"
* "Wie viele Deals wurden im letzten Monat abgeschlossen?"
* "Welche Phase hat die meisten feststeckenden Opportunities?"
### Seitenkontext nutzen
* "Fasse meine Interaktionen mit dieser Person zusammen" (auf einer Kontaktseite)
* "Welche Opportunities sind mit diesem Unternehmen verknüpft?" (auf einer Unternehmensseite)
* "Wann wurde dieser Deal zuletzt aktualisiert?" (auf einer Opportunity-Seite)

View File

@@ -0,0 +1,137 @@
---
title: MCP-Server
description: Verbinden Sie KI-Assistenten mit Ihrem Twenty-Workspace über das Model Context Protocol.
---
Twenty stellt einen [MCP](https://modelcontextprotocol.io/)-Server bereit, damit KI-Assistenten — Claude Desktop, Claude Code, Cursor, ChatGPT und andere — Ihre CRM-Daten in natürlicher Sprache lesen und schreiben können.
Verwenden Sie Ihre **Workspace-URL** (die URL, mit der Sie auf Twenty zugreifen) als MCP-Endpunkt. In Twenty Cloud kann Ihre Workspace-URL `https://{mycompany}.twenty.com` oder eine benutzerdefinierte Domain sein. Der Server ist verfügbar unter:
| Umgebung | MCP-Endpunkt |
| ----------------- | ----------------------------------------------------------------------------- |
| **Cloud** | `https://{your-workspace-url}/mcp` (z. B. `https://mycompany.twenty.com/mcp`) |
| **Selbsthosting** | `https://{your-domain}/mcp` |
## Authentifizierungsmethoden
Sie haben zwei Möglichkeiten, Ihren MCP-Client zu authentifizieren: **OAuth** (empfohlen) oder **API-Schlüssel**.
### Option A — OAuth (empfohlen)
Mit OAuth öffnet Ihr MCP-Client ein Browserfenster, damit Sie sich anmelden können. Es werden keine geheimen Informationen in Konfigurationsdateien gespeichert, und Token werden automatisch erneuert.
<Note>
OAuth erfordert einen MCP-Client, der die [MCP-Autorisierungsspezifikation](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization) unterstützt. Claude Desktop, Claude Code, Cursor und ChatGPT unterstützen dies.
</Note>
Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu und ersetzen Sie `{your-workspace-url}` durch den Host Ihrer Workspace-URL (z. B. `mycompany.twenty.com`):
```json
{
"mcpServers": {
"twenty": {
"type": "streamable-http",
"url": "https://{your-workspace-url}/mcp"
}
}
}
```
Das ist alles — kein API-Schlüssel erforderlich. Wenn der Client sich zum ersten Mal verbindet, wird er:
1. Die OAuth-Metadaten von Twenty über `/.well-known/oauth-protected-resource` und `/.well-known/oauth-authorization-server` ermitteln
2. Sich über die dynamische Client-Registrierung (RFC 7591) als OAuth-Client registrieren
3. Ihren Browser öffnen, um den Zugriff zu autorisieren
4. Token empfangen und eine Verbindung zum MCP-Server herstellen
Nachfolgende Verbindungen verwenden die gespeicherten Token erneut und erneuern sie automatisch.
### Option B — API-Schlüssel
Wenn Ihr MCP-Client OAuth nicht unterstützt oder Sie statische Anmeldeinformationen bevorzugen, übergeben Sie einen API-Schlüssel im `Authorization`-Header:
```json
{
"mcpServers": {
"twenty": {
"type": "streamable-http",
"url": "https://{your-workspace-url}/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
<Warning>
Ihr API-Schlüssel gewährt Zugriff auf Workspace-Daten. Halten Sie es von der Versionskontrolle und von gemeinsam genutzten Dotfiles fern.
</Warning>
Um einen API-Schlüssel zu erstellen, gehen Sie zu **Settings → MCP & APIs → API → + Create key**. Details finden Sie unter [APIs](/l/de/developers/extend/api#create-an-api-key).
## Schnellstart
### 1. Konfiguration kopieren
Gehen Sie in Twenty zu **Settings → MCP & APIs → MCP**. Wählen Sie Ihre Authentifizierungsmethode (OAuth oder API-Schlüssel), kopieren Sie das JSON-Snippet (es verwendet bereits Ihre Workspace-URL) und fügen Sie es in die Konfigurationsdatei Ihres MCP-Clients ein.
| Client | Speicherort der Konfigurationsdatei |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) oder `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
| **Claude Code** | `~/.claude.json` (Benutzer) oder `.mcp.json` (Projekt) |
| **Cursor** | `.cursor/mcp.json` in Ihrem Projekt oder `~/.cursor/mcp.json` global |
| **ChatGPT** | Aktivieren Sie den Entwicklermodus in **Settings → Apps & Connectors → Advanced settings** und verwenden Sie dann **Create** in **Settings → Apps & Connectors**, um den MCP-Server hinzuzufügen |
### 2. Verbinden
Starten Sie Ihren MCP-Client neu (oder laden Sie die Konfiguration neu). Bei Verwendung von OAuth werden Sie zu Twenty weitergeleitet, um den Zugriff zu autorisieren. Bei Verwendung eines API-Schlüssels wird die Verbindung sofort hergestellt.
### 3. Jetzt loslegen
Bitten Sie Ihren KI-Assistenten, mit Ihrem CRM zu interagieren:
* *"Zeige mir die 5 zuletzt erstellten Unternehmen"*
* *"Erstelle eine neue Person namens Jane Doe bei Acme Corp"*
* *"Finde alle offenen Verkaufschancen mit einem Wert von mehr als $10k"*
## Verfügbare Tools
Nach der Verbindung stellt der MCP-Server Tools bereit, die die Twenty-API widerspiegeln. Der empfohlene Workflow ist:
1. **`learn_tools`** — das Eingabeschema für bestimmte Tools abrufen
2. **`execute_tool`** — ein Tool ausführen
Sie müssen sich die Tool-Namen nicht merken. Fragen Sie Ihren KI-Assistenten, was er tun kann, und er ruft `learn_tools` automatisch auf.
## Berechtigungen
MCP-Verbindungen erben die Berechtigungen des authentifizierten Benutzers (OAuth) oder die dem API-Schlüssel zugewiesene Rolle. So beschränken Sie, was der MCP-Server tun darf:
* **OAuth**: Es gilt die Workspace-Rolle des Benutzers.
* **API-Schlüssel**: Weisen Sie dem API-Schlüssel unter **Settings → Members → Roles** eine Rolle zu. Siehe [Berechtigungen](/l/de/user-guide/permissions-access/capabilities/permissions).
## Selbstgehostete Konfiguration
Für selbstgehostete Instanzen ersetzen Sie `{your-workspace-url}` durch die URL Ihres Servers. Stellen Sie sicher, dass `SERVER_URL` in Ihrer Umgebung der öffentlichen URL Ihrer Twenty-Instanz entspricht — dieser Wert wird verwendet, um die OAuth-Discovery-Metadaten zu generieren.
```bash
SERVER_URL=https://twenty.yourcompany.com
```
Der MCP-Endpunkt, die OAuth-Endpunkte und die Discovery-Metadaten leiten sich alle von diesem Wert ab.
## Fehlerbehebung
**"Unauthorized"- oder 401-Fehler**
* OAuth: Autorisieren Sie erneut, indem Sie die gespeicherten Token in Ihrem MCP-Client löschen und die Verbindung wiederherstellen.
* API-Schlüssel: Überprüfen Sie, ob der Schlüssel gültig ist und nicht abgelaufen ist. Generieren Sie ihn bei Bedarf neu.
**Der OAuth-Flow öffnet keinen Browser**
* Stellen Sie sicher, dass Ihr MCP-Client MCP Authorization unterstützt. Wechseln Sie andernfalls zur API-Schlüssel-Methode.
**Verbindungszeitüberschreitung**
* Stellen Sie sicher, dass die MCP-Endpunkt-URL von Ihrem Rechner aus erreichbar ist. Bei selbstgehosteten Instanzen prüfen Sie, ob der Server läuft und `SERVER_URL` korrekt gesetzt ist.

View File

@@ -0,0 +1,35 @@
---
title: Berechtigungen & Zugriffskontrolle
description: Steuern Sie, auf welche Daten KI-Agenten in Ihrem Arbeitsbereich zugreifen und was sie dort ändern können.
---
## Übersicht
KI-Agenten respektieren Ihre bestehende Berechtigungsstruktur. Dies ist besonders wichtig für Teams, die genau steuern möchten, worauf automatisierte KI-Prozesse in ihrem Arbeitsbereich zugreifen oder was sie dort ändern können.
## Weisen Sie einem KI-Agenten eine Rolle zu
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Klicken Sie auf die Rolle, die Sie zuweisen möchten
3. Öffnen Sie den Tab **Zuweisungen**
4. Unter **KI-Agenten** klicken Sie auf **+ KI-Agent zuweisen**
5. Wählen Sie den KI-Agenten aus der Liste aus
6. Bestätigen Sie die Zuweisung
## Warum Rollen an KI-Agenten zuweisen?
| Vorteil | Beschreibung |
| ---------------------- | ------------------------------------------------------------------------------------ |
| **Sicherheit** | Beschränken Sie, auf welche Daten KI-Agenten zugreifen oder welche sie ändern können |
| **Compliance** | Stellen Sie sicher, dass die KI nur die Daten verarbeitet, die sie benötigt |
| **Kontrolle** | Verhindern Sie unbeabsichtigte Aktionen durch KI-Automatisierungen |
| **Revisionsfähigkeit** | Verfolgen Sie nach, welche Aktionen von welchem Agenten ausgeführt wurden |
<Note>
Für KI-Agenten, die innerhalb von Workflows ausgeführt werden, stellt die Rollenzuweisung sicher, dass der Agent nicht auf Daten außerhalb seines vorgesehenen Umfangs zugreifen oder diese ändern kann — selbst wenn der Workflow weitergehende Berechtigungen hat.
</Note>
## Verwandte Inhalte
* [Berechtigungen](/l/de/user-guide/permissions-access/capabilities/permissions) — ausführliche Informationen zum Erstellen und Verwalten von Rollen
* [KI-Agenten](/l/de/user-guide/ai/capabilities/ai-agents) — KI-Funktionen in Workflows

View File

@@ -0,0 +1,31 @@
---
title: KI-FAQ
description: Häufig gestellte Fragen zu KI-Funktionen in Twenty.
---
<AccordionGroup>
<Accordion title="Welche KI-Funktionen sind verfügbar?">
Zwei Hauptfunktionen der KI sind:
1. **KI-Chatbot**: Ein kontextbewusster Assistent, der auf Ihre Twenty-Daten zugreifen kann und Sie bei Anfragen unterstützt
2. **KI-Agenten in Workflows**: Intelligente Automatisierung, die Daten verarbeiten, Entscheidungen treffen und Aufgaben innerhalb Ihrer Workflows ausführen kann
</Accordion>
<Accordion title="Haben KI-Agenten Zugriff auf alle meine Daten?">
AI Agenten arbeiten unter dem Berechtigungssystem. Sie können KI-Agenten unter **Einstellungen → Mitglieder → Rollen** bestimmte Rollen zuweisen und haben damit volle Kontrolle darüber, auf welche Daten sie zugreifen können und welche Aktionen sie ausführen dürfen.
</Accordion>
<Accordion title="Wie funktionieren KI-Credits?">
KI-Aktionen verbrauchen Workflow-Credits basierend auf der Komplexität der Aufgabe und dem verwendeten KI-Modell.
</Accordion>
<Accordion title="Kann ich meine eigenen KI-Modelle verwenden?">
In der Cloud können Sie nur von Twenty bereitgestellte KI-Modelle verwenden. Auf Ihrer selbstgehosteten Instanz können Sie nach Erhalt einer Organization-Lizenz Ihre eigenen KI-Modelle verwenden.
</Accordion>
<Accordion title="Ich sehe keine Rolle, die ich einem Agenten der KI zugewiesen habe. Wo ist sie?">
Standardmäßig ist die Rollenliste auf Rollen gefiltert, die Arbeitsbereichsmitgliedern zugewiesen werden können. Wenn eine Rolle nur KI-Agenten zugewiesen werden kann, müssen Sie den Filter so ändern, dass er die Rollen des AI-Agenten enthält.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,58 @@
---
title: KI
description: KI-gestützte Funktionen in Twenty.
---
<Frame>
<img src="/images/user-guide/workflows/robot.png" alt="KI" />
</Frame>
## Funktionen
Derzeit bietet Twenty Folgendes:
### 1. KI-Chatbot
Ein konversationeller Assistent, der Ihren Kontext versteht und Zugriff auf alle Ihre Twenty-Daten hat.
**Kernfunktionen:**
* **Vollständiger Datenzugriff**: Jeden Datensatz, jede Beziehung oder Kennzahl in Ihrem Arbeitsbereich abfragen
* **Seitenkontext-Erkennung**: Verweisen Sie auf "dieses Unternehmen" oder "diese Opportunity" basierend darauf, wo Sie sich in Twenty befinden
* **Natürliche Sprache**: Stellen Sie Fragen und erhalten Sie Antworten, ohne durch Menüs zu navigieren
**Beispiel-Prompts:**
* "Welche Opportunities werden in diesem Monat abgeschlossen?"
* "Welche Deals befinden sich seit mehr als 30 Tagen in der Verhandlung?"
* "Fasse meine Interaktionen mit dieser Person zusammen"
### 2. KI-Agenten in Workflows
Erweitern Sie Ihre Workflows mit KI-gestützten Aktionen und autonomen Agenten.
**Kernfunktionen:**
* **KI-Aktionen**: Nutzen Sie KI, um Daten anzureichern, Datensätze zu klassifizieren, Zusammenfassungen zu erzeugen und mehr
* **Autonome Agenten**: Lassen Sie Agenten mehrstufige Aufgaben innerhalb eines Workflows ausführen
* **Benutzerdefinierte Prompts**: Legen Sie genau fest, wie KI Ihre Daten verarbeiten soll
**Anwendungsfälle:**
* Eingehende Leads automatisch kategorisieren
* Unternehmensdaten aus öffentlichen Quellen anreichern
* Entwürfe für Follow-up-E-Mails auf Basis von Besprechungsnotizen erstellen
* Opportunities anhand von Interaktionsmustern bewerten
## Berechtigungen und Zugriffskontrolle
KI-Agenten werden über das bestehende Berechtigungssystem verwaltet:
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Konfigurieren Sie, auf welche Daten jeder KI-Agent zugreifen kann
3. Legen Sie Lese-/Schreibberechtigungen pro Objekt fest
So wird sichergestellt, dass KI-Agenten Ihre Richtlinien zur Daten-Governance respektieren und nur auf das zugreifen, was sie benötigen.
* Folgen Sie unserem [GitHub](https://github.com/twentyhq/twenty) für Entwicklungsupdates
* Treten Sie unserem [Discord](https://discord.gg/UfGNZJfAG6) bei, um Feedback und Funktionswünsche zu teilen

View File

@@ -0,0 +1,74 @@
---
title: Guthaben
description: Ein einfaches Guthaben, das Ihre Workflows, KI-Agenten und den KI-Chat antreibt – welchen Wert ein Guthaben hat, wie weit es reicht und wie Sie es verwalten.
---
## Was ist Guthaben?
Guthaben ist ein einheitlicher Saldo, der alles antreibt, was wir in Ihrem Namen ausführen und das reale Kosten verursacht: **Workflow-Automatisierungen**, **KI-Agenten** und der **KI-Chat**. Anstatt getrennte Kontingente für "Automatisierungsläufe" und "KI-Tokens" zu jonglieren, behalten Sie einfach einen einzigen, übersichtlichen Guthabensaldo im Blick.
**1 Guthaben = 1 $ Nutzung.** Ein Guthaben entspricht einem Dollar an Arbeit, sodass Ihr Guthabenstand leicht nachvollziehbar ist – keine abstrakten Einheiten, die umgerechnet werden müssen.
## Wie weit reicht ein Guthaben?
Die Kosten steigen mit dem Aufwand. Alltägliche Automatisierungen und schnelle KI-Nachrichten kosten nur einen winzigen Bruchteil eines Guthabens; große, mehrstufige Aufgaben von KI-Agenten kosten mehr. Ungefähr sieht es so aus:
| Was Sie tun | Kostet ungefähr | Was das bedeutet |
| ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------- | ------------------------------------ |
| Führe einen Standard-Workflow-Schritt aus (Datensätze suchen, erstellen oder aktualisieren) oder löse die Logikfunktion einer App aus | $0.0001 | **10.000 Ausführungen pro Guthaben** |
| Eine externe API aufrufen oder einen Code-Knoten ausführen | Ein kleiner Bruchteil eines Guthabens | Tausende pro Guthaben |
| Eine schnelle KI-Chat-Nachricht senden oder einen einfachen KI-Schritt ausführen | Ein Bruchteil eines Cents | Hunderte pro Guthaben |
| Eine große KI-Agentenaufgabe ausführen (z. B. "10 Arbeitsbereichsobjekte konfigurieren") | Kann sich auf **~1 $ oder mehr** belaufen | Einige pro Guthaben |
| Eine KI-Websuche ausführen | Ein fester Preis pro Suche | Hunderte Suchvorgänge pro Guthaben |
<Note>
Für die meisten Teams sind Standardautomatisierungen praktisch kostenlos – eine spürbare Auswirkung auf Ihr Guthaben bemerken Sie erst, wenn Sie sich stark auf KI-Funktionen stützen oder rechenintensive Code-Knoten ausführen. Das ist so beabsichtigt: Das enthaltene Guthaben soll es Ihnen ermöglichen, zu arbeiten, ohne ständig auf einen Zähler achten zu müssen.
</Note>
<Note>
Nicht jede App berechnet ihre Ausführungen. Anrufaufzeichnung und Letzter Kontakt reagieren auf jede in Ihren Arbeitsbereich importierte E-Mail und Kalenderereignis, so dass deren logische Funktion frei läuft. Sie werden weiterhin für die gemessene Arbeit, die sie ausführen, abgerechnet, zum Beispiel für aufgezeichnete Gesprächsminuten.
</Note>
## Wie KI-Nutzung gemessen wird
Wenn eine Aktion ein KI-Modell aufruft, messen wir die tatsächlich verwendeten Tokens und berechnen sie zu **den veröffentlichten Preisen des Modellanbieters**. Anschließend wandeln wir diesen Dollarbetrag direkt in Credits um – sodass Ihre Ausgaben den tatsächlichen Kosten der Arbeit folgen und nicht einem intern aufgeschlagenen Tarif. Eine kurze Chat-Nachricht kostet einen Bruchteil eines Cents. Eine große Agentenaufgabe – sagen wir, das Konfigurieren von 10 Arbeitsbereichsobjekten – macht viele Modellaufrufe über einen wachsenden Kontext so dass es zu einem Dollar oder mehr summen kann. Sie zahlen nur für das, was Sie tatsächlich nutzen – bis hinunter auf Token-Ebene.
Die Kosten variieren je nach Modell: Ein leichtgewichtiges Modell ist pro Nachricht deutlich günstiger als ein erstklassiges Reasoning-Modell. In **Einstellungen → Abrechnung** sehen Sie die Aufschlüsselung pro Aktion – einschließlich des jeweils verwendeten Modells.
## Was enthalten ist
Jedes Abonnement enthält Guthaben, und die Menge hängt von Ihrem **Abrechnungszeitraum** ab, nicht von Ihrem Tarif:
| Abrechnungszeitraum | Enthaltenes Guthaben | Äquivalente Nutzung |
| ------------------- | -------------------- | --------------------- |
| Monatlich | 5 / Monat | ~$5 Nutzung pro Monat |
| Jährlich | 50 / Jahr | ~$50 Nutzung pro Jahr |
Dieses Guthaben ist so ausgelegt, dass es alltägliche Automatisierungen bequem abdeckt. Fünf Credits decken Zehntausende von Standard-Automatisierungsschritten oder Hunderte von schnellen KI-Nachrichten ab – obwohl eine Handvoll großer, mehrstufige Agenten-Aufgaben können diese schneller nutzen. Sie können Ihr Guthaben jederzeit aufstocken (siehe unten).
## Guthabenübertrag
Ungenutztes Guthaben wird automatisch in den nächsten Abrechnungszeitraum übertragen.
* **Cap**: Rollover ist für eine Periode in voller Höhe begrenzt, so dass du nie mehr als dein Abrechnungszyklus pro Periode vorsieht.
* **Sichtbarkeit**: Wenn übertragene Guthaben verfügbar sind, erscheinen sie als eigene Zeile **Übertragene Guthaben** in **Einstellungen → Abrechnung**, neben dem Saldo **Insgesamt verfügbar**.
## Überwachungsnutzung
Behalten Sie Ihr Guthaben und dessen Verwendung im Blick:
1. Gehen Sie zu **Einstellungen → Abrechnung**
2. Sehen Sie Ihr **verbleibendes Guthaben** und die **Nutzung im aktuellen Zeitraum**
3. Analysieren Sie die Aufschlüsselung, um zu sehen, welche Workflows und KI-Aktionen Guthaben verbrauchen – und welche Modelle diese KI-Aktionen verwendet haben
Wenn Sie dies regelmäßig überprüfen, erkennen Sie einen ressourcenintensiven Workflow frühzeitig und können entscheiden, ob Sie ihn optimieren oder Ihr Guthaben aufstocken möchten.
## Benötigen Sie mehr Guthaben?
Wenn Ihr Guthaben aufgebraucht ist – oder Sie vor einer großen Automatisierungswelle einen Puffer haben möchten – können Sie jederzeit zusätzliche Guthabenpakete kaufen:
1. Gehen Sie zu **Einstellungen → Abrechnung**
2. Klicke auf den **Erhöhen** Button
3. Wählen Sie den benötigten Betrag aus und akzeptieren Sie die Änderungen
Gekauftes Guthaben wird Ihrem verfügbaren Guthaben sofort hinzugefügt.

View File

@@ -0,0 +1,100 @@
---
title: Preispläne
description: Erfahren Sie mehr über die Preispläne von Twenty und wie Sie zwischen ihnen wechseln können.
---
## Übersicht
Twenty bietet flexible Preise, die zu Teams jeder Größe passen – egal, ob Sie Cloud-Hosting oder Selbsthosting bevorzugen.
## Cloud-Pläne
### Pro (Cloud)
Für Teams, die bereit sind zu skalieren:
* Alle CRM-Kernfunktionen
* E-Mail- und Kalendersynchronisierung
* Workflows und Automatisierungen
* Standard-Support
<Note>
Premiumfunktionen (SSO, Berechtigungen auf Zeilenebene, KI-Nutzungsdaten und mehr) sind im Pro-Tarif nicht enthalten.
</Note>
### Organisation (Cloud)
Für größere Teams mit erweiterten Anforderungen:
* Alles aus Pro
* **Premiumfunktionen**: SSO-Integration, Berechtigungen auf Zeilenebene, KI-Nutzungsdaten und mehr
* Vorrangiger Support
## Selbstgehostete Pläne
### Kostenlos (Selbstgehostet)
Hosten Sie Twenty auf Ihrer eigenen Infrastruktur kostenlos:
* Alle Pro-Funktionen enthalten
* Community-Support über Discord
* Volle Kontrolle über Ihre Daten
### Organisation (Selbstgehostet)
Für Teams, die beim Selbsthosting Premiumfunktionen benötigen:
* Alle Pro-Funktionen
* **Premiumfunktionen**: SSO-Integration, Berechtigungen auf Zeilenebene, KI-Nutzungsdaten und mehr
* Support durch das Twenty-Team
* Keine Verpflichtung, benutzerdefinierten Code vor der Weitergabe als Open Source zu veröffentlichen
## Premiumfunktionen
Premiumfunktionen sind nur in den Organisation-Plänen (Cloud oder Selbstgehostet) verfügbar:
* **SSO-Integration**: Single Sign-On mit Ihrem Identitätsanbieter
* **Berechtigungen auf Zeilenebene**: Feingranulare Zugriffskontrolle auf Datensatzebene
* **KI-Nutzungsdaten**: Verfolgen Sie den KI-Verbrauch in Ihrem Arbeitsbereich
* **Audit-Logs**: Prüfen Sie, was jedes Mitglied des Arbeitsbereichs gemacht hat
* **E-Mail-Kampagnen**: Planen Sie, welche E-Mails gesendet werden sollen (bald verfügbar)
* **Unbegrenzte Arbeitsbereiche**: Erstellen Sie so viele Arbeitsbereiche, wie Sie möchten (nur bei Self-Hosting)
* **Privater Quellcode**: Keine Verpflichtung, Änderungen in einem öffentlich zugänglichen Repository zu veröffentlichen (nur bei Self-Hosting)
## Pläne wechseln
### Upgrade auf Organisation
1. Gehen Sie zu **Einstellungen → Abrechnung → Pläne**
2. Klicken Sie auf **Zu Organisation wechseln**
3. Bestätigen Sie Ihr Upgrade
### Downgrade auf Pro
1. Gehen Sie zu **Einstellungen → Abrechnung → Pläne**
2. Klicken Sie auf **Zu Pro wechseln**
3. Bestätigen Sie Ihre Herabstufung
### Zur jährlichen Abrechnung wechseln
1. Gehen Sie zu **Einstellungen → Abrechnung**
2. Klicken Sie auf **Auf jährlich umstellen**
3. Mit jährlicher Abrechnung sparen
### Zur monatlichen Abrechnung wechseln
1. Gehen Sie zu **Einstellungen → Abrechnung**
2. Klicken Sie auf **Auf monatlich herabstufen**
3. Sparen Sie mit monatlicher Abrechnung
## Enterprise-Schlüssel für Organization (Self-Hosted) abrufen
Um den Tarif Organization (Self-Hosted) zu verwenden, müssen Sie einen Enterprise-Schlüssel abrufen:
1. Gehen Sie zu **Einstellungen → Admin-Panel → Enterprise**
<img src="/images/user-guide/billing/enterprise-key.png" alt="Enterprise-Schlüssel" />
2. Klicken Sie auf **Enterprise-Schlüssel abrufen**
3. Wenn Sie zu Stripe weitergeleitet werden, geben Sie Ihre Zahlungsdaten ein und bestätigen Sie
4. Wenn Ihr Enterprise-Schlüssel angezeigt wird, fügen Sie ihn auf der Seite Enterprise-Einstellungen ein und aktivieren Sie die Organization-Lizenz

View File

@@ -0,0 +1,105 @@
---
title: FAQ zur Abrechnung
description: Häufig gestellte Fragen zu den Twenty-Preisen und der Abrechnung.
---
## Preisgestaltung
<AccordionGroup>
<Accordion title="Kann ich Twenty kostenlos beim Selbsthosting nutzen?">
Ja, Sie können Twenty kostenlos beim Selbsthosting nutzen. Sie erhalten Zugang zu allem, was im Plan Pro (Cloud) enthalten ist, mit Ausnahme der Unterstützung von unserem Kernteam. Support ist über unsere Discord-Community zugänglich.
Wenn Sie selbst hosten möchten und die Premium-Funktionen (SSO, Berechtigungen auf Zeilenebene und mehr) benötigen, können Sie die kostenpflichtige Lizenz "Organization (Self-Hosted)" wählen. Dies umfasst auch Support durch das Twenty-Team und hebt die Verpflichtung auf, benutzerdefinierten Code vor der Verteilung als Open Source zu veröffentlichen.
</Accordion>
<Accordion title="Was sind die Premium-Funktionen?">
Premium-Funktionen sind nur in den Organization-Tarifen (Cloud oder Self-Hosted) verfügbar:
* **SSO-Integration**: Single Sign-On mit Ihrem Identitätsanbieter
* **Berechtigungen auf Zeilenebene**: feingranulare Zugriffskontrolle auf Datensatzebene
* **KI-Nutzungsdaten**: Verfolgen Sie den KI-Verbrauch in Ihrem Arbeitsbereich
* **Audit-Logs**: Prüfen Sie, was jedes Mitglied des Arbeitsbereichs gemacht hat
* **E-Mail-Kampagnen**: Planen Sie, welche E-Mails gesendet werden sollen (bald verfügbar)
* **Unbegrenzte Arbeitsbereiche**: Erstellen Sie so viele Arbeitsbereiche, wie Sie möchten (nur bei Self-Hosting)
* **Privater Quellcode**: Keine Anforderung um Änderungen in einem öffentlich zugänglichen Repository zu veröffentlichen (nur selbst-gehostet)
</Accordion>
<Accordion title="Sind die Pläne der Cloud und der Selbstgehosteten Organisation identisch?">
Sie bieten dieselben Premium-Funktionen. Ein Cloud-Abonnement kann jedoch nicht für selbst gehostete Bereitstellungen verwendet werden. Für selbst gehostete Bereitstellungen ist ein Enterprise-Schlüssel erforderlich.
</Accordion>
<Accordion title="Bieten Sie kostenlose Plätze für Nur-Ansicht-Benutzer an?">
Wir bieten keine kostenlosen Plätze an. Die Preise verstehen sich pro Nutzer und jeder Nutzer benötigt eine Lizenz für den Zugriff auf Twenty.
</Accordion>
<Accordion title="Wo kann ich mein Abonnement auf den Organisationsplan umstellen?">
Dies können Sie unter `Einstellungen → Rechnungsstellung → Pläne` tun. Klicken Sie dann auf `Auf Organisation umstellen`.
</Accordion>
<Accordion title="Wo kann ich mein Abonnement auf den Pro-Plan umstellen?">
Dies können Sie unter `Einstellungen → Rechnungsstellung → Pläne` tun. Klicken Sie dann auf `Auf Pro umstellen`.
</Accordion>
<Accordion title="Wo kann ich mein Abonnement auf jährlich umstellen?">
Dies können Sie unter `Einstellungen → Rechnungsstellung` tun. Klicken Sie dann auf `Auf jährlich umstellen`.
</Accordion>
<Accordion title="Wo kann ich mein Abonnement auf monatlich umstellen?">
Dies können Sie unter `Einstellungen → Rechnungsstellung` tun. Klicken Sie dann auf `Auf monatlich umstellen`.
</Accordion>
<Accordion title="Wo kann ich meine Kreditausnutzung sehen?">
Das finden Sie unter `Einstellungen → Rechnungsstellung`.
</Accordion>
<Accordion title="Wie viele Workflow-Credits haben wir?">
Guthaben richten sich nach Ihrem Abrechnungszeitraum, nicht nach Ihrem Tarif:
* **Monatliche Abonnements**: 5 Guthaben pro Monat
* **Jährliche Abonnements**: 50 Guthaben pro Jahr
</Accordion>
<Accordion title="Wie funktioniert der Verbrauch von Workflow-Credits?">
Jede Workflow-Aktion verbraucht Credits basierend auf ihrer Komplexität:
* **Einfache interne Operation** (wie Suchen, Aktualisieren oder Erstellen von Datensätzen) verbrauchen nur sehr wenige Credits
* **Komplexere Operationen** wie Code-Knoten und Anfragen an externe Dienste verbrauchen mehr Credits
* **AI Prompts** verbrauchen ebenfalls mehr Credits, abhängig von der Nutzung
* **Apps** verbraucht auch mehr Credits ähnlich wie Code-Knoten
Credits werden in Echtzeit abgezogen, wenn Workflows oder Apps ausgeführt werden. Sie können Ihren Verbrauch in **Einstellungen → Rechnungsstellung** überwachen, um den Verbrauch und die verbleibenden Credits zu verfolgen.
</Accordion>
<Accordion title="Kann ich mehr Workflow-Credits kaufen?">
Sie können zusätzliche Credits unter `Einstellungen → Rechnungsstellung` kaufen.
</Accordion>
<Accordion title="Kann ich nur für 1 Monat zusätzliche Workflow-Credits kaufen?">
Ja, gehen Sie zu `Einstellungen → Abrechnung`, klicken Sie auf den `Erhöhen`-Button, wählen Sie aus, wie viele Guthaben Sie möchten, und bestätigen Sie diese. Sie werden für den aktuellen Abrechnungszeitraum angewendet. Dann klicke erneut auf den `Increase`-Button, ändere den Wert zurück zum Original, und bestätigen — das Downgrade wird ab dem nächsten Abrechnungszeitraum angewandt.
</Accordion>
</AccordionGroup>
## Abrechnung
<AccordionGroup>
<Accordion title="Wo kann ich die Rechnungsdetails verwalten?">
Dies können Sie unter `Einstellungen → Rechnungsstellung` tun.
</Accordion>
<Accordion title="Wo kann ich meine Zahlungsmethode aktualisieren?">
Dies können Sie unter `Einstellungen → Rechnungsstellung` tun. Klicken Sie dann auf `Rechnungsdetails anzeigen`. Dort können Sie eine neue Zahlungsmethode hinzufügen.
</Accordion>
<Accordion title="Wo kann ich meine Rechnungsinformationen aktualisieren?">
Dies können Sie unter `Einstellungen → Rechnungsstellung` tun. Klicken Sie dann auf `Rechnungsdetails anzeigen`. Dort können Sie die Rechnungsinformationen bearbeiten.
</Accordion>
<Accordion title="Wo kann ich auf meine Rechnungen zugreifen?">
Dies können Sie unter `Einstellungen → Rechnungsstellung` tun. Klicken Sie dann auf `Rechnungsdetails anzeigen`. Sie sehen alle Ihre Rechnungen unten auf dem Bildschirm.
</Accordion>
<Accordion title="Warum ist die Anzahl meiner Plätze anders als die Anzahl der Benutzer in meinem Arbeitsbereich?">
Die Anzahl der Plätze im Arbeitsbereich wird alle 6 Stunden mit dem Zahlungssystem synchronisiert; Rechnungen werden anhand der Differenz angepasst.
</Accordion>
<Accordion title="Warum habe ich eine Rechnung für ein neues Mitglied des Arbeitsbereichs erhalten?">
Wenn ein neues Arbeitsbereichsmitglied zum Arbeitsbereich hinzugefügt wird, wird eine Rechnung gesendet, um die Differenz abzudecken. Wenn ein Mitglied des Arbeitsbereichs entfernt wird, wird die Änderung in der nächsten regulären Monats-/Jahresrechnung berücksichtigt.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,39 @@
---
title: Abrechnung
description: Verstehen Sie die Preisgestaltung von Twenty und verwalten Sie Ihr Abonnement.
---
Twenty bietet flexible Preispläne, die den Bedürfnissen Ihres Teams entsprechen. Verwalten Sie Ihr Abonnement, verfolgen Sie Workflow-Guthaben und greifen Sie auf Rechnungen zu – alles über **Einstellungen → Abrechnung**.
## Was enthält dieser Abschnitt
<CardGroup cols={2}>
<Card title="Preispläne" icon="tags" href="/l/de/user-guide/billing/capabilities/pricing-plans">
Erfahren Sie mehr über die Preispläne von Twenty und was enthalten ist.
</Card>
<Card title="FAQ" icon="circle-question" href="/l/de/user-guide/billing/how-tos/billing-faq">
Häufig gestellte Fragen zu Preisen und Abrechnung.
</Card>
</CardGroup>
## Auf einen Blick
| Plan | Wichtige Funktionen |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Kostenlos (Selbstgehostet)** | Alle Pro-Funktionen, Community-Support |
| **Pro (Cloud)** | Alles außer den Premiumfunktionen (SSO, zeilenbasierte Berechtigungen und mehr), Standard-Support |
| **Organisation (Cloud)** | Alles aus Pro + die Premiumfunktionen (SSO, zeilenbasierte Berechtigungen und mehr), Prioritäts-Support |
| **Organisation (Selbstgehostet)** | Alles aus Pro + die Premiumfunktionen (SSO, zeilenbasierte Berechtigungen und mehr), Twenty-Team-Support, keine Verpflichtung, benutzerdefinierten Code vor der Verteilung als Open Source zu veröffentlichen |
## Schnelle Antworten
**Wo verwalte ich die Abrechnung?**
Gehen Sie zu **Einstellungen → Abrechnung**, um Ihren Plan anzusehen, Zahlungsmethoden zu aktualisieren und auf Rechnungen zuzugreifen.
**Kann ich Twenty kostenlos nutzen?**
Ja! Hosten Sie Twenty selbst und erhalten Sie alle Pro-Funktionen kostenlos.
**Wie führe ich ein Upgrade durch?**
Gehen Sie zu **Einstellungen → Abrechnung** und klicken Sie auf **Zu Organisation wechseln** oder **Zum Jahresplan wechseln**.
Weitere Fragen finden Sie in den [Abrechnungs-FAQs](/l/de/user-guide/billing/how-tos/billing-faq).

View File

@@ -0,0 +1,43 @@
---
title: Kalender
description: Die Funktionen der Kalenderintegration in Twenty verstehen.
---
**Hinweis**: Um Ihren Kalender zu verbinden und die Synchronisierungseinstellungen zu konfigurieren, besuchen Sie [E-Mail- & Kalendereinrichtung](/l/de/user-guide/calendar-emails/overview).
## Wie die Kalenderintegration funktioniert
Twenty synchronisiert Ihre Kalendertermine automatisch und verknüpft sie mit den entsprechenden CRM-Datensätzen, sodass Sie einen vollständigen Überblick über Ihre Meeting-Historie mit Kontakten und Unternehmen erhalten.
## Kalender-Reiter
Neben dem Reiter E-Mails in Datensätzen finden Sie einen Reiter `Kalender`, der die Historie der mit dem Datensatz geplanten Meetings enthält.
### Verfügbar für
* **Personen**: Alle mit einem bestimmten Kontakt geplanten Meetings anzeigen
* **Unternehmen**: Alle Meetings im Zusammenhang mit einem Unternehmen und seinen Mitarbeitern anzeigen
* **Chancen**: Zugriff auf den Meetingverlauf des mit der Chance verknüpften Unternehmens
### Meeting-Historie anzeigen
1. **Zu einem Datensatz gehen**: Gehen Sie zu einem beliebigen Personen-, Firmen- oder Chancen-Datensatz
2. **Wählen Sie den Kalender-Reiter**: Klicken Sie auf den "Kalender"-Reiter neben dem E-Mails-Reiter
3. **Durchsuchen Sie die Meeting-Historie**: Alle geplanten Meetings und deren Details anzeigen
4. **Auf Meeting-Kontext zugreifen**: Teilnehmer, Zeiten und verwandte Informationen einsehen
## Sichtbarkeitseinstellungen
Kalenderdaten folgen denselben Sichtbarkeitseinstellungen wie E-Mails und gewährleisten konsistente Datenschutzkontrollen in beiden Kommunikationskanälen.
## Was synchronisiert wird
* **Externe Meetings**: Alle Meetings mit Kontakten außerhalb Ihrer Organisation
* **Automatische Verknüpfung**: Meetings werden basierend auf den E-Mail-Adressen der Teilnehmer mit bestehenden Personen- und Firmendatensätzen verknüpft
* **Meeting-Details**: Betreff, Uhrzeit, Dauer und Teilnehmer
* **Aktualisierungen**: Neue Kalendertermine werden automatisch synchronisiert
## Was nicht synchronisiert wird
* **Interne Meetings**: Meetings zwischen Kollegen (gleiche Domain) bleiben privat
* **Private Termine**: Termine, die in Ihrem Kalender als privat markiert sind

View File

@@ -0,0 +1,102 @@
---
title: Postfach
description: E-Mail-Integrationsfunktionen in Twenty verstehen.
---
**Hinweis**: Um Ihre E-Mail-Konten zu verbinden und die Synchronisierungseinstellungen zu konfigurieren, besuchen Sie [E-Mail- & Kalendereinrichtung](/l/de/user-guide/calendar-emails/overview).
## Wie die E-Mail-Integration funktioniert
Twenty verknüpft E-Mails automatisch aus Ihren verknüpften Postfächern mit den relevanten CRM-Datensätzen, um den gesamten Kommunikationsverlauf an einem Ort zu halten.
### Objekte, in denen E-Mails gefunden werden können
E-Mail-Konversationen erscheinen in drei Hauptobjekten:
* **Personen**: Alle E-Mails mit einem bestimmten Kontakt anzeigen
* **Unternehmen**: Alle E-Mails zu einem Unternehmen und seinen Mitarbeitern anzeigen
* **Chancen**: Zugriff auf E-Mail-Threads in Verbindung mit dem Unternehmen, die mit der Möglichkeit verbunden sind. E-Mail-Threads von einzelnen Personen innerhalb der Gelegenheit werden noch nicht angezeigt.
### E-Mail-Threads anzeigen
1. **Zu einem Datensatz gehen**: Gehen Sie zu einem beliebigen Personen-, Firmen- oder Chancen-Datensatz
2. **Wählen Sie den Tab "E-Mails"**: Klicken Sie auf den Reiter "E-Mails", um die synchronisierten E-Mails anzuzeigen
3. **Öffnen Sie einen E-Mail-Thread**: Klicken Sie auf eine beliebige E-Mail, um die vollständige Konversation zu öffnen und zu lesen
4. **Durchsuchen Sie den Verlauf**: Blättern Sie durch den vollständigen E-Mail-Verlauf mit diesem Kontakt
<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
## Was Sie sehen werden
### E-Mail-Thread-Ansicht
Wenn Sie einen E-Mail-Thread öffnen, können Sie:
* **Vollständige Gespräche lesen**: Den kompletten E-Mail-Austausch ansehen
* **Teilnehmer anzeigen**: Alle Personen im E-Mail-Thread sehen
* **Zeitstempel prüfen**: Genau wissen, wann jede E-Mail gesendet wurde
* **Zugang zum Kontext**: Den gesamten Kommunikationsverlauf verstehen
### E-Mail-Sichtbarkeit
Je nach den Einstellungen Ihres Postfachs können Sie sehen:
* **Vollständiger Inhalt**: Vollständiger E-Mail-Text und Details
* **Betreff + Metadaten**: Betreffzeile, Absender, Empfänger und Zeitstempel
* **Nur Metadaten**: Grundlegende Informationen ohne E-Mail-Inhalt
## E-Mail-Synchronisierungsverhalten
### Synchronisierungsrate
Twenty importiert E-Mails mit ungefähr **400 Nachrichten pro Minute**. Diese Rate ist derzeit durch das Ratenlimit der Gmail-API begrenzt (und gilt ähnlich für andere Anbieter).
Zur Orientierung:
* 1.000 E-Mails → ~2,5 Minuten
* 10.000 E-Mails → ~25 Minuten
* 50.000 E-Mails → ~2 Stunden
### Was synchronisiert wird
* **Externe E-Mails**: Alle E-Mails mit Kontakten außerhalb Ihrer Organisation
* **Automatische Verknüpfung**: E-Mails werden mit bestehenden Personen- und Firmendatensätzen verbunden
* **Mehrfache Adressen**: E-Mails von jeder Adresse werden mit dem gleichen Kontaktdatensatz verbunden
* **Aktualisierungen**: Neue E-Mails erscheinen sofort
### Was nicht synchronisiert wird
* **Interne E-Mails**: Standardmäßig bleiben E-Mails zwischen Kolleg:innen (gleiche Domain) privat (konfiguriert unter Einstellungen → Allgemein → Sicherheit)
* **Gruppen-E-Mails**: Verteilerlisten und Gruppen-E-Mails sind ausgeschlossen
* **Ausgeschlossene Ordner**: Ordner, die Sie nicht synchronisieren möchten (konfiguriert unter Einstellungen → Konten → E-Mail)
### Interne E-Mails
Wählen Sie, ob interne E-Mails in Twenty synchronisiert werden:
1. Gehen Sie zu **Einstellungen → Allgemein → Sicherheit**
2. Schalten Sie **Interne E-Mails synchronisieren** ein/aus
### Selektive Ordnersynchronisierung
Bestimmen Sie, welche E-Mail-Ordner mit Twenty synchronisiert werden:
1. Gehen Sie zu **Einstellungen → Konten** und wählen Sie Ihr verbundenes E-Mail-Konto aus
2. Konfigurieren Sie die Ordner im Bereich E-Mail
3. Wählen Sie spezifische Ordner zum Einschließen oder Ausschließen (Posteingang, Gesendet, Archiv, benutzerdefinierte Ordner)
## Fehlerbehebung bei der E-Mail-Synchronisierung
### Häufige Synchronisierungsprobleme
* **Synchronisierungsverzögerungen**: E-Mails erscheinen sofort, aber der erste Import dauert länger
* **Fehlende E-Mails**: Prüfen Sie, ob:
* Ordner in den Einstellungen für Nachrichtenordner ausgeschlossen sind
* Die automatische Erstellung von Kontakten deaktiviert ist (E-Mails benötigen vorhandene Twenty-Datensätze)
* E-Mails von Kollegen (gleiche Domain) oder Gruppenlisten stammen
* Die Mailbox die erste Synchronisierung noch abschließt
### E-Mail-Beschränkungen
* **Systemordner**: Einige E-Mail-Ordner sind möglicherweise nicht zur Synchronisierung verfügbar
* **Aliase**: Nur echte Postfächer können verbunden werden (nicht E-Mail-Aliase)

View File

@@ -0,0 +1,25 @@
---
title: Kann ich Meetings aus Twenty buchen?
description: Informationen zum direkten Buchen von Meetings aus Twenty.
---
## Aktueller Status
Die Kalenderintegration von Twenty ist dafür ausgelegt, Ihre vorhandenen Kalenderereignisse zu **synchronisieren und anzuzeigen**.
## Besprechungen über Workflows planen
Auch wenn es nicht möglich ist, Meetings manuell zu planen, können Sie diese in 20 Arbeitsabläufen planen.
1. Erstellen Sie einen neuen Workflow
2. Wählen Sie je nach Bedarf einen beliebigen Auslöser aus
3. Fügen Sie den **Create Calendar Event**-Knoten hinzu
4. Konfigurieren Sie alle erforderlichen Daten
5. Aktivieren Sie den Workflow
## Was Sie tun können
* **Meeting-Verlauf anzeigen** bei Datensätzen zu Personen, Unternehmen und Gelegenheiten
* **Bevorstehende Meetings anzeigen** mit Kontakten in Ihrem CRM
* **Meeting-Kontext nachverfolgen** parallel zur E-Mail-Kommunikation
* **Kontakte automatisch erstellen** aus Meeting-Teilnehmenden

View File

@@ -0,0 +1,53 @@
---
title: Kann ich E-Mails aus Twenty senden?
description: Informationen zum direkten Senden von E-Mails aus Twenty.
---
## Aktueller Status
Die E-Mail-Integration von Twenty ist dafür ausgelegt, Ihren E-Mail-Verlauf zu **synchronisieren und anzuzeigen** sowie E-Mails zu verfassen und zu senden.
Wenn Sie einen E-Mail-Thread auf einer Datensatzseite ansehen und auf **Antworten** klicken, können Sie direkt eine E-Mail verfassen und senden.
## So senden Sie eine Nachricht aus Twenty
Voraussetzung: Ein verknüpftes E-Mail-Konto mit der Möglichkeit, E-Mails zu senden
1. Öffne das Befehlsmenü mit der **Strg+K** oder **Cmd+K** Verknüpfung
2. Klicken Sie auf die Option "E-Mail erstellen"
3. Wählen Sie Empfänger, Betreff und Anhänge zu Ihrer E-Mail
4. Klicken Sie auf "Senden" um die E-Mail zu senden
## Was Sie heute tun können
* **E-Mail-Verlauf anzeigen** bei Datensätzen zu Personen, Unternehmen und Gelegenheiten
* **Vollständige E-Mail-Threads lesen** mit Kontakten in Ihrem CRM
* **Kommunikationskontext nachverfolgen** zusammen mit Kalenderereignissen
* **Kontakte automatisch erstellen** aus E-Mail-Interaktionen
* **Per Weiterleitung antworten** — klicken Sie auf Antworten, um zu Ihrem Postfach zu springen
## E-Mails über Workflows senden
Du **kannst E-Mails automatisch mit Workflows versenden**. Dies ist nützlich für:
* Automatisierte Nachverfolgungen
* Benachrichtigungen an Kontakte
* Ausgelöste Mitteilungen auf Grundlage von Änderungen an Datensätzen
Über Workflows gesendete E-Mails werden über Ihr verbundenes E-Mail-Konto versendet.
→ Erfahren Sie mehr über die [Aktion „E-Mail senden"](/l/de/user-guide/workflows/capabilities/workflow-actions#send-email)
## E-Mail-Sequenzen und Newsletter
Für E-Mail-Sequenzen und Newsletter empfehlen wir, Workflows zu verwenden, um Twenty mit einem dedizierten E-Mail-Marketing-Tool zu verbinden.
<Warning>
Massen-E-Mails sollten zum Schutz der Reputation Ihrer Domain nicht direkt aus Ihrem Postfach gesendet werden. Verwenden Sie ein dediziertes Tool für Massenkommunikation.
</Warning>
→ Siehe [E-Mails aus Workflows senden](/l/de/user-guide/workflows/capabilities/send-emails-from-workflows) für Anweisungen zur Einrichtung
## Zukünftige Pläne
Das native Verfassen von E-Mails direkt in Twenty steht auf unserer Roadmap. Beteiligen Sie sich an unseren [GitHub-Diskussionen](https://github.com/twentyhq/twenty/discussions), um Ihren Anwendungsfall zu teilen und bei der Priorisierung dieser Funktion zu helfen.

View File

@@ -0,0 +1,35 @@
---
title: Kann ich die E-Mail-Aktivität für alle Objekte nachverfolgen?
description: So funktioniert die Nachverfolgung der E-Mail-Aktivität über verschiedene Objekte hinweg.
---
## Unterstützte Objekte
Die E-Mail-Aktivität ist derzeit für **drei Standardobjekte** verfügbar:
| Objekt | Was Sie sehen |
| ----------------- | ---------------------------------------------------------------------------------- |
| **Personen** | Alle mit diesem bestimmten Kontakt ausgetauschten E-Mails |
| **Unternehmen** | Alle E-Mails mit Personen aus diesem Unternehmen (basierend auf der E-Mail-Domain) |
| **Opportunities** | E-Mails, die sich auf das mit der Verkaufschance verknüpfte Unternehmen beziehen |
## Warum nur diese Objekte?
Personen, Unternehmen und Verkaufschancen sind die zentralen Beziehungsobjekte, bei denen E-Mail-Kontext den größten Mehrwert bietet. E-Mail-Threads werden automatisch verknüpft basierend auf:
* **E-Mail-Adresse** → Abgleich mit Personendatensätzen
* **E-Mail-Domain** → Abgleich mit Unternehmensdatensätzen
* **Unternehmensbeziehung** → verknüpft mit Verkaufschancen
## Benutzerdefinierte Objekte
**E-Mail-Tracking ist nicht für benutzerdefinierte Objekte verfügbar** zurzeit.
Wenn Sie E-Mail-Kontext bei einem benutzerdefinierten Objekt benötigen, ziehen Sie Folgendes in Betracht:
* Verwenden Sie ein Beziehungsfeld, um Ihr benutzerdefiniertes Objekt mit Personen oder Unternehmen zu verknüpfen
* Den E-Mail-Verlauf im verknüpften Personen-/Unternehmensdatensatz anzeigen
## Zukünftige Pläne
Die Erweiterung der E-Mail-Sichtbarkeit auf benutzerdefinierte Objekte wird in Betracht gezogen. Teilen Sie Ihren Anwendungsfall in unseren [GitHub-Diskussionen](https://github.com/twentyhq/twenty/discussions), um die Priorisierung dieser Funktion zu unterstützen.

View File

@@ -0,0 +1,42 @@
---
title: Mehrere Postfächer pro Nutzer verbinden
description: Mehrere E-Mail-Konten für einen einzelnen Nutzer verbinden.
---
## Übersicht
Twenty unterstützt **unbegrenzte E-Mail-Konten pro Nutzer**. Dies ist nützlich, wenn Sie mehrere Posteingänge verwalten, zum Beispiel:
* Persönliche Arbeits-E-Mail + gemeinsamer Team-Posteingang
* Mehrere E-Mail-Adressen für die Kundenkommunikation
* Verschiedene E-Mail-Konten für unterschiedliche Rollen
## So fügen Sie mehrere Postfächer hinzu
1. Gehen Sie zu **Einstellungen → Konten**
2. Klicken Sie auf **Konto hinzufügen**
3. Verbinden Sie ein zusätzliches Google- oder Microsoft-Konto oder einen anderen Mailanbieter, der IMAP/SMTP-Protokolle unterstützt
4. Synchronisierungseinstellungen für dieses Postfach konfigurieren
5. Wiederholen Sie dies für jedes Postfach, das Sie verbinden möchten
## Mehrere Konten verwalten
Jedes verbundene Postfach hat eigene Einstellungen:
* **E-Mail-Sichtbarkeit**: Wählen Sie aus, was Teammitglieder sehen können
* **Automatische Kontakterstellung**: Pro Postfach aktivieren/deaktivieren
* **Ordnerauswahl**: Wählen Sie, welche Ordner synchronisiert werden
## So werden E-Mails angezeigt
E-Mails aus all Ihren verbundenen Postfächern werden mit Twenty synchronisiert und erscheinen unter:
* **Personendatensätze**: Basierend auf der E-Mail-Adresse des Kontakts
* **Unternehmensdatensätze**: Basierend auf der E-Mail-Domain
* **Opportunities**: Basierend auf dem verknüpften Unternehmen
<Note>Jede E-Mail zeigt an, in welchem Postfach sie gesendet oder empfangen wurde, so dass Sie verfolgen können, welches Konto für jede Kommunikation verwendet wurde.</Note>
## Wichtige Hinweise
<Warning>Nur echte Postfächer können verbunden werden. E-Mail-Aliase, die an ein anderes Postfach weiterleiten, können nicht separat verbunden werden — sie werden über das Hauptpostfach synchronisiert.</Warning>

View File

@@ -0,0 +1,53 @@
---
title: Ich sehe keine E-Mails in Datensätzen
description: Fehlerbehebung bei fehlenden E-Mails in Datensätzen.
---
## Häufige Ursachen
### 1. Erstsynchronisierung läuft noch
Die E-Mail-Synchronisierung braucht Zeit, insbesondere bei großen Postfächern. Twenty importiert E-Mails mit etwa **400 Nachrichten pro Minute** (begrenzt durch die Ratenbegrenzung der Gmail API).
* **Kalendersynchronisierung**: in wenigen Minuten abgeschlossen
* **E-Mail-Synchronisierung**: Abhängig von der Postfachgröße (z. B. 10.000 E-Mails ≈ 25 Minuten, 50.000 E-Mails ≈ 2 Stunden)
**Lösung**: Warten Sie, bis der Erstimport abgeschlossen ist. Die Dauer lässt sich anhand der Größe Ihres Postfachs abschätzen.
### 2. Kontakt existiert in Twenty nicht
E-Mails erscheinen nur bei vorhandenen Personen-Datensätzen. Wenn der Kontakt noch nicht erstellt wurde:
* Aktivieren Sie die **automatische Kontakterstellung** in Ihren Postfach-Einstellungen
* Oder erstellen Sie zunächst den Personen-Datensatz manuell
**Lösung**: Gehen Sie zu **Einstellungen → Accounts**, wählen Sie Ihr Postfach aus und aktivieren Sie die automatische Kontakterstellung.
### 3. Interne E-Mails sind ausgeschlossen
E-Mails zwischen Kolleginnen und Kollegen (gleiche E-Mail-Domain) werden nie synchronisiert, um die Privatsphäre zu wahren.
**Lösung**: Dieses Verhalten ist beabsichtigt. Es werden nur externe E-Mails synchronisiert.
### 4. E-Mail stammt aus einer Gruppe oder Verteilerliste
Gruppen-E-Mails und Verteilerlisten sind von der Synchronisierung ausgeschlossen.
**Lösung**: Dieses Verhalten ist beabsichtigt.
### 5. Ordner nicht für die Synchronisierung ausgewählt
Wenn Sie die Funktion Message Folder verwenden, können einige Ordner ausgeschlossen sein.
**Lösung**: Gehen Sie zu **Einstellungen → Accounts**, wählen Sie Ihr Postfach aus und überprüfen Sie die Einstellungen zur Ordnersynchronisierung.
### 6. Falsche E-Mail-Adresse im Datensatz
Der Personen-Datensatz könnte eine andere E-Mail-Adresse enthalten als die, die in der E-Mail verwendet wurde.
**Lösung**: Fügen Sie die korrekte E-Mail-Adresse zum Personen-Datensatz hinzu.
## Funktioniert es immer noch nicht?
1. Versuchen Sie, Ihr Postfach zu trennen und erneut zu verbinden
2. Kontaktieren Sie den Support, wenn das Problem weiterhin besteht

View File

@@ -0,0 +1,58 @@
---
title: Importierte E-Mails begrenzen
description: Steuern Sie, welche E-Mails in Twenty importiert werden.
---
## Übersicht
Standardmäßig synchronisiert Twenty alle externen E-Mails aus Ihrem verbundenen Postfach. Sie können den Import mithilfe der **Ordnerauswahl** und der **Sichtbarkeitseinstellungen** begrenzen.
## Methode 1: Ordnerauswahl (Empfohlen)
Bestimmen Sie, welche E-Mail-Ordner mit Twenty synchronisiert werden:
1. Gehen Sie zu **Einstellungen → Konten**
2. Wählen Sie Ihr verbundenes E-Mail-Konto aus
3. Wählen Sie, welche Ordner synchronisiert werden sollen:
| Ordner | Beschreibung |
| ----------------------------- | ------------------------------------------ |
| **Posteingang** | Primäre eingehende E-Mails |
| **Gesendet** | Ausgehende E-Mails, die Sie gesendet haben |
| **Archiv** | Archivierte Nachrichten |
| **Benutzerdefinierte Ordner** | Beliebige spezifische Ordner Ihrer Wahl |
4. Schließen Sie Ordner aus, die Sie nicht synchronisieren möchten (Spam, Papierkorb, persönliche Ordner)
<Note>Damit haben Sie genaue Kontrolle darüber, welche E-Mails in Ihrem CRM erscheinen, ohne alles zu synchronisieren.</Note>
## Methode 2: Einstellungen zur automatischen Kontakterstellung
Steuern Sie, wann aus E-Mails Kontakte erstellt werden:
1. Gehen Sie zu **Einstellungen → Konten**
2. Wählen Sie Ihr verbundenes Postfach aus
3. Wählen Sie eine Option:
* **Deaktiviert**: Es werden keine Kontakte erstellt, E-Mails werden jedoch weiterhin mit bestehenden Kontakten synchronisiert
* **Gesendet & Empfangen**: Erstellt Kontakte aus allen externen E-Mails
* **Nur Gesendet**: Erstellt Kontakte nur aus E-Mails, die Sie senden
## Interne E-Mails
Nachrichten zwischen Kolleginnen und Kollegen (gleiche Domain) können in Twenty synchronisiert werden:
1. Gehen Sie zu **Einstellungen → Allgemein → Sicherheit**
2. Schalten Sie **Interne E-Mails synchronisieren** ein/aus
<Note>Standardmäßig ist diese Option deaktiviert.</Note>
## Was stets ausgeschlossen ist
Diese E-Mails werden unabhängig von den Einstellungen nie synchronisiert:
* **Gruppen-E-Mails**: Verteilerlisten und Gruppennachrichten
* **Spam/Papierkorb**: Systemordner sind in der Regel ausgeschlossen
## Wichtiger Hinweis
<Note>Wir stellen noch keine CC-E-Mail-Adresse für selektives Synchronisieren bereit. Verwenden Sie die oben genannte Ordnerauswahl, um das gleiche Maß an Kontrolle zu erreichen.</Note>

View File

@@ -0,0 +1,144 @@
---
title: Kalender & E-Mails
description: Verbinden Sie Ihre E-Mail- und Kalenderkonten mit Twenty.
---
## Verbindungsoptionen
### Google-Konto (Gmail & Google Kalender)
1. Gehen Sie zu **Einstellungen → Konten**
2. Klicken Sie auf **Konto hinzufügen**
3. Wählen Sie **Mit Google fortfahren**
4. Autorisieren Sie Twenty, auf Ihr Gmail-Konto und Ihren Google-Kalender zuzugreifen
5. Konfigurieren Sie die E-Mail-Synchronisierungseinstellungen (Sichtbarkeit, automatische Erstellung) → Klicken Sie auf **Weiter**
6. Konfigurieren Sie die Kalendersynchronisierungseinstellungen (Sichtbarkeit, automatische Erstellung) → Klicken Sie auf **Konto hinzufügen**
7. Ihre E-Mails und Kalendereinträge werden automatisch synchronisiert
### Microsoft Konto (Outlook & Microsoft Kalender)
1. Gehen Sie zu **Einstellungen → Konten**
2. Klicken Sie auf **Konto hinzufügen**
3. Wählen Sie **Mit Microsoft fortfahren**
4. Autorisieren Sie Twenty, auf Ihr Outlook-Konto und Ihren Microsoft-Kalender zuzugreifen
5. Konfigurieren Sie die E-Mail-Synchronisierungseinstellungen (Sichtbarkeit, automatische Erstellung) → Klicken Sie auf **Weiter**
6. Konfigurieren Sie die Kalendersynchronisierungseinstellungen (Sichtbarkeit, automatische Erstellung) → Klicken Sie auf **Konto hinzufügen**
7. Ihre E-Mails und Kalendereinträge werden automatisch synchronisiert
### IMAP/SMTP/CalDAV-Einrichtung (andere Anbieter)
Für andere E-Mail- und Kalenderanbieter:
1. Gehen Sie zu **Einstellungen → Konten**
2. Konfigurieren Sie die IMAP-Einstellungen, um eingehende E-Mails zu synchronisieren, und die SMTP-Einstellungen, um E-Mails zu senden.
3. CalDAV-Einstellungen für Kalender konfigurieren
4. Die Verbindung testen
<Note>
**Self-Hosting in einem air-gapped oder internen Netzwerk**: Standardmäßig verweigert Twenty ausgehende Verbindungen zu privaten/internen IP-Adressen (SSRF-Schutz). Wenn Ihr E-Mail- oder Kalender-Server auf einer lokalen/privaten IP ausgeführt wird (z. B. ein On-Premises-Server in einem LAN), werden Verbindungen zu diesem blockiert. Um diese zuzulassen, setzen Sie die folgende Umgebungsvariable auf dem Server:
```
OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
```
Dadurch wird der Safe Mode für **alle** ausgehenden Anfragen (HTTP-Workflow-Aktionen, Webhooks sowie IMAP/SMTP/CalDAV-Verbindungen) deaktiviert. Aktivieren Sie diese Einstellung daher nur in vertrauenswürdigen, isolierten Netzwerken, in denen der SSRF-Schutz nicht benötigt wird.
</Note>
### Mehrere Postfächer
* **Unbegrenzte Konten**: Verbinden Sie mehrere E-Mail-Konten pro Benutzer
* **Kontenverwaltung**: Zwischen verschiedenen Postfächern wechseln
* **Sync-Einstellungen**: Verschiedene Einstellungen pro Postfach konfigurieren
<Warning>
Es können nur echte Postfächer verbunden werden (z.B. support@domain.com mit eigenem Posteingang). E-Mail-Aliase, die zu einem anderen Postfach weiterleiten, können nicht mit Twenty verbunden werden.
</Warning>
## E-Mail-Konfiguration
### Nachrichtensichtbarkeit
Wählen Sie verschiedene Sichtbarkeitsstufen für Ihre E-Mails:
* **Nur Metadaten**: Teilen Sie nur grundlegende Informationen (Absender, Empfänger, Datum, Uhrzeit)
* **Betreff und Metadaten**: Teilen Sie die Betreffzeile zusammen mit den Metadaten
* **Gesamter E-Mail-Inhalt**: Teilen Sie den gesamten E-Mail-Inhalt einschließlich Anhängen
### Automatische Kontakt-Erstellung
* **Deaktiviert**: Keine automatische Kontakt-Erstellung
* **Für gesendete und empfangene Nachrichten**: Erstellen Sie Kontakte für alle externen E-Mail-Interaktionen
* **Nur für gesendete Nachrichten**: Kontakte nur für gesendete E-Mails erstellen
* **Hinweis**: Standardmäßig werden interne E-Mails (bei denen alle Beteiligten Ihre Domain teilen) nicht synchronisiert, um die Privatsphäre zu schützen
<Note>Wenn aktiviert, werden Kontakte basierend auf ihrer E-Mail-Domain automatisch mit ihren Unternehmensdatensätzen verknüpft. Falls das Unternehmen noch nicht existiert, erstellt Twenty es für Sie.</Note>
<Note>
**Synchronisierung interner E-Mails**: Das Verhalten „interne E-Mails werden nicht synchronisiert“ ist der Standard, kann aber deaktiviert werden. Der Schalter befindet sich in den erweiterten Einstellungen:
1. Öffnen Sie die **Einstellungen** und aktivieren Sie den Schalter **Erweitert** unten auf der Einstellungsseite
2. Gehen Sie zu **Allgemein → Sicherheit**
3. Aktivieren Sie den Schalter **Interne E-Mails synchronisieren**, um E-Mails einzuschließen, bei denen alle Beteiligten dieselbe Domain verwenden
Dies ist eine arbeitsbereichsweite Einstellung (nützlich für Universitäten oder Organisationen mit gemeinsamer Domain).
</Note>
### Steuern Sie mit der Ordnerauswahl, welche E-Mails synchronisiert werden.
Bestimmen Sie, welche E-Mail-Ordner mit Twenty synchronisiert werden:
1. Gehen Sie zu **Einstellungen → Konten** und wählen Sie Ihr verbundenes E-Mail-Konto aus.
2. Wählen Sie, welche Ordner synchronisiert werden sollen:
* **Posteingang**: Primäre eingehende E-Mails
* **Gesendet**: Ausgehende E-Mails, die Sie gesendet haben
* **Benutzerdefinierte Ordner**: Jegliche spezifischen Ordner, die Sie einbeziehen möchten
* **Ordner ausschließen**: Ordner wie Spam, Papierkorb oder persönliche Ordner überspringen
Damit haben Sie genaue Kontrolle darüber, welche E-Mails in Ihrem CRM erscheinen, ohne alles zu synchronisieren.
**Was synchronisiert wird:**
* **Externe E-Mails**: Alle E-Mails mit externen Kontakten aus gewählten Ordnern
* **Interne E-Mails**: Standardmäßig nicht synchronisiert (E-Mails mit derselben Domain bleiben privat). Aktivieren Sie unten in den **Einstellungen** den Schalter **Erweitert** und schalten Sie dann unter **Allgemein → Sicherheit** **Interne E-Mails synchronisieren** ein, um sie arbeitsbereichsweit einzubeziehen.
* **Anhänge**: Kommt im H1 2026
**Hinweis**: Wir bieten keine CC-E-Mail-Adresse für selektives Synchronisieren an. Verwenden Sie stattdessen die oben genannte Nachrichtenordner-Funktion, um dieselbe Kontrolle darüber zu erhalten, welche E-Mails mit Twenty synchronisiert werden.
## Kalenderkonfiguration
### Ereignissichtbarkeit
Wählen Sie aus, was für andere Benutzer in Ihrem Arbeitsbereich sichtbar wird:
* **Alles**: Die gesamte Eventdetails werden mit deinem Team geteilt
* **Metadaten**: Nur Datum und Teilnehmer werden mit deinem Team geteilt
### Automatische Kontakt-Erstellung für Meetings
* **Ja**: Kontakte für Besprechungsteilnehmer, die nicht in Ihrem CRM sind, automatisch erstellen
* **Nein**: Treffen Sie Verbindungen nur zu vorhandenen Kontakten
<Note>Wenn aktiviert, werden Kontakte basierend auf ihrer E-Mail-Domain automatisch mit ihren Unternehmensdatensätzen verknüpft. Falls das Unternehmen noch nicht existiert, erstellt Twenty es für Sie.</Note>
### Bestimme welche Ereignisse synchronisiert werden
* **Meeting-Import**: Kalenderereignisse automatisch importieren
* **Kontaktverlinkung**: Treffen mit Personen- und Unternehmensdaten verknüpfen
**Was synchronisiert wird:**
* **Meetings**: Kalenderereignisse mit externen Teilnehmern
* **Kontaktverlinkung**: Ereignisse automatisch mit CRM-Aufzeichnungen verknüpft
* **Team-Veranstaltungen**: Gemeinsame Kalenderansicht
## Synchronisationsfrequenz
**Aktualisierungen alle 5 Minuten**: Sowohl E-Mail- als auch Kalenderdaten werden automatisch alle 5 Minuten nach dem ersten Import synchronisiert.
<Note>
**Dauer der Erstsynchronisierung**: Die Kalendersynchronisierung wird schnell abgeschlossen (in der Regel innerhalb von Minuten), während die E-Mail-Synchronisierung bei großen Postfächern länger dauert. Twenty importiert E-Mails mit etwa **400 Nachrichten pro Minute** (begrenzt durch die Ratenbegrenzung der Gmail API), daher dauert es bei einem Postfach mit 10.000 E-Mails etwa 25 Minuten. Keine Sorge, wenn Kontakte aus Kalenderereignissen vor Ihren E-Mail-Kontakten erscheinen; das ist normales Verhalten.
</Note>
## Nächste Schritte
* [Postfachfunktionen](/l/de/user-guide/calendar-emails/capabilities/mailbox)
* [Fehlende E-Mails beheben](/l/de/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)

View File

@@ -0,0 +1,275 @@
---
title: Diagramm-Einstellungen
description: Konfigurieren Sie Ihre Diagramme so, dass Daten genau so angezeigt werden, wie Sie sie benötigen.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## Diagramm-Einstellungen aufrufen
1. Klicken Sie auf die Schaltfläche **Bearbeiten** in der oberen rechten Ecke Ihres Dashboards
<img src="/images/user-guide/dashboard/dashboard-edit.png" alt="Bearbeitungsmodus" />
2. Das Dashboard wechselt in den Bearbeitungsmodus
3. Klicken Sie auf ein beliebiges Widget, um es auszuwählen
4. Der Einstellungsbereich öffnet sich rechts
Die Einstellungen sind in Abschnitte gegliedert:
* **Daten**: Welche Daten abgerufen werden und wie sie gefiltert werden
* **X-Achse**: Wie Kategorien gruppiert und sortiert werden (Balken-/Liniendiagramme)
* **Y-Achse**: Was gemessen wird und wie es angezeigt wird (Balken-/Liniendiagramme)
* **Stil**: Farben, Beschriftungen und visuelle Optionen
<Note>
Einige Einstellungen erscheinen nur, wenn andere Einstellungen konfiguriert sind. Beispielsweise wird **Datumsgranularität** nur angezeigt, wenn Sie ein Datumsfeld auswählen.
</Note>
---
## Daten-Einstellungen
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="database" />Quelle </span>
Wählen Sie, aus welchem Objekt Daten abgerufen werden sollen.
1. Klicken Sie auf **Quelle**
2. Wählen Sie ein Objekt (Chancen, Personen, Unternehmen usw.)
Alle Ihre Standard- und benutzerdefinierten Objekte sind verfügbar. Das Ändern der Quelle setzt andere Einstellungen zurück, da Feldoptionen vom ausgewählten Objekt abhängen.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-source.png" alt="Quelle" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filter" />Filter </span>
Begrenzen Sie, welche Datensätze in das Diagramm einbezogen werden.
1. Klicken Sie auf **Filter**
2. Der Filter-Editor wird geöffnet
3. Klicken Sie auf **+ Filter hinzufügen**
4. Wählen Sie ein Feld, eine Bedingung und einen Wert
5. Fügen Sie bei Bedarf weitere Filter hinzu
Filter funktionieren genauso wie in Tabellenansichten. Verwenden Sie sie, um sich auf bestimmte Segmente Ihrer Daten zu konzentrieren.
**Beispiel**: Filtern Sie Chancen, bei denen Phase "Gewonnen" ist, um nur abgeschlossene Deals anzuzeigen.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="Filter" />
<Tip>
Für Datumsfelder verwenden Sie **Ist relativ**, um dynamische Filter wie "Letzte 7 Tage" oder "Dieser Monat" zu erstellen, die automatisch aktualisiert werden.
</Tip>
<Tip>
Erweiterte Filter werden unterstützt — fügen Sie mehrere Filterregeln hinzu und kombinieren Sie sie mit **Und**- oder **Oder**-Logik.
</Tip>
---
## Einstellungen der X-Achse
Diese Einstellungen steuern die horizontale Achse von Balken- und Liniendiagrammen — typischerweise, wie Ihre Daten in Kategorien gruppiert werden.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-x" />Angezeigte Daten </span>
Wählen Sie das Feld aus, nach dem Ihre Daten gruppiert werden sollen. Dies bestimmt die auf der X-Achse angezeigten Kategorien.
**Beispiel**: Wählen Sie "Phase", um Daten nach Pipeline-Phase zu gruppieren, oder "Erstellungsdatum", um Daten über die Zeit zu sehen.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-data-on-display.png" alt="Angezeigte Daten" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Datumsgranularität </span>
Beim Gruppieren nach einem Datumsfeld wählen Sie den Zeitraum für die Gruppierung.
| Option | Gruppiert Daten nach | Beispielausgabe |
| ---------------------- | ---------------------- | --------------------------------------------------- |
| **Tag** | Jeder Kalendertag | 1. Jan., 2. Jan., 3. Jan. ... |
| **Woche** | Kalenderwochen | Woche 1, Woche 2, Woche 3 ... |
| **Monat** | Kalendermonate | Januar, Februar, März ... |
| **Quartal** | Geschäftsquartale | Q1, Q2, Q3, Q4 |
| **Jahr** | Kalenderjahre | 2023, 2024, 2025 |
| **Wochentag** | Wochentag (aggregiert) | Montag, Dienstag ... (alle Montage zusammengefasst) |
| **Monat des Jahres** | Monat (aggregiert) | Januar, Februar ... (alle Januare zusammengefasst) |
| **Quartal des Jahres** | Quartal (aggregiert) | Q1, Q2, Q3, Q4 (alle Q1 zusammengefasst) |
Die "der Woche/des Jahres"-Optionen aggregieren über die gesamte Zeit. Verwenden Sie **Wochentag**, um zu sehen, welcher Wochentag typischerweise die meisten Deals bringt. Verwenden Sie **Monat**, um Trends Monat für Monat zu sehen.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Sortieren nach </span>
Steuern Sie die Reihenfolge der Kategorien auf der X-Achse.
* **Position** – Verwendet die in den Einstellungen Ihres Auswahlfelds definierte Reihenfolge
* **Alphabetisch** – A bis Z (oder chronologisch bei Daten)
* **Nach Wert** – Nach der Kennzahl sortiert (höchste oder niedrigste zuerst)
* **Manuell** – Ziehen Sie, um Ihre eigene Reihenfolge festzulegen
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-sort.png" alt="Sortieren nach" />
**Tipp**: Für Pipeline-Phasen verwenden Sie **Position**, um Phasen in der Reihenfolge Ihres Verkaufsprozesses anzuzeigen (Lead → Qualifiziert → Angebot → Gewonnen).
<Note>
Die angezeigten Optionen hängen von Ihrem Feldtyp ab. Auswahlfelder haben alle Optionen; Datums- und Textfelder zeigen weniger.
</Note>
<Tip>
Mit der Sortieroption **Manuell** können Sie Kategorien ziehen, um eine benutzerdefinierte Reihenfolge zu erstellen — ideal, um bestimmte Segmente hervorzuheben oder mit Ihren Daten eine Geschichte zu erzählen.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />Nullwerte auslassen </span>
Kategorien mit Nullwerten oder ohne Daten ausblenden.
* **Ein**: Kategorien ohne Einträge werden ausgeblendet
* **Aus**: Alle Kategorien werden angezeigt, auch wenn sie leer sind
Verwenden Sie dies, um Diagramme mit spärlichen Daten aufzuräumen.
---
## Einstellungen der Y-Achse
Diese Einstellungen steuern, was Sie messen und wie es angezeigt wird.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-y" />Angezeigte Daten </span>
Wählen Sie das Feld und die Operation zur Berechnung Ihrer Kennzahl.
* **Zählungen** – Alle zählen, Leere zählen, Nicht-Leere zählen, Eindeutige Werte zählen
* **Mathematik** – Summe, Durchschnitt, Min, Max (Zahlenfelder)
* **Prozentsätze** – Prozent leer, Prozent nicht leer
Boolesche Felder fügen „Wahr/Falsch zählen“ hinzu. Aggregierte Diagramme mit Datumsfeldern zeigen Frühestes/Spätestes.
**Beispiel**: Wählen Sie „Betrag“ mit Summe, um den gesamten Deal-Wert pro Kategorie zu sehen, oder Alle zählen, um die Anzahl der Deals zu sehen.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="Angezeigte Daten" />
<Note>
Die angezeigten Optionen hängen von Ihrem Feld- und Diagrammtyp ab. Wenn eine erwartete Operation nicht angezeigt wird, überprüfen Sie Ihren Feldtyp.
</Note>
### Verhältnis
Für Auswahl-, Mehrfachauswahl- oder Boolesche Felder können Sie den Prozentsatz eines bestimmten Werts berechnen.
1. Wählen Sie ein Auswahl-, Mehrfachauswahl- oder Boolesches Feld aus
2. Aktivieren Sie **Verhältnis**
3. Wählen Sie die zu messende Option
**Beispiel**: Zeigen Sie "Gewonnene" Deals als Prozentsatz aller Chancen. Wenn Sie 10 „Gewonnen“-Deals von insgesamt 50 haben, zeigt das Diagramm 20 %.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filters" />Gruppieren nach </span>
Fügen Sie eine zweite Dimension hinzu, um mehrere Reihen zu erstellen (mehrere Balken oder Linien).
1. Legen Sie zuerst Ihr X-Achsen-Feld fest
2. Klicken Sie auf **Gruppieren nach**
3. Wählen Sie ein zweites Feld aus
**Beispiel**: Gruppieren Sie Deals nach Phase (X-Achse) UND nach Inhaber (Gruppieren nach), um die Pipeline-Aufschlüsselung jeder Person nebeneinander zu sehen.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-group-by.png" alt="Gruppieren nach" />
Wenn Gruppieren nach eingestellt ist, sehen Sie mehrere Farben in Ihrem Diagramm und eine Legende erscheint.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />Datumsgranularität </span>
Wenn Gruppieren nach ein Datumsfeld ist, wählen Sie den Zeitraum (gleiche Optionen wie bei der X-Achse).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />Sortieren nach </span>
Wenn Gruppieren nach eingestellt ist, steuern Sie die Reihenfolge der gruppierten Reihen (z. B. welcher Balken des Inhabers innerhalb jeder Kategorie zuerst erscheint).
Gleiche Optionen wie bei der Sortierung der X-Achse — Position, Alphabetisch und Manuell — außer dass wertbasierte Sortierung für die sekundäre Gruppierung nicht verfügbar ist.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="chart-bar-popular" />Kumulativ </span>
Laufende Summen statt einzelner Werte anzeigen.
* **Aus**: Jeder Balken/Punkt zeigt seinen eigenen Wert
* **Ein**: Jeder Balken/Punkt zeigt die Summe aller vorherigen Werte plus seinen eigenen
**Beispiel**: Januar = 10, Februar = 15
* Kumulativ aus: Zeigt 10 und 15
* Kumulativ ein: Zeigt 10 und 25 (10 + 15)
Verwenden Sie „Kumulativ“, um den Fortschritt zu einem Ziel im Zeitverlauf zu verfolgen.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-cumulative.png" alt="Kumulativ" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="math-min" />Min-Bereich / <ChartIcon icon="math-max" />Max-Bereich </span>
Legen Sie feste Mindest- und Höchstwerte für die Y-Achse fest.
* Leer lassen für automatische Skalierung
* Geben Sie eine Zahl ein, um die Grenze festzulegen
**Wann verwenden:**
* Setzen Sie Min auf 0 für genaue visuelle Vergleiche
* Setzen Sie beides für konsistente Skalen über mehrere Diagramme hinweg
* Fokussieren Sie einen bestimmten Wertebereich, indem Sie beide festlegen
---
## Stil-Einstellungen
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="color-swatch" />Farben </span>
Legen Sie das Farbschema für Ihr Diagramm fest. Wählen Sie aus einer Vielzahl von Farbpaletten.
<Note>
Beim Gruppieren nach einem Auswahlfeld verwendet das Diagramm automatisch die in Ihren Feldeinstellungen für jede Option definierten Farben.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />Achsenname </span>
Wählen Sie, welche Achsenbeschriftungen angezeigt werden sollen: **Keine**, **X-Achse**, **Y-Achse** oder **Beide** (nur Balken- und Liniendiagramme).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="stack-2" />Gestapelte Balken / Gestapelte Linien </span>
Wenn Gruppieren nach eingestellt ist, wählen Sie, wie mehrere Reihen angezeigt werden.
* **Aus (Gruppiert)**: Reihen erscheinen nebeneinander. Verwenden Sie dies, wenn exakte Werte zwischen Gruppen verglichen werden.
* **Ein (Gestapelt)**: Reihen werden übereinander gestapelt. Verwenden Sie dies, wenn Sie die Zusammensetzung zeigen — wie Teile ein Ganzes bilden.
**Beispiel**: Deals nach Phase, gruppiert nach Inhaber
* Gruppiert: Sehen Sie die exakten Zahlen jedes Inhabers nebeneinander
* Gestapelt: Sehen Sie die Gesamtzahl der Deals pro Phase, mit dem gestapelten Beitrag jedes Inhabers
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="badge-2k" />Datenbeschriftungen </span>
Werte direkt auf Diagrammelementen (Balken, Punkte, Segmente) anzeigen.
* **Ein**: Werte erscheinen im Diagramm
* **Aus**: Keine Werte angezeigt (aufgeräumtere Darstellung)
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="text-caption" />Legende </span>
Legende anzeigen oder ausblenden (erscheint nur, wenn Gruppieren nach eingestellt ist).
* **Ein**: Die Legende zeigt, was jede Farbe darstellt
* **Aus**: Keine Legende angezeigt
<Tip>
**Bewegen Sie den Mauszeiger** über ein Legendenelement, um diese Gruppe hervorzuheben. **Klicken** Sie, um es vorübergehend aus dem Diagramm auszublenden.
</Tip>
---
## Diagrammspezifische Hinweise
### Tortendiagramme
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="chart-pie" size={16} /></span> **Jedes Segment steht für** – Legen Sie fest, wie Segmente gruppiert werden
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="eye-off" size={16} /></span> **Leere Kategorie ausblenden** – Nullwert-Segmente entfernen
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="number-123" size={16} /></span> **Wert in der Mitte anzeigen** – Den aggregierten Wert anzeigen (Summe, Durchschnitt, Anzahl usw.)
### Aggregierte Diagramme
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-left" size={16} /></span> **Präfix** – Text vor der Zahl hinzufügen (z. B. `$`)
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-right" size={16} /></span> **Suffix** – Text nach der Zahl hinzufügen (z. B. `%`)

View File

@@ -0,0 +1,92 @@
---
title: Dashboards
description: Erstellen und organisieren Sie Dashboards mit Registerkarten, um Ihre CRM-Daten zu visualisieren.
---
## Übersicht
Dashboards in Twenty sind hierarchisch organisiert: **Dashboards → Registerkarten → Widgets**. Jedes Dashboard kann mehrere Registerkarten enthalten, und jede Registerkarte enthält Widgets (Diagramme, Zahlen, iFrames).
## Ein Dashboard erstellen
1. Gehen Sie in der Navigation zu **Dashboards**
2. Klicken Sie auf **+ Neuer Datensatz**
<img src="/images/user-guide/dashboard/dashboard-create-new.png" alt="Neues Dashboard erstellen" />
3. Geben Sie Ihrem Dashboard einen Namen
4. Fügen Sie Registerkarten und Widgets hinzu
## Mit Registerkarten arbeiten
Registerkarten helfen Ihnen, Ihr Dashboard in logische Abschnitte zu gliedern.
### Registerkarten erstellen
1. Klicken Sie im Bearbeitungsmodus auf **+** in der Tableiste, und ein Seitenfenster wird rechts geöffnet
2. Benennen Sie Ihre Registerkarte (z. B. "Pipeline-Übersicht", "Teamleistung")
3. Fügen Sie der Registerkarte Widgets hinzu
### Registerkarten neu anordnen
1. Im Bearbeitungsmodus klicken Sie auf die Registerkarte, die Sie verschieben möchten, und halten Sie die Maustaste gedrückt
2. Per Drag-and-Drop an die neue Position verschieben
3. Sie können auch auf den Tab klicken und das Kommandomenü benutzen, um den Tab nach links oder rechts zu verschieben
### Registerkarten löschen
1. Im Bearbeitungsmodus klicken Sie auf die Registerkarte, die Sie löschen möchten
2. Klicken Sie im Befehlsmenü auf die Schaltfläche **Löschen**
### Registerkarten duplizieren
1. Klicken Sie auf die Registerkarte, die Sie duplizieren möchten
2. Klicken Sie in der Seitenleiste auf die Schaltfläche **Duplizieren**
<img src="/images/user-guide/dashboard/dashboard-tabs.png" alt="Dashboard-Registerkarte" />
## Dashboard-Layout
### Widgets anordnen
* Per Drag-and-Drop positionieren
* Zur Hervorhebung die Größe anpassen
* Verwandte Diagramme gruppieren
### Ein Dashboard duplizieren
1. Wählen Sie das Dashboard aus, das Sie duplizieren möchten
2. Öffnen Sie die Befehlsleiste mit **Cmd + K** (oder **Ctrl + K** unter Windows)
3. Wählen Sie **Dashboard duplizieren**
<img src="/images/user-guide/dashboard/dashboard-duplicate.png" alt="Dashboard duplizieren" />
### Beste Praktiken
* **Logischer Ablauf**: Von der Übersicht zum Detail anordnen
* **Visuelle Hierarchie**: Größere Diagramme für Schlüsselkennzahlen
* **Einheitliches Design**: Verwenden Sie passende Farben und Schriftarten
## Sichtbarkeit & Zugriff
### Sichtbarkeit des Dashboards
Dashboards sind für alle sichtbar, die Zugriff auf Ihren Twenty-Arbeitsbereich haben. Derzeit gibt es keine Option für private Dashboards.
### Favoriten
Sie können Dashboards für einen schnellen Zugriff zu Ihren Favoriten hinzufügen. Dies ist eine persönliche Einstellung—Ihre Favoriten sind für andere Benutzer nicht sichtbar.
Um ein Dashboard zu den Favoriten hinzuzufügen, öffnen Sie das Dashboard und klicken Sie auf das Sternsymbol.
### Zeitzonenverhalten
Dashboards zeigen derzeit Daten basierend auf der Zeitzone des Benutzers, der sie ansieht. Das bedeutet, dass dasselbe Dashboard für Teammitglieder in verschiedenen Regionen unterschiedliche Kennzahlen anzeigen kann (z. B. APAC vs. US).
<Note>
**Demnächst verfügbar**: Wir werden die Möglichkeit hinzufügen, für ein Dashboard eine bestimmte Zeitzone festzulegen, sodass alle Benutzer unabhängig von ihrem Standort konsistente Daten sehen.
</Note>
<Note>
**Demnächst verfügbar**: Filter auf Dashboard-Ebene ermöglichen es Ihnen, Filter auf alle Widgets gleichzeitig anzuwenden, sodass Sie Ihre Daten schneller erkunden können.
</Note>

View File

@@ -0,0 +1,169 @@
---
title: Widgets
description: Erkunden Sie die Widget-Typen und Visualisierungsoptionen in Twenty.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## Verfügbare Widgets
Twenty bietet verschiedene Widget-Typen, um Ihre CRM-Daten zu visualisieren.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-bar-popular" />Balkendiagramme</span>
Stellen Sie Daten als horizontale oder vertikale Balken dar.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="Balkendiagramm" />
</Frame>
**Am besten geeignet für:**
* Vergleich von Werten über Kategorien hinweg
* Ranglisten anzeigen
* Kennzahlen nach Zeitraum verfolgen
**Beispielverwendung:**
* Deals nach Phase
* Umsatz nach Vertriebsmitarbeitern
* Hinzugefügte Kontakte pro Monat
<Note>
**Anzeigegrenzen**: Balkendiagramme können maximal 100 Balken anzeigen sowie bei Verwendung von Group By 50 Gruppen pro Balken. Wenn Sie die Warnung "Nicht angezeigte Daten: max. X Balken pro Diagramm" sehen, fügen Sie Filter hinzu, um Ihre Daten einzugrenzen, oder ändern Sie die Gruppierung (z. B. nach Woche statt nach Tagen).
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />Tortendiagramme</span>
Zeigen Sie Anteile eines Ganzen.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="Tortendiagramm" />
</Frame>
**Am besten geeignet für:**
* Zusammensetzung oder Verteilung anzeigen
* Teile mit dem Ganzen vergleichen
* Wichtige Segmente hervorheben
**Beispielverwendung:**
* Deal-Verteilung nach Quelle
* Kontaktaufschlüsselung nach Branche
* Pipeline-Zusammensetzung nach Eigentümer
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-line" />Liniendiagramme</span>
Stellen Sie Trends im Zeitverlauf dar.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="Liniendiagramm" />
</Frame>
**Am besten geeignet für:**
* Veränderungen im Zeitverlauf verfolgen
* Trends erkennen
* Mehrere Kennzahlen vergleichen
**Beispielverwendung:**
* Monatlicher Trend der Anzahl der Deals
* Umsatzwachstum über Quartale
* Aktivitätsniveau im Zeitverlauf
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="sum" />Aggregierte Diagramme</span>
Zeigen Sie einzelne Kennzahlen prominent an.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="Aggregiertes Diagramm" />
</Frame>
**Am besten geeignet für:**
* KPIs hervorheben
* Summen oder Durchschnitte anzeigen
* Schnelle Statusprüfungen
**Beispielverwendung:**
* Gesamtwert der Pipeline
* Anzahl offener Chancen
* Konversionsrate
**Erweiterte Optionen:**
* **Verhältnis**: Berechnen Sie für Select-Felder Verhältnisse zwischen Werten. Gehen Sie zu **Angezeigte Daten** → wählen Sie Ihr Feld → aktivieren Sie die Option **Verhältnis**.
* **Präfix & Suffix**: Fügen Sie benutzerdefinierten Text vor oder nach der Zahl hinzu (z. B. "$"-Präfix oder "%"-Suffix) für eine bessere Lesbarkeit.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="frame" />iFrames</span>
Betten Sie externe Tools und Inhalte direkt in Ihr Dashboard ein.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="Tabellendiagramm" />
</Frame>
**Am besten geeignet für:**
* Suche nach einzelnen Elementen
* Überprüfung exakter Werte
* Prüfung oder Referenz
**Beispielverwendung:**
* Deals, die diesen Monat abgeschlossen werden
* Neue Leads in dieser Woche
* Überfällige Rechnungen
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="table" />Tabelle</span>
Sieh dir gefilterte Datensätze direkt in deinem Dashboard an.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
</Frame>
**Am besten geeignet für:**
* Externe Berichte oder Dashboards anzeigen
* Vertriebstools von Drittanbietern integrieren
* Live-Inhalte aus anderen Systemen anzeigen
**Anwendungsbeispiele:**
* Kennzahlen aus Ihrem Support-Tool
* Kennzahlen aus Ihrem Dialer
* Live-Inhalte aus Ihrem Tool für Sales-Sequenzen
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="align-box-left-top" />Rich-Text</span>
Fügen Sie formatierten Text und Inhalte direkt zu Ihrem Dashboard hinzu.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="Rich-Text" />
</Frame>
**Am besten geeignet für:**
* Kontext oder Anweisungen hinzufügen
* Dashboard-Beschreibungen
* Notizen und Anmerkungen
**Funktionen:**
* Rich-Text-Formatierung (fett, kursiv, Listen usw.)
* Bild- und Dateiuploads
* Bearbeitung im Markdown-Stil
<Note>
**Bald verfügbar**: Tachometerdiagramme sind noch nicht verfügbar, stehen aber auf unserer Roadmap.
</Note>
### Widgets duplizieren
1. Klicken Sie auf das Widget
2. Öffnen Sie **Optionen**
3. Klicken Sie auf **Widget duplizieren**

View File

@@ -0,0 +1,54 @@
---
title: Dashboards FAQ
description: Häufig gestellte Fragen zu Dashboards in Twenty.
---
<AccordionGroup>
<Accordion title="Kann ich private Dashboards erstellen?">
Nein, Dashboards sind derzeit für alle sichtbar, die Zugriff auf deinen Twenty-Arbeitsbereich haben. Private Dashboards sind noch nicht verfügbar.
</Accordion>
<Accordion title="Warum sehen meine Kennzahlen anders aus als die meiner Kolleginnen und Kollegen?">
Dashboards zeigen derzeit Daten basierend auf der Zeitzone der betrachtenden Person. Befinden sich Personen in unterschiedlichen Regionen (z. B. APAC vs. USA), können für dasselbe Dashboard leicht unterschiedliche Zahlen angezeigt werden. Wir arbeiten daran, eine Zeitzonen-Einstellung pro Dashboard hinzuzufügen, um teamübergreifend konsistente Daten sicherzustellen.
</Accordion>
<Accordion title="Kann ich mein Dashboard exportieren?">
Das Exportieren von Dashboards ist derzeit nicht verfügbar. Diese Funktion steht auf unserer Roadmap.
</Accordion>
<Accordion title="Kann ich Dashboards mit externen Benutzerinnen und Benutzern teilen?">
Nein, das Teilen von Dashboards mit Benutzerinnen und Benutzern außerhalb deines Twenty-Arbeitsbereichs (Nicht-Twenty-Benutzer) wird derzeit nicht unterstützt.
</Accordion>
<Accordion title="Wie füge ich ein Dashboard zu meinen Favoriten hinzu?">
Öffne das Dashboard, das du zu den Favoriten hinzufügen möchtest, und klicke dann auf das Sternsymbol. Favoriten sind persönlich – sie wirken sich nicht auf andere Benutzer aus.
</Accordion>
<Accordion title="Was ist der Unterschied zwischen Tabs und Widgets?">
* **Tabs** organisieren dein Dashboard in Abschnitte (ähnlich wie Seiten innerhalb des Dashboards)
* **Widgets** sind die einzelnen Visualisierungen (Diagramme, Zahlen, iFrames) innerhalb jedes Tabs
Struktur: Dashboard → Tabs → Widgets
</Accordion>
<Accordion title="Kann ich ein gesamtes Dashboard auf einmal filtern?">
Filter auf Dashboard-Ebene sind noch nicht verfügbar, aber diese Funktion steht auf unserer Roadmap. Derzeit musst du Filter für jedes Widget einzeln anwenden.
</Accordion>
<Accordion title="Sind Gauge-Diagramme verfügbar?">
Noch nicht. Gauge-Diagramme stehen auf unserer Roadmap und werden in einer zukünftigen Version hinzugefügt.
</Accordion>
<Accordion title="Wie dupliziere ich ein Dashboard?">
1. Stelle sicher, dass du im Ansichtsmodus bist (nicht im Bearbeitungsmodus)
2. Öffne die Befehlspalette mit **Cmd + K** (oder **Strg + K** unter Windows)
3. Wähle **Dashboard duplizieren**
</Accordion>
<Accordion title="Wie oft werden Dashboard-Daten aktualisiert?">
Widgets aktualisieren sich automatisch, wenn sich deine CRM-Daten ändern:
* Echtzeitaktualisierungen für die meisten Kennzahlen
* Verwende bei Bedarf die Schaltfläche zum Aktualisieren für eine manuelle Aktualisierung
* Historische Daten bleiben für Trendanalysen erhalten
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,67 @@
---
title: Widget-FAQ
description: Häufige Fragen und Fehlermeldungen erklärt.
---
<AccordionGroup>
<Accordion title="Wie zeige ich Prozentsätze statt Anzahlen?">
Drei Optionen:
* **Prozent leer/nicht leer**: Unter Angezeigte Daten wählen Sie Prozent leer oder Prozent nicht leer aus
* **Verhältnis**: Für Auswahl- oder Kontrollkästchenfelder aktivieren Sie Verhältnis, um eine bestimmte Option als Prozentsatz aller Datensätze anzuzeigen
* **Suffix**: Für aggregierte Diagramme fügen Sie in den Stileinstellungen `%` als Suffix hinzu
</Accordion>
<Accordion title="Was ist der Unterschied zwischen gruppierten und gestapelten Balken?">
Bei Verwendung von **Gruppieren nach** können Sie Reihen auf zwei Arten anzeigen:
* **Gruppiert**: Balken nebeneinander—am besten zum Vergleichen exakter Werte
* **Gestapelt**: Balken übereinander—am besten, um die Zusammensetzung zu zeigen
Schalten Sie **Gestapelt** in den Stileinstellungen um, um zu wechseln.
</Accordion>
<Accordion title="Warum sehe ich die Optionen Summe oder Durchschnitt nicht?">
Verfügbare Operationen hängen vom **Feldtyp** ab:
* **Zahlenfelder**: Summe, Durchschnitt, Minimum, Maximum
* **Datumsfelder**: Frühestes, Spätestes (nur bei aggregierten Diagrammen)
* **Kontrollkästchenfelder**: Anzahl wahr, Anzahl falsch
Wenn Sie eine Option nicht sehen, prüfen Sie, ob Sie einen kompatiblen Feldtyp ausgewählt haben.
</Accordion>
<Accordion title="Warum sind einige Einstellungen ausgegraut oder fehlen?">
Viele Einstellungen werden erst angezeigt, wenn Voraussetzungen erfüllt sind:
* **Datumsgranularität**: Wählen Sie zuerst ein Datumsfeld aus
* **Gruppieren nach, Legende, Gestapelt**: Legen Sie zuerst die Quelle fest
* **Schalter für Legende und Gestapelt**: Legen Sie zuerst Gruppieren nach fest
Wenn eine Einstellung fehlt, konfigurieren Sie zuerst die zugehörige Voraussetzung.
</Accordion>
<Accordion title="Was bedeutet 'Keine Daten'?">
Das Diagramm hat keine Datensätze gefunden, die Ihrer Konfiguration entsprechen.
**So beheben Sie das Problem:** Entfernen oder passen Sie Filter an, vergewissern Sie sich, dass Sie das richtige Quellobjekt ausgewählt haben, oder prüfen Sie, ob für Ihren Datumsbereich Datensätze vorhanden sind.
</Accordion>
<Accordion title="Was bedeutet 'Ungültige Konfiguration'?">
Eine erforderliche Einstellung fehlt oder ist nicht kompatibel.
**So beheben Sie das Problem:** Stellen Sie sicher, dass die Quelle festgelegt ist, Angezeigte Daten konfiguriert sind und alle erforderlichen Gruppierungsfelder ausgewählt sind.
</Accordion>
<Accordion title="Was bedeutet 'Nicht angezeigte Daten'?">
Ihre Daten überschreiten die Anzeigebegrenzungen (100 Balken, 100 Datenpunkte oder 100 Segmente).
**So beheben Sie das Problem:** Fügen Sie Filter hinzu, um Ihre Daten einzugrenzen, oder ändern Sie die Datumsgranularität von Tag auf Woche oder Monat.
</Accordion>
<Accordion title="Warum zeigt eine Achse keine Daten an?">
Das ausgewählte Feld hat für die Datensätze in Ihrem Filter keine Werte, oder der Feldtyp entspricht nicht den erwarteten Daten.
**So beheben Sie das Problem:** Probieren Sie ein anderes Feld aus, oder prüfen Sie, ob Datensätze Werte für das ausgewählte Feld haben.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,75 @@
---
title: Dashboards
description: Erfahren Sie die Grundlagen von Reporting und Dashboards in Twenty.
---
## Dashboards verstehen
Dashboards in Twenty bieten eine visuelle Möglichkeit, Ihre wichtigsten Leistungskennzahlen zu verfolgen und Erkenntnisse aus Ihren CRM-Daten zu gewinnen.
<img src="/images/user-guide/dashboard/dashboards_v2.png" alt="Dashboards" />
## Wichtige Konzepte
### Dashboards
Ein Dashboard ist eine Sammlung von Registerkarten, die Ihre CRM-Daten auf einen Blick anzeigen. Sie können mehrere Dashboards für unterschiedliche Zwecke erstellen:
* Vertriebsleistung
* Teamaktivität
* Gesundheit der Pipeline
* Benutzerdefinierte Kennzahlen
### Registerkarten
Registerkarten ermöglichen es Ihnen, Ihr Dashboard in Abschnitte zu gliedern. Jede Registerkarte enthält ein oder mehrere Widgets.
### Widgets
Widgets sind einzelne Visualisierungen, die spezifische Daten anzeigen. Zu den Typen gehören:
* Balkendiagramme
* Tortendiagramme
* Liniendiagramme
* Aggregierte Diagramme
* iFrames
* Rich-Text
<Note>
**Aktuelle Einschränkungen**:
* Das Exportieren von Dashboards und das Freigeben für externe Benutzer (Nicht-Twenty-Benutzer) sind derzeit nicht verfügbar.
* Gauge-Diagramme sind noch nicht verfügbar.
</Note>
## Erste Schritte
### Ihr erstes Dashboard erstellen
1. Navigieren Sie zum Bereich **Dashboards**
2. Klicken Sie auf **+ Neues Dashboard**
3. Geben Sie Ihrem Dashboard einen Namen
4. Fügen Sie Registerkarten hinzu, um Ihre Inhalte zu organisieren
5. Fügen Sie Widgets hinzu, um Ihre Daten anzuzeigen
6. Speichern
### Widgets hinzufügen
1. Öffnen Sie eine Registerkarte in Ihrem Dashboard
2. Klicken Sie auf **+ Widget hinzufügen**
3. Wählen Sie den Widget-Typ aus
4. Wählen Sie die Datenquelle (Objekt)
5. Konfigurieren Sie die Widget-Einstellungen
6. Speichern Sie und zeigen Sie Ihr Widget an
## Beste Praktiken
* **Einfach anfangen**: Beginnen Sie mit einigen wichtigen Kennzahlen und fügen Sie im Laufe der Zeit weitere hinzu
* **Auf umsetzbare Daten fokussieren**: Zeigen Sie Kennzahlen an, die Entscheidungen vorantreiben
* **Regelmäßige Überprüfung**: Prüfen Sie Ihre Dashboards regelmäßig, um Trends zu erkennen
* **Mit dem Team teilen**: Machen Sie Dashboards für relevante Teammitglieder sichtbar
## Nächste Schritte
* [Widgets und Visualisierungen](/l/de/user-guide/dashboards/capabilities/widgets)
* [Referenz zu den Diagrammeinstellungen](/l/de/user-guide/dashboards/capabilities/chart-settings)
* [FAQ zu Dashboards](/l/de/user-guide/dashboards/how-tos/dashboards-faq)

View File

@@ -0,0 +1,76 @@
---
title: Fehlerbehandlung und Validierung
description: Überprüfen und beheben Sie Importfehler direkt in der Benutzeroberfläche, bevor Sie den Import bestätigen.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Vorabvalidierung
Nachdem Sie Ihre Datei hochgeladen und die Felder zugeordnet haben, validiert Twenty Ihre Daten, **bevor** sie importiert werden. So können Sie Fehler erkennen und beheben, ohne Ihre vorhandenen Daten zu beeinträchtigen.
## Wie es funktioniert
1. **Hochladen** Ihrer CSV-Datei
2. **Zuordnen** Ihrer Spalten zu Twenty-Feldern
3. **Überprüfen** der gelb hervorgehobenen potenziellen Fehler
4. **Fehlerbehebung** direkt in der Benutzeroberfläche
5. **Bestätigen** des Imports
<VimeoEmbed videoId="1145273857" title="Video-Demonstration" />
## Fehleranzeige
Zeilen mit Fehlern sind **gelb** hervorgehoben. Sie können:
* **Die Zelle direkt bearbeiten**, um den Fehler zu beheben
* **Die Zeile entfernen**, um sie vollständig zu überspringen
Diese Inline-Bearbeitung spart Zeit – Sie müssen nicht zu Ihrer Tabellenkalkulation zurückkehren, Fehler beheben und erneut hochladen.
## Häufige Fehlertypen
### Doppelte Werte
**Ursache**: Ein eindeutiges Feld (E-Mail, Domain) existiert bereits in Twenty oder kommt in Ihrer Datei doppelt vor.
**Lösung**:
* Bearbeiten Sie den doppelten Wert in der Import-Benutzeroberfläche
* Entfernen Sie eine der doppelten Zeilen
Weitere Details dazu, wie die Eindeutigkeit erzwungen wird, finden Sie unter [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints).
### Ungültiges Format
**Ursache**: Daten entsprechen nicht dem erwarteten Format (z. B. ungültige E-Mail, falsches Datumsformat).
**Lösung**: Bearbeiten Sie die Zelle, um das korrekte Format zu verwenden.
Siehe [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping) für das erwartete Format jedes Feldtyps.
### Erforderliche Felder fehlen
**Ursache**: Ein erforderliches Feld ist leer.
**Lösung**: Geben Sie im erforderlichen Feld einen Wert ein oder entfernen Sie die Zeile.
### Beziehung nicht gefunden
**Ursache**: Der referenzierte Datensatz existiert nicht (z. B. eine Unternehmensdomain, die nicht importiert wurde).
**Lösung**:
* Importieren Sie zuerst die übergeordneten Datensätze
* Oder korrigieren Sie den Referenzwert
Siehe [Beziehungen importieren](/l/de/user-guide/data-migration/capabilities/import-relations) für die korrekte Importreihenfolge und wie Datensätze verknüpft werden.
## Tipps für weniger Fehler
1. **Laden Sie die Vorlage herunter** um das erwartete Format zu sehen, bevor Sie Ihre Datei importieren
2. **Bereinigen Sie Ihre Daten** zunächst in der Tabellenkalkulation
3. **Importieren Sie Dateien in der richtigen Reihenfolge**, um Beziehungen zu importieren (Unternehmen → Personen → Verkaufschancen)
4. **Testen Sie mit kleinen Stapeln** vor dem vollständigen Import
5. **Auf Duplikate prüfen** vor dem Hochladen
6. **Jede Datei auf 10.000 Datensätze begrenzen**

View File

@@ -0,0 +1,198 @@
---
title: Feldzuordnung
description: Wie die Feldzuordnung beim Datenimport funktioniert.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Wie die Feldzuordnung funktioniert
Wenn Sie eine Datei hochladen, analysiert Twenty Ihre Spalten und versucht, sie bestehenden Feldern zuzuordnen.
### Automatische Zuordnung
Twenty versucht, Spalten anhand der folgenden Kriterien abzugleichen:
* Spaltenüberschriften (genaue oder ähnliche Übereinstimmungen)
* Erkennung des Datentyps (Datum, Zahlen, E-Mails)
* Häufige Feldmuster
<Note>**Schneller Tipp:** Exportieren Sie ein paar Zeilen aus dem Objekt, das Sie importieren möchten. Die exportierte Datei enthält genau die Spaltennamen, die Twenty erwartet, sodass die automatische Zuordnung beim Import reibungslos funktioniert.</Note>
### Optionen für die manuelle Zuordnung
Für jede Spalte können Sie:
* **Einem Feld zuordnen**: Wählen Sie das passende Twenty-Feld aus einem Dropdown aus
* **Nicht zuordnen**: Überspringen Sie die Spalte vollständig (Daten werden nicht importiert)
<Note>**Felder müssen vor dem Import existieren.** Der Import erzeugt Datensätze, nicht Felder. Erstellen Sie benutzerdefinierte Felder vor dem Import unter **Einstellungen → Datenmodell**.</Note>
## Kompatibilität der Feldtypen
Alle im Datenmodell verfügbaren Feldtypen werden für den Import unterstützt.
Sie können auch `id`-Werte importieren, um neuen Datensätzen eine bestimmte ID zuzuweisen oder vorhandene zu aktualisieren.
<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
## Anforderungen an das Datenformat
<Note>**Einige Felder haben eine spezielle Syntax.** Wir empfehlen, vor der Vorbereitung Ihres Imports die Beispieldatei herunterzuladen, um die erwartete Syntax für jeden Feldtyp zu sehen.</Note>
### Adressfelder
Adresse ist ein verschachteltes Feld mit mehreren Spalten. Einige können leer bleiben.
* **Adresse / Adresszeile 1**: Adresszeile 1
* **Adresse / Adresszeile 2**: Adresszeile 2
* **Adresse / Stadt**: Stadtname
* **Adresse / Bundesland**: Bundesland oder Provinz
* **Adresse / Land**: Ländername
* **Adresse / Postleitzahl**: Postleitzahl/ZIP-Code
### Array-Felder
Verwenden Sie folgendes Format:
```
["value1","value2"]
```
### Boolesche Felder
Verwenden Sie `TRUE` oder `FALSE` (Großbuchstaben) – nicht `true` oder `false`
### Währungsfelder
Währung ist ein verschachteltes Feld mit zwei Spalten, die **beide ausgefüllt werden müssen**:
* **Betrag / Betrag**: Der Zahlenwert (z. B. `1234.56`)
* **Betrag / Währung**: Der Währungscode (z. B. `USD`, `EUR`)
### Datumsfelder
Unterstützte Formate:
* `YYYY-MM-DD` (empfohlen)
* `MM/DD/YYYY`
* `DD/MM/YYYY`
* ISO-8601-Format
### Domain-Felder
* Es wird empfohlen, das Format `https://domain.com` zu verwenden, um Duplikate zu vermeiden, da dies das Format für Unternehmen ist, die durch die Postfach- und Kalender-Synchronisierungen erstellt werden.
* Es können ein `Domain Label` und eine `Domain URL` ausgefüllt werden: Best Practice ist, im Label `domain.com` und in der URL `https://domain.com` anzugeben
* Domains müssen im Objekt Unternehmen eindeutig sein
* **Domains müssen innerhalb der zu importierenden Datei eindeutig sein**
### E-Mail-Felder
* Müssen ein gültiges E-Mail-Format haben
* E-Mails müssen im Objekt Personen eindeutig sein
* **E-Mails müssen innerhalb der zu importierenden Datei eindeutig sein**
* Für zusätzliche E-Mails: Verwenden Sie **E-Mails / Primäre E-Mail** für die Haupt-E-Mail und **E-Mails / Zusätzliche E-Mails** mit diesem Format:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### ID-Felder
Die Angabe einer `id` während des Imports ist optional. Twenty erzeugt automatisch eine, wenn keine angegeben wird.
Anwendungsfälle für die Zuordnung einer `id`-Spalte:
* **Spezifische ID festlegen**: Wählen Sie die UUID für neu erstellte Datensätze
* **Vorhandene Datensätze aktualisieren**: Gegen vorhandene Datensätze abgleichen, um sie zu aktualisieren, anstatt Duplikate zu erstellen. In diesem Fall wird empfohlen, die anderen eindeutigen Felder nicht zuzuordnen: Die Zuordnung nur eines eindeutigen Feldes sorgt für einen reibungsloseren Import.
<Note>Wenn Sie eine `id` angeben, muss sie im UUID-Format sein (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
### JSON-Felder
Verwenden Sie gültiges JSON-Format:
```
{"key":"value","key2":"value2"}
```
### Link-Felder
Ähnlich wie Domain-Felder:
* Füllen Sie sowohl die Spalten für Label und URL aus: **Links / Link-URL** und **Links / Link-Label**
* Verwenden Sie das vollständige URL-Format: `https://example.com`
* Für sekundäre Links verwenden Sie die Spalte **Links / Sekundäre Links** mit diesem Format:
```
[{"url":"https://twenty.com","label":"Twenty"}]
```
### Mehrfachauswahl-Felder
Verwenden Sie die **API-Namen** (nicht die Anzeigenamen) in folgendem Format:
```
["VALUE1","VALUE2"]
```
Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
<Note>Neue Auswahloptionen werden durch den Import nicht automatisch erstellt. Sie müssen vor dem Import unter **Einstellungen → Datenmodell** hinzugefügt werden.</Note>
<Warning>
**Importiere Überschreibungen, es fügt nicht hinzu.**
Wenn ein Datensatz bereits `VALUE2` und `VALUE3` ausgewählt hat und Sie `["VALUE1"]` importieren, hat der Datensatz nach dem Import nur noch `VALUE1`. Die bisherigen Auswahlen werden ersetzt, nicht zusammengeführt.
</Warning>
### Zahlenfelder
* Nur Zahlen
* Dezimalzahlen verwenden einen Punkt: `1234.56`
* Keine Tausendertrennzeichen
### Telefonfelder
Telefon ist ein verschachteltes Feld mit mehreren Spalten, die **ausgefüllt werden müssen**
* **Telefone / Primäre Telefonnummer**: Die Telefonnummer (z. B. `4159095555`)
* **Telefone / Ländercode der primären Telefonnummer**: Ländercode (z. B. `US`)
* **Telefone / Vorwahl der primären Telefonnummer**: Vorwahl (z. B. `+1`)
### Bewertungsfelder
Verwenden Sie das API-Namensformat: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4`, `RATING_5`
### Relationsfelder
Weitere Informationen finden Sie in unserem dedizierten Artikel: [Beziehungen zwischen Objekten importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
### Auswahlfelder
Verwenden Sie den **API-Namen** der Option (nicht den Anzeigenamen):
```
VALUE1
```
Siehe [hier](#finding-api-names-for-select-fields), wo Sie die API-Namen finden.
<Note>Neue Auswahloptionen werden durch den Import nicht automatisch erstellt. Sie müssen vor dem Import unter **Einstellungen → Datenmodell** hinzugefügt werden.</Note>
### Textfelder
* Keine besondere Formatierung erforderlich
* Führende/abschließende Leerzeichen werden entfernt
## API-Namen finden
Für Select-, Multi-Select- und Array-Felder mit vordefinierten Optionen müssen Sie die **API-Namen** verwenden, nicht die Anzeigenamen.
### So finden Sie API-Namen
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt und das Feld aus
3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts auf der Einstellungsseite)
4. Zeigen Sie den API-Namen für jede Option an
<VimeoEmbed videoId="1144910809" title="Video-Demonstration" />

View File

@@ -0,0 +1,48 @@
---
title: Unterstützte Dateiformate
description: Unterstützte Dateiformate für den Datenimport in Twenty.
---
## Unterstützte Formate
Twenty unterstützt drei Dateiformate für den Import:
| Format | Erweiterung | Notizen |
| ------------------ | ----------- | ---------------------------- |
| **CSV** | .csv | Empfohlen, am kompatibelsten |
| **Excel** | .xlsx | Modernes Excel-Format |
| **Excel (Legacy)** | .xls | Älteres Excel-Format |
## Datei-Anforderungen
| Anforderung | Wert |
| -------------------- | --------------------------------------------------- |
| **Zeichenkodierung** | UTF-8 empfohlen |
| **Datensatzlimit** | 10.000 Datensätze pro Datei |
| **Struktur** | Die erste Zeile muss Spaltenüberschriften enthalten |
| **Inhalt** | Ein Objekttyp pro Datei |
## CSV: Beste Praktiken
* **Trennzeichen**: Verwenden Sie Komma (`,`) oder Semikolon (`;`)
* **Textbegrenzer**: Verwenden Sie doppelte Anführungszeichen (`"`) für Text, der Kommas enthält
* **Zeilenenden**: Sowohl Windows (CRLF) als auch Unix (LF) werden unterstützt
* **Leere Werte**: Zellen leer lassen, nicht "NULL" oder "N/A" verwenden
## Excel: Beste Praktiken
Beim Export aus Excel:
* Formeln entfernen (nur Werte exportieren)
* Leere Zeilen am Ende löschen
* Sicherstellen, dass keine zusammengeführten Zellen vorhanden sind
* Nur das erste Tabellenblatt verwenden
## Große Datensätze
Für Datenmengen mit mehr als 10.000 Datensätzen:
* In mehrere Dateien aufteilen
* Oder den [API-Import](/l/de/user-guide/data-migration/how-tos/import-data-via-api) für unbegrenzte Datensätze verwenden
<Note>Für sehr große Migrationen (über 100.000 Datensätze) ist die API deutlich schneller und zuverlässiger als CSV-Importe.</Note>

View File

@@ -0,0 +1,148 @@
---
title: Beziehungen zwischen Objekten importieren
description: Beziehungen zwischen Datensätzen per CSV importieren.
---
## Übersicht
Twenty unterstützt das Importieren von Beziehungen zwischen Objekten beim CSV-Import. So können Sie im Rahmen Ihrer Datenmigration Datensätze verknüpfen (z. B. Personen mit Unternehmen verknüpfen).
<Note>**Aktuell für den Import unterstützt**: Eins-zu-viele-Beziehungen, die auf jeder Seite auf einen einzelnen Objekttyp verweisen (z. B. Personen → Unternehmen). Beziehungen, die auf mehrere Objekttypen zeigen, werden für Import/Export noch nicht unterstützt.</Note>
## Wie Beziehungen in Twenty funktionieren
### Eins zu Viele / Viele zu Eins
Twenty unterstützt Standardbeziehungen, bei denen ein Datensatz mit vielen anderen verknüpft wird:
* **Ein Unternehmen → Viele Personen**: Ein Unternehmen kann mehrere Mitarbeitende haben, aber jede Person gehört zu einem Unternehmen
* **Ein Unternehmen → Viele Opportunities**: Ein Unternehmen kann mehrere Deals haben, aber jede Opportunity gehört zu einem Unternehmen
### Beziehungen, die auf mehrere Objekttypen zeigen können
Einige Beziehungen können verschiedene Objekttypen verbinden. Dies funktioniert auf zwei Arten:
**Muster 1: Viele Datensätze, die jeweils mit einem Datensatz aus unterschiedlichen Objekttypen verknüpft sind**
Mehrere Notizen oder Aufgaben können auf einmal an mehrere Objekttypen angehängt werden:
* **Notizen** können gleichzeitig mit einer Person, einem Unternehmen und einer Opportunity verknüpft werden
* **Aufgaben** können gleichzeitig mit einer Person, einem Unternehmen und einer Opportunity verknüpft werden
Hier befinden sich die Notizen/Aufgaben auf der "Viele"-Seite. Jede ist mit genau einem Datensatz pro Objekttyp verknüpft.
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
**Muster 2: Ein Datensatz, der Verknüpfungen von vielen Datensätzen unterschiedlicher Objekttypen erhält**
Ein Projekt kann Verknüpfungen von mehreren Datensätzen über verschiedene Objekttypen hinweg erhalten:
* **Ein Projekt** kann viele Personen mit ihm verknüpft haben, viele Unternehmen mit ihm verknüpft haben und viele Notizen, die daran angehängt sind
Hier befindet sich das Projekt auf der "Eins"-Seite. Mehrere Datensätze aus verschiedenen Objekten können alle mit demselben Projekt verknüpft sein.
<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 verweisen (z. B. Notizen → Personen/Unternehmen/Opportunities), werden beim CSV-Import oder -Export **noch nicht unterstützt**.
* **Import**: Es können nur Eins-zu-viele-Beziehungen importiert werden, die auf jeder Seite auf einen einzelnen Objekttyp verweisen
* **Export**: Spalten für Beziehungen, die auf mehrere Objekttypen verweisen, bleiben derzeit leer
Dies steht auf unserer Roadmap.
</Warning>
### Was heute nicht unterstützt wird
**Viele-zu-viele-Beziehungen** sind noch nicht verfügbar. Sie können derzeit beispielsweise keine Beziehung erstellen, bei der:
* Viele Personen mit vielen Projekten verknüpft sind
<Note>Viele zu viele Beziehungen sind für H2 2026 geplant.</Note>
## Datensätze während des Imports verknüpfen
<Note>**Erinnerung**: Es können nur Eins-zu-viele-Beziehungen importiert werden, die auf einen einzelnen Objekttyp verweisen (z. B. Personen → Unternehmen). Beziehungen, die auf mehrere Objekttypen verweisen (z. B. Notizen → Personen/Unternehmen/Opportunities), werden noch nicht unterstützt.</Note>
### Schritt 1: Identifizieren Sie die "Eins"- und "Viele"-Seiten
Bestimmen Sie zunächst, welches Objekt auf der "Eins"-Seite und welches auf der "Viele"-Seite der Beziehung steht.
**Beispiel**:
* **Unternehmen** ist die "Eins"-Seite (ein Unternehmen hat viele Mitarbeitende)
* **Personen** ist die "Viele"-Seite (jede Person gehört zu einem Unternehmen)
### Schritt 2: Sicherstellen, dass die Datensätze der "Eins"-Seite existieren
Bevor Sie die "Viele"-Seite importieren, müssen die Datensätze der "Eins"-Seite in Twenty bereits existieren.
* Importieren oder erstellen Sie zuerst die Datensätze der "Eins"-Seite (z. B. Unternehmen)
* Validieren Sie deren eindeutigen Bezeichner. Dies kann sein:
* Die `id` (Twenty-UUID)
* Ein als eindeutig festgelegtes Feld (z. B. `domain` für Unternehmen oder eine externe ID aus Ihrem vorherigen System)
<Warning>Der Import schlägt fehl, wenn auf einen nicht vorhandenen Datensatz verwiesen wird.</Warning>
### Schritt 3: Bereiten Sie Ihre CSV-Datei vor
Fügen Sie in Ihrer CSV-Datei der "Viele"-Seite eine Spalte hinzu, die auf den Datensatz der "Eins"-Seite verweist.
**Beispiel**: Für eine Personen-CSV-Datei, die mit Unternehmen verknüpft wird:
```
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
**Wichtig**:
* Der Wert muss dem eindeutigen Feld im Unternehmensdatensatz **exakt entsprechen**
* Für Domains verwenden Sie die **Domain-URL** (z. B. `https://acme.com`), nicht das Domain-Label
* Ordnen Sie pro Beziehung nur **einen** eindeutigen Bezeichner zu: Das führt zu einem reibungsloseren Import
### Schritt 4: Stellen Sie sicher, dass das Beziehungsfeld existiert
Vergewissern Sie sich vor dem Hochladen Ihrer Datei, dass das Beziehungsfeld zwischen Ihren Objekten existiert.
Falls es nicht existiert:
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie Ihr Objekt aus (z. B. Personen)
3. Erstellen Sie ein Beziehungsfeld, das auf das Zielobjekt zeigt (z. B. Unternehmen)
### Schritt 5: Beziehung hochladen und zuordnen
1. Laden Sie Ihre CSV-Datei über die Import-Benutzeroberfläche hoch
2. Suchen Sie im Schritt der Feldzuordnung Ihre Beziehungsspalte (z. B. `companyDomain`)
3. Ordnen Sie sie dem Beziehungsfeld zu (z. B. Unternehmen)
4. Twenty verknüpft automatisch jeden Datensatz mit dem passenden übergeordneten Datensatz
### Verfügbare eindeutige Felder für Beziehungen
| Objekt | Verfügbare eindeutige Felder |
| --------------------------------------------------- | -------------------------------------------------------- |
| **Unternehmen** | `id`, `domain`, jedes benutzerdefinierte eindeutige Feld |
| **Personen** | `id`, `email`, jedes benutzerdefinierte eindeutige Feld |
| **Arbeitsbereichsmitglieder** | `id`, `email` (nicht Name) |
| **Andere Standard- und benutzerdefinierte Objekte** | `id`, jedes als eindeutig markierte Feld |
<Note>**Verknüpfung mit Workspace-Mitgliedern**: Wenn die Beziehung auf Workspace-Mitglieder verweist (Ihr Team, das sich bei Twenty anmeldet), referenzieren Sie sie über ihre **E-Mail-Adresse**, nicht über ihren Namen.</Note>
<Note>Wir empfehlen, `domain` für Unternehmen und `email` für Personen zu verwenden, da diese menschenlesbar sind und sich in Tabellenkalkulationen leicht pflegen lassen.</Note>
<Note>**Erinnerung**: Softgelöschte Datensätze (sichtbar unter Befehlsmenü → Gelöschte Datensätze anzeigen) zählen für die Einzigartigkeitskriterien. Wenn Sie einen Datensatz mit demselben eindeutigen Wert wie ein gelöschter Datensatz importieren, wird der gelöschte Datensatz wiederhergestellt. Weitere Details finden Sie unter [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints).</Note>
## Regel für die Importreihenfolge
<Warning>
**Importieren Sie immer zuerst die "Eins"-Seite!**
1. Zuerst **Unternehmen** (keine Abhängigkeiten)
2. **Personen** an zweiter Stelle (mit Unternehmen verknüpft)
3. **Opportunities** an dritter Stelle (mit Unternehmen/Personen verknüpft)
4. **Benutzerdefinierte Objekte** entsprechend ihren Abhängigkeiten
Der übergeordnete Datensatz muss existieren, bevor Sie darauf verweisen können.
</Warning>

View File

@@ -0,0 +1,72 @@
---
title: Eindeutigkeitsbeschränkungen
description: Wie Twenty während des Imports die Dateneindeutigkeit erzwingt.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Überblick
Twenty erzwingt die Eindeutigkeit bei bestimmten Feldern, um doppelte Datensätze zu verhindern und die Datenintegrität sicherzustellen. Das Verständnis dieser Einschränkungen ist für erfolgreiche Importe entscheidend.
## Standardmäßige eindeutige Felder
| Objekt | Eindeutige Felder |
| ------------------------------ | ------------------------ |
| **Personen** | `id`, `email` |
| **Unternehmen** | `id`, `domain` |
| **Benutzerdefinierte Objekte** | nur `id` (standardmäßig) |
<Note>Das Feld `id` ist die interne Kennung von Twenty und wird für jeden Datensatz automatisch generiert. Es verwendet das UUID-Format (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
## Benutzerdefinierte eindeutige Felder
Sie können unter **Einstellungen → Datenmodell** zusätzliche eindeutige Felder definieren:
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie ein Objekt aus
3. Klicken Sie auf ein Feld
4. Aktivieren Sie **Eindeutig** in den Feldeinstellungen
### Anwendungsfälle für benutzerdefinierte eindeutige Felder
* **Externe IDs**: IDs aus anderen Systemen speichern (Salesforce-ID, HubSpot-ID)
* **Geschäftskennungen**: Mitarbeiternummern, Kundencodes
* **Alternative Kontaktinformationen**: LinkedIn-Profil, Telefonnummer
<Note>Der Feldname `id` ist für die interne ID von Twenty reserviert. Verwenden Sie für externe Kennungen einen anderen Namen wie `externalId` oder `legacyId`.</Note>
## Importverhalten
### Erstellen neuer Datensätze
Wenn ein eindeutiger Feldwert nicht existiert, wird ein neuer Datensatz erstellt.
### Aktualisieren vorhandener Datensätze
Wenn ein eindeutiger Feldwert mit einem vorhandenen Datensatz übereinstimmt, wird dieser Datensatz mit den neuen Daten **aktualisiert**.
<Warning>Um **vorhandene Datensätze zu aktualisieren**, wird empfohlen, **nur ein eindeutiges Feld abzugleichen**.</Warning>
### Soft-gelöschte Datensätze
<Warning>
**Gelöschte Datensätze zählen für die Eindeutigkeit.**
Soft-gelöschte Datensätze (sichtbar unter Befehlsmenü → Gelöschte Datensätze anzeigen) werden in die Eindeutigkeitsprüfungen einbezogen. Wenn Sie einen Datensatz mit demselben eindeutigen Wert wie ein gelöschter Datensatz importieren, wird der gelöschte Datensatz mit den neuen Daten **wiederhergestellt**.
</Warning>
## Duplikaterkennung während des Imports
Während der Validierungsphase:
* Duplikate in Ihrer Datei werden gelb hervorgehoben
* Sie können doppelte Zeilen in der Benutzeroberfläche bearbeiten oder entfernen, bevor Sie den Import starten
<VimeoEmbed videoId="1145246326" title="Video-Demonstration" />
## Beste Praktiken
1. **Entfernen Sie Duplikate** aus Ihrer Datei vor dem Import
2. **Prüfen Sie vorhandene Datensätze** in Twenty vor dem Import
3. **Verwenden Sie externe IDs**, wenn Sie aus anderen Systemen migrieren
4. **Fügen Sie eindeutige Felder hinzu**, wenn Sie vorhandene Datensätze aktualisieren möchten

View File

@@ -0,0 +1,32 @@
---
title: FAQ exportieren
description: Häufig gestellte Fragen zum Export von Daten.
---
<AccordionGroup>
<Accordion title="Können wir alle Arbeitsbereichsdaten exportieren, bevor wir stornieren, einschließlich benutzerdefinierter Objekte, benutzerdefinierter Felder, Beziehungen, Notizen, Aufgaben, Chancen, Anhänge, Workflows, Berechtigungen und Audit-Historie?">
Workspace-Daten können vor dem Abbruch mit einigen Ausnahmen exportiert werden: Dashboards, Workflows und Berechtigungen müssen manuell übertragen werden; Audit-Protokolle können nicht übertragen werden.
</Accordion>
<Accordion title="Welche Elemente können derzeit nicht exportiert oder migriert werden?">
Die meisten Elemente können exportiert oder mit einigen Ausnahmen migriert werden:
* Workflows, Dashboards und alle Einstellungen (API-Schlüssel, Webhooks, Audit-Protokolle, Benutzereinstellungen, etc.) muss manuell migriert werden
* durch die Installation dieser App in einem anderen Arbeitsbereich erzeugte Objekte und Felder können migriert werden. Sie sollten nicht manuell migriert werden
* einige Datensätze, wie Workflow-Versionen und Workflow-Ausführungen, sind nicht übertragbar und werden voraussichtlich verloren gehen
* einige Objekte wie Nachrichten und Kalenderobjekte sollten nicht exportiert werden, da sie erstellt werden, wenn ein Konto verbunden und periodisch synchronisiert ist. Sie werden erneut synchronisiert, sobald Sie Ihr Konto verbinden (solange Sie Zugriff auf dieses Konto haben wenn es ein Konto eines Teammitglieds ist, das deine Firma verlassen hat, dann müssen diese Nachrichten exportiert werden, sonst werden sie verloren)
</Accordion>
<Accordion title="Gibt es eine offizielle Wolke zu selbstgehosteten Migrationsprozessen oder einen unterstützten Migrationsdienst?">
Ab sofort gibt es keine offizielle Cloud-zu-selbst gehostete Migrationsprozedur. Die Grundidee ist:
* installiere zuerst Apps, um app-eigene Objekte und Felder einzuführen
* von Benutzern hinzugefügte Objekte und Felder replizieren
* verwenden Sie ein Skript mit API-Schlüsseln oder KI-Tools, um alle Daten von einem Arbeitsbereich in einen anderen zu migrieren
* alle nicht übertragbaren Objekte müssen manuell migriert werden
Bitte beachten Sie ein paar Dinge:
* Sie können bis zu 50 Anfragen pro Minute auf den Pro Plan oder 100 Anfragen pro Minute auf den Organisationsplan schicken, bevor Sie eine Anfrage/Min. Grenze setzen
* jede API-Anfrage kann bis zu 200 Datensätze haben
* einige Daten in Feldern wie Erstellt von Timeline Aktivitäten und aktualisiert von werden beim Import verloren gehen und vom System überschrieben
</Accordion>
<Accordion title="Werden exportierte Dateien in offenen und dokumentierten Formaten bereitgestellt?">
Exportierte Dateien in der Oberfläche befinden sich im Excel-Format, und alle API-Anfragen können im JSON-Format gespeichert werden.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,209 @@
---
title: Exportieren Sie Ihre Daten
description: Vollständige Schritt-für-Schritt-Anleitung zum Exportieren von Daten aus Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Überblick
Exportieren Sie die Daten Ihres Arbeitsbereichs als CSV für Backups, Berichte oder Migrationen.
**Anwendungsfälle:**
* **Regelmäßige Backups** — behalten Sie Kopien Ihrer Daten
* **Externe Berichterstattung** — analysieren Sie Daten in Excel, Google Sheets oder BI-Tools
* **Migration** — übertragen Sie Daten in ein anderes System
* **Massenaktualisierungen** — exportieren, bearbeiten und erneut importieren, um Datensätze zu aktualisieren
## Was Sie wissen müssen
### Exportbeschränkungen
* **Maximal 20.000 Datensätze** pro Export
* Nur **sichtbare Spalten** werden exportiert
* Nur **gefilterte Datensätze** werden exportiert (basierend auf Ihrer aktuellen Ansicht)
<Note>Für größere Exporte (mehr als 20.000 Datensätze) verwenden Sie Filter, um stapelweise zu exportieren, oder nutzen Sie die [API](/l/de/developers/extend/api).</Note>
### Berechtigungen
Sie benötigen die Berechtigung **"Export CSV"**, um Daten zu exportieren. Kontaktieren Sie Ihren Workspace-Admin, wenn Sie diese Option nicht haben.
## Schritt 1: Zum Objekt navigieren
Gehen Sie zu dem Objekt, das Sie exportieren möchten:
* **People** — für Kontakte
* **Companies** — für Organisationen
* **Opportunities** — für Deals
* **Benutzerdefinierte Objekte** — jedes Objekt, das Sie erstellt haben
## Schritt 2: Ansicht konfigurieren
**Wichtig:** Der Export enthält nur das, was in Ihrer aktuellen Ansicht sichtbar ist.
### Spalten hinzufügen/entfernen
1. Klicken Sie auf **Optionen → Felder** (oder auf das **+** am Ende der Spalten)
2. Wählen Sie die Felder aus, die Sie exportieren möchten
3. Deaktivieren Sie Felder, die Sie nicht benötigen
### Datensätze filtern (optional)
Wenn Sie nur einen Teil der Daten benötigen:
1. Klicken Sie auf **Filter**
2. Fügen Sie Filterbedingungen hinzu (z. B. "Erstellungsdatum > 1. Januar 2024")
3. Es werden nur übereinstimmende Datensätze exportiert
### Datensätze sortieren (optional)
1. Klicken Sie auf eine Spaltenüberschrift, um zu sortieren
2. Der Export übernimmt Ihre Sortierreihenfolge
<Note>**Erstellen Sie eine dedizierte Exportansicht.** Speichern Sie eine Ansicht, die speziell für Exporte konfiguriert ist, damit Sie sie nicht jedes Mal neu konfigurieren müssen.</Note>
## Schritt 3: Daten exportieren
1. Klicken Sie auf das Symbol **⋮** oben rechts in der Tabelle
2. Wählen Sie **Ansicht exportieren**
3. Wählen Sie den Speicherort für die CSV-Datei
4. Warten Sie, bis der Download abgeschlossen ist
## Was exportiert wird
| Enthalten | Nicht enthalten |
| ------------------------------------------------- | ------------------------------------- |
| Alle sichtbaren Spalten | Ausgeblendete Spalten |
| Datensätze, die den aktuellen Filtern entsprechen | Herausgefilterte Datensätze |
| Benutzerdefinierte Feldwerte | Felder, die nicht in der Ansicht sind |
| Datensatz-IDs | Dateianhänge |
| Beziehungs-IDs | Bilder |
### Relationsfelder
Beziehungs-IDs werden nur auf der **"Many"-Seite** einer Beziehung exportiert:
* **People-Export** enthält eine `companyId`-Spalte (Beziehung People → Company)
* **Companies-Export** enthält NICHT `peopleIds` (Companies ist die "One"-Seite)
Das bedeutet, Sie können den People-Export zum Re-Import verwenden und die Verknüpfung zur Company beibehalten, müssen jedoch People nach Companies erneut importieren, um die Beziehungen wiederherzustellen.
## Exportieren für bestimmte Zwecke
### Für Backups
1. Erstellen Sie eine Ansicht, in der **alle Felder** sichtbar sind
2. Entfernen Sie alle Filter, um alle Datensätze einzubeziehen
3. Exportieren Sie jeden Objekttyp separat
4. Speichern Sie Exporte an einem sicheren Ort
5. Richten Sie eine wiederkehrende Erinnerung ein (wöchentlich/monatlich)
### Für externe Berichterstattung
1. Nehmen Sie nur die Felder auf, die Sie für die Analyse benötigen
2. Wenden Sie Filter an, um sich auf relevante Daten zu konzentrieren
3. Erwägen Sie, nach dem Feld zu sortieren, das Sie analysieren werden
### Für Massenaktualisierungen
1. Exportieren Sie die Datensätze, die Sie aktualisieren möchten
2. Fügen Sie den eindeutigen Bezeichner ein (`email`, `domain` oder `id`)
3. Bearbeiten Sie die exportierte Datei
4. Erneut importieren, um Datensätze zu aktualisieren
Siehe: [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import)
### Für Migration
Wenn Sie zum Zweck der Migration in ein anderes System exportieren:
1. **Exportieren Sie jedes Objekt separat** — People, Companies, Opportunities usw.
2. **ID-Felder einbeziehen** — diese helfen, Beziehungen beizubehalten
3. **Feldzuordnungen dokumentieren** — notieren Sie, wie Twenty-Felder Ihrem Zielsystem zugeordnet werden
## Umgang mit großen Datensätzen (mehr als 20.000 Datensätze)
Das Exportlimit beträgt 20.000 Datensätze. Für größere Datensätze:
### Option 1: Stapelweiser Export
1. Fügen Sie einen Filter hinzu (z. B. "Erstellungsdatum"-Bereiche)
2. Exportieren Sie den ersten Stapel
3. Ändern Sie den Filter
4. Exportieren Sie den nächsten Stapel
5. Kombinieren Sie die Dateien in Ihrer Tabellenkalkulation
**Beispielfilter für die Stapelverarbeitung:**
* Nach Datumsbereich (Januar, Februar, März ...)
* Nach Eigentümer/in (Teammitglied A, Teammitglied B ...)
* Nach Status (Aktiv, Inaktiv ...)
### Option 2: Verwenden Sie die API
Die API hat kein Datensatzlimit:
1. Holen Sie sich Ihren API-Schlüssel unter **Einstellungen → Entwickler**
2. Verwenden Sie die GraphQL-API, um Datensätze abzufragen
3. Verarbeiten Sie die Ergebnisse in Ihrer Anwendung
Siehe: [API-Dokumentation](/l/de/developers/extend/api)
## Tipps und Best Practices
### Exportansichten erstellen
Speichern Sie Ansichten, die speziell für Exporte konfiguriert sind:
1. Konfigurieren Sie Spalten und Filter
2. Klicken Sie auf **Ansichtsoptionen** → **Als neue Ansicht speichern**
3. Benennen Sie sie "Export - [Zweck]"
### Sichern Sie Ihre Exporte
Exportierte Dateien können sensible Daten enthalten:
* Speichern Sie sie an sicheren Orten
* Löschen Sie alte Exporte, wenn sie nicht mehr benötigt werden
* Seien Sie vorsichtig beim Teilen von Exportdateien
### Vor dem Export prüfen
<Check>Die richtigen Spalten sind sichtbar</Check>
<Check>Filter sind korrekt gesetzt (oder für den Vollexport entfernt)</Check>
<Check>Sie haben eine Exportberechtigung</Check>
## FAQ
<AccordionGroup>
<Accordion title="Warum fehlen in meinem Export einige Spalten?">
Es werden nur sichtbare Spalten exportiert. Fügen Sie die benötigten Spalten vor dem Export über **Optionen → Felder** hinzu.
</Accordion>
<Accordion title="Warum enthält mein Export nicht alle Datensätze?">
Überprüfen Sie Ihre Filter. Der Export enthält nur Datensätze, die Ihren aktuellen Ansichtsfiltern entsprechen. Entfernen Sie Filter, um alle Datensätze zu exportieren.
</Accordion>
<Accordion title="Kann ich mehr als 20.000 Datensätze exportieren?">
Nicht in einem einzigen Export. Verwenden Sie Filter, um stapelweise zu exportieren, oder nutzen Sie die API für größere Datensätze.
</Accordion>
<Accordion title="Welches Format hat die Exportdatei?">
CSV (durch Kommas getrennte Werte). Lässt sich in Excel, Google Sheets oder jeder Tabellenkalkulationsanwendung öffnen.
</Accordion>
<Accordion title="Sind Beziehungs-IDs enthalten?">
Ja, aber nur auf der "Many"-Seite von Beziehungen. Beispielsweise enthält ein People-Export `companyId`, ein Companies-Export enthält jedoch keine People-IDs.
</Accordion>
<Accordion title="Kann ich Exporte automatisieren?">
Nicht direkt über die UI. Verwenden Sie die API, um automatisierte Export-Workflows zu erstellen.
</Accordion>
</AccordionGroup>
## Nächste Schritte
* [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import) — bearbeiten Sie Ihren Export und importieren Sie ihn erneut
* [So importieren Sie Daten über die API](/l/de/user-guide/data-migration/how-tos/import-data-via-api) — für große Datensätze
* [API-Dokumentation](/l/de/developers/extend/api) — erstellen Sie benutzerdefinierte Export-Workflows

View File

@@ -0,0 +1,430 @@
---
title: Importfehler beheben
description: Umfassende Anleitung zur Fehlerbehebung bei CSV-Importfehlern.
---
## Übersicht
Import funktioniert nicht? Diese Anleitung hilft Ihnen, häufige Importfehler Schritt für Schritt zu erkennen und zu beheben.
## Wie die Importvalidierung funktioniert
Nachdem Sie Ihre Datei hochgeladen und die Spalten zugeordnet haben, validiert Twenty Ihre Daten:
1. **Validierung läuft** — Twenty prüft jede Zeile auf Fehler
2. **Fehler werden hervorgehoben** — problematische Zeilen erscheinen in **gelb**
3. **Sie können direkt korrigieren** — bearbeiten Sie Zellen direkt in der Import-UI
4. **Oder Zeilen entfernen** — problematische Datensätze vollständig überspringen
<Note>**Beheben Sie Fehler in der UI.** Sie müssen nicht zu Ihrer Tabellenkalkulation zurückkehren. Bearbeiten Sie Zellen direkt während des Imports, um Zeit zu sparen.</Note>
## Schritt-für-Schritt-Fehlerbehebung
### Schritt 1: Fehlertyp bestimmen
Klicken Sie auf eine hervorgehobene Zeile, um die spezifische Fehlermeldung anzuzeigen. Häufige Fehlertypen:
| Fehlermeldung | Was es bedeutet |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |
| Doppelte Werte, gelb hervorgehoben | Wert existiert bereits in Twenty oder kommt in Ihrer Datei doppelt vor |
| `{field} is not a valid {type}` (fahren Sie mit der Maus über die gelbe Zelle) | Daten entsprechen nicht dem erwarteten Format |
| Erforderliches Feld hervorgehoben | Erforderliches Feld ist leer |
| `Can't connect to {object}. No unique record found...` (Import schlägt fehl) | Referenzierter Datensatz existiert nicht |
| `Too many records. Up to 10000 allowed` (Upload blockiert) | Die Datei enthält mehr als 10.000 Datensätze |
### Schritt 2: Fehler beheben
Befolgen Sie die unten stehenden spezifischen Anweisungen für jeden Fehlertyp.
---
## Fehler: Doppelter Wert
### Was Sie sehen werden
Zeilen mit doppelten Werten werden in der Import-UI **gelb hervorgehoben**, bevor der Import startet.
### Was es bedeutet
Ein eindeutiges Feld (E-Mail, Domain) entweder:
* Existiert bereits in Twenty
* Kommt in Ihrer Datei doppelt vor
### So beheben Sie den Fehler
**Option 1: Doppelt vorhandenen Wert bearbeiten**
1. Klicken Sie auf die Zelle mit dem Fehler
2. In einen eindeutigen Wert ändern
3. Mit dem Import fortfahren
**Option 2: Die doppelte Zeile entfernen**
1. Klicken Sie auf das X neben der Zeile
2. Die Zeile wird während des Imports übersprungen
**Option 3: Twenty den vorhandenen Datensatz aktualisieren lassen**
1. Stellen Sie sicher, dass Ihre Datei einen eindeutigen Bezeichner enthält (`email`, `domain` oder `id`)
2. Ordnen Sie das Feld mit dem eindeutigen Bezeichner zu
3. Twenty aktualisiert den vorhandenen Datensatz, statt ein Duplikat zu erstellen
<Note>
**Sie können eindeutige Felder ebenfalls aktualisieren.**
* Wenn Sie die `id` beibehalten, aber die `email` ändern → die E-Mail wird aktualisiert
* Wenn Sie die `email` beibehalten, aber die `id` ändern → die ID wird aktualisiert
Solange ein eindeutiger Bezeichner übereinstimmt, aktualisiert Twenty den Datensatz.
</Note>
### So vermeiden Sie diesen Fehler
Vor dem Import:
1. Sortieren Sie Ihre Tabellenkalkulation nach dem eindeutigen Feld
2. Entfernen Sie doppelte Zeilen
3. Prüfen Sie, ob Datensätze bereits in Twenty existieren
<Warning>
**Soft-gelöschte Datensätze zählen für die Eindeutigkeit.**
Überprüfen Sie das Befehlsmenü → Gelöschte Datensätze anzeigen. Die dortigen Datensätze erzwingen weiterhin die Eindeutigkeit. Löschen Sie sie dauerhaft oder stellen Sie sie wieder her und aktualisieren Sie sie.
</Warning>
Weitere Details: [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)
---
## Fehler: Ungültiges Format
### Was Sie sehen werden
Der Zellwert ist gelb hervorgehoben. Fahren Sie mit der Maus darüber, um die Fehlermeldung zu sehen:
```
{field name} is not a valid {field type}
```
### Was es bedeutet
Die Daten entsprechen nicht dem erwarteten Format für diesen Feldtyp.
### So beheben Sie den Fehler — nach Feldtyp
#### E-Mail
**Problem:** Ungültiges E-Mail-Format
**Lösung:** Verwenden Sie das Format `name@domain.com`
```
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com
```
#### Domäne
**Problem:** Uneinheitliches Format kann Duplikate verursachen
**Lösung:** Verwenden Sie das Format `https://domain.com` (empfohlen)
```
⚠️ acme.com (valid, but not recommended)
⚠️ www.acme.com (valid, but not recommended)
✅ https://acme.com (recommended)
```
<Note>Alle Formate sind gültig, aber `https://domain.com` wird empfohlen, da es dem von der E-Mail-/Kalendersynchronisierung verwendeten Format entspricht. Die Verwendung anderer Formate kann doppelte Unternehmen erzeugen.</Note>
#### Datum
**Problem:** Nicht erkanntes Datumsformat
**Lösung:** Verwenden Sie in der gesamten Datei durchgängig das Format `YYYY-MM-DD`
```
✓ 2024-03-15 (YYYY-MM-DD)
❌ 03/15/2024 (MM/DD/YYYY)
❌ 15/03/2024 (DD/MM/YYYY)
```
#### Telefon
**Problem:** Erforderliche Spalten fehlen
**Lösung:** Alle Telefonspalten einschließen
| Spalte | Beispiel |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
#### Boolesch
**Problem:** Falscher boolescher Wert
**Lösung:** Verwenden Sie `TRUE` oder `FALSE` in Großbuchstaben
```
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE
```
#### Auswahl / Mehrfachauswahl
**Problem:** Wert stimmt nicht mit vorhandenen Optionen überein
**Lösung:** Verwenden Sie **API-Namen**, nicht Anzeigenamen
So finden Sie API-Namen:
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt und das Feld aus
3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts)
4. Verwenden Sie den API-Namen (z. B. `OPTION_1`, nicht "Option 1")
```
❌ High Priority
✓ HIGH_PRIORITY
```
#### Währung
**Problem:** Betrag oder Währungscode fehlt
**Lösung:** Beide Spalten ausfüllen
| Spalte | Beispiel |
| --------------------- | --------- |
| **Amount / Amount** | `1234.56` |
| **Amount / Currency** | `USD` |
#### Nummer
**Problem:** Nichtnumerische Zeichen
**Lösung:** Nur Zahlen, Punkt für Dezimalstellen
```
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
```
Vollständige Formatreferenz: [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)
---
## Fehler: Erforderliches Feld fehlt
### Was Sie sehen werden
Die Zeile ist gelb hervorgehoben, und die Zelle des erforderlichen Felds ist markiert.
### Was es bedeutet
Ein erforderliches Feld ist in dieser Zeile leer.
### So beheben Sie den Fehler
**Option 1: Einen Wert eingeben**
1. Klicken Sie auf die leere Zelle
2. Geben Sie einen Wert ein
3. Mit dem Import fortfahren
**Option 2: Die Zeile entfernen**
1. Wenn Ihnen die Daten fehlen, klicken Sie auf X, um die Zeile zu überspringen
### So vermeiden Sie diesen Fehler
Identifizieren Sie vor dem Import die erforderlichen Felder:
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie Ihr Objekt aus
3. Prüfen Sie, welche Felder als erforderlich markiert sind
---
## Fehler: Relation nicht gefunden
### Was Sie sehen werden
Dieser Fehler tritt **nach Beginn des Imports** auf — der Import schlägt mit einer Meldung wie dieser fehl:
```
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
```
Das bedeutet, dass es in Twenty kein Unternehmen mit diesem spezifischen Bezeichner gibt.
<Note>Im Gegensatz zu anderen Fehlern wird dieser im Schritt der Datenüberprüfung nicht erkannt. Der Import startet und schlägt dann fehl, wenn die fehlende Relation auftritt.</Note>
### Was es bedeutet
Sie versuchen, auf einen Datensatz zu verweisen, der in Twenty nicht existiert.
### So beheben Sie den Fehler
**Option 1: Importieren Sie zuerst die übergeordneten Datensätze**
1. Brechen Sie den aktuellen Import ab
2. Importieren Sie die übergeordneten Datensätze (z. B. Unternehmen)
3. Importieren Sie anschließend die untergeordneten Datensätze (z. B. Personen)
**Option 2: Korrigieren Sie den Referenzwert**
1. Überprüfen Sie den Referenzwert in Ihrer Datei
2. Stellen Sie sicher, dass er genau mit einem vorhandenen Datensatz übereinstimmt
3. Format prüfen: Domains sollten das Format `https://domain.com` haben
**Option 3: Entfernen Sie die Relation**
1. Leeren Sie die Zelle, um ohne die Relation zu importieren
2. Fügen Sie die Relation später manuell hinzu
### So vermeiden Sie diesen Fehler
1. **In der richtigen Reihenfolge importieren:**
* Zuerst Unternehmen
* Dann Personen (mit Unternehmensreferenzen)
* Als Drittes Opportunities
2. **Referenzwerte überprüfen:**
* Exportieren Sie übergeordnete Datensätze, um exakte Bezeichner zu erhalten
* Verwenden Sie das Domain-Format `https://domain.com`
* Prüfen Sie auf Tippfehler und Groß-/Kleinschreibung
<Warning>
**Der Import schlägt fehl, wenn auf einen nicht vorhandenen Datensatz verwiesen wird.**
Importieren Sie übergeordnete Objekte immer vor untergeordneten Objekten.
</Warning>
Weitere Details: [Beziehungen importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
---
## Fehler: Datei zu groß
### Was Sie sehen werden
Dieser Fehler tritt **beim Hochladen Ihrer Datei** auf — der Upload wird vollständig blockiert:
```
Too many records. Up to 10000 allowed
```
Sie können erst mit dem Schritt der Datenüberprüfung fortfahren, wenn Sie die Dateigröße reduziert haben.
### Was es bedeutet
Ihre Datei enthält mehr als 10.000 Datensätze.
### So beheben Sie den Fehler
**Option 1: In mehrere Dateien aufteilen**
1. Teilen Sie Ihre Daten in Dateien mit 10.000 oder weniger Datensätzen auf
2. Importieren Sie jede Datei separat
3. Halten Sie die Importreihenfolge ein (Unternehmen vor Personen)
**Option 2: API-Import verwenden**
Für sehr große Datensätze verwenden Sie die API, die keine Datensatzbegrenzung hat.
Siehe: [So importieren Sie Daten über die API](/l/de/user-guide/data-migration/how-tos/import-data-via-api)
---
## Fehler: Feld nicht erkannt
### Was es bedeutet
Eine Spalte in Ihrer Datei kann nicht zugeordnet werden, weil das Feld in Twenty nicht existiert.
### So beheben Sie den Fehler
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt aus, das Sie importieren
3. Klicken Sie auf **+ Feld hinzufügen**
4. Erstellen Sie das benutzerdefinierte Feld mit dem passenden Typ
5. Laden Sie Ihre Datei erneut hoch
<Note>Der CSV-Import erstellt Datensätze, nicht Felder. Alle Felder müssen vor dem Import vorhanden sein.</Note>
---
## Fehler: Benutzerrelation leer
### Was es bedeutet
Sie versuchen, einen Datensatz einem Benutzer zuzuweisen (Owner, Assignee), aber die Relation wird nicht zugeordnet.
### Häufige Ursachen
1. **Benutzer hat seine Einladung nicht angenommen** — der Benutzer existiert noch nicht in Twenty
2. **Benutzer-ID aus altem System verwendet** — Twenty kann IDs aus einem anderen System nicht zuordnen
3. **Falsches E-Mail-Format** — die E-Mail entspricht nicht dem Twenty-Konto des Benutzers
### So beheben Sie den Fehler
1. Stellen Sie sicher, dass alle Benutzer **ihre Einladung** zu Ihrem Twenty-Arbeitsbereich **angenommen haben**
2. Verwenden Sie die **E-Mail-Adresse** des Benutzers (nicht seinen Namen oder die alte System-ID)
3. Verwenden Sie dieselbe E-Mail, mit der sie Twenty beigetreten sind
<Warning>
**Benutzer müssen Einladungen vor dem Import annehmen.**
Wenn ein Benutzer seine Einladung nicht angenommen hat, haben Datensätze, die auf ihn verweisen, leere Benutzerrelationen.
</Warning>
---
## Checkliste vor dem Import
Vermeiden Sie Fehler, indem Sie vor dem Import Folgendes prüfen:
### Dateianforderungen
<Check>Datei ist im CSV-, XLSX- oder XLS-Format</Check>
<Check>Datei enthält weniger als 10.000 Datensätze</Check>
<Check>Datei verwendet UTF-8-Kodierung</Check>
### Datenqualität
<Check>Keine doppelten E-Mails (für Personen)</Check>
<Check>Keine doppelten Domains (für Unternehmen)</Check>
<Check>Alle Datumsangaben verwenden ein einheitliches Format</Check>
<Check>Alle Domains verwenden das Format `https://domain.com`</Check>
### Feldformate
<Check>Boolesche Felder verwenden `TRUE` oder `FALSE` (Großbuchstaben)</Check>
<Check>Auswahlfelder verwenden API-Namen, nicht Anzeigenamen</Check>
<Check>Telefonfelder enthalten alle erforderlichen Spalten</Check>
<Check>Währungsfelder enthalten sowohl Betrag als auch Währungscode</Check>
### Beziehungen
<Check>Übergeordnete Datensätze vor untergeordneten Datensätzen importiert</Check>
<Check>Relationsspalten verweisen auf vorhandene Datensätze</Check>
<Check>Domain-Format entspricht exakt dem Format von Twenty</Check>
### Datenmodell
<Check>Alle benutzerdefinierten Felder existieren in Einstellungen → Datenmodell</Check>
<Check>Auswahloptionen existieren vor dem Import</Check>
---
## Gibt es weiterhin Probleme?
Wenn Sie die obigen Lösungen ausprobiert haben:
1. **Beispieldatei herunterladen** — sehen Sie das genaue Format, das Twenty erwartet
2. **Bestehende Datensätze exportieren** — vergleichen Sie Ihre Datei mit funktionierenden Daten
3. **Testen Sie mit einer kleinen Stichprobe** — probieren Sie zuerst 5-10 Zeilen
4. **Prüfen Sie die Referenzartikel:**
* [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)
* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)
* [Beziehungen importieren](/l/de/user-guide/data-migration/capabilities/import-relations)
* [Fehlerbehandlung](/l/de/user-guide/data-migration/capabilities/error-handling)

View File

@@ -0,0 +1,201 @@
---
title: Unternehmen über CSV importieren
description: Vollständige Schritt-für-Schritt-Anleitung zum Importieren von Unternehmen in Twenty.
---
## Übersicht
Diese Anleitung führt Sie durch den Import Ihrer Unternehmen in Twenty. **Unternehmen sollten zuerst importiert werden**, da Personen und Verkaufschancen mit Unternehmen verknüpft werden.
## Bevor Sie beginnen
### Checkliste der Voraussetzungen
<Check>
Ihre Datei ist im CSV-, XLSX- oder XLS-Format
</Check>
<Check>
Die Datei enthält weniger als 10.000 Datensätze
</Check>
<Check>
Keine doppelten Domains in Ihrer Datei
</Check>
<Check>
Alle benutzerdefinierten Felder existieren in **Einstellungen → Datenmodell**
</Check>
<Note>
Müssen Sie mehr als 10.000 Unternehmen importieren? Teilen Sie in mehrere Dateien auf oder verwenden Sie den [API-Import](/l/de/user-guide/data-migration/how-tos/import-data-via-api).
</Note>
## Schritt 1: Bereiten Sie Ihre Unternehmensdaten vor
### Erforderliche und empfohlene Felder
| Feld | Erforderlich? | Format | Notizen |
| ----------------------------- | ------------- | -------------------- | ------------------------------ |
| **Name** | Empfohlen | Text | Anzeigename des Unternehmens |
| **Domain** | Empfohlen | `https://domain.com` | Eindeutiger Bezeichner |
| **Adresse** | Optional | Mehrere Spalten | Siehe unten |
| **Mitarbeiter** | Optional | Nummer | Anzahl der Mitarbeiter |
| **Benutzerdefinierte Felder** | Optional | Variiert | Muss im Datenmodell existieren |
### Domain-Format
<Warning>
**Verwenden Sie für Domains das Format `https://domain.com`.**
Dies entspricht dem Format, das verwendet wird, wenn Unternehmen durch E-Mail-/Kalender-Synchronisierung automatisch erstellt werden, und verhindert später Duplikate.
</Warning>
**Domain-Spalten:**
* **Domain / Domain Label**: `acme.com`
* **Domain / Domain URL**: `https://acme.com`
### Adressformat
Adresse ist ein verschachteltes Feld mit mehreren Spalten:
```
Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
123 Main Street,San Francisco,CA,USA,94105
```
### Beispielhafte CSV-Struktur
```csv
name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
Widget Co,https://widgets.co,widgets.co,New York,USA,50
```
<Note>
**Profi-Tipp:** Klicken Sie während des Imports auf **Beispieldatei herunterladen**, um die genauen Spaltennamen zu sehen, die Twenty erwartet.
</Note>
## Schritt 2: Zugriff auf die Importfunktion
**Option 1: Aus der Unternehmensansicht**
1. Navigieren Sie zu **Unternehmen** in der linken Seitenleiste
2. Klicken Sie auf das Symbol **⋮** oben rechts
3. Wählen Sie **Datensätze importieren**
**Option 2: Über das Befehlsmenü**
1. Drücken Sie `Cmd + K` (Mac) oder `Strg + K` (Windows)
2. Geben Sie "import" ein
3. Wählen Sie **Datensätze importieren**
4. Wählen Sie **Unternehmen**
## Schritt 3: Laden Sie Ihre Datei hoch
1. Klicken Sie auf **Datei auswählen**
2. Wählen Sie Ihre CSV-, XLSX- oder XLS-Datei aus
3. Warten Sie, bis Twenty Ihre Datei analysiert
## Schritt 4: Ordnen Sie Ihre Spalten zu
Twenty versucht automatisch, Ihre Spalten den Feldern zuzuordnen. Prüfen und anpassen:
1. **Automatische Zuordnungen prüfen** — vergewissern Sie sich, dass sie korrekt sind
2. **Falsche Zuordnungen korrigieren** — klicken Sie auf das Dropdown, um das richtige Feld auszuwählen
3. **Spalten überspringen** — wählen Sie **Do not map** für Spalten, die Sie nicht importieren möchten
### Wichtige Zuordnungsregeln
* **Domain**: Ordnen Sie **Domain / Domain URL** zu (nicht Domain Label)
* **Adresse**: Ordnen Sie jeden Teil der jeweiligen Spalte zu (Stadt, Bundesstaat usw.)
* **Auswahlfelder**: Werte müssen mit vorhandenen Optionen übereinstimmen (oder Sie ordnen sie im nächsten Schritt zu)
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
## Schritt 5: Werte von Auswahlfeldern zuordnen
Wenn Sie Auswahl- oder Mehrfachauswahlfelder haben:
1. Twenty zeigt Ihre Werte neben den vorhandenen Optionen an
2. Ordnen Sie jeden Wert in Ihrer Datei einer Twenty-Option zu
3. Oder erstellen Sie bei Bedarf neue Optionen
<Note>
Auswahloptionen verwenden **API-Namen**, nicht Anzeigenamen. Prüfen Sie **Einstellungen → Datenmodell** → Aktivieren Sie den **Erweiterten Modus**, um API-Namen zu sehen.
</Note>
## Schritt 6: Fehler prüfen und beheben
Bevor der Import abgeschlossen wird, validiert Twenty Ihre Daten:
1. Klicken Sie auf **Nächste Schritte**
2. Zeilen mit Fehlern sind **gelb** hervorgehoben
3. **Fehler direkt beheben** — klicken Sie auf eine Zelle und bearbeiten Sie den Wert
4. **Problematische Zeilen entfernen** — klicken Sie auf das X, um die Zeile zu überspringen
### Häufige Fehler beim Unternehmensimport
| Fehler | Ursache | Lösung |
| ----------------------------- | ---------------------------------- | ------------------------------------------------------------ |
| **Doppelte Domain** | Domain existiert bereits in Twenty | Aus Datei entfernen oder bestehenden Datensatz aktualisieren |
| **Ungültiges Domain-Format** | Falsches Format | Verwenden Sie `https://domain.com` |
| **Erforderliches Feld fehlt** | Erforderliches Feld ist leer | Wert ausfüllen oder Zeile entfernen |
## Schritt 7: Import abschließen
1. Importzusammenfassung prüfen
2. Klicken Sie auf **Bestätigen**, um zu importieren
3. Warten Sie, bis der Import abgeschlossen ist
4. Überprüfen Sie dies, indem Sie einige Datensätze prüfen
## Nach dem Import von Unternehmen
Jetzt können Sie Datensätze importieren, die mit Unternehmen verknüpft sind:
1. **[Personen importieren](/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv)** — verknüpfen Sie sie über die Domain mit Unternehmen
2. **Verkaufschancen importieren** — verknüpfen Sie sie mit Unternehmen
3. **Import verifizieren** — prüfen Sie stichprobenartig einige Datensätze, um sicherzustellen, dass die Daten korrekt sind
## Vorhandene Unternehmen aktualisieren
So aktualisieren Sie Unternehmen, statt neue zu erstellen:
1. Fügen Sie die Spalte `domain` oder `id` in Ihrer Datei hinzu
2. Twenty gleicht Datensätze anhand dieses eindeutigen Bezeichners ab
3. Vorhandene Unternehmen werden aktualisiert; neue werden erstellt
Details finden Sie unter [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import).
## FAQ
<AccordionGroup>
<Accordion title="Warum können zwei Unternehmen nicht dieselbe Domain haben?">
Die Domain ist ein eindeutiger Bezeichner in Twenty. Das verhindert doppelte Unternehmen und stellt sicher, dass die E-Mail-Synchronisierung E-Mails dem richtigen Unternehmen korrekt zuordnet.
</Accordion>
<Accordion title="Was ist, wenn ich Unternehmen ohne Domain habe?">
Sie können die Domain leer lassen. Wir empfehlen jedoch, wenn möglich Domains hinzuzufügen, um die Datenqualität zu verbessern und E-Mails automatisch zuzuordnen.
</Accordion>
<Accordion title="Kann ich Unternehmen ohne verknüpfte Personen importieren?">
Ja! Sie können zunächst Unternehmen importieren und später Personen importieren und sie mithilfe der Unternehmensdomain verknüpfen.
</Accordion>
<Accordion title="Was passiert, wenn ich eine bereits vorhandene Domain importiere?">
Wenn Sie einen eindeutigen Bezeichner (Domain oder id) angeben, der mit einem vorhandenen Unternehmen übereinstimmt, aktualisiert Twenty dieses Unternehmen, statt ein Duplikat zu erstellen.
</Accordion>
<Accordion title="Wie behebe ich Fehler vom Typ 'doppelte Domain'?">
Entfernen Sie entweder das Duplikat aus Ihrer Datei oder fügen Sie die `id` des Unternehmens hinzu, um stattdessen den vorhandenen Datensatz zu aktualisieren.
</Accordion>
</AccordionGroup>
## Fehlerbehebung
Gibt es Probleme? Prüfen Sie:
* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
* [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)
* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)

View File

@@ -0,0 +1,242 @@
---
title: Kontakte über CSV importieren
description: Vollständige Schritt-für-Schritt-Anleitung zum Importieren von Personen/Kontakten in Twenty.
---
## Übersicht
Diese Anleitung führt Sie durch den Import Ihrer Kontakte (Personen) in Twenty.
## Bevor Sie beginnen
### Checkliste der Voraussetzungen
<Check>
Ihre Datei ist im CSV-, XLSX- oder XLS-Format
</Check>
<Check>
Die Datei enthält weniger als 10.000 Datensätze
</Check>
<Check>
Keine doppelten E-Mail-Adressen in Ihrer Datei
</Check>
<Check>
**Unternehmen zuerst importiert** (wenn Personen mit Unternehmen verknüpft werden)
</Check>
<Check>
Alle benutzerdefinierten Felder existieren in **Einstellungen → Datenmodell**
</Check>
<Warning>
**Unternehmen vor Personen importieren**
Wenn Sie Personen mit Unternehmen verknüpfen möchten, importieren Sie zuerst Unternehmen. Das Unternehmen muss existieren, bevor Sie darauf verweisen können.
</Warning>
## Schritt 1: Bereiten Sie Ihre Kontaktdaten vor
### Erforderliche und empfohlene Felder
| Feld | Erforderlich? | Format | Notizen |
| ----------------------------- | ------------- | ----------------- | ------------------------------------- |
| **E-Mail** | Empfohlen | `name@domain.com` | Muss eindeutig sein |
| **Vorname** | Empfohlen | Text | |
| **Nachname** | Empfohlen | Text | |
| **Unternehmen** | Optional | Domain oder ID | Verknüpft mit vorhandenem Unternehmen |
| **Telefon** | Optional | Mehrere Spalten | Siehe unten |
| **Berufsbezeichnung** | Optional | Text | |
| **Benutzerdefinierte Felder** | Optional | Variiert | Muss im Datenmodell existieren |
### E-Mail-Format
* Muss ein gültiges E-Mail-Format haben: `name@domain.com`
* **Muss eindeutig sein** — keine Duplikate in Ihrer Datei oder in Twenty
* Für zusätzliche E-Mails verwenden Sie die Spalte **Emails / Additional Emails**:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### Telefonformat
Telefon ist ein **verschachteltes Feld**, das mehrere Spalten erfordert:
| Spalte | Beispiel |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### Verknüpfung mit Unternehmen
Fügen Sie eine Spalte mit dem eindeutigen Bezeichner des Unternehmens hinzu:
| Spaltenname | Format | Beispiel |
| --------------- | ---------- | -------------------------------------- |
| `companyDomain` | URL-Format | `https://acme.com` |
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Note>
**Domain-URL-Format verwenden** (`https://acme.com`), nicht die Bezeichnung. Dies entspricht der Art, wie Unternehmen in Twenty gespeichert werden.
</Note>
### Beispielhafte CSV-Struktur
```csv
firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
```
<Note>
**Profi-Tipp:** Klicken Sie während des Imports auf **Beispieldatei herunterladen** oder exportieren Sie einige vorhandene Personen, um die genauen Spaltennamen zu sehen, die Twenty erwartet.
</Note>
## Schritt 2: Zugriff auf die Importfunktion
**Option 1: Aus der Personenansicht**
1. Navigieren Sie zu **Personen** in der linken Seitenleiste
2. Klicken Sie auf das Symbol **⋮** oben rechts
3. Wählen Sie **Datensätze importieren**
**Option 2: Über das Befehlsmenü**
1. Drücken Sie `Cmd + K` (Mac) oder `Strg + K` (Windows)
2. Geben Sie "import" ein
3. Wählen Sie **Datensätze importieren**
4. Wählen Sie **Personen**
## Schritt 3: Laden Sie Ihre Datei hoch
1. Klicken Sie auf **Datei auswählen**
2. Wählen Sie Ihre CSV-, XLSX- oder XLS-Datei aus
3. Warten Sie, bis Twenty Ihre Datei analysiert
## Schritt 4: Ordnen Sie Ihre Spalten zu
Twenty versucht automatisch, Ihre Spalten den Feldern zuzuordnen. Prüfen und anpassen:
1. **Automatische Zuordnungen prüfen** — vergewissern Sie sich, dass sie korrekt sind
2. **Falsche Zuordnungen korrigieren** — klicken Sie auf das Dropdown, um das richtige Feld auszuwählen
3. **Spalten überspringen** — wählen Sie **Do not map** für Spalten, die Sie nicht importieren möchten
### Wichtige Zuordnungsregeln
| Spaltentyp | Zuordnen zu | Notizen |
| -------------------- | ------------------------------ | ------------------------------------------ |
| Unternehmensreferenz | **Company**-Beziehungsfeld | Verwenden Sie Domain ODER ID, nicht beides |
| E-Mail | **E-Mail** | Primäre E-Mail-Adresse |
| Zusätzliche E-Mails | **Emails / Additional Emails** | Array-Format |
| Telefon | Getrennte Spalten | Nummer, Ländercode, Telefonvorwahl |
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
### Zuordnung der Unternehmensbeziehung
Beim Zuordnen der Unternehmensspalte:
1. Suchen Sie Ihre Unternehmensreferenzspalte (z. B. `companyDomain`)
2. Ordnen Sie sie dem **Company**-Beziehungsfeld zu
3. Twenty verknüpft jede Person mit dem passenden Unternehmen
<Warning>
**Ordnen Sie für Beziehungen nur EINEN eindeutigen Bezeichner zu.**
Ordnen Sie nicht sowohl `companyId` als auch `companyDomain` zu. Wählen Sie eines — vorzugsweise die Domain, da sie menschenlesbar ist.
</Warning>
## Schritt 5: Werte von Auswahlfeldern zuordnen
Wenn Sie Auswahl- oder Mehrfachauswahlfelder haben (wie z. B. Lead-Quelle):
1. Twenty zeigt Ihre Werte neben den vorhandenen Optionen an
2. Ordnen Sie jeden Wert in Ihrer Datei einer Twenty-Option zu
3. Oder erstellen Sie bei Bedarf neue Optionen
<Note>
Auswahloptionen verwenden **API-Namen**, nicht Anzeigenamen. Prüfen Sie **Einstellungen → Datenmodell** → Aktivieren Sie den **Erweiterten Modus**, um API-Namen zu sehen.
</Note>
## Schritt 6: Fehler prüfen und beheben
Bevor der Import abgeschlossen wird, validiert Twenty Ihre Daten:
1. Klicken Sie auf **Nächste Schritte**
2. Zeilen mit Fehlern sind **gelb** hervorgehoben
3. **Fehler direkt beheben** — klicken Sie auf eine Zelle und bearbeiten Sie den Wert
4. **Problematische Zeilen entfernen** — klicken Sie auf das X, um die Zeile zu überspringen
### Häufige Fehler beim Kontaktimport
| Fehler | Ursache | Lösung |
| ----------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------- |
| **Doppelte E-Mail** | E-Mail existiert bereits in Twenty oder in der Datei | Duplikat entfernen oder bestehenden Datensatz aktualisieren |
| **Ungültiges E-Mail-Format** | E-Mail-Format ist falsch | Auf `name@domain.com` korrigieren |
| **Relation nicht gefunden** | Unternehmen existiert nicht | Importieren Sie zuerst Unternehmen oder korrigieren Sie die Referenz |
| **Erforderliches Feld fehlt** | Erforderliches Feld ist leer | Wert ausfüllen oder Zeile entfernen |
## Schritt 7: Import abschließen
1. Importzusammenfassung prüfen
2. Klicken Sie auf **Bestätigen**, um zu importieren
3. Warten Sie, bis der Import abgeschlossen ist
4. Überprüfen Sie dies, indem Sie einige Datensätze und deren Unternehmensverknüpfungen kontrollieren
## Nach dem Import von Kontakten
Ihre Kontakte sind jetzt in Twenty! Nächste Schritte:
1. **Unternehmensverknüpfungen überprüfen** — öffnen Sie einige Personen-Datensätze, um zu bestätigen, dass sie mit dem richtigen Unternehmen verknüpft sind
2. **Verkaufschancen importieren** — verknüpfen Sie sie bei Bedarf mit Personen und Unternehmen
3. **E-Mail-Synchronisierung einrichten** — verbinden Sie Ihr Postfach, um den E-Mail-Verlauf in Kontaktdatensätzen zu sehen
## Vorhandene Kontakte aktualisieren
So aktualisieren Sie Kontakte, statt neue zu erstellen:
1. Fügen Sie die Spalte `email` oder `id` in Ihrer Datei hinzu
2. Twenty gleicht Datensätze anhand dieses eindeutigen Bezeichners ab
3. Vorhandene Kontakte werden aktualisiert; neue werden erstellt
Details finden Sie unter [So aktualisieren Sie vorhandene Datensätze](/l/de/user-guide/data-migration/how-tos/update-existing-records-via-import).
## FAQ
<AccordionGroup>
<Accordion title="Warum können zwei Personen nicht dieselbe E-Mail haben?">
E-Mail ist ein eindeutiger Bezeichner in Twenty. Das verhindert doppelte Kontakte und stellt sicher, dass die E-Mail-Synchronisierung E-Mails der richtigen Person korrekt zuordnet.
</Accordion>
<Accordion title="Was ist, wenn ich Personen ohne E-Mail habe?">
Sie können das E-Mail-Feld leer lassen. Wir empfehlen jedoch, wenn möglich E-Mail-Adressen hinzuzufügen, um die Datenqualität und die E-Mail-Synchronisierung zu verbessern.
</Accordion>
<Accordion title="Wie verknüpfe ich Personen beim Import mit Unternehmen?">
Fügen Sie eine Spalte mit der Domain des Unternehmens (z. B. `https://acme.com`) oder der ID hinzu. Verbinden Sie diese Spalte beim Mapping mit dem Unternehmens-Relationsfeld.
</Accordion>
<Accordion title="Was ist, wenn das Unternehmen noch nicht existiert?">
Importieren Sie zuerst Unternehmen und dann Personen. Das Unternehmen muss existieren, bevor Sie darauf verweisen können.
</Accordion>
<Accordion title="Kann ich die ID aus meinem vorherigen CRM importieren?">
Ja! Erstellen Sie in Ihrem Datenmodell ein benutzerdefiniertes Feld, das als "eindeutig" markiert ist, um die externe ID zu speichern. Hinweis: Der Feldname `id` ist für die interne ID von Twenty reserviert.
</Accordion>
<Accordion title="Wie behebe ich Fehler vom Typ 'Relation nicht gefunden'?">
Das Unternehmen, auf das Sie verweisen, existiert nicht. Importieren Sie entweder zuerst das Unternehmen oder prüfen Sie, dass die Domain/ID exakt mit einem vorhandenen Unternehmen übereinstimmt.
</Accordion>
</AccordionGroup>
## Fehlerbehebung
Gibt es Probleme? Prüfen Sie:
* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
* [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)

View File

@@ -0,0 +1,176 @@
---
title: Daten über die API importieren
description: Wann und wie Sie die APIs von Twenty für groß angelegte Datenimporte verwenden.
---
## Übersicht
Twenty stellt sowohl **GraphQL**- als auch **REST-APIs** für den programmatischen Datenimport bereit. Verwenden Sie die API, wenn der CSV-Import für Ihr Datenvolumen nicht praktikabel ist oder wenn Sie automatisierte, wiederkehrende Importe benötigen.
## Wann Sie den API-Import verwenden sollten
| Szenario | Empfohlene Methode |
| ------------------------------------ | --------------------------------- |
| Unter 10.000 Datensätzen | CSV-Import |
| 10.000–50.000 Datensätze | CSV-Import (in Dateien aufteilen) |
| **Über 50.000 Datensätze** | **API-Import** |
| Einmalige Migration | Beides (je nach Volumen) |
| **Wiederkehrende Importe** | **API-Import** |
| **Echtzeitsynchronisierung** | **API-Import** |
| **Integration mit anderen Systemen** | **API-Import** |
<Note>Für Datensätze im Bereich von Hunderttausenden ist die API deutlich schneller und zuverlässiger als mehrere CSV-Importe.</Note>
## API-Rate-Limits
Twenty setzt Rate-Limits durch, um die Systemstabilität zu gewährleisten:
| Limit | Wert |
| ------------------------------- | ------------------------ |
| **Anfragen pro Minute** | 100 |
| **Datensätze pro Batch-Aufruf** | 60 |
| **Maximaler Durchsatz** | ~6.000 Datensätze/Minute |
<Warning>
**Planen Sie Ihren Import unter Berücksichtigung dieser Limits.**
Für 100.000 Datensätze bei maximalem Durchsatz rechnen Sie mit etwa 17 Minuten Importzeit. Fügen Sie Pufferzeit für Fehlerbehandlung und Wiederholungen hinzu.
</Warning>
## Erste Schritte
### Schritt 1: API-Schlüssel abrufen
1. Gehen Sie zu **Einstellungen → Entwickler**
2. Klicken Sie auf **+ API-Schlüssel erstellen**
3. Geben Sie Ihrem API-Schlüssel einen aussagekräftigen Namen
4. Kopieren Sie den API-Schlüssel sofort (er wird nicht erneut angezeigt)
5. Bewahren Sie ihn sicher auf
<Warning>
**Halten Sie Ihren API-Schlüssel geheim.**
Jeder, der Ihren API-Schlüssel besitzt, kann auf die Daten Ihres Arbeitsbereichs zugreifen und sie ändern. Checken Sie ihn niemals in Code-Repositories ein und geben Sie ihn nicht öffentlich weiter.
</Warning>
### Schritt 2: Wählen Sie Ihre API
Twenty unterstützt zwei API-Typen:
| API | Am besten geeignet für | Dokumentation |
| ----------- | ---------------------------------------------------------------- | ------------------------------------------- |
| **GraphQL** | Flexible Abfragen, Abruf verknüpfter Daten, komplexe Operationen | [API-Dokumentation](/l/de/developers/extend/api) |
| **REST** | Einfache CRUD-Operationen, vertraute REST-Muster | [API-Dokumentation](/l/de/developers/extend/api) |
Beide APIs unterstützen:
* Erstellen, Lesen, Aktualisieren und Löschen von Datensätzen
* **Batch-Operationen** — bis zu 60 Datensätze pro Aufruf erstellen oder aktualisieren
**Verwenden Sie für Importe Batch-Operationen**, um den Durchsatz innerhalb der Rate-Limits zu maximieren.
### Schritt 3: Importreihenfolge planen
Wie bei CSV-Importen ist die **Reihenfolge bei Relationen wichtig**:
1. Zuerst **Unternehmen** (keine Abhängigkeiten)
2. **Personen** an zweiter Stelle (können mit Unternehmen verknüpft werden)
3. **Opportunities** an dritter Stelle (können mit Unternehmen und Personen verknüpft werden)
4. **Aufgaben/Notizen** (können mit allen oben genannten verknüpft werden)
5. **Benutzerdefinierte Objekte** (gemäß ihren Abhängigkeiten)
## Beste Praktiken
### Anfragen bündeln
* Senden Sie Datensätze nicht einzeln
* Fassen Sie bis zu **60 Datensätze pro API-Aufruf** zusammen
* Dies maximiert den Durchsatz innerhalb der Rate-Limits
### Mit Rate-Limits umgehen
* Implementieren Sie Verzögerungen zwischen den Anfragen (mindestens 600 ms für dauerhafte Importe)
* Verwenden Sie exponentielles Backoff, wenn Sie an Grenzen stoßen
* Überwachen Sie 429-Antworten (Too Many Requests)
### Daten zuerst validieren
* Bereinigen und validieren Sie Ihre Daten vor dem Import
* Prüfen Sie, ob Pflichtfelder ausgefüllt sind
* Überprüfen Sie, ob die Formate den Anforderungen von Twenty entsprechen (siehe [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping))
### Alles protokollieren
* Protokollieren Sie jeden importierten Datensatz (einschließlich IDs)
* Protokollieren Sie Fehler mit vollem Kontext
* Dies hilft bei der Fehleranalyse und der Überprüfung des Abschlusses
### Zuerst testen
* Testen Sie mit einer kleinen Stichprobe (10–20 Datensätze)
* Überprüfen Sie, ob die Daten in Twenty korrekt angezeigt werden
* Führen Sie anschließend den vollständigen Import aus
### Upsert verwenden, um Duplikate zu vermeiden
Die GraphQL-API unterstützt **Batch-Upsert** — aktualisieren, wenn der Datensatz existiert, ansonsten erstellen. Dies verhindert Duplikate beim erneuten Ausführen von Importen.
## Objekt- und Feldnamen finden
So sehen Sie verfügbare Objekte und Felder:
1. Gehen Sie zu **Einstellungen → API und Webhooks**
2. Durchsuchen Sie die **Metadaten-API**
3. Sehen Sie alle Standard- und benutzerdefinierten Objekte mit ihren Feldern
Die Dokumentation zeigt alle Standard- und benutzerdefinierten Objekte, deren Felder und die erwarteten Datentypen.
## Professionelle Dienstleistungen
Bei komplexen API-Migrationen können unsere Partner helfen:
| Dienst | Enthalten |
| ------------------------------------ | ------------------------------------------------- |
| **Datenmodell-Design** | Entwerfen Sie Ihre optimale Datenstruktur |
| **Migrationsskripte** | Schreiben und Ausführen der Importskripte |
| **Daten-Transformation** | Bearbeitung komplexer Zuordnungen und Bereinigung |
| **Validierung & Qualitätssicherung** | Überprüfen, dass die Migration abgeschlossen ist |
**Am besten geeignet für:**
* Migrationen mit über 100.000 Datensätzen
* Komplexe Daten-Transformationen
* Straffe Zeitpläne
* Teams ohne Entwicklerressourcen
Kontaktieren Sie uns unter [contact@twenty.com](mailto:contact@twenty.com) oder informieren Sie sich über unsere [Implementierungsservices](/l/de/user-guide/getting-started/capabilities/implementation-services).
## FAQ
<AccordionGroup>
<Accordion title="Was ist der Unterschied zwischen GraphQL und REST?">
Mit GraphQL können Sie in einer einzelnen Abfrage genau die Daten anfordern, die Sie benötigen, und es eignet sich besser für komplexe Operationen. REST verwendet standardmäßige HTTP-Methoden (GET, POST, PUT, DELETE) und ist möglicherweise vertrauter, wenn Sie mit herkömmlichen APIs gearbeitet haben.
</Accordion>
<Accordion title="Kann ich vorhandene Datensätze über die API aktualisieren?">
Ja! Verwenden Sie Update-Mutationen (GraphQL) oder PUT/PATCH-Anfragen (REST) mit der `id` des Datensatzes.
</Accordion>
<Accordion title="Wie gehe ich mit Duplikaten um?">
Fragen Sie zunächst nach vorhandenen Datensätzen mit eindeutigen Kennungen (E-Mail, Domain). Aktualisieren, wenn vorhanden; erstellen, wenn nicht.
</Accordion>
<Accordion title="Kann ich Datensätze über die API löschen?">
Ja, verwenden Sie Lösch-Mutationen (GraphQL) oder DELETE-Anfragen (REST).
</Accordion>
<Accordion title="Gibt es ein SDK für Python oder Node.js?">
Derzeit nicht, aber beide APIs funktionieren mit jedem HTTP-Client in jeder Sprache.
</Accordion>
</AccordionGroup>
## API-Dokumentation
Für vollständige Implementierungsdetails, Codebeispiele und Schema-Referenz:
* [API-Dokumentation](/l/de/developers/extend/api)

View File

@@ -0,0 +1,225 @@
---
title: Beziehungen zwischen Objekten per CSV importieren
description: Vollständige Schritt-für-Schritt-Anleitung zum Verknüpfen von Datensätzen während des CSV-Imports.
---
## Übersicht
Diese Anleitung führt Sie durch den Import von Beziehungen zwischen Objekten – zum Beispiel das Verknüpfen von Personen mit Unternehmen oder von Opportunities mit Personen.
<Note>**Was kann importiert werden:** Nur Eins-zu-Viele-Beziehungen, die auf einen einzelnen Objekttyp verweisen. Beziehungen, die auf mehrere Objekttypen verweisen (z. B. Notizen, die sowohl mit Personen als auch mit Unternehmen verknüpft sind), werden beim Import noch nicht unterstützt.</Note>
## Beziehungen verstehen
### Was ist eine "Eins-zu-Viele"-Beziehung?
In einer Eins-zu-Viele-Beziehung:
* **Ein** Unternehmen hat **viele** Personen (Mitarbeitende)
* **Ein** Unternehmen hat **viele** Opportunities
* **Eine** Person hat **viele** Aufgaben
Die "Eins"-Seite ist die **übergeordnete**. Die "Viele"-Seite ist die **untergeordnete**.
### Häufige Beziehungen in Twenty
| Beziehung | "Eins"-Seite (übergeordnet) | "Viele"-Seite (untergeordnet) |
| --------------------------- | --------------------------- | ----------------------------- |
| Unternehmen → Personen | Unternehmen | Personen |
| Unternehmen → Opportunities | Unternehmen | Opportunities |
| Personen → Aufgaben | Person | Aufgaben |
| Personen → Notizen | Person | Notizen |
## Schritt 1: Identifizieren Sie die "Eins"- und "Viele"-Seiten
Bestimmen Sie vor dem Import, welches Objekt übergeordnet und welches untergeordnet ist.
**Fragen Sie sich:** "Hat EIN [Objekt A] VIELE [Objekt B]?"
* Ein Unternehmen → Viele Personen ✓ (Unternehmen ist übergeordnet)
* Eine Person → Viele Unternehmen ✗ (Das ist falsch – eine Person gehört zu einem Unternehmen)
## Schritt 2: Importieren Sie zuerst die übergeordneten Datensätze
Das übergeordnete Objekt ("Eins"-Seite) muss in Twenty existieren, bevor Sie darauf verweisen können.
**Importreihenfolge:**
1. Zuerst **Unternehmen** (keine Abhängigkeiten)
2. **Personen** an zweiter Stelle (mit Unternehmen verknüpfen)
3. **Opportunities** an dritter Stelle (mit Unternehmen und/oder Personen verknüpfen)
4. **Aufgaben/Notizen** (mit einem der oben genannten verknüpfen)
<Warning>
**Wenn der übergeordnete Datensatz nicht existiert, schlägt der Import fehl.**
Stellen Sie stets sicher, dass Unternehmen importiert sind, bevor Sie Personen mit Unternehmensreferenzen importieren.
</Warning>
## Schritt 3: Notieren Sie den eindeutigen Bezeichner des übergeordneten Objekts
Sie müssen auf den übergeordneten Datensatz mit einem eindeutigen Bezeichner verweisen. Verfügbare Optionen:
| Übergeordnetes Objekt | Verfügbare eindeutige Bezeichner |
| ------------------------------ | ------------------------------------------------------------------------------------------ |
| **Unternehmen** | `id` (UUID), `domain` (empfohlen) oder ein beliebiges benutzerdefiniertes eindeutiges Feld |
| **Personen** | `id` (UUID), `email` oder ein beliebiges benutzerdefiniertes eindeutiges Feld |
| **Arbeitsbereichsmitglieder** | `id` (UUID), `email` (nicht Name) |
| **Benutzerdefinierte Objekte** | `id` (UUID) oder ein beliebiges als eindeutig markiertes Feld |
<Note>**Empfehlung:** Verwenden Sie `domain` für Unternehmen und `email` für Personen. Diese sind menschenlesbar und in Ihrer Tabelle leicht zu überprüfen.</Note>
### Den Bezeichner finden
Wenn Sie die `id` benötigen:
1. Exportieren Sie die übergeordneten Datensätze aus Twenty
2. Der Export enthält die Spalte `id`
3. Verwenden Sie diese IDs in Ihrer Datei mit untergeordneten Datensätzen
## Schritt 4: Überprüfen Sie, ob das Beziehungsfeld existiert
Stellen Sie vor dem Import sicher, dass das Beziehungsfeld zwischen Ihren Objekten existiert.
**So prüfen oder erstellen Sie es:**
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie Ihr untergeordnetes Objekt aus (z. B. Personen)
3. Suchen Sie nach einem Beziehungsfeld, das auf das übergeordnete Objekt zeigt (z. B. Unternehmen)
4. Wenn es nicht existiert, erstellen Sie es:
* Klicken Sie auf **+ Feld hinzufügen**
* Wählen Sie den Typ **Relation**
* Wählen Sie das übergeordnete Objekt
## Schritt 5: Bereiten Sie Ihre CSV-Datei vor
Fügen Sie Ihrer untergeordneten CSV eine Spalte hinzu, die mit dem eindeutigen Bezeichner auf das übergeordnete Objekt verweist.
### Beispiel: Personen, die mit Unternehmen verknüpft werden
**Ihre Personen-CSV:**
```csv
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
```
Die Spalte `companyDomain` verweist auf die Domain des Unternehmens.
### Formatvorgaben
| Kennung | Format | Beispiel |
| ------- | --------------- | -------------------------------------- |
| Domäne | URL-Format | `https://acme.com` |
| E-Mail | Standard-E-Mail | `john@acme.com` |
| ID | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Warning>
**Das Domain-Format ist wichtig!**
Verwenden Sie `https://domain.com` (nicht nur `domain.com`). Dies entspricht der Art, wie Twenty Unternehmensdomains speichert, und verhindert Zuordnungsfehler.
</Warning>
### Wichtige Regeln
1. **Exakte Übereinstimmung erforderlich** — der Wert muss exakt dem übergeordneten Datensatz entsprechen
2. **Nur EINEN eindeutigen Bezeichner zuordnen** — geben Sie nicht sowohl `companyId` als auch `companyDomain` an
3. **Groß-/Kleinschreibung beachten** — `Acme.com` ≠ `acme.com`
## Schritt 6: Beziehung hochladen und zuordnen
1. Navigieren Sie zum untergeordneten Objekt (z. B. Personen)
2. Klicken Sie auf **⋮** → **Datensätze importieren**
3. Laden Sie Ihre CSV-Datei hoch
4. Im Schritt zur Feldzuordnung:
* Suchen Sie Ihre Beziehungsspalte (z. B. `companyDomain`)
* Ordnen Sie sie dem **Company**-Beziehungsfeld zu
5. Schließen Sie die übrige Zuordnung ab
6. Prüfen Sie Fehler und bestätigen Sie
Twenty verknüpft automatisch jeden untergeordneten Datensatz mit dem passenden übergeordneten Datensatz.
## Schritt 7: Überprüfen Sie den Import
Nach dem Import:
1. Öffnen Sie einige untergeordnete Datensätze (z. B. Personen)
2. Überprüfen Sie, ob das Beziehungsfeld das richtige übergeordnete Objekt anzeigt (z. B. Unternehmen)
3. Öffnen Sie einen übergeordneten Datensatz und prüfen Sie den Bereich mit den zugehörigen Datensätzen
## Häufige Fehler, die Sie vermeiden sollten
| Fehler | Problem | Lösung |
| ------------------------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------------- |
| **Falsche Importreihenfolge** | Personen vor Unternehmen importieren | Importieren Sie immer zuerst übergeordnete, dann untergeordnete Datensätze |
| **Falsches Domain-Format** | Verwendung von `acme.com` statt `https://acme.com` | Verwenden Sie das vollständige URL-Format mit `https://` |
| **Mehrere eindeutige Felder** | Zuordnung sowohl von `companyId` als auch `companyDomain` | Ordnen Sie nur EINEN eindeutigen Bezeichner zu |
| **Beziehungsfeld fehlt** | Das Beziehungsfeld existiert nicht im Datenmodell | Erstellen Sie es vor dem Import unter **Einstellungen → Datenmodell** |
| **Nicht vorhandene Datensätze** | Der übergeordnete Datensatz existiert in Twenty nicht | Importieren Sie zunächst übergeordnete Datensätze oder prüfen Sie auf Tippfehler |
| **Unterschiedliche Groß-/Kleinschreibung** | `Acme.com` in der Datei, aber `acme.com` in Twenty | Achten Sie auf exakt übereinstimmende Groß-/Kleinschreibung |
## Verknüpfen mit Teammitgliedern
Beim Verknüpfen mit Teammitgliedern (Ihrem Team):
* Verwenden Sie ihre **E-Mail-Adresse**, nicht ihren Namen
* Beispiel: `owner@yourcompany.com`, nicht "John Smith"
```csv
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com
```
## FAQ
<AccordionGroup>
<Accordion title="Was ist, wenn mein übergeordneter Datensatz keine Domain oder E-Mail hat?">
Sie haben zwei Optionen:
1. Verwenden Sie die Twenty-`id` (exportieren Sie übergeordnete Datensätze, um ihre IDs zu erhalten)
2. Erstellen Sie ein benutzerdefiniertes eindeutiges Feld in Ihrem Datenmodell, um eine externe ID aus Ihrem vorherigen System zu speichern
</Accordion>
<Accordion title="Kann ich Beziehungen bei bestehenden Datensätzen aktualisieren?">
Ja! Geben Sie den eindeutigen Bezeichner des untergeordneten Datensatzes (z. B. `email` für Personen) und den neuen Beziehungswert an. Beim Import wird die Beziehung aktualisiert.
</Accordion>
<Accordion title="Kann ich Viele-zu-Viele-Beziehungen importieren?">
Viele-zu-Viele-Beziehungen werden beim Import noch nicht unterstützt. Dies ist für H1 2026 geplant.
</Accordion>
<Accordion title="Kann ich mit mehreren Objekttypen verknüpfen (z. B. Notizen mit Personen UND Unternehmen)?">
Beziehungen, die auf mehrere Objekttypen zeigen, werden für Import/Export noch nicht unterstützt. Dies steht auf unserer Roadmap.
</Accordion>
<Accordion title="Was passiert, wenn ein übergeordneter Datensatz nicht existiert?">
Der Import zeigt für diese Zeile einen Fehler an. Sie können entweder:
* Importieren Sie zuerst den übergeordneten Datensatz und importieren Sie dann erneut
* Korrigieren Sie den Referenzwert
* Entfernen Sie die Zeile aus dem Import
</Accordion>
<Accordion title="Warum wird meine Beziehung nicht korrekt verknüpft?">
Häufige Ursachen:
* Falsches Format (verwenden Sie für Domains `https://domain.com`)
* Abweichende Groß-/Kleinschreibung (prüfen Sie die exakte Schreibweise)
* Übergeordneter Datensatz existiert nicht (zuerst übergeordnete Datensätze importieren)
* Zuordnung mehrerer Bezeichner (verwenden Sie nur einen)
</Accordion>
</AccordionGroup>
<Warning>
**Denken Sie daran: soft gelöschte Datensätze zählen für die Eindeutigkeit.**
Wenn Sie "not found"-Fehler erhalten, der Datensatz aber zu existieren scheint, prüfen Sie im Befehlsmenü → Gelöschte Datensätze anzeigen. Der übergeordnete Datensatz wurde möglicherweise soft gelöscht.
</Warning>
## Fehlerbehebung
Gibt es Probleme? Prüfen Sie:
* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
* [Funktionen zum Import von Beziehungen](/l/de/user-guide/data-migration/capabilities/import-relations)
* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)

View File

@@ -0,0 +1,289 @@
---
title: Migration von anderen CRMs
description: Schritt-für-Schritt-Anleitung zur Migration Ihrer Daten von jedem CRM zu Twenty.
---
## Übersicht
Diese Anleitung führt Sie durch die Migration Ihrer Daten von jedem CRM zu Twenty. Der Prozess umfasst die Überprüfung Ihrer Daten, die Vorbereitung Ihres Twenty-Arbeitsbereichs, den Export aus Ihrem aktuellen System und den Import in Twenty.
<Note>Ansichten, Workflows und Berechtigungen müssen nach der Migration manuell neu erstellt werden. Planen Sie Zeit für diese Konfigurationsarbeiten ein.</Note>
## Schritt 1: Überprüfen Sie Ihre aktuellen Daten
Eine Migration ist eine Chance für einen Neuanfang. Übernehmen Sie keinen Ballast.
**Was Sie behalten sollten:**
* Aktive Kontakte und Unternehmen
* Offene Opportunities und Deals
* Wichtige Notizen und Aktivitäten
* Benutzerdefinierte Felder, die Sie tatsächlich verwenden
**Was Sie zurücklassen sollten:**
* Veraltete Kontakte (keine Aktivität seit über 2 Jahren)
* Doppelte Datensätze
* Testdaten
* Nicht verwendete benutzerdefinierte Felder
## Schritt 2: Ihr Datenmodell abbilden
Erstellen Sie ein Zuordnungsdokument zwischen Ihrem aktuellen CRM und Twenty:
| Ihr CRM | Twenty |
| -------------------------- | ------------------------------ |
| Konto / Organisation | **Unternehmen** |
| Kontakt / Person | **Personen** |
| Deal / Opportunity | **Opportunity** |
| Aktivität | **Aufgabe** oder **Notiz** |
| Benutzerdefiniertes Objekt | **Benutzerdefiniertes Objekt** |
**Dokumentieren Sie für jedes Feld:**
* Name des Quellfelds
* Das Zielfeld in Twenty
* Erforderliche Formatumwandlungen (Datumsangaben, Telefonnummern usw.)
<Note>Halten Sie dieses Mapping-Dokument während des Imports griffbereit — Sie werden darauf verweisen, wenn Sie Spalten zuordnen.</Note>
## Schritt 3: Richten Sie Ihren Twenty-Arbeitsbereich ein
Bereiten Sie Ihren Twenty-Arbeitsbereich vor, bevor Sie Daten importieren:
### Benutzerdefinierte Objekte und Felder erstellen
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Erstellen Sie alle benötigten benutzerdefinierten Objekte
3. Fügen Sie Standard- und benutzerdefinierten Objekten benutzerdefinierte Felder hinzu
4. Konfigurieren Sie die Feldeinstellungen (eindeutig, erforderlich, Auswahloptionen usw.)
<Warning>
**Felder müssen vor dem Import vorhanden sein.**
Der CSV-Import erstellt Datensätze, nicht Felder. Erstellen Sie alle benutzerdefinierten Felder vor dem Import unter Einstellungen → Datenmodell.
</Warning>
### Laden Sie Ihr Team ein
<Warning>
**Laden Sie Benutzer ein, BEVOR Sie Daten importieren.**
Wenn Ihre Daten Benutzerreferenzen enthalten (Account Owner, Assignee usw.), müssen diese Benutzer vor dem Import in Twenty existieren. Andernfalls können diese Beziehungen nicht zugeordnet werden.
</Warning>
1. Gehen Sie zu **Einstellungen → Mitglieder**
2. Laden Sie alle Teammitglieder ein
3. **Warten Sie, bis alle** ihre Einladung angenommen haben
4. Überprüfen Sie, ob alle Benutzer in Ihrer Mitgliederliste erscheinen
## Schritt 4: Export aus Ihrem aktuellen CRM
Exportieren Sie Ihre Daten aus Ihrem aktuellen CRM:
1. Suchen Sie nach einer **Export**-Funktion (in der Regel unter Einstellungen, Datenverwaltung oder Admin)
2. Exportieren Sie nach Möglichkeit im **CSV-Format**
3. Exportieren Sie jeden Objekttyp separat (Unternehmen, Kontakte, Deals usw.)
4. Schließen Sie alle Felder ein, die Sie migrieren möchten
**Exportieren Sie diese Objekte (zur Referenz in dieser Reihenfolge):**
1. Unternehmen / Konten / Organisationen
2. Kontakte / Personen
3. Deals / Opportunities
4. Notizen und Aktivitäten
5. Benutzerdefinierte Objekte
## Schritt 5: Daten bereinigen und formatieren
Öffnen Sie jede exportierte CSV in einer Tabellenkalkulationsanwendung und bereiten Sie sie für Twenty vor.
### Duplikate entfernen
1. Sortieren Sie nach dem eindeutigen Feld (E-Mail für Personen, Domain für Unternehmen)
2. Doppelte Zeilen entfernen oder zusammenführen
3. Überprüfen Sie, dass in Twenty keine Duplikate vorhanden sind
### Felder korrekt formatieren
| Feldtyp | Erforderliches Format |
| ----------------- | ------------------------------------------------ |
| **Domain** | `https://domain.com` |
| **E-Mail** | `name@domain.com` (muss eindeutig sein) |
| **Datum** | `YYYY-MM-DD` |
| **Telefon** | Drei Spalten: Nummer, Ländercode, Telefonvorwahl |
| **Boolesch** | `TRUE` oder `FALSE` (in Großbuchstaben) |
| **Auswahlfelder** | Verwenden Sie API-Namen, nicht Anzeigenamen |
<Warning>
**Das Domain-Format ist entscheidend.**
Verwenden Sie `https://domain.com` (nicht `domain.com` oder `www.domain.com`). Dies entspricht dem Format von Twenty und verhindert Duplikate, wenn Sie die E-Mail-/Kalendersynchronisierung verbinden.
</Warning>
Siehe [So bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files) für vollständige Formatierungsanforderungen für alle Feldtypen.
### Beziehungsspalten hinzufügen
Um Datensätze zu verknüpfen (z. B. Personen mit Unternehmen), fügen Sie eine Spalte mit dem eindeutigen Bezeichner des übergeordneten Elements hinzu.
**Beispiel: People-CSV mit Unternehmensverknüpfung**
```csv
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
Siehe [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) für detaillierte Anweisungen zum Verknüpfen von Datensätzen.
### Benutzerreferenzen aktualisieren
Wenn Ihre Daten Benutzerzuweisungen enthalten (Eigentümer, Zuständiger):
1. Fügen Sie eine Spalte mit der **E-Mail des Benutzers** hinzu (nicht nur dessen ID aus dem Altsystem)
2. Verwenden Sie dieselben E-Mail-Adressen, mit denen die Benutzer Ihrem Twenty-Arbeitsbereich beigetreten sind
Siehe [So bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files) für den vollständigen Formatierungsleitfaden.
## Schritt 6: In Twenty importieren
<Warning>
**Die Importreihenfolge ist wichtig!**
Importieren Sie immer in dieser Reihenfolge:
1. Zuerst **Unternehmen** (keine Abhängigkeiten)
2. **Personen** an zweiter Stelle (mit Unternehmen verknüpfen)
3. **Opportunities** an dritter Stelle (mit Unternehmen/Personen verknüpfen)
4. **Notizen und Aufgaben** (mit Datensätzen verknüpfen)
5. **Benutzerdefinierte Objekte** entsprechend ihren Abhängigkeiten
Der übergeordnete Datensatz muss existieren, bevor Sie darauf verweisen können.
</Warning>
### Jedes Objekt importieren
Führen Sie Folgendes der Reihe nach für jede CSV-Datei aus:
1. Navigieren Sie zum Objekt in Twenty
2. Klicken Sie auf **⋮ → Datensätze importieren**
3. Laden Sie die CSV-Datei hoch
4. Ordnen Sie die Spalten den Feldern zu:
* Ordnen Sie die E-Mail-Spalten der Benutzer den entsprechenden Beziehungsfeldern zu
* Ordnen Sie Beziehungsspalten (wie `companyDomain`) den Beziehungsfeldern zu
5. Überprüfen und beheben Sie eventuelle Fehler in der Benutzeroberfläche
6. Bestätigen Sie den Import
7. Überprüfen Sie einige Datensätze, bevor Sie mit der nächsten Datei fortfahren
**Detaillierte Anleitungen:**
* [So importieren Sie Unternehmen](/l/de/user-guide/data-migration/how-tos/import-companies-via-csv)
* [So importieren Sie Kontakte](/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
## Schritt 7: Große Migrationen (50.000+ Datensätze)
Für große Migrationen:
| Datenmenge | Empfohlener Ansatz |
| ------------------------ | -------------------------------- |
| Unter 10.000 Datensätzen | Einzelner CSV-Import |
| 10.000–50.000 Datensätze | In mehrere CSV-Dateien aufteilen |
| Über 50.000 Datensätze | Verwenden Sie die API |
**Für API-Importe:**
* Schneller und zuverlässiger für große Datensätze
* Unterstützt Batch-Operationen (bis zu 60 Datensätze pro Aufruf)
* Siehe [So importieren Sie Daten über die API](/l/de/user-guide/data-migration/how-tos/import-data-via-api)
## Schritt 8: Einrichtung nach der Migration
Schließen Sie nach dem Import der Daten die Konfiguration Ihres Arbeitsbereichs ab:
### Ansichten neu erstellen
* Richten Sie gespeicherte Ansichten mit Filtern, Sortierungen und Spaltenkonfigurationen ein
* Erstellen Sie alle benötigten Kanban- oder Kalenderansichten
### Workflows neu erstellen
* Erstellen Sie Ihre Automatisierungen in **Einstellungen → Workflows** neu
* Beginnen Sie mit den kritischsten Workflows
* Testen Sie jeden Workflow, bevor Sie sich darauf verlassen
### Rollen und Berechtigungen konfigurieren
* Richten Sie Rollen unter **Einstellungen → Mitglieder → Rollen** ein
* Weisen Sie Benutzer den entsprechenden Rollen zu
### E-Mail und Kalender verbinden
* Jeder Benutzer verbindet sein eigenes Konto unter **Einstellungen → Konten**
* Twenty beginnt, E-Mails mit Kontaktdatensätzen zu synchronisieren
* Siehe [E-Mail & Kalender](/l/de/user-guide/calendar-emails/overview)
### Schulen Sie Ihr Team
* Gehen Sie die neue Oberfläche gemeinsam durch
* Dokumentieren Sie alle teamspezifischen Prozesse
## Häufige Probleme und Lösungen
| Problem | Ursache | Lösung |
| ----------------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| **Duplikatfehler** | E-Mail/Domain existiert bereits | Entfernen Sie Duplikate aus der Datei oder fügen Sie einen eindeutigen Bezeichner hinzu, um vorhandene Datensätze zu aktualisieren |
| **Beziehung nicht gefunden** | Übergeordneter Datensatz existiert nicht | Importieren Sie zuerst übergeordnete Objekte (Unternehmen vor Personen) |
| **Fehlende Felder** | Benutzerdefiniertes Feld existiert nicht | Erstellen Sie das Feld vor dem Import unter Einstellungen → Datenmodell |
| **Fehler bei Auswahlfeldern** | Verwendung von Anzeigenamen | Verwenden Sie API-Namen (aktivieren Sie den erweiterten Modus in den Einstellungen, um sie zu finden) |
| **Benutzerbeziehung leer** | Benutzer hat Einladung nicht angenommen | Stellen Sie sicher, dass alle Benutzer ihre Einladungen annehmen, bevor Sie Daten importieren |
Siehe [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors) für detaillierte Schritte zur Fehlerbehebung.
## Checkliste nach der Migration
### Datenintegrität
<Check>Alle Datensätze importiert (Anzahlen mit Quellsystem vergleichen)</Check>
<Check>Beziehungen funktionieren korrekt (Personen mit Unternehmen verknüpft)</Check>
<Check>Benutzerzuweisungen korrekt zugeordnet (Eigentümer, Zuständiger)</Check>
<Check>Benutzerdefinierte Felder befüllt</Check>
<Check>Keine unerwarteten Duplikate</Check>
### Konfiguration
<Check>Ansichten neu erstellt</Check>
<Check>Workflows neu erstellt und getestet</Check>
<Check>Rollen und Berechtigungen konfiguriert</Check>
<Check>E-Mail-/Kalendersynchronisierung verbunden</Check>
### Bereitschaft des Teams
<Check>Team für neues System geschult</Check>
<Check>Zugriffsplan für altes CRM entschieden (zur Referenz behalten? Wann deaktivieren?)</Check>
## FAQ
<AccordionGroup>
<Accordion title="Kann ich Workflows automatisch migrieren?">
Derzeit nicht. Workflows müssen in Twenty manuell neu erstellt werden.
</Accordion>
<Accordion title="Was ist mit Dateianhängen?">
Dateianhänge sind in CSV-Exporten nicht enthalten. Sie müssen sie manuell erneut hochladen, über die API migrieren oder unser Team für Unterstützung kontaktieren.
</Accordion>
<Accordion title="Kann ich während der Migration beide Systeme weiter betreiben?">
Ja, wir empfehlen, Ihr altes CRM weiter zu betreiben, bis Sie überprüft haben, dass die Migration abgeschlossen ist. Achten Sie einfach darauf, nicht an beiden Orten neue Daten zu erstellen.
</Accordion>
<Accordion title="Wie lange dauert die Migration normalerweise?">
Das hängt von der Datenmenge und der Komplexität ab. Kleine Migrationen (unter 10.000 Datensätzen) können in wenigen Stunden durchgeführt werden. Große Migrationen können mehrere Tage dauern, einschließlich Datenbereinigung und Tests.
</Accordion>
</AccordionGroup>
## Brauchen Sie Hilfe?
<Tip>
Möchten Sie Hilfe bei Ihrer Migration? [Finde einen zertifizierten Zwanzig Partner](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm), um deine Daten, Pipelines und Benutzer end-to-end zu bewegen.
</Tip>

View File

@@ -0,0 +1,173 @@
---
title: Migration von Selbstgehostet zu Cloud
description: Schritt-für-Schritt-Anleitung zur Migration Ihrer selbstgehosteten Twenty-Instanz zu Twenty Cloud.
---
## Übersicht
Diese Anleitung führt Sie durch die Migration Ihrer Daten von einer selbstgehosteten Twenty-Instanz zu Twenty Cloud. Der Prozess umfasst das Einrichten Ihres Cloud-Arbeitsbereichs, das Exportieren Ihrer Daten und deren erneutes Importieren.
<Note>Ansichten, Workflows und Rollen müssen nach der Migration manuell neu erstellt werden. Planen Sie Zeit für diese Konfigurationsarbeiten ein.</Note>
## Schritt 1: Erstellen Sie Ihren Cloud-Arbeitsbereich
1. Gehen Sie zu [app.twenty.com](https://app.twenty.com) und erstellen Sie einen neuen Arbeitsbereich
2. Schließen Sie den Einrichtungsassistenten ab
3. Notieren Sie sich die URL Ihres neuen Arbeitsbereichs
## Schritt 2: Datenmodell neu erstellen
Erstellen Sie vor dem Import der Daten Ihre benutzerdefinierten Objekte und Felder neu:
1. Gehen Sie in Ihrer Cloud-Instanz zu **Einstellungen → Datenmodell**
2. Erstellen Sie benutzerdefinierte Objekte, die Ihrer selbstgehosteten Konfiguration entsprechen
3. Fügen Sie Standard- und benutzerdefinierten Objekten benutzerdefinierte Felder hinzu
4. Konfigurieren Sie die Feldeinstellungen (eindeutig, erforderlich usw.)
<Note>Machen Sie Screenshots Ihres selbstgehosteten Datenmodells als Referenz oder halten Sie beide Instanzen nebeneinander geöffnet.</Note>
## Schritt 3: Alle Benutzer einladen
<Warning>
**Wichtig: Laden Sie Benutzer ein, BEVOR Sie Daten importieren.**
Benutzer müssen ihre Einladungen annehmen, bevor Sie Datensätze importieren, die auf sie verweisen (z. B. das Feld 'Account Owner'). Wenn Benutzer noch nicht vorhanden sind, können diese Beziehungen nicht zugeordnet werden.
</Warning>
1. Gehen Sie in Ihrer Cloud-Instanz zu **Einstellungen → Mitglieder**
2. Laden Sie alle Teammitglieder ein, die in der selbstgehosteten Instanz Konten hatten
3. **Warten Sie, bis alle** ihre Einladung angenommen haben
4. Überprüfen Sie, ob alle Benutzer in Ihrer Mitgliederliste erscheinen
## Schritt 4: Daten aus der selbstgehosteten Instanz exportieren
Exportieren Sie jedes Objekt aus Ihrer selbstgehosteten Instanz:
1. Navigieren Sie zu jedem Objekt (Unternehmen, Personen, Opportunities usw.)
2. Konfigurieren Sie die Ansicht so, dass **alle Spalten** angezeigt werden, die Sie migrieren möchten
3. Klicken Sie auf **⋮ → Ansicht exportieren**
4. Speichern Sie jede CSV-Datei mit einem eindeutigen Namen (z. B. `companies-export.csv`)
**Exportieren Sie in dieser Reihenfolge** (als Referenz für den Import):
1. Unternehmen
2. Personen
3. Opportunities
4. Benutzerdefinierte Objekte (entsprechend ihren Abhängigkeiten)
5. Aufgaben, Notizen
## Schritt 5: Verweise auf Arbeitsbereichsmitglieder aktualisieren
Die exportierten CSVs enthalten Benutzer-IDs aus Ihrer selbstgehosteten Instanz. Diese IDs stimmen nicht mit Ihrer Cloud-Instanz überein, daher müssen Sie sie durch E-Mail-Adressen ersetzen.
**Für jede CSV-Datei mit Benutzerverweisen (Owner, Assignee usw.):**
1. Öffnen Sie die CSV-Datei in einem Tabellenkalkulationsprogramm
2. Fügen Sie neben jeder Benutzer-ID-Spalte eine neue Spalte hinzu (z. B. `accountOwnerEmail` neben `accountOwnerId`)
3. Tragen Sie die **E-Mail-Adresse** jedes Benutzers ein
4. Sie können die alte ID-Spalte löschen oder belassen (sie wird beim Import übersprungen)
**Beispiel:**
Vor:
```csv
name,domain,accountOwnerId
Acme Corp,https://acme.com,old-uuid-123
```
Nach:
```csv
name,domain,accountOwnerEmail
Acme Corp,https://acme.com,john@yourcompany.com
```
<Note>Verwenden Sie dieselben E-Mail-Adressen, mit denen die Benutzer die Einladung zu Ihrem Cloud-Arbeitsbereich angenommen haben.</Note>
## Schritt 6: Importreihenfolge planen
Importieren Sie die Dateien in der richtigen Reihenfolge, um Beziehungen beizubehalten:
1. Zuerst **Unternehmen** (keine Abhängigkeiten)
2. **Personen** an zweiter Stelle (mit Unternehmen verknüpft)
3. **Opportunities** an dritter Stelle (mit Unternehmen und Personen verknüpft)
4. **Benutzerdefinierte Objekte** (entsprechend ihren Abhängigkeiten)
5. Zuletzt **Aufgaben und Notizen** (mit anderen Datensätzen verknüpft)
Siehe [So importieren Sie Beziehungen](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) für Details zum Beibehalten von Beziehungen.
## Schritt 7: In die Cloud importieren
Führen Sie Folgendes der Reihe nach für jede CSV-Datei aus:
1. Navigieren Sie in Ihrer Cloud-Instanz zum Objekt
2. Klicken Sie auf **⋮ → Datensätze importieren**
3. Laden Sie die CSV-Datei hoch
4. Ordnen Sie die Spalten den Feldern zu:
* Ordnen Sie die E-Mail-Spalten der Benutzer den entsprechenden Beziehungsfeldern zu
* Ordnen Sie andere Spalten wie üblich zu
5. Überprüfen und beheben Sie eventuelle Fehler
6. Bestätigen Sie den Import
7. Überprüfen Sie einige Datensätze, bevor Sie mit der nächsten Datei fortfahren
## Schritt 8: Konfiguration neu erstellen
Erstellen Sie nach dem Import der Daten manuell neu:
### Ansichten
* Erstellen Sie gespeicherte Ansichten mit Filtern, Sortierungen und Spaltenkonfigurationen neu
* Richten Sie ggf. Kanban- oder Kalenderansichten ein
### Workflows
* Erstellen Sie Automatisierungen in **Einstellungen → Workflows** neu
* Testen Sie jeden Workflow, bevor Sie sich darauf verlassen
### Rollen und Berechtigungen
* Richten Sie Rollen unter **Einstellungen → Mitglieder → Rollen** ein
* Weisen Sie Benutzer den entsprechenden Rollen zu
### Integrationen
* Stellen Sie für jeden Benutzer die E-Mail- und Kalendersynchronisierung wieder her
* Konfigurieren Sie alle API-Integrationen mit neuen API-Schlüsseln neu
## Checkliste nach der Migration
<Check>Alle Daten erfolgreich importiert</Check>
<Check>Beziehungen zwischen Objekten funktionieren korrekt</Check>
<Check>Benutzerzuweisungen (Owner, Assignee) korrekt zugeordnet</Check>
<Check>Ansichten neu erstellt</Check>
<Check>Workflows neu erstellt und getestet</Check>
<Check>Rollen und Berechtigungen konfiguriert</Check>
<Check>E-Mail-/Kalendersynchronisierung wiederhergestellt</Check>
<Check>API-Integrationen mit neuen Schlüsseln aktualisiert</Check>
## FAQ
<AccordionGroup>
<Accordion title="Kann ich Workflows automatisch migrieren?">
Derzeit nicht. Workflows müssen in Ihrer Cloud-Instanz manuell neu erstellt werden.
</Accordion>
<Accordion title="Was ist mit Dateianhängen und Bildern?">
Dateianhänge sind in CSV-Exporten nicht enthalten. Sie müssen Anhänge manuell erneut hochladen, sie über die API migrieren oder unser Team für Unterstützung bei großen Migrationen kontaktieren.
</Accordion>
<Accordion title="Kann ich während der Migration beide Instanzen weiter betreiben?">
Ja, wir empfehlen, Ihre selbstgehostete Instanz weiter auszuführen, bis Sie überprüft haben, dass die Cloud-Migration abgeschlossen ist. Achten Sie darauf, nicht an beiden Orten neue Daten zu erstellen.
</Accordion>
<Accordion title="Was ist, wenn ein Benutzer seine Einladung noch nicht angenommen hat?">
Datensätze, die sich auf diesen Benutzer beziehen, werden nicht importiert oder die Beziehung bleibt leer. Stellen Sie sicher, dass alle Benutzer ihre Einladungen annehmen, bevor Sie Daten importieren.
</Accordion>
</AccordionGroup>
## Brauchen Sie Hilfe?
<Tip>
Migrieren Sie einen großen oder komplexen Workspace? [Holen Sie sich einen zertifizierten Twenty-Partner](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud), der den Umzug Ende-zu-Ende übernimmt. *(Oder binden Sie unser Team ein: [contact@twenty.com](mailto:contact@twenty.com).)*
</Tip>

View File

@@ -0,0 +1,267 @@
---
title: CSV-Dateien vorbereiten
description: Vollständige Schritt-für-Schritt-Anleitung zum Formatieren deiner Daten für den Import in Twenty.
---
## Übersicht
Diese Anleitung führt dich durch die Vorbereitung deiner CSV-Datei für einen erfolgreichen Import. Befolge diese Schritte, um Fehler zu vermeiden.
## Schritt 1: Dateianforderungen prüfen
Bevor du beginnst, stelle sicher, dass deine Datei diese Anforderungen erfüllt:
| Anforderung | Details |
| ---------------------- | --------------------------- |
| **Format** | CSV, XLSX oder XLS |
| **Größenbeschränkung** | 10.000 Datensätze pro Datei |
| **Zeichenkodierung** | UTF-8 empfohlen |
| **Struktur** | Ein Objekttyp pro Datei |
<Note>Für Datenmengen mit mehr als 10.000 Datensätzen teile die Daten in mehrere Dateien auf oder verwende den [API-Import](/l/de/user-guide/data-migration/how-tos/import-data-via-api).</Note>
## Schritt 2: Beispieldatei herunterladen
**Dies ist der wichtigste Schritt.** Die Beispieldatei zeigt dir die exakten Spaltennamen und das Format, das Twenty erwartet.
1. Wechsle zur Objektansicht (Personen, Unternehmen usw.)
2. Klicke auf **⋮** → **Datensätze importieren**
3. Klicke auf **Beispieldatei herunterladen**
4. Verwende diese Datei als Vorlage
<Note>**Profi-Tipp:** Exportiere stattdessen einige vorhandene Datensätze. So erhältst du reale Beispiele dafür, wie Daten formatiert sein sollten, und die Spaltennamen werden beim Import automatisch zugeordnet.</Note>
## Schritt 3: Doppelte Werte entfernen
Twenty erzwingt die Eindeutigkeit bestimmter Felder. Duplikate führen zu Importfehlern.
| Objekt | Eindeutige Felder |
| ------------------------------ | --------------------------------------------------------- |
| **Personen** | `id`, `email` |
| **Unternehmen** | `id`, `domain` |
| **Benutzerdefinierte Objekte** | `id`, plus jedes Feld, das du als eindeutig markiert hast |
**Vor dem Import:**
1. Sortiere deine Tabelle nach dem eindeutigen Feld (E-Mail oder Domain)
2. Entferne oder führe doppelte Zeilen zusammen
3. Prüfe auf Duplikate, die in Twenty bereits existieren
<Warning>**Softgelöschte Datensätze zählen für die Eindeutigkeit.** Datensätze unter Befehlsmenü → Gelöschte Datensätze anzeigen führen zu Duplikatfehlern. Lösche sie dauerhaft oder stelle sie wieder her und aktualisiere sie.</Warning>
## Schritt 4: Jeden Feldtyp korrekt formatieren
Verschiedene Feldtypen erfordern spezifische Formate. Hier ist die vollständige Übersicht:
### Textfelder
* Keine spezielle Formatierung erforderlich
* Führende und nachgestellte Leerzeichen werden automatisch entfernt
### E-Mail-Felder
* Muss ein gültiges E-Mail-Format haben: `name@domain.com`
* Muss eindeutig sein (keine Duplikate in der Datei oder in Twenty)
* Für zusätzliche E-Mails verwende dieses Format in der Spalte **Emails / Additional Emails**:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### Domain-Felder
* **Empfohlenes Format**: `https://domain.com`
* Dies entspricht dem Format der Postfach-/Kalendersynchronisierung (verhindert Duplikate)
* Beide Spalten ausfüllen:
* **Domain / Domain Label**: `domain.com`
* **Domain / Domain URL**: `https://domain.com`
* Muss innerhalb deiner Datei und in Twenty eindeutig sein
### Telefonfelder
Telefon ist ein **verschachteltes Feld**, das mehrere Spalten benötigt:
| Spalte | Beispiel |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### Adressfelder
Adresse ist ein **verschachteltes Feld** mit mehreren Spalten (einige können leer bleiben):
* **Adresse / Adresse 1**: Straßenadresse Zeile 1
* **Adresse / Adresse 2**: Straßenadresse Zeile 2 (optional)
* **Adresse / Stadt**: Stadtname
* **Adresse / Bundesland**: Bundesstaat oder Provinz
* **Adresse / Land**: Name des Landes
* **Adresse / Postleitzahl**: Postleitzahl/ZIP-Code
### Datumsfelder
Verwenden Sie in Ihrer Datei ein einheitliches Format:
* `YYYY-MM-DD` (empfohlen): `2024-03-15`
* ISO 8601: `2024-03-15T10:30:00Z`
### Zahlenfelder
* Nur Zahlen (kein Text)
* Verwenden Sie den Punkt für Dezimalstellen: `1234.56`
* Keine Tausendertrennzeichen (nicht `1,234.56`)
### Währungsfelder
Währung ist ein **verschachteltes Feld** und erfordert zwei Spalten, die **beide ausgefüllt werden müssen**:
| Spalte | Beispiel |
| -------------------- | --------- |
| **Betrag / Betrag** | `1234.56` |
| **Betrag / Währung** | `USD` |
### Boolesche Felder
Großschreibung verwenden: `TRUE` oder `FALSE`
<Warning>Kleinschreibung `true` oder `false` funktioniert nicht.</Warning>
### Auswahlfelder
Verwenden Sie den **API-Namen** der Option, nicht den Anzeigenamen.
**So finden Sie API-Namen:**
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt und das Feld aus
3. Aktivieren Sie den **Erweiterten Modus** (Schalter unten rechts)
4. Kopieren Sie den API-Namen (z. B. `OPTION_1`, nicht "Option 1")
<Note>Neue Auswahloptionen werden nicht automatisch erstellt. Fügen Sie sie vor dem Import unter **Einstellungen → Datenmodell** hinzu.</Note>
### Mehrfachauswahlfelder
Verwenden Sie API-Namen im Array-Format:
```
["VALUE1","VALUE2"]
```
### Array-Felder
Verwenden Sie das JSON-Array-Format:
```
["value1","value2"]
```
### Bewertungsfelder
Verwenden Sie das Format: `RATING_1`, `RATING_2`, `RATING_3`, `RATING_4` oder `RATING_5`
### Links/URL-Felder
Füllen Sie beide Spalten aus:
* **Links / Link-Label**: `Twenty`
* **Links / Link-URL**: `https://twenty.com`
Für sekundäre Links verwenden Sie die Spalte **Links / Sekundäre Links**:
```
[{"url":"https://twenty.com","label":"Twenty"}]
```
### JSON-Felder
Verwenden Sie ein gültiges JSON-Format:
```
{"key":"value","key2":"value2"}
```
### ID-Felder
* **Optional**: Twenty erstellt IDs automatisch, wenn sie nicht angegeben werden
* **Format**: UUID (z. B. `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`)
* **Anwendungsfall**: ID angeben, um bestehende Datensätze zu aktualisieren, statt neue zu erstellen
## Schritt 5: Beziehungsspalten hinzufügen (bei Verknüpfung von Datensätzen)
Um Datensätze mit anderen Objekten zu verknüpfen (z. B. Personen mit Unternehmen), fügen Sie eine Spalte mit dem eindeutigen Bezeichner des zugehörigen Datensatzes hinzu.
**Beispiel**: Verknüpfung von Personen mit Unternehmen
Fügen Sie Ihrer Personen-CSV eine Spalte hinzu:
```
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
**Wichtige Regeln für Beziehungen:**
* Der übergeordnete Datensatz muss bereits in Twenty vorhanden sein
* Verwenden Sie das **Domain-URL**-Format (`https://domain.com`), nicht die Bezeichnung
* Ordnen Sie nur EINEN eindeutigen Bezeichner zu (nicht sowohl `companyId` ALS AUCH `companyDomain`)
* Für Workspace-Mitglieder verwenden Sie deren **E-Mail** (nicht den Namen)
<Warning>
**Die Importreihenfolge ist wichtig!**
Importieren Sie die "One"-Seite vor der "Many"-Seite:
1. **Unternehmen** zuerst
2. **Personen** als Zweites (mit Unternehmensreferenz)
3. **Opportunities** als Drittes
Der übergeordnete Datensatz muss vorhanden sein, bevor Sie darauf verweisen können.
</Warning>
Siehe [Beziehungen importieren](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) für detaillierte Anleitungen.
## Schritt 6: Sicherstellen, dass Felder in Twenty vorhanden sind
Der Import erstellt **Datensätze**, nicht **Felder**. Alle Felder, die Sie importieren möchten, müssen bereits in Ihrem Datenmodell vorhanden sein.
**Vor dem Import:**
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie Ihr Objekt aus
3. Erstellen Sie alle benötigten benutzerdefinierten Felder
4. Notieren Sie die exakten Feldnamen (sie müssen mit Ihren Spaltenüberschriften übereinstimmen)
## Schritt 7: Abschluss-Checkliste
Überprüfen Sie vor dem Hochladen Ihrer Datei:
<Check>Datei ist im CSV-, XLSX- oder XLS-Format</Check>
<Check>Datei enthält weniger als 10.000 Datensätze</Check>
<Check>Zeichencodierung ist UTF-8</Check>
<Check>Keine doppelten E-Mails (für Personen) oder Domains (für Unternehmen)</Check>
<Check>Datumsangaben verwenden durchgehend ein einheitliches Format</Check>
<Check>Domains verwenden das Format `https://domain.com`</Check>
<Check>Boolesche Felder verwenden `TRUE` oder `FALSE` (Großschreibung)</Check>
<Check>Auswahlfelder verwenden API-Namen, nicht Anzeigenamen</Check>
<Check>Alle benutzerdefinierten Felder existieren in Einstellungen → Datenmodell</Check>
<Check>Übergeordnete Datensätze vor untergeordneten Datensätzen importiert</Check>
<Check>Beziehungsspalten verweisen auf vorhandene Datensätze</Check>
## Häufige Fehler, die Sie vermeiden sollten
| Fehler | Lösung |
| ----------------------------------------------------- | -------------------------------------------------------------- |
| Verwendung von `true` statt `TRUE` | Boolesche Werte müssen in Großbuchstaben sein |
| Verwendung von Anzeigenamen für Auswahlfelder | API-Namen in den Einstellungen suchen und verwenden |
| Import von Personen vor Unternehmen | Importieren Sie stets zuerst die übergeordneten Objekte |
| Fehlender Währungscode für Währungsfelder | Sowohl die Spalte Betrag als auch die Spalte Währung ausfüllen |
| Falsches Domain-Format | `https://domain.com` konsequent verwenden |
| Zuordnung mehrerer eindeutiger Felder für Beziehungen | Nur EINES zuordnen (Domain ODER ID, nicht beides) |
## Nächste Schritte
Ihre Datei ist bereit! Jetzt:
* [Unternehmen importieren](/l/de/user-guide/data-migration/how-tos/import-companies-via-csv) (diese zuerst importieren)
* [Kontakte importieren](/l/de/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [Importfehler beheben](/l/de/user-guide/data-migration/how-tos/fix-import-errors)

View File

@@ -0,0 +1,198 @@
---
title: Vorhandene Datensätze per Import aktualisieren
description: Vollständige Schritt-für-Schritt-Anleitung zur Massenaktualisierung von Datensätzen per CSV-Import.
---
## Übersicht
Müssen Sie viele Datensätze auf einmal aktualisieren? Statt sie einzeln zu bearbeiten, verwenden Sie den CSV-Import, um vorhandene Datensätze massenhaft zu aktualisieren.
**Anwendungsfälle:**
* Positionsbezeichnungen für mehrere Personen aktualisieren
* Unternehmensinformationen in großem Umfang ändern
* Daten zu neuen benutzerdefinierten Feldern hinzufügen
* Datenfehler in vielen Datensätzen korrigieren
## Wie es funktioniert
Wenn Sie eine Datei importieren, die einen **eindeutigen Bezeichner** enthält, der mit einem vorhandenen Datensatz übereinstimmt, aktualisiert Twenty diesen Datensatz, anstatt ein Duplikat zu erstellen.
| Wenn der eindeutige Bezeichner... | Twenty wird... |
| ---------------------------------------------- | ------------------------------------------------------------------- |
| Stimmt mit einem vorhandenen Datensatz überein | **Aktualisiert** den vorhandenen Datensatz |
| Stimmt mit keinem Datensatz überein | **Erstellt** einen neuen Datensatz |
| Fehlt in Ihrer Datei | **Erstellt** einen neuen Datensatz (mit automatisch generierter ID) |
<Warning>
**Mehrfachauswahl-Felder werden überschrieben, nicht zusammengeführt.**
Wenn in einem Datensatz `Option A` und `Option B` ausgewählt sind und Sie `["Option C"]` importieren, hat der Datensatz nach dem Import nur noch `Option C`. Der Import ersetzt alle bisherigen Auswahlen — er fügt ihnen nichts hinzu.
Um vorhandene Werte beizubehalten, schließen Sie sie alle in Ihren Import ein: `["Option A","Option B","Option C"]`
</Warning>
## Schritt 1: Exportieren Sie Ihre aktuellen Daten
Exportieren Sie zunächst die Datensätze, die Sie aktualisieren möchten:
1. Navigieren Sie zum Objekt (Personen, Unternehmen usw.)
2. **Fügen Sie die benötigten Spalten hinzu** — klicken Sie auf **Optionen → Felder**, um die Felder anzuzeigen, die Sie aktualisieren möchten
3. **Filtern Sie bei Bedarf** — grenzen Sie auf genau die Datensätze ein, die Sie aktualisieren möchten
4. Klicken Sie auf **⋮** → **Ansicht exportieren**
5. Speichern Sie die CSV-Datei
<Note>**Warum zuerst exportieren?** Die exportierte Datei hat das richtige Format, enthält eindeutige Bezeichner und wird beim Import automatisch zugeordnet.</Note>
### Was exportiert wird
* Alle sichtbaren Spalten in Ihrer aktuellen Ansicht
* Die eindeutigen Bezeichner des Datensatzes (`id`, `email`, `domain`)
* Aktuelle Feldwerte, die Sie ändern können
## Schritt 2: Bearbeiten Sie die CSV-Datei
Öffnen Sie die exportierte Datei in Ihrer Tabellenkalkulation (Excel, Google Sheets usw.):
1. **Behalten Sie die Spalte mit dem eindeutigen Bezeichner bei** — löschen Sie `id`, `email` oder `domain` nicht
2. **Aktualisieren Sie die Werte** in den Spalten, die Sie ändern möchten
3. **Entfernen Sie Spalten, die Sie nicht aktualisieren müssen** (optional, aber übersichtlicher)
4. **Ändern Sie die Werte der eindeutigen Bezeichner nicht** — sonst erstellt Twenty neue Datensätze
### Beispiel: Aktualisieren von Positionsbezeichnungen
**Exportierte Datei:**
```csv
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
```
**Nach Ihren Änderungen:**
```csv
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
```
<Warning>
**Ändern Sie die Werte der eindeutigen Bezeichner nicht.**
Wenn Sie `john@acme.com` in `john.smith@acme.com` ändern, erstellt Twenty einen neuen Datensatz, anstatt den vorhandenen zu aktualisieren.
</Warning>
## Schritt 3: Importieren Sie die aktualisierte Datei
1. Navigieren Sie zum Objekt
2. Klicken Sie auf **⋮** → **Datensätze importieren**
3. Laden Sie Ihre bearbeitete CSV-Datei hoch
4. **Stellen Sie sicher, dass der eindeutige Bezeichner zugeordnet ist** — prüfen Sie, ob `email`, `domain` oder `id` korrekt zugeordnet ist
5. Überprüfen Sie die Feldzuordnungen
6. Auf Fehler prüfen
7. Klicken Sie auf **Bestätigen**
Twenty gleicht Datensätze anhand des eindeutigen Bezeichners ab und aktualisiert sie mit neuen Werten.
## Den richtigen eindeutigen Bezeichner wählen
| Objekt | Empfohlen | Alternative | Notizen |
| ------------------------------ | --------------------------- | ----------- | ------------------------------------------------------ |
| **Personen** | `e-Mail` | `id` | E-Mail ist menschenlesbar |
| **Unternehmen** | `domäne` | `id` | Domain ist menschenlesbar |
| **Benutzerdefinierte Objekte** | Beliebiges eindeutiges Feld | `id` | Verwenden Sie Ihr benutzerdefiniertes eindeutiges Feld |
<Note>**Verwenden Sie nur EINEN eindeutigen Bezeichner.** Ordnen Sie nicht sowohl `email` ALS AUCH `id` zu. Dies kann zu Verwirrung und Fehlern führen.</Note>
### Benutzerdefinierte eindeutige Felder verwenden
Wenn Sie ein benutzerdefiniertes Feld als eindeutig markiert haben (z. B. eine externe ID aus einem anderen System):
1. Schließen Sie dieses Feld in Ihren Export und Import ein
2. Ordnen Sie es beim Import zu
3. Twenty gleicht anhand dieses Feldes ab
## Schritt 4: Überprüfen Sie die Aktualisierungen
Nach dem Import:
1. Öffnen Sie einige aktualisierte Datensätze
2. Prüfen Sie, ob die Änderungen übernommen wurden
3. Stellen Sie sicher, dass keine doppelten Datensätze erstellt wurden
## Was ist mit Feldern, die nicht in Ihrer Datei enthalten sind?
**Felder, die nicht in Ihrer Importdatei enthalten sind, bleiben unverändert.**
| Ihre Datei enthält ... | Ergebnis |
| ---------------------------- | ------------------------------------------------------------------- |
| `email`, `jobTitle` | Nur `jobTitle` wird aktualisiert; andere Felder bleiben unverändert |
| `email`, `jobTitle`, `phone` | `jobTitle` und `phone` werden aktualisiert |
Das heißt, Sie müssen nur die Felder einschließen, die Sie ändern möchten (plus den eindeutigen Bezeichner).
## Aktualisierungen und neue Datensätze kombinieren
Sie können vorhandene Datensätze aktualisieren UND neue im selben Import erstellen:
```csv
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst ← Creates new (email doesn't match)
```
## Häufige Fehler, die Sie vermeiden sollten
| Fehler | Problem | Ergebnis | Lösung |
| ------------------------------------------ | -------------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------- |
| **Eindeutigen Bezeichner ändern** | `john@acme.com` in `john.smith@acme.com` geändert | Erstellt einen neuen Datensatz statt zu aktualisieren | Eindeutige Bezeichner unverändert lassen |
| **Mehrere eindeutige Felder** | Zuordnung sowohl von `email` ALS AUCH `id` | Mögliche Abgleichkonflikte | Ordnen Sie nur EINEN eindeutigen Bezeichner zu |
| **Kein eindeutiger Bezeichner** | Datei enthält nur `firstName`, `lastName`, `jobTitle` | Alle Zeilen erstellen neue Datensätze | Schließen Sie immer `email`, `domain` oder `id` ein |
| **Unterschiedliche Groß-/Kleinschreibung** | Datei enthält `John@acme.com`, aber Twenty hat `john@acme.com` | Erstellt neuen Datensatz | Exportieren Sie aus Twenty, um exakte Werte zu erhalten |
## FAQ
<AccordionGroup>
<Accordion title="Was ist, wenn einige Datensätze noch nicht existieren?">
Datensätze mit eindeutigen Bezeichnern, die nicht mit vorhandenen Datensätzen übereinstimmen, werden als neue Datensätze erstellt. So können Sie im selben Import aktualisieren und erstellen.
</Accordion>
<Accordion title="Kann ich einen Feldwert löschen/leeren?">
Ja, lassen Sie die Zelle in Ihrer CSV leer. Der Import löscht den Wert dieses Feldes im vorhandenen Datensatz.
</Accordion>
<Accordion title="Was passiert mit Feldern, die ich nicht in den Import aufnehme?">
Felder, die nicht in Ihrer Importdatei enthalten sind, bleiben in vorhandenen Datensätzen unverändert. Es werden nur die Felder aktualisiert, die Sie einschließen.
</Accordion>
<Accordion title="Kann ich Beziehungsfelder (z. B. Unternehmen) aktualisieren?">
Ja! Fügen Sie den eindeutigen Bezeichner der Beziehung hinzu (z. B. `companyDomain`) und ordnen Sie ihn dem Beziehungsfeld zu. Die Beziehung wird aktualisiert.
</Accordion>
<Accordion title="Woher weiß ich, welche Datensätze aktualisiert bzw. erstellt werden?">
Im Überprüfungsschritt des Imports zeigt Twenty Ihnen anhand der Übereinstimmungen der eindeutigen Bezeichner, wie viele Datensätze aktualisiert bzw. erstellt werden.
</Accordion>
<Accordion title="Kann ich eine Massenaktualisierung rückgängig machen?">
Es gibt kein automatisches Rückgängigmachen. Wir empfehlen, Ihre Daten vor Massenaktualisierungen als Sicherung zu exportieren.
</Accordion>
</AccordionGroup>
## Beste Praktiken
1. **Zuerst exportieren** — beginnen Sie immer mit einem Export, um das richtige Format sicherzustellen
2. **Vor dem Aktualisieren sichern** — exportieren Sie Ihre Daten, bevor Sie umfangreiche Änderungen vornehmen
3. **Mit einigen Datensätzen testen** — versuchen Sie zunächst, 5-10 Datensätze zu aktualisieren, bevor Sie eine große Menge verarbeiten
4. **Verwenden Sie menschenlesbare Bezeichner** — `email` und `domain` sind leichter zu überprüfen als `id`
5. **Nur notwendige Spalten einschließen** — weniger Spalten bedeuten geringere Fehlerwahrscheinlichkeit
## Fehlerbehebung
Gibt es Probleme? Prüfen Sie:
* [So beheben Sie Importfehler](/l/de/user-guide/data-migration/how-tos/fix-import-errors)
* [Eindeutigkeitsbeschränkungen](/l/de/user-guide/data-migration/capabilities/uniqueness-constraints)
* [Referenz zur Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping)

View File

@@ -0,0 +1,83 @@
---
title: Datenmigration
description: Importieren und exportieren Sie Ihre CRM-Daten über CSV-Dateien oder die API.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Importmethoden
Twenty unterstützt zwei Hauptmethoden zum Importieren von Daten:
| Methode | Am besten geeignet | Volumenlimit |
| -------------- | ------------------------------------------------- | --------------------------- |
| **CSV-Import** | Standardmigrationen, regelmäßige Aktualisierungen | 10.000 Datensätze pro Datei |
| **API-Import** | Groß angelegte Migrationen, Automatisierung | Unbegrenzt |
<Note>Für sehr große Datensätze (Hunderttausende von Datensätzen) verwenden Sie die API. Unsere [Implementierungspartner](/l/de/user-guide/getting-started/capabilities/implementation-services) können bei Bedarf diese Skripte ausführen.</Note>
## Grundlagen des CSV-Imports
Sie können Daten für jedes Objekt mit CSV-, XLSX- oder XLS-Dateien importieren. Jede Datei sollte **nur einen Objekttyp** enthalten (z. B. nur Personen-Datensätze).
<Note>**Felder müssen vor dem Import existieren.** Das Hochladen einer CSV erstellt Datensätze, erstellt jedoch keine Felder. Wenn Sie benutzerdefinierte Felder benötigen, erstellen Sie diese zuerst unter **Einstellungen → Datenmodell**.</Note>
### Schritte
1. Navigieren Sie zu dem Objekt, in das Sie Daten importieren möchten
2. Klicken Sie oben rechts auf das Symbol **⋮** (dies ist das Befehlsmenü) und klicken Sie auf **Datensätze importieren**
3. Laden Sie die Vorlagendatei herunter, um sicherzustellen, dass Ihre Daten im erwarteten Format vorliegen
4. Laden Sie Ihre formatierte CSV-Datei hoch
5. Ordnen Sie Ihre Spalten den Twenty-Feldern zu
6. Überprüfen Sie Fehler (gelb hervorgehoben) und beheben Sie sie, indem Sie sie direkt in der Benutzeroberfläche bearbeiten
7. Bestätigen Sie den Import
### Beziehungen zwischen Objekten importieren
Sie können Beziehungen zwischen Objekten mit der CSV-Importfunktion importieren. Sie müssen auf das verknüpfte Objekt über ein eindeutiges Feld dieses Objekts verweisen: die `id`, die `email` für Personen und Workspace-Mitglieder, die `domain` für Unternehmen, jedes andere im Datenmodell als eindeutig festgelegte Feld für andere Objekte.
<Note>**Gelöschte Datensätze zählen zur Eindeutigkeit.** Softgelöschte Datensätze (sichtbar unter Befehlsmenü → Gelöschte Datensätze anzeigen) werden in die Eindeutigkeitsprüfungen einbezogen. Wenn Sie einen Datensatz mit demselben eindeutigen Wert wie ein gelöschter Datensatz importieren, wird der gelöschte Datensatz wiederhergestellt.</Note>
<Warning>
**Die Importreihenfolge ist wichtig!**
Beim Import verknüpfter Objekte laden Sie die Dateien in dieser Reihenfolge hoch:
1. **Unternehmen** zuerst (die „one“-Seite der Beziehungen)
2. **Personen** an zweiter Stelle (über companyId mit Unternehmen verknüpft)
3. **Opportunities** an dritter Stelle (mit Unternehmen/Personen verknüpft)
4. **Benutzerdefinierte Objekte** mit Beziehungen zuletzt
Warum? Die „one“-Seite einer Eins-zu-viele-Beziehung muss existieren, bevor Sie darauf verweisen können. Beispielsweise muss der Unternehmensdatensatz existieren, bevor Sie eine Person mit der ID dieses Unternehmens importieren.
</Warning>
Weitere Informationen finden Sie in [diesem Artikel](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) mit einer Schritt-für-Schritt-Anleitung zum Vorgehen.
## Daten exportieren
Exportieren Sie die Daten Ihres Arbeitsbereichs für Backups, Berichte oder Migrationen.
### Schritte
1. Navigieren Sie zu dem Objekt, das Sie exportieren möchten
2. Konfigurieren Sie die Ansicht mit den benötigten Spalten
3. Klicken Sie auf **⋮** → **Ansicht exportieren**
4. Speichern Sie die CSV-Datei
<Note>**Nur sichtbare Spalten werden exportiert.** Die CSV-Datei enthält nur die Spalten, die in Ihrer aktuellen Ansicht angezeigt werden. Fügen Sie vor dem Export Spalten hinzu oder blenden Sie sie aus, um zu steuern, welche Daten enthalten sind.</Note>
<Note>**Exportgrenzen**: Bis zu 20.000 Datensätze pro Export.</Note>
## Berechtigungen
Datenimport und -export erfordern bestimmte Berechtigungen:
* **Import**: Erfordert die Berechtigung "Import CSV"
* **Export**: Erfordert die Berechtigung "Export CSV"
Wenden Sie sich an Ihren Arbeitsbereichsadministrator, wenn Sie diese Berechtigungen nicht haben.
## Nächste Schritte
* [Bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files)
* [Beziehungen zwischen Objekten importieren](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [Über die API für große Datensätze importieren](/l/de/user-guide/data-migration/how-tos/import-data-via-api)

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

View File

@@ -0,0 +1,72 @@
---
title: Benutzerdefinierte Felder erstellen
description: Schritt-für-Schritt-Anleitung zum Hinzufügen benutzerdefinierter Felder zu jedem Objekt.
---
Benutzerdefinierte Felder ermöglichen es Ihnen, Informationen zu erfassen, die spezifisch für Ihr Unternehmen sind. Fügen Sie sie zu jedem Objekt hinzu – ob Standard- oder benutzerdefiniert.
## Schritte
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt aus, dem Sie ein Feld hinzufügen möchten
3. Klicke **+ neues Feld**
4. Wählen Sie einen **Feldtyp** (siehe [Felder](/l/de/user-guide/data-model/capabilities/fields) für alle Typen)
5. Geben Sie den **Feldnamen** und eine optionale Beschreibung ein
6. Konfigurieren Sie feldspezifische Einstellungen (siehe unten)
7. Klicken Sie auf **Speichern**
**Schnellmethode:** Klicken Sie in einer beliebigen Tabellenansicht am Ende der Spaltenüberschriften auf **+** → **Felder anpassen**.
## Feld in Ansichten anzeigen
Neue Felder sind nicht automatisch sichtbar. Zum Anzeigen:
1. Öffnen Sie die Tabellenansicht des Objekts
2. Klicken Sie auf **Optionen → Felder**
3. Klicken Sie auf das **Augensymbol** neben Ihrem Feld, um es anzuzeigen
4. Ziehen, um neu anzuordnen
## Konfigurationsoptionen
### Für Auswahl / Mehrfachauswahl
1. Klicken Sie auf **+ Option hinzufügen**, um Optionen zu erstellen
2. Legen Sie bei Bedarf eine **Standardoption** fest
3. Ziehen, um Optionen neu anzuordnen
<Note>
**Verwenden Sie für Importe API-Namen.** Aktivieren Sie in den Einstellungen den **Erweiterten Modus**, um API-Namen anzuzeigen. Siehe [Feldzuordnung](/l/de/user-guide/data-migration/capabilities/field-mapping).
</Note>
### Für Währungsfelder
Legen Sie die **Standardwährung** fest (USD, EUR usw.) für neue Datensätze.
### Für Telefonfelder
Legen Sie den **Standard-Ländercode** fest, der für neue Telefonnummern vorausgefüllt wird.
### Ein Feld eindeutig machen
Schalten Sie **Eindeutig** ein, um doppelte Werte über alle Datensätze hinweg zu verhindern.
<Note>
Wenn Duplikate vorhanden sind (auch in gelöschten Datensätzen), erhalten Sie eine Fehlermeldung. Bereinigen Sie Duplikate zuerst.
</Note>
### Standardwerte festlegen
Für Auswahlfelder können Sie festlegen, welche Option bei neuen Datensätzen vorausgewählt ist. Für Kontrollkästchenfelder legen Sie fest, ob diese standardmäßig aktiviert oder deaktiviert sind.
## Ein Feld deaktivieren
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Suchen Sie das Feld
3. Klicken Sie auf **⋮ → Deaktivieren**
Daten bleiben erhalten. Sie können später reaktivieren oder dauerhaft löschen.
## Verwandt
* [Felder](/l/de/user-guide/data-model/capabilities/fields) — alle Feldtypen erklärt
* [Datenmodell-FAQ](/l/de/user-guide/data-model/how-tos/data-model-faq) — häufige Fragen

View File

@@ -0,0 +1,51 @@
---
title: Benutzerdefinierte Objekte erstellen
description: Schritt-für-Schritt-Anleitung zum Erstellen benutzerdefinierter Objekte in Twenty.
---
Benutzerdefinierte Objekte ermöglichen es Ihnen, Informationen zu speichern, die für Ihr Unternehmen einzigartig sind und die Standardobjekte nicht abdecken. Zum Beispiel: Projekte, Produkte, Tickets oder Listings.
<Note>
**Nicht sicher, ob Sie ein Objekt oder ein Feld benötigen?** Siehe [Ihr Datenmodell verstehen](/l/de/user-guide/data-model/overview) für eine Anleitung.
</Note>
## Schritte
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Klicke **+ Objekt hinzufügen**
3. Füllen Sie Folgendes aus:
* **Singularname** (z. B. "Listing")
* **Pluralname** (z. B. "Listings")
* **Symbol**
* **Beschreibung** (optional)
4. Klicken Sie auf **Speichern**
Ihr Objekt erscheint sofort in der Seitenleiste.
## Als Nächstes: Felder hinzufügen
Neue Objekte beginnen mit grundlegenden Feldern. Fügen Sie benutzerdefinierte Felder hinzu, um die benötigten Daten zu erfassen:
1. Wählen Sie in **Einstellungen → Datenmodell** Ihr Objekt aus
2. Klicke **+ neues Feld**
3. Wählen Sie einen Feldtyp, konfigurieren Sie ihn und speichern Sie
Siehe [Benutzerdefinierte Felder erstellen](/l/de/user-guide/data-model/how-tos/create-custom-fields) für Details zu Feldtypen und Konfiguration.
## Verknüpfung mit anderen Objekten
Um Ihr Objekt mit Personen, Unternehmen oder anderen Objekten zu verknüpfen, erstellen Sie ein Beziehungsfeld. Siehe [Beziehungsfelder erstellen](/l/de/user-guide/data-model/how-tos/create-relation-fields).
## Ein Objekt deaktivieren
Wenn Sie ein Objekt nicht mehr benötigen:
1. Gehe zu **Einstellungen → Datenmodell → Objekt deiner Wahl → Einstellungen**
2. Klicke auf den **Deaktivieren** Button
Das Objekt wird ausgeblendet, die Daten bleiben jedoch erhalten. Sie können es später reaktivieren oder dauerhaft löschen.
## Verwandt
* [Objekte](/l/de/user-guide/data-model/capabilities/objects) — Standard- vs. benutzerdefinierte Objekte
* [Datenmodell-FAQ](/l/de/user-guide/data-model/how-tos/data-model-faq) — häufige Fragen

View File

@@ -0,0 +1,175 @@
---
title: Viele-zu-Viele-Beziehungen erstellen
description: Verbinden Sie Datensätze, bei denen auf beiden Seiten viele Elemente mithilfe von Verknüpfungsobjekten miteinander verknüpft werden können.
---
Viele-zu-Viele-Beziehungen ermöglichen es Ihnen, auf beiden Seiten mehrere Datensätze zu verknüpfen. Beispiel: Viele Personen können an vielen Projekten arbeiten, und jedes Projekt kann viele Personen haben.
<Warning>
**Beta-Funktion**: Verknüpfungsbeziehungen befinden sich derzeit in der Beta. Aktivieren Sie sie unter **Einstellungen → Community → Features**, bevor Sie dieser Anleitung folgen.
</Warning>
<Note>
Für diese Funktion muss außerdem der **Erweiterte Modus** aktiviert sein (Schalter unten links in den Einstellungen).
</Note>
## Wann Viele-zu-Viele-Beziehungen verwenden
Verwenden Sie Viele-zu-Viele-Beziehungen, wenn beide Seiten einer Beziehung mehrere Verknüpfungen haben können:
| Beziehung | Beispiel |
| ----------------------- | -------------------------------------------------------------------------------------------------- |
| Personen ↔ Projekte | Eine Person arbeitet an mehreren Projekten; ein Projekt hat mehrere Teammitglieder |
| Unternehmen ↔ Tags | Ein Unternehmen kann mehrere Tags haben; ein Tag kann für mehrere Unternehmen gelten |
| Produkte ↔ Bestellungen | Ein Produkt kann in mehreren Bestellungen enthalten sein; eine Bestellung enthält mehrere Produkte |
## Wie es funktioniert
Twenty verwendet für Viele-zu-Viele-Beziehungen ein Muster mit **Verknüpfungsobjekt**. Ein Verknüpfungsobjekt sitzt zwischen zwei Objekten und speichert die Verknüpfungen:
```
People ←→ Project Assignments ←→ Projects
```
Das Objekt **Projektzuweisungen** (Verknüpfung) hat:
* Eine Beziehung zu Personen (Viele-zu-Eins)
* Eine Beziehung zu Projekten (Viele-zu-Eins)
Wenn Sie den Schalter für die Verknüpfungsbeziehung aktivieren, zeigt Twenty verknüpfte Datensätze direkt an, anstatt die zwischengeschalteten Verknüpfungsdatensätze anzuzeigen.
## Voraussetzungen
1. **Verknüpfungsbeziehungen in Beta-Funktionen aktivieren**: Gehen Sie zu **Einstellungen → Community → Features** und aktivieren Sie **Verknüpfungsbeziehungen**
2. **Erweiterten Modus aktivieren**: Aktivieren Sie den **Erweiterten Modus** unten links in der Seitenleiste der Einstellungen
3. Planen Sie Ihr Datenmodell:
* Welche zwei Objekte verbinden Sie?
* Wie soll das Verknüpfungsobjekt heißen?
## Schritt 1: Verknüpfungsobjekt erstellen
Erstellen Sie zunächst das Zwischenobjekt, das die Verknüpfungen speichert.
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Klicke **+ Objekt hinzufügen**
3. Benennen Sie es aussagekräftig (z. B. "Projektzuweisung", "Teammitglied", "Produktbestellung")
4. Schalten Sie "Erstellen eines Namensfelds überspringen" ein
<img src="/images/user-guide/fields/new-pivot-object.png" alt="Neues Verknüpfungsobjekt" />
5. Klicken Sie auf **Speichern**
<Tip>
**Namenskonvention**: Verwenden Sie einen Namen, der die Beziehung beschreibt, z. B. "Projektzuweisung" oder "Teammitgliedschaft". Das macht das Datenmodell leichter verständlich.
</Tip>
## Schritt 2: Beziehungen zwischen Objekten und dem Verknüpfungsobjekt erstellen
Fügen Sie für jedes Ihrer beiden Objekte Beziehungsfelder zum Verknüpfungsobjekt hinzu.
### Erste Beziehung (Objekt A → Verknüpfung)
1. Wählen Sie Ihr erstes Objekt unter **Einstellungen → Datenmodell** aus
2. Klicken Sie auf **+ Beziehung hinzufügen**
3. Wählen Sie das Verknüpfungsobjekt aus (z. B. "Projektzuweisungen")
4. Legen Sie den Beziehungstyp auf **Eins-zu-Viele** fest (eine Person kann mit vielen Zuweisungen verknüpft werden)
5. Benennen Sie die Felder:
* Feld bei Personen: z. B. "Projektzuweisungen"
* Feld auf der Verknüpfung: z. B. "Person"
6. Klicken Sie auf **Speichern**
### Zweite Beziehung (Objekt B → Verknüpfung)
1. Wählen Sie Ihr zweites Objekt unter **Einstellungen → Datenmodell** aus
2. Klicken Sie auf **+ Beziehung hinzufügen**
3. Wählen Sie das Verknüpfungsobjekt aus (z. B. "Projektzuweisungen")
4. Legen Sie den Beziehungstyp auf **Eins-zu-Viele** fest (ein Projekt kann mit vielen Zuweisungen verknüpft werden)
5. Aktivieren Sie **"Dies ist eine Beziehung zu einem Verknüpfungsobjekt"**
<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
6. Benennen Sie die Felder:
* Feld auf der Verknüpfung: z. B. "Projekt"
* Feld bei Projekten: z. B. "Teammitglieder"
7. Klicken Sie auf **Speichern**
## Schritt 3: Anzeige der Verknüpfungsbeziehung konfigurieren
Konfigurieren Sie nun die Quellobjekte so, dass verknüpfte Datensätze direkt angezeigt werden, wobei das zwischengeschaltete Verknüpfungsobjekt übersprungen wird.
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das erste Objekt aus (z. B. "Personen")
3. Suchen Sie das Beziehungsfeld, das auf das Verknüpfungsobjekt zeigt (z. B. "Projektzuweisungen")
4. Klicken Sie, um das Feld zu bearbeiten
5. Aktivieren Sie **"Dies ist eine Beziehung zu einem Verknüpfungsobjekt"**
6. Wählen Sie die **Zielbeziehung** aus (z. B. "Projekt" — das Feld an der Verknüpfung, das auf die andere Seite zeigt)
7. Klicken Sie auf **Speichern**
## Ergebnis
Nach der Konfiguration:
* In einem **Person**-Datensatz zeigt das Feld "Projektzuweisungen" **Projekte** direkt an (keine Zuweisungsdatensätze)
* In einem **Projekt**-Datensatz zeigt das Feld "Teammitglieder" **Personen** direkt an
Das Verknüpfungsobjekt existiert weiterhin und speichert die Verknüpfungen, aber die UI präsentiert eine übersichtlichere Viele-zu-Viele-Ansicht.
## Beispiel: Personen ↔ Projekte
Hier ist eine vollständige Schritt-für-Schritt-Anleitung:
### Verknüpfungsobjekt erstellen
* Name: **Projektzuweisung**
* Beschreibung: "Verknüpft Personen mit den Projekten, an denen sie arbeiten"
### Beziehungen hinzufügen
1. **Personen → Projektzuweisung**
* Typ: Eins-zu-Viele
* Feld bei Personen: "Projektzuweisungen"
* Feld bei Zuweisung: "Person"
2. **Projekte → Projektzuweisung**
* Typ: Eins-zu-Viele
* Feld bei Projekten: "Teammitglieder"
* Feld bei Zuweisung: "Projekt"
### Verknüpfungsanzeige konfigurieren
1. Am Objekt **Personen**:
* Feld "Projektzuweisungen" bearbeiten
* Verknüpfungsschalter aktivieren
* Ziel: "Projekt"
2. Am Objekt **Projekte**:
* Feld "Teammitglieder" bearbeiten
* Verknüpfungsschalter aktivieren
* Ziel: "Person"
### Verwendung
* Öffnen Sie einen Person-Datensatz → Sehen Sie deren Projekte direkt
* Öffnen Sie einen Projekt-Datensatz → Sehen Sie Teammitglieder direkt
* Erstellen Sie neue Verknüpfungen von beiden Seiten
## Zusätzliche Daten zu Verknüpfungen hinzufügen
Da das Verknüpfungsobjekt ein echtes Objekt ist, können Sie benutzerdefinierte Felder hinzufügen, um Informationen über die Beziehung zu speichern:
* **Rolle**: "Entwickler", "Designer", "Manager"
* **Startdatum**: Wenn die Person dem Projekt beigetreten ist
* **Zugeordnete Stunden**: Wöchentliche Stunden für dieses Projekt
Um auf diese Daten zuzugreifen, navigieren Sie direkt zum Verknüpfungsobjekt oder greifen Sie per API-Abfrage darauf zu.
## Einschränkungen
* **CSV-Import/-Export**: Das direkte Importieren von Viele-zu-Viele-Beziehungen wird nicht unterstützt. Importieren Sie stattdessen Datensätze in das Verknüpfungsobjekt.
* **Filter**: Das Filtern nach Viele-zu-Viele-Beziehungen bietet möglicherweise nur begrenzte Optionen.
## Verwandt
* [Beziehungsfelder](/l/de/user-guide/data-model/capabilities/relation-fields) — Beziehungstypen erklärt
* [Benutzerdefinierte Objekte erstellen](/l/de/user-guide/data-model/how-tos/create-custom-objects) — so erstellen Sie Objekte
* [Beziehungsfelder erstellen](/l/de/user-guide/data-model/how-tos/create-relation-fields) — grundlegende Einrichtung von Beziehungen

View File

@@ -0,0 +1,70 @@
---
title: Relationsfelder erstellen
description: Schritt-für-Schritt-Anleitung zum Verbinden von Objekten mit Relationsfeldern.
---
Relationsfelder verbinden Datensätze aus verschiedenen Objekten — zum Beispiel Personen mit Unternehmen.
<Note>
**Relationsnamen können nach dem Erstellen nicht geändert werden** (sie wirken sich auf die API aus). Planen Sie Ihre Namen sorgfältig.
</Note>
## Bevor Sie beginnen
Entscheiden Sie:
* Welche Objekte verbinden Sie? (z. B. Personen → Unternehmen)
* Welche ist die "One"-Seite? (z. B. Unternehmen)
* Welche ist die "Many"-Seite? (z. B. Personen — viele Personen arbeiten bei einem Unternehmen)
* Wie soll das Feld auf beiden Seiten heißen?
Siehe [Relationsfelder](/l/de/user-guide/data-model/capabilities/relation-fields) für Erläuterungen zu Relationstypen.
## Schritte
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie das Objekt aus, in dem Sie die Relation benötigen (typischerweise die "Many"-Seite)
3. Klicken Sie auf **+ Neues Feld**
4. Wählen Sie **Relation** als Feldtyp aus
5. Wählen Sie das **Zielobjekt** aus
6. Wählen Sie **One-to-Many** oder **Many-to-One**
7. Geben Sie Feldnamen für **beide Seiten** der Relation ein
8. Klicken Sie auf **Speichern**
## Beispiel: Personen → Unternehmen
* Gehen Sie zu **Einstellungen → Datenmodell → Personen**
* Fügen Sie ein Relationsfeld hinzu
* Ziel: **Unternehmen**
* Typ: **Many-to-One**
* Feld bei Personen: **Unternehmen**
* Feld bei Unternehmen: **Mitarbeitende**
Jetzt kann jede Person mit einem Unternehmen verknüpft werden, und jedes Unternehmen zeigt seine Mitarbeitenden.
## Eine Relation deaktivieren
1. Gehe zu **Einstellungen → Datenmodell → Objekt deiner Wahl**
2. Suchen Sie das Relationsfeld und klicken Sie darauf
3. Klicken Sie auf die **Deaktivieren**-Schaltfläche
Verknüpfungen bleiben erhalten, sind jedoch verborgen. Reaktivieren, um wiederherzustellen.
<Note>
**Das Deaktivieren einer Relation löscht keine Datensätze.** Es wird nur die Verknüpfung zwischen ihnen entfernt.
</Note>
## Eine Relation löschen
1. Gehe zu **Einstellungen → Datenmodell → Objekt deiner Wahl**
2. Suchen Sie das Relationsfeld und klicken Sie darauf
3. Klicken Sie auf die **Löschen**-Schaltfläche
<Note>
Gilt nur für benutzerdefinierte Beziehungen. Standardbeziehungen können nur deaktiviert werden.
</Note>
## Verwandt
* [Relationsfelder](/l/de/user-guide/data-model/capabilities/relation-fields) — Typen und Einschränkungen
* [Relationen importieren](/l/de/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — verknüpfte Datensätze im Stapel importieren

View File

@@ -0,0 +1,22 @@
---
title: Passen Sie Ihr Datenmodell an
description: Übersicht über die Anpassungsoptionen des Datenmodells.
---
Das Datenmodell von Twenty ist vollständig anpassbar. Erstellen Sie Objekte, Felder und Relationen, die zu Ihrem Unternehmen passen.
## Schnellzugriffe
| Ich möchte ... | Leitfaden |
| ------------------------------ | --------------------------------------------------------------------------------------------------- |
| Ein neues Objekt erstellen | [So erstellen Sie benutzerdefinierte Objekte](/l/de/user-guide/data-model/how-tos/create-custom-objects) |
| Einem Objekt Felder hinzufügen | [So erstellen Sie benutzerdefinierte Felder](/l/de/user-guide/data-model/how-tos/create-custom-fields) |
| Objekte miteinander verbinden | [So erstellen Sie Relationsfelder](/l/de/user-guide/data-model/how-tos/create-relation-fields) |
## Mehr erfahren
* [Ihr Datenmodell verstehen](/l/de/user-guide/data-model/overview) — zentrale Konzepte und Planungstipps
* [Objekte](/l/de/user-guide/data-model/capabilities/objects) — Standard vs. benutzerdefinierte Objekte
* [Felder](/l/de/user-guide/data-model/capabilities/fields) — alle Feldtypen
* [Relationsfelder](/l/de/user-guide/data-model/capabilities/relation-fields) — Objekte verbinden
* [FAQ zum Datenmodell](/l/de/user-guide/data-model/how-tos/data-model-faq) — häufige Fragen

View File

@@ -0,0 +1,157 @@
---
title: Datenmodell-FAQ
description: Häufig gestellte Fragen zum Datenmodell von Twenty.
---
## Objektverwaltung
<AccordionGroup>
<Accordion title="Kann ich ein benutzerdefiniertes Objekt löschen?">
Ja, benutzerdefinierte Objekte können gelöscht werden. Sie können sie auch zuerst deaktivieren; dadurch werden das Objekt und seine Daten in der Oberfläche ausgeblendet, während die Daten erhalten bleiben.
</Accordion>
<Accordion title="Kann ich Standardobjekte (Personen, Unternehmen usw.) löschen?">
Nein, Standardobjekte können nicht gelöscht werden. Sie können sie nur deaktivieren; dadurch werden sie in der Oberfläche ausgeblendet, die Daten bleiben jedoch erhalten.
</Accordion>
<Accordion title="Wie viele benutzerdefinierte Objekte kann ich erstellen?">
Sie können so viele benutzerdefinierte Objekte und Felder erstellen, wie Sie benötigen — der Preis ändert sich nicht.
</Accordion>
<Accordion title="Kann ich ein Standardobjekt umbenennen?">
Sie können die Bezeichnung von Standardobjekten (People, Companies, Opportunities) umbenennen, jedoch nicht deren API-Namen. Die API-Namen sind für die Konsistenz in allen Twenty-Workspaces festgelegt.
</Accordion>
<Accordion title="Kann ich das Symbol eines Objekts ändern?">
Ja, Sie können das Symbol sowohl für Standard- als auch für benutzerdefinierte Objekte in **Settings → Data Model** ändern.
</Accordion>
<Accordion title="Kann ich die Objekte in der linken Navigationsleiste umordnen?">
Noch nicht. Die Reihenfolge der Objekte in der Navigation ist derzeit festgelegt, aber diese Funktion ist für eine zukünftige Veröffentlichung geplant.
</Accordion>
<Accordion title="Kann ich Objekte in der linken Navigationsleiste ausblenden?">
Alle aktiven Objekte erscheinen in der Navigation. Sie können Objekte, die Sie nicht benötigen, unter **Einstellungen → Datenmodell** deaktivieren.
</Accordion>
</AccordionGroup>
## Feldmöglichkeiten
<AccordionGroup>
<Accordion title="Kann ich den Feldtyp nach der Erstellung ändern?">
Nein, Feldtypen können nach der Erstellung nicht geändert werden. Wenn Sie einen anderen Typ benötigen, erstellen Sie ein neues Feld mit dem richtigen Typ, migrieren Sie Ihre Daten und deaktivieren Sie anschließend das alte Feld.
</Accordion>
<Accordion title="Warum brauche ich unterschiedliche Singular- und Pluralnamen?">
Unsere GraphQL-API verwendet beide Formen für verschiedene Operationen:
* `createPerson` (Singular) für Einzelaktionen
* `createPeople` (Plural) für Massenoperationen
Dies schafft Einschränkungen, wenn Singular- und Pluralformen gleich sind, verbessert jedoch die Entwicklererfahrung.
</Accordion>
<Accordion title="Warum sind einige Feldnamen geschützt?">
Bestimmte Feldnamen wie `Typ` oder `Applikation` sind für Systemnutzung reserviert. Wählen Sie stattdessen alternative Namen wie `Kategorie` oder `Klassifikation`.
</Accordion>
<Accordion title="Was passiert, wenn ich ein Feld deaktiviere?">
* Das Feld wird in der Oberfläche ausgeblendet
* Vorhandene Daten bleiben erhalten
* Sie können weiterhin über die API auf das Feld zugreifen
* Bestehende Beziehungen bleiben bestehen, aber Sie können keine neuen erstellen
* Sie können das Feld später wieder aktivieren
</Accordion>
<Accordion title="Kann ich ein Feld als erforderlich festlegen?">
Derzeit können benutzerdefinierte Felder nicht als erforderlich festgelegt werden. Alle Felder akzeptieren leere Werte. Sie können Workflows verwenden, um erforderliche Felder durchzusetzen, indem Sie Benachrichtigungen senden oder Aktionen blockieren, wenn Felder leer sind.
</Accordion>
<Accordion title="Was ist der Unterschied zwischen eindeutig und erforderlich?">
* **Eindeutig**: Keine zwei Datensätze dürfen in diesem Feld denselben Wert haben
* **Erforderlich**: Das Feld muss einen Wert haben (derzeit für benutzerdefinierte Felder nicht unterstützt)
</Accordion>
<Accordion title="Kann ich Formelfelder erstellen?">
Formel Felder kommen in **H2 2026**. In der Zwischenzeit können Sie Workflows verwenden, um Feldwerte automatisch zu berechnen und zu aktualisieren.
</Accordion>
<Accordion title="Kann ich verschachtelte Felder in meinen Objekten haben?">
Verschachtelte Felder kommen in **H2 2026**. Aktuell können Sie Workflows verwenden, um Felderwerte von verwandten Objekten einzuholen. Zum Beispiel: Um die Branche eines Unternehmens in einem Personen-Datensatz anzuzeigen, erstellen Sie ein benutzerdefiniertes Feld für Personen und verwenden Sie einen Workflow, um den Wert zu synchronisieren.
</Accordion>
<Accordion title="Kann ich Felder in Objekten umsortieren?">
Ja, gehen Sie zu Einstellungen → Datenmodell → Objekt Ihrer Wahl → Layout und klicken Sie auf **Datensatzseite anpassen**. Wenn diese Schaltfläche deaktiviert ist, müssen Sie einen Datensatz erstellen.
</Accordion>
</AccordionGroup>
## Beziehungen
<AccordionGroup>
<Accordion title="Kann ich eine Beziehung erstellen, die auf dasselbe Objekt verweist?">
Ja! Sich selbst referenzierende Beziehungen werden unterstützt und für Anwendungsfälle wie Account-Hierarchien empfohlen. Erstellen Sie beispielsweise eine Beziehung von Companies zu Companies, um übergeordnete/untergeordnete Accounts nachzuverfolgen.
</Accordion>
<Accordion title="Kann ich Viele-zu-Viele-Beziehungen erstellen?">
In **H2 2026** kommen viele Beziehungen. Derzeit können Sie als Workaround ein Zwischenobjekt mit zwei 1-zu-viele-Beziehungen erstellen.
Erstellen Sie beispielsweise, um People und Projects (Viele-zu-Viele) zu verknüpfen, ein Objekt "Projektzuweisungen" mit:
* Eine Beziehung zu People (viele Zuweisungen → eine Person)
* Eine Beziehung zu Projects (viele Zuweisungen → ein Projekt)
</Accordion>
<Accordion title="Was sind Beziehungen zu mehreren Objekttypen (Morph-Beziehungen)?">
Damit kann ein Objekt über ein einziges Feld mit mehreren unterschiedlichen Objekttypen verknüpft werden. Beispielsweise können Notizen gleichzeitig Personen UND Unternehmen UND Opportunities zugeordnet werden.
Jede Notiz ist gleichzeitig mit einer Person, einem Unternehmen und einer Opportunity verknüpft.
Erfahren Sie mehr unter [Beziehungsfelder](/l/de/user-guide/data-model/capabilities/relation-fields).
</Accordion>
<Accordion title="Kann ich mehrere Beziehungen zwischen denselben Objekten erstellen?">
Ja, Sie können mehrere Beziehungen zwischen denselben beiden Objekten erstellen. Beispielsweise könnte ein Unternehmen sowohl eine "Primary Contact"- als auch eine "Billing Contact"-Beziehung zu Personen haben.
</Accordion>
<Accordion title="Was passiert mit Beziehungen, wenn ich einen Datensatz lösche?">
Wenn Sie einen Datensatz löschen, wird die Verknüpfung aus den verknüpften Datensätzen entfernt. Die verknüpften Datensätze selbst werden nicht gelöscht.
</Accordion>
<Accordion title="Kann ich zirkuläre Beziehungen erstellen?">
Obwohl technisch möglich, sollten zirkuläre Beziehungen (A → B → C → A) vermieden werden, da sie zu Verwirrung und möglichen Leistungsproblemen führen können.
</Accordion>
</AccordionGroup>
## Zugriff und Berechtigungen
<AccordionGroup>
<Accordion title="Wo kann ich mein Datenmodell sehen und bearbeiten?">
Gehen Sie zu **Settings → Data Model**, um alle Ihre Objekte und Felder anzuzeigen und zu bearbeiten.
</Accordion>
<Accordion title="Warum kann ich das Datenmodell unter Einstellungen nicht sehen?">
Wenden Sie sich an Ihren Arbeitsbereichs-Administrator. Der Zugriff auf das Datenmodell ist in der Regel nur für Administratoren eingeschränkt.
</Accordion>
</AccordionGroup>
## Datenverwaltung
<AccordionGroup>
<Accordion title="Gibt es eine Begrenzung, wie viele Datensätze ich haben kann?">
Es gibt keine feste Obergrenze für die Anzahl der Datensätze. Sehr große Datensätze können jedoch die Leistung in einigen Ansichten beeinträchtigen. Verwenden Sie Filter und Ansichten, um große Datensätze effektiv zu verwalten.
</Accordion>
<Accordion title="Kann ich Daten in benutzerdefinierte Objekte importieren?">
Ja, Sie können CSV-Daten in jedes Objekt importieren, einschließlich benutzerdefinierter Objekte. Der Importprozess unterstützt die Feldzuordnung für benutzerdefinierte Felder. Siehe [So bereiten Sie Ihre CSV-Dateien vor](/l/de/user-guide/data-migration/how-tos/prepare-your-csv-files).
</Accordion>
<Accordion title="Kann ich meine Datenmodell-Konfiguration exportieren?">
Derzeit gibt es keinen integrierten Export für die Datenmodell-Konfiguration. Kontaktieren Sie den Support, wenn Sie Ihr Datenmodell zwischen Workspaces migrieren müssen.
</Accordion>
<Accordion title="Wie viele Felder können ein einzelnes Objekt haben?">
Die maximale Anzahl von Feldern, die ein einzelnes Objekt haben kann, ist 1600 Felder pro Postgres-Limit, einschließlich vorhandener und gelöschter Felder. Bitte beachten Sie, dass Zwanzig Ihren Arbeitsbereich nicht reparieren kann, wenn die Grenze von 1600 Feldern erreicht wird, da er unter unsere Richtlinien zur fairen Nutzung fällt.
</Accordion>
</AccordionGroup>
## Brauchen Sie mehr Hilfe?
Sehen Sie sich unsere [Implementierungsdienste](/l/de/user-guide/getting-started/capabilities/implementation-services) an, um Unterstützung beim Design komplexer Datenmodelle zu erhalten.

View File

@@ -0,0 +1,177 @@
---
title: Datenmodell
description: Erfahren Sie, was ein Datenmodell ist und wie Sie eines entwerfen, das zu Ihrem Unternehmen passt.
---
## Was ist ein Datenmodell?
Ein Datenmodell ist die Struktur, die definiert, wie Informationen in Ihrem CRM organisiert sind. Betrachten Sie es als den **Bauplan** Ihrer Kundendaten — Sie entwerfen ihn einmal und füllen ihn dann mit Ihren tatsächlichen Daten.
## Wichtige Konzepte
### Objekte
**Objekte** sind die Hauptkategorien der Daten in Ihrem CRM. Jedes Objekt repräsentiert eine Art von Element, das Sie nachverfolgen möchten.
Twenty enthält Standardobjekte:
* **People** — Einzelpersonen (Kontakte, Leads, Partner)
* **Companies** — Organisationen
* **Opportunities** — Deals oder Verkäufe
* **Notizen** — Notizen an Datensätze angehängt
* **Tasks** — mit Datensätzen verknüpfte To-dos
Sie können außerdem **benutzerdefinierte Objekte** für alles erstellen, was spezifisch für Ihr Unternehmen ist (z. B. Projects, Subscriptions, Events).
### Felder
**Felder** sind die Eigenschaften oder Attribute, die jedes Objekt beschreiben. Sie speichern die eigentlichen Informationen.
Zum Beispiel hat das **People**-Objekt Felder wie:
* Name
* E-Mail
* Telefon
* Berufsbezeichnung
* Company (eine Beziehung zum Companies-Objekt)
Felder haben unterschiedliche **Typen**: Text, Zahl, Datum, Auswahl, Mehrfachauswahl, Beziehung und mehr. Sie können benutzerdefinierte Felder zu jedem Objekt hinzufügen.
### Datensätze
**Datensätze** sind die einzelnen Einträge innerhalb eines Objekts — die tatsächlichen Daten, die Sie erstellen und verwalten.
Zum Beispiel:
* "John Smith" ist ein **Datensatz** im People-Objekt
* "Acme Corp" ist ein **Datensatz** im Companies-Objekt
**Eine Analogie:**
| Konzept des Datenmodells | Analogie aus der realen Welt |
| ------------------------ | ---------------------------------------------------------------- |
| **Objekte** | Abschnitte in einem Buch (die Kategorien) |
| **Felder** | Spalten in einer Tabellenkalkulation (die Eigenschaften) |
| **Datensätze** | Zeilen in einer Tabellenkalkulation (die tatsächlichen Einträge) |
Sie entwerfen das Datenmodell (Objekte + Felder) einmal und erstellen dann viele Datensätze innerhalb dieser Struktur.
## Warum Ihr Datenmodell anpassen?
Jedes Unternehmen arbeitet anders. Die Anpassung Ihres Datenmodells bedeutet, dass Sie Twenty um **Ihre** Prozesse herum gestalten können, anstatt Ihre in ein starres System zu zwängen.
Twenty bietet volle Flexibilität:
* Erstellen Sie so viele benutzerdefinierte Objekte, wie Sie benötigen
* Fügen Sie unbegrenzt viele benutzerdefinierte Felder hinzu
* Der Preis ändert sich durch Anpassungen nicht.
## Tipps zur Gestaltung Ihres Datenmodells
### 1. Beginnen Sie mit Ihren Kernobjekten
Identifizieren Sie die wichtigsten Konzepte, mit denen Sie arbeiten. Twenty bietet bereits:
* **People** — Ihre Kontakte
* **Companies** — Ihre Accounts
* **Opportunities** — Ihre Deals
Überlegen Sie, was Sie sonst noch benötigen könnten:
* Stripe bräuchte ein `Subscriptions`-Objekt
* Airbnb bräuchte ein `Trips`-Objekt
* Ein Accelerator bräuchte ein `Batches`-Objekt
### 2. Verwenden Sie Felder für Varianten, statt neuer Objekte
Wenn etwas nur ein Merkmal eines bestehenden Objekts ist, machen Sie es zu einem **Feld**.
**Verwenden Sie Felder für:**
* Kategorien und Labels (z. B. `Industry` für Companies)
* Statuswerte (z. B. `Stage` für Opportunities)
* Attribute und Eigenschaften
### 3. Erstellen Sie ein Objekt, wenn es eigenständig ist
Wenn das Konzept einen eigenen Lebenszyklus, eigene Eigenschaften oder Beziehungen hat, verdient es ein eigenes Objekt.
**Erstellen Sie ein Objekt für:**
* **Projects** — haben Fristen, Verantwortliche und Aufgaben
* **Subscriptions** — verbinden Unternehmen, Produkte und Rechnungen
* **Events** — beziehen Teilnehmer und Folgeaktionen ein
Dies geht über ein einzelnes Feld hinaus, da sie ihre eigenen Daten und Beziehungen haben.
### 4. Erstellen Sie ein Objekt, wenn die Anzahl der Einträge offen ist
Wenn etwas mehrfach verknüpft werden kann und Sie nicht wissen, wie oft, verwenden Sie ein Objekt.
**Schlechter Ansatz:**
Felder wie `Product 1`, `Product 2`, `Product 3` erstellen ...
**Guter Ansatz:**
Erstellen Sie ein `Products`-Objekt und verknüpfen Sie es mit Datensätzen. Dies unterstützt ein, zwei oder hundert Produkte, ohne Ihr Modell zu ändern.
### 5. Halten Sie es zunächst einfach
Beginnen Sie mit Feldern. Erstellen Sie neue Objekte nur, wenn Sie an Grenzen stoßen:
* Zu viele Felder in einem Objekt
* Wiederholte Datensätze, die getrennt sein sollten
* Beziehungen, die sich nicht sauber abbilden lassen
## Besondere Hinweise zu Personen, Unternehmen und Gelegenheiten
<Warning>
**E-Mail- und Kalender-Synchronisierung funktioniert nur mit Personen, Unternehmen und Gelegenheiten.**
Dies sind die einzigen Objekte, in denen Sie auf synchronisierte E-Mails und Besprechungen aus Ihrem Postfach/Kalender zugreifen können. Wir empfehlen, sie so häufig wie möglich zu nutzen.
</Warning>
**Beste Praktiken:**
* Wenn Sie Kategorien von Personen benötigen, verwenden Sie Felder (keine neuen Objekte)
* Beispiel: Verwenden Sie ein `Person Type`-Feld mit den Werten "Prospect" und "Partner" anstatt separate Objekte zu erstellen
* Erstellen Sie unterschiedliche **Ansichten** zum Filtern: eine zeigt Partner, eine andere Interessenten
**Es ist in Ordnung, Felder zu haben, die nicht für jeden Datensatz gelten.** Zum Beispiel ein `Referral Link`-Feld bei Personen, das nur gilt, wenn `Person Type = Partner`. Blenden Sie dieses Feld in Ansichten aus, in denen es nicht relevant ist.
## Fragen zur Auswahlhilfe
Fragen Sie sich:
<Check>Ist dies nur eine Eigenschaft von etwas, das ich bereits habe, oder benötigt es eigene Eigenschaften?</Check>
<Check>Werde ich jemals mehrere davon pro Datensatz nachverfolgen müssen, ohne zu wissen, wie viele?</Check>
<Check>Verbindet dieses Konzept mehrere unterschiedliche Objekte, nicht nur eines?</Check>
<Check>Wird es einen eigenen Lebenszyklus haben (Phasen, Start-/Enddaten)?</Check>
Wenn die Antwort auf eine oder mehrere dieser Fragen "ja" lautet, ist es wahrscheinlich Zeit für ein neues Objekt.
## Zugriff auf Ihr Datenmodell
1. Gehen Sie zu **Einstellungen** in der linken Seitenleiste
2. Klicken Sie auf **Datenmodell**
3. Zeigen Sie alle Ihre Objekte (Standard und benutzerdefiniert) an
4. Klicken Sie auf ein beliebiges Objekt, um seine Felder anzuzeigen und zu bearbeiten
<Note>
**Sie sehen das Datenmodell nicht in den Einstellungen?**
Der Zugriff auf das Datenmodell ist in der Regel auf Administratoren beschränkt. Kontaktieren Sie Ihren Workspace-Admin, wenn Sie Zugriff benötigen.
</Note>
## Nächste Schritte
Sobald Sie Ihr Datenmodell geplant haben:
* [Benutzerdefinierte Objekte erstellen](/l/de/user-guide/data-model/how-tos/create-custom-objects)
* [Benutzerdefinierte Felder erstellen](/l/de/user-guide/data-model/how-tos/create-custom-fields)
* [Beziehungsfelder erstellen](/l/de/user-guide/data-model/how-tos/create-relation-fields)
## Brauchen Sie Hilfe?
<Tip>
Möchten Sie Hilfe bei der Gestaltung Ihres Datenmodells? [Finde einen zertifizierten Zwanzig Partner](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-data-model) um Objekte, Felder und Beziehungen zu entwerfen und zu bauen.
</Tip>

View File

@@ -0,0 +1,104 @@
---
title: Glossar
description: Machen Sie sich mit grundlegenden Begriffen vertraut, die in Twenty verwendet werden.
---
## API
API (Application Programming Interface) ermöglicht es Ihnen, Twenty mit anderen Softwaresystemen zu verbinden und benutzerdefinierte Integrationen zu erstellen.
## Apps
Apps sind benutzerdefinierte Erweiterungen, die als Code erstellt werden und Datenmodelle sowie Logikfunktionen definieren können. Damit können Entwickler wiederverwendbare Anpassungen erstellen, die in mehreren Workspaces bereitgestellt werden können.
## Code-Aktionen
Code-Aktionen sind Workflow-Schritte, mit denen Sie benutzerdefiniertes JavaScript schreiben können, um Daten zu transformieren, Berechnungen durchzuführen oder komplexe Logik auszuführen, die mit integrierten Aktionen nicht möglich ist.
## Befehlsmenü
Das Befehlsmenü ist eine Schnellzugriffsoberfläche (geöffnet mit `Cmd + K` auf dem Mac und `Strg + K` unter Windows), mit der Sie Aktionen ausführen, Datensätze erstellen und effizient in Ihrem Arbeitsbereich navigieren können.
## Unternehmen & Personen
Das CRM verfügt über zwei grundlegende Arten von Datensätzen:
* Eine `Company` repräsentiert ein Unternehmen oder eine Organisation.
* `People` repräsentieren die aktuellen und potenziellen Kunden oder Klienten Ihres Unternehmens.
## Benutzerdefinierte Felder
Benutzerdefinierte Felder sind Datenfelder, die Sie erstellen, um Informationen zu erfassen, die speziell auf die Bedürfnisse und Prozesse Ihres Unternehmens zugeschnitten sind.
## Datenmodell
Ein Datenmodell ist die Struktur, die definiert, wie Informationen in Ihrem CRM organisiert sind, einschließlich der vorhandenen Objekte, deren Eigenschaften (Felder) und wie sie zueinander in Beziehung stehen.
## Favoriten
Favoriten sind Datensätze, die Sie für den Schnellzugriff markiert haben und die in Ihrer Seitenleiste erscheinen, um einen schnellen Zugriff auf wichtige Daten zu ermöglichen.
## Feld
Ein Feld bezeichnet einen bestimmten Bereich, in dem bestimmte Daten für eine Entität gespeichert werden.
## Iterator
Ein Iterator ist eine Workflow-Aktion, die ein Array von Elementen durchläuft und für jedes Element in der Liste die nachfolgenden Aktionen ausführt.
## Kanban
Ein `Kanban` ist eine visuelle Möglichkeit, Ihre Geschäftsprozesse mit Karten und Spalten zu verfolgen. Jede Spalte stellt eine Phase in Ihrem Prozess dar (zum Beispiel: neu, laufend, gewonnen, verloren), und Sie verschieben Datensätze durch diese Phasen, während sie fortschreiten.
## Objekt
Ein Objekt ist eine Datenstruktur, die einen bestimmten Entitätstyp in Ihrem CRM repräsentiert (wie People, Companies oder Opportunities). Objekte können standardmäßig (eingebaut) oder benutzerdefiniert (von Ihnen erstellt) sein.
## Opportunities
Opportunities in Twenty CRM sind potenzielle Deals oder Verkäufe mit Accounts oder Kontakten.
## Datensatz
Ein Datensatz ist eine Instanz eines Objekts, wie ein bestimmtes Konto oder Kontakt.
## Relationsfelder
Relationsfelder stellen Verbindungen zwischen verschiedenen Objekten her und ermöglichen es Ihnen, Datensätze miteinander zu verknüpfen (zum Beispiel die Verbindung einer Person mit einem Unternehmen).
## Standardfelder
Standardfelder sind vorgefertigte Datenfelder, die standardmäßig mit Objekten geliefert werden und in allen Arbeitsbereichen gebräuchliche Funktionen bieten.
## Aufgaben
Tasks in Twenty CRM sind zugewiesene Aktivitäten in Bezug auf Kontakte, Accounts oder Opportunities.
## Auslöser
Trigger sind der Ausgangspunkt eines Workflows — das Ereignis oder die Bedingung, die die Automatisierung auslöst. Beispiele sind das Erstellen von Datensätzen, Aktualisierungen von Datensätzen, Webhooks oder geplante Zeitpunkte.
## Ansichten
Sie können die Anzeige Ihrer Datensätze mit Ansichten anpassen, indem Sie verschiedene Filter, Layouts und Sortierungsoptionen für jede Ansicht festlegen.
## Upsert
Upsert ist eine Operation, die "update" und "insert" kombiniert — sie aktualisiert einen vorhandenen Datensatz, wenn eine Übereinstimmung gefunden wird, oder erstellt einen neuen Datensatz, wenn keine Übereinstimmung vorhanden ist.
## Webhooks
Webhooks sind automatisierte Nachrichten, die von Twenty an andere Anwendungen gesendet werden, wenn bestimmte Ereignisse eintreten, und ermöglichen die Synchronisierung von Daten in Echtzeit.
## Workflows
Workflows sind automatisierte Prozesse, die basierend auf bestimmten Bedingungen Aktionen auslösen und Ihnen helfen, sich wiederholende Aufgaben und Geschäftsprozesse zu automatisieren.
## Arbeitsbereich
Ein `Arbeitsbereich` repräsentiert typischerweise ein Unternehmen, das Twenty verwendet. Er enthält alle Datensätze und Daten, die Sie und Ihre Teammitglieder zu Twenty hinzufügen.
Er hat einen einzigen Domainnamen, der typischerweise der Domainname ist, den Ihr Unternehmen für Mitarbeiter-E-Mail-Adressen verwendet.
## Arbeitsbereichsmitglieder
Arbeitsbereichsmitglieder sind die Twenty-Benutzer aus Ihrem Team, die Zugriff auf Ihren Arbeitsbereich haben. Sie können als Eigentümer oder Beauftragte für Datensätze zugewiesen werden.

View File

@@ -0,0 +1,17 @@
---
title: Implementierungsdienste
description: Egal, ob Sie Hilfe beim Einstieg oder der Erstellung erweiterter Anpassungen benötigen, wir haben eine Lösung.
---
## Implementierungspartner
Arbeiten Sie mit zertifizierten Twenty-Partnern für erweiterte Anpassungen, Integrationen und dedizierten Support bei der Implementierung zusammen.
<CardGroup cols={2}>
<Card title="Zertifizierte Partner durchsuchen" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">
Finden Sie einen Partner und nehmen Sie direkt Kontakt auf – filtern Sie nach Region, Sprache und Fachkompetenz.
</Card>
<Card title="Von Twenty vermitteln lassen" icon="envelope" href="mailto:contact@twenty.com">
Teilen Sie uns mit, was Sie benötigen, und wir verbinden Sie mit dem passenden Partner.
</Card>
</CardGroup>

View File

@@ -0,0 +1,42 @@
---
title: Was ist Twenty
description: Twenty ist ein Open-Source-CRM, das Ihnen die Bausteine liefert, um genau das zu erstellen, was Ihr Unternehmen benötigt.
---
## Vision
Ein gutes CRM zu schaffen ist schwierig, weil es ein Balanceakt ist.
Für jedes Unternehmen scheinen die Anforderungen klar, doch jeder hat unterschiedliche Bedürfnisse.
Das Ergebnis ist ein CRM, das entweder zu einfach ist oder versucht, ein Alleskönner zu sein, aber in nichts wirklich spezialisiert ist.
Zunächst sieht Twenty aus wie die meisten CRMs, die Sie bereits kennen: Sie können Geschäfte verfolgen, Kontakte organisieren, Aufgaben und Notizen verwalten.
**Aber was es auszeichnet, ist unser Ansatz für Erweiterbarkeit. Wir bauen eine offene Plattform, die die Bausteine bereitstellt, um Ihre einzigartigen geschäftlichen Probleme zu lösen.**
Wir priorisieren universelle Prinzipien und gemeinsame Muster über Funktionslisten.
Wir versuchen nicht, alle Antworten zu haben, sondern befähigen die Benutzer, das zu finden, was für sie am besten funktioniert.
Open-Source ist das Fundament unseres Ansatzes, das sicherstellt, dass Twenty sich mit seiner Gemeinschaft und für seine Gemeinschaft weiterentwickelt.
## Vorteile
**Anpassbar:** Entworfen, um Ihren geschäftlichen Anforderungen gerecht zu werden.
**Gemeinschaftsgeführt:** Entwickelt und gepflegt von einer großen Open-Source-Gemeinschaft.
**Kosteneffizient:** Sie werden niemals von einem Anbieter abhängig sein, da Sie die Software immer selbst hosten können.
## Hauptmerkmale
* **Kalender & E-Mails:** Synchronisieren Sie Ihr Postfach und Ihren Kalender, um sämtliche Kommunikation in Ihren CRM-Datensätzen zu sehen. [Mehr erfahren](/l/de/user-guide/calendar-emails/overview).
* **Datenmodell:** Erstellen Sie benutzerdefinierte Objekte und Felder, die zu Ihren individuellen Geschäftsprozessen passen. [Entdecken](/l/de/user-guide/data-model/overview).
* **Datenmigration:** Importieren und exportieren Sie Ihre Daten per CSV oder API. [Erste Schritte](/l/de/user-guide/data-migration/overview).
* **Ansichten & Pipelines:** Organisieren Sie Ihre Daten mit Tabellenansichten, Kanban-Boards und Vertriebspipelines. [Entdecken](/l/de/user-guide/views-pipelines/overview).
* **Workflows:** Automatisieren Sie Ihre Geschäftsprozesse und integrieren Sie externe Tools. [Automatisierungen erstellen](/l/de/user-guide/workflows/overview).
* **KI:** Erweitern Sie Ihr CRM mit KI-gestützten Funktionen und Agenten. [KI entdecken](/l/de/user-guide/ai/overview).
* **Dashboards:** Verfolgen Sie die Leistung mit benutzerdefinierten Berichten und Visualisierungen. [Dashboards anzeigen](/l/de/user-guide/dashboards/overview).
* **Berechtigungen & Zugriff:** Steuern Sie mithilfe rollenbasierter Berechtigungen, wer Ihre Daten anzeigen, bearbeiten und verwalten kann. [Zugriff konfigurieren](/l/de/user-guide/permissions-access/overview).
* **Notizen & Aufgaben:** Erstellen Sie Notizen und Aufgaben, die mit Ihren Datensätzen verknüpft sind, für eine bessere Zusammenarbeit.
* **API & Webhooks:** Verbinden Sie sich mit anderen Apps und erstellen Sie benutzerdefinierte Integrationen. [Integration starten](/l/de/developers/extend/api).
## Jetzt beitreten
[Hier registrieren](https://app.twenty.com) oder [werden Sie ein Beitragender auf GitHub](https://github.com/twentyhq/twenty).

View File

@@ -0,0 +1,77 @@
---
title: Konfigurieren Sie Ihren Arbeitsbereich
description: Jedes Unternehmen arbeitet anders. Beginnen Sie mit diesen 3 Schritten, um Twenty an Ihre Bedürfnisse anzupassen.
---
<Note>**Schneller Erfolg**: Beginnen Sie damit, Ihr Postfach zu verbinden. Dies bietet Ihnen sofortigen Mehrwert und hilft Ihrem Team, Twenty mit echten Daten in Aktion zu sehen. Dies können Sie unter Einstellungen → Konten tun.</Note>
## 1. Passen Sie Ihr Datenmodell an
Twenty bietet die Flexibilität, die Sie benötigen, um das Datenmodell zu gestalten, das Ihre täglichen Abläufe am besten unterstützt.
Erstellen Sie Objekte und Felder jeder Art, einschließlich Beziehungen zwischen Ihren verschiedenen Objekten. Dies können Sie unter Einstellungen → Datenmodell tun.
Hier sind ein paar Tipps:
* **Du bist nicht beschränkt auf die Anzahl der benutzerdefinierten Felder oder benutzerdefinierten Objekte**. Das Hinzufügen benutzerdefinierter Objekte und Felder führt nicht zu einer Änderung Ihres Plans.
* **Personen, Unternehmen und Chancen sind die drei Objekte, von denen aus Sie auf die E-Mails und Besprechungen zugreifen können, die aus Ihrem Postfach und Kalender synchronisiert wurden**. Wir empfehlen, diese so oft wie möglich zu verwenden und bei Bedarf Feldern hinzuzufügen, um Ihre Einträge zu kategorisieren. Hier ist ein Beispiel:
* Es ist am besten, das People Objekt für deine Perspektiven und Partner zu verwenden und ein Feld auf dem People Objekt namens \`\`\`Person Typ\`\` zu erstellen, anstatt ein eigenes Partner-Objekt zu erstellen, da Sie nicht in der Lage wären, auf die mit dieser Person ausgetauschten E-Mails aus den Partneraufzeichnungen zuzugreifen.
* Erstellen Sie unter Personen verschiedene Ansichten, eine zur Anzeige von Partnern und eine zur Anzeige von Interessenten.
* Zwei Personen können nicht die gleiche E-Mail-Adresse haben. Zwei Unternehmen können nicht die gleiche Domain haben.
* Sie können Standardfelder und -objekte, die Sie nicht verwenden möchten, deaktivieren.
* Sie können Felder aus Ansichten ausblenden: Scheuen Sie sich nicht, Felder zu erstellen; Sie müssen nicht alle anzeigen.
Lesen [Sie diesen Artikel](/l/de/user-guide/data-model/overview), um zu erfahren, wie Sie Ihr Datenmodell entwerfen.
## 2. Importieren Sie Ihre Daten
Durch das Einbringen Ihrer vorhandenen Daten in Twenty erhält Ihr Team von Anfang an Kontext.
### Verbinden Sie Ihr Postfach
Falls Sie dies beim Erstellen Ihres Arbeitsbereichs nicht getan haben, verbinden Sie Ihr **Google oder Microsoft-Konto** unter Einstellungen → Konten. Dies erlaubt Twenty:
* Ihre Nachrichten und Besprechungen importieren
* Kontakte basierend auf Interaktionen automatisch erstellen (optional)
* Den Kommunikationsverlauf für Ihr Team sichtbar halten
**Verwenden Sie einen anderen Anbieter?**
Sie können ein weiteres Postfach über SMTP oder einen weiteren Kalender über CalDAV hinzufügen. Gehen Sie zum Konfigurieren zu **Einstellungen → Konten**.
### Daten via CSV importieren
Verwenden Sie das Befehlsmenü (`Cmd + K` oder `Ctrl + K`), um Personen, Unternehmen, Gelegenheiten oder benutzerdefinierte Objekte über CSV zu importieren.
**Wichtige Richtlinien**:
* Laden Sie die Beispieldatei herunter, um das erwartete Format zu verstehen
* Begrenzen Sie jede Datei auf 10.000 Einträge
* Entfernen Sie doppelte E-Mails für Personen oder doppelte Domains für Unternehmen
* Überprüfen und korrigieren Sie Fehler (gelb hervorgehoben) vor dem Import
Lesen [Sie diesen Artikel](/l/de/user-guide/data-migration/overview), um mehr über den Datenimport zu erfahren.
## 3. Erstellen Sie Ihre erste Ansicht
Das Erstellen verschiedener Ansichten ist der Schlüssel zur aktionierbaren Datenübertragung für Ihr Team.
Hier erfahren Sie, wie Sie vorgehen:
* **Spalten hinzufügen oder ausblen**
Verwalten Sie die in einer bestimmten Ansicht sichtbaren Felder, indem Sie auf Optionen → Felder (von oben rechts) klicken. Sie können von dort aus Felder anzeigen/verbergen.
* **Felder neu sortieren**
Die Felder aus der angegebenen Ansicht neu sortieren, indem Sie auf Optionen → Felder (von oben rechts) klicken. Ziehen Sie die Felder per Drag & Drop, um sie neu anzuordnen.
* **Ansicht filtern**
Begrenzen Sie die angezeigten Einträge mit den Filtern oben rechts.
* **Einträge sortieren**
Sortieren Sie die angezeigten Einträge mit der Sortierfunktion oben rechts oder indem Sie direkt auf den Spaltennamen klicken.
* **Layout wählen**
Sie können zu einem **Kanban-Layout** oder einem **Gruppieren-nach-Layout** wechseln, solange das Objekt ein `Phase`- oder ähnliches Auswahlfeld hat.
* **Speichern Sie Ihre Ansicht als Favoriten**
Dies kann über das Dropdown-Menü erfolgen, das die verschiedenen Ansichten anzeigt.
## Was kommt als Nächstes?
Beginnen Sie mit der Erstellung von Automatisierungen mit [Workflows](/l/de/user-guide/workflows/overview).

View File

@@ -0,0 +1,48 @@
---
title: Einen Arbeitsbereich erstellen
description: Folgen Sie einer Schritt-für-Schritt-Anleitung, um sich bei Twenty anzumelden, einen Abonnementplan auszuwählen und Ihr Konto einzurichten.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Schritt 1: Registrierung
1. Gehen Sie zu [Twenty Sign Up](https://app.twenty.com).
2. Wählen Sie Ihre bevorzugte Anmeldemethode:
* **Weiter mit Google** für die Registrierung mit einem Google-Konto.
* **Weiter mit Microsoft** für die Registrierung mit einem Microsoft-Konto.
* Oder, **Fortfahren mit E-Mail** zur E-Mail-Registrierung.
<VimeoEmbed videoId="927066829" title="Video-Demonstration" />
## Schritt 2: Auswahl einer Testphase
Wählen Sie zwischen zwei Testzeiträumen:
### 30 Tage
Mit Kreditkarte
### 7 Tage
Ohne Kreditkarte
Beide Testphasen umfassen:
* Vollzugriff
* Unbegrenzte Kontakte
* E-Mail-Integration
* Benutzerdefinierte Objekte
* API & Webhooks
Sie können auf „Plan ändern“ klicken, um einen anderen Plan oder Abrechnungszeitraum auszuwählen.
<img src="/images/user-guide/create-workspace/choose-plan.png" style={{width:'100%'}} />
## Schritt 3: Zahlungsbestätigung & Kontoerstellung
Nach der Zahlungsgenehmigung via Stripe erstellen Sie Ihren Arbeitsbereich und Ihr Benutzerprofil. Denken Sie daran, dass Sie Ihr Abonnement jederzeit kündigen können.
## Support
Bei Fragen oder Hilfe kontaktieren Sie das dedizierte Support-Team unter [contact@twenty.com](mailto:contact@twenty.com) oder senden Sie eine Nachricht auf [Discord](https://discord.gg/cx5n4Jzs57).

View File

@@ -0,0 +1,84 @@
---
title: In Twenty navigieren
description: Erhalten Sie einen schnellen Überblick darüber, wie Sie durch die Plattform navigieren und wo Sie verschiedene Aktionen durchführen können.
---
## Das Hauptlayout
Die Mitte des Bildschirms ist **wo Ihre Datensätze leben**: Leute, Unternehmen, Chancen, Aufgaben, Notizen, Dashboards, Workflows und jedes andere Objekt, das Sie erstellt haben. Hier findet die tägliche Arbeit statt.
Du kannst dort Datensätze **anzeigen, bearbeiten oder löschen** sowie **neue Aufrufe erstellen**.
<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
## Die Navigationsleiste
Auf der linken Seite, von oben nach unten, können Sie:
* Zwischen Ihren Arbeitsbereichen mithilfe des Dropdown-Menüs wechseln oder einen neuen Arbeitsbereich erstellen
* Die **Suchleiste** verwenden (drücken Sie `/`, um direkt darauf zuzugreifen)
* Den Bereich **Einstellungen** öffnen
* Habe direkten Zugriff auf deine **Favoriten Ansichten**. Favoriten sind für jeden Benutzer einzigartig.
* Zwischen verschiedenen Objekten wechseln
* **Automatisierungen erstellen** mithilfe von Workflows
<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
## Das Befehlsmenü
Das Befehlsmenü gibt Ihnen **schnellen Zugriff auf Aktionen** in Twenty. Sie können es auf zwei Weisen aufrufen:
* **Tastenkombination**: Drücken Sie `Cmd + K` (Mac) oder `Strg + K` (Windows)
* **Maus**: Klicken Sie auf die drei Punkte in der oberen rechten Ecke
Von dort aus können Sie:
* Neue Datensätze erstellen
* **Daten über CSV importieren und exportieren**
* Neue Ansichten erstellen
* Auf gelöschte Datensätze zugreifen (Twenty unterstützt weiches und hartes Löschen)
* Sehen Sie sich die Tastenkürzel an, um schnell auf Objekte in Ihrem Arbeitsbereich zuzugreifen
<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
## Die Suchleiste
Die Suchleiste ist über das Befehlsmenü, oben in Ihrer Navigationsleiste, oder durch Drücken von `/` sofort erreichbar. Die Suche funktioniert über alle Objekte hinweg.
<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
## Das Seitenpanel
Wenn Sie auf einen Datensatz klicken, erscheint rechts das Seitenpanel. So erhalten Sie eine schnelle Übersicht über die wichtigsten Informationen des Datensatzes, ohne auf eine andere Seite zu wechseln. Von dort aus können Sie diese Übersicht schließen oder zusätzliche Informationen über diesen Datensatz erhalten, indem Sie auf den "Öffnen"-Button klicken.
<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
## Ansichten
Jedes Objekt (wie Chancen oder Personen) unterstützt mehrere Ansichten. Es gibt keine Begrenzung der Anzahl von Ansichten pro Objekt.
Verwenden Sie das Dropdown-Menü oben links im Hauptlayout, um zwischen den verschiedenen Ansichten zu wechseln. Zum Beispiel:
* Verwenden Sie eine Kanban-Ansicht, um Chancen nach Phase zu verfolgen
* Verwenden Sie die Group-By-Ansicht, um Abschnitte zu erstellen und die Effizienz zu verbessern
* Verwenden Sie Filter, um sich auf bestimmte Datensätze zu konzentrieren (z.B. letzte Woche erstellte Leads)
* Gefilterte Ansichten speichern, um sie später wiederzuverwenden
* Favoriten für schnellen Zugriff
<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
Wenn Sie neu bei Ansichten sind, lesen Sie unseren [Leitfaden zu Ansichten & Pipelines](/l/de/user-guide/views-pipelines/overview), um zu erfahren, wie Sie sie erstellen und anpassen.
## Einstellungen
Öffnen Sie Ihre Einstellungen oben links, um:
* **Verbinden Sie Ihre Mailbox und Kalenderkonten** für nahtlose E-Mail- und Kalendersynchronisierung
* Passen Sie Ihr **Datenmodell** an: Erstellen Sie benutzerdefinierte Objekte, Felder und Beziehungen
* **Greifen Sie auf den API-Spielplatz zu und konfigurieren Sie Webhooks**
* **Benutzerberechtigungen verwalten** und Arbeitsbereichs-Zugangskontrollen einstellen
* Teammitglieder einladen und Benutzerrollen verwalten
* Bearbeiten Sie Ihr Profil und Ihre Arbeitsbereicheinstellungen
* Abrechnung konfigurieren und die Nutzung von Workflow-Guthaben überwachen
* Entdecken und aktivieren Sie kommende Funktionen (unter Updates → Early Access)
* **Support aufrufen**, um per Live-Chat Kontakt aufzunehmen
* **Die Dokumentation öffnen**, um im Benutzerhandbuch und in der Entwicklerdokumentation zu stöbern
<Note>Wenn Sie nicht alle Bereiche in den Einstellungen sehen, wenden Sie sich an Ihren Administrator des Arbeitsbereichs. Einige Bereiche haben eingeschränkten Zugriff.</Note>

View File

@@ -0,0 +1,59 @@
---
title: Benutzerhandbuch
description: Willkommen im Twenty-Benutzerhandbuch, Ihre Anlaufstelle für erweiterte Konfigurationen und bewährte Verfahren.
---
import { CardTitle } from "/snippets/card-title.mdx"
<CardGroup cols={3}>
<Card href="/l/de/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>Datenmodell</CardTitle>
Passen Sie Ihr Datenmodell an Ihre Geschäftsprozesse an.
</Card>
<Card href="/l/de/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
<CardTitle>Datenmigration</CardTitle>
Importieren und exportieren Sie Ihre Daten per CSV oder API.
</Card>
<Card href="/l/de/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
<CardTitle>Kalender & E-Mails</CardTitle>
Zentralisieren Sie die Besprechungen und E-Mails Ihres Teams.
</Card>
<Card href="/l/de/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
<CardTitle>Workflows</CardTitle>
Automatisieren Sie Prozesse und integrieren Sie externe Werkzeuge.
</Card>
<Card href="/l/de/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
<CardTitle>KI</CardTitle>
Verstärken Sie Ihr Team mit KI-Agenten.
</Card>
<Card href="/l/de/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
<CardTitle>Layout</CardTitle>
Navigation, Ansichten und Anpassung der Datensatzseite.
</Card>
<Card href="/l/de/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
<CardTitle>Dashboards</CardTitle>
Echtzeit-Einblicke zur Leistungsverfolgung.
</Card>
<Card href="/l/de/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
<CardTitle>Berechtigungen & Zugriff</CardTitle>
Verwalten Sie Rollen und den Zugriff auf Twenty.
</Card>
<Card href="/l/de/user-guide/billing/overview" img="/images/user-guide/halftone/billing.png">
<CardTitle>Abrechnung</CardTitle>
Verstehen Sie, wie die Preisgestaltung und die Abrechnung von Twenty funktionieren.
</Card>
<Card href="/l/de/user-guide/settings/overview" img="/images/user-guide/halftone/settings.png">
<CardTitle>Einstellungen</CardTitle>
Konfigurieren Sie Ihre Arbeitsbereichseinstellungen.
</Card>
</CardGroup>

View File

@@ -0,0 +1,38 @@
---
title: Navigation
description: Passen Sie die linke Seitenleiste an die Arbeitsweise Ihres Teams an.
---
Die linke Seitenleiste ist Ihre wichtigste Möglichkeit, in Twenty zu navigieren. Sie ist vollständig anpassbar — Sie können sie neu organisieren, damit sie zu Ihrem Workflow passt, ohne eine Einstellungsseite zu öffnen.
## Einträge neu anordnen
Ziehen Sie beliebige Einträge in der Seitenleiste per Drag-and-drop, um ihre Position zu ändern. Die Reihenfolge wird pro Benutzer gespeichert, sodass jedes Teammitglied seine eigene Seitenleiste anordnen kann.
## Ordner
Gruppieren Sie zusammengehörige Einträge in Ordnern. Sie könnten beispielsweise einen Ordner "Vertrieb" mit Ihren Pipeline-Ansichten erstellen, einen Ordner "Support" für Tickets oder einen Ordner "Betrieb" für interne Objekte.
Um einen Ordner zu erstellen, klicken Sie mit der rechten Maustaste in die Seitenleiste oder verwenden Sie die Schaltfläche `+`.
## Objekte ausblenden
Objekte, die Sie nicht verwenden, können aus der Seitenleiste ausgeblendet werden. Sie werden nicht gelöscht — sie sind nur aus dem Weg. Sie können sie jederzeit wieder anzeigen unter Einstellungen → Datenmodell.
## Favoriten
Heften Sie Ansichten, Datensätze oder Suchvorgänge im Bereich Favoriten oben in der Seitenleiste an, um mit einem Klick darauf zuzugreifen. Favoriten sind persönlich — jeder Benutzer verwaltet seine eigenen.
## Benutzerdefinierte Links
Fügen Sie Links zu externen Tools direkt in der Seitenleiste hinzu. Nützlich, um auf Ihr Wiki, Dashboards in anderen Tools oder eine beliebige URL zu verlinken, die Ihr Team regelmäßig verwendet.
## Befehlsmenü
Drücken Sie `Cmd+K` (oder `Ctrl+K`), um das Befehlsmenü zu öffnen — eine Suchleiste für den Schnellzugriff, mit der Sie zu jedem Datensatz, jeder Ansicht oder Aktion springen können, ohne durch die Seitenleiste zu navigieren.
## Anpassung der Seitenleiste
Um die Seitenleiste anzupassen, bewegen Sie den Mauszeiger über den Abschnitt "Arbeitsbereich" in der Seitenleiste und klicken Sie auf das Schraubenschlüssel-Symbol.
<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="Symbol zum Bearbeiten der Navigation" />

View File

@@ -0,0 +1,61 @@
---
title: Datensatzseiten
description: Passen Sie das Layout einzelner Datensatz-Detailseiten mit Tabs und Widgets an.
---
## Übersicht
Wenn Sie in Twenty einen Datensatz öffnen, besteht die Detailseite aus **Tabs** und **Widgets**. Beide lassen sich je Objekttyp vollständig anpassen.
## Registerkarten
Jede Datensatzseite kann mehrere Tabs haben — ähnlich wie Tabs in einem Browser. Verwenden Sie sie, um verschiedene Aspekte eines Datensatzes zu organisieren. Zum Beispiel könnte ein Unternehmensdatensatz Tabs für Übersicht, Kommunikation, Aufgaben und Dateien haben.
Sie können:
* Tabs hinzufügen und entfernen
* Tabs umbenennen
* Tabs durch Ziehen neu anordnen
* Festlegen, welcher Tab standardmäßig angezeigt wird
## Widgets
Widgets sind die Bausteine in jedem Tab. Zu den verfügbaren Widget-Typen gehören:
| Widget | Was angezeigt wird |
| ------------------------- | -------------------------------------------------------- |
| **Felder** | Datensatzfelder, gruppiert oder einzeln |
| **Verknüpfte Datensätze** | Tabelle der über eine Beziehung verknüpften Datensätze |
| **E-Mails** | E-Mail-Verlauf aus verbundenen Konten |
| **Kalender** | Kalenderereignisse, die mit dem Datensatz verknüpft sind |
| **Zeitleiste** | Aktivitäts- und Ereignisverlauf |
| **Aufgaben** | Zugehörige Aufgaben |
| **Notizen** | Rich-Text-Notizen |
| **Dateien** | Dateianhänge |
| **Diagramme** | Visuelle Daten aus verknüpften Datensätzen |
| **iFrame** | Eingebettete externe Inhalte |
| **Rich-Text** | Statische Inhalte oder Beschreibungen |
## Datensatzseite anpassen
1. Öffnen Sie einen beliebigen Datensatz
2. Drücken Sie `Cmd+K` und suchen Sie nach "Layout der Datensatzseite bearbeiten"
oder
1. Gehen Sie zu Einstellungen → Datenmodell → Objekt Ihrer Wahl → Layout
2. Klicken Sie für dieses Objekt auf die Schaltfläche "Datensatzseite anpassen"
3. Sie befinden sich jetzt im Anpassungsmodus:
* **Widgets hinzufügen** aus der Widget-Auswahl
* **Widgets ziehen**, um sie im Raster neu zu positionieren
* **Widgets in der Größe ändern**, indem Sie ihre Ränder ziehen
* **Felder konfigurieren**, die in jedem Widget angezeigt werden
* **Tabs verwalten** — hinzufügen, entfernen, umbenennen, neu anordnen
4. Speichern Sie Ihre Änderungen — sie gelten für alle Datensätze dieses Objekttyps
## Feldsichtbarkeit
In einem Felder-Widget können Sie steuern, welche Felder sichtbar sind und in welcher Reihenfolge. Damit können Sie fokussierte Layouts erstellen — beispielsweise, indem Sie auf dem Tab "Übersicht" nur die wichtigsten Felder anzeigen und detaillierte Felder in einen separaten Tab legen.

View File

@@ -0,0 +1,45 @@
---
title: Layout
description: Passen Sie die Navigation, das Durchsuchen und die Anzeige von Datensätzen in Twenty an.
---
Das Layout von Twenty ist auf drei Ebenen anpassbar: wie Sie in der App navigieren, wie Sie Listen von Datensätzen durchsuchen und was Sie sehen, wenn Sie einen einzelnen Datensatz öffnen.
## Navigation
Die linke Seitenleiste ist vollständig anpassbar. Sie können:
* **Elemente neu anordnen** durch Ziehen und Ablegen
* **Ordner erstellen**, um verwandte Objekte und Ansichten zu gruppieren
* **Objekte ausblenden**, die Sie nicht verwenden
* **Benutzerdefinierte Links hinzufügen** zu externen Tools
* **Favoriten anheften** für schnellen Zugriff auf Ansichten, Datensätze oder Suchen
[Navigationsreferenz →](/l/de/user-guide/layout/capabilities/navigation)
## Ansichten
Ansichten steuern, wie Listen von Datensätzen angezeigt werden. Twenty unterstützt drei Ansichtstypen:
| Ansicht | Am besten geeignet für |
| ------------ | -------------------------------------------------------------------------------------------------- |
| **Tabelle** | Arbeiten mit vielen Datensätzen gleichzeitig — Zeilen und Spalten wie in einer Tabellenkalkulation |
| **Kanban** | Pipeline-Verfolgung — Karten per Ziehen und Ablegen, organisiert nach Phase |
| **Kalender** | Zeitbasierte Planung — Datensätze anhand eines Datumsfelds angeordnet |
Jede Ansicht speichert ihre eigenen Filter, Sortierung, Feldsichtbarkeit und Gruppierungskonfiguration. Ansichten können mit dem Arbeitsbereich geteilt oder privat gehalten werden.
[Tabellenansichten →](/l/de/user-guide/views-pipelines/capabilities/table-views) · [Kanban-Ansichten →](/l/de/user-guide/views-pipelines/capabilities/kanban-views) · [Kalenderansicht →](/l/de/user-guide/views-pipelines/capabilities/calendar-view)
## Datensatzseiten
Wenn Sie einen Datensatz öffnen, wird die Detailseite aus konfigurierbaren Registerkarten und Widgets aufgebaut. Sie können:
* **Registerkarten hinzufügen, entfernen und neu anordnen** für jeden Datensatztyp
* **Widgets konfigurieren** — Felder, verwandte Datensätze, E-Mails, Zeitleiste, Kalender, Aufgaben, Notizen, Dateien, Diagramme, iFrames und mehr
* **Widgets ziehen und in der Größe ändern** auf einem Rasterlayout
* **Feldsichtbarkeit pro Widget steuern**
Wechseln Sie in den Layout-Anpassungsmodus über das Befehlsmenü (`Cmd+K` → "Layout der Datensatzseite bearbeiten").
[Referenz zu Datensatzseiten →](/l/de/user-guide/layout/capabilities/record-pages)

View File

@@ -0,0 +1,125 @@
---
title: Rechtliche FAQ
description: Häufig gestellte rechtliche Fragen.
---
## Datenwohnsitz und internationale Überweisungen
<AccordionGroup>
<Accordion title="In welchem Land und in welcher Region würden unsere Arbeitsbereichsdaten, Anhänge, Protokolle und Backups gespeichert?">
Zwanzig Cloud läuft auf AWS-Servern in Frankfurt, Deutschland.
</Accordion>
<Accordion title="Kann der Hosting Bereich vertraglich für unseren Arbeitsbereich festgelegt werden?">
Die Auswahl der Hosting-Region wird ab 2027 verfügbar sein, zunächst für neue Workspaces. Benutzer können zu einem späteren Zeitpunkt eine Regionsänderung für einen bestehenden Workspace anfordern. Alternativ können Sie sich an [unsere Partner](https://twenty.com/partners/list?categories=HOSTING) wenden, die Ihnen bei der Einrichtung Ihrer Instanz helfen.
</Accordion>
<Accordion title="Welche Subprozessoren können unsere CRM-Daten verarbeiten oder darauf zugreifen und in welchen Ländern befinden sie sich?">
Eine Liste aller Unterauftragsverarbeiter ist in [unserem Trust Center](https://trust.twenty.com/?tab=subprocessors) verfügbar.
</Accordion>
<Accordion title="Welche Sicherheiten gelten für internationale Datenübertragungen?">
EU-Standardvertragsklauseln, zusammen mit dem UK-Addendum und Schweizer Ergänzungen, gelten für internationale Datenübermittlungen außerhalb der EU, einschließlich der Übermittlungen an alle Unterauftragsverarbeiter.
</Accordion>
</AccordionGroup>
## Datenverarbeitungsvertrag und rechtliche Rollen
<AccordionGroup>
<Accordion title="Wo finden wir die aktuelle Datenverarbeitungsvereinbarung?">
Sie können Ihre unterzeichnete Datenverarbeitungsvereinbarung (DPA) unter https://{your-domain}/settings/legal/dpa (z. B. https://getting-started.twenty.com/settings/legal/dpa) erstellen.
</Accordion>
<Accordion title="Funktioniert Zwanzig als Datenverarbeiter für Händler- und Kontaktinformationen, die im CRM gespeichert sind, während unser Unternehmen der Datenregler bleibt?">
Gemäß unserer [Datenschutzrichtlinie](https://twenty.com/privacy-policy), fungieren 20 als Datenverarbeiter für Händler und Kontaktinformationen, die im CRM gespeichert sind während Ihr Unternehmen bleibt der Data Controller.
</Accordion>
<Accordion title="Werden CRM-Inhalte jemals verwendet, um zwanzig oder andere KI-Modelle zu trainieren?">
CRM-Inhalte können zur Schulung von KI-Modellen verwendet werden, abhängig von den Allgemeinen Geschäftsbedingungen der Unterauftragsverarbeiter. Twenty verfügt über kein eigenes KI-Modell – alle in Twenty Cloud verfügbaren KI-Modelle werden von unseren Unterauftragsverarbeitern bereitgestellt.
</Accordion>
<Accordion title="Wenn eine optionale KI-Verarbeitung existiert, kann sie für unseren Arbeitsbereich vollständig deaktiviert werden?">
KI kann vollständig deaktiviert werden, indem alle KI-Modelle in Einstellungen → AI → Models ausgeschaltet werden. Zusätzlich werden keine Daten an KI gesendet, es sei denn, Sie interagieren aktiv mit dem KI-Chat oder einem KI-Knoten in einem Workflow.
</Accordion>
</AccordionGroup>
## Sicherheit und Zugriffssteuerung
<AccordionGroup>
<Accordion title="Wird Verschlüsselung während der Übertragung und im Ruhezustand verwendet, wie sehen Ihre Verfahren zum Schlüsselmanagement aus und wie werden Mandantendaten isoliert?">
Alle Daten werden während der Übertragung und im Ruhezustand verschlüsselt. Mandantendaten werden durch ein Schema-pro-Mandant-Setup isoliert, und die Verschlüsselungsschlüssel werden regelmäßig rotiert.
</Accordion>
<Accordion title="Welche 20 Mitarbeiter oder Subprozessoren können zu welchen Zwecken auf die Arbeitsbereiche des Kunden zugreifen und wie wird der Zugang genehmigt und protokolliert?">
Die Engineering- und Support-Teams von 20 können auf die Kunden-Arbeitsbereiche zugreifen, um Probleme zu untersuchen und zu beheben. Arbeitsplatzbesitzer kontrollieren: Support-Zugriff kann jederzeit unter Einstellungen → Allgemein → Sicherheit deaktiviert werden und es bleibt aus, bis Sie es wieder einschalten.
</Accordion>
<Accordion title="Was sind Ihre Benachrichtigungen und Zielbenachrichtigungen nach einem bestätigten Sicherheitsfall, der unsere Daten beeinflusst?">
Im Falle einer bestätigten Verletzung personenbezogener Daten, die Ihre Daten betrifft Wir werden Sie unverzüglich und in jedem Fall innerhalb von 48 Stunden nach Bekanntwerden davon in Kenntnis setzen. Unsere Mitteilung wird in dem Umfang, in dem sie zu dem Zeitpunkt bekannt ist, die Art des Verstoßes beinhalten, die Kategorien und ungefähre Menge von Daten und Einzelpersonen betroffen, wahrscheinliche Folgen, und die Maßnahmen zur Sanierung und Abmilderung ergriffen oder geplant. Wir werden die Aktualisierungen zur Verfügung stellen, sobald die Untersuchung fortschreitet.
</Accordion>
</AccordionGroup>
## Datenspeicherung und -löschung
<AccordionGroup>
<Accordion title="Wenn ein einzelner CRM-Eintrag gelöscht wird, wann wird er dann von aktiven Systemen entfernt?">
Wenn ein Datensatz gelöscht wird, wird er zunächst soft gelöscht und kann noch wiederhergestellt werden. Er wird dauerhaft gelöscht und aus aktiven Systemen entfernt, sobald die Aufbewahrungsfrist abläuft oder ein Benutzer ihn manuell vernichtet.
</Accordion>
<Accordion title="Wie lange werden soft gelöschte Datensätze im System aufbewahrt?">
Standardmäßig werden soft gelöschte Datensätze 14 Tage lang aufbewahrt, danach werden sie dauerhaft aus dem System entfernt. Die Aufbewahrungsfrist für soft gelöschte Datensätze kann in Einstellungen → General → Security geändert werden.
</Accordion>
<Accordion title="Wie lange kann diese Aufzeichnung in Backups oder technischen Logs verbleiben?">
Ein entfernter Datensatz bleibt 30 Tage lang in Backups, danach wird er dauerhaft gelöscht.
</Accordion>
<Accordion title="Wenn ein Arbeitsbereich geschlossen oder vollständig gelöscht wird, welche Zeitleiste gilt für Produktionsdaten, Anhänge, Protokolle und Backups?">
Wenn ein Arbeitsbereich gelöscht wird, werden seine Daten innerhalb von etwa 90 Tagen nach Serviceabbruch aus Live-Systemen entfernt und in der Regel viel früher. Sicherungs- und Archivkopien werden dann innerhalb von 90 Tagen überschrieben oder bereinigt, danach werden alle Daten dauerhaft gelöscht. In beiden Perioden werden die Daten von jeglichem operativen Gebrauch isoliert. Auf Anfrage können wir Ihnen eine schriftliche Bescheinigung geben, sobald die Reinigung abgeschlossen ist. Die vollständigen Bedingungen finden Sie unter Klausel 4.9 Ihres Datenverarbeitungsvertrags.
</Accordion>
<Accordion title="Wurde während einer Sicherungslaufzeit Daten vom Zugriff und der Nutzung isoliert?">
Ja, während einer Sicherungslaufzeit werden gelöschte Daten vom operativen Gebrauch isoliert.
</Accordion>
<Accordion title="Sind bestimmte Kategorien von Daten länger für rechtliche, rechtliche, rechtliche, betrugsvorbeugung, Sicherheit oder Prüfzwecke gespeichert? Wenn ja, welche Kategorien und für wie lange?">
Für weitere Informationen über die Vorratsdatenspeicherung können Sie unsere Datenschutzrichtlinie in [unserem Treuhandzentrum](https://trust.twenty.com/?tab=documents) anfordern.
</Accordion>
<Accordion title="Kann Zwanzig eine schriftliche Bestätigung geben, wenn eine vollständige Löschanfrage abgeschlossen wurde?">
Wir bestätigen Löschanfragen und geben nach der Löschung eine schriftliche Bestätigung ab.
</Accordion>
</AccordionGroup>
## Sicherungen und Widerstandskraft
<AccordionGroup>
<Accordion title="Was sind die Sicherungsfrequenz und die Speicherzeit?">
Backups werden kontinuierlich erstellt, mit täglichen Snapshots, und die Aufbewahrungsfrist beträgt 30 Tage.
</Accordion>
<Accordion title="Was ist das Ziel der Erholungspunkte und des Wiederauffüllungszeitraums für 20 Wolken?">
RTO und RPO sind beide 6 Stunden (nach unserer DPA).
</Accordion>
<Accordion title="Was ist der Prozess um eine Restauration anzufordern oder durchzuführen?">
Um eine Wiederherstellung anzufordern, wenden Sie sich bitte über den Support-Chat oder per E-Mail an [contact@twenty.com](mailto:contact@twenty.com).
</Accordion>
<Accordion title="Werden Backups verschlüsselt und in derselben Region wie die primären Arbeitsbereichsdaten gespeichert?">
Alle Backups werden verschlüsselt und an geografisch getrennten Orten innerhalb derselben Gerichtsbarkeit gespeichert (z.B. innerhalb der EU für EU-Daten).
</Accordion>
</AccordionGroup>
## Compliance
<AccordionGroup>
<Accordion title="Ist die DPR 20 kompatibel?">
Ja, Zwanzig ist [DPR konform](https://trust.twenty.com/?tab=securityControls\&frameworks=gdpr_v1).
</Accordion>
<Accordion title="Ist 20 SOC 2 kompatibel?">
Ja, 20 ist [SOC 2 Compliant](https://trust.twenty.com/?tab=securityControls\&frameworks=soc2_v1).
</Accordion>
<Accordion title="Sind 20 HIPAA kompatibel?">
Nein, 20 sind dabei, HIPAA-konform zu werden.
</Accordion>
</AccordionGroup>
## Lizenzierung
<AccordionGroup>
<Accordion title="Wenn ich den Code ändere, um Funktionen hinzuzufügen, die nur intern von meinem Team genutzt werden, muss ich diese Änderungen veröffentlichen?">
Nein. Die Ausführung einer modifizierten Version nur für Ihr eigenes Team gilt nicht als Verbreitung, sodass keine Veröffentlichungspflicht entsteht. Die Netzwerkklausel der AGPL greift, wenn Personen außerhalb Ihrer Organisation über das Netzwerk mit Ihrer modifizierten Instanz interagieren.
</Accordion>
<Accordion title="Wenn ich ein separates Frontend erstelle und Twenty unverändert als Backend verwende, muss ich diese Änderungen dann veröffentlichen?">
Nein. Ihr Frontend ist Ihr eigenes, separates Werk, und die Kommunikation mit Twenty über dessen APIs ändert daran nichts. Da Twenty selbst nicht verändert wurde, gibt es nichts zu veröffentlichen.
</Accordion>
<Accordion title="Wenn ich den Code ändere, um Funktionen hinzuzufügen, damit ich ihn weiterverkaufen kann, muss ich diese Änderungen veröffentlichen?">
Ja, da Sie den Code ändern, um ihn an andere zu verbreiten, sind Sie verpflichtet, diese Änderungen zu veröffentlichen. Wenn Sie Ihre Änderungen nicht veröffentlichen möchten, können Sie eine Organization-Lizenz erwerben.
</Accordion>
</AccordionGroup>
Wenn Sie weitere Fragen haben, lesen Sie bitte unsere [Allgemeinen Geschäftsbedingungen](https://twenty.com/terms), [Datenschutzerklärung](https://twenty.com/privacy-policy) und unser [Trust Center](https://trust.twenty.com/). Wenn Ihre Fragen weiterhin unbeantwortet bleiben, senden Sie diese an [contact@twenty.com](mailto:contact@twenty.com) oder über den Support-Chat.

View File

@@ -0,0 +1,12 @@
---
title: Rechtliches
description: Rechtliche Themen
---
Sehen Sie sich unsere [FAQ](/l/de/user-guide/legal/how-tos/legal-faq) an.
## Nützliche Links
* [Allgemeine Geschäftsbedingungen](https://twenty.com/terms)
* [Datenschutzerklärung](https://twenty.com/privacy-policy)
* [Trust Center](https://trust.twenty.com/)

View File

@@ -0,0 +1,213 @@
---
title: Berechtigungen
description: Steuern Sie den Zugriff auf Objekte, Felder und Einstellungen mit rollenbasierten Berechtigungen.
---
Das Berechtigungssystem von Twenty ermöglicht es Ihnen, den Zugriff auf drei Hauptbereiche zu steuern:
* **Objekte und Felder**: Kontrollieren Sie, wer Datensätze und einzelne Felder anzeigen, bearbeiten oder löschen kann.
* **Einstellungen**: Verwalten Sie den Zugriff auf die Konfiguration des Arbeitsbereichs und administrative Funktionen.
* **Aktionen**: Steuern Sie allgemeine Arbeitsbereichsaktionen wie das Importieren von Daten oder das Versenden von E-Mails.
## Erstellen Sie eine Rolle
Um eine neue Rolle zu erstellen:
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Unter **Alle Rollen** klicken Sie auf **+ Rolle erstellen**
3. Geben Sie einen Rollennamen ein
4. Im Standard-Tab **Berechtigungen** [Berechtigungen konfigurieren](#customize-permissions)
5. Klicken Sie auf **Speichern**, um den Vorgang abzuschließen
## Löschen Sie eine Rolle
Um eine Rolle zu löschen:
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Klicken Sie auf die Rolle, die Sie entfernen möchten
3. Öffnen Sie den Tab **Einstellungen** und klicken Sie auf **Rolle löschen**
4. Klicken Sie im Modal auf **Bestätigen**
<Note>
Wenn eine Rolle gelöscht wird, wird jedes ihr zugewiesene Mitglied des Arbeitsbereichs automatisch der Standardrolle zugewiesen. Alle Rollen außer der **Admin** Rolle können gelöscht werden. Es muss immer mindestens ein Mitglied der **Admin**-Rolle zugewiesen sein.
</Note>
## Rollen an Mitglieder zuweisen
### Aktuelle Zuweisungen anzeigen
* Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
* Sehen Sie alle Rollen und wie viele Mitglieder jeweils zugewiesen sind
* Anzeigen, welche Mitglieder welche Rollen haben
### Weisen Sie einem Mitglied eine Rolle zu
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Klicken Sie auf die Rolle, die Sie zuweisen möchten
3. Öffnen Sie den Tab **Zuweisungen**
4. Klicken Sie auf **+ Mitglied zuweisen**
5. Wählen Sie das Mitglied des Arbeitsbereichs aus der Liste aus
6. Bestätigen Sie die Zuweisung
### Standardrolle festlegen
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Suchen Sie im Abschnitt **Optionen** nach **Standardrolle**
3. Wählen Sie aus, welche Rolle neue Mitglieder automatisch erhalten sollen
4. Neue Arbeitsbereichsmitglieder werden beim Beitritt dieser Rolle zugewiesen
<Note>
Sie können Rollen nur vorhandenen Mitgliedern des Arbeitsbereichs zuweisen. Um neue Mitglieder einzuladen, verwenden Sie die [Mitgliederverwaltung](/l/de/user-guide/settings/capabilities/member-management).
</Note>
## Berechtigungen anpassen
Berechtigungen bestimmen, was jede Rolle in Ihrem Arbeitsbereich zugreifen oder verändern kann, einschließlich Arbeitsbereichsobjekte, Datensätze, Einstellungen und Aktionen.
### Objektberechtigungen
Der Abschnitt **Objekte** legt fest, was diese Rolle mit Datensätzen in Ihrem Arbeitsbereich tun kann.
#### Standardberechtigungen festlegen (alle Objekte)
Konfigurieren Sie zunächst die Basisberechtigungen, die standardmäßig für **alle Objekte** gelten:
| Berechtigung | Beschreibung |
| -------------------------------------------- | -------------------------------------------------------------- |
| **Datensätze auf allen Objekten anzeigen** | Datensätze in Listen und auf Detailseiten ansehen |
| **Datensätze auf allen Objekten bearbeiten** | Vorhandene Datensätze bearbeiten |
| **Datensätze auf allen Objekten löschen** | Datensätze vorläufig löschen (können wiederhergestellt werden) |
| **Datensätze auf allen Objekten zerstören** | Datensätze dauerhaft löschen |
Auswählen oder abwählen, je nachdem, welches Standardverhalten für diese Rolle gelten soll.
<Note>
**Beispiel — Praktikantenrolle**: Ein Praktikant sollte standardmäßig alle Objekte sehen können, sie jedoch nicht bearbeiten. Aktivieren Sie „Datensätze bei allen Objekten ansehen“, lassen Sie „Datensätze bei allen Objekten bearbeiten“ deaktiviert.
</Note>
#### Ausnahmen auf Objektebene hinzufügen
Nachdem Sie die Standardwerte festgelegt haben, verwenden Sie den Unterabschnitt **Objektebene**, um Regeln hinzuzufügen, die die Standardwerte für bestimmte Objekte außer Kraft setzen.
Klicken Sie auf **+ Regel hinzufügen** und wählen Sie ein Objekt aus, um eine Ausnahme zu erstellen.
**Beispielregeln für eine Praktikantenrolle:**
| Regel | Auswirkung |
| ------------------------------------------------- | ------------------------------------------------------------------------- |
| Opportunities → „Datensätze ansehen“ deaktivieren | Praktikant kann das Opportunities-Objekt überhaupt nicht sehen |
| People → „Datensätze bearbeiten“ aktivieren | Praktikant kann People-Datensätze bearbeiten (aber keine anderen Objekte) |
### Berechtigungen auf Zeilenebene
<Note>
Berechtigungen auf Zeilenebene sind ein **Premium-Feature**, das im Tarif **Organization** (Cloud und Self-Hosted) verfügbar ist.
</Note>
Berechtigungen auf Zeilenebene ermöglichen es dir, anhand dynamischer Kriterien einzuschränken, welche einzelnen Datensätze eine Rolle sehen oder bearbeiten kann. Im Gegensatz zu Objektberechtigungen (die für einen gesamten Objekttyp gelten) werden Berechtigungen auf Zeilenebene für jeden Datensatz einzeln ausgewertet.
**Beispielanwendungsfälle:**
* Vertriebsmitarbeitende können nur ihre eigenen Opportunities sehen
* Manager:innen können alle Datensätze in ihrer Region sehen
* Support-Mitarbeitende können nur Tickets sehen, die ihnen zugewiesen sind
Um Berechtigungen auf Zeilenebene zu konfigurieren, öffne eine Rolle, navigiere zum Tab **Objects** und verwende den Abschnitt **Row-Level**, um Filterbedingungen für ein bestimmtes Objekt zu definieren.
### Feldberechtigungen
Innerhalb jeder Regel auf Objektebene können Sie weitergehen und **Berechtigungen auf Feldebene** konfigurieren, um den Zugriff auf bestimmte Felder zu steuern.
| Berechtigung | Beschreibung |
| ------------------- | --------------------------------- |
| **Feld anzeigen** | Den Feldwert anzeigen |
| **Feld bearbeiten** | Den Feldwert bearbeiten |
| **Kein Zugriff** | Feld ist vollständig ausgeblendet |
**Beispiel — Sensible Felder einschränken:**
Für die Praktikantenrolle mit Bearbeitungszugriff auf People möchten Sie eventuell bestimmte Felder einschränken:
* People → Email → nur **Feld anzeigen** (kann nicht bearbeitet werden)
* People → Address → **Kein Zugriff** (vollständig ausgeblendet)
So kann der Praktikant die meisten People-Felder bearbeiten, während sensible Informationen geschützt werden.
### So funktioniert die Vererbung von Berechtigungen
Berechtigungen kaskadieren von global zu spezifisch:
1. **Alle Objekte** → legt die Basis für alle Objekte fest
2. **Regeln auf Objektebene** → setzen die Basis für bestimmte Objekte außer Kraft
3. **Regeln auf Feldebene** → setzen die Objekteinstellung für bestimmte Felder außer Kraft
Spezifischere Einstellungen haben immer Vorrang.
### Verwaltung von Berechtigungsüberschreibungen
So setzen Sie geerbte Berechtigungen außer Kraft:
1. Klicken Sie auf **X**, um die vererbte Regel zu entfernen
2. Wählen Sie die gewünschten spezifischen Berechtigungen aus
3. Klicken Sie auf das orange **Rückgängig**-Symbol (kreisförmiger Pfeil), um Änderungen rückgängig zu machen
Wenn Sie fertig sind, klicken Sie auf **Beenden**, und dann auf **Speichern**, sobald Sie zur Rollenseite weitergeleitet werden.
### Berechtigungen für Arbeitsbereichseinstellungen
Steuern Sie den Zugriff auf die Einstellungen des Arbeitsbereichs auf zwei Arten:
* Schalten Sie **Einstellungen Alles Zugriff** ein, um vollen Zugriff zu gewähren
* Oder aktivieren Sie bestimmte Berechtigungen (z.B. API-Schlüsselgenerierung, Arbeitsbereich-Präferenzen, Rollenzuweisung, Datenmodellkonfiguration, Sicherheitseinstellungen und Workflow-Management)
<Note>
**Aktuelle Einschränkung**: Für das manuelle Auslösen von Workflows ist derzeit Zugriff auf die Workflow-Verwaltung erforderlich. Dieses Verhalten kann sich in zukünftigen Versionen ändern.
</Note>
### Arbeitsbereichs-Aktionsberechtigungen
Steuern Sie den Zugriff auf allgemeine Arbeitsbereichsaktionen:
* Schalten Sie **Anwendung Alles Zugriff** ein, um volle Berechtigungen zu gewähren
* Oder aktivieren Sie individuelle Aktionen wie **E-Mail senden**, **CSV importieren** und **CSV exportieren**
## API-Schlüssel und KI-Agenten Rollen zuweisen
Neben Mitgliedern des Arbeitsbereichs können Rollen auch **API-Schlüsseln** und **KI-Agenten** zugewiesen werden. Dies ist besonders hilfreich für Teams, die genau steuern möchten, „wer“ was in ihrem Arbeitsbereich tun kann — einschließlich automatisierter Prozesse und Integrationen.
### Warum Rollen API-Schlüsseln und KI-Agenten zuweisen?
* **Sicherheit**: Beschränken, worauf automatisierte Prozesse zugreifen oder was sie ändern können
* **Compliance**: Sicherstellen, dass Integrationen nur die Daten berühren, die sie benötigen
* **Kontrolle**: Verhindern unbeabsichtigter Datenänderungen durch falsch konfigurierte Automatisierungen
* **Nachvollziehbarkeit**: Nachverfolgen, welche Aktionen von welcher Integration oder welchem Agenten ausgeführt wurden
### Einem API-Schlüssel eine Rolle zuweisen
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Klicken Sie auf die Rolle, die Sie zuweisen möchten
3. Öffnen Sie den Tab **Zuweisungen**
4. Unter **API-Schlüssel** auf **+ API-Schlüssel zuweisen** klicken
5. Wählen Sie den API-Schlüssel aus der Liste aus
6. Bestätigen Sie die Zuweisung
Der API-Schlüssel erbt nun alle von dieser Rolle definierten Berechtigungen. Alle mit diesem Schlüssel ausgeführten API-Aufrufe werden entsprechend eingeschränkt.
<Note>
API-Schlüssel ohne zugewiesene Rolle verwenden Standardberechtigungen. Weisen Sie Produktions-API-Schlüsseln zur höheren Sicherheit stets eine spezifische Rolle zu.
</Note>
### Einem KI-Agenten eine Rolle zuweisen
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Klicken Sie auf die Rolle, die Sie zuweisen möchten
3. Öffnen Sie den Tab **Zuweisungen**
4. Unter **KI-Agenten** auf **+ KI-Agenten zuweisen** klicken
5. Wählen Sie den KI-Agenten aus der Liste aus
6. Bestätigen Sie die Zuweisung
Der KI-Agent kann nur auf Daten zugreifen und Aktionen ausführen, die seine zugewiesene Rolle erlaubt.
<Note>
Für KI-Agenten, die innerhalb von Workflows laufen, stellt dies sicher, dass der Agent nicht auf Daten außerhalb seines vorgesehenen Umfangs zugreifen oder diese ändern kann — selbst wenn der Workflow über weitergehende Berechtigungen verfügt.
</Note>

View File

@@ -0,0 +1,125 @@
---
title: SSO-Konfiguration
description: Konfigurieren Sie Single Sign-On für eine sichere Unternehmensauthentifizierung.
---
## Über SSO
Single Sign-On (SSO) ermöglicht es Ihren Teammitgliedern, sich mit dem Identitätsanbieter Ihrer Organisation bei Twenty anzumelden. Dies bietet:
* **Zentralisierte Zugriffskontrolle**: Verwalten Sie den Zugriff von einem Ort aus
* **Verbesserte Sicherheit**: Nutzen Sie Ihre bestehenden Sicherheitsrichtlinien
* **Bessere Benutzererfahrung**: Ein Satz Anmeldedaten für alle Tools
## Unterstützte Anbieter
Twenty unterstützt SSO mit:
* **SAML 2.0**: Funktioniert mit den meisten Identitätsanbietern für Unternehmen
* **Google Workspace**: Für Organisationen, die Google verwenden
* **Microsoft Entra ID** (früher Azure AD): Für Microsoft-Umgebungen
## SSO einrichten
### Voraussetzungen
* Organisationsplan (Cloud- und selbstgehostete Arbeitsbereiche)
* Administratorzugriff auf Ihren Identitätsanbieter
* Admin-Zugriff auf Ihren Zwanzig Arbeitsbereich
### Konfigurationsschritte
#### 1. SSO-Einstellungen aufrufen
1. Gehen Sie zu **Einstellungen → Sicherheit**
2. Suchen Sie den Abschnitt **SSO-Konfiguration**
3. Klicken Sie auf **SSO konfigurieren**
#### 2) Wählen Sie Ihren Anbieter
Wählen Sie Ihren Identitätsanbieter aus der Liste oder wählen Sie "Benutzerdefiniertes SAML" für andere Anbieter.
#### 3. Konfigurieren Sie Ihren Identitätsanbieter
Sie müssen Ihren Identitätsanbieter mit Folgendem konfigurieren:
* **Entity ID**: Bereitgestellt von Twenty
* **ACS-URL**: Die Callback-URL für die Authentifizierung
* **Zertifikat**: Für die sichere Kommunikation
#### 4. Anbieterdetails in Twenty eingeben
* **SSO-URL**: Anmelde-URL Ihres Anbieters
* **Entity ID**: Kennung Ihres Anbieters
* **Zertifikat**: X.509-Zertifikat Ihres Anbieters
#### 5. Testen und aktivieren
1. Klicken Sie auf **Konfiguration testen**, um die Einrichtung zu überprüfen
2. Aktivieren Sie SSO, wenn der Test erfolgreich war
3. Konfigurieren Sie die Einstellungen für die Benutzerbereitstellung
## Benutzerbereitstellung
### Just-in-Time-(JIT)-Bereitstellung
* Benutzer werden bei der ersten Anmeldung automatisch erstellt
* Benutzern wird automatisch eine Standardrolle zugewiesen
* Keine manuelle Benutzererstellung erforderlich
### Manuelle Bereitstellung
* Laden Sie Benutzer ein, bevor sie sich anmelden können
* Bestimmte Rollen vorab zuweisen
* Mehr Kontrolle darüber, wer auf den Arbeitsbereich zugreifen kann
## SSO-Benutzer verwalten
### Rollenzuweisung
SSO-Benutzern können wie regulären Benutzern Rollen zugewiesen werden:
1. Gehen Sie zu **Einstellungen → Mitglieder**
2. Suchen Sie den Benutzer
3. Ändern Sie bei Bedarf die Rolle
### Zugriffsentzug
So entziehen Sie SSO-Benutzern den Zugriff:
* Entfernen Sie sie bei Ihrem Identitätsanbieter oder
* Entfernen Sie sie aus dem Twenty-Arbeitsbereich
## Beste Praktiken
### Sicherheit
* **SSO erzwingen**: Passwortanmeldung für SSO-Benutzer deaktivieren
* **Regelmäßige Audits**: Zugriff regelmäßig überprüfen
* **Strenge IdP-Richtlinien**: MFA beim Identitätsanbieter erzwingen
### Benutzerverwaltung
* **Klare Benennung**: Verwenden Sie eine konsistente Benennung aus Ihrem Verzeichnis
* **Gruppenzuordnung**: Ordnen Sie IdP-Gruppen Twenty-Rollen zu (falls verfügbar)
* **Offboarding-Prozess**: Beziehen Sie Twenty in Ihren Deprovisioning-Workflow ein
## Fehlerbehebung
### Häufige Probleme
* **Zertifikatsfehler**: Stellen Sie sicher, dass das Zertifikat nicht abgelaufen ist
* **URL-Unstimmigkeiten**: Überprüfen Sie, ob die ACS-URL genau entspricht
* **Benutzer nicht gefunden**: Prüfen Sie die Einstellungen für die JIT-Bereitstellung
### Hilfe erhalten
Wenn Sie auf Probleme stoßen, wenden Sie sich mit Folgendem an den Support:
* Erhaltene Fehlermeldungen
* Verwendeter Identitätsanbieter
* Konfigurationsdetails (ohne vertrauliche Daten)
<Tip>
Benötigen Sie eine SSO-Konfiguration für Ihre Organisation? [Finden Sie einen zertifizierten Twenty-Partner](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso), der auf SSO und Identitätseinrichtung spezialisiert ist. *(Sie möchten Twenty lieber direkt einbeziehen? [contact@twenty.com](mailto:contact@twenty.com))*
</Tip>

View File

@@ -0,0 +1,120 @@
---
title: FAQ zu Berechtigungen
description: Häufig gestellte Fragen zu Rollen und Berechtigungen.
---
## Rollen
<AccordionGroup>
<Accordion title="Welche Rollen sind in Twenty standardmäßig enthalten?">
Zwanzig kommt standardmäßig mit **Admin** und **Mitglieder** Rollen. Sie können je nach Bedarf Ihres Teams zusätzliche benutzerdefinierte Rollen erstellen (z. B. Vertriebsmitarbeiter, Manager, Nur-Lese-Benutzer).
</Accordion>
<Accordion title="Kann ich die Admin-Rolle löschen?">
Nein, die Admin-Rolle kann nicht gelöscht werden. Es muss immer mindestens ein Mitglied der Admin-Rolle zugewiesen sein.
</Accordion>
<Accordion title="Was passiert, wenn ich eine Rolle lösche?">
Jedes Mitglied des Arbeitsbereichs, dem diese Rolle zugewiesen ist, wird automatisch der Standardrolle zugewiesen.
</Accordion>
<Accordion title="Wie lege ich eine Standardrolle für neue Mitglieder fest?">
Gehen Sie zu **Einstellungen → Mitglieder → Rollen**, suchen Sie die Option **Standardrolle** und wählen Sie aus, welche Rolle neue Mitglieder beim Beitritt automatisch erhalten sollen.
</Accordion>
<Accordion title="Kann ich einem Benutzer mehrere Rollen zuweisen?">
Nein, jeder Benutzer kann immer nur eine Rolle haben. Erstellen Sie eine benutzerdefinierte Rolle, wenn Sie eine Kombination von Berechtigungen benötigen.
</Accordion>
</AccordionGroup>
## Berechtigungen
<AccordionGroup>
<Accordion title="Was ist der Unterschied zwischen Objekt- und Feldberechtigungen?">
* **Objektberechtigungen**: Steuern den Zugriff auf ganze Datensätze (z. B. kann Personen-Datensätze sehen/bearbeiten/löschen)
* **Feldberechtigungen**: Steuern den Zugriff auf bestimmte Felder innerhalb eines Objekts (z. B. kann das Feld Gehalt sehen, aber nicht bearbeiten)
Feldberechtigungen ermöglichen eine granularere Kontrolle über sensible Daten.
</Accordion>
<Accordion title="Wie funktionieren Berechtigungsüberschreibungen?">
Berechtigungen werden vom Allgemeinen zum Spezifischen vererbt:
1. **Alle Objekte** legt die Basis für alle Objekte fest
2. **Berechtigungen auf Objektebene** können die globale Einstellung für bestimmte Objekte überschreiben
3. **Berechtigungen auf Feldebene** können die Objekteinstellung für bestimmte Felder überschreiben
Spezifischere Einstellungen haben immer Vorrang.
</Accordion>
<Accordion title="Was bedeuten die verschiedenen Berechtigungsstufen?">
Für Objekte:
* **Datensätze anzeigen**: Datensätze in Listen und auf Detailseiten ansehen
* **Datensätze bearbeiten**: Vorhandene Datensätze ändern
* **Datensätze löschen**: Datensätze vorläufig löschen (können wiederhergestellt werden)
* **Datensätze vernichten**: Datensätze dauerhaft löschen
Für Felder:
* **Feld anzeigen**: Feldwert anzeigen
* **Feld bearbeiten**: Feldwert ändern
* **Kein Zugriff**: Feld ist vollständig ausgeblendet
</Accordion>
<Accordion title="Kann ich den Zugriff auf bestimmte Datensätze einschränken (Berechtigungen auf Zeilenebene)?">
Berechtigungen auf Zeilenebene sind im Tarif **Organization** verfügbar. Damit können Sie den Zugriff auf bestimmte Datensätze anhand von Kriterien einschränken (z. B. nur die eigenen Verkaufschancen sehen).
</Accordion>
<Accordion title="Wie mache ich ein Feld für bestimmte Benutzer schreibgeschützt?">
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Wählen Sie die Rolle aus
3. Navigieren Sie zu dem Objekt, das das Feld enthält
4. Setzen Sie die Feldberechtigung auf **Feld anzeigen** (ohne Feld bearbeiten)
</Accordion>
</AccordionGroup>
## Einstellungen & Aktionen
<AccordionGroup>
<Accordion title="Welche Berechtigungen für Einstellungen sind verfügbar?">
Sie können den Zugriff auf Folgendes steuern:
* Erstellung von API-Schlüsseln
* Arbeitsbereichseinstellungen
* Rollenzuweisung
* Konfiguration des Datenmodells
* Sicherheitseinstellungen
* Workflow-Management
Verwenden Sie **Settings All Access**, um vollen Zugriff zu gewähren, oder aktivieren Sie bestimmte Berechtigungen.
</Accordion>
<Accordion title="Welche Berechtigungen für Aktionen sind verfügbar?">
Sie können steuern:
* **E-Mail senden**: Möglichkeit, E-Mails aus Twenty zu senden
* **CSV importieren**: Möglichkeit, Daten per CSV zu importieren
* **CSV exportieren**: Möglichkeit, Daten als CSV zu exportieren
Verwenden Sie **Application All Access**, um alle Aktionen zu gewähren, oder aktivieren Sie einzelne.
</Accordion>
</AccordionGroup>
## SSO
<AccordionGroup>
<Accordion title="Ist SSO in allen Tarifen verfügbar?">
Nein, SSO ist eine Premium-Funktion und nur im Tarif **Organization** verfügbar.
</Accordion>
<Accordion title="Welche Identitätsanbieter werden unterstützt?">
Twenty unterstützt:
* **SAML 2.0** (funktioniert mit den meisten Identitätsanbietern für Unternehmen)
* **Google Workspace**
* **Microsoft Entra ID** (früher Azure AD)
</Accordion>
<Accordion title="Was ist Just-in-Time-(JIT)-Bereitstellung?">
Mit JIT-Bereitstellung werden Benutzerkonten in Twenty automatisch erstellt, wenn sich jemand zum ersten Mal über SSO anmeldet. Ihnen wird automatisch die Standardrolle zugewiesen.
</Accordion>
<Accordion title="Kann ich SSO für alle Benutzer erzwingen?">
Ja, sobald SSO konfiguriert ist, können Sie die Anmeldung per Passwort für SSO-Benutzer deaktivieren, um die Authentifizierung über Ihren Identitätsanbieter durchzusetzen.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,34 @@
---
title: Berechtigungen & Zugriff
description: Verwalten Sie Rollen, Berechtigungen und die Zugriffskontrolle in Ihrem Arbeitsbereich.
---
Das Berechtigungssystem von Twenty ermöglicht es Ihnen, zu steuern, wer in Ihrem Arbeitsbereich auf Daten zugreifen und diese ändern darf. Erstellen Sie Rollen, weisen Sie Berechtigungen zu und konfigurieren Sie SSO für sicheren Zugriff.
## Was Sie in diesem Abschnitt finden
<CardGroup cols={2}>
<Card title="Berechtigungen" icon="lock" href="/l/de/user-guide/permissions-access/capabilities/permissions">
Erstellen Sie Rollen und konfigurieren Sie Objekt-, Feld- und Einstellungsberechtigungen.
</Card>
<Card title="SSO-Konfiguration" icon="key" href="/l/de/user-guide/permissions-access/capabilities/sso-configuration">
Richten Sie Single Sign-On mit Ihrem Identitätsanbieter ein.
</Card>
<Card title="FAQ" icon="circle-question" href="/l/de/user-guide/permissions-access/how-tos/permissions-faq">
Häufige Fragen zu Rollen, Berechtigungen und SSO.
</Card>
</CardGroup>
## Hauptfunktionen
* **Rollenbasierter Zugriff**: Erstellen Sie benutzerdefinierte Rollen mit spezifischen Berechtigungen
* **Objektberechtigungen**: Kontrollieren Sie, wer Datensätze anzeigen, bearbeiten oder löschen kann
* **Feldberechtigungen**: Beschränken Sie den Zugriff auf sensible Felder
* **Einstellungsberechtigungen**: Steuern Sie den Zugriff auf die Konfiguration des Arbeitsbereichs
* **SSO-Integration**: Konfigurieren Sie Single Sign-On für Unternehmenssicherheit (Organization-Plan)
## Schnellzugriffe
* [Rolle erstellen](/l/de/user-guide/permissions-access/capabilities/permissions#create-a-role)
* [SSO konfigurieren](/l/de/user-guide/permissions-access/capabilities/sso-configuration)
* [Teammitglieder verwalten](/l/de/user-guide/settings/capabilities/member-management)

View File

@@ -0,0 +1,36 @@
---
title: Community-Einstellungen
description: Aktivieren Sie Early-Access-Funktionen in Twenty.
---
## Über die Community-Einstellungen
Im Bereich Community können Sie Early-Access-Funktionen aktivieren, bevor sie allgemein verfügbar sind, sowie nach Twenty-Partnern suchen.
## Early-Access-Funktionen
Early-Access-Funktionen sind Funktionen, die vor der allgemeinen Verfügbarkeit noch getestet werden.
**Derzeit im Early Access:**
* **Verknüpfungsbeziehungen** — Viele-zu-viele-Beziehungen
### So aktivieren Sie Early-Access-Funktionen
1. Gehen Sie zu **Einstellungen → Community**
2. Navigieren Sie zum Bereich **Funktionen**
3. Suchen Sie die Funktion, die Sie aktivieren möchten
4. Aktivieren Sie sie
5. Die Funktion ist sofort verfügbar
<Note>
Early-Access-Funktionen können sich je nach Nutzerfeedback ändern. Ihr Feedback hilft uns, Twenty zu verbessern!
</Note>
## Feedback zu Funktionen
Ihr Feedback hilft, Twenty zu verbessern:
* Melden Sie Probleme mit Early-Access-Funktionen
* Teilen Sie mit, wie Sie neue Funktionen nutzen
* Schlagen Sie Verbesserungen über den [Community-Discord](https://discord.gg/cx5n4Jzs57) vor

View File

@@ -0,0 +1,52 @@
---
title: Domäneneinstellungen
description: Konfigurieren Sie die Arbeitsbereichsdomäne, genehmigte Zugriffsdomänen und benutzerdefinierte App-Domänen.
---
Domain-Einstellungen befinden sich an drei Stellen, abhängig davon, was Sie konfigurieren.
## Arbeitsbereichsdomäne
Konfigurieren Sie unter **Einstellungen → Allgemein**.
Bearbeiten Sie den Namen Ihrer Subdomäne oder legen Sie eine benutzerdefinierte Domäne für Ihren Arbeitsbereich fest.
### Domäne anpassen
1. Klicke **Subdomain** um deine Subdomain zu bearbeiten (z.B. `yourcompany.twenty.com`)
2. Oder klicke **Benutzerdefinierte Domain** um eine eigene Domain einzurichten (z.B. `crm.yourcompany.com`)
Für benutzerdefinierte Domänen müssen Sie die DNS-Einstellungen bei Ihrem Domänenanbieter konfigurieren.
## Genehmigte Domänen
Konfigurieren Sie dies unter **Einstellungen → Mitglieder → Einladen**.
Fügen Sie Ihre Firmendomain hinzu, damit sich Teammitglieder automatisch für diesen Arbeitsbereich anmelden.
### Genehmigte Zugriffsdomäne hinzufügen
1. Klicken Sie auf **Genehmigte Zugriffsdomäne hinzufügen**
2. Geben Sie die Domäne Ihres Unternehmens ein (z. B. `yourcompany.com`)
3. Speichern
Nach der Konfiguration kann jede Person mit einer E-Mail-Adresse in dieser Domäne Ihrem Arbeitsbereich beitreten, ohne eine direkte Einladung zu benötigen.
<Note>
Dies ist nützlich, um Ihrem gesamten Team die Selbstregistrierung zu ermöglichen, während der Arbeitsbereich auf Ihre Organisation beschränkt bleibt.
</Note>
## Benutzerdefinierte App-Domänen
Konfigurieren Sie dies unter **Einstellungen → Apps → Ihre App → Einstellungen → App URL**.
Apps, die Routen im Web bereitstellen, werden von einer dedizierten URL ausgeliefert, die im Abschnitt **App URL** angezeigt wird. Sie können eine App stattdessen von einer Domäne bereitstellen, die Ihnen gehört.
### Benutzerdefinierte Domäne hinzufügen
1. Klicke **Benutzerdefinierte Domain**
2. Geben Sie die Domäne ein, die Sie verwenden möchten (z. B. `app.yourcompany.com`)
3. Konfigurieren Sie die DNS-Einstellungen gemäß Anleitung
4. Überprüfen Sie die Domäne
Nur die Routen dieser App sind über die Domäne erreichbar. SSL-Zertifikate werden automatisch bereitgestellt.

View File

@@ -0,0 +1,38 @@
---
title: Erfahrung - Einstellungen
description: Passen Sie Ihr Interface-Thema und regionale Präferenzen an.
---
Personalisieren Sie Ihr Twenty-Erlebnis unter **Settings → Experience**.
## Erscheinungsbild
Wählen Sie Ihr visuelles Design:
* **Hell**: Aufgeräumte, helle Oberfläche
* **Dunkel**: Angenehmer für die Augen bei schwachem Licht
* **Systemeinstellungen**: Passt sich automatisch dem Design Ihres Geräts an
## Sprache
Wählen Sie Ihre bevorzugte Sprache für die Twenty-Oberfläche über das Dropdown-Menü.
## Formate
Konfigurieren Sie Datum, Uhrzeit, Zahlenformat, Zeitzone und den ersten Wochentag im Kalender.
| Einstellung | Beschreibung |
| -------------------- | -------------------------------------------------------- |
| **Zeitzone** | Ihre lokale Zeitzone für präzise Zeitstempel und Planung |
| **Datumsformat** | Wie Datumsangaben angezeigt werden (z. B. 12. Dez. 2025) |
| **Zeitformat** | 12-Stunden-Format (7:22 PM) oder 24-Stunden-Format |
| **Zahlenformat** | Dezimal- und Tausendertrennzeichen (z. B. 1.234,56) |
| **Kalenderstarttag** | Erster Wochentag (Sonntag oder Montag) |
Jede Einstellung kann auf **Systemeinstellungen** gesetzt werden, um sich automatisch an die Einstellungen Ihres Geräts anzupassen, oder Sie wählen ein bestimmtes Format.
## So aktualisieren Sie
1. Gehen Sie zu **Einstellungen → Erlebnis**
2. Passen Sie Ihre Präferenzen in jedem Abschnitt an
3. Änderungen werden automatisch gespeichert

View File

@@ -0,0 +1,86 @@
---
title: Mitgliederverwaltung
description: Teammitglieder einladen und den Zugriff auf den Arbeitsbereich verwalten.
---
Verwalten Sie unter **Einstellungen → Mitglieder**, wer Zugriff auf Ihren Arbeitsbereich hat.
## Neue Mitglieder einladen
### Verwendung der E-Mail-Einladung
1. Gehen Sie zu **Einstellungen → Mitglieder → Einladen**
2. Klicken Sie auf **+ Einladen**
3. Geben Sie die E-Mail-Adresse der Person ein
4. Wählen Sie eine Rolle für das neue Mitglied aus
5. Klicken Sie auf **Einladung senden**
Die eingeladene Person erhält eine E-Mail mit einem Link, um Ihrem Arbeitsbereich beizutreten.
### Verwendung des Einladungslinks
1. Gehen Sie zu **Einstellungen → Mitglieder → Einladen**
2. Kopieren Sie den Einladungslink für den Arbeitsbereich
3. Teilen Sie den Link mit neuen Teammitgliedern
4. Sie erhalten Zugriff, sobald sie sich anmelden
## Mitglieder anzeigen und verwalten
### Alle Mitglieder anzeigen
Gehe zu **Einstellungen → Mitglieder → Team** um alle aktiven Mitglieder zu sehen
Gehe zu **Einstellungen → Mitglieder → Einladungen** um ausstehende Einladungen zu sehen
### Profil eines Mitglieds bearbeiten
Klicken Sie auf ein Mitglied, um dessen Profilseite zu öffnen. Als Administrator können Sie:
* Den **Namen** bearbeiten
* Das **Profilbild** aktualisieren
* **Konto übernehmen** (nützlich zur Fehlerbehebung)
* **Löschen** des Kontos
### Rolle eines Mitglieds ändern
Auf der Profilseite des Mitglieds:
1. Öffnen Sie den Tab **Berechtigungen**
2. Die aktuell zugewiesene Rolle ansehen
3. Wählen Sie im Dropdown-Menü eine andere Rolle aus
4. Die Änderung wird sofort wirksam
→ [Weitere Informationen zu Rollen und Berechtigungen](/l/de/user-guide/permissions-access/capabilities/permissions)
### Mitglied entfernen
1. Klicken Sie auf das Mitglied, um dessen Profil zu öffnen
2. Klicke **Konto löschen** um es aus dem Arbeitsbereich zu entfernen
<Warning>
Entfernte Mitglieder verlieren den Zugriff sofort. Ihre Daten (Datensätze, Notizen, Aufgaben) bleiben im Arbeitsbereich erhalten.
</Warning>
<Note>
E-Mails und Termine des gelöschten Mitglieds sind archiviert und für andere Mitglieder verfügbar.
</Note>
## Ausstehende Einladungen
Verwalten Sie Einladungen, die noch nicht angenommen wurden:
* **Erneut senden**: Die Einladungs-E-Mail erneut senden
* **Abbrechen**: Die Einladung widerrufen, bevor sie angenommen wird
## Genehmigte Zugriffsdomänen
Erlauben Sie Teammitgliedern, basierend auf ihrer E-Mail-Domäne automatisch beizutreten:
1. Gehen Sie zu **Einstellungen → Mitglieder → Einladen**
2. Fügen Sie die Domäne Ihres Unternehmens hinzu (z. B. `yourcompany.com`)
3. Jede Person mit dieser E-Mail-Domäne kann ohne Einladung beitreten
## Verwandt
* [Berechtigungen](/l/de/user-guide/permissions-access/capabilities/permissions) — konfigurieren, was jede Rolle tun kann
* [Domain-Einstellungen](/l/de/user-guide/settings/capabilities/domains-settings) — genehmigte Domains konfigurieren

View File

@@ -0,0 +1,43 @@
---
title: Profileinstellungen
description: Verwalten Sie Ihr persönliches Profil und Ihre Sicherheitseinstellungen.
---
## Persönliche Informationen
### Name und E-Mail
* **Anzeigename**: Aktualisieren Sie, wie Ihr Name anderen Mitgliedern des Arbeitsbereichs angezeigt wird
* **E-Mail-Adresse**: Ändern Sie Ihre Login-E-Mail (erfordert Bestätigung)
* **Profilbild**: Laden Sie einen benutzerdefinierten Avatar hoch oder verwenden Sie Ihre Initialen
## Sicherheitseinstellungen
### Zwei-Faktor-Authentifizierung (2FA)
Aktivieren Sie 2FA, um Ihrem Konto eine zusätzliche Sicherheitsebene hinzuzufügen:
1. Gehen Sie zu **Einstellungen → Profil**
2. Klicken Sie auf **Authentifikator-App**
3. Scannen Sie den QR-Code mit Ihrer Authentifizierungs-App
4. Geben Sie den Bestätigungscode ein, um zu bestätigen
### Passwortverwaltung
* **Passwort ändern**: Aktualisieren Sie Ihr aktuelles Passwort
* **Passwortanforderungen**: Muss mindestens 8 Zeichen lang sein
## Profilverwaltung
### Konto löschen
<Warning>
Wenn Sie Ihr Konto löschen, wird Ihr Zugriff auf alle Arbeitsbereiche dauerhaft entfernt. Diese Aktion kann nicht rückgängig gemacht werden. Du verlierst den Zugriff auf alle Arbeitsbereiche, in denen du Mitglied bist. Wenn du nur bestimmte Teams verlassen möchtest, solltest du stattdessen einzelne Arbeitsbereiche verlassen.
</Warning>
Um Ihr Konto zu löschen:
1. Gehen Sie zu **Einstellungen → Profil**
2. Scrollen Sie zu **Gefahrenbereich**
3. Klicken Sie auf **Konto löschen**
4. Bestätigen Sie, indem Sie Ihre E-Mail-Adresse eingeben

View File

@@ -0,0 +1,30 @@
---
title: Arbeitsbereichseinstellungen
description: Passen Sie den Namen und das Branding Ihres Arbeitsbereichs an.
---
Ihr Arbeitsbereichsbild, -name und Löschoptionen sind alle unter **Einstellungen → Allgemein** zugänglich.
## Arbeitsbereichsbild
* **Logo hochladen**: Ein benutzerdefiniertes Arbeitsbereichs-Logo hinzufügen
* **Unterstützte Formate**: PNG-, JPEG- und GIF-Dateien unter 10 MB
* **Entfernen**: Das aktuelle Arbeitsbereichs-Logo löschen
## Arbeitsbereichsname
* **Name**: Anzeigenamen Ihres Arbeitsbereichs ändern
* Dieser Name erscheint für alle Mitglieder des Arbeitsbereichs
## Gefahrenzone
<Warning>
Durch das Löschen Ihres Arbeitsbereichs werden alle Daten dauerhaft entfernt und der Zugriff für alle Mitglieder sofort widerrufen – diese Aktion kann nicht rückgängig gemacht werden.
</Warning>
Um Ihren Arbeitsbereich zu löschen:
1. Klicke auf den Button **Arbeitsbereich löschen**
2. Bestätigen Sie die Löschung, wenn Sie dazu aufgefordert werden
**Hinweis**: Nur Arbeitsbereich-Administratoren können Arbeitsbereiche löschen.

View File

@@ -0,0 +1,171 @@
---
title: Einstellungen FAQ
description: Häufig gestellte Fragen zu den Twenty-Einstellungen.
---
## Arbeitsbereichseinstellungen
<AccordionGroup>
<Accordion title="Wie ändere ich den Namen meines Arbeitsbereichs?">
1. Gehen Sie zu **Einstellungen → Allgemein**
2. Suchen Sie das Feld Arbeitsbereichsname
3. Geben Sie Ihren neuen Namen ein
4. Änderungen werden automatisch gespeichert
</Accordion>
<Accordion title="Wie aktualisiere ich das Logo meines Arbeitsbereichs?">
1. Gehen Sie zu **Einstellungen → Allgemein**
2. Klicken Sie auf das aktuelle Logo oder den Upload-Bereich
3. Wählen Sie eine Bilddatei aus (PNG, JPEG oder GIF unter 10 MB)
4. Das Logo wird sofort aktualisiert
</Accordion>
<Accordion title="Kann ich mehrere Arbeitsbereiche haben?">
Ja, Sie können mehrere Arbeitsbereiche erstellen und ihnen als Mitglied angehören. Jeder Arbeitsbereich hat seine eigenen Daten, Einstellungen und ein eigenes Abonnement.
</Accordion>
<Accordion title="Wie lösche ich meinen Arbeitsbereich?">
1. Gehen Sie zu **Einstellungen → Allgemein**
2. Scrollen Sie zum Gefahrenbereich
3. Klicken Sie auf **Arbeitsbereich löschen**
4. Bestätigen Sie das Löschen
Hinweis: Dadurch werden alle Daten dauerhaft gelöscht und der Vorgang lässt sich nicht rückgängig machen.
</Accordion>
<Accordion title="Ich habe versehentlich mehrere Arbeitsbereiche erstellt. Was sollte ich tun?">
Löschen Sie die Arbeitsbereiche, die Sie nicht mehr benötigen, unter **Einstellungen → Allgemein → Arbeitsbereich löschen**.
<Warning>
Löschen Sie nicht Ihr **Konto** (unter Einstellungen → Profil erreichbar): Ihr Konto wird von all Ihren Arbeitsbereichen gemeinsam genutzt. Wenn Sie Ihr Konto löschen, verlieren Sie den Zugriff auf ALLE Arbeitsbereiche.
</Warning>
</Accordion>
<Accordion title="Wie kann ich meinen Arbeitsbereich deaktivieren, ohne ihn zu löschen?">
Wenn Sie Ihren Arbeitsbereich vorübergehend deaktivieren möchten (nicht dauerhaft löschen), gehen Sie zu **Einstellungen → Abrechnung** und klicken Sie auf **Plan kündigen**. Ihre Daten werden für einen Kulanzzeitraum aufbewahrt.
</Accordion>
</AccordionGroup>
## Profileinstellungen
<AccordionGroup>
<Accordion title="Wie ändere ich mein Passwort?">
1. Gehen Sie zu **Einstellungen → Profil**
2. Suchen Sie den Abschnitt Passwort
3. Geben Sie Ihr aktuelles Passwort ein
4. Geben Sie Ihr neues Passwort ein
5. Änderungen speichern
</Accordion>
<Accordion title="Wie aktiviere ich die Zwei-Faktor-Authentifizierung?">
1. Gehen Sie zu **Einstellungen → Profil**
2. Suchen Sie den Abschnitt 2FA
3. Klicken Sie auf **2FA aktivieren**
4. Scannen Sie den QR-Code mit Ihrer Authentifizierungs-App
5. Geben Sie den Bestätigungscode ein
</Accordion>
<Accordion title="Kann ich meine E-Mail-Adresse ändern?">
Um Ihre E-Mail-Adresse zu ändern, wenden Sie sich bitte an [contact@twenty.com](mailto:contact@twenty.com).
</Accordion>
<Accordion title="Wie lösche ich mein Konto?">
1. Gehen Sie zu **Einstellungen → Profil**
2. Scrollen Sie zum Gefahrenbereich
3. Klicken Sie auf **Konto löschen**
4. Bestätigen Sie, indem Sie Ihre E-Mail-Adresse eingeben
Hinweis: Dadurch verlieren Sie den Zugriff auf alle Arbeitsbereiche und alle E-Mails, die von Ihren verbundenen Konten synchronisiert wurden, werden gelöscht.
</Accordion>
</AccordionGroup>
## Erfahrung - Einstellungen
<AccordionGroup>
<Accordion title="Wie wechsle ich zwischen hellem und dunklem Modus?">
1. Gehen Sie zu **Einstellungen → Erlebnis**
2. Suchen Sie den Abschnitt Thema
3. Wählen Sie Hell, Dunkel oder System
</Accordion>
<Accordion title="Wie ändere ich das Datumsformat?">
1. Gehen Sie zu **Einstellungen → Erlebnis**
2. Suchen Sie das Datumsformat
3. Wählen Sie Ihr bevorzugtes Format
4. Änderungen werden sofort übernommen
</Accordion>
<Accordion title="Wie ändere ich meine Zeitzone?">
1. Gehen Sie zu **Einstellungen → Erlebnis**
2. Suchen Sie die Zeitzone
3. Wählen Sie Ihre lokale Zeitzone aus
4. Alle Zeitstempel werden angepasst
</Accordion>
<Accordion title="Kann ich die Sprache ändern?">
1. Gehen Sie zu **Einstellungen → Erlebnis**
2. Suchen Sie die Sprache
3. Wählen Sie aus den verfügbaren Sprachen
4. Die Oberfläche wird entsprechend Ihrer Auswahl aktualisiert
</Accordion>
</AccordionGroup>
## Kontoeinstellungen
<AccordionGroup>
<Accordion title="Wie verbinde ich mein E-Mail-Konto?">
1. Gehen Sie zu **Einstellungen → Konten**
2. Klicken Sie auf **Konto hinzufügen**
3. Wählen Sie Google oder Microsoft
4. Autorisieren Sie den Zugriff
5. Konfigurieren Sie die Synchronisierungseinstellungen
</Accordion>
<Accordion title="Kann ich mehrere E-Mail-Konten verbinden?">
Ja, Sie können mehrere E-Mail-Konten verbinden. Gehen Sie zu **Einstellungen → Konten** und fügen Sie nach Bedarf weitere Konten hinzu.
</Accordion>
<Accordion title="Wie trenne ich die Verbindung zu einem E-Mail-Konto?">
1. Gehen Sie zu **Einstellungen → Konten**
2. Suchen Sie das zu entfernende Konto
3. Klicken Sie auf **Trennen**
4. Bestätigen Sie die Aktion
</Accordion>
</AccordionGroup>
## Domänen
<AccordionGroup>
<Accordion title="Kann ich meine Arbeitsbereichsdomäne anpassen?">
Ja! Gehen Sie zu **Einstellungen → Allgemein → Workspace-Domäne** und klicken Sie auf **Domäne anpassen**. Sie haben zwei Optionen:
* **Subdomain**: Verwenden Sie eine Twenty-Subdomain wie `yourcompany.twenty.com`
* **Benutzerdefinierte Domäne**: Verwenden Sie Ihre eigene Domäne wie `crm.yourcompany.com` (erfordert DNS-Konfiguration)
Eine Subdomain ist schnell eingerichtet, während eine benutzerdefinierte Domäne ein vollständig markenkonformes Erlebnis für Ihr Team bietet.
</Accordion>
<Accordion title="Wie funktionieren genehmigte Zugriffsdomänen?">
Sie können genehmigte Zugriffsdomänen konfigurieren, damit Teammitglieder mit Firmen-E-Mail-Adressen Ihrem Arbeitsbereich automatisch beitreten können. Gehen Sie zu **Einstellungen → Mitglieder → Einladen** und fügen Sie Ihre Firmendomäne hinzu (z. B. `yourcompany.com`).
</Accordion>
</AccordionGroup>
## Early-Access-Funktionen
<AccordionGroup>
<Accordion title="Was sind Early-Access-Funktionen?">
Early-Access-Funktionen sind Funktionen, die vor der allgemeinen Verfügbarkeit getestet werden.
</Accordion>
<Accordion title="Sind Early-Access-Funktionen sicher zu verwenden?">
Early Access-Funktionen sind funktionell und sicher zu verwenden, können sich jedoch vor der allgemeinen Verfügbarkeit aufgrund von Rückmeldungen ändern.
</Accordion>
<Accordion title="Wie aktiviere ich Early-Access-Funktionen?">
1. Gehe zu **Einstellungen → Community**
2. Scrollen Sie zum Abschnitt **Features**
3. Suchen Sie die gewünschte Funktion
4. Aktivieren Sie sie
5. Die Funktion ist sofort verfügbar
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,62 @@
---
title: Einstellungen
description: Richten Sie Ihren Twenty-Arbeitsbereich mit wesentlichen Einstellungen ein.
---
## Ersteinrichtung
Wenn Sie Ihren Arbeitsbereich zum ersten Mal erstellen, gibt es mehrere wichtige Einstellungen, die Sie konfigurieren sollten.
### Arbeitsbereichsname und Logo
1. Gehen Sie zu **Einstellungen → Allgemein**
2. Aktualisieren Sie den Namen Ihres Arbeitsbereichs
3. Laden Sie Ihr Firmenlogo hoch
4. Speichern Sie Ihre Änderungen
### Zeitzone und Datumsformat
1. Gehen Sie zu **Einstellungen → Erlebnis**
2. Wählen Sie Ihre Zeitzone aus
3. Wählen Sie Ihr bevorzugtes Datumsformat
4. Speichern Sie Ihre Änderungen
## Wesentliche Einstellungen
### E-Mail und Kalender verbinden
Richten Sie die E-Mail- und Kalendersynchronisierung ein:
1. Gehen Sie zu **Einstellungen → Konten**
2. Klicken Sie auf **Konto hinzufügen**
3. Verbinden Sie Ihr Google- oder Microsoft-Konto
4. Konfigurieren Sie die Synchronisierungseinstellungen
→ [Vollständige Anleitung zur Einrichtung von E-Mail und Kalender](/l/de/user-guide/calendar-emails/overview)
### Laden Sie Ihr Team ein
Fügen Sie Ihrem Arbeitsbereich Teammitglieder hinzu:
1. Gehen Sie zu **Einstellungen → Mitglieder**
2. Klicken Sie auf **+ Einladen**
3. Geben Sie E-Mail-Adressen ein
4. Weisen Sie geeignete Rollen zu
<Note>
Bevor Sie Ihr Team einladen, überprüfen Sie die Standardrolle unter **Einstellungen → Mitglieder → Rollen**. Neuen Mitgliedern wird diese Rolle beim Beitritt automatisch zugewiesen.
</Note>
## Checkliste für Arbeitsbereichseinstellungen
* Arbeitsbereichsname und Logo konfiguriert
* Zeitzone und Datumsformat festgelegt
* E-Mail und Kalender verbunden
* Teammitglieder eingeladen
* Rollen und Berechtigungen konfiguriert
## Nächste Schritte
* [Arbeitsbereichseinstellungen](/l/de/user-guide/settings/capabilities/workspace-settings)
* [Profileinstellungen](/l/de/user-guide/settings/capabilities/profile-settings)
* [Erlebniseinstellungen](/l/de/user-guide/settings/capabilities/experience-settings)

View File

@@ -0,0 +1,46 @@
---
title: Kalenderansicht
description: Datensätze mit Datumsfeldern in einem Kalender anzeigen.
---
## Über die Kalenderansicht
Die Kalenderansicht zeigt Ihre Datensätze in einem Kalender basierend auf einem Datumsfeld an. Jeder Datensatz erscheint als Kalendereintrag am entsprechenden Datum.
<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
## Eine Kalenderansicht erstellen
1. Navigieren Sie zu einem Objekt mit Datumsfeldern
2. Klicken Sie auf das Ansichts-Dropdown → **+ Ansicht hinzufügen**
3. Benenne deine Ansicht und klicke auf **Erstellen**
4. Öffnen Sie rechts die **Optionen**
5. Wählen Sie **Kalender** als Layout
6. Wählen Sie das **Datumsfeld**, das für die Positionierung der Datensätze verwendet werden soll
7. Klicken Sie auf **Ansicht aktualisieren**
## Kalender konfigurieren
### Das Datumsfeld auswählen
Wählen Sie unter **Optionen** aus, welches Datumsfeld bestimmt, wo Datensätze im Kalender angezeigt werden.
### Felder anzeigen
Legen Sie fest, welche Felder bei jedem Kalendereintrag angezeigt werden:
1. Klicken Sie auf **Optionen → Felder**
2. Felder ein-/ausschalten
3. Ziehen, um neu anzuordnen
## Anwendungsfälle
* **Besprechungen und Anrufe**: Bevorstehende Termine anzeigen
* **Fristen**: Fälligkeiten und Abschlussdaten nachverfolgen
* **Veranstaltungen**: Terminierte Aktivitäten planen und visualisieren
* **Nachfassaktionen**: Sehen, wann Aufgaben fällig sind
## Verwandt
* [Übersicht über Ansichten](/l/de/user-guide/views-pipelines/overview) — Erstellen und Verwalten von Ansichten
* [Filter und Sortierung](/l/de/user-guide/views-pipelines/capabilities/filters-and-sorting) — Kalenderdaten filtern

View File

@@ -0,0 +1,52 @@
---
title: Felder & Spalten
description: Wählen Sie aus, welche Felder angezeigt werden sollen und wie Sie sie organisieren.
---
## Anzuzeigende Felder auswählen
Jede Ansicht kann eine andere Auswahl an Feldern anzeigen. Passen Sie an, was sichtbar ist, um sich auf die wichtigen Informationen zu konzentrieren.
### Felder anzeigen oder ausblenden
1. Klicken Sie oben rechts auf **Optionen**
2. Klicken Sie auf **Felder**
3. Klicken Sie auf das **Augensymbol** neben jedem Feld, um es ein- oder auszublenden
### Felder neu anordnen
Ändern Sie die Reihenfolge, in der Felder in Ihrer Ansicht angezeigt werden:
1. Klicken Sie auf **Optionen → Felder**
2. Ziehen Sie Felder nach oben oder unten
3. Änderungen werden automatisch gespeichert
## Feldanzeige nach Ansichtstyp
### Tabellenansichten
* Felder werden als Spalten angezeigt
* Ändern Sie die Größe der Spalten, indem Sie die Ränder ziehen
### Kanban-Ansichten
* Felder werden auf Karten angezeigt
* Über Optionen → Felder neu anordnen
* Verwenden Sie die Kompaktansicht, um alle Felder auszublenden
### Kalenderansichten
* Ausgewählte Felder werden in Kalendereinträgen angezeigt
* Über Optionen → Felder konfigurieren
## Beste Praktiken
* **Nur anzeigen, was benötigt wird** — zu viele Felder überdecken die Ansicht
* **Wichtige Felder zuerst platzieren** — die am häufigsten verwendeten Spalten links
* **Mehrere Ansichten erstellen** — unterschiedliche Feldsätze für unterschiedliche Zwecke
* **Feldsichtbarkeit pro Ansicht verwenden** — gleiches Objekt, anderer Fokus
## Verwandt
* [Tabellenansichten](/l/de/user-guide/views-pipelines/capabilities/table-views) — Funktionen der Listenansicht
* [Kanban-Ansichten](/l/de/user-guide/views-pipelines/capabilities/kanban-views) — kartenbasierte Ansichten

View File

@@ -0,0 +1,78 @@
---
title: Filtern und Sortieren
description: Filtern und sortieren Sie Datensätze, um genau das zu finden, was Sie benötigen.
---
## Daten filtern
Filter helfen Ihnen, sich auf bestimmte Datensätze zu konzentrieren, indem sie nur jene anzeigen, die Ihren Kriterien entsprechen.
### Einen Filter hinzufügen
1. Klicken Sie in der Symbolleiste auf die Schaltfläche **Filter**
2. Wählen Sie das Feld aus, nach dem gefiltert werden soll
3. Wählen Sie den Operator (gleich, enthält usw.)
4. Geben Sie den Filterwert ein
5. Klicken Sie auf **Übernehmen**
### Filteroperatoren
| Feldtyp | Verfügbare Operatoren |
| ---------------- | ------------------------------------------------- |
| Text | Gleich, Enthält, Beginnt mit, Endet mit, Ist leer |
| Nummer | Gleich, Größer als, Kleiner als, Ist leer |
| Datum | Gleich, Vor, Nach, Ist leer |
| Auswahl | Gleich, Ist eines von, Ist leer |
| Kontrollkästchen | Ist wahr, Ist falsch |
| Beziehung | Gleich, Ist leer |
### Mehrere Filter
Kombinieren Sie mehrere Filter, um die Ergebnisse einzugrenzen:
* Alle Filter werden mit UND-Logik angewendet
* Jeder zusätzliche Filter schränkt die Ergebnisse weiter ein
### Filter entfernen
* Klicken Sie bei einzelnen Filter-Chips auf das **X**
* Klicken Sie auf **Alle löschen**, um alle Filter zu entfernen
## Daten sortieren
Die Sortierung legt die Reihenfolge fest, in der Datensätze angezeigt werden.
### Eine Sortierung hinzufügen
1. Klicken Sie in der Symbolleiste auf die Schaltfläche **Sortieren**
2. Wählen Sie das Feld aus, nach dem sortiert werden soll
3. Wählen Sie aufsteigend (A-Z, 0-9) oder absteigend (Z-A, 9-0)
4. Klicken Sie auf **Übernehmen**
### Mehrere Sortierungen
Fügen Sie mehrere Sortierstufen hinzu:
* Die erste Sortierung hat Priorität
* Nachfolgende Sortierungen gelten innerhalb von Gruppen gleicher Werte
### Schnelles Spaltensortieren
Klicken Sie auf eine Spaltenüberschrift, um zu sortieren:
* Erster Klick: Aufsteigend
* Zweiter Klick: Absteigend
* Dritter Klick: Sortierung entfernen
## Filter- und Sortiereinstellungen speichern
Filter und Sortierungen werden mit der Ansicht gespeichert:
1. Konfigurieren Sie Ihre Filter und Sortierungen
2. Klicken Sie auf **Speichern**, um die aktuelle Ansicht zu aktualisieren
3. Oder klicken Sie auf **Als neue Ansicht speichern**, um eine Variante zu erstellen
## Verwandt
* [Tabellenansichten](/l/de/user-guide/views-pipelines/capabilities/table-views) — Funktion „Gruppieren nach“
* [Übersicht über Ansichten](/l/de/user-guide/views-pipelines/overview) — Erstellen und Verwalten von Ansichten

View File

@@ -0,0 +1,98 @@
---
title: Kanban-Board-Ansichten
description: Erfahren Sie, wie Sie Kanban-Ansichten nutzen, um Ihre Workflows zu visualisieren und zu verwalten.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Über Kanban-Ansichten
Kanban-Ansichten visualisieren Prozessabläufe, wobei jede Spalte eine eigene Phase darstellt und jede Karte einen Eintrag repräsentiert.
## Karten zwischen Phasen verschieben
Sie können jede Karte während des Workflows zwischen den Stufen verschieben, indem Sie auf eine Karte klicken und halten dann ziehen Sie es in die nächste Stufe.
<VimeoEmbed videoId="927888627" title="Video-Demonstration" />
## Phasen hinzufügen und löschen
Sie können Ihren Workflow an Ihre Bedürfnisse anpassen, indem Sie Stufen verwenden, die jeweils einen Wert in einem Auswahlfeld darstellen:
### Phasen hinzufügen
Um eine Stufe hinzuzufügen, klicken Sie auf die Feldeinstellungen auswählen, indem Sie auf Einstellungen > Datenmodell navigieren, die Auswahl des Objekts und dann die Auswahl des Feldes, von dem das Kanban-Board abhängt.
<VimeoEmbed videoId="927890428" title="Video-Demonstration" />
### Phasen entfernen
Um eine Phase zu entfernen, bewegen Sie den Mauszeiger über den Phasennamen oder das `⋮`-Symbol, klicken Sie in den Einstellungen des Auswahlfelds auf `Aus Einstellungen bearbeiten` und klicken Sie dann auf **Löschen** neben der entsprechenden Phase.
## Felder anzeigen
Sie können Ihr Kanban-Board so konfigurieren, dass einige Felder angezeigt und andere ausgeblendet werden. Um ein Feld anzuzeigen oder auszublenden, klicke auf **Optionen** oben rechts dann auf **Felder** um die Liste der Optionen aufzurufen, und klicken Sie auf das Augensymbol neben dem Feld, um es anzuzeigen oder zu verbergen.
Sie können auch die Reihenfolge der Felder ändern, indem Sie den Feldnamen festhalten und dorthin ziehen, wo Sie ihn haben möchten.
<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
## Kompaktansicht
Sie können alle Felder ausblenden und einen Überblick über alle Datensätze auf einen Blick erhalten. So aktivieren Sie es:
1. Klicken Sie oben rechts auf **Optionen**
2. Aktivieren Sie den Schalter für **Kompaktansicht**
<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
## Spaltenaggregationen
Jede Spalte in einer Kanban-Ansicht kann oben aggregierte Werte anzeigen, was Ihnen hilft, Ihre Daten auf einen Blick zu erfassen.
### Verfügbare Aggregationen
| Aggregation | Beschreibung |
| ---------------- | --------------------------------------------------------- |
| **Zählen** | Anzahl der Datensätze in der Spalte |
| **Summe** | Gesamtsumme eines numerischen Feldes (z. B. Deal-Beträge) |
| **Durchschnitt** | Durchschnittswert eines numerischen Feldes |
| **Min** | Niedrigster Wert |
| **Max** | Höchster Wert |
### Aggregationen konfigurieren
1. Klicken Sie oben in einer Spalte auf die Zahl, die neben dem Phasennamen angezeigt wird
2. Wählen Sie den Aggregationstyp aus
3. Wählen Sie das zu aggregierende Feld aus
**Beispiel:** Zeigen Sie den Gesamtwert der Deals pro Phase an, indem Sie das Feld Betrag mit Summe aggregieren.
## Wann Sie Kanban-Ansichten verwenden sollten
Kanban-Ansichten eignen sich ideal für:
* **Vertriebspipelines**: Verfolgen Sie Deals durch die Phasen vom Lead bis zum Abschluss
* **Projektmanagement**: Überwachen Sie Aufgaben anhand von Workflow-Status
* **Recruiting**: Verfolgen Sie Kandidaten durch die Einstellungsphasen
* **Jeder mehrstufige Prozess**: Visualisieren Sie jeden Workflow mit definierten Phasen
## Beste Praktiken
### Organisieren Sie Ihre Phasen
* **Phasen begrenzen**: 5-7 Phasen sind ideal für die Übersichtlichkeit
* **Klare Benennung**: Verwenden Sie aussagekräftige Phasennamen
* **Logische Reihenfolge**: Ordnen Sie Phasen in Prozessreihenfolge an
### Kartendarstellung optimieren
* **Schlüsselfelder anzeigen**: Zeigen Sie nur die wichtigsten Informationen an
* **Kompaktansicht verwenden**: Für Übersichten auf hohem Niveau
* **Farbkodierung**: Nutzen Sie Phasenfarben, um den Status schnell zu erkennen
### Datenqualität sicherstellen
* **Regelmäßig aktualisieren**: Sorgen Sie dafür, dass Karten durch die Phasen fortschreiten
* **Abgeschlossenes archivieren**: Verschieben Sie geschlossene Elemente aus der aktiven Ansicht
* **Veraltete Karten prüfen**: Fassen Sie bei Karten nach, die in Phasen feststecken

View File

@@ -0,0 +1,64 @@
---
title: Tabellenansichten
description: Zeigen Sie Ihre Daten in einem tabellenähnlichen Listenformat an.
---
## Über Tabellenansichten
Tabellenansichten zeigen Datensätze in Zeilen mit anpassbaren Spalten—wie in einer Tabellenkalkulation. Dies ist der Standardansichtstyp für die meisten Objekte.
<img src="/images/user-guide/table-views/table-view.png" style={{width:'100%'}} />
## Funktionen
### Spaltenkonfiguration
* Spalten (Felder) anzeigen oder ausblenden
* Spaltenbreiten anpassen
* Spalten durch Ziehen neu anordnen
### Nach einem Auswahlfeld gruppieren
Organisieren Sie Datensätze in einklappbare Gruppen, basierend auf einem Feld des Typs Auswahl.
<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
1. Klicken Sie auf **Optionen**
2. Wählen Sie **Gruppieren**
3. Wählen Sie ein Auswahlfeld
4. Konfigurieren Sie die Gruppenreihenfolge unter **Optionen → Gruppieren → Sortieren**:
* **Alphabetisch** oder **umgekehrt alphabetisch**
* **Manuelle Reihenfolge**: Ziehen Sie Gruppen unter "Sichtbare Gruppen", um sie neu anzuordnen
* Klicken Sie auf das **Augensymbol** neben einer Gruppe, um sie auszublenden
**Anwendungsfälle:**
* Unternehmen nach Typ gruppieren
* Verkaufschancen nach Phase gruppieren
* Aufgaben nach Status gruppieren
<Note>
**Für optimale Leistung beschränken Sie die Anzahl auf 10-15 sichtbare Gruppen pro Ansicht.** Wenn Sie mehr Gruppen benötigen, sollten Sie stattdessen ein Dashboard verwenden.
</Note>
### Spaltenbreiten
Passen Sie die Spaltenbreiten an, um mehr oder weniger Inhalt anzuzeigen:
1. Bewegen Sie den Mauszeiger zwischen zwei Spaltenüberschriften
2. Klicken Sie auf den Spaltenrand und ziehen Sie ihn
3. Lassen Sie los, um die neue Breite festzulegen
## Wann Sie Tabellenansichten verwenden sollten
Tabellenansichten eignen sich am besten für:
* **Durchsuchen großer Datensätze** — viele Datensätze schnell überfliegen
* **Dateneingabe** — mehrere Datensätze effizient bearbeiten
* **Detaillierte Analyse** — viele Felder auf einen Blick
* **Sortieren und Filtern** — bestimmte Datensätze finden
## Verwandt
* [Felder und Spalten](/l/de/user-guide/views-pipelines/capabilities/fields-and-columns) — konfigurieren, welche Felder angezeigt werden
* [Filter und Sortierung](/l/de/user-guide/views-pipelines/capabilities/filters-and-sorting) — Datensätze eingrenzen

View File

@@ -0,0 +1,74 @@
---
title: Ansichtseinstellungen
description: Verwalten Sie Sichtbarkeit, Namen, Symbole und Anordnung von Ansichten.
---
## Sichtbarkeit der Ansicht
Steuern Sie, wer Ihre benutzerdefinierten Ansichten sehen kann.
### Sichtbarkeitsoptionen
| Einstellung | Sichtbar für |
| ------------------ | ----------------------------------- |
| **Arbeitsbereich** | Alle Mitglieder des Arbeitsbereichs |
| **Nicht gelistet** | Nur Sie |
### Sichtbarkeit ändern
1. Öffnen Sie die Ansicht
2. Klicken Sie auf **Optionen → Sichtbarkeit**
3. Wählen Sie **Arbeitsbereich** oder **Nicht gelistet** aus
<Note>
Die Standardansichten "All [Object Name]" können nicht in ihrer Sichtbarkeit geändert werden.
</Note>
## Eine Ansicht umbenennen
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken Sie auf das **⋮**-Menü neben der Ansicht
3. Wählen Sie **Bearbeiten** aus
4. Geben Sie den neuen Namen ein
## Ansichtssymbol ändern
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken Sie auf das **⋮**-Menü neben der Ansicht
3. Wählen Sie **Bearbeiten** aus
4. Klicken Sie auf das Symbol, um es zu ändern
## Ansichten neu anordnen
Ändern Sie die Reihenfolge, in der Ansichten im Dropdown angezeigt werden:
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Ziehen Sie die Ansichten am Griffsymbol
3. Lassen Sie sie an der gewünschten Position los
4. Die Reihenfolge wird automatisch gespeichert
## Eine Ansicht favorisieren
Heften Sie häufig verwendete Ansichten für den schnellen Zugriff an:
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken Sie auf das **⋮**-Menü neben einer Ansicht
3. Wählen Sie **Zu Favoriten hinzufügen** aus
Zu Favoriten hinzugefügte Ansichten werden in einem eigenen Bereich für den schnellen Zugriff angezeigt.
## Eine Ansicht löschen
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken Sie auf das **⋮**-Menü neben der Ansicht
3. Wählen Sie **Löschen** aus
4. Bestätigen Sie das Löschen
<Warning>
Gelöschte Ansichten können nicht wiederhergestellt werden.
</Warning>
## Verwandt
* [Übersicht über Ansichten](/l/de/user-guide/views-pipelines/overview) — Erstellen von Ansichten
* [Zugriff beschränken: So geht's](/l/de/user-guide/views-pipelines/how-tos/restrict-access-to-your-view) — Schritt-für-Schritt-Anleitung

View File

@@ -0,0 +1,61 @@
---
title: Erstellen Sie eine Kalenderansicht für fällige Aufgaben
description: Visualisieren Sie Ihre Aufgaben und Fristen in einem Kalender.
---
<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
## Voraussetzungen
Ihr Aufgabenobjekt benötigt ein Feld **Fälligkeitsdatum** (Typ Datum oder Datum & Uhrzeit).
## Schritte
1. Navigieren Sie zu **Aufgaben**
2. Klicken Sie auf das Ansichts-Dropdown → **+ Ansicht hinzufügen**
3. Benennen Sie Ihre Ansicht (z. B. "Aufgabenkalender")
4. Klicken Sie auf **Erstellen**
5. Klicken Sie auf **Optionen** und wählen Sie **Kalender** als Layout
6. Wählen Sie **Fälligkeitsdatum** als Datumsfeld
7. Klicken Sie auf **Speichern**
## Konfigurieren Sie Ihren Kalender
### Felder in Ereignissen anzeigen
1. Klicken Sie auf **Optionen → Felder**
2. Klicken Sie auf das **Augensymbol**, um Felder ein-/auszublenden
3. Ziehen, um neu anzuordnen
Empfohlene Felder zum Anzeigen:
* **Titel** — Name der Aufgabe
* **Zuständige Person** — wer verantwortlich ist
* **Status** — aktueller Fortschritt
### Kalender filtern
Erstellen Sie gezielte Ansichten:
* **Meine Aufgaben**: Filtern nach "Zuständige Person" = Ich
* **Diese Woche**: Filtern nach Fälligkeitsdatum = Diese Woche
* **Überfällig**: Nach Fälligkeitsdatum < Heute filtern, Status ≠ Erledigt
## Weitere Anwendungsfälle für den Kalender
| Objekt | Datumsfeld | Zweck |
| ----------------------------- | -------------- | ----------------------------------------- |
| Opportunities | Abschlussdatum | Voraussichtliche Abschlüsse nachverfolgen |
| Benutzerdefinierte Ereignisse | Ereignisdatum | Aktivitäten planen |
| Projekte | Frist | Projektzeitpläne überwachen |
## Tipps
* **Wöchentlich prüfen**: Beginnen Sie jede Woche damit, Ihre Kalenderansicht zu prüfen
* **Mit Tabellenansicht kombinieren**: Verwenden Sie den Kalender für den Überblick, die Tabellenansicht für Details
* **Sichtbarkeit festlegen**: Persönliche Aufgabenkalender als Unlisted belassen
## Verwandt
* [Kalenderansicht](/l/de/user-guide/views-pipelines/capabilities/calendar-view) — alle Kalenderfunktionen
* [Filter und Sortierung](/l/de/user-guide/views-pipelines/capabilities/filters-and-sorting) — Ihren Kalender filtern

View File

@@ -0,0 +1,80 @@
---
title: Erstellen Sie eine Kanban-Ansicht für Projekte
description: Verfolgen Sie Projekte über die Phasen hinweg mit einem visuellen Board.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Verwenden Sie eine Kanban-Ansicht, um Ihre Projekte (oder beliebige Objekte mit Phasen) als Karten darzustellen, die sich durch Spalten bewegen.
<VimeoEmbed videoId="927888627" title="Video-Demonstration" />
## Voraussetzungen
Ihr Objekt benötigt ein **Select-Feld**, das als Spalten verwendet wird (z. B. Status, Stufe, Phase).
Falls Sie keines haben:
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie Ihr Objekt aus
3. Fügen Sie ein Select-Feld mit Ihren Stufenoptionen hinzu
## Schritte
1. Navigieren Sie zu Ihrem Objekt (z. B. Projekte, Aufgaben)
2. Klicken Sie auf das Ansichts-Dropdown → **+ Ansicht hinzufügen**
3. Benennen Sie Ihre Ansicht (z. B. "Projekt-Board")
4. Klicken Sie auf **Erstellen**
5. Klicken Sie auf **Optionen** und wählen Sie **Kanban** als Layout
6. Die Ansicht verwendet Ihr Select-Feld automatisch für die Spalten
7. Klicken Sie auf **Speichern**
## Konfigurieren Sie Ihr Board
### Wichtige Felder auf Karten anzeigen
1. Klicken Sie auf **Optionen → Felder**
2. Suchen Sie im Abschnitt "Ausgeblendete Felder" nach Feldern
3. Klicken Sie auf das **Augensymbol**, um sie auf Karten anzuzeigen
4. Ziehen, um neu anzuordnen
<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
### Kompakte Ansicht aktivieren
Für eine grobe Übersicht:
1. Klicken Sie auf **Optionen**
2. Aktivieren Sie die **Kompaktansicht**
Karten zeigen nur den Datensatznamen.
<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
### Aggregationen hinzufügen
Anzahlen oder Summen oben in jeder Spalte anzeigen:
1. Klicken Sie auf die Zahl neben einem Spaltennamen
2. Wählen Sie eine Aggregation (Anzahl, Summe usw.)
3. Wählen Sie bei Bedarf ein Feld aus
## Karten verschieben
Ziehen Sie Karten per Drag & Drop zwischen den Spalten, um ihren Status zu aktualisieren.
<VimeoEmbed videoId="927888627" title="Video-Demonstration" />
## Beispiel: Aufgaben-Board
| Spalte (Status) | Karten |
| ------------------ | ---------------------- |
| **Zu erledigen** | Neue Aufgaben |
| **In Bearbeitung** | Laufende Arbeit |
| **Überprüfung** | Warten auf Genehmigung |
| **Erledigt** | Abgeschlossen |
## Verwandt
* [Kanban-Ansichten](/l/de/user-guide/views-pipelines/capabilities/kanban-views) — Aggregationen, Kompaktansicht, Phasen
* [So richten Sie eine Vertriebspipeline ein](/l/de/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline) — Kanban für Verkaufschancen

View File

@@ -0,0 +1,51 @@
---
title: Eine Tabellenansicht mit Gruppierung erstellen
description: Organisieren Sie Ihre Datensätze anhand von Feldwerten in einklappbare Gruppen.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Gruppieren Sie Ihre Tabellenansicht nach einem Auswahlfeld, um Datensätze in einklappbare Abschnitte zu organisieren.
<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
## Schritte
1. Navigieren Sie zum Objekt (Personen, Unternehmen usw.)
2. Klicken Sie auf das Ansichts-Dropdown → **+ Ansicht hinzufügen**
3. Benennen Sie Ihre Ansicht (z. B. "Unternehmen nach Typ")
4. Klicken Sie auf **Erstellen**
5. Klicken Sie auf **Optionen → Gruppieren**
6. Wählen Sie ein Auswahlfeld zum Gruppieren aus
7. Klicken Sie auf **Speichern**
## Reihenfolge der Gruppen konfigurieren
Wählen Sie unter **Optionen → Gruppieren → Sortieren**, wie Gruppen angeordnet werden:
| Option | Beschreibung |
| -------------------------- | ------------------------------------------------------------------- |
| **Alphabetisch** | A bis Z |
| **Umgekehrt alphabetisch** | Z bis A |
| **Manuelle Reihenfolge** | Ziehen Sie Gruppen, um sie unter "Sichtbare Gruppen" neu anzuordnen |
Klicken Sie auf das **Augensymbol** neben einer Gruppe, um sie aus der Ansicht auszublenden.
<Note>
**Für optimale Leistung beschränken Sie sich auf 10-15 sichtbare Gruppen.** Wenn Sie mehr benötigen, erwägen Sie stattdessen die Verwendung eines Dashboards.
</Note>
## Beispiel: Unternehmen nach Branche
1. Gehen Sie zu **Unternehmen**
2. Erstellen Sie eine neue Ansicht mit dem Namen "Nach Branche"
3. Klicken Sie auf **Optionen → Gruppieren**
4. Wählen Sie das Feld **Branche** aus
5. Speichern
Ihre Unternehmen sind nun nach Branche organisiert, sodass Sie sich jeweils leicht auf ein Segment konzentrieren können.
## Verwandt
* [Tabellenansichten](/l/de/user-guide/views-pipelines/capabilities/table-views) — alle Funktionen der Tabellenansicht
* [Filter und Sortierung](/l/de/user-guide/views-pipelines/capabilities/filters-and-sorting) — Gruppieren mit Filtern kombinieren

View File

@@ -0,0 +1,32 @@
---
title: Zugriff auf Ihre Ansicht beschränken
description: Steuern Sie, wer Ihre benutzerdefinierten Ansichten sehen kann.
---
Jede Ansicht (mit Ausnahme der Standardansichten "Alle [Objektname]") verfügt über eine eigene Sichtbarkeitseinstellung.
## Schritte
1. Öffnen Sie die Ansicht, die Sie einschränken möchten
2. Klicken Sie oben rechts auf **Optionen**
3. Klicken Sie auf **Sichtbarkeit**
4. Wählen Sie **Nicht gelistet** aus
Ihre Ansicht ist nun nur für Sie sichtbar.
## Sichtbarkeitsoptionen
| Einstellung | Wer kann sie sehen |
| ------------------ | ----------------------------------- |
| **Arbeitsbereich** | Alle Mitglieder des Arbeitsbereichs |
| **Nicht gelistet** | Nur Sie |
## Notizen
* Die Standardansichten "Alle [Objektname]" können nicht auf "Nicht gelistet" gesetzt werden
* Nicht gelistete Ansichten erscheinen nicht in den Ansichts-Dropdowns anderer Benutzer
* Sie können die Sichtbarkeit jederzeit wieder auf "Arbeitsbereich" ändern
## Verwandt
* [Ansichtseinstellungen](/l/de/user-guide/views-pipelines/capabilities/view-settings) — alle Konfigurationsoptionen für Ansichten

View File

@@ -0,0 +1,120 @@
---
title: Vertriebspipeline einrichten
description: Konfigurieren Sie Ihre Vertriebspipeline, um Verkaufschancen durch die Phasen zu verfolgen.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
Eine Vertriebspipeline in Twenty ist eine Kanban-Ansicht Ihres Objekts "Opportunities", in der jede Spalte eine Phase Ihres Vertriebsprozesses darstellt.
## Schritt 1: Phasen konfigurieren
Phasen werden im Feld **Phase** des Objekts "Opportunities" definiert.
1. Gehen Sie zu **Einstellungen → Datenmodell**
2. Wählen Sie **Opportunities** aus
3. Suchen Sie das Feld **Phase** und klicken Sie darauf
4. Fügen Sie Phasen hinzu, entfernen oder benennen Sie sie um, um Ihren Prozess abzubilden
<VimeoEmbed videoId="927890428" title="Video-Demonstration" />
### Empfohlene Phasen
| Phase | Zweck |
| ---------------- | ---------------------------------- |
| **Neu** | Neu identifizierte Verkaufschancen |
| **Qualifiziert** | Als geeignet bestätigt |
| **Termin** | In Gesprächen |
| **Angebot** | Angebot gesendet |
| **Verhandlung** | Konditionen werden ausgehandelt |
| **Gewonnen** | Geschäft gewonnen |
| **Verloren** | Geschäft verloren |
<Note>
**5-7 Stufen sind optimal.** Zu viele Stufen machen die Pipeline schwer zu scannen; zu wenige verlieren die Sichtbarkeit in den Deal-Fortschritt.
</Note>
## Schritt 2: Pipeline-Ansicht erstellen
1. Gehen Sie zu **Opportunities**
2. Klicken Sie auf das Ansichts-Dropdown → **+ Ansicht hinzufügen**
3. Nennen Sie sie "Vertriebspipeline"
4. Klicken Sie auf **Erstellen**
5. Öffnen Sie **Optionen** und wählen Sie **Kanban** als Layout
Die Ansicht verwendet automatisch das Feld "Phase" für die Spalten.
## Schritt 3: Ansicht konfigurieren
### Wichtige Felder anzeigen
1. Klicken Sie auf **Optionen → Felder**
2. Suchen Sie im Abschnitt "Ausgeblendete Felder" nach Feldern
3. Klicken Sie auf das **Augen-Symbol**, um Folgendes anzuzeigen: Unternehmen, Betrag, Abschlussdatum, Eigentümer
### Aggregationen aktivieren
Summen oben in jeder Spalte anzeigen:
1. Klicken Sie auf die Zahl, die oben in einer Spalte neben einem Phasennamen angezeigt wird
2. Wählen Sie den Aggregationstyp (Anzahl, Summe, Durchschnitt usw.)
3. Wählen Sie das zu aggregierende Feld (z. B. Betrag)
**Beispiel:** Zeigen Sie den Gesamtwert der Deals pro Phase an, indem Sie das Feld Betrag mit Summe aggregieren.
### Kompakte Ansicht verwenden (optional)
Für eine grobe Übersicht mit minimalem Karteninhalt:
1. Klicken Sie auf **Optionen**
2. Aktivieren Sie den Schalter für **Kompaktansicht**
## Schritt 4: Persönliche und Team-Ansichten erstellen
### "Meine Pipeline"
* **Filter**: Eigentümer = Ich
* **Sichtbarkeit**: Nicht gelistet (persönliche Ansicht)
### "Team-Pipeline"
* **Filter**: Keiner (alle anzeigen)
* **Sichtbarkeit**: Arbeitsbereich (geteilte Ansicht)
### "Abschluss in diesem Monat"
* **Typ**: Tabelle
* **Filter**: Abschlussdatum = Dieser Monat, Phase ≠ Gewonnen, Phase ≠ Verloren
* **Sortierung**: Abschlussdatum aufsteigend
## Arbeiten mit Opportunities
### Opportunities erstellen
* Klicken Sie in der Opportunities-Ansicht auf **+ Neu**
* Oder klicken Sie in einer bestimmten Phasenspalte auf **+**
### Durch die Phasen wechseln
Ziehen Sie Opportunity-Karten per Drag & Drop zwischen die Spalten, um ihre Phase zu aktualisieren.
<VimeoEmbed videoId="927888627" title="Video-Demonstration" />
## Beste Praktiken
### Pipeline-Hygiene
* Aktualisieren Sie Geschäfte täglich entsprechend ihrem Fortschritt
* Verschieben oder schließen Sie ruhende Geschäfte umgehend
* Halten Sie Abschlussdaten realistisch
### Phasendisziplin
* Definieren Sie klare Kriterien für jede Phase
* Verschieben Sie Geschäfte umgehend, wenn Kriterien erfüllt sind
* Lassen Sie Geschäfte nicht zu lange in Phasen liegen
## Verwandt
* [Kanban-Ansichten](/l/de/user-guide/views-pipelines/capabilities/kanban-views) — Aggregationen und Kompaktansicht
* [Filter und Sortierung](/l/de/user-guide/views-pipelines/capabilities/filters-and-sorting) — gefilterte Ansichten erstellen

View File

@@ -0,0 +1,149 @@
---
title: Erwarteter Betrag in Ihrer Pipeline anzeigen
description: Gewichtete Deal‑Werte basierend auf der Phasenwahrscheinlichkeit berechnen und anzeigen.
---
Der erwartete Betrag ist ein berechneter Wert: **Amount × Probability**. So können Sie den Umsatz prognostizieren, indem Sie Deals nach ihrer Abschlusswahrscheinlichkeit gewichten.
<Tip>
Dies ist ein Beispiel für das Erstellen von [Formel­feldern](/l/de/user-guide/workflows/how-tos/crm-automations/formula-fields) mit Workflows.
</Tip>
Diese Anleitung führt Sie durch das Einrichten der benutzerdefinierten Felder und Workflows, die erforderlich sind, um erwartete Beträge in Ihrer Pipeline zu berechnen und anzuzeigen.
## Schritt 1: Benutzerdefinierte Felder erstellen
Sie benötigen zwei benutzerdefinierte Felder am Objekt „Opportunities“.
### Feld „Probability“ erstellen
1. Gehen Sie zu **Settings → Data Model → Opportunities**
2. Klicken Sie auf **+ Feld hinzufügen**
3. Konfigurieren:
* **Name**: Probability
* **Typ**: Number
* **Beschreibung**: Phasenbasierte Wahrscheinlichkeit (0–100 %)
4. Klicken Sie auf **Speichern**
### Feld „Expected Amount“ erstellen
1. Klicken Sie auf **+ Feld hinzufügen**
2. Konfigurieren:
* **Name**: Expected Amount
* **Typ**: Currency
* **Beschreibung**: Berechnet: Amount × Probability
3. Klicken Sie auf **Speichern**
### Optional: Felder für Benutzer schreibgeschützt machen
Wenn Benutzer diese berechneten Felder nicht manuell bearbeiten sollen:
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Wählen Sie die zu konfigurierende Rolle aus
3. Suchen Sie das Objekt „Opportunities“
4. Setzen Sie die Felder **Probability** und **Expected Amount** auf schreibgeschützt
Dadurch können nur die Workflows diese Werte aktualisieren.
## Schritt 2: Workflow #1 erstellen — Probability bei Phasenwechsel aktualisieren
Dieser Workflow setzt die Probability automatisch, wenn eine Opportunity in eine neue Phase wechselt.
### Neuen Workflow erstellen
1. Gehen Sie zu **Workflows**
2. Klicken Sie auf **+ New Workflow**
3. Benennen Sie ihn „Update Probability on Stage Change“
### Trigger konfigurieren
1. Fügen Sie einen **Record Created or Updated**-Trigger hinzu
2. Wählen Sie **Opportunities** als Objekt
3. Filtern nach: **Stage**-Feld wird aktualisiert
### Für jede Phase Verzweigungen hinzufügen
Erstellen Sie für jede Phase eine Verzweigung mit der entsprechenden Wahrscheinlichkeit:
| Phase | Wahrscheinlichkeit |
| ------------ | ------------------ |
| Neu | 10 % |
| Qualifiziert | 25 % |
| Meeting | 40 % |
| Proposal | 60 % |
| Negotiation | 80 % |
| Closed Won | 100 % |
| Closed Lost | 0% |
<Note>
Um eine neue Verzweigung zu erstellen, klicken Sie mit der rechten Maustaste auf den Workflow-Canvas und klicken Sie auf **New action**. Verknüpfen Sie diese Aktion anschließend mit dem vorherigen Knoten, indem Sie den Pfeil vom vorherigen Knoten zu dieser neuen Aktion ziehen.
</Note>
Für jede Phase:
1. Fügen Sie einen **Filter**-Knoten hinzu: Stage = [Phasenname]
2. Fügen Sie eine **Update Record**-Aktion hinzu:
* Datensatz: Die auslösende Opportunity
* Feld: Probability
* Wert: [Wahrscheinlichkeit für diese Phase]
### Erwarteten Betrag berechnen
Nachdem die Verzweigungen wieder zusammengeführt wurden:
1. Fügen Sie einen **Filter**-Knoten hinzu: Amount ist nicht leer
2. Fügen Sie eine **Update Record**-Aktion hinzu:
* Datensatz: Die auslösende Opportunity
* Feld: Expected Amount
* Wert: Amount × Probability
## Schritt 3: Workflow #2 erstellen — Bei Änderung von Amount neu berechnen
Dieser Workflow aktualisiert den Expected Amount, wenn sich der Amount des Deals ändert.
### Neuen Workflow erstellen
1. Gehen Sie zu **Workflows**
2. Klicken Sie auf **+ New Workflow**
3. Benennen Sie ihn „Recalculate Expected Amount on Amount Change“
### Trigger konfigurieren
1. Fügen Sie einen **Record Created or Updated**-Trigger hinzu
2. Wählen Sie **Opportunities** als Objekt
3. Filtern nach: **Amount**-Feld wird aktualisiert
### Logik hinzufügen
1. Fügen Sie einen **Filter**-Knoten hinzu: Amount ist nicht leer
2. Fügen Sie eine **Update Record**-Aktion hinzu:
* Datensatz: Die auslösende Opportunity
* Feld: Expected Amount
* Wert: Amount × Probability
## Schritt 4: In Ihrer Pipeline anzeigen
Zeigen Sie nun die Summen des Expected Amount in Ihrer Kanban-Ansicht an:
1. Öffnen Sie Ihre Kanban-Ansicht **Sales Pipeline**
2. Klicken Sie auf die **Zahl** neben einem Phasennamen oben in einer Spalte
3. Wählen Sie **Summe**
4. Wählen Sie **Expected Amount**
Jede Spalte zeigt nun den insgesamt gewichteten Pipeline‑Wert für diese Phase.
## Zusammenfassung
| Komponente | Zweck |
| -------------------------- | ----------------------------------------------------------------------------------------- |
| **Feld „Probability“** | Speichert die phasenbasierte Gewinnwahrscheinlichkeit |
| **Feld „Expected Amount“** | Speichert Amount × Probability |
| **Workflow #1** | Aktualisiert Probability bei Phasenwechsel und berechnet anschließend Expected Amount neu |
| **Workflow #2** | Berechnet Expected Amount neu, wenn sich Amount ändert |
| **Aggregation** | Zeigt die Summe des Expected Amount pro Phase an |
## Verwandt
* [Formel­felder](/l/de/user-guide/workflows/how-tos/crm-automations/formula-fields) — berechnete Felder mit Workflows erstellen
* [Kanban-Ansichten](/l/de/user-guide/views-pipelines/capabilities/kanban-views) — Spaltenaggregationen
* [Benutzerdefinierte Felder erstellen](/l/de/user-guide/data-model/how-tos/create-custom-fields) — Feldkonfiguration

View File

@@ -0,0 +1,231 @@
---
title: Verfolgen Sie, wie lange Opportunities in jeder Phase bleiben
description: Überwachen Sie die Deal-Geschwindigkeit, indem Sie nachverfolgen, wann Opportunities jede Phase betreten.
---
<Tip>
Dies ist ein Beispiel dafür, wie man mit Workflows [Formelfelder](/l/de/user-guide/workflows/how-tos/crm-automations/formula-fields) erstellt – konkret Datumsberechnungen.
</Tip>
Das Nachverfolgen, wann Opportunities eine Phase betreten, hilft, Engpässe zu erkennen und die Deal-Geschwindigkeit zu messen.
Diese Anleitung führt Sie durch das Einrichten benutzerdefinierter Felder und eines Workflows, um automatisch zu erfassen, wann eine Opportunity in eine Phase wechselt, und zu berechnen, wie viele Tage sie in der vorherigen Phase verbracht hat.
## Schritt 1: Benutzerdefinierte Felder erstellen
Für jede Phase benötigen Sie zwei Feldtypen:
* **Datums- und Uhrzeitfelder**: Erfassen, wann die Opportunity die jeweilige Phase betreten hat
* **Zahlenfelder**: Speichern, wie viele Tage die Opportunity in jeder Phase verbracht hat
### Erstellen Sie die Felder "Last Entered"
1. Gehen Sie zu **Settings → Data Model → Opportunities**
2. Klicken Sie für jede Phase auf **+ Add Field** und konfigurieren Sie:
* **Name**: Last Entered [Phasenname] (z. B. "Last Entered New", "Last Entered Qualified")
* **Type**: Date & Time
* **Description**: Zeitstempel, wann die Opportunity diese Phase betreten hat
3. Klicken Sie auf **Speichern**
Erstellen Sie diese Felder:
* Last Entered New
* Last Entered Qualified
* Last Entered Meeting
* Last Entered Proposal
* Last Entered Negotiation
* Last Entered Closed Won
* Last Entered Closed Lost
### Erstellen Sie die Felder "Days in Stage"
1. Klicken Sie für jede Phase auf **+ Add Field** und konfigurieren Sie:
* **Name**: Days in [Phasenname] (z. B. "Days in New", "Days in Qualified")
* **Type**: Number
* **Description**: Anzahl der in dieser Phase verbrachten Tage
2. Klicken Sie auf **Speichern**
Erstellen Sie diese Felder:
* Days in New
* Days in Qualified
* Days in Meeting
* Days in Proposal
* Days in Negotiation
<Note>
Sie benötigen keine "Days in"-Felder für Closed Won und Closed Lost, da dies finale Phasen sind.
</Note>
### Optional: Felder schreibgeschützt machen
Wenn Benutzer diese berechneten Felder nicht manuell bearbeiten sollen:
1. Gehen Sie zu **Einstellungen → Mitglieder → Rollen**
2. Rolle zum Konfigurieren auswählen
3. Suchen Sie das Objekt Opportunities
4. Setzen Sie die Felder "Last Entered" und "Days in" auf schreibgeschützt
## Schritt 2: Workflow erstellen
Dieser einzelne Workflow übernimmt beide Aufgaben:
* Erfasst den Zeitstempel beim Eintritt in eine neue Phase
* Berechnet die in der vorherigen Phase verbrachten Tage
### Workflow erstellen
1. Gehen Sie zu **Workflows**
2. Klicken Sie auf **+ New Workflow**
3. Nennen Sie ihn "Track Stage Time"
### Trigger konfigurieren
1. Fügen Sie einen **Record Updated**-Trigger hinzu
2. Wählen Sie **Opportunities** als Objekt aus
3. Filtern nach: **Stage**-Feld wird aktualisiert
### Verzweigungen für jede Phase hinzufügen
<Note>
Um eine neue Verzweigung zu erstellen, klicken Sie mit der rechten Maustaste auf den Workflow-Canvas und klicken Sie auf **New action**. Verknüpfen Sie anschließend diese Aktion mit dem vorherigen Knoten, indem Sie den Pfeil vom vorherigen Knoten zu dieser neuen Aktion ziehen.
</Note>
---
**Branch 1: Stage = New (erste Phase)**
Da dies die erste Phase ist, wird nur der Eintrittszeitstempel erfasst — es gibt keine vorherige Phase, von der aus berechnet werden kann.
1. Fügen Sie einen **Filter**-Knoten hinzu: Stage = New
2. Fügen Sie eine **Code**-Aktion hinzu:
```javascript
export const main = async (): Promise<object> => {
return { now: new Date().toISOString() };
};
```
3. Fügen Sie eine **Update Record**-Aktion hinzu:
* Datensatz: Die auslösende Opportunity
* Feld: Last Entered New
* Wert: `now` aus dem Code-Knoten
---
**Branch 2: Stage = Qualified**
Beim Wechsel zu Qualified den Eintrittszeitpunkt erfassen UND die in New verbrachten Tage berechnen.
1. Fügen Sie einen **Filter**-Knoten hinzu: Stage = Qualified
2. Fügen Sie eine **Code**-Aktion hinzu:
```javascript
export const main = async (params: {
lastEnteredPreviousStage: Date;
}): Promise<object> => {
const { lastEnteredPreviousStage } = params;
const now = new Date();
const entryDate = new Date(lastEnteredPreviousStage);
const diffTime = Math.abs(now.getTime() - entryDate.getTime());
const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
return {
now: now.toISOString(),
daysInPreviousStage: daysInPreviousStage
};
};
```
3. Konfigurieren Sie die Eingabe des Code-Knotens: Ordnen Sie `lastEnteredPreviousStage` dem Feld **Last Entered New** zu
4. Fügen Sie eine **Update Record**-Aktion hinzu:
* Datensatz: Die auslösende Opportunity
* Zu aktualisierende Felder:
* Last Entered Qualified = `now`
* Days in New = `daysInPreviousStage`
---
**Branch 3: Stage = Meeting**
Beim Wechsel zu Meeting den Eintrittszeitpunkt erfassen UND die in Qualified verbrachten Tage berechnen.
1. Fügen Sie einen **Filter**-Knoten hinzu: Stage = Meeting
2. Fügen Sie eine **Code**-Aktion hinzu:
```javascript
export const main = async (params: {
lastEnteredPreviousStage: Date;
}): Promise<object> => {
const { lastEnteredPreviousStage } = params;
const now = new Date();
const entryDate = new Date(lastEnteredPreviousStage);
const diffTime = Math.abs(now.getTime() - entryDate.getTime());
const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
return {
now: now.toISOString(),
daysInPreviousStage: daysInPreviousStage
};
};
```
3. Konfigurieren Sie die Eingabe des Code-Knotens: Ordnen Sie `lastEnteredPreviousStage` dem Feld **Last Entered Qualified** zu
4. Fügen Sie eine **Update Record**-Aktion hinzu:
* Datensatz: Die auslösende Opportunity
* Zu aktualisierende Felder:
* Last Entered Meeting = `now`
* Days in Qualified = `daysInPreviousStage`
---
**Für die verbleibenden Phasen fortfahren:**
| Phase | Datensätze | Berechnet |
| ----------- | ------------------------ | ------------------- |
| Proposal | Last Entered Proposal | Days in Meeting |
| Negotiation | Last Entered Negotiation | Days in Proposal |
| Closed Won | Last Entered Closed Won | Days in Negotiation |
| Closed Lost | Last Entered Closed Lost | Days in Negotiation |
Die Verzweigungen müssen nicht wieder zusammengeführt werden – jede läuft unabhängig, wenn ihre Phasenbedingung erfüllt ist.
## Schritt 3: Zeit in der Phase analysieren
Mit erfassten Zeitstempeln und Tageszahlen können Sie nun die Deal-Geschwindigkeit analysieren.
### Eine Ansicht "Slow Deals" erstellen
1. Erstellen Sie eine Tabellenansicht der Opportunities
2. Spalten hinzufügen: Name, Phase, Tage in [vorheriger Phase], Betrag
3. Nach dem Feld "Days in" sortieren (absteigend)
4. Nach Phase filtern, um sich jeweils auf eine Phase zu konzentrieren
Deals oben haben die meiste Zeit in der vorherigen Phase verbracht.
### Aggregationen verwenden
In Ihrer Pipeline-Kanban-Ansicht:
1. Klicken Sie auf die Zahl neben einem Phasennamen
2. Wählen Sie **Average** aus
3. Wählen Sie ein "Days in"-Feld
Dies zeigt die durchschnittliche Zeit, die Deals in jeder Phase verbringen.
## Zusammenfassung
| Komponente | Zweck |
| ----------------------------- | ----------------------------------------------------------------- |
| **Last Entered-Felder** | Speichern, wann die Opportunity jede Phase betreten hat |
| **Days in-Felder** | Speichern, wie viele Tage in jeder Phase verbracht wurden |
| **Workflow** | Erfasst den Zeitstempel UND berechnet die Tage in einem Durchlauf |
| **Ansichten & Aggregationen** | Deal-Geschwindigkeit analysieren und Engpässe identifizieren |
## Verwandt
* [Workflows](/l/de/user-guide/workflows/overview) — Grundlagen der Automatisierung
* [So erstellen Sie benutzerdefinierte Felder](/l/de/user-guide/data-model/how-tos/create-custom-fields) — Feldkonfiguration
* [Kanban-Ansichten](/l/de/user-guide/views-pipelines/capabilities/kanban-views) — Aggregationen

View File

@@ -0,0 +1,132 @@
---
title: Ansichten & Pipelines
description: Erfahren Sie, wie Sie in Twenty Ansichten erstellen und verwalten.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Ansichten verstehen
Ansichten sind gespeicherte Konfigurationen, die festlegen, wie Ihre Daten angezeigt werden. Jede Ansicht kann Folgendes haben:
* **Layout**: Tabelle, Kanban oder Kalender
* **Filter**: Welche Datensätze angezeigt werden
* **Sortierung**: Wie Datensätze angeordnet werden
* **Felder**: Welche Spalten sichtbar sind
## Ansichtstypen
### Tabellenansicht
Die standardmäßige tabellenähnliche Ansicht, die Datensätze in Zeilen mit anpassbaren Spalten anzeigt.
### Kanban-Ansicht
Eine visuelle Board-Ansicht, in der Datensätze als Karten nach Phasen organisiert erscheinen. Ideal für:
* Vertriebspipelines
* Projektverfolgung
* Jeder Workflow mit definierten Phasen
### Kalenderansicht
Eine Kalenderansicht, die Datensätze mit Datumsfeldern anzeigt. Perfekt für:
* Besprechungen und Veranstaltungen
* Fristen und Fälligkeitstermine
* Zeitbasierte Planung
## Eine Ansicht erstellen
Es gibt zwei Möglichkeiten, eine neue Ansicht zu erstellen.
### Das Ansichts-Dropdown-Menü verwenden
1. Navigieren Sie zu einem beliebigen Objekt (Personen, Unternehmen usw.)
2. Klicken Sie oben links auf den Namen der Ansicht (zeigt die aktuelle Ansicht mit einem Dropdown-Pfeil)
3. Klicken Sie auf **+ Ansicht hinzufügen**
4. Benennen Sie Ihre Ansicht und klicken Sie auf **Erstellen**
5. Wählen Sie unter **Optionen** ein Layout (Tabelle, Kanban oder Kalender)
6. Fügen Sie bei Bedarf Filter und Sortierung hinzu
7. Wählen Sie aus, welche Felder angezeigt werden sollen, und ordnen Sie sie neu an
8. Klicken Sie auf **Speichern**
<VimeoEmbed videoId="1145648745" title="Videodemonstration" />
### Beginnen Sie mit der Bearbeitung einer vorhandenen Ansicht
1. Navigieren Sie zu einem beliebigen Objekt (Personen, Unternehmen usw.)
2. Wählen Sie unter **Optionen** ein Layout (Tabelle, Kanban oder Kalender) aus und fügen Sie bei Bedarf Filter und Sortierung hinzu
3. Klicken Sie auf **Als neue Ansicht speichern**
4. Benennen Sie Ihre Ansicht und klicken Sie auf **Erstellen**
5. Bearbeiten Sie Ihre neue Ansicht weiter
6. Klicken Sie auf **Ansicht aktualisieren**, um Ihre zusätzlichen Konfigurationen zu speichern
<VimeoEmbed videoId="1145654005" title="Videodemonstration" />
## Ansichten verwalten
### Ansicht bearbeiten
1. Wählen Sie die Ansicht im Dropdown-Menü aus
2. Nehmen Sie Ihre Änderungen vor (Filter, Sortierung, Spalten)
3. Klicken Sie auf **Speichern**, um die Ansicht zu aktualisieren
### Eine Ansicht umbenennen oder ihr Symbol ändern
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken Sie auf das **⋮**-Menü neben dem Ansichtsnamen
3. Wählen Sie **Bearbeiten** aus
4. Ändern Sie den Namen oder das Symbol
5. Klicken Sie auf **Speichern**
### Ansichten neu anordnen
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken und ziehen Sie eine Ansicht an ihrem Ziehpunkt
3. Lassen Sie sie an der gewünschten Position los
4. Die neue Reihenfolge wird automatisch gespeichert
### Zu Favoriten hinzufügen
Häufig verwendete Ansichten für den Schnellzugriff anheften:
1. Öffnen Sie das Ansichts-Dropdown-Menü
2. Klicken Sie auf das **⋮**-Menü neben einer Ansicht
3. Wählen Sie **Zu Favoriten hinzufügen** aus
4. Die Ansicht erscheint im Bereich Favoriten
### Ansicht löschen
1. Wählen Sie die zu löschende Ansicht aus
2. Klicken Sie auf das Ansichts-Dropdown-Menü
3. Klicken Sie auf das **⋮**-Menü neben der Ansicht
4. Wählen Sie **Löschen** aus
5. Löschen bestätigen
<Warning>
Gelöschte Ansichten können nicht wiederhergestellt werden. Stellen Sie vor der Bestätigung sicher, dass Sie sie entfernen möchten.
</Warning>
## Sichtbarkeit von Ansichten
Jede Ansicht (außer den Standardansichten "Alle [Objektname]") hat ihre eigene Sichtbarkeitseinstellung.
So ändern Sie die Sichtbarkeit:
1. Öffnen Sie die Ansicht
2. Klicken Sie auf **Optionen → Sichtbarkeit**
3. Wählen Sie:
* **Arbeitsbereich**: Für alle Mitglieder des Arbeitsbereichs sichtbar
* **Nicht gelistet**: Nur für Sie sichtbar
<Note>
Bei den Standardansichten "Alle [Objektname]" kann die Sichtbarkeit nicht geändert werden.
</Note>
## Nächste Schritte
* [Tabellenansichten](/l/de/user-guide/views-pipelines/capabilities/table-views)
* [Kanban-Ansichten](/l/de/user-guide/views-pipelines/capabilities/kanban-views)
* [Filter und Sortierung](/l/de/user-guide/views-pipelines/capabilities/filters-and-sorting)
* [Ansichtseinstellungen](/l/de/user-guide/views-pipelines/capabilities/view-settings)

View File

@@ -0,0 +1,167 @@
---
title: E-Mails über Workflows senden
description: Senden Sie personalisierte E-Mails automatisch mit Workflow-Aktionen.
---
Senden Sie automatisch E-Mails, wenn bestimmte Ereignisse in Ihrem CRM auftreten—heißen Sie neue Kontakte willkommen, führen Sie Nachfassaktionen bei Verkaufschancen durch oder benachrichtigen Sie Teammitglieder.
## Voraussetzungen
Bevor Sie E-Mails aus Workflows senden können:
1. Verbinden Sie ein E-Mail-Konto unter **Einstellungen → Konten**
2. Stellen Sie sicher, dass für das Konto Sendeberechtigungen aktiviert sind
## Grundlegender E-Mail-Workflow
### Beispiel: Willkommens-E-Mail für neue Kontakte
**Ziel**: Senden Sie eine Willkommens-E-Mail, wenn eine neue Person zum CRM hinzugefügt wird.
**Einrichtung**:
1. **Workflow erstellen**: Gehen Sie zu **Einstellungen → Workflows** und klicken Sie auf **+ Neuer Workflow**
2. **Auslöser hinzufügen**: Wählen Sie **Datensatz wird erstellt** → **Personen**
3. **Aktion "E-Mail senden" hinzufügen**:
* Klicken Sie auf **+**, um eine Aktion hinzuzufügen
* Wählen Sie **E-Mail senden**
* Konfigurieren Sie die E-Mail:
| Feld | Wert |
| ----------- | -------------------------------------- |
| **An** | `{{trigger.object.email}}` |
| **Betreff** | `Willkommen bei {{Your Company Name}}` |
| **Inhalt** | `Hi {{trigger.object.firstName}}, ...` |
4. **Testen und aktivieren**: Testen Sie mit einem Beispieldatensatz und aktivieren Sie anschließend
## Variablen in E-Mails verwenden
Verweisen Sie mit der Syntax `{{variable}}` auf Daten aus vorherigen Schritten:
```text
Hi {{trigger.object.firstName}},
Thank you for connecting with us!
Your company, {{trigger.object.company.name}}, is now in our system.
Best regards,
The Team
```
### Verfügbare Variablen aus Auslösern
| Auslöser-Typ | Häufige Variablen |
| ----------------------------------- | -------------------------------------- |
| **Datensatz erstellt/aktualisiert** | `{{trigger.object.fieldName}}` |
| **Manuell** | `{{trigger.selectedRecord.fieldName}}` |
| **Webhook** | `{{trigger.body.fieldName}}` |
## Erweitert: Bedingte E-Mails
### Beispiel: Unterschiedliche E-Mails basierend auf der Lead-Quelle
**Ziel**: Senden Sie unterschiedliche Willkommens-E-Mails, je nachdem, woher der Lead stammt.
**Einrichtung**:
1. **Auslöser**: Datensatz wird erstellt (Personen)
2. **Aktion "Filter" hinzufügen**:
* Bedingung: `{{trigger.object.source}}` ist gleich `"Website"`
* Wenn wahr → mit der Website-Willkommens-E-Mail fortfahren
3. **Verzweigung für andere Quellen**:
* Erstellen Sie parallele Verzweigungen für verschiedene Quellen
* Jede Verzweigung hat ihre eigene Aktion "E-Mail senden"
## E-Mails an mehrere Empfänger senden
### Beispiel: Team benachrichtigen, wenn ein Deal abgeschlossen wird
**Ziel**: Senden Sie E-Mails an den Vertriebsmitarbeiter und dessen Manager, wenn eine Verkaufschance gewonnen wird.
**Einrichtung**:
1. **Auslöser**: Datensatz wird aktualisiert (Chancen, Phase = "Closed Won")
2. **Datensätze durchsuchen**: Finden Sie den Manager des Eigentümers der Verkaufschance
3. **E-Mail senden #1**: An den Eigentümer der Verkaufschance
* An: `{{trigger.object.owner.email}}`
* Betreff: `Glückwunsch zum Abschluss von {{trigger.object.name}}!`
4. **E-Mail senden #2**: An den Manager
* An: `{{searchRecords.manager.email}}`
* Betreff: `Deal gewonnen: {{trigger.object.name}}`
## Geplante Nachfass-E-Mails
### Beispiel: 3 Tage nach der Besprechung nachfassen
**Ziel**: Senden Sie 3 Tage, nachdem eine Besprechung protokolliert wurde, eine Nachfass-E-Mail.
**Einrichtung**:
1. **Auslöser**: Datensatz wird erstellt (Aktivitäten, Typ = "Besprechung")
2. **Verzögerungsaktion**: 3 Tage warten
3. **E-Mail senden**:
* An: Besprechungsteilnehmer
* Betreff: Rückmeldung zu unserem Gespräch
* Text: Verweisen Sie auf Besprechungsdetails aus dem Auslöser
## E-Mail-Anhänge
Sie können Dateien an E-Mails anhängen, die von Workflows gesendet werden. Der Anhang ist eine statische Datei, die Sie beim Konfigurieren des Workflows hochladen.
### So fügen Sie einen Anhang hinzu
1. Klicken Sie in der Aktion **E-Mail senden** auf die Schaltfläche **Anhänge**
2. Klicken Sie, um eine Datei von Ihrem Computer hochzuladen
3. Die Datei wird allen E-Mails, die durch diese Aktion gesendet werden, angehängt
### Häufige Anwendungsfälle
| Anwendungsfall | Beispieldatei |
| ------------------------------- | --------------------------------- |
| **Willkommens-E-Mails** | Unternehmensbroschüre (PDF) |
| **Onboarding-Sequenzen** | Leitfaden für die ersten Schritte |
| **Vertriebs-Nachverfolgungen** | Produktkatalog oder Preisliste |
| **Veranstaltungsbestätigungen** | Veranstaltungsdetails oder Agenda |
<Note>
Anhänge sind statisch—dieselbe Datei wird an alle Empfänger gesendet. Für dynamische Dokumente (wie personalisierte Anführungszeichen), generieren und fügen Sie Dateien mit einer [Logic Funktion](/l/de/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
</Note>
## Beste Praktiken
### E-Mail-Inhalt
* Formulieren Sie Betreffzeilen prägnant und relevant
* Personalisieren Sie mit dem Namen des Empfängers
* Fügen Sie eine klare Handlungsaufforderung hinzu
* Testen Sie E-Mails vor der Aktivierung
### Zustellbarkeit
* Senden Sie nicht zu viele E-Mails in zu kurzer Zeit
* Verwenden Sie professionelle E-Mail-Signaturen
* Vermeiden Sie Spam-Trigger-Wörter
* Stellen Sie sicher, dass Marketing-E-Mails eine Abmeldemöglichkeit enthalten
### Fehlerbehebung
* Überprüfen Sie, dass das E-Mail-Konto verbunden und aktiv ist
* Prüfen Sie, ob die E-Mail-Adresse des Empfängers gültig ist
* Überprüfen Sie Workflow-Ausführungen auf Fehlermeldungen
* Testen Sie zunächst mit Ihrer eigenen E-Mail-Adresse
## Verwandt
* [Workflow-Trigger](/l/de/user-guide/workflows/capabilities/workflow-triggers)
* [Workflow-Aktionen](/l/de/user-guide/workflows/capabilities/workflow-actions)

View File

@@ -0,0 +1,88 @@
---
title: Verzweigungen in Workflows verwenden
description: Verstehen Sie, wie Verzweigungen funktionieren und wie Sie steuern, welcher Pfad ausgeführt wird.
---
## Wie Verzweigungen funktionieren
Im Workflow-Editor können Sie mehrere Pfade (Verzweigungen) erstellen, die von einem einzelnen Knoten ausgehen. So können Sie komplexe Automatisierungen mit unterschiedlichen Ergebnissen erstellen.
**Wichtig**: Wenn ein Workflow ausgeführt wird, **werden standardmäßig alle Verzweigungen parallel ausgeführt**. Es gibt keine integrierte "if/else"-Logik, um eine Verzweigung gegenüber einer anderen auszuwählen—jeder Pfad wird gleichzeitig ausgeführt.
## Steuern, welche Verzweigung ausgeführt wird
Um basierend auf bestimmten Bedingungen nur eine Verzweigung auszuführen, **fügen Sie am Anfang jeder Verzweigung einen Filter-Knoten hinzu**.
### Beispiel-Setup
1. Erstellen Sie Ihren Workflow mit mehreren Verzweigungen, die von einem einzelnen Knoten ausgehen
2. Fügen Sie in jeder Verzweigung als ersten Schritt einen **Filter**-Knoten hinzu
3. Legen Sie für jeden Filter Bedingungen fest, um zu bestimmen, wann diese Verzweigung fortgesetzt werden soll
4. Nur die Verzweigung(en), deren Filterbedingungen erfüllt sind, wird/werden weiter ausgeführt
### Wie Filter funktionieren
* Wenn die Filterbedingung **erfüllt** ist: Die Verzweigung wird weiter ausgeführt
* Wenn die Filterbedingung **nicht erfüllt** ist: Die Verzweigung stoppt am Filter-Knoten
Dadurch entsteht effektiv eine bedingte Logik, bei der basierend auf Ihren Daten nur die passende Verzweigung ausgeführt wird.
## Beispiel: Routing nach Dealgröße
**Szenario**: Wenn ein Deal abgeschlossen wird, senden Sie je nach Dealgröße unterschiedliche Benachrichtigungen.
1. **Auslöser**: Verkaufschance aktualisiert (Phase = Closed Won)
2. **Verzweigung 1**: Filter für Betrag > $10.000 → Slack-Nachricht an #big-deals senden
3. **Verzweigung 2**: Filter für Betrag ≤ $10.000 → E-Mail an den Vertriebsleiter senden
Beide Verzweigungen starten, aber nur diejenige, die dem Dealbetrag entspricht, wird über ihren Filter hinaus fortgesetzt.
## Verzweigungen erstellen
<Note>
Um aus einem bestehenden Schritt eine neue Verzweigung zu erstellen, klicken Sie im Schritt auf die Schaltfläche **+** und fügen Sie Ihre Aktion hinzu. Sie können mehrere Verzweigungen hinzufügen, indem Sie **+** mehrmals klicken.
</Note>
1. Wählen Sie im Workflow-Editor den Schritt aus, von dem Sie verzweigen möchten
2. Klicken Sie auf **+**, um eine Aktion hinzuzufügen
3. Dadurch wird eine Verzweigung erstellt
4. Klicken Sie im selben Schritt erneut auf **+**, um weitere Verzweigungen zu erstellen
5. Jede Verzweigung kann ihre eigene Abfolge von Aktionen haben
## Verzweigungen wieder zusammenführen
Nachdem parallele Verzweigungen ihre Arbeit abgeschlossen haben, können Sie sie wieder zu einem einzelnen Pfad zusammenführen:
1. Schließen Sie Ihre verzweigten Aktionen ab
2. Fügen Sie einen neuen Schritt hinzu, der nach allen Verzweigungen ausgeführt werden soll
3. Ziehen Sie eine Verbindung vom letzten Schritt jeder Verzweigung zu diesem neuen Schritt
4. Der zusammengeführte Schritt wartet, bis alle verbundenen Verzweigungen abgeschlossen sind, bevor er ausgeführt wird
### Beispiel: Erst verarbeiten, dann benachrichtigen
```
Trigger
│
├── Branch A: Update Customer Record
│
└── Branch B: Create Support Ticket
↘ ↙
Merged Step: Send Confirmation Email
```
Die Bestätigungs-E-Mail wird sowohl nach der Kundenaktualisierung als auch nach der Ticketerstellung versendet.
## Beste Praktiken
* Verwenden Sie am Anfang von Verzweigungen immer **Filter-Knoten**, wenn Sie eine bedingte Ausführung möchten
* Halten Sie Verzweigungsbedingungen **gegenseitig ausschließend**, um doppelte Aktionen zu vermeiden
* Testen Sie Ihre Workflows mit unterschiedlichen Daten, um sicherzustellen, dass die richtigen Verzweigungen ausgeführt werden
* **Benennen Sie Verzweigungsschritte um** und verwenden Sie aussagekräftige Bezeichnungen, damit klar ist, was jeder Pfad tut
* **Verzweigungen zusammenführen**, wenn Sie nach paralleler Verarbeitung eine abschließende Aktion benötigen
## Verwandt
* [Workflows-FAQ](/l/de/user-guide/workflows/how-tos/need-more-help/workflows-faq) — Antworten zur parallelen Ausführung
* [Workflow-Aktionen](/l/de/user-guide/workflows/capabilities/workflow-actions) — verfügbare Aktionen für Verzweigungen

View File

@@ -0,0 +1,183 @@
---
title: Iterator verwenden
description: Durchlaufen Sie Arrays von Datensätzen, um Aktionen für jedes Element auszuführen.
---
Mit Iterator können Sie ein Array von Datensätzen durchlaufen und für jeden Datensatz Aktionen ausführen. Es ist unverzichtbar für Workflows, die mehrere Datensätze verarbeiten müssen, die von der Aktion „Datensätze suchen“ zurückgegeben oder über Webhooks empfangen werden.
## Wann Sie Iterator verwenden sollten
| Szenario | Beispiel |
| ------------------------------ | ------------------------------------------------------- |
| **Suchergebnisse verarbeiten** | E-Mail an jede gefundene Person senden |
| **Webhook-Arrays verarbeiten** | Der Reihe nach für jedes Element Datensätze erstellen |
| **Massenaktualisierungen** | Mehrere Datensätze mit berechneten Werten aktualisieren |
| **Benachrichtigungen** | Mehrere Personen über ein Ereignis benachrichtigen |
## Iterator verstehen
Iterator erwartet ein **Array** als Eingabe. Dann:
1. Nimmt das erste Element aus dem Array
2. Führt alle Aktionen im Iterator mit diesem Item aus
3. Wechselt zum nächsten Element
4. Wiederholt sich, bis alle Elemente verarbeitet sind
### Auswählen des Arrays, über das iteriert werden soll
Die meisten Array-Quellen (Search Records, ein Webhook-Array-Feld, ein Bulk Manual Trigger) können direkt im Variablen-Auswahldialog ausgewählt werden.
Wenn ein **Code**- oder **Logic Function**-Schritt ein *Top-Level-Array* zurückgibt, erscheint dessen Ausgabe im Variablen-Auswahldialog als indizierte Einträge (`0`, `1`, `2`, …). Um über das Array als Ganzes zu iterieren, wähle für diesen Schritt die Option **Whole list** – der Iterator leitet dann die Struktur jedes Elements automatisch aus der Liste ab.
## Grundlegende Einrichtung
### Beispiel: E-Mail an alle in den Suchergebnissen
**Ziel**: Alle Kontakte in einem bestimmten Unternehmen finden und jedem eine personalisierte E-Mail senden.
### Schritt 1: Nach Datensätzen suchen
1. Fügen Sie die Aktion **Datensätze suchen** hinzu
2. Objekt: **Personen**
3. Filter: Unternehmen ist gleich "Acme Inc"
4. Dadurch wird ein Array von Personen zurückgegeben
### Schritt 2: Prüfen, ob Ergebnisse vorhanden sind
1. Fügen Sie eine **Filter**-Aktion hinzu
2. Bedingung: `{{searchRecords.length}}` ist größer als 0
3. Dies verhindert Iterator-Fehler bei leeren Ergebnissen
### Schritt 3: Iterator hinzufügen
1. Fügen Sie eine **Iterator**-Aktion hinzu
2. Array-Eingabe: Wählen Sie `{{searchRecords}}` aus
3. Dadurch wird eine Schleife erstellt
### Schritt 4: Aktionen im Iterator hinzufügen
Aktionen, die nach dem Iterator platziert werden, werden für jedes Element ausgeführt:
1. Füge **E-Mail senden** Aktion (innerhalb des Iterators) hinzu
2. An: `{{iterator.currentItem.email}}`
3. Betreff: Hallo `{{iterator.currentItem.firstName}}`!
4. Text: Personalisierte Nachricht unter Verwendung der Felder des aktuellen Elements
### Ergebnis
Wenn Datensätze suchen 5 Personen zurückgibt, führt der Iterator Folgendes aus:
* Sendet E-Mail an Person 1
* Sendet E-Mail an Person 2
* ... setzt dies für alle 5 fort
## Zugriff auf Daten des aktuellen Elements
Im Iterator verwenden Sie `{{iterator.currentItem}}`, um auf den aktuellen Datensatz zuzugreifen:
| Variable | Beschreibung |
| --------------------------------------- | ------------------------------------------------- |
| `{{iterator.currentItem}}` | Das vollständige Objekt des aktuellen Datensatzes |
| `{{iterator.currentItem.id}}` | Datensatz-ID |
| `{{iterator.currentItem.email}}` | E-Mail-Feld |
| `{{iterator.currentItem.company.name}}` | Name des zugehörigen Unternehmens |
| `{{iterator.index}}` | Aktuelle Position im Array (0-basiert) |
Im Variablen-Auswahldialog kannst du entweder in ein bestimmtes Feld des aktuellen Elements hineinnavigieren oder **Use the whole item** auswählen, um auf das gesamte aktuelle Element zu verweisen (`{{iterator.currentItem}}`). Das Auswählen des gesamten Elements ist praktisch, wenn du einen vollständigen Datensatz direkt an einen nachgelagerten Schritt übergeben möchtest, anstatt ihn Feld für Feld neu aufzubauen.
## Häufige Muster
### Mehrere Datensätze aktualisieren
**Ziel**: Alle überfälligen Aufgaben als "Late" markieren
```
1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
└── Update Record
- Object: Tasks
- Record: {{iterator.currentItem.id}}
- Status: Late
```
### Datensätze aus Array erstellen
**Ziel**: Ein Webhook erhält eine Bestellung mit mehreren Positionen; für jede Position einen Datensatz erstellen
```
1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
└── Create Record
- Object: Order Items
- Name: {{iterator.currentItem.name}}
- Quantity: {{iterator.currentItem.qty}}
- Related Order: {{trigger.body.orderId}}
```
### Bedingte Verarbeitung innerhalb der Schleife
**Ziel**: Nur E-Mails an Kontakte mit gültigen E-Mail-Adressen senden
```
1. Search Records (People)
2. Iterator (searchRecords)
└── Filter (currentItem.email is not empty)
└── Send Email
- To: {{iterator.currentItem.email}}
```
## Fehlerbehebung
### "Iterator erwartet ein Array"
**Ursache**: Sie haben einen einzelnen Datensatz statt eines Arrays übergeben.
**Lösung**: Stellen Sie sicher, dass Sie das Ergebnis von Datensätze suchen oder ein Array-Feld übergeben, nicht einen einzelnen Datensatz.
```
✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}
```
### Iterator wird nicht ausgeführt
**Ursache**: Das Array ist leer.
**Lösung**: Fügen Sie vor dem Iterator einen Filter hinzu, um die Array-Länge zu prüfen:
```
Filter: {{searchRecords.length}} > 0
```
### Aktionen werden zu oft ausgeführt
**Ursache**: Datensätze suchen hat mehr Datensätze zurückgegeben als erwartet.
**Lösung**:
* Fügen Sie der Aktion „Datensätze suchen“ spezifischere Filter hinzu
* Legen Sie für die Aktion „Datensätze suchen“ ein Limit fest (max. 200)
* Fügen Sie innerhalb des Iterators einen Filter für zusätzliche Bedingungen hinzu
## Leistungsaspekte
* **Credit-Verbrauch**: Jede Iteration verbraucht Credits für ihre Aktionen
* **Zeit**: Große Arrays benötigen länger für die Verarbeitung
* **Grenzwerte**: Ziehen Sie für sehr große Vorgänge eine Stapelverarbeitung in Betracht
* **Ratenlimits**: Externe API-Aufrufe können bei vielen Iterationen auf Ratenlimits stoßen
## Beste Praktiken
1. **Prüfen Sie stets die Array-Länge** vor dem Iterator, um Fehler zu vermeiden
2. **Fügen Sie Filter innerhalb von Schleifen hinzu**, wenn nicht alle Elemente verarbeitet werden müssen
3. **Benennen Sie Ihren Iterator-Schritt um**, um zu beschreiben, was durchlaufen wird
4. **Testen Sie mit kleinen Arrays**, bevor Sie große Datenmengen verarbeiten
5. **Überwachen Sie Workflow-Ausführungen**, um sicherzustellen, dass Iterationen wie erwartet abgeschlossen werden
## Verwandt
* [Workflow-Aktionen](/l/de/user-guide/workflows/capabilities/workflow-actions)
* [So verwenden Sie Verzweigungen](/l/de/user-guide/workflows/capabilities/use-branches-in-workflows)
* [Workflows-FAQ](/l/de/user-guide/workflows/how-tos/need-more-help/workflows-faq)

View File

@@ -0,0 +1,332 @@
---
title: Workflow-Aktionen
description: Erfahren Sie mehr über die in Twenty-Workflows verfügbaren Aktionen.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## Über Aktionen
Aktionen definieren, was nach dem Auslösen passiert. Sie können mehrere Aktionen verketten, um komplexe Automatisierungen zu erstellen.
<Tip>
* Verwenden Sie die Variablenauswahl (klicken Sie auf das Symbol `(x+)`), um verfügbare Daten aus vorherigen Schritten zu durchsuchen
* Bewegen Sie den Mauszeiger über ein beliebiges Eingabefeld, um zu sehen, aus welchem Schritt eine Variable stammt — hilfreich, wenn dasselbe Feld (z. B. ID) in mehreren vorherigen Schritten vorhanden ist
* Geben Sie jeder Aktion einen aussagekräftigen Namen, um die Wartung zu erleichtern
</Tip>
## Datensatz-Aktionen
<img src="/images/user-guide/workflows/workflow_actions.png" style={{width:'100%'}} />
### Datensatz erstellen
Fügt einem ausgewählten Objekt einen neuen Datensatz hinzu.
**Konfiguration**:
* Wählen Sie das Zielobjekt aus
* Füllen Sie die erforderlichen und optionalen Felder aus
* Verwenden Sie Daten aus vorherigen Schritten oder geben Sie Werte manuell ein, um Felder auszufüllen
**Ausgabe**: Die neu erstellten Datensatzdaten stehen in nachfolgenden Schritten zur Verfügung.
### Datensatz aktualisieren
Ändert einen bestehenden Datensatz in einem ausgewählten Objekt.
<img src="/images/user-guide/workflows/update_record.png" style={{width:'100%'}} />
**Konfiguration**:
* Wählen Sie das Zielobjekt aus
* Wählen Sie den spezifischen Datensatz zum Aktualisieren aus.
* Sie können entweder einen festen Datensatz auswählen, indem Sie das Dropdown-Menü verwenden, das alle verfügbaren Datensätze anzeigt.
* Oder Sie lassen den Datensatz dynamisch auswählen, indem Sie einen in einem vorherigen Schritt gefundenen Datensatz über `(x+)` angeben. In diesem Schritt können Sie den Datensatz nicht anhand verschiedener Kriterien suchen. Wenn Sie den Datensatz noch nicht identifiziert haben, fügen Sie vor diesem Schritt `Update Record` einen Schritt `Search Record` hinzu.
* Wählen Sie zu ändernde Felder aus und geben Sie neue Werte ein
**Ausgabe**: Die aktualisierten Datensatzdaten stehen in nachfolgenden Schritten zur Verfügung.
### Datensatz löschen
Entfernt einen Datensatz aus einem ausgewählten Objekt.
**Konfiguration**:
* Wählen Sie das Zielobjekt aus
* Wählen Sie den spezifischen Datensatz zum Löschen aus
**Ausgabe**: Die gelöschten Datensatzdaten stehen in nachfolgenden Schritten zur Verfügung.
### Datensätze durchsuchen
Findet Datensätze innerhalb eines ausgewählten Objekts mittels Filterkonditionen.
**Konfiguration**:
* Wählen Sie das Objekt aus, das Sie durchsuchen möchten.
* Legen Sie Filterkriterien fest, um Ergebnisse einzugrenzen.
* Konfigurieren Sie Sortierung und Begrenzungen.
**Ausgabe**: Gibt passende Datensätze zurück, die in nachfolgenden Schritten verwendet werden können.
<Note>
**Limit**: Search Records gibt maximal **200 Datensätze** zurück. Wenn Sie mehr verarbeiten müssen, fügen Sie spezifische Filter hinzu, um die Ergebnisse zu reduzieren, oder verwenden Sie geplante Workflows, um stapelweise zu verarbeiten.
</Note>
**Best Practice**: Verwenden Sie [Verzweigungen](/l/de/user-guide/workflows/capabilities/workflow-branches) nach dem Durchsuchen von Datensätzen, um "gefunden" vs "nicht gefunden" Szenarien zu behandeln.
### Datensatz einfügen oder aktualisieren
Erstellt einen neuen Datensatz oder aktualisiert einen vorhandenen anhand von Übereinstimmungskriterien. Das ist hilfreich, wenn Sie nicht sicher sind, ob ein Datensatz bereits vorhanden ist.
<img src="/images/user-guide/workflows/upsert_double_identifier.png" style={{width:'100%'}} />
**Konfiguration**:
* Wählen Sie das Zielobjekt aus
* Beachten Sie, welche Felder für den Abgleich verwendet werden können: E-Mail für Personen, Domain für Unternehmen, ID für beliebige Objekte oder jedes Feld, das als eindeutig markiert ist. Unten müssen Sie mindestens eines davon ausfüllen.
* Füllen Sie die Feldwerte aus. Vergessen Sie nicht, mindestens einen der eindeutigen Bezeichner auszufüllen.
<Note>
**Der Abgleich funktioniert in der Regel noch besser, wenn Sie nur einen eindeutigen Bezeichner hinzufügen.** Beispielsweise werden im untenstehenden Screenshot Unternehmen anhand ihrer Domain abgeglichen. Die ID ist nicht unbedingt erforderlich.
</Note>
<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
* Verwenden Sie Daten aus vorherigen Schritten, um Felder zu füllen
**So funktioniert**:
1. Sucht nach einem Datensatz, der Ihren Kriterien entspricht
2. Wenn gefunden → Aktualisiere den vorhandenen Eintrag
3. Wenn nicht gefunden → Erstelle einen neuen Datensatz
**Ausgabe**: Die erstellten oder aktualisierten Datensatzdaten sind für die Verwendung in folgenden Schritten verfügbar.
## Flow-Aktionen
### Iterator
**Schleppt sich durch ein Array von Datensätzen** aus einem vorherigen Schritt, so dass du Aktionen auf jedem Datensatz einzeln ausführen kannst.
**Konfiguration**:
* Wählen Sie das Array der Datensätze aus einem vorherigen Schritt (z.B. Ergebnisse aus Suchdatensätzen, aus einem manuellen Trigger mit Bulk-Verfügbarkeit, aus einem Codeknoten). Wenn ein Code- oder Logikfunktions-Schritt ein Top-Level-Array zurückgibt, wählen Sie die Option **Whole list**, um über die gesamte Ausgabe zu iterieren.
* Definieren Sie die Aktionen, die für jeden Datensatz in der Schleife ausgeführt werden sollen.
<Note>
- Sie können mehrere Aktionen innerhalb eines Iterators hinzufügen.
- Wenn Sie Zweige innerhalb eines Iterators verwenden, stellen Sie sicher, dass sich der letzte Schritt jedes Zweiges mit dem Iterator verbindet, um die Schleife zu schließen.
</Note>
* Zugriff auf `Aktuelle Item` Felder: Um Felder aus dem aktuell verarbeiteten Datensatz zu verwenden, klicke auf den **Iterator** Schritt, dann wähle **Aktuelles Iterator**. Die Liste der verfügbaren Felder aus diesem Datensatz wird angezeigt und kann für die Verwendung in folgenden Aktionen ausgewählt werden. Sie können auch **Use the whole item** auswählen, um das gesamte aktuelle Element an einen nachgelagerten Schritt zu übergeben.
<VimeoEmbed videoId="1146577247" title="Video-Demo" />
### Filter
Filtert Datensätze basierend auf bestimmten Bedingungen, so dass nur Datensätze, die die Kriterien erfüllen, durchlaufen können.
**Konfiguration**:
* Datensatz zum filtern auswählen
* Definieren Sie Filterbedingungen und Kriterien
* Konfigurieren Sie, welche Datensätze in nachfolgende Schritte übergehen sollen
<Note>
1. **Ausgabe**: Filterknoten geben keine Daten zurück – sie fungieren als Tore. Wenn die Bedingungen erfüllt sind, geht der Workflow weiter. Wenn nicht, stoppt der Workflow an diesem Zweig.
2. Der "IS"-Operator kann mit numerischen Feldern verwendet werden. Es spielt als "EQUAL".
</Note>
### Verzögerung
Behebt Workflow-Ausführung für eine bestimmte Dauer oder bis zu einem bestimmten Datum/Zeitpunkt.
**Verzögerungstypen**:
| Typ | Beschreibung |
| ------------------- | ---------------------------------------------------------------- |
| **Dauer** | Warte auf eine bestimmte Zeit (Tage, Stunden, Minuten, Sekunden) |
| **Geplantes Datum** | Warten Sie bis zu einem bestimmten Datum und Zeit |
**Konfiguration für Dauern**:
* Tage, Stunden, Minuten und/oder Sekunden festlegen
* Mehrere Einheiten kombinieren (z. B. 2 Tage und 4 Stunden)
**Konfiguration für geplantes Datum**:
* Datum und Uhrzeit auswählen
* Kann ein Datumsfeld aus einem vorherigen Schritt referenzieren (z.B. 3 Tage nach einer Besprechung)
**Anwendungsfälle**:
* Warten Sie 24 Stunden bevor Sie eine Nachfass-E-Mail senden
* Pause bis zum Enddatum einer Gelegenheit
* Aufgaben für Geschäftszeiten planen
<Note>
Das geplante Datum kann nicht in der Vergangenheit sein. Wenn ein Datumsfeld aus einem vorherigen Schritt verwendet wird und das Datum bereits abgelaufen ist, wird der Workflow fehlschlagen.
</Note>
**Limits & Credits**:
* **Kein maximales Zeitlimit** - Du kannst Verzögerungen von Minuten, Tage, Wochen oder länger einstellen
* **1 Credits verbraucht** wenn der Delay Knoten ausgeführt wird, unabhängig von der Dauer
* **Kein Guthaben verbraucht** während des Wartens - eine 5-minütige Verzögerung kostet dasselbe wie eine 5-tägige Verzögerung
## Kommunikationsaktionen
### E-Mail senden
Sendet eine E-Mail aus Ihrem Workflow. Dies ist ideal für vordefinierte Gruppenmails. E-Mails werden so aussehen, wie sie von Ihrem Postfach gesendet werden.
Es eignet sich nicht für Newsletter (die eine umfassendere Formatierung erfordern) oder für automatisierte E-Mail-Sequenzen.
**Voraussetzungen**: Fügen Sie ein E-Mail-Konto unter Einstellungen → Konten hinzu
**Konfiguration**:
* Wählen Sie das Absender-E-Mail-Konto
<Note>
Sie können nur E-Mails aus Postfächern versenden, die mit Ihrem eigenen Konto synchronisiert wurden. Das Versenden von Postfächern anderer Teammitglieder (z. B. die E-Mail des Kontoinhabers) ist auf der Roadmap.
</Note>
Für alle folgenden Schritte können Sie Variablen aus früheren Schritten zur Personalisierung referenzieren.
* E-Mail-Adresse des Empfängers eingeben.
<Note>
Im Moment ist nur ein Empfänger möglich.
</Note>
* Betreffzeile festlegen.
* Nachrichtentext verfassen. Sie können Links formatieren, nummerierte Listen, Kugelpunktlisten erstellen und Anhänge hinzufügen.
<Note>
Das Hinzufügen von HTML-Signaturen ist im Moment nicht möglich.
</Note>
### Formular
Fordert während der Workflow-Ausführung ein Formular an, um Benutzereingaben zu sammeln. Die Antworten können dann in folgenden Schritten verwendet werden, um Datensätze zu erstellen, E-Mails zu senden oder jede andere Aktion basierend auf der Eingabe auszuführen.
<Warning>
**Formulare sind nur für manuelle Trigger konzipiert**. Bei Workflows mit anderen Triggern (Datensatz erstellt, aktualisiert, etc.) sind Formulare nur über die Workflow-Ausführungsoberfläche zugänglich, was nicht das erwartete Benutzererlebnis ist. 2026 wird ein Benachrichtigungszentrum freigegeben, um Formulare in automatisierten Arbeitsabläufen ordnungsgemäß zu unterstützen.
</Warning>
**Konfiguration**:
* Konfigurieren Sie die Felder, die Benutzer ausfüllen sollen. Für jedes Feld wählen
* ein Typ unter Text, Nummer, Datum, gegebener Datensatz, ein Auswahlfeld. Felder aller Objekte stehen zur Auswahl zur Verfügung.
* ein Label
* ein Standardwert unter `Platzhalter` (optional)
* Formulartitel bearbeiten
**Ausgabe**: Formularantworten sind für nachfolgende Schritte verfügbar.
**Beispiel**: Der "Quick Lead"-Workflow ist standardmäßig in allen Arbeitsbereichen verfügbar, die überall im Kommandomenü `Cmd+K` verfügbar sind.
**So füllen Sie das Formular aus**:
* Löse deinen manuellen Workflow aus dem Kommandomenü `Cmd+K` aus
* Füllen Sie das Formular aus, das im Seitenfenster angezeigt wird, und klicken Sie auf "Absenden".
<Note>
Die Felder können nicht obligatorisch gemacht werden.
</Note>
<VimeoEmbed videoId="1147277989" title="Video-Demo" />
## Integrationsaktionen
### Code
Führt benutzerdefiniertes JavaScript in Ihrem Workflow aus.
Im Hintergrund wird jede Code-Aktion von ihrer eigenen **Logikfunktion** unterstützt – einer serverseitigen TypeScript-Funktion, die auf der Twenty-Plattform ausgeführt wird. Wenn Sie eine Code-Aktion hinzufügen, erstellt Twenty eine dedizierte Logikfunktion für diesen Schritt und stellt deren Editor inline bereit, sodass der von Ihnen geschriebene Code zusammen mit dem Workflow gespeichert wird.
**Konfiguration**:
* Greifen Sie auf Variablen aus vorherigen Schritten zu. Sie können die Namen der Variablen dynamisch bearbeiten.
<VimeoEmbed videoId="1147281795" title="Video-Demo" />
* Schreiben Sie JavaScript-Code im Editor
* Variablen zurückgeben, um sie in nachfolgenden Schritten zu verwenden
* Code direkt im Schritt testen
<Note>
Wenn Sie externe API-Schlüssel in Ihrem Code verwenden müssen, müssen Sie diese direkt in den Funktionskörper eingeben. Sie können API-Schlüssel nicht an anderer Stelle konfigurieren und sie dann in der Logikfunktion referenzieren.
</Note>
<Tip>
**Mit Arrays arbeiten?** Arrays von externen Systemen oder vorherigen Schritten können als Zeichenketten verwendet werden. Siehe [Wie man Arrays in Code-Aktionen behandelt](/l/de/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) für die Lösung.
</Tip>
<Tip>
Klicken Sie auf das quadratische Symbol oben rechts im Code-Editor, um es im Vollbildmodus anzuzeigen – hilfreich, da die Standardbreite des Editors begrenzt ist.
</Tip>
#### Eine Logikfunktion in mehreren Workflows wiederverwenden
Die Inline-Code-Aktion ist ideal für einmalige Logik, aber der darin enthaltene Code gehört zu genau diesem einen Schritt. Wenn Sie dieselbe Logik über mehrere Workflows hinweg teilen oder sie als versionierten Quellcode in einer App pflegen möchten, definieren Sie eine **wiederverwendbare Logikfunktion**, anstatt Code in jede Code-Aktion zu kopieren und einzufügen.
Eine Logikfunktion wird einmal in einer App definiert (mithilfe des SDK-Befehls `defineLogicFunction`) und durch Hinzufügen von `workflowActionTriggerSettings` im Workflow-Builder verfügbar gemacht. Sobald Ihre App installiert ist, erscheint diese Funktion als eigene Aktion im Workflow-Builder, neben den eingebauten Aktionen. Wenn Sie sie auswählen, werden die von Ihnen deklarierten Eingabefelder angezeigt (mit Variablen-Auswahl, genau wie bei anderen Aktionen) und Ihr geteilter Code wird ausgeführt – kein Inline-JavaScript erforderlich.
| | Code-Aktion | Wiederverwendbare Logikfunktion |
| -------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------ |
| **Wo der Code liegt** | Inline-Editor, an einen einzelnen Workflow-Schritt gebunden | In einer App definiert, im Versionskontrollsystem versioniert |
| **Wiederverwendung** | Pro Schritt kopiert und eingefügt | Als Aktion in jedem Workflow hinzugefügt |
| **Eingaben** | Variablen, die im Editor verdrahtet werden | Felder, die aus Ihrem deklarierten Eingabe-Schema gerendert werden |
| **Am besten geeignet für** | Schnelle, Workflow-spezifische Logik | Gemeinsam genutzte Logik, die in mehreren Workflows verwendet wird |
Beide laufen auf derselben Logikfunktions-Laufzeit, sodass eine Code-Aktion, die Sie inline prototypisiert haben, später mit minimalen Änderungen in eine wiederverwendbare Logikfunktion überführt werden kann.
<Tip>
Die entwicklerorientierte Referenz zur Definition von Logikfunktionen und deren Bereitstellung im Workflow-Builder finden Sie unter [Logic Functions](/l/de/developers/extend/apps/logic/logic-functions) – insbesondere im Abschnitt **Exposing a function as an AI tool or workflow action** und bei `workflowActionTriggerSettings`.
</Tip>
### HTTP-Anfrage
Sendet eine Anfrage an eine externe API als Teil Ihres Workflows.
<img src="/images/user-guide/workflows/http_action.png" style={{width:'100%'}} />
**Konfiguration**:
* Geben Sie die API-Endpunkt-URL ein. Die Verwendung von Parametern aus früheren Schritten ist möglich.
* Wählen Sie die HTTP-Methode aus (GET, POST, PUT, PATCH, DELETE)
* Erforderliche Header und Werte hinzufügen
* Beispielantwort zur Strukturvorschau bereitstellen
## KI-Aktionen
### AI Agent - demnächst
Führt einen KI-Agent innerhalb Ihres Workflows aus, um intelligente Aufgaben auszuführen.
**Konfiguration**:
* **Agent**: Wähle einen vorhandenen KI-Agent oder verwende den Standardmakler
* **Anfrage**: Schreibe die Anweisung für den KI-Agent
* Referenzvariablen von vorherigen Schritten in der Promption
**Was KI Agenten tun können**:
* Daten analysieren und zusammenfassen
* Einträge klassifizieren oder kategorisieren
* Textinhalt generieren
* Entscheidungen auf Basis von Daten treffen
* Interagiere mit deinen CRM-Daten mithilfe von Tools
**Ausgabe**: Die Antwort des KI-Agenten ist verfügbar für die Verwendung in folgenden Schritten. Wenn der Agent ein strukturiertes Ausgabeschema hat, folgt die Antwort diesem Format.
<Note>
AI Agent-Aktionen verbrauchen Workflow-Credits basierend auf dem verwendeten KI-Modell. Siehe [Workflow Credits](/l/de/user-guide/workflows/capabilities/workflow-credits) für Details.
</Note>
<Note>
Die AI-Agenten respektieren die rollenbasierten Genehmigungen. Sie können Agenten unter **Einstellungen → Mitglieder → Rollen** bestimmte Rollen zuweisen, um zu steuern, auf welche Daten sie zugreifen können. Siehe [Permissions](/l/de/user-guide/permissions-access/capabilities/permissions) für Details.
</Note>

View File

@@ -0,0 +1,66 @@
---
title: Workflow-Verzweigungen
description: Erstellen Sie parallele Pfade und bedingte Logik in Ihren Workflows.
---
Verzweigungen ermöglichen es Ihnen, Ihren Workflow in mehrere Pfade aufzuteilen, die abhängig von Ihren Daten gleichzeitig oder bedingt ausgeführt werden können.
<img src="/images/user-guide/workflows/branches.png" style={{width:'100%'}} />
## So funktionieren Verzweigungen
Wenn Sie von einem einzelnen Knoten mehrere Verbindungen erstellen, wird jeder Pfad zu einer Verzweigung. Standardmäßig werden **alle Verzweigungen parallel ausgeführt**—sie warten nicht aufeinander.
## Verzweigungen erstellen
### Neue Verzweigung hinzufügen
1. **Klicken Sie mit der rechten Maustaste auf die Hauptfläche** des Workflows (nicht auf einen vorhandenen Knoten)
2. Klicken Sie auf **Knoten hinzufügen**
3. Wählen Sie den Knotentyp für Ihre neue Verzweigung
4. Ziehen Sie einen Pfeil vom unteren Rand des vorherigen Schritts zum oberen Rand dieser neuen Aktion
5. Wiederholen Sie dies, um weitere Verzweigungen vom selben Knoten hinzuzufügen
<Note>
Jede Verzweigung ist unabhängig. Das Hinzufügen einer Verzweigung wirkt sich nicht auf andere bestehende Pfade von diesem Knoten aus.
</Note>
### Visuelles Layout
Verzweigungen erscheinen als parallele Pfade im Workflow-Editor. Sie können Knoten ziehen, um das visuelle Layout neu anzuordnen, ohne die Ausführung zu beeinflussen.
## Bedingte Verzweigungen
Da standardmäßig alle Verzweigungen ausgeführt werden, verwenden Sie **Filter**-Knoten, um zu steuern, welche Pfade tatsächlich ausgeführt werden:
| Verzweigung | Filterbedingung | Aktion |
| ----------- | --------------------- | -------------------------------- |
| A | Phase = "Gewonnen" | Glückwunsch-E-Mail senden |
| B | Phase = "Verloren" | Nachverfolgungsaufgabe erstellen |
| C | Phase = "Verhandlung" | Manager benachrichtigen |
1. Erstellen Sie Verzweigungen von Ihrem Trigger oder Ihrer Aktion aus
2. Fügen Sie einen **Filter**-Knoten als ersten Schritt jeder Verzweigung hinzu
3. Konfigurieren Sie jeden Filter mit sich gegenseitig ausschließenden Bedingungen
4. Fügen Sie Ihre Aktionen nach jedem Filter hinzu
Nur die Verzweigungen, bei denen die Filterbedingung erfüllt ist, werden weiter ausgeführt.
## Verzweigungen zusammenführen
**Verzweigungen werden nicht automatisch zusammengeführt.** Jede Verzweigung wird unabhängig ausgeführt, bis sie endet. Sie haben volle Flexibilität, wie Sie dies handhaben:
* **Option 1: Verzweigungen getrennt halten**
Jede Verzweigung verarbeitet ihre eigenen Nachverfolgungsaktionen unabhängig. Dies ist der einfachste Ansatz, wenn Verzweigungen nicht zusammengeführt werden müssen.
* **Option 2: Verzweigungen manuell zusammenführen**
Beim Erstellen Ihres Workflows können Sie mehrere Verzweigungen manuell mit derselben nachgelagerten Aktion verbinden. Ziehen Sie einfach Pfeile vom Ende jeder Verzweigung zu einem gemeinsamen Knoten.
<Note>
Obwohl Sie einen [Delay](/l/de/user-guide/workflows/capabilities/workflow-actions#delay)-Knoten verwenden können, um die Ausführung zu pausieren, lässt er sich derzeit nicht so konfigurieren, dass er wartet, "bis eine andere Verzweigung endet".
</Note>
## Verwandte Inhalte
* [So verwenden Sie Verzweigungen in Workflows](/l/de/user-guide/workflows/capabilities/use-branches-in-workflows) - Schritt-für-Schritt-Anleitung
* [Workflow-Aktionen](/l/de/user-guide/workflows/capabilities/workflow-actions) - Verfügbare Aktionen einschließlich Filter

View File

@@ -0,0 +1,75 @@
---
title: Workflow-Guthaben
description: Verstehen Sie den Verbrauch und die Verwaltung von Workflow-Guthaben.
---
Workflow-Guthaben treiben Ihre Automatisierungen in Twenty an. Das Verständnis ihrer Funktionsweise hilft Ihnen, die Kosten zu optimieren und Ihr Automatisierungsbudget effektiv zu verwalten.
## Guthabenverteilung
Workflow-Guthaben werden basierend auf Ihrem Abrechnungszeitraum zugeteilt, nicht nach Ihrer Tarifstufe:
| Abrechnungszeitraum | Guthaben |
| -------------------------- | ------------------- |
| **Monatliches Abonnement** | 5 Credits pro Monat |
| **Jährliches Abonnement** | 50 Credits pro Jahr |
<Note>
5 Credits pro Monat sind für Standardautomatisierungen großzügig bemessen. Die meisten Teams überschreiten dieses Limit bei typischer Nutzung von Workflows nicht. Zusätzliche Guthaben werden vor allem für erweiterte Code-Aktionen und KI-gestützte Workflows benötigt.
</Note>
## Wie der Verbrauch von Guthaben funktioniert
Guthaben werden verbraucht, wenn Workflows ausgeführt werden, nicht, wenn Sie sie erstellen. Jede Workflow-Aktion verbraucht Credits basierend auf ihrer Komplexität:
### Guthabenverbrauch nach Aktionstyp
* **Einfache interne Vorgänge**: Sehr niedriger Guthabenverbrauch
* Datensätze durchsuchen
* Datensatz erstellen
* Datensatz aktualisieren
* Datensatz löschen
* Formularaktionen
* **Komplexe Vorgänge**: Höherer Guthabenverbrauch
* Code-Aktionen (JavaScript-Ausführung)
* HTTP-Anfragen an externe Dienste
* **KI-Funktionen**: Höherer Guthabenverbrauch
* KI-Agent-Aktionen verbrauchen Guthaben abhängig vom verwendeten KI-Modell
* Komplexere Prompts und längere Ausgaben verbrauchen mehr Guthaben
* **Delay-Aktionen**: Minimaler Guthabenverbrauch
* Der Delay-Knoten verbraucht **1 Guthaben**, wenn er ausgeführt wird
* **Es werden keine Guthaben verbraucht** während der Wartezeit
* Eine Verzögerung von 5 Minuten kostet dasselbe wie eine Verzögerung von 5 Tagen
### Echtzeitabzug
Guthaben werden in Echtzeit abgezogen, sobald Workflows ausgeführt werden. Das bedeutet:
* Entwurfs-Workflows verbrauchen keine Guthaben
* Nur aktive, laufende Workflows nutzen Ihre Guthabenzuteilung
* Fehlgeschlagene Workflows verbrauchen dennoch Guthaben für abgeschlossene Schritte
## Guthabenverwaltung
### Guthabenverbrauch prüfen
1. Gehen Sie zu **Einstellungen → Abrechnung**
2. Sehen Sie sich Ihren aktuellen Guthabenverbrauch und verbleibenden Saldo an
3. Beobachten Sie Nutzungsmuster, um Ihre Workflows zu optimieren
### Zusätzliche Guthaben kaufen
Wenn Sie mehr Guthaben über Ihre Plan-Zuteilung hinaus benötigen:
1. Gehen Sie zu **Einstellungen → Abrechnung**
2. Klicken Sie auf die Option, um zusätzliche Guthaben zu kaufen. Pakete unterschiedlicher Größen sind verfügbar.
3. Guthaben werden Ihrem aktuellen Saldo hinzugefügt
## Beste Praktiken
* **Batch-Verarbeitung**: Verwenden Sie Massen-Operationen und Iterator-Aktionen effizient um einzelne Aktionsaufrufe zu reduzieren
* **Optimierung manueller Auslöser**: Wählen Sie bei manuellen Auslösern die Verfügbarkeit `Bulk`, um mehrere Datensätze in einem einzelnen Workflow-Durchlauf zu verarbeiten
* Optimieren Sie Code-Aktionen für Effizienz

View File

@@ -0,0 +1,93 @@
---
title: Workflow-Läufe
description: Workflow-Ausführungen überwachen und verwalten.
---
## Über Läufe
Ein **Lauf** ist ein Protokoll einer Workflow-Ausführung. Jedes Mal, wenn ein Workflow ausgelöst wird – sei es durch ein Datensatzereignis, einen Zeitplan, eine manuelle Aktion oder einen Webhook – wird ein neuer Lauf erstellt.
## Läufe anzeigen
### Im Workflow-Editor
1. Öffnen Sie den Workflow, den Sie überwachen möchten
2. Klicken Sie auf das **Läufe**-Panel auf der rechten Seite
3. Sehen Sie eine Liste der letzten Läufe mit ihrem Status
### In der Ansicht Workflow-Läufe
1. Gehen Sie in der Seitenleiste zu **Workflow-Läufe**
2. Zeigen Sie Läufe über alle Workflows hinweg an
3. Filtern Sie nach Status, Workflow oder Datum
## Laufstatus
| Status | Beschreibung |
| ------------------- | ------------------------------------------------------------------------------------------------- |
| **Wird ausgeführt** | Workflow wird derzeit ausgeführt |
| **Abgeschlossen** | Workflow wurde erfolgreich abgeschlossen |
| **Fehlgeschlagen** | Beim Workflow ist ein Fehler aufgetreten und wurde angehalten |
| **Wartend** | Workflow ist angehalten (z. B. wartet auf eine Verzögerungsaktion oder eine Formularübermittlung) |
## Laufdetails
Klicken Sie auf einen beliebigen Lauf, um Folgendes zu sehen:
* **Status**: Aktueller Zustand des Laufs
* **Gestartet am**: Wann der Lauf begonnen hat
* **Dauer**: Wie lange der Lauf gedauert hat
* **Triggerdaten**: Die Eingabe, die den Workflow gestartet hat
* **Schrittausgaben**: Daten, die von jedem Schritt zurückgegeben wurden
* **Fehlermeldungen**: Falls der Lauf fehlgeschlagen ist – was schiefgelaufen ist
## Ausführung Schritt für Schritt
Jeder Lauf zeigt den Fortschritt in Ihrem Workflow:
1. Sehen Sie, welche Schritte erfolgreich abgeschlossen wurden
2. Ermitteln Sie, wo Fehler aufgetreten sind
3. Sehen Sie sich die zwischen den Schritten übergebenen Daten an
4. Beheben Sie Probleme, indem Sie die Eingaben und Ausgaben der Schritte untersuchen
## Fehlerbehandlung
Wenn ein Lauf fehlschlägt:
1. Öffnen Sie den fehlgeschlagenen Lauf
2. Finden Sie den Schritt, der den Fehler verursacht hat
3. Prüfen Sie die Fehlermeldung auf Details
Häufige Probleme:
* Erforderliche Felder fehlen
* Ungültiges Datenformat
* Externe API-Fehler
* Berechtigungsprobleme
## Workflows erneut ausführen
Wenn ein Durchlauf fehlschlägt, können Sie Folgendes tun:
* Beheben Sie das zugrunde liegende Problem und warten Sie auf den nächsten Trigger
* Lösen Sie bei manuellen Workflows den Workflow mit denselben oder aktualisierten Daten erneut aus
* Überprüfen Sie die Workflow-Logik, um zukünftige Fehler zu verhindern
## Leistungs-Tipps
### Verlauf verwalten
* Läufen sind als historische Referenz erhalten
* Sehr alte Abläufe können automatisch archiviert werden
* Exportiere ausgeführte Daten, wenn Datensätze gespeichert werden müssen
### Best Practices überwachen
* Überprüfen Sie regelmäßig nach der Aktivierung neuer Workflows
* Überprüfung fehlgeschlagen um Muster zu identifizieren
## Verwandt
* [Workflow-Trigger](/l/de/user-guide/workflows/capabilities/workflow-triggers)
* [Workflow-Aktionen](/l/de/user-guide/workflows/capabilities/workflow-actions)
* [Workflow Fehlerbehebung](/l/de/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting)

View File

@@ -0,0 +1,136 @@
---
title: Workflow-Auslöser
description: Erfahren Sie mehr über die verschiedenen Auslöser, die Ihre Workflows starten.
---
## Über Auslöser
Workflows beginnen immer mit einem einzelnen Auslöser, der festlegt, wann die Automatisierung ausgeführt werden soll.
<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
<Tip>
**Erweiterte Objekte werden unterstützt!** Über die standardmäßigen CRM-Objekte hinaus (Personen, Unternehmen, Chancen) können Sie auch Workflows auslösen und Aktionen ausführen für:
* Arbeitsbereichsmitglieder
* Kalenderereignisse
* Nachrichten (E-Mails)
* Aufgaben, Notizen und viele andere Systemobjekte
Dies ermöglicht leistungsstarke Automatisierungen, etwa das Benachrichtigen von Teammitgliedern, wenn Kalenderereignisse erstellt werden, oder das automatische Verarbeiten eingehender E-Mails.
</Tip>
## Datensatz wird erstellt
Startet den Workflow, wenn ein neuer Datensatz in einem ausgewählten Objekt (Personen, Unternehmen, Gelegenheiten oder ein benutzerdefiniertes Objekt) erstellt wird.
**Konfiguration**: Wählen Sie den Objekttyp aus, der auf neue Datensätze überwacht werden soll.
<Note>
* Dieser Trigger eignet sich hervorragend für Datensätze, die von CSV, Postfach- und Kalendersynchronisation oder API erstellt wurden.
* **Für manuell erstellte Datensätze nicht empfohlen**: Mit diesem Auslöser starten Workflows, sobald der Datensatz erstellt wird. Da Zwanzig UI automatisch spart (es gibt keinen Bearbeitungsmodus und dann eine Validierung, um Datensätze zu speichern) wird der Workflow ausgelöst, bevor der Benutzer alle Felder eingibt.
Um diesen Workflow bei manuell erstellten Datensätzen auszulösen, wird empfohlen, stattdessen den Auslöser `Record is created or updated` zu verwenden.
</Note>
## Datensatz wird aktualisiert
Startet den Workflow, wenn Änderungen an einem bestehenden Datensatz vorgenommen werden.
**Konfiguration**:
* Wählen Sie den Objekttyp aus
* Optional angeben, welche Felder auf Änderungen überwacht werden sollen
## Datensatz wird aktualisiert oder erstellt
Startet den Workflow, wenn ein Datensatz in einem ausgewählten Objekt entweder erstellt oder aktualisiert wird.
**Warum das wichtig ist**: Dieser Auslöser ist besonders hilfreich, da auf verschiedene Arten erstellte Datensätze sich unterschiedlich verhalten:
* **API-/CSV-Importe**: Datensätze werden sofort mit allen Feldern befüllt erstellt
* **Manuelle Erstellung**: Datensätze werden zuerst erstellt, dann werden Felder in nachfolgenden Aktualisierungen hinzugefügt
**Konfiguration**:
* Wählen Sie den Objekttyp aus, der überwacht werden soll
* Optional angeben, welche Felder auf Änderungen überwacht werden sollen
* Der Workflow wird sowohl bei der ersten Erstellung als auch bei nachfolgenden Aktualisierungen ausgelöst
## Datensatz wird gelöscht
Startet den Workflow, wenn ein Datensatz aus einem Objekt entfernt wird.
**Konfiguration**: Wählen Sie den Objekttyp aus, der auf Löschungen überwacht werden soll.
## Manueller Auslöser
Startet den Workflow, wenn er durch eine Benutzeraktion ausgelöst wird. Dieser Auslöser ist über das `Cmd+K`-Menü oder über eine benutzerdefinierte Schaltfläche zugänglich, die nach Auswahl von Datensätzen in der oberen Navigationsleiste angezeigt wird.
<img src="/images/user-guide/workflows/add_to_newsletter_button.png" style={{width:'100%'}} />
**Verfügbarkeitskonfiguration**: Wählen Sie aus, wie der Workflow die Datensatzauswahl handhaben soll:
* **Global**: Für das Auslösen dieses Workflows ist kein Datensatz erforderlich. Der Workflow wird aus dem Befehlsmenü `Cmd+K` irgendwo (von jedem Objekt) ausgelöst und verwendet keine Eintragung(en) als Eingabe.
Für die **Single** und **Bulk** Verfügbarkeit werden die ausgewählten Datensätze(n) an Ihren Workflow übergeben. Dies ist für ein bestimmtes Objekt konfiguriert und mehrere Datensätze können ausgewählt werden, bevor der Workflow ausgelöst wird.
* **Single**: Der Workflow läuft von Anfang bis Ende so oft wie die Datensätze ausgewählt sind.
<Note>
**Soft-Limit: 100 Ausführungen/Minute**. Darüber hinaus verbleiben Workflows im Status "Nicht gestartet" und werden schrittweise verarbeitet—entweder durch einen Hintergrundauftrag oder wenn ein anderer Workflow in die Warteschlange gelangt. Das bedeutet, Sie können mit einem einzelnen Auslöser mehr als 100 Datensätze auswählen; die Ausführung wird dann lediglich langsamer.
</Note>
* **Bulk**: Der Workflow wird einmal ausgeführt und stellt die gesamte Liste der Datensätze als Eingabe zur Verfügung. Das bedeutet, dass der Workflow eine [Iterator-Aktion](/l/de/user-guide/workflows/capabilities/workflow-actions#iterator) enthalten muss.
<Note>
Dies ist fortgeschrittener und am besten für Personen geeignet, die die Anzahl der Workflow-Ausführungen optimieren möchten.
</Note>
<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
**Zusätzliche Konfiguration**:
* Wählen Sie das Zielobjekt aus (für Einzel- und Bulk-Verfügbarkeit)
* Wählen Sie ein Befehls-Symbol für den Workflow-Trigger
* Platzierung in der Navigationsleiste konfigurieren (angeheftet oder nicht angeheftet)
**Zugriffsmethoden**:
* `Cmd+K`-Menü zum Finden und Starten manueller Workflows
* Benutzerdefinierte Schaltfläche in der oberen Navigationsleiste (falls konfiguriert)
## Zeitbasierter Auslöser: Nach Zeitplan
Startet den Workflow auf regelmäßiger Basis, die Sie definieren.
**Konfiguration**:
* Zeiteinheit auswählen (Minuten, Stunden, Tage)
* Geben Sie einen Wert ein oder verwenden Sie benutzerdefinierte Cron-Ausdrücke für erweitertes Scheduling
<Note>
**Zeitzone**: Geplante Workflows laufen in **UTC**. Wenn Sie Uhrzeiten für tägliche Zeitpläne festlegen, konvertieren Sie Ihre lokale Zeit in UTC.
</Note>
## Externer Auslöser: Webhook
Startet den Workflow, wenn eine GET- oder POST-Anfrage von einem externen Dienst empfangen wird.
<img src="/images/user-guide/workflows/webhook_trigger.png" style={{width:'100%'}} />
**Konfiguration**:
* Der Workflow stellt eine eindeutige Webhook-URL bereit—kopieren Sie diese und fügen Sie sie in Ihrem externen System als aufzurufenden Endpunkt hinzu.
* Für POST-Anfragen definieren Sie die erwartete Body-Struktur, damit Twenty weiß, welche Daten zu erwarten sind. Fügen Sie hier die Felder hinzu, die Sie erhalten und die weiter unten in Ihrem Workflow benötigt werden.
* Konfigurieren Sie die Authentifizierung (bald verfügbar).
## Den richtigen Auslöser wählen
| Anwendungsfall | Empfohlener Auslöser |
| -------------------------------------------- | ----------------------------------------- |
| Neue Leads müssen verarbeitet werden | Datensatz wird erstellt |
| Datenänderungen müssen synchronisiert werden | Datensatz wird aktualisiert |
| Import/manuelle Datenverarbeitung | Datensatz wird aktualisiert oder erstellt |
| Bereinigung nach dem Löschen | Datensatz wird gelöscht |
| Vom Benutzer initiierte Aktion | Manuell auslösen |
| Wiederkehrende Berichte | Nach Zeitplan |
| Externe Integration | Webhook oder Nach Zeitplan |

View File

@@ -0,0 +1,84 @@
---
title: Workflow-Versionen
description: Workflow-Versionen und -Entwürfe verwalten.
---
## Über Versionen
Jedes Mal, wenn Sie einen Workflow aktivieren, wird eine neue Version erstellt. So können Sie Änderungen im Laufe der Zeit nachverfolgen und bei Bedarf zu früheren Konfigurationen zurückkehren.
## Versionsstatus
| Status | Beschreibung |
| --------------- | ------------------------------------------------- |
| **Entwurf** | Wird bearbeitet, noch nicht veröffentlicht |
| **Aktiv** | Live-Version, die auf Trigger reagiert |
| **Deaktiviert** | Zuvor aktiv, aber manuell gestoppt |
| **Archiviert** | Vergangene Versionen für die Historie beibehalten |
## Mit Entwürfen arbeiten
Wenn Sie einen aktiven Workflow bearbeiten, werden Ihre Änderungen als **Entwurf** gespeichert. Die aktive Version läuft weiter, während Sie an Aktualisierungen arbeiten.
Wenn Sie mit der Bearbeitung fertig sind, können Sie:
* **Aktivieren**: Den Entwurf als neue aktive Version veröffentlichen (die vorherige Version wird archiviert)
* **Verwerfen**: Den Entwurf löschen und die aktuelle aktive Version beibehalten
## Versionsverlauf
### Frühere Versionen anzeigen
1. Öffnen Sie den Workflow
2. Klicken Sie auf die Registerkarte **Versionen**
3. Alle früheren Versionen mit Zeitstempeln anzeigen
### Eine Version wiederherstellen
1. Suchen Sie die Version, die Sie wiederherstellen möchten
2. Klicken Sie auf **Als Entwurf verwenden**
3. Die Version wird in einen neuen Entwurf kopiert
4. Nehmen Sie alle erforderlichen Aktualisierungen vor
5. Aktivieren Sie, wenn alles bereit ist
## Beste Praktiken
### Versionsverwaltung
* Aktivieren Sie nur, wenn alles für den Produktivbetrieb bereit ist
* Achten Sie auf aussagekräftige Änderungen zwischen Versionen
* Dokumentieren Sie größere Änderungen in Workflow-Namen oder -Beschreibungen
* Testen Sie im Entwurfsmodus, bevor Sie aktivieren
### Änderungen rückgängig machen
* Wenn eine neue Version Probleme verursacht, stellen Sie die vorherige Version wieder her
* Verwenden Sie den Versionsverlauf, um nachzuvollziehen, was sich geändert hat
* Testen Sie wiederhergestellte Versionen immer, bevor Sie sie aktivieren
## Häufige Workflows
### Schnellbearbeitung
1. Kleine Änderungen an einem aktiven Workflow vornehmen
2. Im Entwurfsmodus testen
3. Die neue Version aktivieren
### Umfassende Überarbeitung
1. Verwenden Sie die vorherige Version als Ausgangspunkt
2. Nehmen Sie umfangreiche Änderungen im Entwurf vor
3. Testen Sie alle Szenarien gründlich
4. Aktivieren Sie, wenn Sie sicher sind
### Rollback
1. Identifizieren Sie das Problem mit der aktuellen Version
2. Suchen Sie im Verlauf die letzte funktionierende Version
3. Klicken Sie auf **Als Entwurf verwenden**
4. Aktivieren Sie, um das alte Verhalten wiederherzustellen
## Verwandte Themen
* [Erste Schritte mit Workflows](/l/de/user-guide/workflows/overview)
* [Workflow-Ausführungen](/l/de/user-guide/workflows/capabilities/workflow-runs)

View File

@@ -0,0 +1,82 @@
---
title: Arrays in Code-Aktionen verarbeiten
description: Erfahren Sie, wie Sie Array-Eingaben in Code-Aktionen innerhalb von Workflows korrekt verarbeiten.
---
Bei der Arbeit mit Arrays in Code-Aktionen stoßen Sie möglicherweise auf zwei häufige Herausforderungen:
1. **Als Strings übergebene Arrays** — Daten aus externen Systemen oder vorherigen Schritten kommen als String statt als echtes Array an
2. **Einzelne Elemente nicht auswählbar** — Sie können nur das gesamte Array auswählen, nicht bestimmte Felder darin
Beides lässt sich mit einem Code-Knoten lösen.
## Arrays aus Strings parsen
Arrays werden zwischen Workflow-Schritten häufig als Strings oder JSON übergeben, statt als native Arrays. Dies geschieht, wenn:
* Empfangen von Daten aus externen APIs über HTTP Request
* Verarbeiten von Webhook-Payloads
* Weitergeben von Daten zwischen Workflow-Schritten
**Lösung**: Fügen Sie dieses Muster am Anfang Ihrer Code-Aktion hinzu:
```javascript
export const main = async (params: {
users: any;
}): Promise<object> => {
const { users } = params;
// Handle input that may come as a string or an array
const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
// Now you can safely work with usersFormatted as an array
return {
users: usersFormatted.map((user) => ({
...user,
activityStatus: String(user.activityStatus).toUpperCase(),
})),
};
};
```
Die entscheidende Zeile `typeof users === "string" ? JSON.parse(users) : users` prüft, ob die Eingabe ein String ist, parst sie bei Bedarf oder verwendet sie direkt, wenn sie bereits ein Array ist.
## Einzelne Felder aus Arrays extrahieren
Ein Webhook kann ein Array wie `answers: [...]` zurückgeben, aber in nachfolgenden Workflow-Schritten können Sie nur das **gesamte Array** auswählen — nicht einzelne Elemente darin.
**Lösung**: Fügen Sie einen Code-Knoten hinzu, um bestimmte Felder zu extrahieren und als strukturiertes Objekt zurückzugeben:
```javascript
export const main = async (params: {
answers: any;
}): Promise<object> => {
const { answers } = params;
// Handle input that may come as a string or an array
const answersFormatted = typeof answers === "string"
? JSON.parse(answers)
: answers;
// Extract specific fields from the array
const firstname = answersFormatted[0]?.text || "";
const name = answersFormatted[1]?.text || "";
return {
answer: {
firstname,
name
}
};
};
```
Der Code-Knoten gibt statt eines Arrays ein strukturiertes Objekt zurück. In den folgenden Schritten können Sie nun einzelne Felder wie `answer.firstname` und `answer.name` aus der Variablenauswahl auswählen.
<Tip>
**Möchten Sie über das Array iterieren, anstatt Felder zu extrahieren?** Wenn ein Code- oder Logikfunktionsschritt ein Array auf oberster Ebene zurückgibt, können Sie es direkt in einen [Iterator](/l/de/user-guide/workflows/capabilities/use-iterator) einspeisen: Wählen Sie die Option **Whole list** des Schritts als Eingabe des Iterators und verweisen Sie dann innerhalb der Schleife mit `{{iterator.currentItem}}` auf jedes Element. In diesem Fall müssen Sie das Array nicht in ein Objekt umstrukturieren.
</Tip>
<Tip>
Klicken Sie auf das quadratische Symbol oben rechts im Code-Editor, um ihn im Vollbild anzuzeigen — hilfreich, da die Standardbreite des Editors begrenzt ist.
</Tip>

Some files were not shown because too many files have changed in this diff Show More