Anpassen der Data Standard-Datei MenuDefinitions.xml

Fügen Sie weitere Data Standard-Menüelemente zur Vault Client-Schnittstelle hinzu, oder unterdrücken Sie mithilfe der Datei MenuDefinitions.xml bestimmte Befehle.

Vorgegebene Data Standard-Menüoptionen

Wenn Sie Autodesk Vault Data Standard installiert haben, werden nach dem Neustart des Vault Client zusätzliche Menübefehle verfügbar.

Neue Standard-Datei
Neuer Standard-Ordner
Info über Autodesk Vault Data Standard (im Hilfe-Menü)

Anmerkung: Weitere Informationen finden Sie in der Data Standard Benutzerhilfe.

Alle Data Standard-Menüanpassungen in Vault Client sind in der Datei MenuDefinitions.xml definiert, die sich unter %programdata%\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault befindet.

Anmerkung: Sie müssen die Vault-Werkzeugkästen zurücksetzen, nachdem Vault Client zum ersten Mal nach der Installation von Data Standard neu gestartet wurde, oder nachdem Änderungen an der DateiMenuDefinitions.xml vorgenommen wurden.

Dateielemente

Das Format der Konfigurationsdateien ist XML. Verwenden Sie einen Texteditor oder einen XML-Editor zum Ändern von Elementwerten in der Datei.

Die Datei MenuDefinitions.xml verfügt über drei Komponenten der obersten Ebene:

Menüelement (MenuItem)
Befehls-Sites (CommandSite)
Unterdrückte Menüelemente (SuppressMenuItems)

Menüelemente

Zuerst muss jeder Befehl definiert werden. Dies kann mithilfe der Komponente MenuItem erfolgen.

Enthält ein oder mehrere <Befehlsname>-Elemente.

<Befehlsname> - Eindeutiger Name für den Befehl. Dieser Name wird in einer CommandSite-Komponente verwendet.

Beispiel für eine neue Standard-Datei

<MenuItem>
<NewTask Label="$UIString[MNU22]" Description="$UIString[MNU17]" Hint="$UIString[MNU18]"
PSFile="CreateCustomObject.ps1" Image="NewCustomObject.ico" ToolbarPaintStyle="TextAndGlyph"
NavigationTypes="Task" MultiSelectEnabled="False" />
<EditTask Label="$UIString[MNU21]" Description="$UIString[MNU19]" Hint="$UIString[MNU20]"
PSFile="EditCustomObject.ps1" Image="EditCustomObject.ico" ToolbarPaintStyle="TextAndGlyph"
NavigationTypes="Task" MultiSelectEnabled="False" />
<NewFile Label="$UIString[MNU1]" Description="$UIString[MNU11]" Hint="$UIString[MNU7]" PSFile="CreateFile.ps1"
Image="NewStandardFile.ico" ToolbarPaintStyle="TextAndGlyph" NavigationTypes="File,Folder"
MultiSelectEnabled="False" />
<EditFile Label="$UIString[MNU2]" Description="$UIString[MNU12]" Hint="$UIString[MNU8]" PSFile="EditFile.ps1"
Image="EditFileDatasheet.ico" ToolbarPaintStyle="TextAndGlyph" NavigationTypes="File"
MultiSelectEnabled="False" />
<NewFolder Label="$UIString[MNU3]" Description="$UIString[MNU13]" Hint="$UIString[MNU9]" PSFile="CreateFolder.ps1"
Image="NewStandardFolder.ico" ToolbarPaintStyle="TextAndGlyph" NavigationTypes="Folder"
MultiSelectEnabled="False" />
<EditFolder Label="$UIString[MNU4]" Description="$UIString[MNU14]" Hint="$UIString[MNU10]" PSFile="EditFolder.ps1"
Image="EditFolderDatasheet.ico" ToolbarPaintStyle="TextAndGlyph" NavigationTypes="Folder"
MultiSelectEnabled="False" />
<ShowLog Label="$UIString[MNU5]" Description="$UIString[MNU15]" Hint="$UIString[MNU5]" PSFile="ShowLog.ps1"
Image="Log.ico" ToolbarPaintStyle="TextAndGlyph" MultiSelectEnabled="False" />
<AboutDialog Label="$UIString[MNU6]" Description="$UIString[MNU16]" Hint="$UIString[MNU6]"
PSFile="ShowAboutDialog.ps1" Image="About.ico" ToolbarPaintStyle="TextAndGlyph"
MultiSelectEnabled="False" />
</MenuItem>

Die verfügbaren Attribute für das MenuItem-Element <Befehlsname> sind in der folgenden Tabelle aufgelistet.

