Microsoft Planner

Overzicht

Microsofts taakbeheer- en samenwerkingsplatform voor teams. Via Langdock’s integratie kunt u Microsoft Planner direct vanuit uw gesprekken openen en beheren.

Authenticatie: OAuth Categorie: Microsoft 365 Beschikbaarheid: Alle workspace-abonnementen

Beschikbare acties

Plannen weergeven

microsoftplanner.listPlans

Haal alle Planner-plannen op waar de gebruiker toegang toe heeft

Bevestiging vereist: Nee

Parameters:

  • groupId (TEKST, Optioneel): ID van de Microsoft 365-groep om plannen van op te halen. Laat leeg om plannen uit alle toegankelijke groepen te krijgen

  • includeDetails (BOOLEAN, Optioneel): Voeg aanvullende plangegevens toe, zoals categorieën en gedeelde informatie

Uitvoer: Geeft een lijst met plannen en hun details terug

Plan maken

microsoftplanner.createPlan

Maak een nieuw Planner-plan in een Microsoft 365-groep

Bevestiging vereist: Nee

Parameters:

  • groupId (TEKST, Vereist): ID van de Microsoft 365-groep waar het plan zal worden gemaakt. De gebruiker moet lid zijn van deze groep

  • titel (TEKST, Vereist): Titel van het nieuwe plan

Uitvoer: Geeft de details van het aangemaakte plan terug

Plan ophalen

microsoftplanner.getPlan

Haal de details op van een specifiek Planner-plan

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan dat opgehaald moet worden

  • includeDetails (BOOLEAN, Optioneel): Voeg aanvullende plangegevens toe, zoals categorieën en gedeelde informatie

Uitvoer: Geeft de plandetails terug

Taken weergeven

microsoftplanner.listTasks

Haal taken op uit een Planner-plan

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan waarvan taken moeten worden opgehaald

  • includeDetails (BOOLEAN, Optioneel): Voeg aanvullende taakdetails toe, zoals beschrijving, checklist en verwijzingen

Uitvoer: Geeft een lijst met taken uit het plan terug

Taak aanmaken

microsoftplanner.createTask

Maak een nieuwe taak in een Planner-plan

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan waar de taak zal worden aangemaakt

  • planTitle (TEKST, Optioneel): Als geen Plan-ID is opgegeven, zoek dan het plan op exacte titel binnen uw toegankelijke groepen. Als er meerdere overeenkomsten zijn, retourneer een fout met kandidaten

  • titel (TEKST, Vereist): Titel van de nieuwe taak

  • bucketId (TEKST, Optioneel): ID van de bucket waarin de taak wordt geplaatst. Laat leeg om in de standaardbucket te plaatsen

  • bucketName (TEKST, Optioneel): Als geen Bucket-ID is opgegeven, zoek de bucket op exacte naam. Als deze niet wordt gevonden, wordt de taak aangemaakt in de standaardbucket van het plan

  • assignedToUserId (TEKST, Optioneel): Gebruikers-ID waaraan de taak toegewezen wordt. Laat leeg om een niet-toegewezen taak te maken

  • assignedToEmail (TEKST, Optioneel): E-mailadres (UPN) van de gebruiker aan wie de taak toegewezen wordt. Laat leeg om een niet-toegewezen taak te maken

  • assignToMe (BOOLEAN, Optioneel): Als waar en er geen andere toegewezen persoon is opgegeven, wijs de taak toe aan de huidige gebruiker

  • dueDateTime (TEKST, Optioneel): ISO 8601 met tijdzone vereist (UTC 'Z' of offset), bijv. 2025-08-13T17:00:00Z of 2025-08-13T17:00:00+02:00

  • prioriteit (SELECT, Optioneel): Prioriteitsniveau van de taak (Dringend, Belangrijk, Midden, Laag)

Uitvoer: Geeft de details van de aangemaakte taak terug

Taak bijwerken

microsoftplanner.updateTask

Werk een bestaande taak bij in een Planner-plan

Bevestiging vereist: Nee

