Свойства адаптера JNDI

Общие свойства расположены в верхней части формы. Эти поля определяют атрибуты, связанные с записью LDAP. Информацию о свойствах, которые здесь не перечислены, а также инструкции по применению формы и импорту/экспорту записей LDAP см. в разделе Общие свойства и действия.

Атрибуты с нестроковым синтаксисом, которые необходимо возвращать в виде байтовых массивов (byte[]). Значение свойства указывается в виде строки имен атрибутов, разделенных пробелами. Необходимо включить все атрибуты, которые нужно сохранить как бинарные объекты.

Если это свойство не указано, то возвращаются массивы байтов только для тех атрибутов из каталога LDAP, для которых указан нестроковый синтаксис. Предполагается, что для всех остальных атрибутов задан синтаксис строки.

Примеры атрибутов, которые можно сохранять как бинарные объекты в LDAP:

photo	thumbnailPhoto	authorityRevocationList
personalSignature	thumbnailLogo	certificateRevocationList
audio	userPassword	crossCertificatePair
jpegPhoto	userCertificate	x500UniqueIdentifier
javaSerializedData	caCertificate

Атрибуты с нестроковым синтаксисом, которые необходимо сохранять в виде байтовых массивов (byte[]). Используйте запятую для разделения имен атрибутов в строке.

Если это свойство не указано, предполагается, что для всех атрибутов используется синтаксис строки. Только атрибуты, уже распознанные каталогом LDAP как имеющие нестроковый синтаксис, возвращаются в виде байтовых массивов.

Пароль по умолчанию, который используется при входе в службу каталогов.

Имя пользователя по умолчанию, которое вводится при входе в службу каталогов.

Значение по умолчанию для этого свойства отсутствует. Если имя пользователя не указано, его необходимо указать непосредственно в webject-командах, используемых для получения доступа к службам каталогов. В противном случае это свойство можно определить путем сопоставления имен и паролей пользователей. Дополнительные сведения о сопоставлении параметров доступа см. в разделах Сопоставление имен и паролей пользователей и Сопоставление имен и паролей пользователей в заданиях Info*Engine и JSP.

jndi.syntax.direction

Направление упорядочения имен объектов в различающемся имени. Допустимые значения: RIGHT_TO_LEFT, LEFT_TO_RIGHT и FLAT.

Значение по умолчанию для этого свойства: RIGHT_TO_LEFT.

jndi.syntax.separator

Символ, используемый для разделения имен объектов в различающемся имени. Значение по умолчанию для этого свойства: запятая (,).

environment.java.naming.ldap.derefAliases

Указывает, как обрабатываются псевдонимы LDAP во время операций поиска. Выберите одно из следующих значений.

Значение по умолчанию для этого свойства: ALWAYS.

Определяет способ обработки ссылок сервером LDAP. Ссылки являются механизмом, посредством которого папка LDAP связывается с другими физическими папками LDAP для получения результатов поиска. Выберите одно из следующих значений.

◦ ИГНОРИРОВАТЬ - все ссылки в подключенном коде игнорируются и возвращаются лишь результаты, полученные без обработки ссылок.

Поведение ссылок также задается на сервере LDAP. Если свойство для адаптера не задано пользователем, в настройках на сервере LDAP задается его значение по умолчанию.

Фильтр поиска по умолчанию для webject-команды Query-Objects, если для нее не задан фильтр поиска. В фильтре поиска можно по запросу выбирать поднабор со всеми записями в области запроса.

Задает контекстную область поиска. Выберите одно из следующих значений.

◦ SUBTREE - поиск начинается с текущего уровня и ведется по всем уровням полной иерархии LDAP, находящимся ниже текущего уровня.

Значение по умолчанию для этого свойства: ONELEVEL.

Максимальное допустимое время поиска в секундах. Если предельное значение достигнуто, а поиск не завершен, то найденные записи возвращаются с исключением IEPartialResultsException. При заданном значении 0 время проведения поиска не ограничено.

Значение по умолчанию для этого свойства равно 0 и означает, что время поиска не ограничено.

Используемый протокол LDAP. Допустимые значения: 3 для LDAPv3 и 2 для LDAPv2.

Значение по умолчанию для этого свойства: 3.

Полный путь к файлу журнала, который используется, когда адаптер находится вне процесса.

