报表

报表统计和测量图纸中的内容：有多少个图元、各图层的切割线和压痕线有多长、刀模所需的刀线长度及其大致成本、展开料的尺寸、所有图元的列表。文件 › 报表… 会列出报表，询问所选报表的选项，并显示其结果。复制 将结果以文本形式放到剪贴板上；保存… 将其写为 CSV、Excel 工作簿（Numbers 和 Google 表格也能打开）、OpenDocument 电子表格（LibreOffice 的格式）、网页、PDF（用于打印或发送：版式与网页相同，图片按原样绘制，长表格延续到后续页面）、Word 文档（Pages 和 Google 文档也能打开）或 OpenDocument 文本（LibreOffice 的格式）——两者版式与 PDF 相同且仍可编辑、Markdown（用于 Wiki 或笔记）、JSON（原样的数据，供其他程序使用）或文本。在电子表格中，数字仍为数字，标题加粗。

报表用 JavaScript 编写，因此您可以修改应用自带的报表或编写自己的报表：统计什么、如何分组、单位和价格、列。

声明报表

drawingReport({
  name: "Cut and crease",
  category: "Quantities",
  description: "Total cut and crease length.",
  options: { selectionOnly: { label: "Selected elements only", value: false } },
  run(drawing, options) {
    const elements = drawing.elements.filter(e => !options.selectionOnly || e.selected);
    const length = layer => elements.filter(e => e.layer === layer).reduce((t, e) => t + e.length, 0);
    return {
      title: "Cut and crease",
      summary: `${elements.length} elements`,
      tables: [{
        columns: ["Layer", { title: `Length (${drawing.units})`, decimals: 1 }],
        rows: [["Cut", length(0)], ["Crease", length(1)]],
        footer: ["Total", length(0) + length(1)]
      }]
    };
  }
});

drawing 是设计规则所看到的图纸：其名称、单位、范围和图层，每个导出的图元及其 id、类型、图层、长度、面积、端点、范围、连接点和刀具，以及是否被选中；正在处理的页面；每个页面上的排样，包括其纸张、副本和废料；以及按名称访问的备注（drawing.notes["Customer"]）。options 按名称保存所选的值。也可以使用绘图 API 的读取函数（variable("L")、getPoint(4)、evaluate("…")），以及 distanceBetween 和 crossings。报表不能更改图纸。针对各行业的报表，它还包含 drawing.panels（切割图层上作为工件的每个闭合轮廓：其尺寸取外接最小矩形，以及面积、周长、孔、开孔和缺口、其内部的文字、纹向和封边，以及其在 3D 中的 thickness 和 look：其自己的 RULE THICK 和 LOOK，否则为其图层的 LAYER3D，否则为 null）、drawing.welds（用焊口编号工具编号的焊口）和 drawing.rollLayouts（每个卷材排料的裁幅、接缝和裁切图）。

返回内容

每个表格包含：

单元格可以是数字、文本或 true/false（显示为“是”和“否”）；null 表示单元格为空。数字按列的小数位数显示（未指定时，整数按原样显示，其他数字保留 2 位），并右对齐。在 CSV 中，数字以完整精度写入，以便电子表格处理。

报表也可以只返回文本：一个字符串，或由多行组成的数组。

应用自带的报表

它们位于应用的 Extensions 文件夹中的 reports.js 内，其中还有它们共用的辅助函数（sum、groupBy）；焊口图、玻璃订货清单、板件开料清单、地毯卷材裁切清单以及泡棉和垫片报价位于 tradereports.js 中。将该文件复制到您自己的文件夹（文件 › 扩展 › 打开扩展文件夹）即可修改它们：使用您所在货币的价格、您的刀模使用的图层、您的估价人员需要的列。

使用您的语言

应用自带的报表以应用所用的语言（英语、西班牙语或简体中文）显示：报表对话框和“一键制作”中的名称、类别、说明和选项，以及报表所写的内容（标题、表头、列、摘要和说明），数字按您的习惯书写（西班牙语使用小数逗号）。供其他程序导入的内容保持英文：板件下料清单的 MaxCut、OptiCut 和 CutRite 列，以及勾选 CSV：仅订购单（用于导入） 时的玻璃订购单。来自您图纸的内容（图层名称、零件名称、配件项目）按原样显示。

您自己的报表也可以这样做：

• tr("English text", …) 给出用户语言的文本，其 {0}、{1} … 由其后的值填入；数字的占位符可以指定写法：{0:F2} 表示两位小数。
• fmt(number, decimals) 按用户的习惯书写数字。
• 译文位于脚本旁的 strings 文件夹中：es.json 和 zh-Hans.json，各自包含英文文本及其译文。报表声明的内容（名称、类别、说明、选项及其选项值）也由它们翻译；run 收到的选项值保持声明时的原样。没有译文的文本以英文显示，您文件夹中的译文优先于应用自带的译文。
• 在两处译法不同的词在竖线前带上其上下文：tr("weld|Socket") 在英文中显示 Socket。

const count = (n, one, many) => tr(n === 1 ? one : many, n);
summary: tr("{0}, {1:F2} m in all.", count(rules.length, "{0} rule", "{0} rules"), total)

说明

• 出错的报表会说明错误，并显示文件和行号。
• 编写报表时，print(…) 和 console.log(…) 会在交互窗口中显示值。

要通过电子邮件发送报表而不是保存它，请使用文件 › 通过电子邮件发送 › 报表…，并在报表中选择保存…：请参阅通过电子邮件发送导出文件。另请参阅：扩展、设计规则、绘图 API。