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:

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.

Observação: O suporte a menus de contexto para 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.

    Observação: 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.

Observação: 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) da amostra de Task.

  2. Substitua Task por Person em todas as variáveis.

  3. Modifique Description, Hint, Label e Navigation Types.

    Observação: Para essas variáveis, é possível usar a sintaxe UIString da amostra 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) da amostra de 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 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 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 ao executar estas tarefas:

  1. Copie os arquivos de definição de menu CreateCustomObject.ps1 e EditCustomObject.ps1 e renomeie-os 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\<versão do Vault>\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 os IDs por aqueles 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).