Описание конфигуратора

V 6.7

КОНФИГУРАТОР

Что такое конфигуратор

Конфигуратор – инструмент для создания конфигурации.

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

Конфигурация отражает связи отдельных действий с результатами деятельности, представленные в исходном описании деятельности, как связь операций (действий) и показателей (результатов).

Конфигурация представляет собой набор метаданных, которые в ходе использования решения интерпретируются платформой и, таким образом, определяют какие данные будут собираться (операции) и какая информация будет предоставляться (показатели).

Она состоит из:

• операций
• показателей
• справочников
• ролей
• списков
• печатных форм

Структура бизнес-логики в конфигураторе

Структура бизнес-логики в конфигураторе отражена в виде дерева.

Как начать работу с конфигуратором

Как работает поиск в конфигураторе

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

ПОКАЗАТЕЛЬ

Что такое показатель

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

Каждый показатель обладает перечнем аналитических разрезов (аналитик), которые используются при конструировании представлений информации (отчетов, диаграмм, графиков, виджетов) и их отображении для пользователя.

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

Как создать показатель

Как добавить аналитику в показатель

• Для добавления существующей аналитики выберите ее из списка.

• При создании новой аналитики, укажите ее наименование и тип данных.

• Воспользуйтесь кнопкой «Добавить и закрыть», чтобы установить аналитику в показатель.

• Воспользуйтесь кнопкой «Добавить» для последовательного добавления нескольких аналитик. В конце нажмите кнопку «Закрыть».

Как выбрать и установить тип данных аналитики

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

Часто используемые типы данных:

String/строка (тип поля при хранении в базе данных str_val),
Date/дата (date_val),
Decimal/дробное (dbl_val),
Currency/деньги (cur_val),
Integer/целое (long_val).

Для работы показателя необходимо в список его аналитик (параметров) добавить параметр с наименованием самого показателя.

У данного параметра необходимо указать наименование (заполняется при создании), системное наименование (внутреннее наименование, которое используется в системе и обычным пользователям не видно), «тип данных» и «функция агрегации» значений в показателе. Все эти характеристики заполняются в виде правил в соответствующих полях. Принято в качестве системного наименования данного параметра использовать префикс «ActValue» и далее код из номера созданного показателя.

Особенности системного показателя

Системные показатели используются и заполняются системой без привязки к операциям.
Наименования системных показателей заданы системой и не должны меняться.
Системные показатели содержат определенный перечень аналитик, наименования которых также не должны изменяться.
Примеры таких показателей и цель их использования:
- «Лог» - в данном показателе логируются (записываются) все изменения элементов всех справочников и их параметров .
- «Лог операций» - в данном показателе содержатся записи обо всех изменениях в операциях
- «Лог списков» - в данном показателе содержатся записи обо всех изменениях в атрибутах типа список
- «Статистика использования Bill RP» - содержит данные о действиях пользователей в системе с объектами типа отчет, интерфейс
- «Сообщения о ходе импорта» - показатель содержит информацию о прохождении импорта данных (стандартного обмена данными).
Перечень показателей, которые нужны для работы ленты (обмена сообщениями между пользователями):
- «Разговоры»
- «Разговоры - прикреплённые объекты»
- «Разговоры - сообщения»
- «Разговоры - участники»
- «Непрочитанные сообщения»
- «Прочитанные сообщения»
- «Сообщения пользователей»

Хранение данных показателей

Значения показателя в базе данных хранятся в отдельной таблице.
Наименования таблиц начинаются с «CROSS_JRN_...» и заканчиваются системным кодом показателя, присвоенным конфигуратором.

ОПЕРАЦИЯ

Что такое операция

Операция – это единый и неделимый набор данных о произведенном действии. Все данные операции хранятся в ее атрибутах.

Все операции разделены на типы. В зависимости от типа, операции обладают различными наборами атрибутов.

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

Операция создается моментально и немедленно влияет на все связанные с нею показатели. Момент формирования проводок определяется переводом операции в состояние «проведена».

Как создать операцию

Как добавить параметр в заголовок операции

Как выбрать тип данных параметра

При создании, параметру заголовка операции по умолчанию присваивается тип Integer (целое). Это значит, что допустимо только целое значение.

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

Меняйте и устанавливайте подходящий тип данных параметра в разделе Свойства.

Особенности системного параметра операции

Описание характеристик параметра:

