<< Щелкните, чтобы показать Содержание >> Администратору > Настройка модулей > Справочники > Фильтрация справочников

Открыть фильтруемый справочник

Contents

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

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

Выполнение сценария зависит от настройки варианта запуска фильтруемого справочника. Если параметр FilterRequisiteValues указан, то открывается справочник, отфильтрованный по заданным значениям. Значения полей дополнительного фильтра не запрашиваются.

Если параметр FilterRequisiteValues не указан, то открывается окно «Дополнительный фильтр» со списком реквизитов, запрашиваемых для конкретного справочника. Например, при открытии справочника Договоры на экране появится окно «Дополнительный фильтр» с запросом параметров для фильтрации справочника.

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

При заполнении полей в окне «Дополнительный фильтр» необходимо учитывать особенности:

•	для реквизитов типа «Строка» может быть указана часть значения, в этом случае в справочнике будут все записи, в которых соответствующий реквизит содержит введенное значение;

•	для реквизитов типа «Признак», «Дата» и «Справочник» должны быть указаны точные значения. Значения реквизитов типа «Признак» выбираются из списка допустимых значений, реквизитов типа «Дата» – из календаря, реквизитов типа «Справочник» – из соответствующего справочника.

Примечание

При заполнении реквизитов дополнительного фильтра, предполагающих выбор из фильтруемых справочников, следует использовать стандартный механизм like-ввода. В результате откроется справочник со списком записей, удовлетворяющих введенному значению. Если таких записей нет, тогда справочник откроется пустым. В таком случае, необходимо либо добавить новую запись в справочнике, либо, если ошиблись с вводом значения, закрыть справочник и ввести в поле еще раз нужное значение. Для данного примера таким полем является поле Организация.

Параметры запуска сценария

Параметр

Описание

NeedRepeatFilter

Признак повторного показа окна «Дополнительный фильтр» после закрытия справочника. Возможные значения:

•	-1 – показывать окно «Дополнительный фильтр» после каждого закрытия справочника до тех пор, пока в этом окне не будет нажата кнопка Отмена;

•	0 – не показывать окно после закрытия справочника.

По умолчанию имеет значение 0.

Повторное открытие окна «Дополнительный фильтр» удобно использовать, когда точные критерии поиска нужных записей в справочнике заранее не известны, и поиск может выполняться в несколько этапов. Например, пользователи регулярно ищут входящие РКК по дате их регистрации, но точная дата, как правило, не известна. В этом случае критерии поиска удобно запрашивать несколько раз

ReferenceName

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

FilterRequisiteValues

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

<ИмяРеквизита1>=<ЗначениеРеквизита1>; …

<ИмяРеквизитаN>=<ЗначениеРеквизитаN>.

Формат передаваемого значения зависит от типа реквизита:

•	для реквизитов типа «Строка» можно передавать часть значения;

•	для реквизитов типа «Признак» и «Дата» следует передавать отображаемое значение;

•	для реквизитов типа «Справочник» – код записи справочника.

Например,

«Организация=Д000020;Реквизит=4;Дата2=08.09.2017».

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

Если данный параметр указан, то параметр NeedRepeatFilter игнорируется

ViewName

Имя представления открываемого справочника. Если параметр не задан, справочник открывается в главном представлении

Например, для открытия справочника Договоры без повторного показа окна «Дополнительный фильтр» и отфильтрованного по коду значений реквизитов Организация, Категория договора, по части значения реквизита Номер договора, по точному значению реквизита Дата договора, можно использовать следующую командную строку. Подробнее см. раздел «Ключи файла SBLauncher»:

sblauncher.exe -S="SQLSERVER" -D="DIRECTUM" -СТ="Script" –F="LaunchFilteredReference" -R="NeedRepeatFilter=0|ReferenceName=ДГВ| FilterRequisiteValues=Организация=Д000020;КатегорияДоговора=Д000004; Реквизит=4;Дата2=08.09.2007"

При настройке соответствующего варианта запуска сценария в компоненте «Настройка вариантов запуска компонент» в поле карточки Дополнительные параметры нужно указать следующее значение:

-R="NeedRepeatFilter=0|ReferenceName=ДГВ| FilterRequisiteValues=Организация=Д000020;КатегорияДоговора=Д000004; Реквизит=4;Дата2=08.09.2007"

Если для данного сценария настроены параметры запуска, тогда в компоненте Настройка вариантов запуска компонент в поле карточки Дополнительные параметры можно указать следующее значение:

-R="LaunchParamsCode=<КОД>"

где

КОД – код, заданный при настройке набора значений параметров сценария Открыть фильтруемый справочник в справочнике Параметры запуска компонент.

Сообщество пользователей DIRECTUM