Microsoft Planner
Aufgaben in Microsoft Planner aus Workflows und im Chat finden, zusammenfassen, anlegen und bearbeiten
Finden, zusammenfassen, anlegen und bearbeiten Sie Aufgaben in Microsoft Planner, auch in den Plänen Ihrer Microsoft-365-Gruppen und Teams. Die Integration steht in Workflows und im Agent-Modus des Chats zur Verfügung, zum Beispiel mit „Welche Planner-Aufgaben sind diese Woche fällig?“
Authentifizierung: OAuth 2.0. Verbinden Sie Ihr Microsoft-Konto auf der Integrations-Seite. Sie sehen genau die Pläne, die Ihr Microsoft-Konto auch in Planner und Teams sieht.
Berechtigungen
| Berechtigung | Wofür |
|---|---|
Tasks.ReadWrite | Pläne und Aufgaben lesen, Aufgaben anlegen und bearbeiten. Ohne „Aufgaben ändern“ beim Verbinden: nur lesen |
User.Read | Optional: welches Konto verbunden ist und wer „ich“ ist |
User.ReadBasic.All | Optional: Namen der Zuständigen anzeigen und Personen per E-Mail-Adresse zuweisen |
Lässt Ihre Organisation die optionalen Berechtigungen nicht zu, verbindet sich Planner trotzdem. Zuständige erscheinen dann als Benutzer-ID, und Aufgaben lassen sich nur per Benutzer-ID oder „me“ zuweisen.
Premium-Pläne sind über die Microsoft-Schnittstelle nicht erreichbar, nur Basis-Pläne.
Aktionen
Pläne auflisten
Gibt alle Pläne zurück, die das verbundene Konto sehen kann, einschließlich der Pläne seiner Gruppen und Teams.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Group ID | Nein | Nur die Pläne dieser Microsoft-365-Gruppe (dieses Teams) |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
plans | array | Pläne mit id, title, groupId |
Buckets auflisten
Gibt die Buckets (Spalten) eines Plans in der Reihenfolge des Boards zurück.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Plan | Ja | Der Plan |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
buckets | array | Buckets mit id und name |
Aufgaben auflisten
Gibt die Aufgaben eines Plans zurück, oder ohne Plan alle Aufgaben, die Ihnen in irgendeinem Plan zugewiesen sind.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Plan | Nein | Leer: alle mir zugewiesenen Aufgaben |
| Only tasks assigned to me | Nein | Mit Plan: nur meine Aufgaben |
| Status | Nein | open (Standard), all, notStarted, inProgress oder completed |
| Bucket | Nein | Nur Aufgaben in diesem Bucket |
| Due on or before / after | Nein | Fälligkeit als JJJJ-MM-TT |
| Limit | Nein | Höchstens so viele Aufgaben (Standard 50, maximal 200) |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
tasks | array | Aufgaben mit title, status, priority, dueDate, planTitle, bucketName, assignees (id, name) |
Aufgabe abrufen
Gibt eine Aufgabe mit Beschreibung, Checkliste, Links, Bucket und Zuständigen zurück.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Task | Ja | Die Aufgabe |
Aufgabe erstellen
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Plan | Ja | Der Plan |
| Title | Ja | Titel |
| Bucket | Nein | Bucket des Plans |
| Description | Nein | Beschreibung (Notizen) |
| Assignees | Nein | Benutzer-IDs, E-Mail-Adressen oder me, durch Komma getrennt |
| Due Date | Nein | Fälligkeit als JJJJ-MM-TT |
| Start Date | Nein | Beginn als JJJJ-MM-TT |
| Priority | Nein | urgent, important, medium oder low |
| Status | Nein | notStarted, inProgress oder completed |
Aufgabe bearbeiten
Ändert nur die Felder, die Sie setzen. Leere Felder bleiben unverändert, none löscht eine Beschreibung oder ein Datum.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Task | Ja | Die Aufgabe |
| Title, Description | Nein | Neuer Titel, neue Beschreibung |
| Assignees (replace) | Nein | Ersetzt alle Zuständigen |
| Add / Remove | Nein | Fügt Zuständige hinzu oder entfernt sie |
| Bucket | Nein | Verschiebt die Aufgabe in einen Bucket desselben Plans |
| Due / Start Date | Nein | Neue Termine |
| Priority, Status | Nein | Wie bei „Aufgabe erstellen“ |
| Percent complete | Nein | Fortschritt 0–100 |
Bearbeitet jemand dieselbe Aufgabe gleichzeitig, liest die Aktion sie neu und versucht es einmal erneut.
Aufgabe in Bucket verschieben
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Task | Ja | Die Aufgabe |
| Bucket | Ja | Ziel-Bucket im selben Plan |