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

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 2: Строка 2:
  
 
<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>]]
 
 
</div></div>
 
</div></div>
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
 
<div class="mw-collapsible mw-collapsed" style="width:600px;">
Строка 28: Строка 28:
 
#[[Платформа_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 style="width:600px;">
 
<div style="width:600px;">
Строка 59: Строка 60:
 
#'''Названия атрибутов''' (жарг. Шапка) - это заголовок столбца, который задаётся в конструкторе. <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 в качестве первичного ключа справочника - идентификатора поддерживается только чтения, без изменения элементов. Если в справочнике есть атрибут с типом "родитель", то ему необходимо обязательно указывать тип данных такой же как у идентификатора!
 

Версия 10:35, 13 сентября 2021

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

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

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

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

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

3. Использовать и отображать в других объектах платформы

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


Для чего?

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

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

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

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


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

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

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