Data Standard 自定义对象管理

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

要求

为了支持自定义对象，需要以下三个组件：

使用预配置的自定义对象“Task”

默认情况下，所有这三个组件都会随 Data Standard 一同提供。这些组件都经过了预配置，可与 Vault 中名为 Task 的自定义对象配合使用。

注意：仅当存在自定义对象时，才会提供针对自定义对象的关联菜单支持。

  1. 通过 Vault 配置，创建一个自定义对象定义并将其命名为 Task。

    注意：有关详细信息，请参见自定义对象管理。

  2. 将 Title 和 Description 特性指定给 Base 类别。

  3. 重新启动 Vault Explorer 并登录 Vault 两次：

    • 首次登录时，确认 Task 对象类型可在 Vault Client 中使用。
    • 注销并再次登录以初始化“数据表”选项卡和菜单项，以创建和编辑 Task。

    新的自定义对象 Task 被完全初始化并准备就绪，可以使用。

  4. 使用“新建”命令创建新自定义对象并为其指定任意名称。

  5. 在新自定义对象上单击鼠标右键。关联菜单现在将“新建 Task”和“编辑 Task”显示为菜单选项。

注意：在定义新的自定义对象并首次登录后，将创建文件 CustomEntityDefinitions.json（%programdata%\Autodesk\<Vault 版本>\Extensions\DataStandard\Vault）。该文件中的定义用于初始化自定义对象的选项卡和菜单项。该文件不应手动修改。要避免用户必须多次登录，可以部署该文件。如果您无法初始化自定义对象，可删除该文件。当您下次登录到 Vault 时，将创建该文件。

配置其他自定义对象

要定义您自己的自定义对象，请复制 Task 样例中的三个组件，并且根据需要进行修改。

下面是一个名为 Person 的自定义对象的示例。

菜单条目

以下位置定义了用于创建和编辑对话框的关联菜单项：

%programdata%\Autodesk\<Vault 版本>\Extensions\DataStandard\Vault\MenuDefinitions.xml

必须创建菜单项定义：

  1. 从 Task 样例中复制定义（MenuItem NewTask、MenuItem EditTask）。

  2. 将所有变量中的 Task 替换为 Person。

  3. 修改 Description、Hint、Label 和 Navigation Types。

    注意：对于这些变量，可以使用原始样例中的 UIString 语法。有关详细信息，请参见本地化。
    <NewTask Label="CreatePerson..." 
Description="New Person"
Hint="Create a new person object" 
PSFile="CreateCustomObject.ps1"
Image="NewCustomObject.ico"
ToolbarPaintStyle="TextAndGlyph"
NavigationTypes="Person"
MultiSelectEnabled="false"/>

<EditTaskLabel="Edit Person..." 
Description="Edit Person"
Hint="Edit a person object"
PSFile="EditCustomObject.ps1"
Image="EditCustomObject.ico"
ToolbarPaintStyle="TextandGlyph"
NavigationTypes="Task"
MultiSelectEnabled="False"/>

    接下来，为新的自定义对象创建菜单站点。

    1. 从 Task 样例中复制站点 (CommandSite Task)。

    2. 将所有变量中的 Task 替换为 Person。

       <TaskLabel="Person"
  DeployAsPullDown="False"
  Location="Person">
  <ItemName="NewPerson">
   </Item>
  <ItemName="EditPerson">
   </Item>

有关菜单语法的详细信息，请参见自定义 Data Standard MenuDefiniftions.xml 文件。

脚本文件

MenuDefinitions.xml 文件中的菜单定义指向 PowerShell 文件。这些文件位于 %programdata%\Autodesk\<Vault 版本>\Extensions\DataStandard\Vault\addinVault\Menus。

默认的 CreateCustomObject.ps1 和 EditCustomObject.ps1 PowerShell 文件适用于每个自定义对象。没有必要创建附加的 PowerShell 文件。但是，仍然可以通过执行以下任务为新的自定义对象自定义和创建 PowerShell 文件：

  1. 复制 CreateCustomObject.ps1 和 EditCustomObject.ps1 菜单定义文件，并将其重命名为 CreatePerson.ps1 和 EditPerson.ps1。

  2. 与其他脚本类似，创建和编辑自定义对象脚本都指向关联的 XAML 文件。

    通过将 Task 替换为 Person，修改用于定义 Data Standard 对话框的 XAML 文件名。

    ...
$xamlFile = New-Object CreateObject.WPF.XamlFile "PersonXaml", "%ProgramData%\Autodesk\Vault 2016\Extensions\DataStandard\Vault\Configuration\Person.xaml"
$dialog.XamlFile = $xamlFile
...

对话框和选项卡

自定义对象创建和编辑对话框的 XAML 文件在 PowerShell 文件中指定（请参见上文）。默认情况下，创建和编辑对话框以及选项卡的 XAML 文件位于此处：

%programdata%\Autodesk\<Vault 版本>\extensions\datastandard\vault\configuration

默认的 CustomObject.xaml 适用，无需进行任何更改。但是，您必须使用 CustomObject.xaml 文件作为模板，为新的自定义对象创建 XAML 文件。

  1. 复制 CustomObject.xaml 文件并将其命名为 Person.xaml。

  2. 通过下列步骤修改新的 XAML 文件：

    • 将 TaskWindow 的所有引用替换为 PersonWindow。
    • 通过将 New Person 和 Edit Person Datasheet 添加至 UiStrings.xml 并将 ID 替换为新文本字符串 UIString[LBL61] 和 UIString[LBL62] 的 ID，更正对话框标题。
    • 根据需要，添加或删除特性控件。

  3. 通过配置下列各项更改 %programdata%\Autodesk\<Vault 版本>\Extensions\DataStandard\Vault\addinVault\Default.ps1 中的下列函数：

    • 配置 InitializeWindow 以控制对话框的大小。
    • 配置 GetCategories 以支持基于类别的动态特性。
    • 配置 Validate 以实施验证规则。

为新的自定义对象获取 Datasheet 选项卡

  1. 复制 Task 文件夹并将其命名为 Person。
  2. 如果需要，更新 Person 文件夹中的 Datasheet.xaml（例如，添加或删除特性）。
父页面: Data Standard 配置