Платформа 3V/Справочник: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 9 промежуточных версий этого же участника)
Строка 1: Строка 1:
−
[[Файл:Справочник лого единообразное.png|40px|link=Платформа 3V/Методика]]  '''Справочник''' - способ хранения данных, при котором уникальную запись характеризует одно поле.
+
{{DISPLAYTITLE:Справочник}}
 +
[[Файл:Справочник лого единообразное.png|40px|link=Платформа 3V/Справочник]]  '''Справочник''' - способ хранения данных, при котором уникальную запись характеризует одно поле.
  
 
<div class="toccolours mw-collapsible" style="width:600px; background:#FFFFFF;">
 
<div class="toccolours mw-collapsible" style="width:600px; background:#FFFFFF;">
−
<div style="color:#CC2200">[[Платформа_3V/Справочник/Как_настроить_справочник%3F|<font style="color: #CC2200">Как настроить справочник?</font>]]</div>
+
<div style="color:#CC2200">[[Платформа 3V/Справочник/Как настроить справочник|<font style="color: #CC2200">Как настроить справочник?</font>]]</div>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
  
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
−
1. [[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике|<font style="color: #CC2200">Задать атрибуты в справочнике</font>]]
+
1. [[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике|<font style="color: #0645AD">Задать атрибуты в справочнике</font>]]
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
#[[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике/Выбор_необходимого_типа_данных_для_атрибутов|<font style="color: #CC2200">Выбрать необходимый тип данных для атрибутов</font>]]
 
#[[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике/Выбор_необходимого_типа_данных_для_атрибутов|<font style="color: #CC2200">Выбрать необходимый тип данных для атрибутов</font>]]
 +
##[[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике/Выбор_необходимого_типа_данных_для_атрибутов/Изменение_типа_атрибута_на_связанный|<font style="color: #0645AD">Задать и использовать связанные атрибуты</font>]]
 
#[[Платформа_3V/Справочник/Вычислимые_атрибуты|<font style="color: #0645AD">Задать и использовать вычислимый атрибут</font>]]
 
#[[Платформа_3V/Справочник/Вычислимые_атрибуты|<font style="color: #0645AD">Задать и использовать вычислимый атрибут</font>]]
−
#[[Платформа_3V/Справочник/Изменение_типа_атрибута_на_связанный|<font style="color: #0645AD">Задать и использовать связанные атрибуты</font>]]
+
#[[Платформа 3V/Справочник/Задание атрибутов в справочнике/Вычислимые значения файла|<font style="color: #0645AD">Вычислить значения атрибута файл</font>]]
 
</div></div>
 
</div></div>
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
−
2. [[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник|<font style="color: #0645AD">Редактировать записи в справочнике</font>]]
+
2. [[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник|<font style="color: #0645AD">Редактировать данные в справочнике</font>]]
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
#[[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник/Добавление_данных_вручную_пользователем|<font style="color: #CC2200">Редактировать данные вручную</font>]]
 
#[[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник/Добавление_данных_вручную_пользователем|<font style="color: #CC2200">Редактировать данные вручную</font>]]
Строка 21: Строка 23:
 
</div></div>
 
</div></div>
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
−
3. Использовать и отображать в других объектах платформы
+
3. Доп. настройки в справочнике
 +
<div class="mw-collapsible-content">
 +
#[[Платформа_3V/Справочник/Настройка_уникального_индекса_в_справочнике|<font style="color: #0645AD">Настроить уникальный индекс в справочнике</font>]]
 +
#[[Платформа_3V/Справочник/Лимиты_элементов|<font style="color: #CC2200">Ограничить отображение количества элементов</font>]]
 +
#[[Платформа_3V/Справочник/Настройка_кэширования_справочника|<font style="color: #0645AD">Настроить кэширование справочника</font>]]
 +
