PowerShell-Funktionen für Data Standard

PowerShell-Funktionen werden verwendet, um im Programm anpassen Geschäftslogik, Verhalten, die Vorgabewerte und die Benutzeroberfläche.

Data Standard enthält verschiedene Funktionen, die erforderlich sind, um mit den vorgegebenen Dialogfeldern und Registerkarten zu arbeiten. Einige Funktionen werden innerhalb des Data Standard-Zusatzmoduls aufgerufen.

Diese Funktionen sind erforderlich und dürfen nicht entfernt werden.

Die Funktionen sind ereignisgesteuert und können geändert werden, um das Verhalten zu ändern. Andere Funktionen werden direkt aus der XAML-Datei heraus aufgerufen, beispielsweise, um Informationen aus der Vault-Datenbank (z. B. verfügbare Nummernschemata, Kategorien) abzurufen.

Alle Dateien mit den Endungen *.ps1 und *.psm1 (PowerShell-Modul), die sich in den Ordnern "addinVault" (Vault) oder "addins" (CAD) befinden, werden automatisch importiert und verwendet.

Anmerkung: Autodesk empfiehlt die Verwendung einer separaten .ps1-Datei für Ihre eigenen Funktionen.

Die folgende Tabelle enthält eine Liste der Funktionen, die direkt über ein Zusatzmodul oder aus einer XAML-Datei heraus aufgerufen werden. Für eine bessere Lesbarkeit des Codes rufen diese Funktionen möglicherweise weitere Funktionen auf. Diese Funktionen werden nicht explizit aufgeführt.