Attribut	Erforderlich	Gültige Werte	Beschreibung
Label	Ja	Zeichen und Zahlen	Im Menü angezeigter Text
Beschreibung	Ja	Zeichen und Zahlen	Enthält weitere Details zur Funktion eines Befehls.
Hinweis	Ja	Zeichen und Zahlen	Text der QuickInfo oder des Befehls
PSFile	Ja	PowerShell (PS1)-Dateiname	Name der PowerShell-Datei, die das Skript enthält, das ausgeführt werden soll, wenn der Menübefehl aufgerufen wird.
Bild	Nein	Das Bild muss die Größe 16 x 16 oder 32 x 32 haben.	Name des Bitmap-Bilds für den Menübefehl. Die Datei muss sich in demselben Ordner wie MenuDefinitions.xml befinden.
ToolbarPaintStyle	Nein	Text, Glyph und TextandGlyph	Steuert, wie der Befehl in einem Werkzeugkasten angezeigt wird.
NavigationTypes	Nein	Stückliste, Änderungsauftrag, Datei, FileVersion, Ordner, Artikel, Andere	Durch Kommas getrennte Liste der Objekttypen, für die dieser Befehl verfügbar ist.
MultiSelectEnabled	Nein	True oder False	Wenn False, wird der Befehl nur aktiviert, wenn ein einzelnes Element ausgewählt wird.

Anmerkung: Für die Variablen Beschreibung, Hinweis und Beschriftung kann die Zeichenfolgesyntax der Benutzeroberfläche verwendet werden. Weitere Informationen finden Sie unter Lokalisierung.

Befehls-Sites

Enthält ein oder mehrere <Befehls-Site-Namen>-Elemente.

Geben Sie über die Befehls-Sites an, in welchem Menü die definierten Menübefehle angezeigt werden sollen. Befehls-Sites können mit Site-Komponenten definiert werden.

Beispiel für das Datei-Kontextmenü:

<CommandSite>
<FileContext Label="myMenu" DeployAsPullDown="False" Location="FileContextMenu">
<Item Name="NewFile"></Item>
<Item Name="EditFile"></Item>
</FileContext>
<FolderContex Label="myMenu" DeployAsPullDown="False" Location="FolderContextMenu">
<Item Name="NewFile"></Item>
<Item Name="NewFolder"></Item>
<Item Name="EditFolder"></Item>
</FolderContex>
<StandardToolbar Label="myMenu" DeployAsPullDown="False" Location="StandardToolbar">
<Item Name="NewFile"></Item>
<Item Name="EditFile"></Item>
</StandardToolbar>
<ToolsMenu Label="myMenu" DeployAsPullDown="False" Location="ToolsMenu">
<Item Name="ShowLog"></Item>
</ToolsMenu>
<HelpMenu Label="myMenu" DeployAsPullDown="False" Location="HelpMenu">
<Item Name="AboutDialog"></Item>
</HelpMenu>
<Task Label="Task" DeployAsPullDown="False" Location="Task">
<Item Name="NewTask"></Item>
<Item Name="EditTask"></Item>
</Task>
</CommandSite>

Die verfügbaren Attribute für das CommandSite-Element <Befehls-Site-Name> sind in der folgenden Tabelle aufgelistet.

Attribut	Erforderlich	Gültige Werte	Beschreibung
Label	Nein	Zeichen und Zahlen	Im Pulldown-Menü angezeigter Text. Bei Nichtvorhandensein wird "mymenu" verwendet.
DeployAsPullDown	Nein	True oder False	Wenn True, wird das Pulldown-Menü im Kontextmenü mit der oben definierten Bezeichnung erstellt.
Position	Ja	Zeichen und Zahlen	Text, der die QuickInfo für den Befehl darstellt.

Das CommandSite-Element enthält einen oder mehrere <Artikel>, die den Elementen entsprechen, die in den MenuItem-Elementen festgelegt wurden.

Das einzige Attribut für das <Artikel>-Element ist Name.

Attribut	Erforderlich	Gültige Werte	Beschreibung
Name	Ja	Name des in den MenuItem-Elementen definierten Elements.	Name des in den MenuItem-Elementen definierten Elements

Unterdrückte Menüelemente

Vorgabemäßig ist der Befehl Neuer Ordner nicht mehr im Menü Datei und im Kontextmenü enthalten, wenn Data Standard installiert ist. Administratoren können weitere vorgegebene Befehle aus der Vault-Benutzeroberfläche entfernen, indem sie den Abschnitt SuppressMenuItems in der Datei MenuDefinitions.xml ändern.

<SuppressMenuItems>
NewFolder,NewFolderGroupMenu,NewFolderGroupButton,NewFolderForContextMenus
</SuppressMenuItems>

Die Befehlsnamen sind durch ein Komma getrennt.

Beispiel:

Um den Befehl Neuer Bibliotheksordner zu unterdrücken, fügen Sie der Liste SuppressMenuItems die folgenden beiden Befehle hinzu: NewLibraryFolder, NewLibraryFolderForContextMenus.
Um den Befehl Ordner umbenennen zu unterdrücken, fügen Sie den folgenden Befehl hinzu: Folder.Rename.
Rückgängigmachen unterdrückter Befehle:
1. Um einen Befehl nicht mehr zu unterdrücken, entfernen Sie den entsprechenden Befehlsnamen aus dem Abschnitt suppressMenuItems.
2. Starten Sie Vault neu, um die Änderungen anzuzeigen.