</div></div>
 +
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 +
4. Доп. настройки справочника для использования в других объектах 3V
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
#[[Платформа_3V/Справочник/Связи_атрибутов_справочников|<font style="color: #0645AD">Настроить связи атрибутов(Собственный и транзитивный атрибуты)</font>]]
 
#[[Платформа_3V/Справочник/Связи_атрибутов_справочников|<font style="color: #0645AD">Настроить связи атрибутов(Собственный и транзитивный атрибуты)</font>]]
Строка 27: Строка 36:
 
#[[Платформа_3V/Справочник/Cортировка|<font style="color: #0645AD">Настроить сортировку элементов справочника(SortingOptions)</font>]]
 
#[[Платформа_3V/Справочник/Cортировка|<font style="color: #0645AD">Настроить сортировку элементов справочника(SortingOptions)</font>]]
 
#[[Платформа_3V/Справочник/Альтернативные_иерархии|<font style="color: #0645AD">Настроить альтернативную иерархию</font>]]
 
#[[Платформа_3V/Справочник/Альтернативные_иерархии|<font style="color: #0645AD">Настроить альтернативную иерархию</font>]]
−
#[[Платформа_3V/Справочник/Настройка_уникального_индекса_в_справочнике|<font style="color: #0645AD">Настроить уникальный индекс в справочнике</font>]]
+
</div></div>
 +
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 +
5. [[Платформа_3V/Права_доступа/Права_доступа_на_справочники/Права_на_выполнение_действий_со_всеми_элементами_справочника|<font style="color: #CC2200">Настроить права доступа</font>]]
 +
<div class="mw-collapsible-content">
 +
#[[Платформа_3V/Права_доступа/Права_доступа_на_справочники/Права_доступа_на_элементы|<font style="color: #CC2200">Настроить права доступа на отдельные элементы</font>]]
 +
##[[Платформа_3V/Справочник/Атрибутивный_доступ|<font style="color: #0645AD">Настроить атрибутивный доступ</font>]]
 +
##[[Платформа_3V/Справочник/Поэлементный доступ|<font style="color: #CC2200">Настроить поэлементный доступ</font>]]
 
</div></div>
 
</div></div>
 
<div style="width:600px;">
 
<div style="width:600px;">
−
4. [[Платформа_3V/Права_доступа/Права_доступа_на_справочники|<font style="color: #CC2200">Настроить права доступа</font>]]
+
6. [[Платформа_3V/Внешний справочник|<font style="color: #0645AD">Внешний справочник</font>]]
−
</div>
 
−
<div style="width:600px;">
 
−
5. [[Платформа_3V/Справочник/Лимиты_элементов|<font style="color: #CC2200">Ограничить отображение количества элементов</font>]]
 
−
</div>
 
−
<div style="width:600px;">
 
−
6. [[Платформа_3V/Справочник/Настройка_кэширования_справочника|<font style="color: #0645AD">Настроить кэширование справочника</font>]]
 
−
</div>
 
−
<div style="width:600px;">
 
−
7. [[Платформа_3V/Внешний справочник|<font style="color: #0645AD">Внешний справочник</font>]]
 
 
</div>
 
</div>
 
<div style="width:600px;">
 
<div style="width:600px;">
−
8. [[Платформа_3V/Календарный справочник|<font style="color: #0645AD">Календарный справочник</font>]]
+
7. [[Платформа_3V/Календарный справочник|<font style="color: #0645AD">Календарный справочник</font>]]
 
</div></div></div>
 
</div></div></div>
 +
 +
 
==== Для чего? ====
 
==== Для чего? ====
  
Строка 57: Строка 65:
 
#'''Названия атрибутов''' (жарг. Шапка) - это заголовок столбца, который задаётся в конструкторе. <br><br>
 
#'''Названия атрибутов''' (жарг. Шапка) - это заголовок столбца, который задаётся в конструкторе. <br><br>
 
#'''Область данных''' (Элементы справочника) - это заполненные значениями ячейки атрибутов.<br><br>
 
