Универсальные концепции

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

Теги объектов

Система Papyrus оперирует значительным количеством объектов данных (эта концепция рассмотрена на стр. link). Каждый тип объекта данных определяется собственным встроенным набором атрибутов. Для расширения этого набора применяется механизм тегов объектов.

Общий принцип работы тегов состоит в том, что вы определяете типы тегов, свойственные для данного типа объекта (теги персоналий, теги товаров и т.д.). К объектам же привязываете теги, относящиеся к заданным типам.Например, вы можете определить тег персоналии “Надежность плательщика” и к каким-либо клиентам привязывать оценку надежности его как плательщика.

На текущий момент теги можно привязывать к следующим объектам данных:

  • Персоналии
  • Локации
  • Товары
  • Документы
  • Лоты
  • Глобальные учетные записи
  • Интернет-магазины Universe-HTT
  • Типы тегов

    Каждый прикрепленный к конкретному объекту тег должен относиться к предварительно определенному типу тега.

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

    Персоналии
    Справочники→ Админ→ Теги объектов→ Теги персоналий
    Товары
    Справочники→ Админ→ Теги объектов→ Теги товаров
    Документы
    Справочники→ Админ→ Теги объектов→ Теги документов
    Лоты
    Справочники→ Админ→ Теги объектов→ Теги лотов
    Глобальные учетные записи
    Справочники→ Админ→ Теги объектов→ Теги глобальных учетных записей
    При вызове любого из перечисленных пунктов меню открывается список просмотра типов тегов соответствующего объекта данных.

    Типы значений тегов

    Главное применение тегов - привязка настраиваемых значений к объектам данных. Эти значения могут иметь различные типы. Вот полный список возможных типов значений тегов с кратким описанием:
    Логический
    Такой тег может иметь только два значения: ИСТИНА или ЛОЖЬ.

    Строка
    Тег ассоциирует с объектом строки длиной до 127 символов (включительно).
    Число
    Вещественное число.

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

    Дата
    Календарная дата.
    Метка времени
    Комбинация дата/время.

    Значение метки времени хранится в формате Microsoft Ole (как число с плавающей точкой двойной точности).

    Объект
    Значением тега является ссылка на объект данных из этой же базы данных.

    Пока применение данного типа ограничено: может быть использовано только для лотов и связанным объектом может быть лишь персоналия и сертификат качества.

    GUID
    Глобально уникальный идентификатор.

    Изображение
    Файл изображения.

    Параметры типа тега

    Диалог редактирования типа тегаДиалог редактирования записи типа тега приведен на рис. link. Далее приводится описание управляющих элементов этого диалога.

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

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

    Наименование
    Уникальное среди всех типов тегов наименование.
    Символ
    Символьное обозначение типа тега, используемое для доступа к тегам из внешних программ и для импорта/экспорта.

    Символ может быть пустым, но если он указан, то система проследит за его уникальностью.

    ▼Группа

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

    В этом комбо-боксе может быть выбрана группа, которой должен принадлежать данный тип тега.

    ✓Извещать о нулевом или отрицательном значении

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

    ✓Наследуемый

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

    ✓Извещение в кассовой панели

    что-то

    ✓Иерархическое перечисление

    что-то
    Тип
    Наименование типа значения тега. Как упоминалось выше, тип значения нельзя менять после создания нового тега. Поэтому, данное поле не допускает радактирования.

    ▼Группа объектов

    Этот комбо-бокс доступен только для тегов с типом значения Объект. Группа объектов позволяет уточнить набор объектов, с которым может быть связано значение тега. Для тегов, связанных с персоналиями, группа объектов позволяет выбрать вид персоналии.

    [Элементы перечисления]

    Кнопка доступна только для тегов с типом значений Перечисление. Нажатие кнопки открывает для редактирования список элементов перечисления.

    Значения тегов

    Список значений теговЗначения тегов объекта обычно отображаются для просмотра и редактирования в виде списка, изображенного на рис. link. Кнопки [Редакт], [Добавить], [Удалить] служат, соответственно, для редактирования, создания и удаления элементов списка.

    Перед созданием нового тега объекта программа запрашивает тип, предлагая список выбора, в котором перечислены типы тегов, определенные для объекта данных (для товаров, персоналий и т.д.).Диалог редактирования тега зависит от выбранного типа тега. Для примера на рис. link приведен вид диалога редактирования перечисляемого тега.

    Диалог редактирования значения перечисляемого тега.

    Фильтр значений тегов

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

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

    Список тегов и ограничений
    Список, в котором отображаются установленные ограничения.

    [Добавить]

    Создать новое ограничение.

    [Редакт]

    Изменить выбранное ограничение.

    [Удалить]

    Удалить выбранное ограничение.

    [Очистить]

    Удалить все ограничения.

    [Вверх]

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

    [Вниз]

    Кнопка для перемещения выбранного ограничения вниз по списку. Назначение аналогично кнопке [Вверх], но с обратными смыслом.

    ✓Отсутствие данных тегов

    Установка этого флага предписывает системе выбирать только те объекты, для которых отсутствуют все указанные в списке теги. При этом ограничения, естественно, игнорируются - принимаются во внимание только перечисленные типы тегов.

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

    Диалог критерия значения тегаНа рис. link показан диалог одного критерия фильтра значений тегов.

    ▼Тег

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

    [...]

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

    Выбор специальных критериев

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

    Зарезервированные и специальные теги

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

    Зарезервированные теги

    Эти теги создаются автоматически командой Создание зарезервированных объектов.

    Права агента на доступ к кассовым операциям
    ИД=4
    Символ = POSRIGHTS
    Тип объекта = PERSON
    Тип тега = STRING
    Дата рождения

    ИД=5
    Символ = DOB
    Тип объекта = PERSON
    Тип тега = DATE

    Права на доступ и изменение товаров
    ИД=10
    Символ = GOODSRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING
    Права на доступ и изменение персоналий

    ИД=11
    Символ = PERSONRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    Права на доступ и изменение персональных карт
    ИД=12
    Символ = SCARDRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING
    Префикс номеров персональных карт

    ИД=13
    Символ = SCARDPREFIX
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    Дата производства
    ИД=14
    Символ = MANUFTIME
    Тип объекта = LOT
    Тип тега = TIMESTAMP
    Права на доступ к файлам

    ИД=15
    Символ = FILESRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    UUID документа
    ИД=16
    Символ = BILLUUID
    Тип объекта = BILL
    Тип тега = UUID
    Ключевые слова товара

    ИД=17
    Символ = GOODSKEYWORDS
    Тип объекта = GOODS
    Тип тега = STRING

    Ключевые слова документа
    ИД=18
    Символ = BILLKEYWORDS
    Тип объекта = BILL
    Тип тега = STRING
    Символ тега приватной товарной группы

    ИД=19
    Символ = PGGTAGSYMB
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    Ключевые слова рабочих книг
    ИД=20
    Символ = WORKBOOKKEYWORDS
    Тип объекта = WORKBOOK
    Тип тега = STRING
    Синонимы ключевых слов рабочих книг

    ИД=21
    Символ = WORKBOOKKWSYN
    Тип объекта = WORKBOOK
    Тип тега = STRING

    Локации ключевых слов рабочих книг
    ИД=22
    Символ = WORKBOOKKWLOC
    Тип объекта = WORKBOOK
    Тип тега = STRING
    UUID сессии, создавшей JUNK-чек

    ИД=23
    Символ = CCHECKJSUUID
    Тип объекта = CCHECK
    Тип тега = UUID

    Права на доступ и изменение автономных адресов
    ИД=24
    Символ = SALOCRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING
    Права на доступ и изменение рабочих книг

    ИД=25
    Символ = WORKBOOKRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    Длинный код рабочей книги
    ИД=26
    Символ = WORKBOOKLONGCODE
    Тип объекта = WORKBOOK
    Тип тега = STRING
    Метка автоматически созданного документа

    ИД=27
    Символ = BILLAUTOCREATION
    Тип объекта = BILL
    Тип тега = STRING

    Номер документа у контрагента
    ИД=28
    Символ = BILLOUTERCODE
    Тип объекта = BILL
    Тип тега = STRING
    Дата документа у контрагента

    ИД=29
    Символ = BILLOUTERDATE
    Тип объекта = BILL
    Тип тега = DATE

    Идент получателя эл налоговых документов
    ИД=30
    Символ = ENALOGDEST
    Тип объекта = PERSON
    Тип тега = STRING
    ФИАС-GUID адреса

    ИД=31
    Символ = FIASGUIDADR
    Тип объекта = LOCATION
    Тип тега = UUID

    ФИАС-GUID здания
    ИД=32
    Символ = FIASGUIDHSE
    Тип объекта = LOCATION
    Тип тега = UUID
    Права на доступ и изменение устройств Stylo

    ИД=33
    Символ = STYLORIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    Права на доступ и изменение процессоров
    ИД=34
    Символ = PRCRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING
    Права на доступ и изменение технологических сес

    ИД=35
    Символ = TSESSRIGHTS
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    UUID технологической сессии
    ИД=36
    Символ = TSESSUUID
    Тип объекта = TSESSION
    Тип тега = UUID
    Описание технологической сессии

    ИД=37
    Символ = TSESSDESCR
    Тип объекта = TSESSION
    Тип тега = STRING

    ФСРАР идентификатор склада
    ИД=38
    Символ = FSRARIDLOC
    Тип объекта = LOCATION
    Тип тега = STRING
    ФСРАР идентификатор предприятия

    ИД=39
    Символ = FSRARIDORG
    Тип объекта = PERSON
    Тип тега = STRING

    ФСРАР код справки А
    ИД=41
    Символ = FSRARINFALOTCODE
    Тип объекта = LOT
    Тип тега = STRING
    ФСРАР код справки Б

    ИД=42
    Символ = FSRARINFBLOTCODE
    Тип объекта = LOT
    Тип тега = STRING

    ФСРАР код товара в лоте
    ИД=43
    Символ = FSRARLOTGOODSCODE
    Тип объекта = LOT
    Тип тега = STRING
    EDI подтверждение доставки документа

    ИД=44
    Символ = EDIACKBILL
    Тип объекта = BILL
    Тип тега = STRING

    EDI идентификатор документа
    ИД=45
    Символ = EDIIDENTBILL
    Тип объекта = BILL
    Тип тега = STRING
    URL сервера ЕГАИС (склад)

    ИД=46
    Символ = EGAISSRVURL
    Тип объекта = LOCATION
    Тип тега = STRING

    ФСРАР данные справки А
    ИД=47
    Символ = EGIASINFAREG
    Тип объекта = LOT
    Тип тега = STRING
    URL сервера ЕГАИС (главная организация)

    ИД=48
    Символ = EGAISSRVURLMP
    Тип объекта = PERSON
    Тип тега = STRING

    EDI RECADV CONFIRM
    ИД=49
    Символ = EDIRECADVCONFIRM
    Тип объекта = BILL
    Тип тега = UUID
    Размерности лота

    ИД=50
    Символ = DIMENTIONS
    Тип объекта = LOT
    Тип тега = STRING

    EDI подтверждение отмены документа
    ИД=51
    Символ = EDIREJECTACKBILL
    Тип объекта = BILL
    Тип тега = STRING
    EDI канал доставки документа

    ИД=53
    Символ = EDICHANNEL
    Тип объекта = BILL
    Тип тега = STRING

    EDI ответ на запрос об отмене документа
    ИД=54
    Символ = EDIREPEALACK
    Тип объекта = BILL
    Тип тега = STRING
    EDI проблемные товарные строки

    ИД=55
    Символ = EDIPROBLEMTRFR
    Тип объекта = BILL
    Тип тега = STRING

    Серийный номер исходного лота
    ИД=56
    Символ = SOURCESERIAL
    Тип объекта = LOT
    Тип тега = STRING
    UUID персоналии

    ИД=57
    Символ = PERSONUUID
    Тип объекта = PERSON
    Тип тега = UUID

    UUID локации
    ИД=58
    Символ = LOCUUID
    Тип объекта = LOCATION
    Тип тега = UUID
    Формальное основание документа

    ИД=59
    Символ = FORMALREASON
    Тип объекта = BILL
    Тип тега = ENUM

    EDI запрос на отмену проведения документа
    ИД=60
    Символ = EDIREPEALREQ
    Тип объекта = BILL
    Тип тега = STRING
    UUID кассового узла

    ИД=61
    Символ = POSNODEUUID
    Тип объекта = POSNODE
    Тип тега = UUID

    UUID управляющего кассового узла
    ИД=62
    Символ = POSNODEHOSTUUID
    Тип объекта = POSNODE
    Тип тега = UUID
    Ид государственного контракта

    ИД=63
    Символ = STATECONTRACTID
    Тип объекта = BILL
    Тип тега = STRING

    Ид участника эл документооборота nalog.ru
    ИД=64
    Символ = ENALOGID
    Тип объекта = PERSON
    Тип тега = STRING
    Формальная ссылка на комплементарный документ

    ИД=65
    Символ = BILLCOMPLEMENTARY
    Тип объекта = BILL
    Тип тега = STRING

    ВЕТИС идентификатор предприятия
    ИД=66
    Символ = PERSONVETISUUID
    Тип объекта = PERSON
    Тип тега = UUID
    Имя для авторизации

    ИД=67
    Символ = GUALOGIN
    Тип объекта = GLOBALUSER
    Тип тега = STRING

    UUID товара
    ИД=68
    Символ = GOODSUUID
    Тип объекта = GOODS
    Тип тега = UUID
    EDI RECADV RCV

    ИД=69
    Символ = EDIRECADVRCV
    Тип объекта = BILL
    Тип тега = STRING

    EDI DESADV SENT
    ИД=70
    Символ = EDIDESADVSENT
    Тип объекта = BILL
    Тип тега = STRING
    EDI ORDRSP SENT

    ИД=71
    Символ = EDIORDRSPSENT
    Тип объекта = BILL
    Тип тега = STRING

    EDI ALCODESADV SENT
    ИД=72
    Символ = EDIALCDESADVSENT
    Тип объекта = BILL
    Тип тега = STRING
    EDI INVOIC SENT

    ИД=73
    Символ = EDIINVOICSENT
    Тип объекта = BILL
    Тип тега = STRING

    ВЕТИС issuer UUID
    ИД=74
    Символ = PERSONVETISISSUUID
    Тип объекта = PERSON
    Тип тега = UUID
    ВЕТИС пользователь-инициатор операций

    ИД=75
    Символ = PERSONVETISUSER
    Тип объекта = PERSON
    Тип тега = STRING

    ВЕТИС UUID лота
    ИД=76
    Символ = LOTVETISUUID
    Тип объекта = LOT
    Тип тега = UUID
    ВЕТИС GUID локации

    ИД=77
    Символ = LOCVETISGUID
    Тип объекта = LOCATION
    Тип тега = UUID

    Специальные теги

    Эти теги не зарезервированы, однако некоторые компоненты инфраструктуры Papyrus ссылаются на них по приведенному символу.

    Символ рабочей книги с шаблоном письма для покупателя интернет-магазина Universe-HTT
    Символ=BUYER_MSG_TEMPLATE
    Тип объекта=UHTTSTORE
    Тип тега = STRING
    Признак чужего интернет-магазина

    Символ=FOREIGNSTORE
    Тип объекта=UHTTSTORE
    Тип тега = BOOLEAN

    Список адресов электронной почты, по которым надо отослать уведомление о появлении заказа от покупателя
    Символ=STORE_NOTIFY_MAIL
    Тип объекта=UHTTSTORE
    Тип тега = STRING

    Строка может содержать несколько адресов, разделенных точкой с запятой (;).

    mystore@abc.ru;oleg@abc.ru