Datensätze

Virtual Marketer CRM hat fünf Datensatztypen: Contacts, Organizations, Deals, Services und Tasks. Sie nutzen alle dasselbe Screen-Layout, deshalb dokumentiert diese Seite sie gemeinsam, für Menschen und für AI-Agents, die die UI steuern.

Das gemeinsame Layout

Jeder Datensatztyp hat dieselben drei Oberflächen:

• Liste unter /{type} (zum Beispiel /contacts), locale-präfixiert wie https://crm.virtual-marketer.de/en/contacts. Suche, Filter, Sortierung und Massenaktionen leben hier.
• Drawer: Hängen Sie ?open={entityType}:{id} an die Listen-URL an (zum Beispiel /contacts?open=contact:{id}), um einen Datensatz über der Liste zu bearbeiten.
• Detailseite unter /{type}/{id} (zum Beispiel /contacts/42) für den vollen Datensatz, Custom Fields und das Löschen.

Zeilen tragen nie eine DOM-Id. Öffnen Sie einen Datensatz über seine URL oder den Drawer-Deep-Link, nie durch Klick auf eine per Id gesuchte Zeile.

Listen und Toolbars

Jeder Datensatztyp hat seine eigene Route und seine eigenen Toolbar-Ids, mit dem Typ als Präfix. Die vier Toolbar-Steuerelemente verhalten sich überall gleich: Add öffnet den Anlege-Drawer, Search filtert die Liste live, Filter öffnet das Filter-Popover (Filter-Syntax), und Display options steuert Spalten, Sortierung und Ansichtsmodus.

Drawer- und Detail-Aktionen

Diese Ids teilen sich alle Datensatztypen.

Notizen sind ein beschriftetes Feld im Formular. Dort bearbeiten, dann speichern.

Custom Columns und die Board-Ansicht

Jeder Datensatztyp kann benutzerdefinierte Custom Columns tragen. Es gibt keine fest im Typ verankerten Workflow-Felder, also weder eine produktseitige Deal-Stage noch einen produktseitigen Task-Status. get_record_schema gibt zurück, welche Columns ein Workspace für den jeweiligen Typ konfiguriert hat.

Eine singleSelect-Custom-Column kann eine Board-Ansicht (Kanban) steuern. #{type}-display-options wechselt die Liste zwischen Tabelle und einem Board, gruppiert nach einer gewählten singleSelect-Column. Im Board ziehen Sie einen Datensatz zwischen den Spalten, um den Wert dieser Column zu ändern; das Pendant im Drawer oder Detail-Formular ist, das Feld zu setzen und zu speichern. Das gilt für jeden Datensatztyp mit mindestens einer singleSelect-Column, nicht nur für Deals.

Der Demo-Workspace bringt Beispiel-Columns mit, um das Muster zu zeigen, etwa eine "Status"-Column bei Deals sowie "Status"- und "Priority"-Columns bei Tasks. Das sind vorbefüllte Beispiele, kein festes Verhalten. Benennen Sie sie um, ändern Sie ihre Optionen, fügen Sie weitere hinzu oder entfernen Sie sie pro Workspace.

Datensätze verknüpfen sich mit anderen Datensätzen über beschriftete Relations-Felder im Formular. Wählen Sie die Datensätze, dann speichern.

Datumsfelder, die sich selbst füllen

Eine Custom Column der Organisation vom Typ date kann sich selbst füllen. Öffnen Sie die Spalte im Editor für Custom Fields und wählen Sie unter „Automatisch ausfüllen, wenn … gesetzt wird“ ein Feld. Sobald dieses Feld bei einer Organisation zum ersten Mal einen Wert bekommt, wird das heutige Datum (Europe/Berlin) in die Datumsspalte geschrieben. Ein Datum, das schon einen Wert hat, wird nie überschrieben, und wenn das auslösende Feld später geleert wird, bleibt das Datum stehen.

Auslöser kann jede andere Custom Column der Organisation sein, nur keine weitere Datumsspalte. „Nicht automatisch ausfüllen“ schaltet es ab. Wird eine der beiden Spalten gelöscht, verschwindet auch die Einstellung. Über MCP ist dieselbe Einstellung manage_custom_columns mit set_auto_date oder remove_auto_date, und get_record_schema zeigt sie als autoFilledFrom an der Datumsspalte.

Reihenfolge und mehrzeilige Felder

Custom Fields erscheinen im Formular und in der Tabelle alphabetisch. Wer ein Feld weiter nach oben holen will, trägt im Editor für Custom Fields unter „Position“ eine Zahl ein: eine kleinere Zahl steht weiter oben, alle Felder ohne Position folgen danach alphabetisch. Ein leeres Feld entfernt die Position wieder. Ein Textfeld (plain) mit „Mehrzeilig“ wird als mitwachsendes Textfeld angezeigt statt als einzelne Zeile, passend für längere Texte wie E-Mail-Entwürfe oder Begründungen.

Beschreibung, Lernen und Prüfpflicht

Jedes Custom Field hat im Editor drei weitere Einstellungen für den Virtual Marketer Agent. Die Beschreibung für den Agenten ist die ausdrückliche Regel des Feldes, etwa „Betreff höchstens 60 Zeichen, kein Emoji“; der Agent liest sie vor jedem Schreiben, und sie geht allem Gelernten vor. Aus Bearbeitungen lernen macht jede Änderung durch einen Menschen zu einem Lernsignal: korrigieren Sie einen Entwurf des Agenten, schreibt er die nächsten Entwürfe entsprechend. Änderung kritisch prüfen ist für folgenreiche Felder wie Zielgruppe oder Stil gedacht: ein Agent ändert den Wert dann nur mit einer Begründung, die mit dem Briefing übereinstimmt, und die Begründung steht im Änderungsverlauf. Ihre eigenen Änderungen in der Oberfläche sind davon nicht betroffen. Mehr dazu unter Der Virtual Marketer Agent.

Tipps für Agents

• Finden Sie Steuerelemente über die stabilen Ids oben, zum Beispiel document.querySelector('#deals-add'). Ids sind über Sprachen und Viewports identisch, sichtbare Labels nicht.
• Um einen Datensatz zu öffnen, bauen Sie die URL selbst: /{type}/{id} für die volle Seite oder /{type}?open={entityType}:{id} für den Drawer. Versuchen Sie nicht, eine Zeile anzuklicken.
• Bevorzugen Sie MCP-Tools gegenüber dem Bedienen der UI, wenn ein Tool existiert. Einen Datensatz anlegen oder ändern, oder den Wert einer singleSelect-Column setzen, ist ein Tool-Call statt einer Klickstrecke.

Verwandte Seiten

• Kernkonzepte: Entitäten, Beziehungen, Custom Columns.
• MCP-Tool-Katalog: jedes Tool, das Ihre KI aufrufen kann.
• App-Guide, Dashboard