Partilhar 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 o cn e lDAPDisplayName propriedades de um novo attributeSchema ou classSchema objeto.
  • 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 poderia 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 ser 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 seu software 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 esquema, mas é possível desativá-las e renomeá-las com nomes obscuros. Para obter mais informações, consulte Desativando classes e atributos existentes.