Оператор "PDF" предназначен для формирования PDF-файлов из визуализаций или отчетов в системе Cubisio. Он позволяет сохранять отчеты в виде PDF, добавлять страницы в существующие документы, настраивать фильтры и выбирать страницы для включения в PDF.
- Генерация PDF из отчетов: Создание PDF-файлов на основе визуализаций или отчетов, созданных в системе Cubisio.
- Добавление страниц в существующий PDF: Возможность добавления новых страниц в уже созданный PDF-документ.
- Выбор страниц: Включение в PDF всех или только определенных страниц отчета.
- Фильтрация данных: Применение глобальных и локальных фильтров для формирования PDF с нужными данными.
- Сохранение результата: Сохранение PDF-файла на локальный компьютер или передача его данных для дальнейшей обработки (например, отправка по электронной почте или сохранение в базе данных).
- Настройка имени файла: Возможность автоматического формирования имени файла на основе названия отчета или задание имени вручную.
- Поиск отчёта Возможность поиска отчёта по названию.
Оператор "PDF" имеет следующие настройки:
- args: Входной порт для передачи дополнительных аргументов в оператор. Аргументы могут использоваться для динамической установки имени файла, фильтров и других параметров.
- Продолжить запись в открытый документ:
- Идентификатор документа (PDF key): Идентификатор PDF-документа, в который необходимо добавить страницы. Идентификатор генерируется при первом создании документа в режиме "оставить открытым для добавления".
- По завершению:
- сохранить и закрыть:
- Сохранить результат в файл:
- Название файла:
- создать по названию отчета: Имя файла будет сформировано автоматически на основе названия отчета.
- указать: Позволяет задать имя файла вручную.
- Имя файла: Входной параметр для задания имени PDF-файла.
- Сохранить результат в выходной порт:
- Сохранить в Base64: PDF-файл будет представлен в виде строки Base64, что удобно для хранения в базах данных.
- Изменить столбец с результатом: Позволяет изменить название столбца, в котором будет храниться PDF в виде Base64. По умолчанию
pdfData
- Сохранить название файла в выходной порт:
- Название файла:
- создать по названию отчета: Имя файла будет сформировано автоматически на основе названия отчета.
- указать: Позволяет задать имя файла вручную.
- Имя файла: Входной параметр для задания имени PDF-файла.
- Изменить столбец с названием файла: Позволяет изменить название столбца, в котором будет храниться имя файла. По умолчанию
pdfFile
- оставить открытым для добавления: Позволяет добавить страницы в этот же PDF позже.
- Изменить столбец с идентификатором документа: Изменяет имя столбца для записи сгенерированного ключа
pdfKey
- Источник:
- Выбрать из проекта: Выбор отчета или визуализации непосредственно из проекта.
- Отчет: Визуализация или отчет, который необходимо сохранить в PDF.
- Найти по названию: Поиск отчета по его имени.
- Название - название отчёта.
- Область поиска:
- в указанных дашбордах/папках: Поиск будет осуществлён в указанных папках и дашбордах.
- Укажите объекты где искать: Дашборды и папки для поиска.
- Искать рекурсивно в папках: Искать во всех вложенных папках.
- в проекте: Поиск будет осуществлён во всём проекте.
- Страницы:
- все: В PDF будут включены все страницы отчета.
- указать выборочно: Позволяет выбрать конкретные страницы для включения в PDF.
- Диапазон: Указывает диапазоны страниц. Можно использовать перечисление номеров (например, 3, 5, 8), диапазоны через дефис (например, 2-5) или их комбинации (например, 2-4, 5, 6, 8-12).
- нет: Страницы не добавляются. Этот режим полезен для закрытия ранее открытого PDF без добавления новых страниц.
- Пробрасывать глобальный фильтр: PDF будет сформирован с учетом фильтров, установленных на дашборде, если процесс запущен из дашборда.
- Установить локальный фильтр: Позволяет добавить дополнительные критерии фильтрации.
- filter: Входной порт для передачи данных фильтрации.
- Элементы фильтра:
- Фильтрующее значение: Значение, по которому будет фильтроваться отчет.
- Установить параметр или измерение: Имя параметра или измерения для фильтрации. По умолчанию используется поле из "Фильтрующее значение". Для установки значения параметра используйте "${имя_параметра}".
- Оператор: Условие фильтрации. (
=, >, <, >=, <=, !=)
- Время ожидания (сек.): Максимальное время ожидания завершения работы оператора. По умолчанию 36000 секунд (10 часов).
- out: Выходной порт оператора. В зависимости от настроек, в этот порт могут быть переданы данные PDF-файла в виде массива байтов или строки Base64, название сгенерированного файла, либо сгенерированный
pdfKey.
- Сохранение отчета в PDF: Выберите источник "Выбрать из проекта" и укажите нужный отчет. Выберите "все" для включения всех страниц или "указать выборочно" для выбора определенных страниц. Выберите режим "сохранить и закрыть" и, если нужно, "Сохранить результат в файл".
- Добавление страниц в существующий PDF: Выберите режим "Продолжить запись в открытый документ" и укажите "Идентификатор документа". Укажите источник отчёта и страницы. Выберите "оставить открытым для добавления" если требуется добавить страницы в этот же документ в дальнейшем. В конце закройте документ, используя режим "сохранить и закрыть".
- Фильтрация данных перед генерацией PDF: Активируйте "Установить локальный фильтр". Установите поля и значения. Укажите оператор. При необходимости, включите "Пробрасывать глобальный фильтр".
- Поиск отчёта по названию: Выберите источник "Найти по названию" и укажите название отчёта. Выберите область поиска и при необходимости укажите дашборды/папки.
- Добавим оператор "PDF" на схему.
- Выберите "Выбрать из проекта" и перетащите нужный отчет из дерева проекта в поле "Отчет".
- Выберите "все" в разделе "Страницы".
- В разделе "По завершению" выберите "сохранить и закрыть".
- В разделе "Сохранить результат в файл" установите галочку.
- В разделе "Название файла" выберите "создать по названию отчета".
- Соедините выходной порт оператора с любым другим оператором или выполните сценарий.
- На вашем компьютере будет сохранен PDF файл с названием отчёта.