Описание
Пункты конфигурации DocForDoc являются частью конфигурации DocExt и описывают, как один документ получает другие. Пункты конфигурации предоставляют множество возможностей для простого получения и выбора документов из представлений в Ваших приложениях.
Пункты конфигурации DocForDoc должны вноситься на закладке DocForDoc конфигурации DocExt. Используйте новую строку для каждого пункта. Первый пункт конфигурирует значения по умолчанию и каждый последующий пункт конфигурирует получение документов. Каждый пункт получения в DocForDoc конфигурирует как документы, представленные данной конфигурацией DocExt ( целевые документы ), будут получены из какого-либо другого документа ( исходный документ ).
К пункту получения DocForDoc можно обращаться из пунктов конфигураций Doc и DocUpDoc и нескольких публичных функций библиотеки DocExtLib.
Формат пункта
Пункт значений по умолчанию конфигурации DocForDoc является первым пунктом из всех. Этот пункт определяет значения по умолчанию для получения целевых документов в каком-либо пункте DocForDoc.
Формат пункта значений по умолчанию:
APP[ наименование ] VIEW[ наименование ] PICK[ наименование ] FOLDER[ наименование ]
Описание формата:
APP[ наименование ] - наименование приложения ( в проекте ), из которого будет получены целевые документы. Проекты и их приложения определяются конфигурациями типа Project.
VIEW[ наименование ] - наименование представления, из которого будут получены целевые документы.
PICK[ наименование ] - наименование представления, из которого будут выбираться целевые документы пользователем.
FOLDER[ наименование ] - наименование папки ( не представления ), из которого будут выбраны целевые документы пользователем. Папка будет использована вместо представления ( тег PICK ) либо чтобы выбрать документы по более чем одному ключу, либо когда проверяется условие для целевых документов с помощью тегов TRG или BOTH.
Пункты получение документов должны размещаться под пунктом значений по умолчанию ( первым ) в конфигурации DocForDoc. Вводите каждый новый пункт конфигурации на новой строке.
Формат пункта получения документов:
наименование [ описание ] SRC{ условие } KEY{ формула } TRG{ условие } BOTH{ условие } APP[ наименование ] PRJ[ наименование ] VIEW[ наименование ] PICK[ наименование ] FOLDER[ наименование ] CAT{ формула }
Описание формата:
наименование - уникальное наименование пункта в конфигурации ( без пробелов ). Рекомендуется использовать короткое наименование и начать его с текста, соответствующего исходным документам, например - наименование их формы. Полное наименование пункта конфигурации, с помощью которого можно обращаться к пункту, будет являться объединением наименований конфигурации и его пункта через символ "4". Таким образом, полное наименование пункта будет содержать информацию как о целевых документах, так и об исходном документе. Например, если конфигурация DocExt называется "Contract" ( целевые документы ) и пункт конфигурации DocForDoc называется "Company" ( исходный документ ), то полное наименование пункта конфигурации будет "Contract4Company". Чтобы обратиться к пункту конфигурации DocForDoc откуда-либо, Вы должны всегда использовать его полное наименование.
[ описание ] - текст описания для пункта. Например - [ Договоры для Компании ].
SRC{ условие } - определяет когда выполнять получение документов. Условие проверяется для исходного документа.
KEY{ формула } - вычисляет ключ, чтобы получить или выбрать целевые документы в представлении. Результатом должен быть текст. Формула вычисляется на исходном документе.
TRG{ условие } - определяет когда целевой документ остается в полученном списке документов. Условие проверяется для каждого целевого документа, полученного из представления ( тег VIEW ) по ключу ( тег KEY ).
BOTH{ условие } - определяет когда целевой документ остается в полученном списке документов. Условие проверяется для каждого целевого документа, полученного из представления ( тег VIEW ) по ключу ( тег KEY ) и затем проверенного условием ( тег TRG ), и для исходного документа одновременно. Внутри формулы пишите теги SRC[ наименование ] и TRG[ наименование ], чтобы использовать значение поля с указанным наименованием в исходном и целевом документе соответственно. Результатом, полученным тегом SRC или TRG, всегда будет текст, заключенный в кавычки. Если результатом тега будет список, то каждое его значение будет заключено в кавычки с разделением всех значений двоеточием между собой для преобразования этого списка в формат Языка Формул.
VIEW[ наименование ] or VIEW{ формула } - наименование представления или формула, вычисляющая его. Заменяет наименование, указанное в теге VIEW пункта конфигурации со значениями по умолчанию.
PICK[ наименование ] or PICK{ формула } - наименование представления или формула, вычисляющая его. Заменяет наименование, указанное в теге PICK пункта конфигурации со значениями по умолчанию.
FOLDER[ наименование ] or FOLDER{ формула } - наименование папки или формула, вычисляющая его. Заменяет наименование, указанное в теге FOLDER пункта конфигурации со значениями по умолчанию.
CAT{ формула } - вычисляет единственную категорию для отображения документов в папке. Тег имеет значение только для выбора пользователем документов в папке, полученной тегом FOLDER, когда результатом тега KEY является список.
APP[ наименование ] or APP{ формула } - наименование приложения ( в проекте ) или формула, вычисляющая его. Заменяет наименование, указанное в теге APP пункта конфигурации со значениями по умолчанию. Проекты и их приложения определяются конфигурациями типа Project.
PRJ[ наименование ] or PRJ{ формула } - наименование проекта с приложением, определяемым тегом APP. Используйте этот тег только если проект целевых документов отличается от проекта исходного документа. Проекты и их приложения определяются конфигурациями типа Project.
В тегах VIEW, PICK, FOLDER, APP, PRJ со скобками { } формула вычисляется на исходном документе. Этими тегами, а также тегом KEY, Вы можете вычислять список в качестве результата, но в таком случае размерности списков либо должны быть равными между собой, либо должны равняться одному.
Ссылки по теме:
Смотрите также: