为自定义对象配置 Data Standard

可以将“创建”对话框和选项卡配置为显示自定义对象数据。

要求

配置 Data Standard 以便与自定义对象配合使用

默认情况下,所有这三个组件都会随 Data Standard 一同提供。这些组件都经过了预配置,可与 Vault 中名为 CustomObject 的自定义对象配合使用。您必须先创建此自定义对象,然后才能将 Data Standard 与所有自定义对象配合使用。
注: 仅当存在现有的自定义对象时,才会提供针对自定义对象的关联菜单支持。您必须先创建默认自定义对象 (CustomObject),然后才能将 Data Standard 与其他自定义对象配合使用。

创建 CustomObject

  1. 在 Vault 中创建一个自定义对象并将其命名为 CustomObject。

    注: 有关详细信息,请参见自定义对象管理
  2. 重新启动 Vault。
    注: 您必须重新启动 Vault 客户端才能显示“自定义对象”选项卡。
  3. 使用“新建”命令创建新自定义对象并为其指定任意名称。
  4. 在新自定义对象上单击鼠标右键。关联菜单现在显示了两个新的菜单项。

为 Data Standard 创建自定义对象菜单

自定义对象菜单是在 mymenu.mnu 文件中进行配置的。此文件位于 C:\ProgramData\Autodesk\Vault 2015\Extensions\DataStandard\Vault 目录下。
注: 对于 Vault 2015 R2 用户,该文件的位置为 C:\ProgramData\Autodesk\Vault 2015 R2\Extensions\DataStandard\Vault

修改 mymenu.mnu 文件

    mymenu.mnu 文件的两个部分中,您可以配置菜单选项。一个部分用于菜单选项“新建”。另一个部分用于菜单选项“编辑”。

    “新建”菜单选项

      item newCustomObject 
      {
      .....
      ...
       NavigationTypes = [{CustomObject}];
      ToolbarPaintStyle = TextAndGlyph;
       PSFile = "CreateCustomObject.ps1";
       Image="NewCustomObject.ico";
      }
      

    “编辑”菜单选项

      item editCustomObject 
      {
      ....
      .....
       NavigationTypes = [{CustomObject}];
       ToolbarPaintStyle = TextAndGlyph;
       PSFile = "EditCustomObject.ps1";
       Image="EditCustomObject.ico";
      }

    这两部分的语法与其他菜单项的一样。但是,属性 NavigationTypes 包含您要用指定菜单选项支持的自定义对象的名称。自定义对象的名称必须输入在花括号中(例如 {CustomObjectName})。

    默认情况下,将使用 {CustomObject}。但是,如果您创建了其他名称的自定义对象,例如 MyCustomObject,则 NavigationTypes 属性值必须与该自定义对象的名称 {MyCustomObject} 相匹配。

修改“创建”和“编辑”自定义对象脚本文件

    根据 mymenu.mnu 文件中的具体部分,该文件中的菜单定义指向名为 CreateCustomObject.ps1EditCustomObject.ps1 的 PowerShell 文件。用于创建和编辑自定义对象的脚本文件与用于创建和编辑其他对象(例如文件和文件夹)的脚本类似。但是,用于创建和编辑自定义对象的脚本包含两个唯一的命令:GetCreateCustomObjectDialogGetEditCustomObjectDialog

    与其他脚本类似,“创建”和“编辑”自定义对象脚本也指向关联的 .xaml 文件。可以编辑这些脚本以指向其他 .xaml 文件。

    以下示例摘自 NewCustomObject.ps1 脚本。

    ....
    $dialog = $dsCommands.GetCreateCustomObjectDialog($id)
    $xamlFile = New-Object CreateObject.WPF.XamlFile "CustomEntityXaml", "%ProgramData%\Autodesk\Vault 2015\Extensions\DataStandard\Vault\Configuration\CustomObject.xaml"
    ....
    注: Vault 2015 R2 用户应改为使用此路径:C:\ProgramData\Autodesk\Vault 2015 R2\Extensions\DataStandard\Vault\Configuration

使用 XAML 模板创建自定义对象对话框和选项卡

    .xaml 对话框的语法与其他对话框和选项卡的一样。对于“创建”和“编辑”对话框,随 CustomObject.xaml 一同提供了 XAML 模板。您可以使用此对话框模板来创建自己的自定义对象。

    自定义对象的文件夹必须创建在 C:\ProgramData\Autodesk\Vault 2015\Extensions\DataStandard\Vault\Configuration 目录下。
    注: 对于 Vault 2015 R2 用户,该文件的位置为 C:\ProgramData\Autodesk\Vault 2015 R2\Extensions\DataStandard\Vault\Configuration
    默认情况下,名为 CustomObject 的文件夹已存在。此文件夹用于您在第一次配置 Data Standard 以便与自定义对象配合使用时所创建的标准自定义对象 (CustomObject)。
    对于您自己的自定义对象,请创建 CustomObject 文件夹的副本并将其重命名为您的自定义对象的名称。
    注: 文件夹名称必须与自定义对象的名称相匹配。

    Vault 重新启动后,“Data Standard”对话框中的选项卡将显示自定义对象名称(该名称由自定义对象文件夹中的 XAML 文件决定)。默认情况下,名为 Datasheet.xml 的 XAML 文件已存在。使用此文件作为模板来创建您的自定义对象选项卡。

    注: 有关详细信息,请参见 .xaml 文件剖析