Funktion	Datei	Verwendung Zusatzmodul	Verwendung XAML	Beschreibung
ActivateOKButton	Vault: Default.ps1	Vault		Wird für die Validierung und Aktivierung der Schaltfläche OK in den Dialogfeldern Bearbeiten und Erstellen verwendet. Vorgabemäßig wird die Funktion Validate() aufgerufen, die dann abhängig vom Fenstertyp weitere Prüffunktionen aufruft. Da ActivateOkButton jedes Mal aufgerufen wird, wenn Sie Daten im Dialogfeld ändern, können Probleme auftreten, wenn die Prüffunktionen zu komplex sind.
AddinLoaded	CAD: Default.ps1	CAD		Wird aufgerufen, wenn das VDS Inventor- oder AutoCAD-Zusatzmodul geladen wird.
Addinunloaded	CAD: Default.ps1	CAD		Wird aufgerufen, wenn das VDS Inventor- oder AutoCAD-Zusatzmodul entfernt wird.
GetCategories	Vault, CAD: Default.ps1		Vault, CAD	Diese Funktion wird für die Erstellung von Dialogfeldern für Vault und CAD verwendet, um Kategorien in einem Kombinationsfeld anzuzeigen. Die vorgegebene Implementierung gibt eine Liste aller Kategorien für Dateien, Ordner oder benutzerdefinierte Elemente auf Grundlage des Fensternamens zurück. Wird für dynamische Eigenschaften verwendet. Für CAD-Bearbeitungsdialogfelder wird die zugewiesene Kategorie zurückgegeben.
GetNewCustomObjectName	Vault: Default.ps1	Vault		Wird beim Klicken auf die Schaltfläche OK aufgerufen, um ein benutzerdefiniertes Objekt zu erstellen. Diese Funktion gibt den Namen des neuen benutzerdefinierten Objekts zurück. Die vorgegebene Implementierung ruft den Wert entweder aus einem Erstellungsdialogfeld-Steuerelement mit dem Namen CUSTOMOBJECTNAME oder über eine spezielle Eigenschaft _GeneratedNumber ab, wenn Vault-Nummernschemata definiert sind. Weitere Informationen finden Sie unter Data Standard und Nummernschemata.
GetNewFileName	Vault: Default.ps1	Vault		Wird beim Klicken auf die Schaltfläche OK im Dialogfeld Datei erstellen aufgerufen. Diese Funktion gibt den Namen der neuen Datei zurück. Die vorgegebene Implementierung ruft den Wert entweder aus einem Erstellungsdialogfeld-Steuerelement mit dem Namen FILENAME oder über eine spezielle Eigenschaft _GeneratedNumber ab, wenn Vault-Nummernschemata definiert sind. Weitere Informationen finden Sie unter Data Standard und Nummernschemata.
GetNewFolderName	Vault: Default.ps1	Vault		Wird beim Klicken auf die Schaltfläche OK im Dialogfeld Ordner erstellen aufgerufen. Diese Funktion gibt den Namen für den neuen Ordner zurück. Die vorgegebene Implementierung ruft den Wert entweder aus einem Erstellungsdialogfeld-Steuerelement mit dem Namen FOLDERNAME oder über eine spezielle Eigenschaft _GeneratedNumber ab, wenn Vault-Nummernschemata definiert sind. Weitere Informationen finden Sie unter Data Standard und Nummernschemata.
GetNumSchms	Vault, CAD: Default.ps1		Vault, CAD	Diese Funktion wird in Dialogfeldern für die Dateierstellung für Vault und CAD verwendet, um Nummernschemata in einem Kombinationsfeld anzuzeigen. Die vorgegebene Implementierung gibt alle aktivierten Nummernschemata für Vault-Dateien zurück. Das vorgegebene Nummernschema ist ein Schema mit demselben Namen wie die ausgewählte Kategorie. Existiert kein Schema mit demselben Namen wie die ausgewählte Kategorie, wird der in den Vault-Einstellungen vorgegebene Schemasatz verwendet.
GetParentFolderName	Vault: Default.ps1	Vault		Wird beim Klicken auf die Schaltfläche OK im Dialogfeld Ordner erstellen aufgerufen. Diese Funktion kann verwendet werden, um einen bestimmten Ordnernamen bei der Verwendung von Neue Standard-Datei oder Neuer Standard-Ordner zu erzwingen. Wenn eine leere Zeichenfolge zurückgegeben wird, so wird der ausgewählte Ordner verwendet.
InitializeTabWindow	Vault: Default.ps1	Vault		Wird bei der Initialisierung von Data Standard-Registerkarten in Vault aufgerufen.
InitializeWindow	Vault: Default.ps1	Vault		Wird beim Initialisieren der Data Standard-Dialogfelder aufgerufen.
ItemTitle	Vault: Default.ps1		Vault	Wird auf den Registerkarten für Artikel und Änderungsaufträge verwendet. Die vorgegebene Implementierung gibt den Artikel- oder Änderungsauftragswert für die Eigenschaft "Title (item,CO)" zurück. Anmerkung: {Binding Prop[_XLTN_TITLE_ITEM_CO]} kann wegen des Eigenschaftsnamens nicht direkt aus der XAML-Datei heraus verwendet werden.
ItemDescription	Vault: Default.ps1		Vault	Wird auf den Registerkarten für Artikel und Änderungsaufträge verwendet. Die vorgegebene Implementierung gibt den Artikel- oder Änderungsauftragswert für die Eigenschaft "Description (item,CO)" zurück. Anmerkung: {Binding Prop[_XLTN_DESCRIPTION_ITEM_CO]} kann wegen des Eigenschaftsnamens nicht direkt aus der XAML-Datei heraus verwendet werden.
OnLogOn	Vault: Default.ps1	Vault		Wird bei der Anmeldung eines Benutzers bei einem Tresor aufgerufen.
OnLogOff	Vault: Default.ps1		Vault	Wird bei der Abmeldung eines Benutzers aufgerufen.
OnPostCloseDialog	CAD: Default.ps1	CAD		Wird aufgerufen, wenn die Data Standard-Dialogfelder durch Klicken auf die Schaltfläche OK geschlossen werden, und bevor der Dateiname in den Eigenschaften festgelegt ist und diese aktualisiert werden.
OnTabContextChanged	Vault: Default.ps1	Vault		Wird beim Ändern einer benutzerdefinierten Registerkarte in Vault aufgerufen. Wird zum Aktualisieren der auf der Registerkarte angezeigten Daten verwendet.
SetWindowTitle($newFile, $editFile, $name)	Vault, CAD: Default.ps1	Vault, CAD		Wird über die Funktion InitializeWindow aufgerufen. Diese Funktion erhält die Eingaben abhängig von CreateMode oder EditMode. Ebenfalls eine Rolle spielt die Bestimmung: File, Folder oder CustomObject. Die zurückgegebene Ausgabe wird als Titel des Dialogfelds eingestellt.

Anmerkung: Die ps1-Dateien für die Menüelemente in C:\ProgramData\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault\addinVault\Menus enthalten Code, der nicht im Rahmen einer PowerShell-Funktion ausgeführt wird. Dieser Code wird direkt durch Klicken auf das Menüelement ausgeführt.