fonctions PowerShell pour Data Standard

fonctions PowerShell sont utilisés pour la programmation de personnaliser une logique applicative, le comportement, les valeurs par défaut et de l'interface utilisateur.

Data Standard est fourni avec plusieurs fonctions qui sont nécessaires pour travailler avec les onglets et les boîtes de dialogue standard. Certaines fonctions sont appelées depuis les compléments Data Standard.

Ces fonctions sont obligatoires et ne doivent pas être supprimées.

Les fonctions peuvent être considérées comme des fonctions basées sur des événements que vous pouvez éditer afin d'adapter le comportement. D'autres fonctions sont appelées directement depuis le fichier XAML. Cela peut notamment être le cas en vue d'extraire des informations à partir de la base de données Vault (catégories, schémas de numérotation disponibles, par exemple).

Tous les fichiers *.ps1 et *.psm1 (module PowerShell) figurant dans le dossier "addinVault" (Vault) ou "addins" (CAO) sont automatiquement importés et utilisés.

Remarque : Autodesk vous recommande d'utiliser un fichier .ps1 distinct de vos propres fonctions.

Le tableau suivant présente une liste des fonctions qui sont directement appelées à partir d'un complément ou d'un fichier XAML. Pour une meilleure lisibilité du code, ces fonctions peuvent faire appel à d'autres fonctions. Ces autres fonctions ne sont pas répertoriées explicitement.