Parameters:

  • taskId (TEKST, Vereist): ID van de taak die bijgewerkt moet worden

  • titel (TEKST, Optioneel): Nieuwe titel voor de taak. Laat leeg om de huidige titel te behouden

  • percentComplete (NUMMER, Optioneel): Voltooiingspercentage (0-100). Stel in op 100 om als voltooid te markeren

  • dueDateTime (TEKST, Optioneel): ISO 8601 met tijdzone vereist (UTC 'Z' of offset), bijv. 2025-08-13T17:00:00Z of 2025-08-13T17:00:00+02:00. Laat leeg om de huidige vervaldatum te behouden

  • prioriteit (SELECT, Optioneel): Nieuw prioriteitsniveau van de taak. Laat leeg om de huidige prioriteit te behouden

  • assignToMe (BOOLEAN, Optioneel): Als waar en er geen andere toegewezen persoon is opgegeven, wijs de taak toe aan de huidige gebruiker

  • assignedToEmail (TEKST, Optioneel): E-mailadres (UPN) van de gebruiker om de taak aan toe te wijzen. Laat leeg om de huidige toewijzingen te behouden

  • assignedToUserId (TEKST, Optioneel): Gebruikers-ID om de taak aan toe te wijzen. Laat leeg om de huidige toewijzingen te behouden

Uitvoer: Geeft de bijgewerkte taakdetails terug

Buckets weergeven

microsoftplanner.listBuckets

Haal alle buckets op uit een Planner-plan

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan waarvan buckets moeten worden opgehaald

Uitvoer: Geeft een lijst met buckets uit het plan terug

Bucket maken

microsoftplanner.createBucket

Maak een nieuwe bucket in een Planner-plan om taken te organiseren

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan waar de bucket zal worden aangemaakt

  • name (TEKST, Vereist): Naam van de nieuwe bucket

Uitvoer: Geeft de details van de aangemaakte bucket terug

Taakreacties ophalen

microsoftplanner.getTaskComments

Haal alle reacties op uit de gespreksthread van een Planner-taak

Bevestiging vereist: Nee

Parameters:

  • taskId (TEKST, Vereist): ID van de taak waarvan reacties moeten worden opgehaald

  • includeEmpty (BOOLEAN, Optioneel): Neem reacties op die geen tekstinhoud hebben (systeemberichten, enz.)

Uitvoer: Geeft taakreacties terug

Triggers

Nieuwe taak

microsoftplanner.newTask

Wordt geactiveerd wanneer een nieuwe taak wordt aangemaakt in een opgegeven plan

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan dat op nieuwe taken moet worden bewaakt

  • assignedToUserId (TEKST, Optioneel): Activeer alleen voor taken die aan dit gebruikers-ID zijn toegewezen. Laat leeg om alle taken te bewaken

  • filterByAssigneeEmail (TEKST, Optioneel): Activeer alleen voor taken die aan dit e-mailadres (UPN) zijn toegewezen. Laat leeg om alle taken te bewaken

Uitvoer: Geeft het resultaat van de bewerking terug

Taak voltooid

microsoftplanner.taskCompleted

Wordt geactiveerd wanneer een taak als voltooid is gemarkeerd (100% vooruitgang) in een opgegeven plan

Bevestiging vereist: Nee

Parameters:

  • planId (TEKST, Vereist): ID van het plan dat op voltooide taken moet worden bewaakt

Uitvoer: Geeft het resultaat van de bewerking terug

Veelvoorkomende gebruikssituaties

  • Gegevensbeheer Beheer en organiseer uw Microsoft Planner-gegevens

  • Automatisering Automatiseer workflows met Microsoft Planner

  • Rapportage Genereer inzichten en rapporten

  • Integratie Verbind Microsoft Planner met andere tools

Beste praktijken

1

Aan de slag

  • Schakel de Microsoft Planner-integratie in uw werkruimte-instellingen in

  • Authenticeer met OAuth

  • Test de verbinding met een eenvoudige leesbewerking

  • Verken beschikbare acties voor uw gebruikssituatie

2

Belangrijke overwegingen

  • Zorg voor de juiste authenticatiegegevens

  • Respecteer rate limits en API-quotums

  • Controleer instellingen voor gegevensprivacy

  • Test bewerkingen eerst in een veilige omgeving

Probleemoplossing

Probleem
Oplossing

Authenticatie mislukt

Controleer uw OAuth-gegevens

Rate limit overschreden

Verminder de frequentie van verzoeken

Gegevens niet gevonden

Controleer machtigingen en beschikbaarheid van gegevens

Verbindingstime-out

Controleer netwerkconnectiviteit

Ondersteuning

Voor extra hulp met de Microsoft Planner-integratie, neem contact op met [email protected]

VorigeSharePointVolgendePylon