• значение по умолчанию – значение которое будет установлено автоматически в параметр при создании операции;
• скрытый – при установке данной характеристики, параметр будет автоматически скрыт при создании операции;
• только для чтения – значение параметра будет невозможно изменить/установить вручную при создании операции;
• обязательный – операция не перейдет в состояние «Сохранена», пока не заполнены все параметры с установленной характеристикой «Обязательный»;
• у параметров, которые содержат ссылку на другие операции (параметры типа «Основание» или параметры со ссылкой на «Журнал операций»), должен быть заполнен источник данных.

Системные параметры операции имеют отличный от других способ хранения данных. Значения таких параметров хранятся в таблице [OPER_HEADERS_JRN].

Свойство «Название для отображения» по умолчанию заполняется системным названием атрибута. Для изменения данного свойства только для выбранной операции устанавливаете «галку» и правее указываете новое название.
Для изменения свойства «Обязательный» у атрибута требуется установить первую галку и установить или убрать вторую галку. Первая галка при установке означает, что свойство будет настраиваться. И по умолчанию первая галка не установлена – в данном случае система считает атрибут обязательным для заполнения. При установленной первой галки и снятой второй (как на примере) система считает атрибут не обязательным для заполнения.

Кроме основных типов правил и настроек параметров в конфигураторе на параметре можно добавить правила до изменения или после изменения.
Создание функций/процедур для правил описано в разделе «Функции и процедуры на VB в проекте».

Хранение данных операции

Таблица [OPER_HEADERS_JRN] содержит все операции в базе данных.

АТРИБУТ И АНАЛИТИКА

Что такое атрибут

Атрибут – именованная единица хранения первичных данных определенного типа (число, текст, дата и т.п.)

Существуют атрибуты элементов справочников (или просто «атрибуты справочников») и атрибуты операций (назначаются на типы операций).

Атрибут справочника существует у всех его элементов и связан с какой-то характеристикой соответствующего объекта в деятельности.

Атрибут операции существует у всех операций данного типа и связан с какой-то характеристикой производимого действия.

Атрибутами в конфигурации представлены свойства данных.

Как создать аналитику

• Для добавления аналитики или атрибута выберите элемент из списка или создайте новый

• Заполните параметр «Название для отображения».

• Укажите тип данных.

Системное наименование аналитики показателей начинается с «attr» или с «dim». Системное наименование атрибутов операций начинается с «attr».

Как настроить тип данных аналитики

Атрибутам, аналитикам должен быть присвоен тип данных.


Основные типы данных:
String/строка (тип поля при хранении в базе данных str_val),
Date/дата (date_val),
Decimal/дробное (dbl_val),
Currency/деньги (cur_val),
Integer/целое (long_val).

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

Настройка типа данных: каждый тип данных имеет возможность настройки.

Особенность типа данных KEY: значение содержит ссылку на другой элемент справочника или другую операцию

Хранение данных атрибута и аналитики

Системные параметры хранятся в таблице [OPER_HEADERS_JRN]
Перечень параметров: [NUM_HEADER], [ID_DOCUMENT], [NUM_HEADER_UP], [ID_REG], [ID_SCLAD_IN], [ID_SCLAD_OUT],
[ID_PARTNER], [ID_EMPLOY], [ID_PSCALE], [ID_CURRENCY], [NUMBER], [KURS], [SUMMA], [DATEOPER], [ID_AUTOR], [STATE], [ID_CREATOR], [GRAND_HEADER],[FK]).

Атрибуты операций и справочников хранятся в отдельных таблицах. При загрузке конфигурации для каждого нового атрибута создается соответствующая таблица вида:
CREATE TABLE [dbo].[ATTRIB_7636]
( [CD_THEME] [int] NOT NULL,
[ID_ITEM] [int] NOT NULL,
[ATTRIB_VALUE] [bit] NULL)

Название таблицы соответствует системному названию атрибута.
Поле [CD_THEME] может содержать значения: код справочника, для которого заполнен атрибут; код 25 (означает, что атрибут принадлежит операции); код 26 (означает, что атрибут принадлежит строке операции).
Поле [ID_ITEM] содержит код элемента справочника, или код операции, или код строки операции, для которой заполнен данный атрибут.
Поле [ATTRIB_VALUE] – содержит значение атрибута.

Как заполнить атрибут в операции

Используйте правило типа «Ограничение» (д.б. оформлено в виде SQL-кода) для выбора списка элементов в атрибуте.

АТРИБУТ ТИПА СПИСОК

Что такое атрибут типа список

Атрибут типа список – это атрибут, значение которого представлено коллекцией элементов.

Элементы коллекции могут обладать характеристиками, индивидуальными для каждого атрибута типа список.

Модификатор, формирующий проводки на основании атрибута типа список, создаст проводку для каждого элемента коллекции.

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

Используйте один или несколько атрибутов типа список в операции или справочнике.

