SharePoint文档浏览记录日志：如何保存日志或创建自定义触发器？

方案1：SPFx应用自定义扩展（覆盖全站文档） #

这是最稳定通用的方案，能捕获站点内所有文档的访问行为：

• 新建SPFx项目，选择Application Customizer模板
• 在扩展的onInit方法中，通过URL判断当前页面是否为文档预览/打开页（比如包含_layouts/15/WopiFrame.aspx或_layouts/15/Doc.aspx）
• 确认是文档页面后，获取当前用户信息、文档URL、访问时间等核心数据
• 调用SharePoint REST API，将数据写入预先创建的日志列表（建议字段：UserID、UserName、DocumentURL、DocumentTitle、AccessTime）

核心代码片段：

import { SPHttpClient, SPHttpClientConfiguration } from '@microsoft/sp-http';

// 在onInit方法内添加逻辑
const docPageKeywords = ['WopiFrame.aspx', 'Doc.aspx'];
const isDocPage = docPageKeywords.some(keyword => window.location.href.includes(keyword));

if (isDocPage) {
  const currentUser = await this.context.pageContext.web.currentUser.fetch();
  // 可通过页面上下文或URL解析文档标题
  const docTitle = this.context.pageContext.listItem?.title || '未知文档';
  
  const logItem = {
    '__metadata': { 'type': 'SP.Data.LogListItem' },
    'UserID': currentUser.id,
    'UserName': currentUser.title,
    'DocumentURL': window.location.href,
    'DocumentTitle': docTitle,
    'AccessTime': new Date().toISOString()
  };

  // 提交日志到列表
  await this.context.spHttpClient.post(
    `${this.context.pageContext.web.absoluteUrl}/_api/web/lists/getbytitle('DocumentAccessLogs')/items`,
    SPHttpClient.configurations.v1,
    {
      headers: {
        'Accept': 'application/json;odata=nometadata',
        'Content-Type': 'application/json;odata=nometadata',
        'X-RequestDigest': await this.context.spHttpClient.getDigest(this.context.pageContext.web.absoluteUrl)
      },
      body: JSON.stringify(logItem)
    }
  );
}

• 部署扩展到租户，绑定到目标站点后，即可自动监听所有文档访问动作。

方案2：文档库专属自定义脚本（针对单个库） #

如果仅需记录特定文档库的访问，可采用轻量脚本方案：

• 先创建日志列表，字段同方案1
• 编写JS脚本，监听文档库内文件的点击事件（比如预览/打开按钮的触发）
• 脚本中通过SharePoint REST API获取用户和文档信息，写入日志列表
• 将脚本上传到站点资产库，通过文档库的格式化当前视图或现代页面嵌入功能加载脚本

注意：现代文档库对自定义JS的支持有限，若无法直接注入，可改用SPFx Field Customizer替代。

方案3：排查租户级审核日志配置 #

你提到站点集审核设置缺少功能，大概率是租户级未启用对应审核项：

1. 登录Microsoft 365合规中心
2. 进入审核模块，确认已启用「文档和页面」的「查看」动作审核
3. 租户级启用后，回到站点集的审核设置，就能看到对应选项，开启后可直接通过审核日志报告导出访问记录

内容的提问来源于stack exchange，提问作者Hamza