执行 <#list> 时如何正确分组记录

Question

新人来了。我一直在 NetSuite（使用 Freemarker）中构建一个高级表单来显示发票数据。一切看起来和工作都很好，但是，我想按位置对发票行项目进行分组。我正在使用一个简单的 <#list> 循环来提取订单项记录。我目前在每个订单项上显示位置。

代码（为简单起见删除了formats/styles）：

<table>
  <#list record.item as item>
     <tr>
        <td> ${item.location} </td>
        <td> ${item.description} </td>
        <td> ${item.quantity} </td>
        <td> ${item.rate} </td>
        <td> ${item.amount} </td>
    </tr>
  </#list>
</table>

当前输出示例：

Location A     Des 1              1        0     0
Location B     Des 1              1        0     0
Location C     Des 1              1        0     0
Location A     Des 2              1        0     0
Location B     Des 2              1        0     0
Location C     Des 2              1        0     0
Location A     Des 3              1        0     0
Location C     Des 3              1        0     0

所需的输出示例：

Location A
Des 1              1        0     0
Des 2              1        0     0
Des 3              1        0     0
Location B
Des 1              1        0     0
Des 2              1        0     0
Location C
Des 1              1        0     0
Des 2              1        0     0
Des 3              1        0     0

我试过嵌套第二个 <#list> 但它没有正常工作。任何建议或指示都有助于将我推向正确的方向。

谢谢！

Answer 1

FreeMarker 期望通过任何设置变量的方式来完成这种分组，在本例中是 NetSuite。（然而，我认为这可以被视为纯粹的表示问题，所以也许 FreeMarker 将来应该处理这个问题。）如果 NetSuite 确实不会为您分组数据，那么您必须在 FreeMarker 中进行，它将有点尴尬，因为它不是真正的编程语言......但它就是这样。

像这样定义一个宏：

<#macro listGroups items groupField>
  <#if items?size == 0><#return></#if>
  <#local sortedItems = items?sort_by(groupField)>
  <#local groupStart = 0>
  <#list sortedItems as item>
    <#if !item?is_first && item[groupField] != lastItem[groupField]>
      <#local groupEnd = item?index>
      <#nested lastItem[groupField], sortedItems[groupStart ..< groupEnd]>
      <#local groupStart = groupEnd>
    </#if>
    <#local lastItem = item>
  </#list>
  <#local groupEnd = sortedItems?size>
  <#nested lastItem[groupField], sortedItems[groupStart ..< groupEnd]>
</#macro>

您以后可以像这样使用这个宏：

<@listGroups record.item "location"; groupName, groupItems>
  <p>${groupName}</p>
  <table>
    <#list groupItems as groupItem>
       <tr>
          <td>${groupItem.location}</td>
          <td>${groupItem.description}</td>
          <td>${groupItem.quantity}</td>
          <td>${groupItem.rate}</td>
          <td>${groupItem.amount}</td>
      </tr>
    </#list>
  </table>
</@listGroups>

请注意，<@listGroups ...>中的groupName和groupItems只是您指定的任意循环变量名，它们不需要与#macro中使用的变量名匹配定义。

执行 <#list> 时如何正确分组记录

How to properly group records when executing a <#list>

freemarker