Ссылка на карточку

Элемент управления Ссылка на карточку предназначен для выбора и отображения ссылки на определённую карточку.

После изменения разметок с данным ЭУ потребуется перезапуск dvwebclient, чтобы отобразить изменения.
Элемент управления "Ссылка на карточку" в режиме просмотра
Рисунок 1. Элемент управления "Ссылка на карточку" в режиме просмотра
ЭУ позволяет:

  • Открывать и изменять ссылку.

  • Открывать файл карточки, на которую указывает ссылка.

Возможность добавления/удаления/изменения ссылки определяется доступностью данной операции по ролевой модели.

При удалении сильной ссылки удаляется сама карточка.

Выбор ссылки осуществляется в диалоговом окне, интерфейс по умолчанию которого представлен на следующем рисунке.

Выбор ссылки на карточку
Рисунок 2. Выбор ссылки на карточку

Название карточки в ссылке по умолчанию формируется с помощью расширения Web-клиента. Если метод расширения для формирования не найден, в ссылке указывается дайджест карточки.

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

Свойства

Общие

Название ЭУ

Название типа элемента управления.

Название

Уникальное название элемента управления.

Тег

Простое текстовое свойство, позволяющее добавить для ЭУ скрипт (например, JSON).

Внешний вид

Отображать метку без значения

Определяет вариант отображения метки.

  • Когда флаг установлен, текст метки отображается всегда.

  • Когда флаг не установлен, текст метки отображается, только если задано значение ЭУ.

Подсказка

Содержимое всплывающей подсказки.

Локализуемый

Текст метки

Содержимое метки, отображаемой слева от элемента управления.

Локализуемый

Показывать иконку

Включает или выключает отображение иконок у элемента управления.

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

Данные

Расширенный источник данных

Выбор типа источника данных элемента управления: текущая карточка или один из типов, настроенных в корневом элементе разметки.

Источник данных

Секция карточки, содержащая данные элемента управления.

Поле данных

Поле карточки, имеющее тип RefCardId.

Операция редактирования

Выбор операции для редактирования значения ЭУ. Если операция недоступна пользователю, то изменение ссылки будет недоступно. Если операция не выбрана, то возможность изменения ссылки не проверяется.

Если значение Операции редактирования наследуется от родительского Блока, название свойства меняется на Операция редактирования (наследовано).

Текст при отсутствии значения

Текст, отображаемый в ЭУ, когда ссылка не выбрана.

Локализуемый

Тип карточки для ссылки

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

Поведение

Видимость

Настройка видимости. Элемент управления отображается в карточке, когда флаг установлен. Элемент управления и любое его содержимое не отображаются, когда флаг снят.

Адаптивный

Дополнительные css классы

Названия дополнительных классов CSS для изменения стиля элемента управления. Перечисляются через пробел.

Использовать список папок

Настройка списка папок, из которых пользователь сможет выбирать карточку для ссылки в режиме выбора "В текущей папке".

Список папок
Рисунок 3. Список папок

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

Обязательное

Определяет требование к заполнению значения ЭУ до сохранения карточки:

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

  • Когда флаг не установлен, присваивать значение необязательно.

Операция редактирования для видимости

Определяет операцию, которая должна быть доступна, чтобы ЭУ отображался для пользователя. Работа свойства зависит от значения свойства Видимость:

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

  • Когда флаг Видимость установлен, и операция редактирования для видимости НЕ выбрана, ЭУ отображается всегда.

  • Когда флаг Видимость НЕ установлен, ЭУ всегда скрыт.

Отключен

Когда флаг установлен, отключается возможность изменить значения элемента управления. Работает совместно со свойством `Операция редактирования. Редактирование будет запрещено, если одно из свойств запрещает редактирование.

Адаптивный

Переходить по TAB

Флаг определяет последовательность перехода по ЭУ карточки при нажатии кнопки TAB. Если флаг установлен, переход по TAB разрешён.

Поисковый запрос

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

Выбор поискового запроса
Рисунок 4. Выбор поискового запроса

По умолчанию используется собственный поисковый запрос Web-клиента: "Ссылки". Данный запрос позволяет искать карточки по дайджесту, автору, дате создания и изменения.

Поисковый параметр

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

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

При формировании поиска для виртуальной папки появляется возможность искать по конкретной карточке.

Задержка поиска

Свойство доступно только при активации свойства Поисковый параметр.

Позволяет настроить задержку поиска после ввода поисковых символов. Значение по умолчанию: 500 мс.

Минимальное количество символов

Свойство доступно только при активации свойства Поисковый параметр.

Задаёт минимальное количество символов для поиска Значение по умолчанию: 3.

Режим редактирования

Определяет вариант отображения элемента управления и возможность изменения его значения:

  • По месту — значение изменяется в отдельном окне, которое открывается нажатием на элемент управления. Данный вариант подходит как для разметки режима редактирования, так и для разметки режима просмотра карточки.

  • Редактирование — значение изменяется непосредственно в элементе управления. Данный вариант может быть выбран в разметке режима редактирования и просмотра.

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

  • Без редактирования — значение изменить нельзя.

Стандартный css класс

Название CSS класса, в котором определён стандартный стиль элемента управления.

События

Перед закрытием окна

Вызывается перед закрытием окна выбора ссылки.

Перед открытием карточки

Вызывается при использовании команды открытия карточки по ссылке.

Перед открытием окна

Вызывается перед открытием окна выбора ссылки.

Перед открытием предпросмотра файла

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

Перед удалением ссылки

Вызывается перед удалением ссылки.

После закрытия окна

Вызывается после закрытия окна выбора ссылки.

После открытия окна

Вызывается после открытия окна выбора ссылки.

После открытия предпросмотра файла

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

После смены данных

Вызывается после изменения содержимого элемента управления.

После удаления ссылки

Вызывается после удаления ссылки.

При наведении курсора

Вызывается при входе курсора мыши в область элемента управления.

При отведении курсора

Вызывается, когда курсор мыши покидает область элемента управления.

При получении фокуса

Вызывается, когда элемент управления выбирается.

При потере фокуса

Вызывается, когда выбор переходит к другому элементу управления.

При щелчке

Вызывается при щелчке мыши по любой области элемента управления.