Ссылки

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

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

При работе с элементом Ссылки в новой карточке и при редактировании существующей карточки функция добавления ссылки на новую карточку недоступна.

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

Рисунок 1. Пример отображения элемента управления "Ссылки" в режиме По умолчанию

ЭУ в режиме По умолчанию позволяет:

Просматривать список существующих ссылок.
Добавлять ссылки на существующие карточки с использованием формы поиска и выбора карточки.

Рисунок 2. Выбор ссылки на карточку
Создавать новые с добавлением ссылок.
Добавлять гиперссылки.
Добавлять файлы.
Ограничивать возможность добавления ссылок.
Просматривать информацию о ссылке и добавлять описание к ней.

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

Рисунок 3. Пример отображения элемента управления "Ссылки" в режиме "Простой"

ЭУ в режиме Простой позволяет:

Просматривать список существующих ссылок.
Просматривать информацию о ссылке и добавлять описание к ней.

Описание ссылки в таблице ссылок, а также справка о ссылке могут быть настроены. См. пункт Настройка отображения информации о ссылке в элементе управления Ссылки.

К карточкам, ссылки на которые содержатся в ЭУ, могут применяться групповые операции. См. пункт Настройка групповых операций в элементе управления Ссылки.

Свойства

Общие

Название ЭУ

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

Название

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

Тег

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

Внешний вид

Вид дополнительной информации

Определяет способ формирования справки о ссылке (открывается при нажатии кнопки Информация ):

Только о ссылке. В справке будут отображаться: автор ссылки, тип ссылки и описание.
Только о карточке. В справке будет отображаться информация о карточке, на которую указывает ссылка. Формат отображения информация о карточке определяется разметкой с режимом "Справка".
О карточке и о ссылке. В справку будут включены информация о ссылке и о карточке (настраивается разметкой), на которую указывает ссылка.
Не показывать. Не показывать кнопку для открытия справки.

Рисунок 4. Отображение информации о ссылке и о карточке в окне справки

Заголовок

Текст, который отображается над ссылками. Заголовок выделяется жирным шрифтом. Рядом с заголовком отображается число ссылок.

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

Колонки

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

Рисунок 5. Настройки отображения колонок в таблице ссылок

Метод для описания

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

Стандарт. В таблице будет отображаться дайджест карточки.
Расширение. В таблице будет отображаться информация о карточке, возвращаемая серверным расширением Web-клиента (в свойстве Наименование метода для описания должно быть указано название метода, предоставляемого расширением).
Разметка. В таблице будет отображаться информация о карточке, формируемая разметкой с режимом выбора Описание. Если у карточки, на которую указывает ссылка, отсутствует разметка с режимом выбора Описание, в ссылке будет использоваться дайджест карточки.

Настройка применяется только к ссылкам на карточки.

Наименование метода для описания

Название метода расширения Web-клиента, возвращающего описание ссылки. См. Разработка расширения для формирования описаний ссылок.

Для карточек Исходящий, Входящий, Заявка, ОРД, Рабочий, Служебная записка, Договор, Акт и Доп. соглашение предоставляется стандартный метод для описания: DocumentManagement_Default.

Разрешить настройку столбцов

Разрешает или запрещает пользователям самостоятельно формировать список столбцов, отображаемых таблице ссылок.

Режим отображения

Определяет способ работы с элементом управления:

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

Данные

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

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

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

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

Поле данных

Поле карточки, содержащее ссылку на карточку Список ссылок на карточки.

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

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

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

Хранить сильную ссылку

Определяется тип ссылки на карточку. Если флаг установлен, то используется сильная ссылка.

Поведение

Видимость

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

Адаптивный

Добавить гиперссылку

Настройка параметров добавления или просмотра ссылки на URL-адрес.

Рисунок 6. Настройки добавления гиперссылки

Можно включить или отключить возможность добавления новой гиперссылки, при этом соответствующая кнопка будет показана или скрыта. Также можно указать операцию редактирования, при которой добавление гиперссылок будет разрешено. В поле Протокол по умолчанию нужно указать протокол, который будет добавляться к адресу, введённому пользователем, если в адресе не указан конкретный протокол (http, https, ftp и т.п.). Добавление ссылок будет доступно всем, если операция редактирования не указана.

Добавить ссылку

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

Рисунок 7. Настройки добавления ссылки

Флаг Доступно. Позволяет включить или отключить возможность добавления новой ссылки, при этом соответствующая кнопка будет показана или скрыта.
Можно также указать Операцию редактирования, при которой добавление ссылок будет разрешено.

Если операция редактирования не указана, добавление ссылок будет доступно всем.
А также возможные типы ссылок.

