Настройка печатной формы "Заказ-наряд"

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

В данном разделе приводится пример настройки печатной формы "Заказ-наряд", общее описание отчетов и печатных форм см. Настройка отчетов и печатных форм.

Описание процесса использования печатной формы

Описание процесса использования печатной формы позволяет сформировать набор данных для отображения на печатной форме.

Печатная форма "Заказ-наряд" используется в рамках следующего процесса распределения заказ-нарядов:

  • Сотрудники службы поддержки регистрируют запросы типа "Запрос на обслуживание" или "Инцидент". Запрос может быть связан с одним или несколькими IT-активами.

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

    Задачи создаются в привязке к запросам типов "Запрос на обслуживание" и "Инцидент".

  • Сотрудники службы поддержки могут распечатывать заказ-наряды на выполнение работ по запросу и связанным задачам из карточки запроса.

    В печатной форме отображаются данные конкретного запроса, для которого построен заказ-наряд, а также данные связанных задач и IT-активов.

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

  1. В системном классе "Запрос" (serviceCall) добавьте типы: "Запрос на обслуживание" и "Инцидент", см. Настройка классов и типов объектов.

  2. В системном классе "Запрос" (serviceCall) добавьте пользовательские атрибуты:

    • "Тема" (shortDescr) типа "Строка";
    • "Задачи" (tasks) типа "Набор ссылок на бизнес-объекты";
    • "Связанные IT-активы" (KEs) типа "Набор ссылок на бизнес-объекты".
  3. Добавьте пользовательский класс "IT-актив" (objectBase).
  4. Добавьте пользовательский класс "Задача" (task).

  5. В пользовательском классе "Задача" (task) добавьте пользовательские атрибуты:

    • "Номер" (objectNumber) типа "Целое число";
    • "Описание" (description) типа "Текст в формате RTF";
    • "Дедлайн" (deadline) типа "Дата/время".

Разработка макета печатной формы

Создайте макет таблицы печатной формы. В таблице печатной формы должны отображаться следующие данные:

  • данные запроса, по которому построен заказ-наряд;
  • данные о задачах, созданных в рамках данного запроса;
  • данные о связанных IT-активах;
  • название компании.

На рисунке приведен макет печатной формы "Заказ-наряд".

Наполните макет печатной формы данными (значениями атрибутов объектов).

В таблице печатной формы должны отображаться следующие атрибуты:

  • Атрибуты объекта класса "Запрос" (serviceCall) (информация о запросе, по которому построен заказ-наряд):

    • "Название" (title);
    • "Тема" (shortDescr);
    • "Контрагент" (client);
    • "Тип" (metaClass);
    • "Услуга" (service);
    • "Статус" (state);
    • "Ответственный" (responsible);
    • "Регламентное время решения" (timeAllowanceTimer);
    • "Контактное лицо" (clientName);
    • "Контактный телефон" (clientPhone);
    • "Контактный e-mail" (clientEmail);
    • "Описание" (descriptionInRTF);
    • "Приоритет" (priority).

  • Атрибуты объекта класса "Задача" (task), связанного с объектами класса "Запрос" (serviceCall).

    • "Номер" (objectNumber);
    • "Описание" (description);
    • "Дедлайн" (deadline);
    • "Ответственный" (responsible);
    • "Связанные заявки" (serviceCalls) типа "Прямая ссылка" в классе "IT-актив" (objectBase).
    • "Связанные IT-активы" (KEs) типа "Обратная ссылка" в классе "Запрос" (serviceCall).

    Атрибуты связи задачи и запроса:

    • "В рамках заявки" (serviceCall) типа "Прямая ссылка" в классе "Задача" (task).
    • "Задачи" (tasks) типа "Обратная ссылка" в классе "Запрос" (serviceCall).

  • Атрибут объекта класса "IT-актив" (objectBase), связанного с объектами класса "Запрос" (serviceCall):

    • "Название" (title)

    Атрибуты связи IT-актива и запроса:

    • "Связанные заявки" (serviceCalls) типа "Прямая ссылка" в классе "IT-актив" (objectBase).
    • "Связанные IT-активы" (KEs) типа "Обратная ссылка" в классе "Запрос" (serviceCall).

  • Атрибут объекта класса "Компания" (root):

    • "Название" (title).

Настройка шаблона печатной формы в Pentaho Report Designer

Шаблон PRD предназначен для:

  • извлечения данных для печатной формы из базы данных с помощью SQL запроса и их обработки;
  • создания макета печатной формы.

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