Возможно использование атрибута типа список на других атрибутах типа список.

Как создать атрибут типа список

Виды атрибутов типа список

Стандартные атрибуты типа список хранят любые данные разных типов.
Данные каждого атрибута типа список хранятся в отдельной таблице.
Название таблиц содержит [ATTR_...] + системный код атрибута.
Количество параметров и сами параметры добавляются в атрибут типа список по потребности конфигурации.

Строки операций хранят только списки товаров, с заданными в системе и в конфигурации параметрами.
Данные из строк операций хранятся в одной таблице [OPER_ROWS_JRN].
Для «строк операций» существуют обязательные параметры.

Хранение данных атрибутов

......

СТРОКИ ОПЕРАЦИИ

Что такое строки операции

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

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

Во-вторых, платформа позволяет хранить данные о количестве товара в разных единицах измерения с заданной точностью.

В системе предусмотрено два типа строк:
строки, влияющие на остатки товаров,
строки, не влияют на остатки товаров и служат только для хранения перечня строк.

Как создать строки операции

Создавайте отдельный экземпляр «строк операции» для каждого типа операций. Уникальность связи обеспечивает сочетание кода операции и Внешнего ключа строк:

Добавляйте в качестве новых элементов в строки операции товары справочника товаров,
строки других операций

Как создать операцию со строками

Для связи строк и операцией, заполните два правила: «MoveRows» и «BaseOfRows»

«MoveRows» - правило, которое указывает влияют ли строки данной операции на остатки или нет. Значение типа «Boolean», может иметь два значения «True» (влияют на остатки) или «False» (не влияют на остатки).

«BaseOfRows» - правило, которое указывает какой источник кандидатов будет у данной операции. Значение типа «Целое», может быть значения «1» - справочник товаров, «2» - строки других операций.

Как ограничить кандидатов в операции

Чтобы ограничить кандидаты операции со строками, создайте правило на заголовке операции:

• Добавьте одно или несколько правил
• Выберите тип правила «OperationRowCandidateCondition».
• Укажите Тип значения «function».
• Запишите в поле «Значение» имя vb-функции (при вызове она вернет условия для получения кандидатов).

Правила на заголовках операции служат для ограничения кандидатов.
Правила на строках операции служат для проверки остатков и сохранения целостности данных.
Система при подъеме кандидатов и проверке остатков строит SQL-запрос. В связи с этим правила для подъема кандидатов и для проверки остатков представляют собой функции, которые возвращают участок sql-кода, который будет подставлен в результирующий запрос.
Для конфигурирования кандидатов на заголовке операции и на строках могут использоваться одни и те же правила.
На заголовке операции и на строках используется один и тот же тип правил:

Как настроить проверку остатков

Чтобы проверить остатки в операции со строками, создайте правило на строках операции:

• Добавьте правило
• Выберите тип правила «OperationRowCandidateCondition».
• Укажите Тип значения «function».
• Запишите в поле «Значение» имя vb-функции (при вызове она вернет условия для получения остатков).

Хранение данных строк операций

Хранение данных в строках операций позволяет сохранять и отслеживать целостность определенного вида данных: остатков и движения товаров. Параметры хранения строк операций в базе содержатся в таблице [OPER_ROWS_JRN].

Список таких параметров:
Единица измерения (id_unit)
Количество (строки) (kol_oper_rate)
Количество_еи (kol_oper)
Остаток_еи (kol_ost)
Товар (id_product)
Цена (price)

Параметры, системное наименование которых начинается с «attr» хранятся в отдельных таблицах.

Типы правил для строк операции

«OperationSumCalc» - правило для расчета суммы операции при изменении данных в строках
«OperationRowDefaultPrice» - правило для установки цены по умолчанию
«OperationRowAdded» - правило срабатывает при добавлении новой строки в операции.

АТРИБУТ "ОСНОВАНИЕ"

Что такое атрибут "Основание"

Атрибут «Основание» – особый атрибут, позволяющий соединять взаимосвязанные операции в дерево. Это дает возможность не только быстро находить взаимосвязанные операции, но и предотвратить нарушения целостности данных, связанные с редактированием и удалением операций.

ПРАВИЛО-ОСНОВАНИЕ

Что такое правило-основание

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

Правило создается в разделе «Скрытые»

При создании заполняется только наименование

После создания нового правила-основания (если оно было создано не копированием из другого правила) необходимо обновить данные в конфигурации – повторным подключением или обновлением данных (в меню пункт «Обновить»).

Далее заполняются параметры правила:

