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.

Poznámka: Podpora místních nabídek je u uživatelských objektů k dispozici, pouze pokud uživatelské objekty existují.

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.

Poznámka: Při prvním přihlášení po definování nového uživatelského objektu je vytvořen soubor CustomEntityDefinitions.json (%programdata%\Autodesk\<edice aplikace Vault>\Extensions\DataStandard\Vault). Definice v souboru se používá k inicializaci karty a položek nabídky pro uživatelské objekty. Soubor by se neměl upravovat ručně. Aby se uživatelé nemuseli přihlašovat několikrát, lze soubor rozmístit. Pokud uživatelské objekty nelze inicializovat, soubor lze odstranit. Při příštím přihlášení do úložiště se opět vytvoří.

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 ukázky objektu Úloha.
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 version>\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 řetězce TaskWindow řetězcem 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: Umožňuje řídit velikost 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).