將組織資料(電子郵件、檔案、聊天和行事曆事件)直接整合到您的自定義應用程式中,以提高用戶生產力。 藉由使用 Microsoft Graph API 和 Microsoft Entra ID,您可以順暢地擷取及顯示應用程式內的相關數據,減少使用者切換內容的需求。 無論是參考傳送給客戶的電子郵件、檢閱 Teams 訊息或存取檔案,使用者都可以快速找到所需的資訊,而不需要離開您的應用程式、簡化其決策程式。
在本練習中,您將會:
- 建立Microsoft Entra ID 應用程式註冊,讓 Microsoft Graph 可以存取組織數據,並將其帶入應用程式。
- 從 Microsoft Teams 中找出
team
和channel
標識碼,這些 Teams 需要將聊天訊息傳送至特定頻道。 - 使用您Microsoft Entra ID 應用程式註冊的值更新專案的 .env 檔案。
建立Microsoft項目標識碼應用程式註冊
移至 Azure 入口網站 ,然後選取 [Microsoft Entra ID]。
選取 [管理 ] -->[應用程式註冊 ],然後選取 [+ 新增註冊]。
填寫新的應用程式註冊窗體詳細數據,如下所示,然後選取 [註冊]:
- 名稱: microsoft-graph-app
- 支援的帳戶類型: 任何組織目錄中的帳戶(任何Microsoft專案標識符租使用者 - 多租使用者)
- 重新導向 URI:
- 選取[單頁應用程式][SPA],然後在 [
http://localhost:4200
字段中輸入 。
- 選取[單頁應用程式][SPA],然後在 [
- 選取 [註冊] 以建立應用程式註冊。
在資源功能表中選取 [ 概觀 ],
Application (client) ID
並將值複製到剪貼簿。
更新專案的 .env 檔案
在編輯器開啟 .env 檔案,並將值指派
Application (client) ID
給ENTRAID_CLIENT_ID
。ENTRAID_CLIENT_ID=<APPLICATION_CLIENT_ID_VALUE>
如果您想要啟用將訊息從應用程式傳送至 Teams 頻道的能力,請使用您的 Microsoft 365 開發租使用者帳戶登入 Microsoft Teams (本教學課程的前置條件中提及)。
登入之後,請展開小組,並尋找您想要從應用程式傳送訊息的頻道。 例如,您可以選取 [公司 團隊] 和 [ 一般 ] 頻道(或您想要使用的任何小組/頻道)。
在小組標頭中,按兩下三個點(...),然後選取 [取得小組的連結]。
在彈出視窗中顯示的連結中,小組標識碼是 之後
team/
的字母和數位字串。 例如,在連結 “https://teams.microsoft.com/l/team/19%3ae9b9.../", 團隊標識符是 19%3ae9b9... 最多到下列/
字元。複製小組標識碼,並將它指派給
TEAM_ID
.env 檔案。在通道標頭中,按兩下三個點(...),然後選取 [ 取得通道的連結]。
在彈出視窗中顯示的連結中,通道標識碼是 後面
channel/
字母和數位的字串。 例如,在連結 “https://teams.microsoft.com/l/channel/19%3aQK02.../", 信道標識符為 19%3aQK02... 最多到下列/
字元。複製通道標識碼,並將它指派給
CHANNEL_ID
.env 檔案中。繼續之前,請先儲存 env 檔案。
啟動/重新啟動應用程式和 API 伺服器
根據您完成的練習,執行下列 其中一 個步驟:
如果您在先前的練習中啟動資料庫、API 伺服器和網頁伺服器,您必須停止 API 伺服器和 Web 伺服器,然後重新啟動它們以挑選 .env 檔案變更。 您可以讓資料庫保持執行狀態。
找出執行 API 伺服器和網頁伺服器的終端機視窗,然後按 CTRL + C 以停止它們。 在每一個終端機視窗中輸入
npm start
,然後按 Enter 鍵,再次啟動它們。 繼續進行下一個練習。如果您尚未啟動資料庫、API 伺服器和網頁伺服器,請完成下列步驟:
在下列步驟中,您將在 Visual Studio Code 中建立三個終端機視窗。
以滑鼠右鍵按兩下 Visual Studio Code 檔案清單中的 .env 檔案,然後選取 [ 在整合式終端機中開啟]。 在繼續之前,請確定您的終端機位於專案的根目錄 - openai-acs-msgraph 。
從下列 其中一個選項 中選擇,以啟動 PostgreSQL 資料庫:
如果您已安裝並執行 Docker Desktop ,請在終端機視窗中執行
docker-compose up
,然後按 Enter。如果您已安裝 Podman-compose 並執行 Podman, 請在終端機視窗中執行
podman-compose up
,然後按 Enter。若要使用 Docker Desktop、Podman、nerdctl 或您已安裝的另一個容器運行時間直接執行 PostgreSQL 容器,請在終端機視窗中執行下列命令:
Mac、Linux 或 Windows 子系統 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
使用 PowerShell 的 Windows:
[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
資料庫容器啟動時,請按 + Visual Studio Code 終端機工具列 中的圖示來建立第二個終端機視窗。
cd
進入 伺服器/typescript 資料夾,然後執行下列命令來安裝相依性並啟動 API 伺服器。npm install
npm start
在 Visual Studio Code +中再次按圖示,以建立第三個終端機視窗。
cd
進入 客戶端 資料夾,然後執行下列命令來安裝相依性並啟動網頁伺服器。npm install
npm start
瀏覽器將會啟動,而且系統會帶您前往 http://localhost:4200。