1. Необходимо в параметре «Источник» выбрать показатель
2. Заполняете «Свойства» (аналитики), т.е. добавляете все аналитики, которые будут участвовать в построении «Основания»
3. Указываете «Ключевое свойство» - аналитика, которая содержит код операции, попадающий в «Основание».
4. Заполняете вручную «Условие», т.е. условие в соответствии с которым можно будет выбрать операцию из показателя. В качестве условия могут быть значение показателя, либо аналитики. При формировании условия можно использовать значения параметров операции. Например, {dateoper} или {attr1849}.
Пример такого условия: ActValue935 > 0 AND dim3 <= {dateoper} AND Dim373 = {attr1849}
5. Заполняете вручную «Строку форматирования», т.е. формируете внешний вид строки, которая будет отображаться пользователям при выборе основания.
Пример такой строки: Договор от {attr2920}, {Dim373}, {attr7468}. При этом вместо названия аналитик будут подставляться значения.

Как настроить основание для операции

Чтобы обеспечить ввод одной операции на основании других операций, используйте атрибут «Основание».

РОЛЬ

Что такое роль

Роль – это совокупность прав группы пользователей в рамках информационной системы. Права назначаются на работу с первичными данными и показателями, а также на работу с доступными пользователю объектами конечного решения: отчетами, сохраненными пользовательскими интерфейсами, точками контроля, обменами.

Как создать роль

Созданная роль доступна для использования после загрузки конфигурации.

Данные о роли хранятся в таблицах:
ROLES_LIST – таблица со списком ролей
EMPLOY_LIST – таблица со списком сотрудников
ROLES_EMPLOY_COM – таблица со связью между ролями и сотрудниками
select * from ROLES_LIST
select * from EMPLOY_LIST
select * from ROLES_EMPLOY_COM

СПРАВОЧНИКИ

Что такое справочник

Справочник – это перечень условно неизменных в процессе деятельности предприятия объектов определенного типа.
Справочник нужен для хранения часто используемых, редко изменяемых однотипных данных. Например, список складов или список клиентов.
Элементы справочников используются в операциях, списках, показателях, в других справочниках.

Как создать справочник

При создании и добавлении справочников в конфигураторе, они отображаются в каталоге "Общие"

У справочников есть свои уникальные номера.

Перед началом работы со справочником необходимо загрузить конфигурацию в базу.

Пользовательский справочник

Пользовательский справочник от системного отличается системой хранения данных

Список пользовательских справочников хранится в таблице [REF_LIST]
Элементы пользовательских справочников хранятся в одной таблице [ITEM_LIST]
Уникальные номера пользовательских справочников начинаются со 101.

При создании пользовательского справочника конфигуратор предложит название, которое можно сохранить, а можно заменить.

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

Системный справочник

Список системных справочников хранится в таблице [THEME_REF].
Элементы системных справочников хранятся в отдельных таблицах.
Информация о распределении элементов системного справочника хранится в таблице [THEME_REF], в поле «префикс». Добавив к префиксу «_list», можно понять, элементы какого справочника хранятся в таблице (например, таблица [SCLAD_LIST] хранит элементы справочника складов).

Уникальные номера системных справочников лежат в границах от 1 до 99.
При создании таких справочников допустимо их копировать из других конфигураций.

• Заполните параметры справочника: «название», «название для отображения»,

«внешний ключ» - код справочника:

«Внешний ключ» соответствует коду справочника (CD_THEME).
Для удобства создания системных справочников можно воспользоваться копированием элементов между конфигурациями (в описании раздел «Дополнение. Копирование элементов между конфигурациями»). Т.е. можно скопировать справочник из другой конфигурации.
Все системные справочники, добавленные в конфигурацию, должны быть «вручную» (путем редактирования таблицы – столбца Activ) активированы в таблице [Theme_Ref]. Т.е. в столбце Activ должна быть установлена «1», а у справочников не используемых в данной конфигурации должен быть установлен «0»

Как активировать системный справочник

Для того, чтобы вновь созданными справочником можно было воспользоваться в системе, необходимо загрузить конфигурацию в базу.
В случае добавления в конфигурацию системного справочника, его требуется «активировать» в базе данных в таблице [THEME_REF]. Для этого в поле [ACTIV] установить значение 1.

Как добавить параметры в справочник

Добавьте из списка или создайте новый параметр в разделе «Свойства»:

Нельзя добавлять параметры, системное наименование которых начинается с Dim.

Используйте системный параметр справочника «Активен» (activ) для включения/исключения доступа к любому элементу, без его удаления.

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

Добавляйте в справочник атрибуты типа список, системное наименование которых начинается с «Detail»

Виды правил в справочниках

