> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/formulare-und-umfragen/eigene-datenobjekte-in-formularen-und-umfragen-erfassen.md). # Eigene Datenobjekte in Formularen und Umfragen erfassen Erfasse strukturierte Zusatzdaten in Formularen, Umfragen und Quizzen, verknüpfe sie mit Kontakten und vermeide typische Zuordnungsfehler. ## Worum es geht Kontaktfelder beschreiben eine einzelne Person. Ein eigenes Datenobjekt ist sinnvoll, wenn du zusätzlich Dinge, Fälle oder andere fachliche Einheiten festhalten möchtest, die zu einem oder mehreren Kontakten gehören. Das kann zum Beispiel ein Objekt, ein Fahrzeug, ein Haustier oder ein Projekt sein. Die Angaben aus dem Formular werden mit dem Kontakt verknüpft. So sieht dein Team später nicht nur „wer hat das Formular ausgefüllt?“, sondern auch „zu welchem Objekt oder Anliegen gehören diese Angaben?“. Neben eigenen Datenobjekten gibt es das feste Unternehmensobjekt. Es verbindet mehrere Kontakte mit einer Organisation. Für einen einzelnen Kontakt ist dabei nur eine Unternehmensverbindung möglich. Eigene Datenobjekte können dagegen – abhängig von ihrer eingerichteten Beziehung – mehrere Verknüpfungen pro Kontakt abbilden. ## Erst die richtige Datenstruktur wählen | Wenn du erfassen willst | Verwende | Warum | | ------------------------------------ | ------------------- | ------------------------------------------------------------------------------ | | Eine Eigenschaft einer Person | Kontaktfeld | Die Angabe gehört direkt zum Kontakt, etwa eine bevorzugte Sprache. | | Informationen über eine Organisation | Unternehmensobjekt | Mehrere Kontakte können derselben Organisation zugeordnet werden. | | Wiederkehrende fachliche Einheiten | Eigenes Datenobjekt | Die Information ist kein bloßes Kontaktmerkmal, sondern ein eigener Datensatz. | Beim Unternehmensobjekt sind Name, Telefonnummer und E-Mail-Adresse bereits als typische Felder vorhanden. Der Unternehmensname ist dort das feste Hauptfeld. Bei einem eigenen Datenobjekt legst du die Felder und das Hauptfeld selbst fest. Das Hauptfeld ist die wichtigste Bezeichnung eines Datensatzes – etwa **Objektbezeichnung** oder **Fahrzeugkennung**. Es sorgt dafür, dass dein Team die Zuordnung später eindeutig erkennt. ## Voraussetzungen Bevor du einen Formularbereich baust, kläre diese Punkte: * Das eigene Datenobjekt ist unter **Einstellungen** → **Eigene Datenobjekte** angelegt. * Es hat ein verständliches Hauptfeld und die benötigten weiteren Felder. * Für Unternehmensdaten existiert die Organisation unter **Einstellungen** → **Unternehmen**. * Du weißt, welche Verbindung zum Kontakt entstehen soll. * Du verwendest im jeweiligen Formular, in der Umfrage oder im Quiz nur einen Datenobjekttyp. Die Verbindung zum Kontakt heißt in der Oberfläche **Zuordnung**. Sie legt fest, welcher Kontakt zu welchem Datensatz gehört. Richte sie gleich ein, wenn du das erste Feld eines eigenen Datenobjekts hinzufügst. ## Datenobjekt im Formular einrichten 1. Öffne bei Bedarf unter **Einstellungen** → **Eigene Datenobjekte** das gewünschte Objekt und prüfe Hauptfeld sowie weitere Felder. 2. Für Unternehmensdaten öffnest du **Einstellungen** → **Unternehmen** und stellst sicher, dass die betreffende Organisation vorhanden ist. 3. Öffne den Editor des Formulars, der Umfrage oder des Quiz. 4. Füge ein Feld des gewünschten Datenobjekts im Editor ein. 5. Lege die Zuordnung zum Kontakt fest. Entscheide dabei bewusst, welche Beziehung im Alltag abgebildet werden soll. 6. Das Hauptfeld wird automatisch berücksichtigt. Ergänze danach nur die Felder, die die Person tatsächlich ausfüllen muss. 7. Speichere und veröffentliche erst nach einem vollständigen Test. Die Datenobjektfelder werden im Editor hinzugefügt, nicht auf einer öffentlich sichtbaren Seite nachträglich. Plane deshalb die Struktur zuerst; ein späterer Wechsel des Objekttyps macht zusätzliche Aufräumarbeit nötig. ## Mehrere Felder schnell hinzufügen Wenn du mehrere Angaben desselben Datenobjekts abfragen willst, öffnest du im linken Bereich des Editors **Datenobjektfelder hinzufügen**. 1. Wähle im Auswahlfeld das gewünschte Objekt. 2. Suche nach dem Feldnamen oder öffne den passenden Ordner. 3. Nutze Symbol und Feldkennung, um ähnlich benannte Felder auseinanderzuhalten. Die Feldkennung ist die technische, eindeutige Bezeichnung eines Feldes; sie hilft nur bei der Auswahl und muss nicht von Kundinnen oder Kunden verstanden werden. 4. Markiere die benötigten Felder. 5. Wähle **Felder hinzufügen** oder ziehe eines der markierten Felder gemeinsam auf die Arbeitsfläche. Die Auswahl bleibt beim Suchen und Scrollen erhalten. Wechselst du auf ein anderes Objekt, wird sie absichtlich zurückgesetzt. So verhindert die Oberfläche, dass Felder aus zwei verschiedenen Datenobjekten versehentlich vermischt werden. Die neu eingefügten Felder folgen der Reihenfolge in der linken Seitenleiste. Ist auf der Arbeitsfläche bereits ein Element markiert, werden sie direkt danach eingefügt. Andernfalls erscheinen sie am Ende der aktuellen Formularseite oder Quizfolie. Kontrolliere anschließend die Reihenfolge aus Sicht einer Person, die das Formular zum ersten Mal ausfüllt. ## Was nach der Übermittlung passiert Nach dem Absenden wird der Kontakt mit dem Datensatz verknüpft. Du kannst die Verbindung später im Kontakt und im zugehörigen Datenobjekt nachvollziehen. Änderungen an verknüpften Daten werden innerhalb der Verbindung aktualisiert; prüfe deshalb besonders sorgfältig, ob die richtige Person mit dem richtigen Datensatz verbunden wurde. Teste mindestens diese Punkte: 1. Öffne den veröffentlichten Ablauf als Testperson. 2. Fülle das Hauptfeld und alle weiteren Pflichtangaben aus. 3. Übermittle das Formular. 4. Öffne den Testkontakt und kontrolliere die Zuordnung. 5. Öffne den erzeugten Datensatz und prüfe, ob alle Angaben vollständig und richtig gespeichert wurden. 6. Wenn mehrere Kontakte mit demselben Objekt arbeiten sollen, wiederhole den Test mit einem zweiten Kontakt. ## Wichtige Grenzen ### Nur ein Datenobjekttyp pro Ablauf In einem Formular, einer Umfrage oder einem Quiz darfst du Felder eines eigenen Datenobjekts und Unternehmensfelder nicht kombinieren. Entferne zuerst die Felder des bisherigen Objekts, bevor du auf einen anderen Typ wechselst. ### Hauptfeld nicht leichtfertig löschen Entfernst du das Hauptfeld eines eigenen Datenobjekts, verschwinden die zugehörigen Felder aus dem Editor. Lege das Hauptfeld daher nur neu an, wenn du die Auswirkungen verstanden hast. Danach musst du die benötigten Felder im Formular wieder hinzufügen. ### Nicht jede Weiterverwendung ist verfügbar Formulare, Umfragen und Quizze mit Unternehmens- oder eigenen Datenobjektfeldern lassen sich nicht zuverlässig über die Vorlagenbibliothek erstellen oder teilen. Erweiterte Auswertungen, Sammeländerungen und personalisierte Werte für diese Felder stehen in diesem Zusammenhang ebenfalls nicht zur Verfügung. Nutze das Datenobjekt deshalb für eine klare, wiederholbare Datenerfassung – nicht als Ersatz für ein umfassendes Auswertungs- oder Massenpflegewerkzeug. ## Typische Fehler ### Felder eines falschen Objekts erscheinen im Editor Entferne vorhandene Felder des anderen Datentyps vollständig. Wähle danach im Bereich **Datenobjektfelder hinzufügen** das richtige Objekt und füge die Felder erneut ein. ### Die Zuordnung wird nicht geladen Prüfe zuerst die Einrichtung des Datenobjekts und die Internetverbindung. Kontrolliere dann, ob das Hauptfeld existiert und die gewünschte Verbindung zum Kontakt eingerichtet wurde. ### Das Unternehmen ist beim Kontakt nicht sichtbar Stelle sicher, dass die Organisation unter **Einstellungen** → **Unternehmen** vorhanden ist. Prüfe außerdem, ob du den richtigen Kontakt geöffnet hast; ein Kontakt kann nur einer Organisation zugeordnet sein. ### Unklare Feldnamen Verwende kurze, fachlich eindeutige Namen. „Nummer“ oder „Status“ allein führen später schnell zu Verwechslungen. Besser sind Bezeichnungen wie „Fahrzeugkennung“ oder „Objektstatus“. ## Praxisbeispiel Eine Hausverwaltung möchte in einer Interessentenanfrage nicht nur Kontaktdaten, sondern auch Informationen zum gewünschten Mietobjekt erfassen. Sie legt das eigene Datenobjekt **Objekt** mit dem Hauptfeld **Objektbezeichnung** an und ergänzt Felder für Lage, Größe und gewünschten Termin. Im Formular verwendet sie ausschließlich dieses Datenobjekt, richtet die Zuordnung zum Kontakt ein und testet die Übermittlung mit zwei Testkontakten. Danach kann das Team in jedem Kontakt sehen, welchem Objekt die Anfrage zugeordnet ist und welche Angaben übermittelt wurden. ## Ergebnis prüfen Der Ablauf ist sauber eingerichtet, wenn eine Person das Formular ohne Erklärung ausfüllen kann, der richtige Kontakt mit dem richtigen Datensatz verbunden ist und dein Team die Angaben später an beiden Stellen wiederfindet. Ist das nicht eindeutig, vereinfache zuerst Objektname, Hauptfeld und Formularreihenfolge. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://one-loop.gitbook.io/help/plattform/one-loop-plattform/websites-und-leadgewinnung/formulare-und-umfragen/eigene-datenobjekte-in-formularen-und-umfragen-erfassen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.