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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
 
(не показано 10 промежуточных версий этого же участника)
Строка 1: Строка 1:
{{#subpages:}}
+
{{DISPLAYTITLE:Справочник}}
 +
[[Файл:Справочник лого единообразное.png|40px|link=Платформа 3V/Справочник]]  '''Справочник''' - способ хранения данных, при котором уникальную запись характеризует одно поле.
  
Справочник - способ хранения данных, при котором уникальную запись характеризует одно поле
+
<div class="toccolours mw-collapsible" style="width:600px; background:#FFFFFF;">
 +
<div style="color:#CC2200">[[Платформа 3V/Справочник/Как настроить справочник|<font style="color: #CC2200">Как настроить справочник?</font>]]</div>
 +
<div class="mw-collapsible-content">
  
Каждый справочник колонки - атрибуты с данными и структура JSON атрибута справочника:
+
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 +
1. [[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике|<font style="color: #0645AD">Задать атрибуты в справочнике</font>]]
 +
<div class="mw-collapsible-content">
 +
#[[Платформа_3V/Справочник/Задание_атрибутов_в_справочнике/Выбор_необходимого_типа_данных_для_атрибутов|<font style="color: #CC2200">Выбрать необходимый тип данных для атрибутов</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;">
 +
2. [[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник|<font style="color: #0645AD">Редактировать данные в справочнике</font>]]
 +
<div class="mw-collapsible-content">
 +
#[[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник/Добавление_данных_вручную_пользователем|<font style="color: #CC2200">Редактировать данные вручную</font>]]
 +
#[[Платформа_3V/Справочник/Добавление_новых_записей_в_справочник/Перенос_справочников_через_экспорт_и_импорт|<font style="color: #0645AD">Добавить или редактировать  данные через импорт/экспорт</font>]]
 +
#[[!!|<font style="color: #CC2200">Добавить записи через действия внутри форм</font>]]
 +
#[[Платформа 3V/Отчет/6. Дополнительные действия в отчете/Настройка добавления строк в справочник, показатель отчета|<font style="color: #CC2200">Добавить записи через действия внутри отчётов</font>]]
 +
</div></div>
 +
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 +
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">
 +
#[[Платформа_3V/Справочник/Связи_атрибутов_справочников|<font style="color: #0645AD">Настроить связи атрибутов(Собственный и транзитивный атрибуты)</font>]]
 +
#[[Платформа_3V/Справочник/Группировка|<font style="color: #0645AD">Настроить группировку</font>]]
 +
#[[Платформа_3V/Справочник/Cортировка|<font style="color: #0645AD">Настроить сортировку элементов справочника(SortingOptions)</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 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>
  
{| 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)''']]
 
|}
 
  
 +
Справочник нужен для хранения данных.
 +
<br><br>
 +
==== Из чего состоит? ====
  
 +
Справочник состоит из следующих частей:
  
Базовыми атрибутами справочника является:
+
[[Файл:Справочник области.png|слева|700px]]<div style="clear:both;"></div>
{| 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 в качестве первичного ключа справочника - идентификатора поддерживается только чтения, без изменения элементов. Если в справочнике есть атрибут с типом "родитель", то ему необходимо обязательно указывать тип данных такой же как у идентификатора!
+
#'''Названия атрибутов''' (жарг. Шапка) - это заголовок столбца, который задаётся в конструкторе. <br><br>
 +
#'''Область данных''' (Элементы справочника) - это заполненные значениями ячейки атрибутов.<br><br>

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

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


Для чего?

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

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

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

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


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

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