Table of Contents

（教程）创建宏

  • 2023-12-07
  • Morten Lønskov
Applies to:
  • ✔ Tabular Editor 2 称为“自定义操作”
  • Tabular Editor 3
    ✔ Desktop
    ✔ Business
    ✔ Enterprise

宏是保存在 Tabular Editor 中的 C# Script，可以在不同语义模型之间轻松复用。将脚本另存为宏后，右键单击 TOM Explorer 中的对象时即可使用该宏，从而轻松将脚本应用到你的模型。

Note

在 Tabular Editor 2 中，用于复用 C# Script 的功能叫做 @custom-actions。

创建宏

创建宏的第一步是编写并测试一个 C# Script。

Tip

开始进行 C# Script 编写的一个简单方法是使用内置的录制功能，它会记录你在 TOM Explorer 中执行的操作。这样，你就可以了解如何与不同的模型对象交互，并创建可重复使用的脚本。另一种方式是重用现有脚本，比如我们的脚本库中的脚本。在本教程中，我们使用脚本 Format Numeric Measures（即“格式化数值度量值”）来演示宏功能。

当脚本满足要求并正常运行后，可点击工具栏中的“另存为宏”按钮保存脚本，这将打开“保存宏”窗口。

宏 创建信息框

“保存宏”窗口提供三个选项：

  1. 宏名称：为宏命名，并使用反斜杠 "" 为该宏创建文件夹路径（见下文）
  2. 为宏提供工具提示，方便你记住它的具体作用
  3. 选择宏应在哪个上下文中可用。

宏保存信息框

在上面的示例中，宏将保存到名为 Formatting\Beginner 的文件夹中，脚本名为“格式化数字度量值”。它会以“度量值”上下文保存。

宏上下文

宏会保存在一个“有效上下文”中，该上下文决定脚本可以应用到模型中的哪些对象。

之后，在 TOM Explorer 中右键单击某个度量值时即可使用该宏。保存宏时指定的上下文决定了你右键单击哪些对象时会看到该宏。

Tabular Editor 会根据正在保存的脚本建议一个上下文。

宏菜单快捷方式

编辑宏

在“宏”窗格中双击即可打开宏。编辑 C# Script 后，可按 Ctrl + S 或单击“Edit Macro”按钮保存。

宏编辑信息框

宏 JSON 文件

宏以名为 MacroActions.json 的 JSON 文件形式存储在 %LocalAppFolder%/TabularEditor3 中。想了解 Tabular Editor 中文件类型的更多信息，可以查看支持的文件类型

宏文件示例

MacroActions.json 文件示例可在此处找到。其中包含我们脚本库中的多个 C# Script: 下载示例 MacroActions 文件