CRM-Dashboard konfigurieren
Der Start nach der Anmeldung: Diagramm-, Verlaufs-, Kalender- und Karten-Widgets über Ihren CRM-Daten, Dashboard-Ansichten, Widget-Editor und Tastenkürzel.
Was zeigt das Dashboard, und kann ich Widgets mit meinem Team teilen?
Auf dem Dashboard landen Sie nach der Anmeldung. Es zeigt Widgets über Ihren CRM-Daten: Pipelines, Aufgabenzahlen, letzte Aktivität, was immer Sie einrichten. Jedes Widget gehört Ihnen. Teammitglieder sehen es erst, wenn Sie im Editor Als Vorlage freigeben einschalten, und starten daraus dann ihre eigene Kopie. Zum Hinzufügen von Widgets ist keine Rollenberechtigung nötig, aber ein Diagramm zählt nur die Datensätze, die Ihre Rolle lesen darf, deshalb kann die Kopie eines Teammitglieds andere Zahlen zeigen. Widget hinzufügen erscheint nur, wenn Ihre Rolle mindestens eine Liste lesen darf. In einem Workspace ohne Listen weist das Dashboard darauf hin und bietet Personen, die das Datenmodell verwalten, Liste erstellen an.
Kann ich mehrere Dashboards haben?
Ja. Die Ansichts-Chips über den Widgets wechseln zu Ihren eigenen benannten Dashboards, etwa eines pro Team oder Zweck; ist keines ausgewählt, sehen Sie das Haupt-Dashboard, und ein erneuter Klick auf die ausgewählte Ansicht führt dorthin zurück. Neue Ansicht legt eines an, und V öffnet wie auf einer Liste die Ansichtsauswahl. Jede Ansicht behält ihre eigenen Widgets und deren Anordnung, ein neues Widget landet in der Ansicht, die Sie gerade sehen, und ein Link auf eine Ansicht öffnet für Sie genau dieses Dashboard. Ansichten und ihre Widgets gehören Ihnen, bis Sie sie teilen: Teilen… im Menü einer Ansicht zeigt sie wie auf einer Liste allen im Workspace oder ausgewählten Rollen. Teammitglieder finden sie dann nach ihren eigenen Ansichten als Chip mit Ihrem Foto und sehen dieselben Widgets und dieselbe Anordnung, nur lesend; jede Zahl wird mit ihrem eigenen Zugriff berechnet. Die Widgets ändern nur Sie; Als neue Ansicht duplizieren gibt Ihren Kolleginnen und Kollegen eine eigene Kopie mit allen Widgets und ihrer Anordnung, die sie frei ändern können, ohne Ihre zu berühren. Wenn Sie eine eigene Ansicht duplizieren, werden ihre Widgets genauso mitkopiert. Das Haupt-Dashboard lässt sich nicht teilen; teilen Sie stattdessen eine benannte Ansicht. Wer den Link einer Ansicht öffnet, die nicht mit ihm geteilt ist, sieht das eigene Dashboard. Beim Löschen einer Ansicht kommt sie mitsamt ihren Widgets in den Papierkorb, und die Bestätigung nennt sie; Rückgängig oder Wiederherstellen holt beide zurück.
Kann ich ein Dashboard mit Personen außerhalb des Workspaces teilen?
Ja, mit einem öffentlichen Link. Öffnen Sie in einer eigenen Dashboard-Ansicht Teilen…, wählen Sie Alle mit dem Link und klicken Sie auf Speichern; der Link wird erstellt und kopiert, und alle im Workspace sehen die Ansicht ebenfalls. Jede Person mit dem Link sieht dann die Diagramme und Zahlen dieser Ansicht live, nur lesend und ohne Anmeldung, unter einer Adresse, die auf /p/… endet; die Seite zeigt den Namen der Ansicht und Ihren Workspace-Namen. Die Zahlen werden mit Ihrem Zugriff berechnet, ein öffentlicher Link zeigt also nie mehr, als Sie selbst sehen. Ein Klick auf einen Balken oder eine Zahl öffnet die Datensätze dahinter, nur lesend und mit Ihrem Zugriff, mit dem Namen des Datensatzes und den Feldern, nach denen das Diagramm gruppiert oder summiert; Besucher können im Drawer suchen, filtern, sortieren und Spalten anpassen, aber nur in den angezeigten Spalten, und nichts wird gespeichert; ändern lässt sich nichts, und Datensätze öffnen sich nicht auf eigenen Seiten. Listen, Kalender, Karten und Aktivitätsverläufe fehlen. Jede Person mit dem Link sieht diese Diagramme und Datensätze, veröffentlichen Sie also nur Boards, die Sie zeigen möchten. Kopieren kopiert den Link jederzeit erneut, Letzter Tag, an dem der Link funktioniert (UTC) setzt ein optionales Enddatum, und der Dialog zeigt, wie oft der Link geöffnet wurde. Eine andere Option zu wählen und zu speichern stoppt den Link sofort; erneut Alle mit dem Link zu wählen erzeugt eine neue Adresse. Gespeicherte Listenansichten lassen sich genauso veröffentlichen (Listen). Solange der Link aktiv ist, zeigt der Chip Ihrer Ansicht eine Weltkugel.
Veröffentlichen erfordert Erstellen in der Zeile Öffentliche Links Ihrer Rolle; die Rolle Admin hat das. Öffentliche Links erlauben unter Allgemein schaltet alle öffentlichen Links des Workspaces aus und wieder ein; solange es aus ist, zeigt jeder Link Link nicht verfügbar. Ein Link funktioniert außerdem nicht mehr, wenn er abläuft, die Ansicht in den Papierkorb kommt oder die Person, die ihn erstellt hat, die Berechtigung verliert, deaktiviert wird oder den Workspace verlässt. Erstellen und Ausschalten eines Links erscheinen unter Audit-Log. Das Haupt-Dashboard lässt sich nicht veröffentlichen; veröffentlichen Sie eine benannte Ansicht. Mate und andere MCP-Clients veröffentlichen mit manage_data_views und der Aktion publish, der REST-Endpunkt ist POST /api/v1/data-views/publish; auch dort sehen danach alle im Workspace die Ansicht, und wer sie privat oder für Rollen teilt, beendet den Link.
Welche Widget-Typen gibt es, und welche Diagramme können sie zeigen?
Klicken Sie auf Widget hinzufügen, um Widget auswählen zu öffnen. Zuerst kommt Von Grund auf neu mit einer Karte pro Diagrammstil (Kennzahl, Balkendiagramm, Horizontale Balken, Fläche im Zeitverlauf, Rangliste, Ring, Trichter und Netz) sowie Aktivitätsverlauf, Anstehend, Monatsübersicht und Karte; eine Karte öffnet den Editor mit diesem Stil, und Sie wählen die Daten. Mit einer Vorlage starten listet Widgets, die Teammitglieder freigegeben haben. Ein Widget, das für Sie gebaut wird, beschreiben Sie mit Mate fragen im Widget-Editor.
- Ein Diagramm aggregiert eine Liste: Anzahl, Summe, Durchschnitt, Minimum oder Maximum eines Zahlenfelds. Gruppieren Sie nach einem Feld, nach einzelnen Datensätzen, nach Zugewiesen an (ein Datensatz mit zwei zuständigen Personen zählt für beide) oder über eine Beziehung, etwa Deal-Wert nach Phase oder Positionsbeträge nach Service. Jeder Quelldatensatz zählt einmal pro Gruppe, ein Deal mit zwei Organisationen zählt also für beide vollständig. Für einen Zeitverlauf gruppieren Sie nach einem Datumsfeld, nach Erstellt am oder Aktualisiert am und wählen ein Zeitintervall (Tag, Woche ab Montag, Monat, Quartal oder Jahr). Uhrzeiten werden in der Zeitzone des Browsers eingeteilt, der das Widget gespeichert hat; reine Datumswerte verschieben sich nie, und Datensätze ohne Datum werden unter dem Diagramm gezählt.
- Aktivitätsverlauf ist ein Feed von Änderungen, Nachrichten und Kanalaktivitäten, neueste zuerst. Seine Filter gehören zu diesem Widget, sodass mehrere Verläufe Unterschiedliches zeigen können, ohne einander oder die Ansicht Aktivitäten eines Datensatzes zu verändern.
- Anstehend listet die Datensätze einer Liste nach einem Datums- oder Datum-Uhrzeit-Feld für die nächsten Tage (standardmäßig 14, höchstens 90), mit einem Abschnitt Überfällig für frühere Daten und optional einer Betragsspalte. Filtern Sie erledigte Datensätze heraus, etwa abgeschlossene Aufgaben, damit nur offene als überfällig zählen.
- Monatsübersicht färbt jeden Tag eines Monats danach, wie viele Datensätze auf ihn fallen, oder nach der Summe eines Zahlen- oder Währungsfelds. Die Pfeile wechseln den Monat, und ein Tag öffnet eine Liste seiner Datensätze.
- Karte zeigt die Datensätze einer Liste an der Position, die mit einem Adressfeld gespeichert ist, und fasst nah beieinander liegende Datensätze zu nummerierten Gruppen zusammen. Ein Einfachauswahlfeld färbt die Markierungen in den Farben seiner Optionen, wie in Diagrammen, ein Zahlen- oder Währungsfeld bestimmt ihre Größe, und eine Markierung öffnet eine Karte mit Name, Adresse, einem optionalen Detailfeld und Datensatz öffnen. Eine Gruppe übernimmt die Farbe von mehr als der Hälfte ihrer Datensätze; ohne eine solche Mehrheit ist sie ein ungefärbter Ring, den die Legende als Gemischt aufführt.
Unter Darstellung kann ein Diagramm ein vertikales oder horizontales Balkendiagramm (mit oder ohne Beschriftungen), ein Ring- oder Radardiagramm sein oder einer dieser Stile:
| Stil | Zeigt | Erfordert |
|---|---|---|
| Kennzahl | Einen Gesamtwert | Keine Gruppierung |
| Fläche im Zeitverlauf | Einen Wert pro Zeitraum; leere Zeiträume sind bei Anzahl und Summe null, sonst eine Lücke | Ein Zeitintervall |
| Rangliste | Gruppen nach Wert mit Anteil an der Summe, die ersten zehn und der Rest | Eine Gruppierung |
| Trichter | Jede Option in Reihenfolge mit der Umwandlung von Schritt zu Schritt; eine Phase mit Wahrscheinlichkeit 0, etwa Verloren, steht darunter | Ein Einfachauswahlfeld wie eine Phase |
Ein Stil, der nicht zur Gruppierung passt, ist mit einem Hinweis deaktiviert. Berechnete Werte erfordern Zugriff auf ihre Eingaben.
Was kann ein Aktivitätsverlauf zeigen, auch Kalenderereignisse?
Ein Verlauf zeigt dieselben Einträge wie Audit-Log: Datensatzänderungen mit vorherigem und aktuellem Wert, Verwaltungs- und Konfigurationsänderungen, Nachrichten, Kanalaktivitäten wie angenommene LinkedIn-Kontaktanfragen und Termine aus dem Kalender eines verbundenen Gmail- oder Outlook-Kontos (das Kalenderlayout einer Liste und die Kalender-Widgets zeigen Datensätze nach ihren Datumsfeldern, keine Termine). Filtern Sie nach Aktivitätstyp, Anbieter, Kanal, Unterhaltung oder Verknüpfte Datensätze, und begrenzen Sie ihn auf Datensatztypen oder Datensätze oder auf ein Datum Von und Bis. Verknüpfte Datensätze nutzen Enthält mindestens einen von, Schließt alle aus, Hat einen verknüpften Datensatz und Hat keinen verknüpften Datensatz. Verschiedene Filter müssen alle zutreffen; mehrere Werte in einem Filter treffen zu, wenn einer passt.
Ältere laden zeigt die nächste Seite. Eine Zeile kann einen primären und bis zu drei verknüpfte Datensätze verlinken, und eine Nachricht kann ihren Thread im Posteingang öffnen. Zeilen ohne Datensatz bleiben ohne Link sichtbar.
Wie gehen Kalender-Widgets mit Datum und Zeitzonen um?
Ein reines Datumsfeld ist ein Kalendertag und verschiebt sich nie. Ein Datum-Uhrzeit-Feld landet auf dem Tag, auf den es in der Zeitzone des Widgets fällt, also der Zeitzone des Browsers, der das Widget angelegt hat; „heute“ und Überfällig richten sich nach derselben Zeitzone. Das Datumsfeld kann auch ein Datumsbereich oder Datum-Uhrzeit-Bereich sein: Der Datensatz erscheint am Tag, an dem sein Bereich beginnt, und gilt als überfällig, sobald der Bereich geendet hat. Anstehend zeigt bis zu 100 Datensätze und bis zu 20 überfällige mit ihrer Gesamtzahl. Monatsübersicht zählt oder summiert jeden Datensatz des Monats, und ein Tag listet bis zu 100 seiner Datensätze. Beide nutzen dieselben Filter, Datensatzrechte und Feldberechtigungen wie Diagramme, daher zeigt die Kopie einer freigegebenen Vorlage nur, was das jeweilige Teammitglied lesen darf.
Woher kommt die Karte, und welche Datensätze fehlen darauf?
Die Karte zeigt Ländergrenzen, Regionen und Städte aus Natural Earth (gemeinfrei). Diese Kartendateien liefert Customermates mit, und Ihr eigener Customermates-Server stellt sie bereit, daher schickt eine Karte keine Anfrage an einen externen Karten-, Kachel-, Schrift- oder Geocoding-Dienst, und ein selbst gehosteter Server zeigt Karten auch ohne Internetzugang. Die Kartendateien laden erst, wenn ein Karten-Widget auf dem Bildschirm ist.
Ein Datensatz erscheint dort, wo sein Adressfeld eine Position speichert: in der Mitte des Postleitzahlgebiets, sobald das Postleitzahlenverzeichnis die Postleitzahl kennt, oder am Gebäude nach einer Adresssuche auf einem selbst gehosteten Server mit Photon (siehe Wie gebe ich eine Adresse ein?). Datensätze ohne Adresse, ohne gespeicherte Position oder mit einer Adresse, die Sie nicht lesen dürfen, zählt stattdessen der Hinweis unter der Karte. Eine Karte zeigt höchstens 2.000 Datensätze; schränken Sie die Filter ein, wenn das Widget meldet, dass es nur einen Teil zeigt. Zoomen Sie mit den Schaltflächen, der Tastatur (+ und -, Pfeiltasten zum Verschieben, 0 zum Zurücksetzen) oder dem Mausrad bei gedrückter Cmd/Strg-Taste; sobald Sie die Karte ausgewählt haben, zoomt das Mausrad auch ohne Taste. Auf einem Touchscreen scrollt ein Finger die Seite, und zwei Finger verschieben und zoomen die Karte. Wählen Sie eine Gruppe, um hineinzuzoomen.
Wer sieht was in einem Verlauf?
| Zugriff | Sichtbarer Inhalt |
|---|---|
| Nur Aktivitätsprotokoll | Zulässige Änderungen |
| Nur Inbox-Nachrichten, in einem Tarif mit Messaging | Zulässige Nachrichten, Kanalaktivitäten und Termine |
| Beides | Ein zusammengeführter Verlauf |
| Keines von beiden | Ein Hinweis, dass keine Aktivität verfügbar ist |
Die beiden Berechtigungen sind die Zeilen Aktivitätsprotokoll und Inbox-Nachrichten der Rolle des Mitglieds unter Rollen, jeweils mit Lesen auf Alle. Nachrichten, Kanalaktivitäten und Termine erfordern außerdem Customermates Cloud und einen Tarif mit Messaging (Pro und höher); Änderungen bleiben auch ohne ihn sichtbar. Ein gelöschter oder nicht mehr zugänglicher Filterwert liefert keine Treffer mehr und erscheint als Filter nicht verfügbar auf dem Chip und als Auswahl nicht verfügbar in der Auswahl, damit Sie ihn entfernen können.
Wie lege ich ein Diagramm- oder Aktivitätsverlauf-Widget im Widget-Editor an oder bearbeite es?
Wählen Sie unter Widget auswählen einen Diagrammstil, Aktivitätsverlauf, Anstehend, Monatsübersicht, Karte oder eine Vorlage; alle öffnen denselben Editor. Geben Sie dem Widget einen Namen und wechseln Sie dann zwischen Daten und Darstellung. Daten enthält die Quelle und was gezählt wird; Filter und Gruppierung sind einklappbare Abschnitte darin, und sobald Sie gruppieren, legt Gruppenfilter fest, welche Datensätze als Gruppen erscheinen. Beide Filterabschnitte zeigen dieselbe durchsuchbare Filter-Palette wie eine Liste, und verknüpfte Felder erscheinen als Liste › Feld. Darstellung enthält Diagrammstil, Farben, Legende, Kennzahl und Filter anzeigen und Als Vorlage freigeben. Die Live-Vorschau über den Einstellungen zeigt das Widget mit echten Daten und aktualisiert sich bei jeder Änderung; wählen Sie Dashboard-Größe, um es in den Proportionen zu sehen, die es auf dem Dashboard einnimmt. Klicken Sie in der Fußzeile auf Speichern.
Ein Klick auf ein Diagramm oder einen Balken öffnet den Daten-Drawer: oben bleibt das Diagramm, darunter stehen die beitragenden Datensätze mit den üblichen Listenfiltern und der Seitennavigation. Eine andere Gruppe ändert die Datensätze. In Liste öffnen öffnet die Übersicht mit derselben Auswahl und zusätzlichen Filtern; die Abfrage umfasst alle passenden Datensätze. Ein Klick auf eine Zeile öffnet den Datensatz. Zum Bearbeiten verwenden Sie den Stift bei Hover oder Tastaturfokus oder Bearbeiten im lokalen Menü, das auch per Rechtsklick erreichbar ist. Ein Filter-Chip öffnet den Editor bei diesem Filter. Zurücksetzen stellt nach einer Änderung die gespeicherten Werte wieder her, und das Papierkorb-Symbol in der Kopfzeile des Editors verschiebt das Widget nach einer Bestätigung in den Papierkorb. Ein neues Widget erhält den ersten freien Platz. Ziehen Sie ein Widget, um es zu verschieben, und ziehen Sie an einer Kante oder Ecke, um seine Größe zu ändern (Verschieben ist auf Touch-Geräten aus); die Anordnung wird nur für Sie gespeichert. Höhen rasten in Zeilen von 54 px ein; Diagramm- und Zahl-Widgets sind mindestens zwei Zeilen hoch, ein Aktivitätsverlauf mindestens sechs Zeilen hoch und zwei Spalten breit, ein Kalender-Widget mindestens fünf Zeilen hoch und zwei Spalten breit und eine Karte mindestens fünf Zeilen hoch und drei Spalten breit.
Welche Controls bringt die Seitenleiste mit?
Die Seitenleiste enthält Ihre Arbeit und ist auf jedem Screen dieselbe. Oben stehen Suchen (Cmd/Strg+K, siehe Globale Suche), Mate fragen (Cmd/Strg+J, siehe der Assistent) und Hinzufügen (C). Darunter folgen Übersicht mit Dashboard, Wissensdatenbank, Kalender, Posteingang und Automatisierungen, dann Daten mit Ihren Listen, dann Ihre eigenen Abschnitte. Einträge, die Ihre Rolle nicht öffnen darf, sind ausgeblendet. Posteingang zählt ungelesene Unterhaltungen.
Die Seitenleiste gehört Ihnen: Ziehen Sie einen Eintrag, um ihn umzusortieren oder in einen anderen Abschnitt zu verschieben, oder nutzen Sie sein Menü … für Nach oben, Nach unten, In Abschnitt verschieben (einschließlich Neuer Abschnitt) und In der Seitenleiste ausblenden. Ein Klick auf einen Abschnittstitel klappt ihn ein; sein Menü … (oder ein Rechtsklick) bietet Nach oben und Nach unten, bei selbst angelegten Abschnitten auch Umbenennen und Abschnitt löschen. Beim Löschen eines Abschnitts kehren seine Einträge an ihren Standardplatz zurück; ausgeblendete Einträge bleiben ausgeblendet. Seitenleiste anpassen im persönlichen Menü öffnet einen Dialog mit einem Schalter je Eintrag zum Ein- oder Ausblenden, Neuer Abschnitt und, sobald Sie etwas geändert haben, Auf Standard zurücksetzen, das nach einer Bestätigung die Standardanordnung wiederherstellt. Andere sehen Ihre Änderungen nicht.
Der Name des Workspace oben öffnet das Workspace-Menü: die Workspaces, zu denen Sie gehören, zum Wechseln, Workspace erstellen, Mitglieder einladen (wenn Sie einladen dürfen), Mitglieder, Einstellungen, Abrechnung mit einem Chip für Ihren Tarif und seinen Status sowie für Customermates-Operatoren Operator-Konsole. Ihr Avatar öffnet das persönliche Menü: Profil & Einstellungen, Darstellung (System, Hell oder Dunkel), Sprache, Tastenkürzel, Dokumentation, Feedback senden, Seitenleiste anpassen und Abmelden. Einstellungen und G, dann S öffnen Profil & Einstellungen, und die Seitenleiste wechselt zur Einstellungsnavigation mit Konto (Profil & Einstellungen, Workspaces, Kanäle & Kalender, API-Schlüssel & Konnektoren) und Workspace (Allgemein, Mitglieder, Rollen, Abrechnung, Audit-Log, Webhooks); Zurück oben darin führt zur Seite zurück, von der Sie kamen. Seitenleiste anpassen wird nicht angeboten, solange die Einstellungsnavigation angezeigt wird. Bis Sie Ihre Adresse bestätigt haben, zeigen Ihr Avatar und der Eintrag Profil & Einstellungen E-Mail nicht verifiziert.
Welche Tastenkürzel gibt es?
Drücken Sie ? oder wählen Sie Tastenkürzel im persönlichen Menü, um alle Kürzel mit den Tasten Ihres Computers zu sehen (⌘ auf dem Mac, sonst Strg), gruppiert und durchsuchbar. Kürzel mit Cmd/Strg und Esc wirken überall, auch während Sie tippen. Einzeltasten und G-Folgen wirken nur, wenn kein Textfeld den Fokus hat und kein Menü oder Dialog offen ist.
| Gruppe | Tasten | Wirkung |
|---|---|---|
| Allgemein | Cmd/Strg+K oder / | Suchen; tippen Sie eine Frage und drücken Sie Tab, um stattdessen Mate zu fragen |
| Allgemein | Cmd/Strg+J | Mate fragen (öffnet oder schließt den Assistenten) |
| Allgemein | ? | Tastenkürzel anzeigen |
| Allgemein | Cmd/Strg+\ | Seitenleiste ein- oder ausblenden |
| Navigation | G dann D, I, K, R, C | Dashboard, Posteingang, Wissensdatenbank, Routinen, Datenmodell |
| Navigation | G dann S | Einstellungen |
| Navigation | G dann W | Workspace wechseln, wenn Sie zu mehreren gehören |
| Erstellen | C | Datensatz oder Liste hinzufügen |
| Listen und Ansichten | G dann 1 bis 9 | Listen nach ihrer Position in Ihrer Seitenleiste; ausgeblendete Listen werden übersprungen |
| Listen und Ansichten | V | Ansicht einer Liste oder des Dashboards wechseln |
| Listen und Ansichten | F | Suche und Filter einer Liste öffnen |
| Formulare | Cmd/Strg+Enter | Offenes Formular speichern |
| Formulare | Esc | Obersten Dialog oder Drawer schließen |
Nach G haben Sie etwa eine Sekunde für die zweite Taste; ein Hinweis zeigt, dass die App wartet. Kürzel für Seiten, die Ihre Rolle nicht öffnen darf, fehlen. Die Suche listet dieselben Befehle mit ihren Tasten: oben Mate fragen, dann die Ansichten der Liste, auf der Sie sind, die Seiten, Hinzufügen und, mit mehreren Workspaces, Workspace wechseln…. Wenn Sie Spracheingabe nutzen oder versehentlich Tasten drücken, schalten Sie Einzeltasten-Kürzel unten im Kürzel-Dialog aus; Kürzel mit Cmd/Strg funktionieren weiter. Die Einstellung gilt nur für Sie und auf allen Geräten.
Was passiert beim ersten Start?
Neue Accounts durchlaufen den Onboarding-Wizard, bevor sie das Dashboard sehen: Ihr Profil, die Wissensdatenbank, Team-Einladungen und das Verbinden eines KI-Clients. Die einrichtende Person kann Website-Import, Einladungen und KI-Verbindung überspringen; eingeladene Mitglieder sehen nur ihr Profil.
Für Agents
Erstellen und ändern Sie Widgets mit manage_widgets, statt den Editor zu bedienen; das Tool unterstützt dieselben Optionen wie die App. Lesen Sie ein Widget vor einer Änderung, denn ein übergebenes measure- oder displayOptions-Objekt ersetzt das ganze Objekt, und übergeben Sie die aktuelle expectedRevision, einen idempotencyKey und bei Änderungen expectedVersion. Ein Zeitverlauf setzt groupBy.dateInterval und eine IANA-Zeitzone in groupBy.timeZone; Verläufe nutzen activityQuery, Kalender-Widgets calendarQuery (layout upcoming oder month, das Datumsfeld und eine IANA-Zeitzone in timeZone) und Karten mapQuery (das Adressfeld sowie optional Farb-, Größen- und Detailfeld). get liest ein Kalender-Widget für einen anderen Zeitraum window von bis zu 42 Tagen, etwa einen Monat oder einen Tag. Die Widget-Art lässt sich nicht ändern. Ein optionales layout platziert ein Widget im selben Aufruf: x und w zählen Spalten des 12-Spalten-Rasters, y und h Zeilen von 54 px. Diagramm- und Zahl-Widgets brauchen ein h von mindestens 2, ein Aktivitätsverlauf ein w von mindestens 2 und ein h von mindestens 6, ein Kalender ein w von mindestens 2 und ein h von mindestens 5, eine Karte ein w von mindestens 3 und ein h von mindestens 5, und überlappende Positionen werden abgelehnt. Leere Zeilen zwischen Widgets sind erlaubt; das Dashboard rückt Widgets in sie nach oben. get_calendars liest Kalenderereignisse. Die genauen Schemas stehen im MCP-Katalog.
Welche REST-Endpunkte verwalten Widgets?
Über REST liefert POST /api/v1/widgets/list jedes Widget aus allen Ihren Dashboard-Ansichten mit viewId und Layout, POST /api/v1/widgets/save legt eines an oder ändert es, POST /api/v1/widgets/layout verschiebt mehrere und ändert ihre Größe auf einmal, und POST /api/v1/widgets/delete verschiebt eines in den Papierkorb. Für einen Verlauf, einen Kalender oder eine Karte übergeben Sie widgets/save den Wert kind: "activityTimeline", "calendar" oder "map"; ohne kind wird ein neues Widget ein Diagramm, eine Änderung kann unveränderte Einstellungen weglassen, und ein anderes kind bei einer Änderung wird mit widgetKindImmutable abgelehnt. POST /api/v1/widgets/read liefert ein Widget mit seinen aktuellen Ergebnissen; bei einem Kalender-Widget nimmt es zusätzlich ein window mit from und to an. Dashboard-Ansichten sind gespeicherte Ansichten der Oberfläche dashboard unter /api/v1/data-views/.