Verwalten von benutzerdefinierten Data Standard-Objekten

Konfigurieren der Dialogfelder und Registerkarten für die Erstellung, um benutzerdefinierte Objektdaten anzuzeigen.

Anforderungen

Für die Unterstützung von benutzerdefinierten Objekten sind drei Komponenten erforderlich:

• Menüeinträge für das Erstellungs- und Bearbeitungsdialogfeld
• Dialogfelddateien (XAML) für die Dialogfelder und Registerkarten
• Skriptdateien (PowerShell) für die Dialogfeldlogik

Verwenden des vorkonfigurierten benutzerdefinierten Objekts Task

Alle drei Komponenten sind vorgabemäßig im Lieferumfang von Data Standard enthalten. Diese Komponenten sind darauf vorkonfiguriert, mit einem benutzerdefinierten Objekt in Vault mit dem Namen Task zusammenzuarbeiten.

Anmerkung: Die Kontextmenü-Unterstützung für benutzerdefinierte Objekte ist nur verfügbar, wenn ein benutzerdefiniertes Objekt vorhanden ist.

1. Erstellen Sie über die Vault-Konfiguration eine Definition für das benutzerdefinierte Objekt, und nennen Sie es Task.
   Anmerkung: Weitere Informationen finden Sie unter Verwalten von benutzerdefinierten Objekten.
2. Weisen Sie die Eigenschaften Title und Description der Kategorie Base zu.
3. Starten Sie den Vault Explorer neu, und melden Sie sich zweimal bei Vault an:
   • Wenn Sie sich zum ersten Mal anmelden, überprüfen Sie, ob der Objekttyp Task im Vault Client verfügbar ist.
   • Melden Sie sich ab, und melden Sie sich ein zweites Mal an, um die Registerkarte Datenblatt und die Menüelemente zu initialisieren, um so Aufgaben zu erstellen und zu bearbeiten.

   Das neue benutzerdefinierte Objekt Task ist nun vollständig initialisiert und kann verwendet werden.

4. Erstellen Sie mit dem Befehl Neu ein neues benutzerdefiniertes Objekt, und geben Sie ihm einen beliebigen Namen.
5. Klicken Sie mit der rechten Maustaste auf das neue benutzerdefinierte Objekt. Im Kontextmenü werden nun die Menüoptionen Neue Aufgabe und Aufgabe bearbeiten angezeigt.

Anmerkung: Wenn Sie sich das erste Mal anmelden, nachdem ein neues benutzerdefiniertes Objekt definiert wurde, wird die Datei CustomEntityDefinitions.json (%programdata%\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault) erstellt. Die Definition in der Datei wird verwendet, um die Registerkarte und die Menüelemente für die benutzerdefinierten Objekte zu initialisieren. Diese Datei sollte nicht manuell bearbeitet werden. Um zu vermeiden, dass sich Benutzer mehrmals anmelden müssen, kann die Datei bereitgestellt werden. Wenn Sie benutzerdefinierte Objekte nicht initialisieren können, kann die Datei gelöscht werden. Sie wird das nächste Mal, wenn Sie sich bei einem Tresor anmelden, erstellt.

Konfigurieren zusätzlicher benutzerdefinierter Objekte

Um Ihr eigenes benutzerdefiniertes Objekt zu definieren, kopieren Sie die drei Komponenten aus dem Task-Beispiel und nehmen die erforderlichen Änderungen vor.

Im Folgenden sind Beispiele eines benutzerdefinierten Objekts mit der Bezeichnung Person angegeben.

Menüeinträge

Die Kontextmenüeinträge zum Erstellen und Bearbeiten eines Dialogfelds sind hier definiert:

%programdata%\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault\MenuDefinitions.xml

Die Menüeintrag-Definitionen müssen erstellt werden:

1. Kopieren Sie die Definitionen (MenuItem NewTask, MenuItem EditTask) aus dem Task-Beispiel.
2. Ersetzen Sie in allen Variablen Task durch Person.
3. Ändern Sie die Beschreibungs-, Hinweis-, Beschriftungs- und Navigationstypen.
   Anmerkung: Für diese Variablen kann die UIString-Syntax im ursprünglichen Beispiel verwendet werden. Weitere Informationen finden Sie unter Lokalisierung.

	<NewTask Label="CreatePerson..." 
			 Description="New Person"
    Hint="Create a new person object" 
    PSFile="CreateCustomObject.ps1"
    Image="NewCustomObject.ico"
    ToolbarPaintStyle="TextAndGlyph"
    NavigationTypes="Person"
    MultiSelectEnabled="false"/>

   <EditTaskLabel="Edit Person..." 
    Description="Edit Person"
    Hint="Edit a person object"
    PSFile="EditCustomObject.ps1"
    Image="EditCustomObject.ico"
    ToolbarPaintStyle="TextandGlyph"
    NavigationTypes="Task"
    MultiSelectEnabled="False"/>
  

