Список объектов можно экспортировать в электронные таблицы формата .xlsx.
Список объектов — инструмент работы с большим количеством однотипных объектов. В списке объектов отображаются объекты одного класса определенных типов, или все типы объектов класса. Название объекта в списке является ссылкой на карточку объекта.
- Результаты экспорта списка
- Процедура выгрузки, в зависимости от количества экспортируемых элементов списка
- Права на экспорт списка объектов
Результаты экспорта списка представлены в виде файла .xlsx.
Имя файла формируется по правилу: "exportSDДДММГГГГ_ЧЧММ (GMT +/-...-00).xls", где
- ДДММГГГГ — дата выгрузки;
- ЧЧММ — время выгрузки (дата и время по часовому поясу текущего пользователя),
- GMT+/-...-00 — отклонения от GMT по часовому поясу текущего пользователя.
Пример, файл exportSD19.12.2013_15-32(GMT +6-00).xlsx
Особенности выгрузки атрибутов объекта:
-
Название атрибута в .xlsx-файле совпадает:
- с названием атрибута из класса/типа объектов, в котором добавлен данный атрибут, если для контента со списком не настроено ограничение по типам;
- с названием атрибута из типа объектов, если для контента со списком настроено ограничение по одному типу;
- с названием атрибута из родительского класса/типа объектов, если для контента со списком настроено ограничение больше, чем по одному типу.
-
Представление атрибутов в .xlsx-файле совпадает с представлением, указанным в настройках колонок списка
Если данное представление не может быть выражено при помощи plain-текста без потерь, используются следующие преобразования:
- для атрибута типа "Элемент справочника" — название элемента справочника.
-
для атрибута "Статус":
- в представлении "Код" — код статуса;
- в прочих представлениях — название статуса;
- для атрибута типа "Ссылка на объект" — название объекта;
- для атрибута типа" Гиперссылка" — гиперссылка;
- для атрибута типа "Текст в формате RTF" — plain-текст;
- для атрибута типа "Файл" — имя файла;
- для атрибута типа "Целое число" — целое число.
- Все атрибуты, для которых в списке были указаны дата и время, выгружаются в часовом поясе пользователя, также как и отображаются в списке объектов. Если часовой пояс пользователя не указан, даты выгружаются в часовом поясе сервера
При выгрузке списка объектов в файл проверка прав на отображение атрибутов данных объектов не производится.
Процедура выгрузки, в зависимости от количества экспортируемых элементов списка
Процедура выгрузки зависит от количества экспортируемых элементов списка и настройки конфигурации системы.
Выгрузка до 1000 записей
В конфигурации системы максимальное количество записей, которое будет доступно для выгрузки из списка объектов = 1000 (значение по умолчанию).
- При выгрузке до 1000 записей списка включительно, файл с результатами экспорта списка сразу будет предоставляться для скачивания.
- При выгрузке более 1000 записей после нажатия кнопки "Экспорт списка" на экране будет открываться форма с сообщением о превышении максимально допустимого количества экспортируемых строк и выгрузке только первых 1000 строк из всего количество строк в текущем представлении списка или выбранных элементов. При нажатии кнопку "Ок", файл с результатами экспорта списка будет предоставлен для скачивания.
Выгрузка более 1000 записей
В конфигурации системы максимальное количество записей, которое будет доступно для выгрузки из списка объектов = N (более 1000).
- При выгрузке до 1000 записей списка включительно, файл с результатами экспорта списка сразу будет предоставляться для скачивания.
-
При выгрузке более 1000 записей, но менее N записей списка включительно, экспорт списка выполняется в фоновом режиме (пользователь может продолжать работать в системе или выйти из нее), затем ссылка для скачивания файла с результатами экспорта списка отправляется на e-mail, указанный при попытке экспорта списка.
По умолчанию в поле ввода адреса для отправки ссылки на форме "Экспорт списка" будет устанавливаться значение атрибута "Адрес электронной почты сотрудника" (email) сотрудника, выполняющего экспорт. Если атрибут "Адрес электронной почты сотрудника" (email) не заполнен, или у сотрудника нет прав на просмотр данного атрибута, или экспорт выполняется суперпользователем, то поле пусто.
В поле можно указать только один адрес электронной почты.
Файл доступен для скачивания только пользователю, инициировавшему экспорт и всем суперпользователям. Если экспорт выполнял суперпользователь, то файл доступен для скачивания только суперпользователям
Ссылка для скачивания файла с результатами экспорта списка действительна ограниченное время. Время доступности ссылки (количество суток, на протяжении которых будет храниться файл с экспортированными данными в базе данных или файловом хранилище) указывается в конфигурации системы и по умолчанию =3. .
- При попытке выгрузки более N записей списка, для пользователя выводится сообщение: "Количество экспортируемых строк превышает максимально допустимое значение. Будут экспортированы только первые N строк из N+X", где Х — число строк превышающее максимальное значение N.
Подробное описание параметров экспорта списка в dbaccess.properties см. Список.
Права на экспорт списка объектов
Для текущего сотрудника возможность экспорта списка объектов регулируется правами доступа. Кнопка "Экспорт списка" отображается в сложном списке объектов, если у пользователя есть право на выгрузку объектов из списка.
В контентах "История изменения объекта" и "История изменения ответственного и статуса" кнопка "Экспорт списка" отображается всегда.
Право на экспорт списка объектов:
- Право настраивается в карточке класса (типа), список объектов которого будет экспортироваться, на вкладке "Права доступа"/"Матрица прав"
- Право контролируется группой прав "Другие права" (право "Выгрузка объектов из списка").
- Право доступно для профилей, основанных хотя бы на одной абсолютной роли (без учета системных ролей "Автор файла" и "Автор комментария")
- При наличии ограничений по типам в контенте со списком объектов и/или атрибуте связи, проверка прав выполняется только для типов, которые одновременно удовлетворяют обоим ограничениям. У пользователя должно быть право на выгрузку объектов из списка для каждого из проверяемых типов. В таблице ниже приведены примеры.
| Атрибут связи. Ограничения по типам | Контент. Ограничения по типам | Проверка прав для типов | Кто видит кнопку |
|---|---|---|---|
| нет | нет | все типы класса |
суперпользователь (всегда); пользователь при наличии прав |
| нет | типы В, С | В, С |
суперпользователь (всегда); пользователь при наличии прав |
| типы А, В | нет | А, В |
суперпользователь (всегда); пользователь при наличии прав |
| типы А, В | типы В, С | В |
суперпользователь (всегда); пользователь при наличии прав |
| тип А | тип В | - | никто |
| типы А, В | ни один | - | никто |
| ни один | типы В, С | - | никто |
| ни один | ни один | - | никто |
Выполнение действия в интерфейсе пользователя: Экспорт (выгрузка) списка в файл.