В поле Типы ссылок отображаются только те ссылки, которые добавлены в области Выбрано. Чтобы выбрать разрешённые типы, нужно нажать на кнопку в появившемся диалоговом окне перенести их из колонки Доступно в колонку Выбрано.

Рисунок 8. Выбор разрешённых типов ссылок

Диалоговое окно такого типа открывается в полях Типы ссылок и Типы карточек при редактировании свойства Добавить ссылку, а также в поле Типы ссылок при редактировании свойства Добавить гиперссылку.
Настройка Типы карточек позволяет установить ограничение по типам карточек, на которые можно ссылаться.

Можно выбрать один или несколько типов карточек, на которые разрешено ссылаться.

Если типы карточек не выбраны, допускается добавление ссылок на карточки любых типов.

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

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

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

Список папок. При нажатии открывается окно добавления папок (по идентификаторам). Из выбранных папок пользователь сможет выбирать карточки для добавления ссылок в режиме выбора В текущей папке.

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

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

Добавить файл

Настройка параметров добавления или просмотра ссылки на файл.

Рисунок 11. Настройки добавления файла

Диалоговое окно настройки добавления файла содержит:

Флаг Доступно. Включает или выключает возможность добавления файла с помощью элемента управления "Ссылки".
Поле Операция. Операция редактирования, которая должна быть доступна пользователю для разрешения добавления файла.
Поле Типы ссылок. Тип ссылки, с которой будут добавляться файлы.
Поле Вид файла. Вид карточки, которая будет создаваться для добавляемого файла.

Файл (или несколько) можно добавить с помощью кнопки или "перетаскиванием" из файловой системы. При добавлении файлов, для каждого файла будет создана карточка вида Вид файла.

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

Файл может быть удалён, если на него ссылается только данная карточка.
Если карточка файла содержит только один файл, то будет удалена его карточка и ссылка на неё,
Если карточка файла содержит несколько файлов, из карточки файла будет удалён только выбранный файл.

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

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

Загружать синхронно (шт)

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

Изменение

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

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

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

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

Отключен

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

Адаптивный

Отображать раскрытым

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

Адаптивный

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

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

Показывать файлы для ссылок

Настройка типов ссылок, для которых должен действовать особый режим отображения. При особом режиме редактирования в ЭУ отображается не карточка, на которую ссылка, а её основные и дополнительные файлы.

Пользователь может открыть файл, щелкнув по названию файла в списке ссылок или карточку файла из меню Три вертикальные точки . Пользователь также может удалить ссылку на карточку или файл из карточки, на которую указывает ссылка.

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

Создать ссылку

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

Рисунок 12. Настройки создания карточки с добавлением ссылки

Можно включить или отключить возможность создания ссылки с созданием карточки, при этом соответствующая кнопка будет показана или скрыта.

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

Настройка Виды карточек позволяет указать виды карточек, которые можно создавать по ссылке:

Можно выбрать один или несколько видов карточек, на которые разрешено ссылаться.
Если вид карточек содержит подвиды, то при установленном в данной настройке флаге С дочерними видами, они также будут доступны для создания карточек по ссылке.

Если вид или виды карточек не выбраны, то добавление ссылки с созданием карточки будет невозможно.

Функция создания карточки с добавлением ссылки недоступна в разметке создания карточки.

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

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

Удаление

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

События

Данные загружены

Вызывается, когда данные ссылки на файл загружены.

Клик по строке

Вызывается при нажатии на строку ссылки на файл.

Перед добавлением ссылки на новую карточку

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

Перед добавлением ссылки на существующую карточку

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

Перед загрузкой ссылки на файл

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

Перед закрытием тултипа с информацией о карточке

Вызывается перед закрытием окна (открытого кнопкой Информация ) с информацией о карточке.

Перед кликом по имени ссылки

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

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

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

Перед открытием меню ссылки

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

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

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

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

Вызывается перед открытием (кнопкой Информация ) окна с информацией о карточке, на которую указывает ссылка.

Перед разворачиванием

Вызывается перед разворачиванием ЭУ кнопкой Развернуть .

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

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

Перед сворачиванием

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

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

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

Перед удалением файла

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

После добавления ссылки на существующую карточку

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

После загрузки ссылки на файл

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

После изменения выделения

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

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

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

После переключения режима групповых операций

Вызывается после переключения режима групповых операций.

После разворачивания

Вызывается после разворачивания ЭУ кнопкой Развернуть .

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

Вызывается после сохранения комментария (в окне информации о карточке) к ссылке.

После сворачивания

Вызывается после сворачиванием ЭУ кнопкой Свернуть .

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

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

После удаления файла

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

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

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

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

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

При щелчке

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