如何在表格中填充User Story的Revision History？Rally方案存疑

没问题！我来一步步帮你搞定用模型填充User Story修订历史表格的事儿，结合你找到的那篇《Querying for User Story revisions in Rally》方案，咱们这么来操作：

首先得在你的数据模型里把两个关键对象的绑定关系捋顺：

• User Story：对应Rally里的HierarchicalRequirement对象，每个故事都有唯一的ObjectID作为标识
• Revision：对应Rally的Revision对象，它的Artifact字段会直接关联到对应User Story的ObjectID，而RevisionHistory字段里藏着所有修订的关键信息——比如修改时间、操作人、具体变更的字段等

你找到的那篇方案里应该提到了Rally API查询修订历史的方式，现在把它落地到模型里：

• 第一步：先把表格要引用的所有User Story的ObjectID收集成一个列表
• 第二步：针对这个列表调用Rally API，用过滤条件精准捞取关联的修订数据，示例过滤规则可以这么写：

  Artifact.ObjectID = [目标User Story的ID] AND RevisionHistory.CreationDate > [你需要的起始时间]
  

• 第三步：把API返回的原始数据映射到你的模型字段里，比如：
  • 修订版本号 → RevisionNumber
  • 修改时间 → CreationDate
  • 修改人 → User.Name
  • 变更内容 → 可以用Description，或者解析Changes字段里的具体变更项（更精准）

当模型拿到结构化的修订历史数据后，就可以无缝填充表格了，分两种常见场景说：

• 前端交互式表格（比如React/Vue）：直接把模型返回的修订历史数组作为表格数据源，循环渲染每一行就行。举个React的小例子：

  <table className="revision-history-table">
    <thead>
      <tr>
        <th>修订版本</th>
        <th>修改时间</th>
        <th>操作人</th>
        <th>变更内容</th>
      </tr>
    </thead>
    <tbody>
      {storyRevisions.map(revision => (
        <tr key={revision.RevisionNumber}>
          <td>{revision.RevisionNumber}</td>
          <td>{new Date(revision.CreationDate).toLocaleString()}</td>
          <td>{revision.User.Name}</td>
          <td>{parseChangeDetails(revision.Changes)}</td>
        </tr>
      ))}
    </tbody>
  </table>
  

  这里的parseChangeDetails就是你可以在模型层写的方法，用来解析Changes字段里的JSON数据，把“状态从Defined改为In Progress”这种具体变更展示出来。
• 后端生成静态表格（比如Excel/PDF）：模型把修订历史整理成二维数组这种结构化格式，然后用对应的工具库（比如Apache POI处理Excel）生成表格，每一条修订记录对应表格的一行

• 批量查询减少API调用：别傻乎乎单个故事逐个查，用IN操作符一次性查多个故事的修订历史，比如：

  Artifact.ObjectID IN [StoryID1, StoryID2, StoryID3]
  

• 加个缓存省时间：如果表格不需要实时刷新数据，可以把查询到的修订历史缓存起来，避免重复调用API拖慢速度
• 解析变更字段更友好：Rally返回的Changes是JSON格式的，你在模型层把它解析成人类易懂的文字，比直接展示默认的Description要清晰得多

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