Funciones de PowerShell para Data Standard

Las funciones de PowerShell se utilizan para personalizar la lógica empresarial, el comportamiento, los valores por defecto y la interfaz de usuario.

Data Standard incluye varias funciones que son necesarias para trabajar con los cuadros de diálogo y fichas. Algunas funciones se llaman desde dentro de los complementos de Data Standard.

Estas funciones son obligatorias y no se pueden eliminar.

Las funciones pueden considerarse como funciones dirigidas por eventos y se pueden modificar para cambiar el comportamiento. Otras funciones se llaman directamente desde el archivo XAML. Por ejemplo, para recuperar información de la base de datos de Vault (por ejemplo, esquemas de numeración disponibles, categorías).

Todos los archivos *.ps1 y *.psm1 (módulo de PowerShell) que se encuentran en las carpetas "addinVault" (Vault) o "addins" (CAD) se importan y se utilizan automáticamente.

Nota: Autodesk recomienda utilizar un archivo .ps1 por separado para sus propias funciones.

La siguiente tabla contiene una lista de las funciones que se llaman directamente desde un complemento o desde un archivo XAML. Para mejorar la legibilidad del código, estas funciones pueden llamar a otras funciones. Estas otras funciones no se muestran de forma explícita.

Función	Archivo	Uso del complemento	Uso de XAML	Descripción
ActivateOKButton	Vault: Default.ps1	Vault		Se utiliza para la validación y activación del botón Aceptar en los cuadros de diálogo de edición y creación. Por defecto, llama a la función Validate() que, a continuación, según el tipo de ventana, llama a otras funciones de validación. Debido a que se llama a ActivateOkButton cada vez que se modifican los datos en el cuadro de diálogo, esto puede provocar problemas de rendimiento si las funciones de validación son demasiado complejas.
AddinLoaded	CAD: Default.ps1	CAD		Se llama cuando se ha cargado el complemento de VDS Inventor o AutoCAD.
Addinunloaded	CAD: Default.ps1	CAD		Se llama cuando se ha descargado el complemento de VDS Inventor o AutoCAD.
GetCategories	Vault, CAD: Default.ps1		Vault, CAD	Esta función se utiliza en los cuadros de diálogo de creación de Vault y CAD para mostrar categorías en un cuadro combinado. La implementación por defecto devuelve una lista de todas las categorías de archivo, carpeta o entidad personalizada según el nombre de la ventana. Se utiliza para Propiedades dinámicas. Para cuadros de diálogo de edición de CAD, se devuelve la categoría asignada.
GetNewCustomObjectName	Vault: Default.ps1	Vault		Se llama al hacer clic en el botón Aceptar en el cuadro de diálogo de creación de un objeto personalizado. Esta función devuelve el nombre del nuevo objeto personalizado. La implementación por defecto obtiene el valor de un control del cuadro de diálogo de creación con el nombre CUSTOMOBJECTNAME o de una propiedad especial _GeneratedNumber si los esquemas de numeración de Vault están definidos. Consulte Data Standard y esquemas de numeración para obtener más información.
GetNewFileName	Vault: Default.ps1	Vault		Se llama al hacer clic en el botón Aceptar en el cuadro de diálogo de creación de un archivo. Esta función devuelve el nombre de archivo del nuevo archivo. El valor por defecto de implementación, obtiene el valor desde un cuadro de diálogo de creación de control con el nombre FILENAME o desde una propiedad especial _GeneratedNumber si los esquemas de numeración de Vault están definidos. Consulte Data Standard y esquemas de numeración para obtener más información.
GetNewFolderName	Vault: Default.ps1	Vault		Se llama al hacer clic en el botón Aceptar en el cuadro de diálogo de creación de una carpeta. Esta función devuelve el nombre de la nueva carpeta. La implementación por defecto obtiene el valor de un control del cuadro de diálogo de creación con el nombre FOLDERNAME o de una propiedad especial _GeneratedNumber si los esquemas de numeración de Vault están definidos. Consulte Data Standard y esquemas de numeración para obtener más información.
GetNumSchms	Vault, CAD: Default.ps1		Vault, CAD	Esta función se utiliza en los cuadros de diálogo de creación de un archivo de Vault y CAD para mostrar esquemas de numeración en un cuadro combinado. La implementación por defecto devuelve todos los esquemas de numeración de archivo de Vault activados. El esquema de numeración por defecto es un esquema con el mismo nombre que la categoría seleccionada. Si un esquema no existe con el mismo nombre que la categoría seleccionada, es el esquema por defecto definido en los parámetros de Vault.
GetParentFolderName	Vault: Default.ps1	Vault		Se llama al hacer clic en el botón Aceptar en el cuadro de diálogo de creación de una carpeta. Esta función se puede utilizar para forzar un nombre de carpeta específico al utilizar las funciones Nuevo archivo estándar o Nueva carpeta estándar. Si se devuelve una cadena vacía, se utiliza la carpeta seleccionada.
InitializeTabWindow	Vault: Default.ps1	Vault		Se llama al inicializar las fichas de Data Standard en Vault.
InitializeWindow	Vault: Default.ps1	Vault		Se llama al inicializar los cuadros de diálogo de Data Standard.
ItemTitle	Vault: Default.ps1		Vault	Se utiliza en las fichas para objetos de artículo y ECO. La implementación por defecto devuelve el valor de la propiedad "Título (artículo,CO)" del artículo o ECO. Nota: {Binding Prop[_XLTN_TITLE_ITEM_CO]} no se puede utilizar directamente en el XAML a causa del nombre de la propiedad.
ItemDescription	Vault: Default.ps1		Vault	Se utiliza en las fichas para objetos de artículo y ECO. La implementación por defecto devuelve el valor de la propiedad "Descripción (artículo,CO)" del artículo o ECO. Nota: {Binding Prop[_XLTN_DESCRIPTION_ITEM_CO]} no se puede utilizar directamente en el XAML a causa del nombre de la propiedad.
OnLogOn	Vault: Default.ps1	Vault		Se llama cuando un usuario inicia sesión en un almacén.
OnLogOff	Vault: Default.ps1		Vault	Se llama cuando el usuario cierra sesión.
OnPostCloseDialog	CAD: Default.ps1	CAD		Se llama cuando el cuadro de diálogo Data Standard se cierra haciendo clic en el botón Aceptar y se actualizan las propiedades antes de que el nombre de archivo se haya establecido.
OnTabContextChanged	Vault: Default.ps1	Vault		Se llama cuando cambia el contexto de una ficha personalizada en Vault. Se utiliza para actualizar los datos que se muestran en la ficha.
SetWindowTitle($newFile, $editFile, $name)	Vault, CAD: Default.ps1	Vault, CAD		Se llama desde la función InitializeWindow. Esta función se alimenta con las entradas según CreateMode o EditMode así como si es para File, Folder o CustomObject. El resultado que se devuelve se establece como el título del cuadro de diálogo.

Nota: Los archivos ps1 para los artículos de menú, ubicados en C:\ProgramData\Autodesk\\Extensions\DataStandard\Vault\addinVault\Menus contienen código que no se encuentra en el ámbito de una función de PowerShell. Este código se ejecuta directamente cuando se hace clic en el elemento de menú.