“Data Standard”对话框的高级配置详细信息

可以在“Data Standard”对话框中使用某些嵌入脚本以利用 PowerShell 中的某些功能。通过执行此操作，您可以进一步自定义“Data Standard”对话框，以便该值可以自动更新

基本函数

Prop[ ] 函数

Prop[ ] 是用于绑定的基本函数。通过该函数可以访问 Vault 中文件的特性。如果想要将文本框映射到特性 Engineer，请编写如下代码：<TextBox text="{Binding Prop[Engineer].Value}"/>。当创建文本框时，Prop[ ] 将返回该特性的值。每次文本框更新时，它都会通知负责将新值写入映射的文件特性的 Prop[ ] 函数。

• Value：您可以设置当前值或者读取值。
• .ListValue：返回包含可设置的固定值列表的字段(数组)。在 Data Standard 中，您可以自动取回预定义列表。
• .IsValid：检查特性是否有效。例如，如果您从通过 .ListValue 获取的预定义列表选择值，则将返回 TRUE。适用于 AutoCAD 和 Inventor 的 Data Standard 将使用正则表达式（如果设置）检查值。Vault Data Standard 会使用特性中定义的规则检查值。
• .IsInvalid 是 .isValid 的取反值。您在 .xaml 中需要用到它，因为您无法对值进行取反。

PS 函数

有三个脚本用于提供对话框与 PowerShell 之间的连接。它们的区别在于返回的值不同。

另外三个函数是 PsCmd[ ]、PsVal[ ] 和 PsList[ ]。这三个函数调用 Data Standard 中可用的脚本/函数。Data Standard 会加载在模块文件夹中找到的所有文件，然后使用这三个 PS 函数执行这些文件。此模块文件夹位于 C:\ProgramData\Autodesk\Vault <发行年份>\Extensions\DataStandard\Vault\addinVault 中。仅会加载此文件夹中的 .ps1 文件。Data Standard 不会查找子文件夹。

PsCmd[ ] 只能执行脚本函数。它不会返回任何值。

PsVal[ ] 可以执行脚本函数并返回字符串。

PsList[ ] 可以执行脚本函数并返回一组值。

EditMode 和 CreateMode

EditMode 和 CreateMode 是布尔类型的函数，允许您启用或禁用 UI 元素。以下是布尔类型的函数。

例如：

<TextBox:Name="myTextBox"IsEnabled="{Binding
CreateMode}"/>

或者

<TextBoxx:Name="myTextBox"IsEnabled="{Binding
EditMode}"/>

脚本绑定

通过将脚本绑定到函数，您可以调用“Data Standard”对话框中更改的字段上的事件。此绑定功能为自定义对话框带来了诸多可能性。

例如，您可以隐藏和显示高级字段以用于特殊目的。假设有这样一种情况：某个用户创建了一个新文件。您无需填充“公司”字段。但是，如果该字段已填充，则可以显示工程师或设计师姓名字段以便用户进行输入。或者，对话框可以在用户单击“确定”之前验证插入的字段值。

Data Standard 系统特性

Data Standard 有三个系统特性。它们均为只读特性。如果使用对它们使用绑定，则绑定仅适用于一个方向（只读）。

这三个系统特性为：

• _FileName 包含不含扩展名的文件名。
• _FileExt 包含文件扩展名。
• _FilePath 包含不含文件名的文件路径。

您可以将这三个系统特性结合使用以获取文档的整个路径，包括文件名和扩展名。

调试

使用“$dsDiag.inspect()”可以创建一个窗口以显示 PowerShell 脚本环境中的所有变量以及那一时刻其包含的成员和值。它是一个非常有用的调试工具。

注： $MyViewDiag 和 $MyViewWindow 已经分别重命名为 $dsDiag 和 $dsWindow。为了保持与以前的自定义设置兼容，旧变量名称仍起作用。但是，在将来的版本中会将其删除。出于这一原因，我们建议在现有自定义设置中就更改变量名称。