Урок 8. Экспорт данных

Введение

В ходе этого урока вы научитесь формировать и экспортировать отчёты по процессу найма персонала с помощью шаблонов экспорта и кнопок в интерфейсе Comindware Platform. Вы освоите подготовку шаблона Excel, сопоставление атрибутов, настройку кнопки экспорта и выдачу прав на её использование для HR-менеджера.

Предусловия: пройден урок 4. Связи и коллекции записей, документооборот.

Расчётная продолжительность: 50 мин.

Темы, навыки и задания урока

Темы

• Устройство и настройка шаблона экспорта в Excel
• Сопоставление атрибутов с ячейками шаблона
• Настройка кнопки экспорта и выдача прав на её использование

Навыки

• Создание файлов Excel с заполнителями для подстановки данных
• Настройка шаблонов экспорта
• Добавление кнопок экспорта на формы и в таблицы
• Управление правами доступа к операциям экспорта

Задания

• Подготовить шаблон Excel для отчёта о найме.
• Настроить шаблон экспорта в системе и задать имя выходного файла в формате PDF.
• Создать и разместить кнопку экспорта в интерфейсе.
• Выдать HR-менеджеру разрешение на использование кнопки экспорта.

Определения

• Шаблон экспорта — файл (в формате Excel или Word) с заполнителями, куда автоматически подставляются значения атрибутов.
• Экспорт отчёта — автоматическое формирование документа на основе шаблона экспорта.
• Кнопка — элемент интерфейса, запускающий операцию экспорта данных.
• Разрешение на использование кнопки — право пользователя запускать экспорт отчёта.

Формирование шаблона для выгрузки отчёта

Подготовка шаблона «Кандидаты» к экспорту

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

1. Перейдите к шаблону записи «Кандидаты».

2. Создайте атрибут «Ссылка на запись» со следующими свойствами:

   • Тип: текст
   • Вычислять автоматически: флажок установлен

   • Вычисляемое значение: формула

     FORMAT("https://your-host/#Resolver/{0}", LIST($id)) 
     

   Внимание!

   Чтобы формула сработала, замените https://your-host на доменное имя вашего сервера Comindware Platform.

   

3. Перейдите к шаблону записи «Документы кандидатов».

4. Создайте атрибут «Имя файла» со следующими свойствами:

   • Тип: текст
   • Вычислять автоматически: флажок установлен

   • Вычисляемое значение: N3

     # Импортируем функции для работы 
     # с документами и записями  
     @prefix object: <http://comindware.com/ontology/object#>. 
     @prefix document: <http://comindware.com/ontology/document#>. 
      
     { 
         # Находим атрибут «Файл» в шаблоне «Документы кандидатов» 
         # и помещаем ID атрибута  в локальную переменную ?DocumentAttribute 
         ("Документыкандидатов" "Файл") object:findProperty ?DocumentAttribute. 
         # Помещаем значение атрибута «Файл» текущей записи в ?DocumentAttributeValue 
         ?item ?DocumentAttribute ?DocumentAttributeValue. 
         # Считываем имя файла из значения атрибута «Файл» и возвращаем его. 
         ?DocumentAttributeValue document:title ?value. 
     } 
     

     Язык N3

     Язык N3 — это компактный язык для описания данных и правил обработки информации. В Comindware Platform он используется для создания вычисляемых атрибутов, автоматизации бизнес-логики и интеграции с внешними системами.

     Язык N3 обладает следующими преимуществами:

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

     Подробнее о синтаксисе и возможностях языка N3 см. «Написание выражений на языке N3».

Создание файла шаблона экспорта

1. Создайте пустой файл Excel Отчёт_о_найме.xlsx.
2. Заполните лист Excel, как показано на следующей иллюстрации.
3. Сохраните файл.

.png)_

Настройка шаблона экспорта

1. Перейдите в шаблон записи «Кандидаты».
2. Откройте вкладку Шаблоны экспорта.
3. Нажмите «Создать».
4. Укажите название шаблона экспорта «Отчёт о найме».
5. В поле «Файл шаблона» выберите пункт «Значение» и прикрепите настроенный ранее файл Отчёт_о_найме.xlsx.
6. В поле «Имя выходного файла» выберите пункт «Значение» и укажите требуемое имя файла отчёта с данными (без расширения файла), например: Отчёт о найме. Файл с указанным именем будет скачивать HR-менеджер.
7. Установите флажок «Экспортировать как PDF».
8. Сохраните шаблон экспорта.

Настройка кнопки экспорта отчёта

При создании шаблона экспорта автоматически создается кнопка экспорта.

Эту кнопку необходимо добавить на форму или в таблицу, чтобы выгружать данные.

Проверка кнопки экспорта

Удостоверимся, что кнопка экспорта соответствует нашим требованиям.

1. Перейдите на вкладку «Кнопки» шаблона «Кандидаты».
2. Откройте кнопку «Отчёт о найме».

3. Проверьте корректность свойств кнопки:

   • Отображаемое название: Отчёт о найме
   • Контекст операции: запись
   • Операция: экспорт записи
   • Результат выполнения: скачать документ
   • Шаблон экспорта: Отчёт о найме

Добавление кнопки экспорта на форму пользовательской задачи

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

1. Откройте шаблон «Кандидаты».
2. Перейдите на вкладку «Формы».
3. Создайте новую форму.
4. Присвойте форме отображаемое название «Выгрузка отчёта».
5. Измените отображаемое название автоматически созданной новой области на «Выгрузка отчёта».
6. Выберите область кнопок области «Выгрузка отчёта» и поместите на неё кнопку «Отчёт о найме».

7. Сохраните форму.

   

8. Откройте диаграмму процесса «Найм персонала».

9. Нажмите кнопку «Редактировать».
10. Выберите задачу «Сформировать и согласовать предложение с кандидатом».
11. В меню элемента нажмите кнопку «Форма» ‌.
12. Разверните в панели элементов шаблон «Кандидаты».
13. Поместите вложенную форму «Выгрузка отчёта» в область над формой «Кандидаты — Основная форма».
14. Сохраните форму задачи.
15. Опубликуйте диаграмму процесса «Найм персонала».

Настройка разрешения на использование кнопки экспорта

Для того чтобы HR-менеджер мог воспользоваться кнопкой «Отчёт о найме», ему необходимо предоставить соответствующее разрешение.

Для этого настроим роль «HR-менеджер».

1. Откройте раздел «Роли» приложения «Управление персоналом».
2. Откройте роль «HR-менеджер».
3. Перейдите на вкладку «Разрешения».
4. Раскройте в панели ресурсов шаблон «Кандидаты».
5. Перетащите кнопку «Отчёт о найме» на таблицу разрешений.
6. Установите для кнопки «Отчёт о найме» разрешение «Использование кнопки».
7. Перетащите форму «Отчёт о найме» на таблицу разрешений.
8. Сохраните роль.

Тестирование экспорта отчёта о найме

1. Перейдите к списку экземпляров шаблона «Кандидаты».
2. Создайте нового кандидата.
3. С помощью страницы «Мои задачи» пройдите процесс до задачи «Сформировать и согласовать предложение с кандидатом».
4. Откройте форму задачи «Сформировать и согласовать предложение с кандидатом».
5. Нажмите кнопку «Сохранить».

6. Нажмите кнопку «Отчёт о найме» и дождитесь экспорта (скачивания) сформированного PDF-документа.

   

7. Откройте экспортированный документ и удостоверьтесь, что в нём присутствуют все экспортируемые значения.

8. Завершите задачу.

Итоги урока

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

На этом курс «Аналитик. Базовый» завершён. Ознакомьтесь с Заключением.