Správa uživatelských objektů nástroje Data Standard

Je možné nakonfigurovat dialogy vytvoření a karty tak, aby zobrazovaly data uživatelských objektů.

Požadavky

K podpoře uživatelských objektů jsou potřeba tři komponenty:

• položky nabídek pro dialog vytváření a úprav,
• soubory dialogů (XAML) pro dialogy a karty,
• soubory skriptů (PowerShell) pro logiku dialogů.

Použití předkonfigurovaného uživatelského objektu Task

Všechny tři komponenty se dodávají s nástrojem Data Standard. Tyto komponenty jsou předem konfigurované k práci s uživatelským objektem v úložišti Vault, který má název Task.

1. Pomocí nástrojů pro konfiguraci úložiště Vault vytvořte uživatelský objekt a nazvěte jej Task.

   Poznámka: Další informace naleznete v části Správa uživatelských objektů.

2. Vlastnosti Název a Popis zařaďte do kategorie Základní.

3. Restartujte aplikaci Vault Explorer a dvakrát se přihlaste k aplikaci Vault:

   • Při prvním přihlášení zkontrolujte, zda je typ objektu Task dostupný v aplikaci Vault Client.
   • Odhlaste se, znovu se přihlaste, aby se inicializovala karta Datový list a položky nabídek k vytváření a úpravám objektů Task.

   Nový uživatelský objekt Task je plně inicializován a připraven k použití.

4. Pomocí příkazu Nový vytvořte vlastní uživatelský objekt s libovolným názvem.

5. Klikněte na nový uživatelský objekt pravým tlačítkem. V místní nabídce se nyní zobrazují položky Nová úloha a Upravit úlohu.

Konfigurace dalších uživatelských objektů

Chcete-li definovat svůj vlastní uživatelský objekt, zkopírujte tři komponenty z ukázky objektu Task a podle potřeby je upravte.

Níže je uveden příklad uživatelského objektu s názvem Person (Osoba).

Položky nabídek

Položky místních nabídek dialogu úprav a vytváření jsou definovány v tomto souboru:

%programdata%\Autodesk\<verze aplikace Vault>\Extensions\DataStandard\Vault\MenuDefinitions.xml

Definice položek nabídek jen nutné vytvořit:

1. Zkopírujte definice (MenuItem NewTask, MenuItem EditTask) z příkladu objektu Task.

2. Nahraďte objekt Task objektem Person.

3. Upravte popis, nápovědu, štítek a typy navigace.

   Poznámka: Pro tyto proměnné lze použít původní syntaxi objektu UIString v příkladu. Další informace naleznete v tématu Lokalizace.

   <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"/>
   

   Dále vytvořte umístění nabídky nového uživatelského objektu.

   1. Zkopírujte umístění (CommandSite Task) z příkladu objektu Task.

   2. Nahraďte objekt Task objektem Person.

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

Podrobnější informace o syntaxi nabídek naleznete v tématu Přizpůsobení souboru MenuDefinitions.xml nástroje Data Standard.

Soubory skriptů

Definice nabídek v souboru MenuDefinitions.xml odkazují na soubory prostředí PowerShell. Tyto soubory jsou umístěny ve složce %programdata%\Autodesk\<verze aplikace Vault>\Extensions\DataStandard\Vault\addinVault\Menus.

Výchozí soubory prostředí PowerShell CreateCustomObject.ps1 a EditCustomObject.ps1 lze použít pro každý uživatelský objekt. Není nutné vytvářet další soubory prostředí PowerShell. Stále je však možné následujícím způsobem pro nový uživatelský objekt přizpůsobovat a vytvářet soubory prostředí PowerShell:

1. Zkopírujte soubory definic nabídek CreateCustomObject.ps1 a EditCustomObject.ps1 a změňte jejich názvy na CreatePerson.ps1 a EditPerson.ps1.

2. Podobně jako ostatní skripty i skripty pro vytváření a úpravy uživatelských objektů odkazují na související soubor XAML.

   V názvu souboru XAML, který definuje dialog nástroje Data Standard, nahraďte text Task textem Person.

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

Dialogy a karty

Soubor XAML pro dialog vytváření a úprav uživatelského objektu je definován v souborech prostředí PowerShell (viz výše). Ve výchozím nastavení jsou soubory XAML dialogů vytváření a úprav a karet umístěny zde:

%programdata%\Autodesk\<Vault verze>\Extensions\DataStandard\Vault\Configuration

Výchozí soubor CustomObject.xaml lze používat bez jakýchkoliv změn. Jako šablonu k vytvoření souboru XAML nového uživatelského objektu je však nutné použít soubor CustomObject.xaml.

1. Zkopírujte soubor CustomObject.xaml a změňte jeho název na Person.xaml.

2. Pomocí následujících kroků nový soubor XAML upravte:

   • Nahraďte všechny výskyty textu TaskWindow textem PersonWindow.
   • Opravte název dialogu přidáním hodnot Nová osoba a Upravit datový list osoby do souborů UiStrings.xml a nahrazením identifikátorů identifikátory nových textových řetězců UIString[LBL61] a UIString[LBL62].
   • Podle potřeby přidejte nebo odeberte ovládací prvky vlastností.

3. V souboru %programdata%\Autodesk\<verze aplikace Vault>\Extensions\DataStandard\Vault\addinVault\Default.ps1 proveďte konfiguraci a změňte následující parametry:

   • InitializeWindow: Slouží k řízení velikosti dialogu.
   • GetCategories: Umožňuje podporovat dynamické vlastnosti na základě kategorií.
   • Validate: Umožňuje implementovat pravidla validace.

Získání karty Datový list nového uživatelského objektu

1. Zkopírujte složku Task a přejmenujte ji na Person.
2. V případě potřeby aktualizujte soubor Datasheet.xaml ve složce Person (například přidejte nebo odeberte vlastnosti).