Administração de objetos personalizados do Data Standard

Configure as caixas de diálogo e guias de criação para exibir dados do objeto personalizado.

Requisitos

Três componentes são necessários para o suporte de objeto personalizado:

• Entradas de menu para a caixa de diálogo de criação e edição.
• Arquivos de caixas de diálogo (.xaml) para caixas de diálogo e guias.
• Arquivos de script (PowerShell) para a lógica de caixa de diálogo.

Usar objeto personalizado pré-configurado "Task"

Por padrão, os três componentes são fornecidos no Data Standard. Esses componentes são pré-configurados para funcionar com um objeto personalizado do Vault chamado Task.

Nota: A compatibilidade de menus de contexto com objetos personalizados só estará disponível se houver um objeto personalizado.

1. Por meio da configuração do Vault, crie uma definição de objeto personalizado e chame-o de Task.
   Nota: Consulte Administração de Objetos personalizados para obter mais informações.
2. Atribua as propriedades Title e Description à categoria Base.
3. Reinicie o Vault Explorer e faça login no Vault duas vezes:
   • Na primeira vez que fizer login, verifique se o tipo de objeto Tasks está disponível no cliente do Vault.
   • Faça logout e faça login uma segunda vez para iniciar a guia Folha de dados e os itens de menu para criar e editar tarefas.

   O novo objeto personalizado Task é completamente inicializado e está pronto para usar.

4. Crie um novo objeto personalizado usando o comando Novo e o nomeie como desejar.
5. Clique com o botão direito do mouse no novo objeto personalizado. Agora, o menu de contexto mostra as opções Nova tarefa e Editar tarefa.

Nota: Quando você faz login pela primeira vez depois de definir um novo objeto personalizado, o arquivo CustomEntityDefinitions.json(%programdata%\Autodesk\<versão do Vault>\Extensions\DataStandard\Vault) é criado. A definição do arquivo é usada para inicializar a guia e os itens de menu relacionados aos objetos personalizados. O arquivo não deve ser modificado manualmente. Para evitar que os usuários tenham que fazer login várias vezes, o arquivo pode ser implementado. Se não conseguir inicializar os objetos personalizados, você poderá excluir o arquivo. Ele será criado na próxima vez que você fizer login em um vault.

Configurar objetos personalizados adicionais

Para definir seu próprio objeto personalizado, copie os três componentes do exemplo Task e faça as modificações necessárias.

Veja a seguir exemplos de um objeto personalizado chamado Person.

Entradas de menu

As entradas do menu de contexto para a criação e a edição de uma caixa de diálogo são definidas aqui:

%programdata%\Autodesk\<versão do Vault>\Extensions\DataStandard\Vault\MenuDefinitions.xml

As definições das entradas de menu devem ser criadas:

1. Copie as definições (MenuItem NewTask, MenuItem EditTask) do exemplo Task.
2. Substitua Task por Person em todas as variáveis.
3. Modifique Description, Hint, Label e Navigation Types.
   Nota: Para essas variáveis, é possível usar a sintaxe UIString do exemplo original. Consulte Localização para obter mais informações.

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

Em seguida, crie um site de menu para o novo objeto personalizado.

1. Copie o site (CommandSite Task) do exemplo Task.
2. Substitua Task por Person em todas as variáveis.

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

Consulte Personalizar o arquivo MenuDefiniftions.xml do Data Standard para obter mais detalhes sobre a sintaxe do menu.

Scripts de arquivos

As definições de menu contidas no arquivo MenuDefinitions.xml apontam para arquivos do PowerShell. Esses arquivos estão localizados em %programdata%\Autodesk\<versão do Vault>\Extensions\DataStandard\Vault\addinVault\Menus.

Os arquivos CreateCustomObject.ps1 padrão e EditCustomObject.ps1 padrão do PowerShell são compatíveis com todos os objetos personalizados. Não há necessidade de criar arquivos adicionais do PowerShell. No entanto, ainda é possível personalizar e criar arquivos do PowerShell para o novo objeto personalizado. Para isso, execute estas tarefas:

1. Copie os arquivos de definição de menu CreateCustomObject.ps1 e EditCustomObject.ps1 e os renomeie como CreatePerson.ps1 e EditPerson.ps1.
2. Assim como outros scripts, os scripts para criar e editar objetos personalizados apontam para um arquivo XAML relacionado.

   Modifique o nome do arquivo XAML que define a caixa de diálogo do Data Standard substituindo Task por Person.

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

Caixas de diálogo e guias

O arquivo XAML da caixa de diálogo de criação e edição do objeto personalizado é especificado nos arquivos do PowerShell (veja acima). Por padrão, os arquivos XAML de caixas de diálogo de criação e edição, bem como as guias, estão localizados aqui:

%programdata%\Autodesk\<Vault version>\extensions\datastandard\vault\configuration

O CustomObject.xaml padrão não precisa de nenhuma alteração. Contudo, você precisa usar o arquivo CustomObject.xaml como modelo para criar um arquivo XAML para o novo objeto personalizado.

1. Copie o arquivo CustomObject.xaml e nomeie-o Person.xaml.
2. Modifique o novo arquivo XAML com estas etapas:
   • Substitua todas as ocorrências de TaskWindow por PersonWindow.
   • Corrija o título da caixa de diálogo adicionando Nova pessoa e Editar folha de dados de pessoas ao arquivo UiStrings.xml e substituindo as IDs pelas IDs das novas sequências de texto UIString[LBL61] e UIString[LBL62].
   • Adicione ou remova controles de propriedade conforme necessário.
3. Altere as seguintes funções em %programdata%\Autodesk\<versão do Vault>\Extensions\DataStandard\Vault\addinVault\Default.ps1 configurando:
   • InitializeWindow para controlar o tamanho da caixa de diálogo.
   • GetCategories para oferecer suporte a propriedades dinâmicas baseadas em categorias.
   • Validate para implementar regras de validação.

Obtenha a guia Folha de dados para o novo objeto personalizado

1. Copie a pasta Task e dê a ela o nome Person.
2. Se necessário, atualize o arquivo Datasheet.xaml na pasta Person (por exemplo, adicione ou remova propriedades).