Для получения файла с шаблоном PRD обратитесь в службу поддержки компании NAUMEN.

Шаблон PRD строится с привлечением внешнего конструктора Pentaho Report Designer (PRD), полное описание настройки шаблона PRD см. Настройка шаблона для отчета или печатной формы в Pentaho Report Designer.

Настройка шаблона PRD для печатной формы состоит из следующих этапов:

  1. Создание шаблона PRD, см. Добавление шаблона PRD. Настройка структуры шаблона PRD.

  2. Составление SQL запроса, см. Составление SQL запроса для извлечения данных.

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

    Заказ-наряд должен строится для запроса, на карточке которого он расположен. Для этого в SQL запросе необходимо использовать системный параметр subject_id: значение колонки id текущего объекта в таблице базы данных, т.е. в subject_table.

    Текст SQL запроса. Печатная форма "Заказ-наряд":

    Copy 
    SELECT
    servicecall.*,
    task.deadline,
    task.title AS taskTitle,
    task.id AS task_id,
    task.description AS taskDesc,
    COALESCE(tbl_employee.title||'/ ', '')||COALESCE(tbl_team.title, '') AS taskResponsible,
    task.responsibleemployee_id AS tasktaskresponsibleemployee_id,
    task.responsibleteam_id
    FROM
    (SELECT
    sCall.id AS id,
    tbl_root.title AS titleRoot,
    sCall.title,
    COALESCE(tbl_employee.title||'/ ', '')||COALESCE(tbl_team.title, '') AS responsible,
    sCall.responsibleemployee_id,
    sCall.responsibleteam_id,
    sCall.case_id,
    metainfo.title AS caseTitle,
    sCall.number_,
    sCall.shortdescr,
    metainfoSt.title AS state,
    COALESCE(empClient.title||'/ ', '')||COALESCE(ouClient.title, '')||COALESCE('/ '||teamClient.title, '') AS Client,
    sCall.clientemployee_id,
    sCall.clientou_id,
    sCall.clientteam_id,
    sCall.client_email,
    sCall.client_name,
    sCall.client_phone,
    sCall.descriptionrtf,
    sCall.timeallowancetimerd,
    '' AS timeAllowanceTimer,
    '' AS fDate,
    slm.title AS titleSlm,
    sCall.service_id,
    tbl_priority.priority_level AS priority,
    (SELECT string_agg(tbl_objectbase.title, '/' )
    FROM tbl_objectbase INNER JOIN tbl_objectba_servicec ON tbl_objectbase.id = tbl_objectba_servicec.objectbase_id
    WHERE tbl_objectba_servicec.servicecalls_id = sCall.id
    GROUP BY    tbl_objectba_servicec.servicecalls_id
    ) AS titleCMDB
    FROM
    tbl_servicecall AS sCall
    INNER JOIN tbl_sys_metainfo_titles AS metainfo ON (metainfo.kase= sCall.case_id AND metainfo.clazz='serviceCall')
    LEFT JOIN tbl_sys_metainfo_states AS metainfoSt  ON (metainfoSt.code=sCall.state AND metainfoSt .kase=sCall.case_id)
    LEFT JOIN tbl_slmservice AS slm ON slm.id = sCall.service_id
    LEFT JOIN tbl_team ON sCall.responsibleteam_id = tbl_team.id
    LEFT JOIN tbl_employee ON sCall.responsibleemployee_id = tbl_employee.id
    LEFT JOIN tbl_employee AS empClient ON empClient.id = sCall.clientemployee_id
    LEFT JOIN tbl_ou AS ouClient ON sCall.clientou_id = ouClient.id
    LEFT JOIN tbl_team AS teamClient ON sCall.clientteam_id = teamClient.id
    LEFT JOIN tbl_priority ON sCall.priority_id = tbl_priority.id
    , tbl_root
     
    WHERE
    sCall.id = ${subject_id}
    --         sCall.id = 1211004  -- INC6
    --         sCall.id = 1211001  -- INC3
    --         sCall.id = 1211003  -- SD5*/
    ) AS servicecall
    LEFT JOIN tbl_task AS task ON servicecall.id = task.servicecall
    LEFT JOIN tbl_employee ON task.responsibleemployee_id = tbl_employee.id
    LEFT JOIN tbl_team ON  tbl_team.id = task.responsibleteam_id
    ORDER BY task.title:: int

  3. Формирование печатной формы, на основе макета, который состоит из таблиц:

    1. определите области и структурные элементы печатной формы, см. Добавление шаблона PRD. Настройка структуры шаблона PRD;
    2. добавьте в каждую область необходимые элементы, см.  Управление элементами шаблона PRD.
    3. определите значения элементова в шаблоне PRD, см. Определение значения поля в шаблоне PRD.
  4. После выполнения всех настроек сохраните шаблон PRD.