Fonction	Fichier	Complément - Utilisation	Fichier XAML - Utilisation	Description
ActivateOKButton	Vault : Default.ps1	Vault		Utilisé pour la validation et l'activation du bouton OK dans les boîtes de dialogue de modification et de création. Par défaut, la fonction Validate() est appellée. Cette dernière, en fonction du type de fenêtre, appelle ensuite d'autres fonctions de validation. Etant donné que la fonction ActivateOkButton est appelée chaque fois que des données sont modifiées dans la boîte de dialogue, cela peut entraîner des problèmes de performances si les fonctions de validation sont trop complexes.
AddinLoaded	CAO : Default.ps1	CAO		Appelée lorsque le complément Inventor ou AutoCAD pour VDS est chargé.
Addinunloaded	CAO : Default.ps1	CAO		Appelée lorsque le complément Inventor ou AutoCAD pour VDS est déchargé.
GetCategories	Vault, CAO : Default.ps1		Vault, CAO	Cette fonction est utilisée dans les boîtes de dialogue de création de Vault et de CAO pour afficher les catégories dans une zone déroulante. L'implémentation par défaut renvoie une liste de toutes les catégories de fichiers, de dossiers ou d'entités personnalisées en fonction du nom de la fenêtre. Utilisée pour les propriétés dynamiques. Pour les boîtes de dialogue de modification de CAO, la catégorie affectée est renvoyée.
GetNewCustomObjectName	Vault : Default.ps1	Vault		Appelée lorsque l'utilisateur clique sur le bouton OK dans la boîte de dialogue de création d'objet personnalisé. Cette fonction renvoie le nom du nouvel objet personnalisé. L'implémentation par défaut extrait la valeur à partir d'une boîte de dialogue de création avec le nom CUSTOMOBJECTNAME ou à partir d'une propriété spéciale _GeneratedNumber si des schémas de numérotation de Vault ont été définis. Pour en savoir plus, reportez-vous à la rubrique Data Standard et schémas de numérotation.
GetNewFileName	Vault : Default.ps1	Vault		Appelée lorsque l'utilisateur clique sur le bouton OK dans la boîte de dialogue de création de fichier. Cette fonction renvoie le nom du nouveau fichier. L'implémentation par défaut extrait la valeur à partir d'une option de la boîte de dialogue de création avec le nom FILENAME ou à partir d'une propriété spéciale _GeneratedNumber si des schémas de numérotation de Vault ont été définis. Pour en savoir plus, reportez-vous à la rubrique Data Standard et schémas de numérotation.
GetNewFolderName	Vault : Default.ps1	Vault		Appelée lorsque l'utilisateur clique sur le bouton OK dans la boîte de dialogue de création de dossier. Cette fonction renvoie le nom du nouveau dossier. L'implémentation par défaut extrait la valeur à partir d'une option de la boîte de dialogue de création avec le nom FOLDERNAME ou à partir d'une propriété spéciale _GeneratedNumber si des schémas de numérotation de Vault ont été définis. Pour en savoir plus, reportez-vous à la rubrique Data Standard et schémas de numérotation.
GetNumSchms	Vault, CAO : Default.ps1		Vault, CAO	Cette fonction est utilisée dans les boîtes de dialogue de création de fichier de Vault et de CAO pour afficher les schémas de numérotation dans une zone déroulante. L'implémentation par défaut renvoie tous les schémas de numérotation de fichiers de Vault activés. Le schéma de numérotation par défaut est un schéma portant le même nom que la catégorie sélectionnée. S'il n'existe aucun schéma portant le même nom que la catégorie sélectionnée, le schéma est le schéma par défaut défini dans les paramètres de Vault.
GetParentFolderName	Vault : Default.ps1	Vault		Appelée lorsque l'utilisateur clique sur le bouton OK dans la boîte de dialogue de création de dossier. Cette fonction peut être utilisée pour forcer l'application d'un nom de dossier spécifique lors de l'utilisation de la fonction Nouveau fichier de normes ou Nouveau dossier standard. Si une chaîne vide est renvoyée, le dossier sélectionné est utilisé.
InitializeTabWindow	Vault : Default.ps1	Vault		Appelée lors de l'initialisation des onglets Data Standard dans Vault.
InitializeWindow	Vault : Default.ps1	Vault		Appelée lors de l'initialisation des boîtes de dialogue Data Standard.
ItemTitle	Vault : Default.ps1		Vault	Utilisée dans les onglets des objets de type Article et OMT. L'implémentation par défaut renvoie la valeur de la propriété "Title (item,CO)" de l'article ou de l'OMT. Remarque : L'élément {Binding Prop[_XLTN_TITLE_ITEM_CO]} ne peut pas être utilisé directement dans le fichier XAML en raison du nom de la propriété.
ItemDescription	Vault : Default.ps1		Vault	Utilisée dans les onglets des objets de type Article et OMT. L'implémentation par défaut renvoie la valeur de la propriété "Description (item,CO)" de l'article ou de l'OMT. Remarque : L'élément {Binding Prop[_XLTN_DESCRIPTION_ITEM_CO]} ne peut pas être utilisé directement dans le fichier XAML en raison du nom de la propriété.
OnLogOn	Vault : Default.ps1	Vault		Appelée lorsque l'utilisateur se connecte à un coffre-fort.
OnLogOff	Vault : Default.ps1		Vault	Appelée lorsque l'utilisateur se déconnecte.
OnPostCloseDialog	CAO : Default.ps1	CAO		Appelée lorsque les boîtes de dialogue Data Standard sont fermées en cliquant sur le bouton OK et avant la mise à jour des propriétés associées au fichier défini.
OnTabContextChanged	Vault : Default.ps1	Vault		Appelée lorsque le contexte d'un onglet personnalisé dans Vault est modifié. Permet de mettre à jour les données affichées dans l'onglet.
SetWindowTitle($newFile, $editFile, $name)	Vault, CAO : Default.ps1	Vault, CAO		Appelée à partir de la fonction InitializeWindow. Cette fonction est alimentée avec des entrées qui varient selon que le mode CreateMode ou EditMode est utilisé, ainsi que si elle est destinée à l'élément File, Folder ou CustomObject. La sortie qui est renvoyée devient le titre de la boîte de dialogue.

Remarque : Les fichiers ps1 des éléments de menu (disponibles à l'emplacement suivant : C:\ProgramData\Autodesk\<version de Vault>\Extensions\DataStandard\Vault\addinVault\Menus) contiennent du code qui n'entre pas dans le cadre d'une fonction PowerShell. Ce code est exécuté directement lorsque l'utilisateur clique sur l'élément de menu.