Инструменты пользователя

Инструменты сайта


ru:airlay:reporttemplate

Шаблоны отчетов

Excel шаблоны

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

Типы шаблонов

  • Обычный – создает отчет по объектам.
  • Детализированный – создает отчет по изменениям категории объектов.

Поля шаблона

Шаблон составляется из атрибутов объекта, автора изменений категории, наименования категории и времени изменения. Подробное описание полей шаблона:

  - Все атрибуты объекта в формате {{attr}}, {{attr.subattr}} для вложенных атрибутов
  - Атрибуты автора изменений такие как: {{customer._id}}, {{customer.name}}, {{customer.email}}, {{customer.firstName}}, {{customer.secondName}}, {{customer.lastName}}, {{customer.number}}, {{customer.position}}, {{customer.department}}, {{customer.workStatus}}, {{customer.company}}, {{customer.division}}, {{customer.employeeID}}, {{customer.SAPLogin}}
  - Наименование категории {{category.name}}
  - Дата изменения категории {{time}}

Примечание: если поля customer и category присутсвуют в атрибутах объекта, они будут заменнены на значения отчета

Для получения времени необходимо использовать тэг конвертации времени: Конвертация unix-времени

<b data-convertUnixTime='DD-MM-YYYY HH:mm:ss'>{{time}}</b>

Так же в шаблоне отчета для ячеек времени необходимо указать формат дата и время.

Поля шаблона по ошибкам с групировкой

  - поле для группировки {{field}}
  - общее количество объектов {{total}}
  - количество корректных объектов {{correct}}
  - количество не корректных объектов {{incorrect}}

Поля шаблона по ошибкам без групировки

Существует как docx так и xlsx.

XLSX:

  - общее количество объектов {{additional.total}}
  - количество корректных объектов {{additional.correct}}
  - количество не корректных объектов {{additional.incorrect}}
  - порядковый номер объекта {{number}}
  - уникальное поле объекта {{id}}
  - количество объектов {{count}}
  - список ошибок {{errors}}

DOCX:

  - общее количество объектов ${total}
  - количество корректных объектов ${correct}
  - количество не корректных объектов ${incorrect}
  - Пример вывода ошибок - 
  ${data}
        Ошибки: 
	    Объект: ${id}
	    Ошибки: ${errors}
  ${/data}

Поля шаблона объекту

Пример файлов

Word шаблоны

Описание шаблона

Для подстановки используется паттерн ${имя_поля}, заменяет паттерн на значение из отчета. Повторяющийся блок:

${имя_блока}
Шаблон блока
${/имя_блока}

Имя блока должно соответствовать полю objects или comments

Таблица задач: Колонки должны содержать паттерны с именами полей задачи

Паттерн для изображений:

${search-image-pattern}
${search-image-pattern:[width]:[height]:[ratio]}
${search-image-pattern:[width]x[height]}
${search-image-pattern:size=[width]x[height]}
${search-image-pattern:width=[width]:height=[height]:ratio=false}

Паттерн для форматирования времени:

${field:dateFormat=DD-MM-YYYY HH:mm:ss}

Отчет имеет следующую структуру:

{
    "name": "string",
    "number": "int",
    "description": "string",
    "issues": "array",
    "comments": "array",
    "objects": "array"
}

Массив issues содержит задачи мероприятия:

{
    "localNumber": "string",
    "name": "string",
    "createDate": "dateString",
    "endDate": "dateString",
    "status": "string",
    "assign": "string"
}

Массив comments содержит комментарии к мероприятию:

{
    "text": "string",
    "images": {
        "main": "string",
        "preview": string,
    }
}

Массив objects содержит объекты связанные с мероприятием, object содержит атрибуты объекта

Пример: report_template.docx

ru/airlay/reporttemplate.txt · Последнее изменение: 2023/04/21 14:38 — Лев