关于Autodesk Tandem命名过滤器定义、保存、检索及API的技术问询

云原生阿岚

2026-6-16

Autodesk Tandem 过滤器操作与API检索指南

1. 定义、保存和检索命名过滤器

定义并保存过滤器

打开目标Tandem项目，进入资产浏览器或对应数据视图
配置过滤条件：在过滤面板中选择目标属性（如设备类型、运行状态），设置匹配规则（等于、包含等），支持多条件组合
点击过滤面板右侧的保存图标（软盘样式），输入自定义名称后确认，完成保存

检索已保存过滤器

在过滤面板的下拉列表中直接选择已保存的过滤器名称，即可快速应用对应条件
点击过滤面板的「管理过滤器」选项，可对已保存的过滤器进行编辑、重命名或删除操作

2. 多过滤器保存与编程检索

多过滤器支持

完全可以在同一Tandem项目中创建并保存多个命名过滤器，每个过滤器独立存储自身的条件组合，保存时输入不同名称即可，不会互相覆盖。

编程方式检索已保存过滤器

Tandem REST API提供了专门的接口用于检索项目内的已保存过滤器，以下是核心实现示例：

JavaScript 代码示例

// 替换为你的有效访问令牌和项目ID
const accessToken = 'YOUR_VALID_ACCESS_TOKEN';
const projectId = 'TARGET_PROJECT_ID';

async function fetchSavedFilters() {
  try {
    const res = await fetch(
      `https://developer.api.autodesk.com/tandem/v1/projects/${projectId}/filters`,
      {
        method: 'GET',
        headers: {
          'Authorization': `Bearer ${accessToken}`,
          'Content-Type': 'application/json'
        }
      }
    );
    const savedFilters = await res.json();
    console.log('已保存过滤器列表:', savedFilters);
    return savedFilters;
  } catch (err) {
    console.error('获取过滤器失败:', err);
  }
}

// 执行检索
fetchSavedFilters();