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

Параметры запуска

Предыдущий раздел В начало Следующий раздел

При выполнении сценария Открыть фильтруемый справочник должны быть указаны следующие параметры запуска:

Параметр

Описание

NeedRepeatFilter

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

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

ReferenceName

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

FilterRequisiteValues

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

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

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

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

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

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

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

Например,

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

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

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

Например, для открытия справочника Договоры без повторного показа окна «Дополнительный фильтр» и отфильтрованного по коду значений реквизитов Организация, Категория договора, по части значения реквизита Номер договора, по точному значению реквизита Дата договора, можно использовать следующую командную строку (описание назначений ключей см. в руководстве администратора, раздел «Ключи файла 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=<КОД>"

где

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