Boards, Spalten und Lanes
Ein Board liegt in einer Collection. Collections sind die Art, wie Boards gruppiert werden („Produkt", „Kundenarbeit", „Intern"), und ein Board sitzt an der Wurzel einer Collection, nie unter einem anderen Board.
Ein Board ist dreierlei zugleich, und es lohnt sich, das zu trennen:
- Ein Raster: seine Spalten und Lanes.
- Ein Dokument: ein Textkörper über dem Raster, in den man schreibt.
- Eine Menge Karten: Sie sind Seiten und haben eine eigene Seite.
Das Symbol des Boards steht neben seinem Titel oben im Board. Ein Klick darauf wählt ein Emoji oder ein Symbol oder lädt ein Bild hoch; ohne Symbol zeigt das Board dort ein blasses Board-Zeichen.
Das Raster
Spalten sind die Stationen: Zu tun, In Arbeit, Fertig. Jede hat eine Beschriftung und, wenn Sie möchten, ein Symbol. Eine Farbe hat sie nicht, und das ist Absicht: Sie wäre eine zweite Marke neben dem Symbol, und die schwächere von beiden, denn eine Farbe muss man je Board lernen, ein Zeichen nicht.
Lanes sind die waagerechte Teilung: nach Team, nach Arbeitsstrang, nach Kunde. Eine Lane hat eine Beschriftung und, wie eine Spalte, wahlweise ein Symbol, gesetzt mit derselben Auswahl an ihrer Überschrift. Eine Farbe hat auch eine Lane nicht.
Namen sind je Board eindeutig: Zwei Spalten können nicht gleich heißen, zwei Lanes ebenso wenig, und eine Lane kann nicht so heißen wie die Zeile für Karten ohne Lane. Groß- und Kleinschreibung und Leerzeichen am Rand zählen nicht, „Team A“ und „team a“ sind also derselbe Name. Eine Spalte und eine Lane dürfen gleich heißen.
Beides sind schlicht Listen am Board. Spalten umzuordnen heißt, die Liste umzuordnen. Einklappen lässt sich beides, und die stille Zeile für Karten ohne Lane ebenso; dieser Zustand steht am Board, eine Spalte klappt also für alle zu, die das Board öffnen.
Die Zeile für Karten ohne Lane lässt sich je Board auch umbenennen, etwa in
„Allgemein", über das Menü ⋯ neben ihrer Überschrift (noLaneLabel in der
API). Bleibt der Name leer, heißt sie wieder „Keine Lane". Sie bleibt die Zeile
ohne Lane: Sie lässt sich nicht verschieben oder löschen, und ihre Karten haben
keine Lane.
Eine Lane löschen Sie über das Menü ⋯ neben ihrer Überschrift: Lane
löschen…. Die Rückfrage davor nennt, wie viele Karten in der Lane stehen. Sie
bleiben erhalten: Jede bleibt in ihrer Spalte und steht danach in der Zeile für
Karten ohne Lane. In der API ist das removedLanes mit {"moveTo": null} für
die gelöschte Lane.
curl -X PATCH "$BASE/api/v1/workspaces/$WS/boards/$BOARD" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"columns": [
{ "id": "…uuid…", "label": "Zu tun" },
{ "id": "…uuid…", "label": "In Arbeit" },
{ "id": "…uuid…", "label": "Fertig" }
]
}'
Drei Eigenschaften dieses Aufrufs tragen:
- Die Liste wird ganz ersetzt, nicht verschmolzen. Schicken Sie jede Spalte mit, die bleiben soll. Es gibt keinen Aufruf „eine Spalte hinzufügen": Zwei Clients, die je eine Spalte an eine unvollständige Liste hängen, sind genau der Weg, auf dem ein Board still eine Station verliert.
- Die Kennungen vergeben Sie. Die Kennung einer Spalte gehört Ihnen und gilt nur für dieses Board. Genau das erlaubt, „In Arbeit" in „In Bearbeitung" umzubenennen, ohne eine einzige Karte anzufassen: Die Karten zeigen auf die Kennung, nicht auf die Beschriftung.
- Eine Spalte zu löschen verschiebt ihre Karten nicht. Sie behalten die Kennung, die sie hatten, und die gruppierte Abfrage meldet sie darunter. Nichts geht verloren, und nichts wird still einer Station zugeschlagen, die Sie nicht gewählt haben. Aber ein Board in diesem Zustand hat Karten, die Sie im Raster nicht sehen, bis Sie die Spalte wieder anlegen oder die Karten verschieben.
Ein neues Board beginnt ohne Spalten und ohne Lanes. Der Server hat keine Meinung dazu, wie Ihre ersten drei Spalten heißen sollten; das entscheidet, was das Board anlegt.
Der Textkörper des Boards
Ein Board trägt ein eigenes Dokument über dem Raster. Es ist derselbe Editor, den auch eine Seite hat. Er ist für das, was eine Spaltenüberschrift nicht sagen kann: wofür dieses Board da ist, wie es geführt wird, was „Fertig" hier bedeutet.
Karten lassen sich in diesen Textkörper einbetten, ein Absatz kann also auf die Karte zeigen, um die es geht, und die Karte bleibt eine Karte.
Kommentare am Textkörper des Boards sind nicht gebaut. Kommentare an Karten schon.
Ein Board lesen
Ein Board wird in einer Anfrage gelesen, gruppiert:
GET /api/v1/workspaces/{workspaceId}/boards/{boardId}/cards
Die Antwort sind Gruppen aus (Spalte × Lane), jede mit einem Fenster von Karten,
einem eigenen Cursor und einer Gesamtzahl. Diese Form ist der Punkt: Ein Board
mit zehntausend Karten muss den Kopf jeder Spalte zeichnen, ohne jede Karte zu
lesen, und ein Board als eine flache Liste zu blättern kann das nicht.
windowSize legt fest, wie viele Karten je Gruppe kommen.
filters beschränkt die Antwort auf passende Karten: ein JSON-Array von
Bedingungen {"fieldId", "op", "value"}, wie bei den Filtern einer
Datenbank-Ansicht (eq, ne, contains, is_empty, is_not_empty, dazu
gt, gte, lt, lte für eine Zahl oder ein Datum, ein Datum in ganzen Tagen),
höchstens 20. Bei einem Kontrollkästchen trifft eq false (wie ne true)
auch auf Karten zu, deren Kästchen nie berührt wurde. Mit match=any reicht
eine erfüllte Bedingung; der Standard
all verlangt alle. Der Filter wirkt vor den Fenstern, also zählen Karten,
Cursor und Gesamtzahl jeder Gruppe nur passende Karten. Ein Cursor merkt sich
den Filter nicht: dieselben filters mitschicken. Eine Feld-ID, die es im
Workspace nicht gibt, wird mit validation_failed abgelehnt.
Zweierlei sollte man erwarten:
- Ein leeres Board hat keine Gruppen, nicht eine leere Gruppe je Spalte. Gruppen entstehen aus Karten.
- Es gibt eine Gruppe ohne Spalte: die Karten, die nie platziert wurden. Eine Zeile, die über die allgemeine Zeilen-API in die Datenbank hinter dem Board kommt, landet dort. Ohne diese Gruppe gäbe es solche Karten, und man käme nicht an sie heran.
Ein Board wird betrachterabhängig gelesen. Eine Karte, deren Seite Sie nicht lesen dürfen, fehlt ganz, statt als Platzhalter zu erscheinen. Zahlen und Cursor sind also von Person zu Person verschieden. Das ist dieselbe Regel wie sonst überall: „Sie dürfen es nicht sehen" und „es gibt es nicht" sehen absichtlich gleich aus.
Vorlagen
Eine Vorlage ist die Form eines Boards: seine Spalten, seine Lanes, seine Felder und welche Felder die Karten zeigen. Sie enthält keine Karten und keine Automationen.
Auswählen. Der Dialog für ein neues Board bietet ein leeres Board und die Vorlagen an, unsere zuerst. Das Board entsteht in einem Schritt mit den Spalten, Lanes und Feldern der Vorlage und merkt sich, aus welcher Vorlage und Version es kommt.
Zwei Arten. Die Vorlagen, die mit dem Produkt kommen, sind in jedem Workspace gleich und lassen sich nicht ändern. Mit „Duplizieren“ entsteht eine Kopie, die du bearbeiten kannst. Die eigenen Vorlagen eines Workspace legen seine Admins und der Eigentümer mit „Als Vorlage speichern“ an einem Board an: Das übernimmt die aktuelle Form des Boards. Sie können sie umbenennen, mit der Form eines Boards ersetzen und löschen. Alle anderen im Workspace können sie auswählen. Ein Feldtyp, den eine Vorlage nicht tragen kann (Formeln, Relationen), und die Spalte Status bleiben beim Speichern weg, und der Dialog nennt, welche. In den Einstellungen listet der Abschnitt „Board-Vorlagen“ alle auf; dort duplizieren Admins und der Eigentümer eine Vorlage (die Kopie heißt „ (Kopie)“), benennen sie um, ändern die Beschreibung, aktualisieren sie aus einem Board (ihre Version steigt) und löschen sie. Boards, die aus einer gelöschten Vorlage entstanden sind, behalten, was sie haben.
Auf ein bestehendes Board anwenden. „Vorlage anwenden“ zeigt zuerst, was hinzukäme: die Spalten, Lanes, Felder, Optionen und angezeigten Felder, die dem Board fehlen. Mit der Bestätigung wird genau das hinzugefügt. Nichts wird umbenannt, verschoben oder gelöscht, und kein Feld, das die Karten heute zeigen, wird ausgeblendet. Eine Spalte, die das Board in anderer Schreibweise hat („in-arbeit“ für „In Arbeit“), gilt als vorhanden. Zweimal anwenden fügt beim zweiten Mal nichts hinzu. Hat sich das Board geändert, nachdem du die Vorschau geöffnet hast, wird nichts angewendet und du siehst die Vorschau neu.
Felder. Ein Feld, dessen Schlüssel im Workspace mit demselben Typ existiert, wird verwendet und nicht neu angelegt. Ein Schlüssel, der mit einem anderen Typ existiert, bleibt unberührt: Die Vorschau nennt ihn, alles andere wird trotzdem hinzugefügt, und neben dem vorhandenen Feld entsteht kein zweites. Felder werden dem Board selbst angeboten, andere Boards bleiben wie sie sind. Ein Feld anzulegen, das es noch nicht gibt, ist Admin-Arbeit: Wendet ein Mitglied eine Vorlage an, werden Spalten und Lanes hinzugefügt, und die Vorschau nennt die Felder, die ein Admin noch anlegen muss.
Neue Versionen. Eine spätere Änderung an einer Workspace-Vorlage wird den Boards, die daraus entstanden sind, nicht angeboten. Eine neuere Version einer mitgelieferten Vorlage schon: Ein Board, das daraus entstanden ist, zeigt, dass die Vorlage etwas Neues hat, mit derselben Vorschau, und ohne deine Bestätigung ändert sich nichts.
Rechte
- Auflisten und Lesen eines Boards braucht
readauf seiner Collection. - Anlegen braucht
editauf der Collection. - Ändern eines Boards (Titel, Symbol, Spalten, Lanes) braucht
editauf dem Board. - Löschen braucht
full. Es geht in den Papierkorb und nimmt die Datenbank dahinter mit aus der Reichweite.
Eine Karte zu verschieben regelt das Board, nicht die Seite der Karte. Wer
edit auf dem Board hat, darf eine Karte ziehen, deren Seite er nicht lesen
darf: Er ändert, wo eine Karte liegt, nicht, was sie sagt. Diese Karte zu
öffnen braucht weiterhin read auf der Seite, und darin zu schreiben edit.
Diese Trennung ist es, die ein Board in einem Team benutzbar macht, in dem nicht alles für alle lesbar ist.
Rückgängig
Eine Karte verschieben, sie vom Board entfernen, eine Karte oder ein Board in den Papierkorb legen und eine Spalte oder Lane löschen lässt sich zurücknehmen. Nach jeder dieser Aktionen bietet eine Meldung unten am Bildschirm Rückgängig an. ⌘Z (Strg+Z unter Windows und Linux) nimmt die letzte dieser Aktionen zurück, ⌘⇧Z (Strg+Umschalt+Z) stellt sie wieder her. Wer gerade in einem Textfeld oder in einer Karte schreibt, nimmt mit ⌘Z den Text zurück.
- Rückgängig merkt sich die letzten 50 eigenen Aktionen in diesem Browser-Tab. Neu laden oder ein anderer Workspace beginnt leer.
- Die Rückfrage vor dem Löschen kommt weiterhin; Rückgängig ist der Weg zurück danach.
- Eine gelöschte Spalte kommt mit Name, Symbol und Platz zurück, und mit den Karten, die in ihr geladen waren. Eine gelöschte Lane kommt ebenso zurück, ihre geladenen Karten stehen wieder in ihr, in ihren Spalten.
- Hat jemand anderes die Karte, Spalte, Lane oder das Board inzwischen geändert, wird nichts zurückgesetzt, und die Meldung sagt das.
- Feldwerte und Text gehören nicht zu diesem Rückgängig.
Ein Board filtern
Filter neben dem Knopf Ansicht zeigt nur die Karten, die passen. Wählen Sie ein Feld, einen Vergleich und einen Wert. Fügen Sie weitere Bedingungen hinzu und wählen Sie, ob eine Karte alle erfüllen muss oder eine davon. Jedes Feld des Workspace lässt sich nutzen, jeder Feldtyp.
Welche Vergleiche es gibt, hängt vom Feldtyp ab. Text und URL bieten ist, ist nicht, enthält, ist leer und ist nicht leer; ein Kontrollkästchen bietet ist angehakt und ist nicht angehakt; eine Zahl bietet zusätzlich größer als, mindestens, kleiner als und höchstens; ein Datum bietet zusätzlich nach, ab, vor und bis, gezählt in ganzen Tagen; alle anderen Typen bieten ist, ist nicht, ist leer und ist nicht leer. Ist nicht angehakt umfasst auch die Karten, deren Kästchen nie berührt wurde. Eine Zahl tippen Sie in ein Feld, das nur Ziffern annimmt.
Die passenden Karten bleiben in ihren Spalten und Lanes, und jede Spalte zählt nur die passenden Karten. Karten ziehen geht wie immer. Eine Karte, deren Wert Sie so ändern, dass sie nicht mehr passt, verschwindet aus dem gefilterten Board.
Der Filter steht in der Adresse des Boards und wird nicht gespeichert. Kopieren Sie die Adresse, um jemandem das gefilterte Board zu schicken; laden Sie das Board ohne sie, sind alle Karten wieder da. Andere sehen Ihren Filter nur, wenn Sie ihnen den Link schicken. Filter aufheben beendet ihn.
Automationen
Ein Board kann selbst Karten anlegen, nach Zeitplan. Öffnen Sie das Menü ⋯
des Boards und wählen Sie Automationen…; wer das Board ändern darf, darf
auch seine Regeln verwalten.
Eine Regel sagt, wann (täglich, an gewählten Wochentagen oder an einem Tag
im Monat, zu einer Uhrzeit in einer Zeitzone) und was: einen Kartentitel,
auf Wunsch einen Text, und die Spalte und Lane, in die die Karte kommt. Titel
und Text dürfen Platzhalter enthalten, die bei jedem Lauf ausgefüllt werden:
{datum}, {woche} (Kalenderwoche), {monat} und {jahr}, oder englisch
{date}, {week}, {month} und {year}. Das Formular zeigt vor dem
Speichern die nächsten fünf Läufe.
- Jetzt auslösen legt sofort eine Karte an, unabhängig vom Zeitplan.
- Nur wenn die vorige Karte erledigt ist überspringt einen Lauf, solange die zuletzt angelegte Karte noch auf dem Board und nicht in der letzten Spalte liegt.
- Pausieren hält eine Regel an; Fortsetzen plant sie ab jetzt neu.
- Verlauf zeigt, was jeder Lauf getan hat: Karte angelegt, übersprungen, pausiert oder fehlgeschlagen.
Eine Regel handelt im Namen der Person, die sie angelegt hat. Jeder geplante Lauf legt höchstens eine Karte an; war der Dienst zu dem Zeitpunkt nicht erreichbar, wird der verpasste Lauf einmal nachgeholt. Wird die Spalte oder Lane der Regel gelöscht, pausiert sich die Regel und nennt den Grund; fortsetzen lässt sie sich, sobald sie auf eine vorhandene Spalte zeigt. Ein Board hat höchstens 20 Regeln. Auch ein Assistent kann Regeln über den MCP-Server verwalten.
Ein Board ist keine Datenbankansicht
Falls Sie typisierte Datenbanken mit gespeicherten Ansichten kennen: Ein Board ist keine davon mit angeschraubtem Kanban-Layout. Es ist eine eigene Art Dokument, Geschwister einer Seite, mit eigenem Textkörper und eigener Konfiguration. Hinter seinen Karten sitzt zwar eine Datenbank, die das Board sich selbst anlegt und verwaltet, aber das Raster gehört dem Board, nicht einer Ansicht.
Was ein Board nicht kann
- Keine WIP-Limits. Nichts zählt die Karten einer Spalte gegen eine Obergrenze.
- Keine Sortierung. Ein Board steht immer in Board-Reihenfolge, der Reihenfolge, in der Karten platziert wurden. Es gibt kein „nach Priorität sortieren". Filter gibt es, siehe oben.
- Keine Kartenvorlagen außerhalb einer Automation, keine Kartenbilder, kein öffentlicher Freigabelink.
- Kein Import aus einem anderen Werkzeug.
Jeder dieser Punkte ist eine protokollierte Entscheidung und kein Versehen, und keiner davon steht kurz bevor.