Дополнительные настройки шаблона PRD для печатной формы:

  • Чтобы заказ-наряд отображался на странице формата А4, в меню "Файл" выберите пункт "Параметры страницы" и укажите стандартный размер страницы А4 и необходимые отступы, см.  Форматирование страницы отчета (печатной формы).
  • Таблица со списком связанных с запросом задач может растянуться на несколько страниц. Чтобы настроить повторение заголовка на каждой странице печатной формы, добавьте ячейки с заголовком в группу "Заголовок отчета". Выберите элемент "Заголовок отчета" и на вкладке "Стиль" в атрибуте "дублировать заголовок" (группа атрибутов "расположение на странице") установите true , см.  Повторение заголовка на каждой странице.
  • Значения в ячейках с описанием запроса, задач и т.д. могут содержать большое количество текста. Рекомендуется сделать все ячейки таблицы динамически расширяемыми, для этого выберите элемент шаблона PRD и на вкладке "Стиль" в атрибуте "динамическая высота" (группа атрибутов "размер и расположение") установите true, см.  Динамическое расширение ячеек таблицы.
  • Чтобы в одной ячейке отображать фиксированный текст в одном формате, а значения атрибутов в другом, необходимо использовать функции, см. Описание стандартных функций Pentaho Report Designer.

Настройка печатной формы в системе

Добавление шаблона печатной формы

Добавление шаблона печатной формы выполняется по общим правилам создания шаблонов отчетов и печатных форм на странице "Шаблоны отчетов и печатных форм", см. Добавление шаблона отчетов и печатных форм.

При создании шаблона печатной формы "Заказ-наряд" на форме добавления заполните поля:

  • Название: "Заказ-наряд".
  • Код: уникальный идентификатор шаблона в системе.
  • Описание.
  • Файл: "Шаблон печатной формы заказ-наряд.prpt". Для получения файла обратитесь в службу поддержки NAUMEN.

  • Скрипт печатной формы "Заказ-наряд". Скрипт позволяет корректно обрабатывать теги из RTF атрибутов и вычисляет дату первого построения отчета.

    Содержание скрипта:

    Copy 
    //ОСНОВНОЙ БЛОК--------------------------------------------------------
    table.rows.each() { row ->
    row.descriptionRTF = row.descriptionRTF?  row.descriptionRTF.replaceAll("\\<.*?>","") : "-";
    row.descriptionRTF = row.descriptionRTF.replaceAll("\\ "," ");
    row.taskDesc = row.taskDesc?  row.taskDesc.replaceAll("\\<.*?>","") : "-";
    row.taskDesc = row.taskDesc.replaceAll("\\ "," ");
    row.fdate=new Date();
    def backTimerVal = subject.timeAllowanceTimer;
    row.timeAllowanceTimer =  backTimerVal? backTimerVal.deadLineTime : "-";
    };
    return table;

После сохранения форма добавления закроется, новый шаблон отобразится на странице "Шаблоны отчетов и печатных форм".

Размещение печатной формы на карточке объекта

Печатная форма размещается на карточке объекта в контентах: "Список отчетов, печатных форм" и "Отчет, печатная форма", см. Настройка отчетов и печатных форм в системе.

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

Работа с печатной формой в системе

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

  1. Зарегистрируйте запрос типа "Инцидент" и свяжите запрос с IT-активом 1С.

  2. В карточке запроса добавьте две задачи для устранения инцидента.

  3. В карточке запроса перейдите на вкладку "Печатные формы". Нажмите на название шаблона "Заказ-наряд".

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

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

    На странице экземпляра печатной формы выполняются следующие действия:

    • Экспорт (выгрузка) в файл печатной формы . При нажатии кнопки Экспорт, раскрывается список для выбора формата файла. Процедура загрузки и место сохранения файла на компьютере зависят от настройки интернет-браузера пользователя.

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

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

  4. Чтобы вернуться к списку экземпляров печатной формы, перейдите по ссылке К списку отчетов "Заказ-наряд".

    Действия с экземплярами печатной формы см. Работа с экземпляром отчета (печатной формы) .

  5. Перейдите в карточку запроса и добавьте новую задачу.

    Перейдите на вкладку "Печатные формы" и добавьте новый экземпляр печатной формы "Заказ-наряд". Новая задача будет отображаться в списке задач печатной формы.