JoinSection — класс

Предоставляет данные присоединенной секции в поисковом запросе.

Синтаксис

public abstract class JoinSection

Свойства

Имя Описание

Alias

Задаёт или возвращает псевдоним данного присоединения (присоединения секции).

Id

Задаёт или возвращает идентификатор секции, к которой выполнено присоединение.

JoinWith

Задаёт или возвращает псевдоним присоединения, если данное присоединение от другого присоединения.

ReturnFields

Не используется.

SectionField

Задаёт или возвращает название поля, к которому выполнено присоединение.

SectionQuery

Задаёт или возвращает текущий поисковый запрос.

TableName

Задаёт или возвращает название SQL-таблицы, если выполнено присоединение к таблице базы данных. Указывать ID не требуется.

WithField

Задаёт или возвращает псевдоним поля, от которого присоединяется секция.

Примеры

В качестве примера, найдем документы, автором которых является сотрудник с табельным номером 456.

SearchQuery searchQuery = userSession.CreateSearchQuery(); (1)

CardTypeQuery cardTypeQuery = searchQuery.AttributiveSearch.CardTypeQueries.AddNew(CardDocument.ID); (2)

SectionQuery sectionQuery = cardTypeQuery.SectionQueries.AddNew(CardDocument.MainInfo.ID); (3)

JoinSection joinSection = sectionQuery.JoinSections.AddNew("Author1"); (4)

joinSection.Id = RefStaff.Employees.ID; (5)

joinSection.SectionField = "RowID"; (6)

joinSection.WithField = CardDocument.MainInfo.Author; (7)

Condition condition = sectionQuery.ConditionGroup.Conditions.AddNew(RefStaff.Employees.ClockNumber, FieldType.Unistring, ConditionOperation.Equals, "456"); (8)

condition.SectionAlias = joinSection.Alias; (9)

CardDataCollection result = userSession.CardManager.FindCards(searchQuery.GetXml()); (10)
1 Создаем поисковый запрос.
2 Создаем поиск по типу карточки.
3 Добавляем поиск по секции карточки Основная информация.
4 Создаем присоединяемую секцию с псевдонимом Author1.
5 Указываем идентификатор секции, к которой присоединяемся — сотрудники Справочника сотрудников.
6 Указываем идентификатор поля, к которому присоединяемся — идентификатор сотрудника.
7 Указываем псевдоним поля основной секции, по которому выполняется присоединение — автор документа.
8 Добавляем условие поиска по табельному номеру.
9 Указываем псевдоним секции, по которой выполняется поиск — псевдоним присоединенной секции.
10 Выполняем поиск и получаем результат — карточки, автором которых является сотрудник с табельным номером 456.