Поделиться через

Именование атрибутов и классов

  • Статья

В этом разделе содержатся рекомендации по именованию атрибутов и классов.

Чтобы создать новый класс или атрибут, соблюдайте следующие правила именования:

  • Используйте одинаковое имя для свойств cn и lDAPDisplayName нового объекта attributeSchema или classSchema.
  • Определите компанию с префиксом нижнего регистра в первом разделе имени. Этот префикс может быть DNS-именем, акронимом или другой строкой, которая однозначно идентифицирует компанию. Префикс гарантирует, что все атрибуты и классы для конкретной компании отображаются последовательно при просмотре схемы.
  • Если вы разрабатываете расширение схемы в качестве независимого поставщика программного обеспечения, добавьте сокращенное название продукта префикса. Это добавляет различие между несколькими продуктами, содержащими расширения схемы LDAP.
  • Используйте дефис в качестве следующего символа после префикса.
  • Укажите атрибут или имя класса, уникальное в атрибутах компании после дефиса. Эта часть общего имени должна быть описательной. Не используйте нелогичные имена, которые бессмысленны для разработчиков и зрителей схемы.

Например, если вымышленная компания Fabrikam расширила схему путем добавления атрибута для хранения идентификатора голосовой почты, cn и lDAPDisplayName нового атрибута может быть "fabrikam-VoiceMailID".

Если объект lDAPDisplayName атрибута или класса не указан, система использует cn для создания. Однако системный алгоритм создания имени может привести к столкновениям имен или именам, которые трудно читать. Чтобы избежать этих проблем, рекомендуется явно указать lDAPDisplayName для всех атрибутов и классов.

Для целей разработки и тестирования может потребоваться добавить суффикс версии в cn и lDAPDisplayName, например fabrikam-VoiceMailID-001. В распределенной среде разработки и тестирования суффикс версии позволяет разработчикам одновременно запускать несколько версий программного обеспечения. После завершения тестирования переименуйте атрибут или класс, чтобы удалить суффикс.

Удалить устаревшие версии расширений схемы невозможно, но их можно отключить и переименовать с неясными именами. Дополнительные сведения см. в разделе "Отключение существующих классов и атрибутов".