Amministrazione degli oggetti personalizzati di Data Standard

È possibile configurare le finestre di dialogo e le schede di creazione per visualizzare i dati degli oggetti personalizzati.

Requisiti

Per il supporto di oggetti personalizzati sono necessari tre componenti:

• Le voci di menu per la finestra di dialogo di creazione e di modifica
• I file di finestre di dialogo (XAML) per le finestre di dialogo e le schede
• I file di script (PowerShell) per la logica della finestra di dialogo.

Utilizzo dell'oggetto personalizzato preconfigurato "Task"

Per default, tutti e tre i componenti sono forniti con Data Standard. Questi componenti sono preconfigurati per essere utilizzati con un oggetto personalizzato in Vault denominato Task.

Nota: Il supporto del menu contestuale per gli oggetti personalizzati è disponibile solo se è presente un oggetto personalizzato.

1. Tramite la configurazione del Vault, creare una definizione dell'oggetto personalizzato e denominarla Task.
   Nota: Per ulteriori informazioni, vedere Amministrazione delle definizioni di oggetti personalizzati.
2. Assegnare le proprietà Title e Description alla categoria Base.
3. Riavviare Vault Explorer ed effettuare l'accesso a Vault due volte:
   • Al primo accesso, verificare che il tipo di oggetto Task sia disponibile in Vault Client.
   • Eseguire la disconnessione ed effettuare l'accesso una seconda volta per inizializzare la scheda Foglio dati e le voci di menu per creare e modificare le attività.

   Il nuovo oggetto personalizzato Task è completamente inizializzato e pronto per l'utilizzo.

4. Creare un nuovo oggetto personalizzato utilizzando il comando Nuovo oggetto personalizzato, quindi denominarlo come si desidera.
5. Fare clic con il pulsante destro del mouse sul nuovo oggetto personalizzato. Nel menu contestuale ora vengono visualizzate le opzioni del menu Nuova attività e Modifica attività.

Nota: Al primo accesso successivo alla definizione di un nuovo oggetto personalizzato, viene creato il file CustomEntityDefinitions.json (%programdata%\Autodesk\<Vault edition>\Extensions\DataStandard\Vault). La definizione nel file viene utilizzata per inizializzare la scheda e le voci di menu per gli oggetti personalizzati. Il file non deve essere modificato manualmente. È possibile installare il file per evitare che gli utenti debbano accedere diverse volte. Se non è possibile inizializzare gli oggetti personalizzati, il file può essere eliminato. Verrà creato al prossimo accesso ad un vault.

Configurazione di ulteriori oggetti personalizzati

Per definire il nuovo oggetto personalizzato, copiare i tre componenti dall'esempio con Task e modificarli in base alle necessità.

Di seguito sono riportati alcuni esempi di un oggetto personalizzato denominato Person.

Voci di menu

Le voci del menu contestuale per la creazione e la modifica di una finestra di dialogo sono definite qui:

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

È necessario creare le definizioni delle voci di menu:

1. Copiare le definizioni (MenuItem NewTask, MenuItem EditTask) dall'esempio con Task.
2. Sostituire Task con Person in tutte le variabili.
3. Modificare Description, Hint, Label e NavigationTypes.
   Nota: Per queste variabili, può essere utilizzata la sintassi UIString nell'esempio originale. Per ulteriori informazioni, vedere Localizzazione.

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

Dopodiché, creare un sito del menu per il nuovo oggetto personalizzato.

1. Copiare il sito (CommandSite Task) dall'esempio con Task.
2. Sostituire Task con Person in tutte le variabili.

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

Per ulteriori informazioni sulla sintassi del menu, vedere Personalizzazione del file MenuDefinitions.xml di Data Standard.

File di script

Le definizioni dei menu nel file MenuDefinitions.xml puntano ai file di PowerShell. Questi file si trovano al percorso %programdata%\Autodesk\<Vault version>\Extensions\DataStandard\Vault\addinVault\Menus.

I file di default CreateCustomObject.ps1 e EditCustomObject.ps1 di PowerShell possono essere utilizzati per ogni oggetto personalizzato. Non è necessario creare ulteriori file PowerShell. Tuttavia, è ancora possibile personalizzare e creare file PowerShell per il nuovo oggetto personalizzato eseguendo le seguenti operazioni:

1. Copiare i file di definizione del menu CreateCustomObject.ps1 e EditCustomObject.ps1 e rinominarli CreatePerson.ps1 e EditPerson.ps1.
2. Analogamente ad altri script, gli script di creazione e modifica di oggetti personalizzati fanno riferimento ad un file XAML correlato.

   Modificare il nome del file che definisce la finestra di dialogo di Data Standard sostituendo Task con Person.

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

Finestre di dialogo e schede

Il file XAML per la finestra di dialogo di creazione e modifica di oggetti personalizzati è specificato nei file di PowerShell (vedere sopra). Per impostazione predefinita, i file XAML per le finestre di dialogo di creazione e di modifica e per le schede sono disponibili qui:

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

Il file di default CustomObject.xaml può essere utilizzato senza alcuna modifica. Tuttavia, è necessario utilizzare il file CustomObject.xaml come modello per creare un file XAML per il nuovo oggetto personalizzato.

1. Copiare il file CustomObject.xaml e rinominarlo Person.xaml.
2. Modificare il nuovo file XAML seguendo questi passaggi:
   • Sostituire tutte le ricorrenze di TaskWindow con PersonWindow.
   • Correggere il titolo della finestra di dialogo aggiungendo New Person e Edit Person Datasheet al file UiStrings.xml e sostituendo gli ID con gli ID per le nuove stringhe di testo UIString[LBL61] e UIString[LBL62].
   • Aggiungere o rimuovere i comandi delle proprietà in base alle esigenze.
3. Modificare le seguenti funzioni in %programdata%\Autodesk\<Vault version>\Extensions\DataStandard\Vault\addinVault\Default.ps1 configurando:
   • InitializeWindow per controllare le dimensioni della finestra di dialogo.
   • GetCategories per supportare le proprietà dinamiche in base alle categorie.
   • Validate per implementare le regole di convalida.

Scheda Datasheet per il nuovo oggetto personalizzato

1. Copiare la cartella Task e denominarla Person.
2. Se necessario, aggiornare il file Datasheet.xaml nella cartella Person (ad esempio, aggiungere o rimuovere proprietà).