Administración de objetos personalizados de Data Standard

Configure cuadros de diálogo y fichas de creación para mostrar datos de objeto personalizados.

Requisitos

Se necesitan tres componentes para el soporte de objetos personalizados:

• Entradas de menú para el cuadro de diálogo de creación y edición.
• Archivos de cuadro de diálogo (.xaml) en los cuadros de diálogo y fichas.
• Archivos de secuencias de comandos (PowerShell) para la lógica de cuadros de diálogo.

Utilizar el objeto personalizado preconfigurado "Tarea"

Por defecto, los tres componentes se proporcionan con Data Standard. Estos componentes se han preconfigurado para trabajar con un objeto personalizado en Vault denominado Tarea.

Nota: La compatibilidad con menús contextuales para objetos personalizados solo está disponible si hay un objeto personalizado.

1. Mediante la configuración de Vault, cree una definición de objeto personalizado y llámelo Tarea.
   Nota: Consulte Administración de objetos personalizados para obtener más información.
2. Asigne las propiedades de título y descripción de las propiedades a la categoría Base.
3. Reinicie Vault Explorer e inicie sesión en Vault dos veces:
   • La primera vez que inicie sesión, compruebe que el tipo de objeto Tareas esté disponible en Vault Client.
   • Cierre la sesión y vuelva a iniciarla por segunda vez para inicializar la ficha Hoja de datos y los artículos de menú para crear y editar Tareas.

   El nuevo objeto personalizado Tarea se ha inicializado por completo y está listo para su uso.

4. Cree un nuevo objeto personalizado mediante el comando Nuevo y asígnele el nombre que desee.
5. Haga clic con el botón derecho en el nuevo objeto personalizado. El menú contextual muestra ahora Nueva tarea y Editar tarea como opciones de menú.

Nota: Al iniciar la sesión por primera vez después de haber definido un nuevo objeto personalizado, el archivo CustomEntityDefinitions.json (%programdata%\Autodesk\<edición de Vault>\Extensions\DataStandard\Vault ). La definición del archivo se utiliza para inicializar la ficha y los elementos de menú para los objetos personalizados. El archivo no se debe modificar manualmente. Para evitar que los usuarios deban conectarse varias veces, el archivo se puede implantar. Si no puede inicializar los objetos personalizados, el archivo se puede suprimir. Se crea la próxima vez que inicie sesión en un almacén.

Configurar objetos personalizados adicionales

Para definir su propio objeto personalizado, copie los tres componentes del ejemplo de Tarea y modifíquelos según sea necesario.

A continuación se muestran ejemplos de un objeto personalizado denominado Persona.

Entradas del menú

Las entradas de menú contextual para crear y editar un cuadro de diálogo se define aquí:

%programdata%\Autodesk\<versión de Vault>\Extensions\DataStandard\Vault\MenuDefinitions.xml

Deben crearse las definiciones de entrada de menú:

1. Copie las definiciones (MenuItem NewTask, MenuItem EditTask) del ejemplo de Tarea.
2. Sustituya Tarea (Task) por Persona (Person) en todas las variables.
3. Modifique los valores de Description, Hint, Label y Navigation Types.
   Nota: Para estas variables, puede utilizarse la sintaxis de UIString del ejemplo original. Consulte Licencias para obtener más información.

	<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"/>
  

A continuación, cree un sitio de menú para el nuevo objeto personalizado.

1. Copie el sitio (CommandSite Tarea) desde el ejemplo de Tarea.
2. Sustituya Tarea (Task) por Persona (Person) en todas las variables.

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

Consulte Personalización del archivo MenuDefinitions.xml de Data Standard para obtener más información sobre la sintaxis de los menús.

Archivos de secuencias de comandos

Las definiciones de menú del archivo MenuDefinitions.xml apuntan a archivos de PowerShell. Estos archivos se encuentran en %programdata%\Autodesk\<versión de Vault>\Extensions\DataStandard\Vault\addinVault\Menus.

Los archivos CreateCustomObject.ps1 y EditCustomObject.ps1 por defecto de PowerShell funcionan para cada objeto personalizado. No es necesario crear archivos adicionales de PowerShell. Sin embargo, aún es posible personalizar y crear archivos de PowerShell para el nuevo objeto personalizado mediante las siguientes tareas:

1. Copie los archivos de definición de menús CreateCustomObject.ps1 y EditCustomObject.ps1 y cambie su nombre por CreatePerson.ps1 y EditPerson.ps1.
2. De forma similar a otras secuencias de comandos, las secuencias de comandos de creación y edición de objetos personalizados apuntan a un archivo XAML relacionado.

   Modifique el nombre del archivo XAML que define el cuadro de diálogo Data Standard sustituyendo Tarea (Task) por Persona (Person).

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

Cuadros de diálogo y fichas

El archivo XAML para el cuadro de diálogo de creación y edición de objetos personalizados se especifica en los archivos de PowerShell (véase arriba). Por defecto, los archivos XAML para cuadros de diálogo de creación y edición, así como las fichas, se encuentran aquí:

%programdata%\Autodesk\<Vault version>\extensions\datastandard\vault\configuration

Por defecto, el CustomObject.xaml por defecto funciona sin cambios. No obstante, debe utilizar el archivo CustomObject.xaml como una plantilla para crear un archivo XAML para un nuevo objeto personalizado.

1. Copie CustomObject.xaml y asígnele el nombre Person.xaml.
2. Modifique el nuevo archivo XAML con estos pasos:
   • Sustituya todas las incidencias de TaskWindow por PersonWindow.
   • Corrija el título del cuadro de diálogo agregando Nueva persona y Editar hoja de datos de persona en UiStrings.xml y sustituya los ID por los correspondientes a las nuevas cadenas de texto UIString[LBL61] y UIString[LBL62].
   • Agregue o elimine controles de propiedad según sea necesario.
3. Cambie las funciones siguientes en %programdata%\Autodesk\<versión de Vault>\Extensions\DataStandard\Vault\addinVault\Default.ps1 configurando:
   • InitializeWindow para controlar el tamaño del cuadro de diálogo.
   • GetCategories para admitir propiedades dinámicas basadas en categorías.
   • Validate para implementar reglas de validación.

Obtenga una ficha Hoja de datos para el nuevo objeto personalizado

1. Copie la carpeta Tarea y cambie el nombre por Persona.
2. Si es necesario, actualice Datasheet.xaml en la carpeta Persona (por ejemplo, añada o elimine propiedades).