Просмотр кода страницы Платформа 3V/Справочник/Задание атрибутов в справочнике/Выбор необходимого типа данных для атрибутов/Изменение типа атрибута на связанный

__TOC__

== Описание ==

Если в значениях атрибута, который необходимо связать с другим справочником, выведены идентификаторы связанного справочника, то достаточно указать тип "Связанный" и наименование связанного справочника в Конструкторе. <br>
Если же в значениях атрибута, который необходимо связать с другим справочником, выведены не идентификаторы, а другие значения, то необходимо прописать "Linked" в настройке '''type''' и прописать настройку '''attributeLink''':

<syntaxhighlight lang="JSON" line>
{
  ...
  "dictionaryStructure": {
    "attributes": [
     ...
      {
        ...
        "type": "Linked",
        "attributeLink": {
          "name": "Справочник",
          "linkedDictionaryId": 134,
          "linkedAttributeId": 2,
          "linkedAttributeNameId": 3,
          "canSelect": null
        },
        ...
      }
    ],
    ...
  },
  ...
}
</syntaxhighlight>

'''attributeLink.name''' - наименование связанного справочника <br>
'''attributeLink.linkedDictionaryId''' - идентификатор связанного справочника <br>
'''attributeLink.linkedAttributeId''' - в связанном справочнике идентификатор атрибута, по которому необходимо связать данные <br>
'''attributeLink.linkedAttributeNameId''' - в связанном справочнике идентификатор атрибута, значения которого необходимо отобразить в текущем справочнике <br>

Важно! Для создания связей в справочнике НЕ по идентификатору обязательно [[Платформа 3V/Справочник/Настройка уникального индекса в справочнике|'''наличие уникального индекса в связанном справочнике''']] на соответствующем поле атрибута! Данное требование существует из-за необходимости подтверждения уникальности элементов по атрибуту связанного справочника, чтобы исключить ситуацию нескольких элементов с одинаковыми значениями атрибута в связанном справочнике. 

== Пример ==

В справочнике имеется атрибут assignee с типом "Custom", в значениях которого указан логин:

[[Файл:Атрибут assignee.png|мини|слева]]<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>

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

1. Меняем значение "Custom" на "Linked" в настройке '''type''':

[[Файл:Атрибут assignee type Linked.png|мини|слева]]<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>

2. В настройке '''attributeLink''' прописываем:

* Вариант 1. Отображение логина (тех же значений):

'''attributeLink.name''' - "Пользователи" <br>
'''attributeLink.linkedDictionaryId''' - 9 <br>
'''attributeLink.linkedAttributeId''' - 21 (так как связываем данные по логину, то ищем в связанном справочнике "Пользователи" атрибут с логином и указываем его идентификатор) <br>
'''attributeLink.linkedAttributeNameId''' - 21 (так как хотим оставить в значениях логин в текущем справочнике, то указываем идентификатор атрибута с логином в справочнике "Пользователи") <br>

[[Файл:Атрибут assignee attributeLink 21.png|мини|слева]]<br><br><br><br><br><br><br><br><br><br><br><br><br><br><br>

* Вариант 2. Отображение Фамилии и Имени:

'''attributeLink.name''' - "Пользователи" <br>
'''attributeLink.linkedDictionaryId''' - 9 <br>
'''attributeLink.linkedAttributeId''' - 21 (так как связываем данные по логину, то ищем в связанном справочнике "Пользователи" атрибут с логином и указываем его идентификатор) <br>
'''attributeLink.linkedAttributeNameId''' - 2 (так как хотим заменить логин на Фамилию и Имя в текущем справочнике, то указываем идентификатор атрибута с Фамилией и Именем в справочнике "Пользователи") <br>

[[Файл:Атрибут assignee attributeLink 2.png|мини|слева]]