Funções do PowerShell para Padrão de dados

Funções do PowerShell são utilizadas para personalizar o comportamento de forma programática lógica de negócios, valores padrão, e a interface do usuário.

O padrão de dados vem com diversas funções que são necessárias para trabalhar com o padrão de caixas de diálogo e guias. Algumas funções são chamadas de dentro do complemento Data Standard.

Estas funções são obrigatórias e não devem ser removidas.

As funções podem ser consideradas como ativadas por evento e podem ser modificadas para alterar o comportamento. Outras funções são chamadas diretamente do arquivo XAML. Por exemplo, para recuperar informações do banco de dados do Vault (por exemplo, esquemas de numeração disponíveis, categorias).

Todos os arquivos *.ps1 e *.psm1 (módulo PowerShell) localizados nas pastas "addinVault" (Vault) ou "addins" (CAD) são importados e usados automaticamente.

Nota: A Autodesk recomenda utilizar um arquivo .ps1 separado para suas próprias funções.

A tabela a seguir contém uma lista de funções que são chamadas diretamente de um complemento ou de um arquivo XAML. Para melhor leitura do código, essas funções podem chamar outras funções. Essas outras funções não são listadas explicitamente.

Função	Arquivo	Complemento de uso	XAML de uso	Descrição
ActivateOKButton	Vault: Default.ps1	Vault		Utilizado para validação e para ativar o botão OK nas caixas de diálogo Editar e Criar. Por padrão, ele chama a função Validate() e, em seguida, com base no tipo de janela, chama outras funções de validação. Como ActivateOkButton é chamado de cada vez que os dados são alterados na caixa de diálogo, isso pode causar problemas de desempenho se as funções de validação forem muito complexas.
AddinLoaded	CAD: Default.ps1	CAD		Chamado quando o VDS Inventor-Addin ou o AutoCAD-Addin é carregado.
Addinunloaded	CAD: Default.ps1	CAD		Chamado quando a VDS Inventor-Addin ou AutoCAD-Addin é descarregado.
GetCategories	Vault, CAD: Default.ps1		Vault, CAD	Esta função é utilizada nas caixas de diálogo Criar do Vault e do CAD para exibir categorias em uma caixa combo. O padrão de implementação retorna uma lista de todos os arquivos, pastas ou categorias de entidade personalizadas com base no nome da janela. Usado para Dynamic Properties. Para caixas de diálogo de edição de CAD, a categoria atribuída é retornada.
GetNewCustomObjectName	Vault: Default.ps1	Vault		Chamado ao clicar no botão OK na caixa de diálogo Criar um objeto personalizado. Esta função retorna o nome do novo objeto personalizado. A implementação padrão obtém o valor no controle de uma caixa de diálogo de criação com o nome CUSTOMOBJECTNAME ou em uma propriedade especial _GeneratedNumber, caso os esquemas de numeração do Vault estejam definidos. Consulte Data Standard e esquemas de numeração para obter mais informações.
GetNewFileName	Vault: Default.ps1	Vault		Chamado ao clicar no botão OK na caixa de diálogo Criar arquivo. Esta função retorna o nome do arquivo para o novo arquivo. O padrão de implementação obterá o valor a partir de uma caixa de diálogo de criação de controle com o nome FILENAME ou a partir de uma propriedade especial _GeneratedNumber se os esquemas de numeração do Vault estiverem definidos. Consulte Data Standard e esquemas de numeração para obter mais informações.
GetNewFolderName	Vault: Default.ps1	Vault		Chamado ao clicar no botão OK na caixa de diálogo Criar pasta. Esta função retorna o nome da nova pasta. A implementação padrão obtém o valor no controle de uma caixa de diálogo de criação com o nome FOLDERNAME ou em uma propriedade especial _GeneratedNumber, caso os esquemas de numeração do Vault estejam definidos. Consulte Data Standard e esquemas de numeração para obter mais informações.
GetNumSchms	Vault, CAD: Default.ps1		Vault, CAD	Esta função é utilizada nas caixas de diálogo de criação de arquivos do Vault e do CAD para mostrar os esquemas de numeração em uma caixa combo. O padrão de implementação retorna todos os esquemas de numeração ativados do arquivo do Vault. O esquema de numeração padrão é um esquema com o mesmo nome da categoria selecionada. Se não houver um esquema com o mesmo nome da categoria selecionada, o esquema será o padrão definido nas configurações do Vault.
GetParentFolderName	Vault: Default.ps1	Vault		Chamado ao clicar no botão OK na caixa de diálogo Criar pasta. Esta função pode ser utilizada para forçar um nome de pasta específico ao usar a função Novo arquivo padrão ou Nova pasta padrão. Se uma sequência vazia for retornada, a pasta selecionada será utilizada.
InitializeTabWindow	Vault: Default.ps1	Vault		Chamado ao inicializar as guias de Data Standard no Vault.
InitializeWindow	Vault: Default.ps1	Vault		Chamado ao inicializar caixas de diálogo do Data Standard.
ItemTitle	Vault: Default.ps1		Vault	Utilizado em guias para itens e objetos ECO. A implementação padrão retorna o valor do item ou da propriedade "Título (Item, CO)" do ECO. Nota: {Binding Prop[_XLTN_TITLE_ITEM_CO]} não pode ser usado diretamente no XAML por causa do nome da propriedade.
ItemDescription	Vault: Default.ps1		Vault	Utilizado em guias para itens e objetos ECO. A implementação padrão retorna o valor do item ou da propriedade "Descrição (Item, CO)" do ECO. Nota: {Binding Prop[_XLTN_DESCRIPTION_ITEM_CO]} não pode ser usado diretamente no XAML por causa do nome da propriedade.
OnLogOn	Vault: Default.ps1	Vault		Chamado quando o usuário efetua o login em um Vault.
OnLogOff	Vault: Default.ps1		Vault	Chamado quando o usuário se desconecta.
OnPostCloseDialog	CAD: Default.ps1	CAD		Chamado quando as caixas de diálogo do Data Standard são fechadas ao clicar no botão OK e antes do nome de arquivo ser definido e as propriedades serem atualizadas.
OnTabContextChanged	Vault: Default.ps1	Vault		Chamado quando o contexto de uma guia personalizada do Vault é alterado. É utilizado para atualizar os dados que são exibidos na guia.
SetWindowTitle($newFile, $editFile, $name)	Vault, CAD: Default.ps1	Vault, CAD		Chamado a partir da função InitializeWindow. Essa função recebe entradas, dependendo de CreateMode ou EditMode, seja para File, Folder ou CustomObject. O resultado retornado é definido como o título da caixa de diálogo.

Nota: Os arquivos ps1 para os itens de menu, localizados em C:\ProgramData\Autodesk\<Vault version>\Extensions\DataStandard\Vault\addinVault\Menus, contêm um código que não está no escopo de uma função PowerShell. Este código é executado diretamente quando o item de menu for clicado.