Compartilhar via


Nomeando atributos e classes

Este tópico inclui diretrizes para nomear atributos e classes.

Para criar uma nova classe ou atributo, siga as seguintes regras de nomenclatura:

  • Use o mesmo nome para as propriedades cn e lDAPDisplayName de um novo objeto attributeSchema ou classSchema.
  • Identifique a empresa com um prefixo minúsculo na primeira seção do nome. Esse prefixo pode ser um nome DNS, acrônimo ou outra cadeia de caracteres que identifique exclusivamente a empresa. O prefixo garante que todos os atributos e classes de uma empresa específica sejam exibidos consecutivamente ao navegar no esquema.
  • Se você estiver desenvolvendo uma extensão de esquema como um fornecedor de software independente, adicione uma abreviação do nome do produto do prefixo. Isso adiciona distinção entre vários produtos que contêm extensões de esquema LDAP.
  • Use um hífen como o próximo caractere após o prefixo.
  • Especifique um atributo ou nome de classe que seja exclusivo dentro dos atributos da empresa após o hífen. Esta parte do nome comum deve ser descritiva. Não use nomes ilógicos que não façam sentido para desenvolvedores e visualizadores do esquema.

Por exemplo, se a empresa fictícia da Fabrikam estendeu o esquema adicionando um atributo para armazenar um identificador de caixa postal, o cn e lDAPDisplayName do novo atributo poderá ser "fabrikam-VoiceMailID".

Se o lDAPDisplayName de um atributo ou classe não for especificado, o sistema usará o cn para gerar um. No entanto, o algoritmo do sistema para gerar o nome pode resultar em colisões de nomes ou nomes difíceis de ler. Para evitar esses problemas, é recomendável que um lDAPDisplayName seja explicitamente especificado para todos os atributos e classes.

Para fins de desenvolvimento e teste, pode ser desejável acrescentar um sufixo de versão ao cn e lDAPDisplayName, por exemplo, "fabrikam-VoiceMailID-001". Em um ambiente de desenvolvimento/teste distribuído, um sufixo de versão permite que os desenvolvedores executem várias versões de seus softwares simultaneamente. Após a conclusão do teste, renomeie o atributo ou a classe para remover o sufixo.

Não é possível excluir versões extintas de extensões de um esquema, mas é possível desabilitá-las e renomeá-las com nomes obscuros. Para obter mais informações, consulte Desabilitando classes e atributos existentes.