本指南將引導您設定和測試將 Power Pages 與 Microsoft Graph 和 SharePoint Online 整合的伺服器邏輯範例。
步驟 1:下載範例套件
- 移至 GitHub 存放庫 https://github.com/microsoft/power-pages-samples。
- 選取程式碼 >下載 ZIP。
- 下載後,將ZIP檔案解壓縮到本機資料夾,例如:
C:\PowerPages\ServerLogic - 進入解壓縮的路徑:
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:必要條件
開始之前,請確定您擁有:
- 存取 Microsoft Entra ID (Azure AD), 並有權註冊應用程式。
- 存取 SharePoint Online 網站 (例如 https://contoso.sharepoint.com/sites/EventSite)。
步驟 3:建立和設定 Entra ID 應用程式
您需要應用程式註冊,才能讓您的伺服器邏輯程式代碼針對 Microsoft Graph 進行驗證。
建立應用程式註冊
- 移至 Azure 入口網站,然後選取 [ 應用程式註冊]。
- 選取 + 新增註冊。
- 提供名稱 (例如,PowerPages-Graph-Integration)。
- 選擇 [僅限此組織目錄中的帳戶]。
備註
您不需要為此範例提供重新導向 URI。
- 選取 註冊。
設定 API 權限
- 在新應用程式中,移至 API 權限>新增權限。
- 選取 [ Microsoft Graph>應用程式] 許可權。
- 新增下列權限:
- Sites.ReadWrite.All (適用於 SharePoint 檔案作業)
- Mail.Send (選擇性 - 僅當您計劃啟用電子郵件部分時才需要)
- 選取將管理員同意授與您的租用戶。
建立客戶端密碼
- 移至 憑證與密碼> 用戶端密碼。
- 選取 + 新增用戶端密碼。
- 輸入描述並選擇到期期限 (例如,六個月)。
- 選取 [新增],然後立即 複製產生的值 ,這是您的 CLIENT_SECRET。
收集所需的數值
從您的 Azure 應用程式:
- 用戶端 ID> CLIENT_ID
- 租用戶標識碼> TENANT_ID
- 用戶端密碼> CLIENT_SECRET
步驟 4:識別您的 SharePoint 網站和資料夾
腳本會將產生的事件票證上傳至 SharePoint 網站。
- 識別您的 SharePoint 主機名稱 和 網站路徑:例如:HOSTNAME =
contoso.sharepoint.comSITE_PATH =/sites/EventSite - 請確定名為 Documents 的文件庫存在 (預設)。
步驟 5:部署套件
從 GitHub 匯入最近下載的網站,以建立新網站。 若要瞭解如何匯入網站,請參閱 power-pages-solutions
在網站升級期間,更新環境變數的值。 更新您在先前步驟中擷取的下列值:
- 用戶端識別碼
- 租用戶標識碼
- 用戶端密碼 (將此值保留在金鑰保存庫中,並在環境變數中使用它。對於測試,您可以直接將其保存在環境變數中。
- 主機名稱
- 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"
);
成功執行後:
- 新記錄會出現在 Dataverse 的 crd69_eventregistrations 下。
- HTML 票證檔案會上傳至您的 SharePoint 文件 > 票證 資料夾。
- crd69_ticketurl欄位包含上傳票證檔案的連結。
(選用)步驟 7:啟用電子郵件通知
若要傳送確認電子郵件給出席者:
- 取消指令碼中 「傳送確認電子郵件」 區段的註解。
- 將 {senderUserId} 取代為有效的 已啟用信箱的使用者識別碼 (例如,服務帳戶) 。
- 請確定已新增 Mail.Send 權限,並取得系統管理員同意。