Используйте это свойство вместо свойства Каталог ведения журнала, предоставляемого в форме редактора свойств. Появление свойства Каталог ведения журнала зависит от того, задана ли настройка Показать журнал в редакторе форм. Сообщения журнала для адаптеров, находящихся в незавершенных процессах, записываются в файл журнала сервера Info*Engine, а не в файл, имя которого указано в данном свойстве.

Максимальное число записей, возвращаемых в качестве результатов запроса. Если указанное предельное значение достигнуто, а поиск не завершен, то найденные записи возвращаются и генерируется исключение IEPartialResultsException.

Указание значения 0 означает, что ограничений нет и должны быть возвращены все найденные записи. Ограничение на предел размера может быть наложено как в подключенном каталоге LDAP, так и в свойстве pagedSizeLimit.

Значение по умолчанию для этого свойства: 0; возвращаются все найденные записи.

socketAccess.maxThreadCount

Максимальное допустимое число параллельных потоков запросов для каждого экземпляра адаптера. Значение по умолчанию для этого свойства: 100.

java.naming.factory.initial

Имя Java-класса для класса фабрики. Значение по умолчанию для этого свойства: com.sun.jndi.ldap.LdapCtxFactory.

java.naming.provider.url

URL-адрес службы имен или сервера каталогов.

Различающееся имя записи, с которой начинается поиск.

Строка, которая используется для подписания и проверки запросов.

Сведения о проверке запросов см. в разделах Сопоставление имен и паролей пользователей для адаптеров и Изменение свойств проверки запроса Info*Engine.

Еще одна строка, которая используется для подписания и проверки запросов к процессору задач или адаптеру. Свойство secret.text создает более сложную подпись запроса, чем свойство secret.text2, и может использоваться вместо свойства secret.text или в дополнение к нему.

Алгоритм используется для шифрования значений свойств Ключ и Ключ 2.

Допустимые значения: SHA-1, MD2 и MD5. Значение по умолчанию для этого свойства: SHA-1.

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

◦ NAMING - выполняется поиск по одному уровню LDAP, где содержится именованная запись, с фильтром (objectclass=*) для получения имен записей, находящихся ниже именованной записи.

Значение по умолчанию для этого свойства: DIRECTORY.

Определяет, отправляется ли подробное описание в файл журнала. Если выбрать TRUE, подробные описания будут отправлены в файл журнала.

По умолчанию для этого свойства задано значение FALSE, означающее, что подробные описания не будут отправлены в файл журнала.

Информация о конфигурации для службы или адаптера может быть обновлена во время работы службы или адаптера, что позволяет обновить свойства без перезапуска.

Свойство Время жизни задает время (в минутах), оставшееся до автоматической перезагрузки свойств системы или адаптера. Автоматическая перегрузка свойств происходит только при обращении к ним. По умолчанию срок действия свойств не ограничен.

Если свойство в форме не определено, его можно добавить в поле Дополнительные свойства. При добавлении дополнительных свойств формат имени свойства включает имя записи адаптера (имя службы), сопровождаемое именем свойства. Например:

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

Если значение оказывается слишком длинным, чтобы увидеть его полностью, появляется действие Править. Нажмите кнопку Править, чтобы открыть новое окно навигатора, где текстовое поле будет иметь больший размер.

Следующие свойства могут быть особенно полезны при конфигурировании адаптера JNDI, их можно добавить как дополнительные свойства.

Определяет размер страницы для результатов поиска, возвращаемых сервером LDAP, разбитых на страницы. Задайте значение больше 0 для этого свойства, чтобы включить поиск с разбиением результатов на страницы, или равное 0, чтобы выключить.

По умолчанию это свойство выключено до тех пор, пока не используется служба Active Directory; в случае ее использования задание свойства windchill.config.directoryType автоматически включает поиск с разбиением на страницы с размером страницы равным 1000.

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

Значение по умолчанию для этого свойства: 20 000 записей. Это значение должно быть больше значения свойства pageSize или равно ему.

Добавьте это свойство, если используется сервер Active Directory Microsoft с адаптером. Задайте значение ADS.

Задание этого свойства автоматически включает поиск LDAP с разбиением на страницы, с размером страницы, по умолчанию равным 1000 результатов. Задание свойства pageSize переопределяет это значение.

Чтобы выключить поиск с разбиением на страницы, задайте для свойства pageSize значение 0.

Атрибуты LDAP, доступные в Windchill и в кэше участников. Атрибуты вводятся в виде списка (через запятую).