Tabela ModuleConfiguration
A tabela ModuleConfiguration identifica os atributos configuráveis do módulo. Esta tabela não é mesclada no banco de dados.
A tabela ModuleConfiguration tem as colunas a seguir.
| Coluna | Tipo | Chave | Nullable |
|---|---|---|---|
| Nome | identificador de | Y | N |
| Formato | inteiro | N | N |
| Tipo | de Texto | N | Y |
| ContextData | de Texto | N | Y |
| DefaultValue | de Texto | N | Y |
| Atributos | inteiro | N | Y |
| DisplayName | de Texto | N | Y |
| Descrição | de Texto | N | Y |
| HelpLocation | de Texto | N | Y |
| HelpKeyword | de Texto | N | Y |
Colunas
-
Nome do
-
Esse campo define o nome do item configurável. Esse nome é referenciado no modelo de formatação na coluna Valor da tabela ModuleSubstitution.
-
Formato
-
Esta coluna especifica o formato dos dados que estão sendo alterados.
Formato Valor de Texto 0 key 1 inteiro 2 de formato bitfield 3 -
Tipo de
-
Esta coluna especifica o tipo para os dados que estão sendo alterados. Esse tipo é usado para fornecer um contexto para qualquer interface do usuário e não é usado no processo de mesclagem. Os valores válidos para esta coluna dependem do valor na coluna Formatar.
-
ContextData
-
Esta coluna especifica um contexto semântico para os dados solicitados. O tipo é usado para fornecer um contexto para qualquer interface do usuário e não é usado no processo de mesclagem. Os valores válidos para esta coluna dependem dos valores nas colunas Formatar e Tipo.
-
DefaultValue
-
Esta coluna especifica um valor padrão para o item neste registro se a ferramenta de mesclagem se recusar a fornecer um valor. Esse valor deve ter o formato, o tipo e o contexto do item. Se esse for um item de formato "Chave", a chave estrangeira deverá ser uma chave válida nas tabelas do módulo. Nulo pode ser um valor válido para esta coluna, dependendo do item. Para itens de formato "Chave", esse valor está no formato especial CMSM. Para todos os outros tipos, o valor é tratado literalmente.
Os autores do módulo devem garantir que o módulo seja válido em seu estado padrão. Isso garante que versões de Mergemod.dll anteriores à versão 2.0 ainda possam usar o módulo em seu estado padrão.
-
Atributos de
-
Esta coluna é um campo de bits que contém atributos para este item configurável. Nulo é equivalente a 0. Todos os outros bits nesta coluna são reservados para uso futuro e devem ser 0.
Nome Decimal Hexadecimal Descrição msmConfigurableOptionKeyNoOrphan 1 0x00000001 Esse atributo só se aplica a registros que listam uma chave estrangeira a uma tabela de módulo em seu campo DefaultValue. A ferramenta de mesclagem ignora o atributo para qualquer formato que não seja o tipos de formato de chave. Os itens não listados na tabela ModuleSubstitution são excluídos da verificação a seguir. A ferramenta de mesclagem não mescla a linha referenciada pela coluna DefaultValue no banco de dados de destino se as seguintes condições forem atendidas depois de concluir todas as opções de configuração.
Cada linha na tabela ModuleConfiguration com o mesmo DefaultValue tem o conjunto msmConfigurationItemsKeyNoOrphan.
Nenhuma linha usa o DefaultValue porque a ferramenta de criação se recusou a fornecer um valor.
A ferramenta de mesclagem mescla a linha se qualquer uma das condições a seguir for atendida.
A ferramenta de mesclagem localiza qualquer linha que não tenha msmConfigItemsKeyNoOrphan definida.
Se a ferramenta de mesclagem encontrar qualquer linha usando DefaultValue porque a ferramenta de criação se recusou a fornecer um valor.msmConfigurableOptionNonNullable 2 0x00000002 Quando esse atributo é definido, nulo não é uma resposta válida para este item. Esse atributo não tem efeito para tipos de formato inteiro ou tipos de formato bitfield. -
DisplayName
-
Esta coluna fornece uma breve descrição deste item que a ferramenta de criação pode usar na interface do usuário. Essa coluna pode não ser localizada. Defina essa coluna como nula para que o módulo solicite que a ferramenta de criação não exponha essa propriedade na interface do usuário. A ferramenta pode desconsiderar o valor neste campo.
-
Descrição do
-
Esta coluna fornece uma descrição deste item que a ferramenta de criação pode usar em elementos da interface do usuário. Essa cadeia de caracteres pode ser localizada pela transformação de idioma do módulo. Essa coluna pode ser nula.
-
HelpLocation
-
Esta coluna fornece o nome de um arquivo de ajuda (sem a extensão .chm) ou uma lista delimitada por ponto-e-vírgula de namespaces de ajuda. Essa coluna poderá ser nula se nenhuma ajuda estiver disponível. Essa coluna só poderá ser nula se a coluna HelpKeyword for nula.
-
HelpKeyword
-
Esta coluna fornece uma palavra-chave para o arquivo de ajuda ou namespace da coluna HelpLocation. A interpretação dessa palavra-chave depende da coluna HelpLocation. Essa coluna pode ser nula.
Observações
A tabela ModuleConfiguration é usada por módulos de mesclagem configuráveis. Mergemod.dll 2.0 ou posterior é necessário para criar um módulo de mesclagem configurável.
Para garantir a compatibilidade com versões mais antigas do Mergemod.dll, a tabela ModuleConfiguration e a tabela ModuleSubstitution devem ser adicionadas à tabela ModuleIgnoreTable de cada módulo.
Validação