(教程)创建宏
宏是在 Tabular Editor 中保存的 C# Script,可在不同语义模型间轻松复用。 将脚本保存为宏后,你就可以在 TOM Explorer 中右键单击对象时使用该宏,从而轻松将脚本应用到你的模型中。
创建宏
创建宏的第一步是编写并测试一个 C# Script。
Tip
开始使用 C# 脚本编写的一个简单方法是使用内置的录制功能,它可以录制你在 TOM Explorer 中执行的操作。 通过这种方式,你可以了解如何与不同的模型对象交互,并创建可复用的脚本。 另一种方法是复用现有脚本,例如我们脚本库中的脚本。 在本教程中,我们使用脚本 Format Numeric Measures 来演示宏功能。
当脚本按要求运行后,可以使用工具栏按钮“保存为宏”保存脚本,这会打开“保存宏”窗口。

“保存宏”窗口提供三个选项:
- 宏名称:为宏命名,并使用反斜杠 "" 为宏创建文件夹路径(见下文)
- 为宏添加工具提示,方便记住其具体用途
- 选择宏应可用的上下文。

在上面的示例中,宏将保存在名为 Formatting\Beginner 的文件夹中,脚本名为 "Format Numeric Measures"。 它将保存在“度量值”上下文中。
宏上下文
宏会保存在一个“有效上下文”中,该上下文决定脚本可以应用到模型中的哪些对象。
然后,您可以在 TOM Explorer 中右键单击度量值时使用此宏。 保存宏时指定的上下文决定了右键单击哪些对象时会显示该宏。
Tabular Editor 会根据正在保存的脚本建议一个上下文。

编辑宏
在“宏”窗格中双击该宏即可打开;编辑 C# Script 后,可使用 Ctrl + S 或单击“编辑宏”按钮保存。

宏 JSON 文件
宏以名为 MacroActions.json 的 JSON 文件形式存储在 %LocalAppFolder%/TabularEditor3 中。 有关 Tabular Editor 中文件类型的更多信息,请参阅 支持的文件类型
宏文件示例
此处提供了一个 MacroActions.JSON 文件示例。 其中包含我们脚本库中的多个 C# Script:下载示例 MacroActions 文件