При работе со справочниками применяется несколько основных видов правил:

• тонкие права
• правила на элементах справочников
• правила на параметрах справочников

Назначение тонких прав

Добавьте на справочнике правило типа «Constraint» для ограничения видимости элементов определенным пользователям (например, ограничение по заданным условиям списка клиентов в справочнике для менеджера по продажам).

При назначении тонких прав, заполните вручную тип значения «sql»:

Правила на элементах справочников

«PropertyEditableEvent» - запрет или разрешение редактирование элементов справочников.
«CatalogChangedEvent» - выполнение правила происходит после редактирования элемента справочника.
Добавляя правило, в столбце «Тип значения» укажите тип «function»

Добавляя правило, в столбце «Тип значения» укажите тип «function»

В поле «Значение» укажите название функции, которая будет вызвана правилом.
Функция, которая вызывается при срабатывании правила «PropertyEditableEvent» должна возвращать значение типа Boolean.

Правила на параметрах справочников

Правила на параметрах справочника позволяют расширить функционал справочника, автоматизировать работу со справочником.

• значение по умолчанию – правило, при помощи которого можно установить значение по умолчанию для параметра при создании нового элемента в справочнике.
• после изменения – правило, которое выполнится после того, как будет создан элемент в справочнике
• при изменении – правило срабатывает при создании нового элемента в справочнике
• ограничения – правило, позволяет ограничить список отображаемых элементов, которые можно выбрать для заполнения параметра.

Пример применения ограничения:

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

Пример использования маски ввода:

Единицы измерения в справочнике товаров

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

Основная ед. изм. используется при вводе данных и устанавливается автоматически
Базовая ед. изм. хранит в себе данные по движению товаров.


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

На один элемент справочника товаров может быть назначено несколько единиц измерения. Минимум – одна единица измерения (в случае, когда базовая единица измерения является основной).


Соотношение основной единицы измерения к базовой содержится в одноименном столбце:

Хранение данных единиц измерения

При заполнении параметров, данные записываются в таблицу [PRODUCT_LIST]:
select ID_PRODUCT, NAME, ID_UNIT_BASE, ID_UNIT_DEFAULT from PRODUCT_LIST

Значения полей в таблице:
ID_PRODUCT – код товара в справочнике
NAME – наименование товара
ID_UNIT_BASE – код базовой единицы измерения (ссылка на код ед. изм. в справочнике единиц измерения)
ID_UNIT_DEFAULT – код основной единицы измерения (ссылка на код ед. изм. в справочнике единиц измерения)

ПЕЧАТНАЯ ФОРМА

Что такое печатная форма

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

Как создать печатную форму

• Заполните параметр «Системное имя» (укажите наименование печатной формы)

Установите галочку у параметра «Основан на элементе» (это позволит использовать ПФ на операциях):

Системное наименование (поле «Название») присваивается автоматически и используется для идентификации отчета.

• Заполните поле «Название для отображения». Оно доступно пользователю при просмотре и печати

Галка не ставится, если вызов печатной формы в платформе осуществляется командами, написанными кодом.

МОДИФИКАТОР

Что такое модификатор

Модификатор – это объект конфигурации, связанный с типом операций и определяющий из каких данных и каким способом будут формироваться проводки при создании операции данного типа.

Как создать модификатор

Типы источников данных в модификаторах

Для получения данных через модификаторы используйте следующие типы источников данных:

• параметры и атрибуты операций
• строки и списки операций
• sql-функции, возвращающие табличные значения

Получение данных из атрибута типа список

Заполните параметр «Источник проводок» для получения данных через модификаторы из строк и/или атрибутов типа список:

Получение данных с помощью SQL-функции

Используйте табличную SQL-функцию в качестве источника данных для модификатора.
Для этого укажите название SQL-функции в параметре «Источник проводок»
Функция получает код операции, который передается через параметр «@nh»

Одно из полей функции возвращает код операции в поле с названием «ID_ITEM».
Остальные возвращаемые поля зависят от решаемой задачи.

Создание условий на модификаторы

Используйте условия для ввода ограничений при заполнении показателей модификаторами. Оформление «условий» подобно оформлению модификаторов:

В данном примере наложено условие на значение параметра «склад отгрузки» операции и атрибут справочника складов.

Создание ограничений на модификаторе

При желании ограничить перечень элементов атрибута типа список, доступных в качестве источника проводок:

• добавьте к модификатору правило типа «Constraint».
• Укажите тип значения «sql»
• Напишите в поле значения ограничение на языке sql.

Ограничение будет добавлено в итоговый запрос на получение списка проводок в секцию «where».