Data organizace: Vytvoření registrace aplikace Microsoft Entra ID

Zvyšte produktivitu uživatelů integrací dat organizace (e-mailů, souborů, chatů a událostí kalendáře) přímo do vlastních aplikací. Pomocí rozhraní Microsoft Graph API a Microsoft Entra ID můžete bezproblémově načítat a zobrazovat relevantní data v rámci vašich aplikací, což snižuje potřebu uživatelů přepínat kontext. Bez ohledu na to, jestli odkazujete na e-mail odeslaný zákazníkovi, kontrolujete zprávu Teams nebo přistupujete k souboru, můžou uživatelé rychle najít informace, které potřebují, aniž by opustili vaši aplikaci, a zjednodušili tak rozhodovací proces.

V tomto cvičení budete:

• Vytvořte registraci aplikace Microsoft Entra ID, aby Microsoft Graph mohl přistupovat k datům organizace a přenést je do aplikace.
• Vyhledejte team a channel ID z Microsoft Teams, které jsou potřeba k odesílání chatovacích zpráv do určitého kanálu.
• Aktualizujte soubor .env projektu hodnotami z registrace aplikace Microsoft Entra ID.

Vytvoření registrace aplikace Microsoft Entra ID

1. Přejděte na Azure Portal a vyberte Microsoft Entra ID.

2. Vyberte Spravovat -->Registrace aplikací následované + Nová registrace.

3. Vyplňte podrobnosti nového registračního formuláře aplikace, jak je znázorněno níže, a vyberte Zaregistrovat:

   • Název: microsoft-graph-app
   • Podporované typy účtů: Účty v libovolném adresáři organizace (libovolný tenant Microsoft Entra ID – Víceklient)
   • Identifikátor URI přesměrování:
     • Vyberte jednostránkové aplikace (SPA) a zadejte http://localhost:4200 do pole Identifikátor URI přesměrování .
   • Výběrem Registrovat vytvořte registraci aplikace.

   

1. V nabídce prostředků vyberte Přehled a zkopírujte Application (client) ID hodnotu do schránky.

   

Aktualizace souboru .env projektu

1. Otevřete soubor .env v editoru a přiřaďte Application (client) ID hodnotu .ENTRAID_CLIENT_ID

   ENTRAID_CLIENT_ID=<APPLICATION_CLIENT_ID_VALUE>
   

2. Pokud chcete povolit možnost odeslat zprávu z aplikace do kanálu Teams, přihlaste se k Microsoft Teams pomocí svého účtu tenanta Microsoft 365 pro vývoj (toto je uvedeno v předběžných dotazech pro tento kurz).

3. Po přihlášení rozbalte tým a najděte kanál, do kterého chcete odesílat zprávy z aplikace. Můžete například vybrat tým společnosti a obecný kanál (nebo jiný tým nebo kanál, který chcete použít).

   

4. V záhlaví týmu klikněte na tři tečky (...) a vyberte Získat odkaz na tým.

5. V odkazu, který se zobrazí v místním okně, id týmu je řetězec písmen a číslic za team/. Například v odkazu "https://teams.microsoft.com/l/team/19%3ae9b9.../", ID týmu je 19%3ae9b9... až do následujícího / znaku.

6. Zkopírujte ID týmu a přiřaďte ho do TEAM_ID souboru .env .

7. V záhlaví kanálu klikněte na tři tečky (...) a vyberte Získat odkaz na kanál.

8. V odkazu, který se zobrazí v místním okně, je ID kanálu řetězec písmen a číslic za channel/. Například v odkazu "https://teams.microsoft.com/l/channel/19%3aQK02.../", ID kanálu je 19%3aQK02... až do následujícího / znaku.

9. Zkopírujte ID kanálu a přiřaďte ho v CHANNEL_ID souboru .env .

10. Než budete pokračovat, uložte soubor env .

Spuštění nebo restartování aplikačních serverů a serverů rozhraní API

Proveďte jeden z následujících kroků na základě cvičení, která jste do tohoto okamžiku dokončili:

• Pokud jste databázi, server rozhraní API a webový server spustili v předchozím cvičení, musíte zastavit server rozhraní API a webový server a restartovat je, aby se změny souboru .env obnovily. Databázi můžete nechat spuštěnou.

  Vyhledejte terminálová okna se serverem rozhraní API a webovým serverem a stisknutím kombinace kláves CTRL+C je zastavte. Začněte je znovu zadáním npm start do každého okna terminálu a stisknutím klávesy Enter. Pokračujte k dalšímu cvičení.

• Pokud jste databázi, server rozhraní API a webový server ještě nezahajovali, proveďte následující kroky:

  1. V následujících krocích vytvoříte tři okna terminálu v editoru Visual Studio Code.

     

  2. Klikněte pravým tlačítkem myši na soubor .env v seznamu souborů editoru Visual Studio Code a vyberte Otevřít v integrovaném terminálu. Než budete pokračovat, ujistěte se, že je váš terminál v kořenovém adresáři projektu – openai-acs-msgraph .

  3. Výběrem jedné z následujících možností spusťte databázi PostgreSQL:

     • Pokud máte nainstalovaný a spuštěný Docker Desktop , spusťte docker-compose up ho v okně terminálu a stiskněte Enter.

     • Pokud máte podman s nainstalovaným a spuštěným podman-compose , spusťte podman-compose up v okně terminálu a stiskněte Enter.

     • Pokud chcete kontejner PostgreSQL spustit přímo pomocí Docker Desktopu, Podmanu, nerdctl nebo jiného nainstalovaného modulu runtime kontejneru, spusťte v okně terminálu následující příkaz:

       • Mac, Linux nebo Subsystém Windows pro Linux (WSL):

         [docker | podman | nerdctl] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v $(pwd)/data:/var/lib/postgresql/data -p 5432:5432 postgres
         

       • Windows s PowerShellem:

         [docker | podman] run --name postgresDb -e POSTGRES_USER=web -e POSTGRES_PASSWORD=web-password -e POSTGRES_DB=CustomersDB -v ${PWD}/data:/var/lib/postgresql/data -p 5432:5432 postgres
         

  4. Jakmile se kontejner databáze spustí, stisknutím + ikony na panelu nástrojů Terminálu editoru Visual Studio Code vytvořte druhé okno terminálu.

     

  5. cd do složky server/typescript a spuštěním následujících příkazů nainstalujte závislosti a spusťte server rozhraní API.

     • npm install
     • npm start

  6. + Dalším stisknutím ikony na panelu nástrojů Terminálu editoru Visual Studio Code vytvořte třetí okno terminálu.

  7. cd do složky klienta a spuštěním následujících příkazů nainstalujte závislosti a spusťte webový server.

     • npm install
     • npm start

  8. Spustí se prohlížeč a budete přesměrováni na http://localhost:4200.

     

Další krok

Data organizace: Přihlášení uživatele a získání přístupového tokenu