Administrowanie obiektami niestandardowymi programu Data Standard

Można skonfigurować okna dialogowe i karty tworzenia, aby były wyświetlane dane obiektu niestandardowego.

Wymagania

Trzy komponenty są wymagane do obsługi obiektów niestandardowych:

elementy menu dla okna dialogowego tworzenia i edycji,
pliki (.xaml) okien dialogowych i kart dla okien dialogowych i kart,
pliki skryptów (PowerShell) opisujących logikę okien dialogowych.

Użycie wstępnie skonfigurowanego niestandardowego obiektu „Task”

Domyślnie z programem Data Standard dostarczane są wszystkie trzy komponenty. Te komponenty są wstępnie skonfigurowane do pracy z obiektem niestandardowym o nazwie Task w programie Vault.

Uwaga: obsługa menu kontekstowego w przypadku obiektów niestandardowych jest dostępna tylko wtedy, gdy obiekt niestandardowy istnieje.

Za pomocą konfiguracji programu Vault należy utworzyć definicję obiektu niestandardowego i nazwać go Task.

Uwaga: zobacz temat Administrowanie obiektami niestandardowymi, aby uzyskać więcej informacji.
Przypisz właściwości Tytuł i Opis do kategorii Podstawowe.
Uruchom ponownie program Vault Explorer i zaloguj się do programu Vault dwukrotnie:
- Podczas pierwszego logowania sprawdź, czy typ obiektu Task jest dostępny w kliencie programu Vault.
- Wyloguj się i zaloguj się drugi raz, aby zainicjować kartę Arkusz danych i elementy menu umożliwiające tworzenie i edycję zadań.
Nowy obiekt niestandardowy Task zostanie w pełni zainicjowany i będzie gotowy do użycia.
Za pomocą polecenia Nowy utwórz nowy obiekt niestandardowy i nazwij go w dowolny sposób.
Kliknij prawym przyciskiem myszy nowy obiekt niestandardowy. Menu kontekstowe zawiera teraz opcje New Task (Nowe zadanie) i Edit Task (Edytuj zadanie).

Uwaga: Podczas logowania się po raz pierwszy po zdefiniowaniu nowego obiektu niestandardowego zostanie utworzony plik CustomEntityDefinitions.json (%programdata%\Autodesk\<wersja programu Vault>\Extensions\DataStandard\Vault). Definicja w pliku służy do zainicjowania kart i elementów menu dla obiektów niestandardowych. Pliku nie należy modyfikować ręcznie. Aby uniknąć potrzeby logowania się kilkakrotnie, plik można wdrożyć. Jeśli nie można zainicjować obiektów niestandardowych, plik można usunąć. Jest on tworzony podczas następnego logowania do repozytorium.

Konfigurowanie dodatkowych obiektów niestandardowych

Aby zdefiniować własny obiekt niestandardowy, skopiuj trzy komponenty z przykładu Task i zmodyfikuj je w razie potrzeby.

Poniżej podano przykłady obiektu niestandardowego o nazwie Person.

Elementy menu kontekstowego do okna dialogowego tworzenia i edycji są zdefiniowane tutaj:

%programdata%\Autodesk\<wersja programu Vault>\Extensions\DataStandard\Vault\MenuDefinitions.xml

Definicje elementów menu muszą zostać utworzone:

Skopiuj definicje (MenuItem NewTask, MenuItem EditTask) z przykładu Task.
Zastąp ciąg Task ciągiem Person we wszystkich zmiennych.

Zmodyfikuj zmienne Description, Hint, Label i NavigationTypes.

Uwaga: W przypadku tych zmiennych można użyć składni ciągu interfejsu użytkownika podanej w pierwotnym przykładzie. Więcej informacji można znaleźć w temacie Lokalizacja.

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

Następnie należy utworzyć lokalizację menu dla nowego obiektu niestandardowego.

Skopiuj lokalizację (CommandSite Task) z przykładu Task.

Zastąp ciąg Task ciągiem Person we wszystkich zmiennych.

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

Zobacz temat Dostosowanie standardu danych pliku MenuDefiniftions.xml, aby uzyskać więcej szczegółów dotyczących składni menu.

Pliki skryptów

Definicje menu w pliku MenuDefinitions.xml wskazują na pliki PowerShell. Te pliki te znajdują się w katalogu %programdata%\Autodesk\<wersja programu Vault>\Extensions\DataStandard\Vault\addinVault\Menus.

Domyślne pliki PowerShell CreateCustomObject.ps1 i EditCustomObject.ps1 działają dla każdego obiektu niestandardowego. Nie trzeba tworzyć dodatkowych plików PowerShell. Nadal jednak można dostosować i utworzyć pliki PowerShell dla nowych obiektów niestandardowych, wykonując następujące czynności:

Skopiuj definicje menu CreateCustomObject.ps1 i EditCustomObject.ps1 i zmień ich nazwy na CreatePerson.ps1 i EditPerson.ps1.
Skrypty tworzenia i edycji obiektów niestandardowych, podobnie jak w przypadku innych skryptów, wskazują na powiązany plik XAML.

Zmień nazwę pliku XAML, który definiuje okno dialogowe programu Data Standard, zastępując ciąg Task ciągiem Person.
```
...
$xamlFile = New-Object CreateObject.WPF.XamlFile "PersonXaml", "%ProgramData%\Autodesk\Vault 2016\Extensions\DataStandard\Vault\Configuration\Person.xaml"
$dialog.XamlFile = $xamlFile
...
```

Okna dialogowe i karty

Plik XAML okna dialogowego tworzenia i edycji obiektów niestandardowych jest określony w plikach PowerShell (patrz wyżej). Domyślnie pliki XAML okien dialogowych tworzenia i edycji oraz kart znajdują w katalogu:

%programdata%\Autodesk\<wersja programu Vault>\Extensions\DataStandard\Vault\Configuration

Domyślny plik CustomObject.xaml działa bez żadnych zmian. Jednak należy użyć pliku CustomObject.xaml jako szablonu, aby utworzyć plik XAML dla nowego obiektu niestandardowego.

Skopiuj plik CustomObject.xaml i nazwij go Person.xaml.
Zmodyfikuj nowy plik XAML, wykonując następujące czynności:
- Zastąp wszystkie wystąpienia elementu TaskWindow elementem PersonWindow.
- Popraw tytuł okna dialogowego, dodając pliki New Person i Edit Person Datasheet do pliku UiStrings.xml i zastępując identyfikatory identyfikatorami dla nowych ciągów tekstowych UIString[LBL61] i UIString[LBL62].
- Dodaj lub usuń kontrolki właściwości zgodnie z potrzebami.
Zmień następujące funkcje w katalogu: %programdata%\Autodesk\<wersja programu Vault>\Extensions\DataStandard\Vault\addinVault\Default.ps1, konfigurując:
- InitializeWindow, aby sterować rozmiarem okna dialogowego.
- GetCategories, aby obsługiwać właściwości dynamiczne oparte na kategoriach.
- Validate, aby zaimplementować reguły sprawdzania poprawności.

Pobieranie karty Arkusz danych dla nowego obiektu niestandardowego

Skopiuj folder Task i nazwij go Person.
Jeśli zachodzi taka potrzeba, zaktualizuj plik Datasheet.xaml w folderze Person (np. dodaj lub usuń właściwości).