Als Nächstes erstellen Sie eine Menü-Site für das neue benutzerdefinierte Objekt.

1. Kopieren Sie die Site (CommandSite-Task) aus dem Task-Beispiel.
2. Ersetzen Sie in allen Variablen Task durch Person.

<TaskLabel="Person"
         DeployAsPullDown="False"
         Location="Person">
         <ItemName="NewPerson">
									</Item>
         <ItemName="EditPerson">
          </Item>

Weitere Informationen zur Menüsyntax finden Sie unter Anpassen der Data Standard-Datei MenuDefiniftions.xml.

Skriptdateien

Die Menüdefinitionen in der Datei MenuDefinitions.xml verweisen auf PowerShell-Dateien. Diese Dateien befinden sich unter %programdata%\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault\addinVault\Menus.

Die vorgegebenen PowerShell-Dateien CreateCustomObject.ps1 und EditCustomObject.ps1 können für jedes benutzerdefinierte Objekt verwendet werden. Es ist nicht erforderlich, zusätzliche PowerShell-Dateien zu erstellen. Es ist jedoch möglich, PowerShell-Dateien für das neue benutzerdefinierte Objekt anzupassen und zu erstellen, indem Sie die folgenden Aufgaben ausführen:

1. Kopieren Sie die CreateCustomObject.ps1- und EditCustomObject.ps1-Menüdefinitionsdateien, und benennen Sie sie in CreatePerson.ps1 und EditPerson.ps1 um.
2. Ähnlich wie andere Skripts verweisen die Skripts zum Erstellen und Bearbeiten von benutzerdefinierten Objekten auf eine zugehörige XAML-Datei.

   Ändern Sie den Namen der XAML-Datei, die das Data Standard-Dialogfeld definiert, indem Sie Task durch Person ersetzen.

   ...
   $xamlFile = New-Object CreateObject.WPF.XamlFile "PersonXaml", "%ProgramData%\Autodesk\Vault 2016\Extensions\DataStandard\Vault\Configuration\Person.xaml"
   $dialog.XamlFile = $xamlFile
   ...

Dialogfelder und Registerkarten

Die XAML-Datei für das Erstellungs- und Bearbeitungsdialogfeld des benutzerdefinierten Objekts wird in den PowerShell-Dateien angegeben (siehe oben). Vorgabemäßig befinden sich die XAML-Dateien für die Erstellungs- und Bearbeitungsdialogfelder sowie die Registerkarten hier:

%programdata%\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault\Configuration

Die vorgegebene CustomObject.xaml funktioniert ohne Änderungen. Sie müssen allerdings die CustomObject.xaml-Datei als eine Vorlage zum Erstellen einer XAML-Datei für ein neues benutzerdefiniertes Objekt verwenden.

1. Kopieren Sie die CustomObject.xaml-Datei, und nennen Sie sie Person.xaml.
2. Ändern Sie die neue XAML-Datei, indem Sie die folgenden Schritte durchführen:
   • Ersetzen Sie alle Vorkommen von TaskWindow durch PersonWindow.
   • Korrigieren Sie den Dialogfeldtitel, indem Sie New Person und Edit Person Datasheet in der Datei UiStrings.xml hinzufügen und die IDs durch die IDs für die neuen Textzeichenfolgen UIString[LBL61] und UIString[LBL62] ersetzen.
   • Fügen Sie nach Bedarf Eigenschaftssteuerelemente hinzu oder entfernen diese.
3. Ändern Sie die folgenden Funktionen unter %programdata%\Autodesk\<Vault-Version>\Extensions\DataStandard\Vault\addinVault\Default.ps1, indem Sie Folgendes konfigurieren:
   • InitializeWindow zum Steuern der Größe des Dialogfelds
   • GetCategories zur Unterstützung von dynamischen Eigenschaften basierend auf Kategorien
   • Validate zum Implementieren von Validierungsregeln

Erstellen einer Datenblatt-Registerkarte für das neue benutzerdefinierte Objekt

1. Kopieren Sie den Task-Ordner, und geben Sie ihm den Namen Person.
2. Falls erforderlich, aktualisieren Sie die Datei Datasheet.xaml im Person-Ordner (z. B. Eigenschaften hinzufügen oder entfernen).