ГОСТ Р ИСО/МЭК 10166-1-2001

8.2.7 Операция List

Возвращает атрибуты СПД членов заданной группы СПД или записей СПД, идентифицированных элементами заданного списка результатов поиска СПД. Для группы СПД перечисляются только ее члены, но не их потомки. Члены группы СПД или записи СПД, идентифицированные элементами списка результатов поиска СПД, недоступные (из-за недостаточных прав доступа) инициировавшему операцию пользователю, не включаются в этот перечень (другие члены и записи возвращаются пользователю при условии задания соответствующего значения ErrorHandlingMode). Количество членов или элементов (записей), которые должны быть перечислены, может быть ограничено аргументом count-limit. Если этот лимит будет превышен, то перечисление членов или элементов (записей) может быть продолжено следующей операцией List. Для каждого члена или элемента (записи) возвращаются только заданные атрибуты СПД. Члены или элементы (записи) перечисляются в заданном порядке.

List : : = ABSTRACT-OPERATION ARGUMENT ListArgument RESULT ListResult ERRORS{

Abandoned,

AccessError,

AttributeError,

NameError,

ReservationError,

SecurityError,

ServiceError}

8.2.7.1    Аргумент ListArgument ListArgument : : = SEQUENCE {

entry [0] DfrEntryName,

COMPONENTS OF

CommonListSearchArguments (WITH COMPONENTS {..., selection PRESENT}), COMPONENTS OF CommonArguments}

Компоненты ListArgument имеют следующий смысл.

а)    Специфические аргументы List:

-    entry идентифицирует группу СПД или список результатов поиска СПД, которая должна быть перечислена.

б)    Общие аргументы List/Search:

-    continue, если установлен равным TRUE, задает, что процесс перечисления, идентифицированный аргументом task-id в CommonArguments, должен быть продолжен с того места, где был ранее прерван;

-    limits факультативно задает максимальное число записей СПД, которые должны быть возвращены этой абстрактной операцией;

-    selection задает, какие атрибуты СПД каждой записи должны быть возвращены в результате абстрактной операции List;

-    ordering факультативно задает, в каком порядке записи СПД должны быть помещены в ListResult (это упорядочение, если оно задано, перекрывает определенное ранее упорядочение перечисляемой группы СПД или списка результатов поиска СПД).

в)    Общие аргументы:

-    task-id, см. 8.1.3.1;

-    reservation, если запрошено, применяется к перечисляемой записи СПД;

-    error-handling может быть задан любой из четырех режимов (ErrorHandlingMode) (см. 8.1.3.3); если задан режим until-first-warning, то все члены группы СПД или записи, взятые из списка результатов поиска СПД, перечисляются в заданном порядке до появления первого предупреждения;

-    priority, см. 8.1.3.4;

-    privileges, см. 8.1.3.5.

8.2.7.2    Результат ListResult

В случае успешного завершения запроса должен быть возвращен результат ListResult: ListResult : : = SEQUENCE {

COMPONENTS OF

CommonListSearchResult,

42