4.7. Операция добавления Add
Операция Add позволяет клиенту запросить добавление записи в каталог. Запрос Add определяется следующим образом:
AddRequest ::= [APPLICATION 8] SEQUENCE {
entry LDAPDN,
attributes AttributeList }
AttributeList ::= SEQUENCE OF attribute Attribute
Поля запроса Add:
entry:
Имя добавляемой записи. Серверу не нужно (SHALL NOT) выполнять какие-либо разыменования псевдонимов для определения местоположения записи, которая будет добавлена.
attributes:
Список атрибутов, которые, наряду с атрибутами из RDN, составляют содержимое добавляемой записи. Клиенты могут (MAY) включать, либо могут не (MAY NOT) включать в этот список атрибут (атрибуты) RDN. Клиенты не должны (MUST NOT) предоставлять те атрибуты, которые нельзя модифицировать пользователю (NO-USER-MODIFICATION), такие как атрибуты createTimestamp или creatorsName, поскольку сервер выставляет их автоматически.
Серверы должны (MUST) обеспечить, чтобы записи удовлетворяли правилам пользовательской и системной схемы данных, а также другим ограничениям модели данных. Типы атрибутов, для которых не определено соответствие equality, подчиняются правилам из раздела 2.5.1 [RFC4512] (это относится к атрибуту именования и, кроме того, к любым добавляемым многозначным атрибутам).
Для успешного выполнения запроса AddRequest запись, имя которой указано в поле entry этого запроса, не должна (MUST NOT) существовать. Непосредственно вышестоящая (родительская) запись добавляемой записи объекта или псевдонима должна (MUST) существовать. Например, если клиент пытается добавить <CN=JS,DC=Example,DC=NET>, запись <DC=Example,DC=NET> не существует, а запись <DC=NET> существует, то сервер вернёт результирующий код noSuchObject, а поле matchedDN конструкции LDAPResult будет содержать <DC=NET>.
При получении запроса Add сервер попытается добавить указанную запись. Результат попытки добавления будет возвращён клиенту в ответе Add Response, который определяется следующим образом:
AddResponse ::= [APPLICATION 9] LDAPResult
Ответ с кодом success указывает на то, что новая запись была добавлена в каталог.