Microsoft Planner
Aplikace Helpdesk v rámci integrace s aplikacemi třetích stran nabízí možnost propojení se službou Microsoft Planner. Jedná se o službu dostupnou v rámci většiny plánů Microsoft 365 (bývalý Office 365).
Důležité: Integrace využívá registraci aplikace v rámci Microsoft Entra, je proto nutné mít zřízený tenant v Microsoft Azure a oprávnění tuto registraci provést. Tato možnost je technicky k dispozici u většiny plánů Microsoft 365 pro firmy.
Registrace v portálu Microsoft Entra
Microsoft Entra admin center: https://entra.microsoft.com
V levém menu rozbalíme složku Applications a zvolíme App registrations. Na nové stránce zvolíme novou registraci (tlačítko New registration).
Ve formuláři vyplníme jméno registrace (můžeme zvolit jakékoli, které bude dávat smysl pro budoucí správu) a v sekci Redirect URI (optional) vybereme z roletového menu Web a vyplníme adresu ve tvaru:
https://<primarni adresa Helpdesku>/AuthPlannerCallback/Index
Příklad: https://playground.servicedesk.net/AuthPlannerCallback/Index
Následně ve spodní části klikneme na tlačítko Register pro vytvoření registrace.
Dojde k vytvoření registrace a přesměrování na stránku s přehledem, kde v levém menu vybereme Certificates & secrets a klikneme na New client secret.
V nově otevřené vertikální záložce vyplníme popis (na jeho podobě nezáleží) a zvolíme platnost (doporučujeme co nejdelší). Pak ve spodní částí záložky potvrdíme tlačítkem Add.
Hodnotu klíče (Value) si zkopírujeme a někam poznačíme, budeme ji potřebovat při konfiguraci v aplikaci Helpdesk
v následných krocích.
Nyní přejdeme v levém menu do sekce API permissions a klikneme na Add a permission.
V nově otevřené vertikální záložce klikneme na Microsoft Graph.
V dalším kroku vybereme Delegated permissions.
V seznamu možných oprávnění API vybereme:
Directory.Read.AllGroup.ReadWrite.Alloffline_access
Po přidání se nám zobrazí všechna oprávnění (viz níže), kde klikneme na Grant admin consent for <název firmy>.
Tím máme registraci dokončenou a přejdeme do sekce Overview, kde zi zkopírujeme Application (client) ID a Directory (tenant) ID.
V tento okamžik máme vše potřebné a můžeme přejít do aplikace Helpdesk, kde provedeme zbytek konfigurace.
Konfigurace MS Planner v aplikaci Helpdesk
V aplikaci Helpdesk přejdeme do Administrace, zvolíme kategorii Integrace a klikneme na Planner.
Na řádku Propojení s Planner klikneme na tlačítko Nastavení.
Na nově otevřené stránce s nastavením vložíme Tenant ID, Client ID a Client secret, které jsme si nachystali v předchozích krocích, a konfiguraci uložíme.
Tím je konfigurace na straně aplikace Helpdesk dokončena. V tento okamžik je možné integraci začít využívat.
V následující sekci si popíšeme první kroky v rámci MS Planner, které je potřeba mít provedeny, aby se integrace chovala dle očekávání.
První kroky s integrací MS Planner
V době tvorby tohoto návodu (Q2/2025) existuje nové webové rozhraní, které umožňuje správu úkolů a plánů.
Adresa: https://planner.cloud.microsoft
Důležité: Ujistěte se, že jste do portálu Microsoft Planner přihlášení pod účtem organizace, v rámci které jste prováděli registraci v Microsoft Entra.
Microsoft Planner v principu umožňuje tvorbu vlastních úkolů bez nějaké další nadřazené hierarchie (pouze samotné úkoly), nicméně pro funkčnost integrace v aplikaci Helpdesk
je vyžadováno mít vytvořený alespoň jeden plán, do kterého budou vytvářeny nové úkoly z požadavků, resp. vazby z požadavků na již existující úkoly v MS Planner.
Existenci plánu ověříme tak, že ve webovém rozhraní přejdeme do záložky My Plans.
Tímto způsobem vytvořený plán (z praktického hlediska je vhodné, aby byl sdílený v rámci organizace a mělo k němu přístup například více kolegů) je následně dostupný v aplikaci Helpdesk pro tvorbu nových úkolů a vazeb.
Po otevření libovolného požadavku se v pravé části nachází dlaždice Plánovač (podmínkou zobrazení dlaždice je existující konfigurace MS Planner, která je popsána v předchozích krocích tohoto návodu).
Každý uživatel tenantu Microsoft 365 se do plánovače v aplikaci Helpdesk přihlašuje pod svým vlastním organizačním účtem Microsoft. Tím je zajištěno, že každý pracuje pouze se svými vlastními úkoly, které mohou (nebo nemusí) být sdíleny s dalšími uživateli tenantu.
Po přihlášení pak dlaždice obsahuje možnosti Nový úkol a Navázat, kde rozdíl je právě v tom, zda požadavek chceme navázat na úkol, který se v MS Planner již nachází (a tvoříme jen vazbu), nebo zda chceme z daného požadavku vytvořit úkol zcela nový.
U nového úkolu je vždy nutné zvolit skupinu, pod kterou je daný plán nasdílen (viz předchozí popis), následně zvolit odpovídající plán, kontejner (např. backlog nebo in progress), název úkolu (předvyplněn předmět požadavku) a alternativně můžeme zvolit řešitele a termín (vše v rámci MS Planner).
Poslední volbou je Viditelnost, kde naopak určujeme, zda danou vazbu uvidí pouze aktuální uživatel aplikace Helpdesk, nebo zda ji budou mít možnost vidět i ostatní řešitelé (koncoví uživatelé tyto informace nemají k dispozici).
Po kliknutí na tlačítko vytvořit dojde k zobrazení vazby v aplikaci Helpdesk:
No a po prokliknutí přes odkaz (nebo zobrazení plánu v MS Planner) můžeme najít také nově vytvořený úkol.
Mírně se liší tvorba vazby na požadavek, kde postačí zvolit skupinu a plán (volitelně i kontejner) a kliknout na tlačítko Hledat:
Po kliknutí na Hledat se zobrazí seznam dostupných úkolů, kde stačí vybrat odpovídající úkol a kliknout na Navázat.
Vytvořená vazba je pak v aplikaci Helpdesk viditelná dle toho, zda jsme nastavili pouze sebe, případně i ostatní řešitele. U každé vazby se pak nachází ikony pro odstranění vazby (ponechání úkolu v MS Planner) a pro smazání úkolu (odstraní nejen vazbu, ale smaže i úkol v MS Planner).