La variable $Prop[] en Data Standard

La variable $Prop[] proporciona acceso a las propiedades de Vault cuando se utiliza en Data Standard para Vault o a las propiedades de CAD cuando se utiliza en Data Standard para CAD. Especificar el nombre de la propiedad entre corchetes [] devuelve un objeto IProperty que se puede utilizar para obtener y definir los valores de propiedad.

Tipo: Common.Wpf.IndexerForwarder, IProperty

Propiedades especiales

Para las propiedades normales, se debe utilizar el nombre de la propiedad.

No obstante, hay propiedades especiales de solo lectura que permiten acceder a información adicional a través de la variable $Prop. Estas propiedades tienen un prefijo de subrayado (_).

Nota: La columna de disponibilidad indica en qué archivos PowerShell se pueden utilizar los objetos. Por ejemplo, cuadro de diálogo de archivo de Vault significa que el código de PowerShell se utiliza en el contexto de un cuadro de diálogo de creación y edición de archivo.

Propiedad especial

Disponibilidad

Descripción

-Categoría

Vault: Archivo, Carpeta, Objeto personalizado

AutoCAD, Inventor

Tipo de valor: cadena

Se establece en la categoría asignada para un objeto de Vault existente.

-CreateMode

Vault: Archivo, Carpeta, Objeto personalizado

AutoCAD, Inventor

Tipo de valor: booleano

Se puede utilizar en funciones de PowerShell para determinar si la ventana Data Standard está en modo de creación. Este es el caso cuando un archivo se guarda por primera vez.

-CopyMode

Inventor, AutoCAD

Tipo de valor: booleano

Se puede utilizar en funciones de PowerShell para determinar si la ventana Data Standard está en modo de copia. Defínala como true para las funciones Copiar y Reemplazar por Copiar de Data Standard.

Nota: Cuando -CopyMode es true, -CreateMode también está establecida en true.

-EditMode

Vault: Archivo, Carpeta, Objeto personalizado

AutoCAD, Inventor

Tipo de valor: booleano

Se puede utilizar en funciones de PowerShell para determinar si la ventana Data Standard está en modo de edición. Se establece en True para la función de Data Standard: hoja de datos.

-Formato

Inventor

Tipo de valor: cadena

Se establece en el formato asignado para un objeto de Inventor o en el primer elemento de ListValues.

Tipo de ListValues: List<cadena> contiene una lista de formatos que dependen del tipo de documento.

  • Para dibujos: PDF, DXF, DWG
  • Para modelos: JT, STEP

-FileExt

Vault: Archivo

AutoCAD, Inventor

Tipo de valor: cadena

Contiene la extensión de archivo.

-FileName

Vault: Archivo

AutoCAD, Inventor

Tipo de valor: cadena

Contiene el nombre de archivo sin extensión.

-FilePath

Vault: Archivo

AutoCAD, Inventor

Tipo de valor: cadena

Contiene la ruta del archivo de Vault (que empieza por $) sin el nombre de archivo.

-FolderName

Vault: Carpeta

Tipo de valor: cadena

Contiene el nombre de la carpeta.

-FolderPath

Vault: Carpeta

Tipo de valor: cadena

Contiene la ruta de la carpeta de Vault (que empieza por $) sin el nombre de archivo.

-GeneratedNumber

Vault: Archivo

Tipo de valor: cadena

Contiene el número generado. El valor se establece mediante DSNumSchemeCtrl. Consulte Numeración para obtener más información.

-OriginalFileName

AutoCAD, Inventor

Tipo de valor: cadena

Contiene el nombre del documento de origen durante un evento de Copiar o Copia con dibujo.

-SaveCopyAsMode

Inventor

Tipo de valor: booleano

El valor se establece en True cuando un usuario de Inventor hace clic en el botón Guardar copia como; de lo contrario, el valor se establece en False.

-SuggestedVaultPath

Inventor

Tipo de valor: cadena

Contiene la ruta del archivo directamente relacionado, por ejemplo, la ruta del ensamblaje principal para los componentes creados en el contexto del ensamblaje o la ruta de la vista de componente principal en los dibujos.

-VaultVirtualPath

Inventor

Tipo de valor: cadena

Contiene la carpeta virtual asignada de Vault tal y como está definida en el archivo de proyecto de Inventor.

-WorkspacePath

Inventor

Tipo de valor: cadena

Contiene la ruta de espacio de trabajo tal y como se haya definido en el archivo de proyecto de Inventor.

Licencias

Cuando el nombre de la propiedad en los corchetes [] se inicia con el prefijo -XLTN- (por ejemplo, $prop["-XLTN-TITLE-ITEM-CO"].Value), el nombre se asigna al nombre de propiedad real de la versión localizada del servidor de Vault. Consulte Localización para obtener más información.

Objeto IProperty

El objeto IProperty es un empaquetador para la propiedad subyacente de Vault o CAD.

Nota: La expresión $prop["Title"] devuelve un objeto IProperty para la propiedad "Título". No devuelve el valor directo de la propiedad.

Propiedades

Nombre

Tipo

Descripción

Valor

objeto

Devuelve el valor de la propiedad. Se puede utilizar para obtener o definir el valor de la propiedad.

IsValid

booleano

Comprueba si la propiedad es válida.

IsInvalid

booleano

Negación de IsValid. Resulta útil porque no es fácil negar valores de XAML.

ListValues

Objeto

Matriz

Solo se utiliza para la propiedad especial "_Category". Devuelve una lista de cadenas.

EnforceListValues

booleano

Obtiene el valor existente si existe o se puede definir para modificarlo.

IsObligatory

booleano

Obtiene el valor existente si existe o se puede definir para modificarlo.

Longitud mínima

entero

Obtiene el valor existente si existe o se puede definir para modificarlo.

MaximumLength

entero

Obtiene el valor existente si existe o se puede definir para modificarlo.

Caso

cadena

Obtiene el valor existente si existe o se puede definir para modificarlo.

MinimumDate

DateTime

Obtiene el valor existente si existe o se puede definir para modificarlo.

MaximumDate

DateTime

Obtiene el valor existente si existe o se puede definir para modificarlo.

Minimumvalue

entero

Obtiene el valor existente si existe o se puede definir para modificarlo.

Maximumvalue

entero

Obtiene el valor existente si existe o se puede definir para modificarlo.

CustomValidation

Scriptblock

Ejecuta scriptblock y devuelve el resultado. El bloque de archivo de comandos debe devolver un valor booleano. Cuando esta variable se define, a continuación, ninguna de las demás restricciones se ejecuta.

CustomValidationErrorMessage

cadena

Cuando el valor CustomValidation anterior es False, cualquier texto definido aquí se mostrará como información de herramientas en el control al que está unido este objeto Prop.

Eventos

Nombre

Descripción

PropertyChanged

Aparece cuando se cambia el valor de una propiedad. Consulte Ejemplo: Utilización de eventos con el cuadro de diálogo Data Standard para ver un ejemplo.

Ejemplos

En PowerShell, se puede acceder a las propiedades con la siguiente sintaxis:

PowerShell

$fileName = $Prop["-FileName"].Value

Se puede acceder al mismo objeto a través de un vínculo XAML. Sin embargo, la sintaxis es ligeramente distinta:

XAML

<TextBox Text="{Binding Prop[-FileName].Value}"/>