如何使用JavaScript获取Alfresco Share指定文件夹的NodeRef

你提到的Alfresco Share中无法使用Repository侧的companyhome对象这个判断半对半错：

• 如果是编写浏览器端运行的前端JS、或是Share层的Surf脚本，确实无法直接获取Repository层根作用域的companyhome对象，直接调用必然报错
• 如果是编写部署在Repository层的Web Script脚本，无论被Share调用还是供其他服务调用，所有Repository JS API（包括companyhome、siteService等内置对象）都可以正常使用
  注意区分两个JS运行环境的边界，这是Alfresco新手最容易踩的坑之一。

以你提到的「Documents站点下Report文件夹」场景为例，给你两种最常用的实现路径，按需选择即可：

• 方案1：Repository层服务端JS（优先选择，性能好、权限逻辑统一）
  Alfresco所有站点的文档库根节点，默认都存放在/sites/{站点短名}/documentLibrary路径下，不需要全库遍历查找，直接用内置站点服务定位即可：

  // 注意站点短名是创建站点时填写的URL标识，默认自动转全小写，不要直接用显示名
  var targetSite = siteService.getSite("documents");
  if (!targetSite) {
      throw new Error("目标站点不存在");
  }
  // 先拿到站点的文档库容器节点
  var docLibRoot = targetSite.getContainer("documentLibrary");
  if (!docLibRoot) {
      throw new Error("站点文档库未初始化");
  }
  // 定位文档库下的Report文件夹，支持多层相对路径，比如"2024/Q3/Report"
  var reportFolder = docLibRoot.childByNamePath("Report");
  if (!reportFolder || !reportFolder.isFolder) {
      throw new Error("Report文件夹不存在或路径错误");
  }
  // 这里就是你要的Report文件夹NodeRef
  var reportFolderNodeRef = reportFolder.nodeRef.toString();
  
  // 遍历获取文件夹下所有子节点
  var childList = reportFolder.children;
  for (var i = 0; i < childList.length; i++) {
      var currentNode = childList[i];
      // 按需处理子节点，比如打印名称、类型、自定义属性
      logger.log("子节点名称：" + currentNode.name + "，NodeRef：" + currentNode.nodeRef);
  }
  

  如果需要在Share前端拿到结果，把这段逻辑绑定到一个Repository层的Web Script，前端直接AJAX请求这个脚本的地址，就能拿到结构化的返回数据。

• 方案2：Share前端JS直接调用内置REST API
  如果不想自定义后端脚本，可以直接在前端调用Alfresco原生的公开API，不需要依赖companyhome对象：

  const siteShortName = "documents";
  // 第一步：查询站点文档库容器信息
  fetch(`/alfresco/api/-default-/public/alfresco/versions/1/sites/${siteShortName}/containers/documentLibrary`)
    .then(resp => resp.json())
    .then(docLibData => {
      const docLibNodeId = docLibData.entry.id;
      // 第二步：通过相对路径定位Report文件夹
      return fetch(`/alfresco/api/-default-/public/alfresco/versions/1/nodes/${docLibNodeId}/relative-path/Report`);
    })
    .then(resp => resp.json())
    .then(reportData => {
      // 拿到Report文件夹的NodeRef
      const reportNodeRef = reportData.entry.id;
      console.log("Report文件夹NodeRef：", reportNodeRef);
      // 第三步：拉取文件夹下所有子节点
      return fetch(`/alfresco/api/-default-/public/alfresco/versions/1/nodes/${reportNodeRef}/children?include=properties,permissions`);
    })
    .then(resp => resp.json())
    .then(childrenData => {
      console.log("Report下所有子节点：", childrenData.list.entries);
    })
    .catch(err => {
      console.error("节点查询失败：", err);
    });
  

• 站点短名不要直接用中文/大小写混写的显示名，必须和创建站点时设置的URL标识完全一致，默认创建时系统会自动把名称转成全小写作为短名
• 如果Report文件夹不在文档库根目录，只要把childByNamePath的参数、或是API请求里的relative-path值改成实际的相对路径即可，比如"财务归档/年度报表/Report"
• 前端直接调用API时，要确保当前登录用户对目标站点、目标文件夹有读取权限，否则接口会返回403权限错误

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