#'''Область данных''' (Элементы справочника) - это заполненные значениями ячейки атрибутов.<br><br>
−
 
−
Каждый справочник колонки - атрибуты с данными и структура JSON атрибута справочника:
 
−
 
−
{| class="wikitable"
 
−
|-
 
−
! "attributes": [...]
 
−
|-
 
−
| <syntaxhighlight lang="JSON" line>
 
−
{
 
−
        "id": 1,
 
−
        "name": "...",
 
−
        "code": "...",
 
−
        "description": "",
 
−
        "dataType": "...",
 
−
        "type": "...",
 
−
        "isNullable": false,
 
−
        "hasMultipleValues": false,
 
−
        "isVisible": false,
 
−
        "isReadOnly": true,
 
−
        "formula": null,
 
−
        "tableName": "",
 
−
        "identIndex": {
 
−
          "code": null,
 
−
          "isUnique": false,
 
−
          "dbIndexName": null,
 
−
          "fields": [],
 
−
          "isNew": true
 
−
        },
 
−
        "referenceIndex": {
 
−
          "code": null,
 
−
          "isUnique": false,
 
−
          "dbIndexName": null,
 
−
          "fields": [],
 
−
          "isNew": true
 
−
        },
 
−
        "attributeLink": null,
 
−
        "defaultValue": null,
 
−
        "defaultValueExpression": null,
 
−
        "userAttributePermissions": null,
 
−
        "component": null
 
−
      }
 
−
</syntaxhighlight>
 
−
|}
 
−
 
−
== Описание свойств атрибута ==
 
−
{| class="wikitable"
 
−
|-
 
−
! Свойство !! Описание
 
−
|-
 
−
| id || Уникальный идентификатор атрибута справочника (базовые атрибуты имеют идентификаторы от 1 до 4, нумерация дополнительных атрибутов начинается с 20)
 
−
|-
 
−
| name || Наименование атрибута, которое будет по умолчанию отображаться у атрибута
 
−
|-
 
−
| code || Код атрибута в таблице в базе данных
 
−
|-
 
−
| description || описание хранимых данных атрибута
 
−
|-
 
−
| dataType || тип данных (список доступных типов данных см. ниже)
 
−
|-
 
−
| type || тип атрибута (список доступных типов атрибутов см. ниже)
 
−
|-
 
−
| isNullable || флаг о возможности пустого значения
 
−
|-
 
−
| hasMultipleValues || для атрибутов в типом данных "Связанный" флаг на возможность множественной отметки
 
−
|-
 
−
| isVisible || флаг о видимости атрибута
 
−
|-
 
−
| isReadOnly || флаг о возможности только чтения или редактирования атрибута
 
−
|-
 
−
| formula || формула расчета для [[Платформа_3V/Справочник/Вычислимые атрибуты|'''вычислимых атрибутов''']]
 
−
|-
 
−
| tableName || Физическое имя связанной таблицы для множественного атрибута
 
−
|-
 
−
| attributeLink || блок свойств предназначенных для указания [[Платформа 3V/Справочник/Изменение типа атрибута на связанный|'''связи между двумя справочниками''']]
 
−
|-
 
−
| attributeLink.name || наименование связанного справочника
 
−
|-
 
−
| attributeLink.linkedDictionaryId || идентификатор связанного справочника
 
−
|-
 
−
| attributeLink.linkedAttributeId || в связанном справочнике идентификатор атрибута, по которому необходимо связать данные
 
−
|-
 
−
| attributeLink.linkedAttributeNameId || в связанном справочнике идентификатор атрибута, значения которого необходимо отобразить в текущем справочнике
 
−
|-
 
−
| attributeLink.canSelect || связь атрибутов, по которой будет происходить [[Платформа_3V/Отчет/Блокировка_для_выбора_элементов_в_выпадающих_списках|'''блокировка элементов в столбцах отчета''']]
 
−
|-
 
−
| defaultValue || [[Платформа_3V/Отчет/Установка_значения_по_умолчанию|'''постоянное значение атрибута по умолчанию''']]
 
−
|-
 
−
| defaultValueExpression ||  [[Платформа_3V/Отчет/Установка_значения_по_умолчанию|'''значение атрибута по умолчанию на основании выражения''']]
 
−
|-
 
−
| component || наименование компонента (веб), который должен использоваться для работы с данными. Например, используется для [[Платформа_3V/Отчет/Логический атрибут в 3х состояниях (True/False/null)|'''отображения в отчетах логических атрибутов в трех возможных состояниях (True/False/null)''']]
 
−
|}
 
