如何:使用伺服器邏輯與 Microsoft Graph 和 SharePoint 互動

本指南將引導您設定和測試將 Power Pages 與 Microsoft Graph 和 SharePoint Online 整合的伺服器邏輯範例。

步驟 1:下載範例套件

  1. 移至 GitHub 存放庫 https://github.com/microsoft/power-pages-samples。
  2. 選取程式碼 >下載 ZIP。
  3. 下載後,將ZIP檔案解壓縮到本機資料夾,例如: C:\PowerPages\ServerLogic
  4. 進入解壓縮的路徑: samples/server-logic/sharepoint-integration 此資料夾包含 event-registration.zip 解決方案套件,其中包含您將在後續步驟中匯入的 Power Pages 網站資源。

或者,如果您願意,也可以使用 git clone。

git clone https://github.com/microsoft/power-pages-samples.git
cd power-pages-samples/samples/server-logic/sharepoint-integration

步驟 2:必要條件

開始之前,請確定您擁有:

步驟 3:建立和設定 Entra ID 應用程式

您需要應用程式註冊,才能讓您的伺服器邏輯程式代碼針對 Microsoft Graph 進行驗證。

建立應用程式註冊

  1. 移至 Azure 入口網站,然後選取 [ 應用程式註冊]。
  2. 選取 + 新增註冊。
  3. 提供名稱 (例如,PowerPages-Graph-Integration)。
  4. 選擇 [僅限此組織目錄中的帳戶]。

    備註

    您不需要為此範例提供重新導向 URI。

  5. 選取 註冊。

設定 API 權限

  1. 在新應用程式中,移至 API 權限>新增權限。
  2. 選取 [ Microsoft Graph>應用程式] 許可權。
  3. 新增下列權限:
    • Sites.ReadWrite.All (適用於 SharePoint 檔案作業)
    • Mail.Send (選擇性 - 僅當您計劃啟用電子郵件部分時才需要)
  4. 選取將管理員同意授與您的租用戶。

建立客戶端密碼

  1. 移至 憑證與密碼> 用戶端密碼。
  2. 選取 + 新增用戶端密碼。
  3. 輸入描述並選擇到期期限 (例如,六個月)。
  4. 選取 [新增],然後立即 複製產生的值 ,這是您的 CLIENT_SECRET。

收集所需的數值

從您的 Azure 應用程式:

  • 用戶端 ID> CLIENT_ID
  • 租用戶標識碼> TENANT_ID
  • 用戶端密碼> CLIENT_SECRET

步驟 4:識別您的 SharePoint 網站和資料夾

腳本會將產生的事件票證上傳至 SharePoint 網站。

  1. 識別您的 SharePoint 主機名稱 和 網站路徑:例如:HOSTNAME = contoso.sharepoint.com SITE_PATH = /sites/EventSite
  2. 請確定名為 Documents 的文件庫存在 (預設)。

步驟 5:部署套件

  1. 從 GitHub 匯入最近下載的網站,以建立新網站。 若要瞭解如何匯入網站,請參閱 power-pages-solutions

  2. 在網站升級期間,更新環境變數的值。 更新您在先前步驟中擷取的下列值:

    • 用戶端識別碼
    • 租用戶標識碼
    • 用戶端密碼 (將此值保留在金鑰保存庫中,並在環境變數中使用它。對於測試,您可以直接將其保存在環境變數中。
    • 主機名稱
    • SITE_PATH

指令碼醒目提示:組態區段

const CLIENT_ID = Server.SiteSetting.Get("CLIENT_ID");
const CLIENT_SECRET = Server.SiteSetting.Get("CLIENT_SECRET");;
const TENANT_ID = Server.SiteSetting.Get("TENANT_ID");

const HOSTNAME = Server.SiteSetting.Get("HOSTNAME"); 
const SITE_PATH = Server.SiteSetting.Get("SITE_PATH"); 

這些是從 Power Pages 網站設定(環境變數)中安全載入的。

步驟 6:測試 SharePoint 整合

指令碼會處理 事件註冊表單提交、取得 Microsoft Graph 存取權杖、產生 HTML 票證、將其上傳至 SharePoint,並在 Dataverse 中建立記錄。

腳本醒目提示:呼叫 Microsoft Graph 以取得存取權杖

async function getAccessToken() {
   const body = {
      "client_id": CLIENT_ID,
      "client_secret": CLIENT_SECRET,
      "scope": "https://graph.microsoft.com/.default",
      "grant_type": "client_credentials"
   };
   const tokenResp = await Server.Connector.HttpClient.PostAsync(
      `https://login.microsoftonline.com/${TENANT_ID}/oauth2/v2.0/token`,
      JSON.stringify(body),
      { "Content-Type": "application/x-www-form-urlencoded" },
      "application/x-www-form-urlencoded"
   );
   const tokenJson = JSON.parse(JSON.parse(tokenResp).Body);
   return tokenJson.access_token;
}

腳本重點:將票證上傳至 SharePoint

const siteResp = await Server.Connector.HttpClient.GetAsync(
  `https://graph.microsoft.com/v1.0/sites/${HOSTNAME}:${SITE_PATH}`,
  { Authorization: `Bearer ${accessToken}` }
);
const siteId = JSON.parse(JSON.parse(siteResp).Body).id;

const driveResp = await Server.Connector.HttpClient.GetAsync(
  `https://graph.microsoft.com/v1.0/sites/${siteId}/drive`,
  { Authorization: `Bearer ${accessToken}` }
);
const driveId = JSON.parse(JSON.parse(driveResp).Body).id;

const uploadUrl = `https://graph.microsoft.com/v1.0/drives/${driveId}/root:/Tickets/${fileName}:/content`;

await Server.Connector.HttpClient.PutAsync(
  uploadUrl,
  htmlTicket,
  { Authorization: `Bearer ${accessToken}`, "Content-Type": "text/html" },
  "text/html"
);

成功執行後:

  1. 新記錄會出現在 Dataverse 的 crd69_eventregistrations 下。
  2. HTML 票證檔案會上傳至您的 SharePoint 文件 > 票證 資料夾。
  3. crd69_ticketurl欄位包含上傳票證檔案的連結。

(選用)步驟 7:啟用電子郵件通知

若要傳送確認電子郵件給出席者:

  1. 取消指令碼中 「傳送確認電子郵件」 區段的註解。
  2. 將 {senderUserId} 取代為有效的 已啟用信箱的使用者識別碼 (例如,服務帳戶) 。
  3. 請確定已新增 Mail.Send 權限,並取得系統管理員同意。

伺服器邏輯概觀
作者伺服器邏輯
伺服器物件
如何使用伺服器邏輯與 Dataverse 資料表互動