−
 
−
 
−
 
−
Базовыми атрибутами справочника является:
 
−
{| class="wikitable"
 
−
|-
 
−
! Наименование атрибута (name) !! Идентификатор (id) !! Код (code) !!  Тип атрибута (type) !!  Тип данных (dataType)
 
−
|-
 
−
| Идентификатор || 1 || ID || Id || Integer/String/DateTime/Guid
 
−
|-
 
−
| Наименование || 2 || NAME || Name || String
 
−
|-
 
−
| Порядок || 3 || ORD || Ord || Integer
 
−
|-
 
−
| Родитель || 4 || PARENT_ID || ParentId || Integer/String/DateTime/Guid
 
−
|}
 
−
 
−
Типы данных:
 
−
{| class="wikitable"
 
−
|-
 
−
! Тип данных (dataType) !! Описание
 
−
|-
 
−
| Boolean || Логическое значение (да/нет)
 
−
|-
 
−
| Clob || Двоичные данные
 
−
|-
 
−
| DateTime || Дата и время
 
−
|-
 
−
| Double || Вещественное число
 
−
|-
 
−
| Integer|| Целое число (32 разряда)
 
−
|-
 
−
| Guid || Гарантированный уникальный идентификатор
 
−
|-
 
−
| Json || Данные в формате JSON
 
−
|-
 
−
| Long || Целое число (64 разряда)
 
−
|-
 
−
| String || Строка
 
−
|}
 
−
 
−
'''NB!''' Поддержка атрибутов типа DateTime, String и guid в качестве первичного ключа справочника - идентификатора поддерживается только чтения, без изменения элементов. Если в справочнике есть атрибут с типом "родитель", то ему необходимо обязательно указывать тип данных такой же как у идентификатора!
 

Текущая версия на 11:23, 23 декабря 2021

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

1. Задать атрибуты в справочнике

  1. Выбрать необходимый тип данных для атрибутов
    1. Задать и использовать связанные атрибуты
  2. Задать и использовать вычислимый атрибут
  3. Вычислить значения атрибута файл

2. Редактировать данные в справочнике

  1. Редактировать данные вручную
  2. Добавить или редактировать данные через импорт/экспорт
  3. Добавить записи через действия внутри форм
  4. Добавить записи через действия внутри отчётов

3. Доп. настройки в справочнике

  1. Настроить уникальный индекс в справочнике
  2. Ограничить отображение количества элементов
  3. Настроить кэширование справочника

4. Доп. настройки справочника для использования в других объектах 3V

  1. Настроить связи атрибутов(Собственный и транзитивный атрибуты)
  2. Настроить группировку
  3. Настроить сортировку элементов справочника(SortingOptions)
  4. Настроить альтернативную иерархию

5. Настроить права доступа

  1. Настроить права доступа на отдельные элементы
    1. Настроить атрибутивный доступ
    2. Настроить поэлементный доступ


Для чего?

Справочник нужен для хранения данных.

Из чего состоит?

Справочник состоит из следующих частей:

Справочник области.png


  1. Названия атрибутов (жарг. Шапка) - это заголовок столбца, который задаётся в конструкторе.

  2. Область данных (Элементы справочника) - это заполненные значениями ячейки атрибутов.

Источник — https://wiki.3v-group.net/index.php?title=Платформа_3V/Справочник&oldid=5615