Windward Core: где скачать и как пользоваться

Windward Core: автоматизация генерации документов из шаблонов и данных

Windward Core автоматизирует выпуск договоров, счетов, отчётов, писем, таблиц и презентаций из офисных шаблонов и данных. На Xeon Live можно скачать Windward Core бесплатно и свериться с кратким описанием продукта; ниже разберём не только назначение, но и практический рабочий процесс — от подключения данных и расстановки тегов до проверки PDF.

Что такое Windward Core и для каких задач он необходим

Windward Core — не обычный редактор PDF и не конструктор документов с отдельным визуальным холстом. Его базовая модель состоит из двух частей: Designer помогает подготовить шаблон в Microsoft Word, Excel или PowerPoint, а Engine объединяет этот шаблон с данными и формирует конечный файл. Такой подход удобен там, где макет должен оставаться привычным для сотрудников, но содержимое документа меняется от клиента к клиенту, от периода к периоду или от записи к записи.

Карточка Windward Core с логотипом Windward
Windward Core — система генерации документов по шаблонам Microsoft Office.

Для пользователя это выглядит как работа с обычным офисным документом, в который добавлены специальные теги. Тег может вывести одно значение, повторить строку таблицы для набора данных, показать блок лишь при выполнении условия или импортировать внешний фрагмент. В результате оформление остаётся в шаблоне, а изменяемая часть приходит из базы, JSON, XML, OData и других поддерживаемых источников. Для понимания того, чем полученный PDF отличается от исходного офисного файла, полезен материал Xeon Live о том, как устроен формат PDF.

Как устроена связка Designer и Engine

Designer отвечает за шаблон и бизнес-логику, которую видно прямо в документе: текст, таблицы, стили и графика остаются средствами Office, а теги определяют, какие данные подставлять и какие участки повторять или скрывать. Engine запускается уже на стороне приложения или сервера. Исторически Windward поставлял нативные движки для Java и .NET, а для других стеков применял RESTful Engine. Это важное разделение: сотруднику, который правит макет, не требуется открывать код приложения, а разработчик не обязан ручным способом верстать каждую форму.

Интерфейс Windward Designer в Microsoft Office
Классический Designer работает внутри Microsoft Office: справа видны Tag Tree и PODs.
Источник: Windward Studios

Преимущество архитектуры заметно на документах, которые часто меняют дизайн, но применяют стабильный набор данных: страховых формах, выписках, коммерческих предложениях, актах, пакетах отчётности. Шаблон можно доработать в Office, сохранив действующие теги. Ограничение тоже очевидно: продукт ориентирован на системную автоматизацию и интеграцию, по этой причине для разовой правки уже готового PDF он избыточен. Для такой задачи логичнее применять обычный редактор PDF.

Текущий статус продукта и различия в наименованиях интерфейса

Windward Studios вошла в Apryse, а Windward Core стал одной из технологических основ платформы Fluent. В актуальной документации наименования ленты и отдельных окон приведены уже для Fluent Designer, вместе с этим архив прежних релизов Windward Core сохранён. По этой причине на старой установке наименования и расположение отдельных элементов могут отличаться от свежих снимков экрана, но рабочая логика остаётся узнаваемой: источник данных → теги в шаблоне → предварительная проверка → Output. Ниже команды называются так, как они обозначены в действующей документации преемника; там, где новая функция появилась лишь в Fluent, это отмечено отдельно.

Меню Data Sources со списком Recent
В актуальном Fluent меню Data Sources показывает активные и недавно использованные соединения.
Источник: Apryse Fluent Docs

Карта интерфейса Designer: где находятся рабочие инструменты

Перед созданием первого шаблона стоит один раз пройти по ленте Designer и понять, за что отвечает каждая группа. Это экономит время: большая часть операций сводится к нескольким повторяющимся действиям — подключить данные, поставить или выбрать тег, посмотреть его свойства, проверить возвращаемое значение и сформировать выходной документ.

Группа Data: источники, параметры и дерево тегов

Шаг 1. Откройте документ-шаблон в Word, Excel или PowerPoint и перейдите на вкладку Designer. В актуальном Fluent она называется Fluent. Шаг 2. Отыщите группу Data. Команда Data Sources открывает Connection Editor, Input Parameters — окно параметров, вводимых перед формированием документа, Tag Tree — иерархию тегов. Шаг 3. Для нового шаблона начинайте именно с Data Sources: пока соединение не создано, инструменты выбора данных для тегов не дадут полезного итога.

Группа Data на ленте Fluent Designer
Группа Data — отправная точка: тут подключают данные, создают входные параметры и открывают Tag Tree.
Источник: Apryse Fluent Docs

Проверка. После соединения источник должен появиться среди активных подключений. Потом откройте Data Tree или Data Bin и убедитесь, что видите структуру таблиц, полей или узлов. Если дерево пустое, не переходите к разметке шаблона: сперва исправьте соединение или схему, иначе дальше придётся диагностировать каждый тег отдельно.

Группа Tags: создание и навигация по тегам

Шаг 1. Поставьте курсор в место, где должно появиться динамическое значение. Шаг 2. Откройте меню Tags и выберите нужный тип тега; для простого значения применяется Out, для повторения — ForEach с EndForEach, для условия — If с EndIf и при необходимости Else. Шаг 3. После вставки применяйте Select Tag, Edit Tag, Next и Previous, чтобы не искать элементы ручным способом по большому документу. Шаг 4. Если тег больше не нужен, сперва выделите именно его, потом применяйте Delete Tag — так меньше риск удалить соседний текст шаблона.

Группа Tags на ленте Fluent Designer
Группа Tags отвечает за создание, выбор, удаление и переход между тегами шаблона.
Источник: Apryse Fluent Docs

В старых материалах Windward те же идеи встречаются под брендом AutoTag/Designer. На практике полезно воспринимать тег не как текстовую метку, а как исполняемый элемент шаблона: он включает ссылку на источник, выражение выбора данных и добавочные свойства. По этой причине копирование видимого фрагмента тега без проверки его настроек может перенести не ту привязку к данным.

Tag Properties: источник, данные, мастер и Preview

Шаг 1. Выберите уже существующий тег. Шаг 2. В группе Tag Properties проверьте Datasource — в особенности когда шаблон объединяет несколько систем. Шаг 3. Откройте Data Tree или Choose Data и укажите поле или узел, который должен вернуть тег. Шаг 4. Для сложной выборки применяйте Wizard, а затем Preview. Предварительный просмотр необходим до общего Output: он показывает, что возвращает конкретный тег, и отделяет проблемы данных от проблем вёрстки.

Группа Tag Properties на ленте Fluent Designer
Tag Properties связывает выбранный тег с данными, мастером и предварительным просмотром.
Источник: Apryse Fluent Docs

Проверка. Если Preview показывает ожидаемое значение, но общий документ выглядит неправильно, причина почти наверняка находится уже в размещении тегов, формате Office или настройках вывода. Если Preview пустой, возвращайтесь к Datasource, пути к данным и условиям самого тега. Такая последовательность резко сокращает количество одновременно проверяемых причин.

Toolbox и Output: финальные действия над шаблоном

Шаг 1. Когда отдельные теги возвращают правильные данные, переходите в Toolbox. Шаг 2. Применяйте служебные инструменты для проверки структуры, поиска повторяющихся элементов и работы с импортируемыми фрагментами. Шаг 3. Командой Output выберите формат и создайте тестовый документ. Шаг 4. Сопоставьте итог не только визуально: проверьте количество строк в повторяющихся секциях, наличие условных блоков, формат дат и чисел, а для PDF — встроенные шрифты и разрывы страниц.

Группа Toolbox с командами проверки и вывода
В Toolbox находятся служебные инструменты шаблона и команда Output.
Источник: Apryse Fluent Docs

На данном этапе полезно держать тестовые данные с предсказуемыми крайними случаями: пустым значением, одной строкой, несколькими строками и длинным текстом. Красивый итог на одной идеальной записи ещё не означает, что шаблон устойчив к реальным данным.

Как подключить данные и проверить соединение

Подключение данных — первый практический этап, где чаще всего проявляются проблемы окружения. Designer хранит сведения о соединениях и позволяет применять несколько источников в одном шаблоне. В актуальном Connection Editor есть вкладка New для создания нового подключения, Connections для уже использованных соединений и отдельные возможности работы с источниками, настроенными в Fluent Manager.

Connection Editor со списком типов источников данных
Connection Editor создаёт и хранит подключения к данным, а также позволяет проверить соединение.
Источник: Apryse Fluent Docs

Подключение JSON из файла или веб-ресурса

Шаг 1. Откройте Data Sources → Data Sources, чтобы попасть в Connection Editor. Шаг 2. На вкладке New выберите JSON в группе Web/File. Шаг 3. Задайте понятное имя соединения. Оно в особенности важно, если в одном шаблоне будет несколько источников: имя потом видно в свойствах тега. Шаг 4. Укажите файл или URL с JSON. Для веб-источника при необходимости выберите поддерживаемый протокол аутентификации; для локального файла проверьте, что путь доступен той среде, где работает Designer.

Выбор JSON как нового источника данных
JSON можно подключить как файл или веб-ресурс через Connection Editor.
Источник: Apryse Fluent Docs

Шаг 5. Проверьте Encoding. Неверная кодировка обычно проявляется не как ошибка соединения, а как испорченный текст в данных. Шаг 6. Нажмите Add, затем Test. Лишь после успешного теста закрывайте редактор. Шаг 7. Откройте Data Bin или Data Tree и разверните корневой объект. Отыщите поле, значение которого заблаговременно известно в тестовом JSON. Шаг 8. Создайте временный Out, привяжите его к этому полю и выполните Preview. Если значение совпало с исходным файлом, соединение и путь к данным работают.

Параметры подключения JSON
В карточке JSON задаются имя, файл или URL, кодировка и при необходимости параметры аутентификации.
Источник: Apryse Fluent Docs

Что проверить при массиве. Если JSON содержит список объектов, одиночный Out не должен применяться как замена циклу. Сперва определите массив как набор для ForEach, затем внутри области цикла обращайтесь к полям текущего элемента. Иначе в зависимости от выбранного пути вы получите только одно значение, пустой итог или неоднозначную выборку.

Подключение SQL-базы и подготовка схемы

Шаг 1. В Connection Editor выберите нужный SQL-тип на вкладке New. Шаг 2. Заполните имя, провайдер, сервер и базу, затем метод авторизации и учётные данные. Шаг 3. Оставьте чтение метаданных включённым, когда планируете пользоваться SQL Wizard: метаданные помогают мастеру понимать таблицы, представления и связи. Шаг 4. Запустите Test. При ошибке не переходите к тегам — сперва подтвердите доступность сервера, полномочия учётной записи и наличие нужного ADO.NET-провайдера.

Общий вид SQL Wizard
SQL Wizard делит работу на области Data, Composition, Results и Select Statement.
Источник: Apryse Fluent Docs

Шаг 5. После успешного подключения откройте SQL Wizard из свойства тега. В области Data выберите таблицы и поля. Перенесите нужные столбцы в Composition, задайте фильтрацию и сортировку, потом откройте Results. Шаг 6. Сверьте строки с тем, что ожидаете получить из базы. Шаг 7. Лишь после этого сохраняйте выражение в тег. Такой порядок предотвращает ситуацию, когда сложная выборка впервые проверяется уже внутри большого шаблона.

Несколько источников в одном шаблоне

Шаг 1. Создайте каждое соединение отдельно и дайте им различимые имена. Шаг 2. Перед редактированием каждого тега смотрите поле Datasource, а не полагайтесь на последний открытый источник. Шаг 3. Для основной сущности — к примеру, клиента — сформируйте внешний цикл или контекст. Шаг 4. Внутри него можно обращаться к другому источнику, используя значение текущей сущности как условие выборки. Windward поддерживает одновременную обработку нескольких источников, по этой причине такая схема подходит, когда реквизиты клиента хранятся в одной системе, а операции — в другой.

Панель Data Bin с деревом данных
Data Bin показывает структуру подключённых данных и позволяет переносить элементы в шаблон.
Источник: Apryse Fluent Docs

Проверка. Сперва сделайте два независимых временных Out — по одному на каждый источник — и убедитесь, что они возвращают ожидаемые данные. Затем объединяйте их в общий блок. Если после объединения значения начинают пропадать, смотрите область действия циклов и переменных: источник может быть исправен, а контекст текущей строки уже изменился.

Как собрать шаблон: Out, ForEach, If и входные параметры

После подключения данных основной объём работы проходит внутри офисного документа. Сперва полезно построить минимальную версию шаблона: одно поле, одна повторяющаяся таблица и одно условие. После того как эта конструкция стабильно формируется, добавляйте оформление и добавочные ветки. Такой порядок проще диагностировать, чем готовить сложный дизайн сразу.

Вывод одиночного значения через Out

Шаг 1. Поставьте курсор туда, где должно появиться значение: имя клиента, дата, итоговая сумма, наименование подразделения. Шаг 2. Добавьте тег Out. Шаг 3. В редакторе тега выберите Datasource и поле в дереве данных либо задайте путь в области Query редактора. Шаг 4. Нажмите Preview и убедитесь, что возвращается одно ожидаемое значение. Шаг 5. Настройте Format и Type лишь после того, как само значение уже правильно найдено.

Редактор тега Out
Out выводит одиночное значение и позволяет задавать формат, тип и поведение при отсутствии данных.
Источник: Apryse Fluent Docs

Шаг 6. Для дат применяйте формат, согласованный с остальным документом; для чисел и валюты не подменяйте числовой тип заблаговременно сформированной строкой, иначе сортировка и расчёты становятся менее предсказуемыми. Шаг 7. Если поле может отсутствовать, задайте подходящее поведение и значение по умолчанию там, где это требуется бизнес-правилами. Проверка. Сформируйте итог на записи с заполненным и пустым полем и сопоставьте оба случая.

Повторяющиеся строки через ForEach и EndForEach

Шаг 1. Подготовьте в Word таблицу с одной строкой-шаблоном для позиции счета, операции или сотрудника. Шаг 2. Перед повторяемой частью вставьте ForEach и укажите набор строк или узлов, по которому необходимо пройти. Шаг 3. Внутри области цикла разместите Out для полей текущей строки — к примеру, наименование, количество и сумму. Шаг 4. После последнего повторяемого элемента поставьте EndForEach. Граница цикла должна охватывать ровно тот фрагмент, который надо размножать.

Редактор тега ForEach
ForEach задаёт повторение блока для набора строк или узлов, EndForEach закрывает область цикла.
Источник: Apryse Fluent Docs

Шаг 5. Нажмите Preview для самого ForEach или сформируйте короткий тестовый документ с тремя записями. Шаг 6. Проверьте, что заголовок таблицы не повторяется вместе с данными, если этого не требуется, а итоговая строка находится уже после EndForEach. Шаг 7. Проверьте нулевой набор: при отсутствии строк таблица не должна оставлять сломанные границы или лишний пустой абзац. Для сложных вложенных наборов добавляйте внутренний ForEach лишь после того, как внешний цикл работает отдельно.

Условный контент с If, Else и EndIf

Шаг 1. Сформулируйте условие в терминах данных: к примеру, показывать город только когда поле не пусто, выводить альтернативный текст при отсутствии значения или включать раздел для определённого типа клиента. Шаг 2. Поместите If перед условным фрагментом и EndIf после него. Шаг 3. Укажите условие в редакторе и проверьте Preview. Шаг 4. Сформируйте документ на записи, где условие истинно, и убедитесь, что блок присутствует.

Шаблон с тегами If и EndIf
If и EndIf ограничивают фрагмент, который печатается лишь при выполнении условия.
Источник: Apryse Fluent Docs

Шаг 5. Сформируйте второй документ на записи, где условие ложно. Если вместо скрытия необходим альтернативный текст, между If и EndIf добавьте Else и после него — альтернативную ветку. Шаг 6. Для вложенных условий двигайтесь от внутреннего к внешнему и следите за парностью закрывающих тегов. Проверка. В Tag Tree последовательность If/Else/EndIf должна быть логичной, а в конечном файле не должны появляться пустые строки или остатки оформления скрытого блока.

Шаблон с If, Else и EndIf
Else задаёт альтернативный текст или значение, когда условие If не выполняется.
Источник: Apryse Fluent Docs

Параметры, которые пользователь вводит перед формированием документа

Шаг 1. Откройте Input Parameters из группы Data. Шаг 2. Нажмите Add и создайте параметр с понятным именем. Шаг 3. Укажите, обязателен ли он, выберите тип, задайте разумное значение по умолчанию и описание. Значение по умолчанию полезно не только пользователю: оно позволяет проверять связанные теги без постоянного ручного ввода. Шаг 4. Сохраните параметр и применяйте его в условии или выборе данных.

Вкладка настройки одного Input Parameter
Для параметра задаются обязательность, тип, значение по умолчанию и описание.
Источник: Apryse Fluent Docs

Шаг 5. Запустите Output. Перед генерацией Designer покажет форму ввода параметров. Введите тестовое значение, для которого заблаговременно знаете итог. Шаг 6. Повторите формирование с другим значением и сопоставьте, меняется ли нужная часть документа. Шаг 7. Не применяйте входной параметр как метод скрыть неверную привязку данных: сперва убедитесь, что без фильтрации источник доступен и возвращает корректный набор.

Как сформировать документ и проверить итог

Готовый шаблон необходимо проверять в два слоя. Первый слой — данные: что возвращает конкретный тег. Второй — выходной документ: как Office-разметка, теги и движок вместе выглядят в PDF, DOCX, XLSX, PPTX или другом поддерживаемом формате. Эти проверки нельзя объединять в одну, иначе ошибка в одном поле заставляет пересматривать весь документ.

Предварительная проверка отдельного тега

Шаг 1. Выберите подозрительный тег и откройте его свойства. Шаг 2. Убедитесь, что выбран правильный Datasource. Шаг 3. Нажмите Preview. Для Out ожидайте одно значение, для ForEach — набор, соответствующий тестовым данным. Шаг 4. Если Preview не совпадает с ожидаемым, исправляйте выбор данных, фильтры или контекст до общего Output. Шаг 5. Если Preview корректен, запомните это как контрольную точку и переходите к проверке макета.

Результат шаблона с альтернативным значением
В итоговом документе пустое значение заменено веткой Else.
Источник: Apryse Fluent Docs

Такой метод в особенности полезен при большом документе: одна и та же визуальная проблема — пустая ячейка — может означать как отсутствие данных, так и условие, которое скрыло блок, или неверную границу ForEach. Preview позволяет сразу исключить первый класс причин.

Вывод в PDF, DOCX, XLSX, PPTX и другие форматы

Шаг 1. Откройте Output и выберите формат, который реально будет применяться в рабочем процессе. Один и тот же шаблон не следует оценивать только по DOCX, если конечный канал — PDF. Шаг 2. Для первого теста применяйте небольшой, но репрезентативный набор данных. Шаг 3. После генерации откройте файл в целевом просмотрщике, а не только в Office. Шаг 4. Сверьте заголовки, номера страниц, повторяемые строки, изображения, диаграммы, переносы и условные разделы.

Окно Input Parameters до создания параметров
Input Parameters задают значения, которые пользователь вводит перед формированием документа.
Источник: Apryse Fluent Docs

Шаг 5. Проверьте крайние варианты: длинное имя, длинный адресный блок без публикации физического адреса в тестовой статье, большое число строк, пустую коллекцию и отсутствующее необязательное поле. Шаг 6. Для PDF отдельно проверьте шрифты и переносы. В типовом просмотрщике можно открыть свойства документа и вкладку Fonts: это помогает заметить подмену шрифта сервером. Шаг 7. Если PDF требуется лишь создать без сложной автоматизации, сопоставьте задачу с более простыми методами из инструкции как создать PDF-файл.

Добавочная проверка в текущем Fluent

В Fluent версии 26 появилась команда Check Template, которой не следует приписывать старым сборкам Windward Core. Она полезна при миграции или работе на современной версии: шаг 1 — открыть Check Template; шаг 2 — выбрать целевой формат; шаг 3 — просмотреть Fluent Verify и исправить неподдерживаемые элементы, предупреждения и ошибки; шаг 4 — повторить проверку до чистого итога, затем уже делать Output.

Команда Check Template в Fluent
В Fluent 26 и новее Check Template проверяет совместимость шаблона с выбранным форматом до генерации.
Источник: Apryse Fluent Docs

Для постоянного контроля в текущем Fluent есть Verify Report On Generation в Options → Error Handling. Это удобно на этапе активной разработки шаблона, когда авторы часто меняют стили и объекты Office. После включения параметра стоит перезапустить Office, как указывает документация, и убедиться, что панель проверки появляется при формировании итога.

Настройка Verify Report On Generation
В текущем Fluent проверку можно запускать автоматически при каждом формировании итога.
Источник: Apryse Fluent Docs

Как ускорить работу со сложными шаблонами

На небольшом договоре десяток тегов можно сопровождать ручным способом. На отчёте с несколькими источниками, вложенными циклами и повторяемыми блоками необходим другой подход: дерево тегов для навигации, Data Bin для обзора данных, SQL Wizard для построения выборок и PODs для повторного применения готовых фрагментов.

Data Bin и Tag Tree для навигации

Шаг 1. Откройте Data Bin и используйте его как карту подключённых данных. Не переносите в шаблон первый похожий столбец: смотрите путь и источник. Шаг 2. При длинном документе откройте Tag Tree. Двойной переход к элементу позволяет быстрее отыскать тег и его редактор, чем прокрутка десятков страниц. Шаг 3. Перед серьёзным изменением структуры сохраните снимок Tag Tree в XML — эта функция предназначена для информационного анализа и помогает сопоставить порядок тегов до и после переделки.

Команда Save в Tag Tree
Tag Tree можно сохранить в XML для анализа структуры шаблона.
Источник: Apryse Fluent Docs

Шаг 4. После перемещения крупного блока вновь откройте дерево и проверьте парность ForEach/EndForEach и If/EndIf. Шаг 5. Если в документе появились неожиданные повторения, ищите в дереве область, которая закрывается позднее, чем планировалось. Проверка. Техническое XML-представление дерева полезно именно как карта структуры, но редактировать шаблон безопаснее через Designer, а не прямой правкой этого XML.

XML-представление сохранённого Tag Tree
Сохранённое дерево даёт техническое представление последовательности тегов.
Источник: Apryse Fluent Docs

SQL Wizard без ручного набора сложной выборки

Шаг 1. Выберите тег, которому необходимы данные из SQL, и откройте Wizard. Шаг 2. В Data отыщите таблицы и нужные поля. Шаг 3. Перенесите поля в Composition и настройте порядок, фильтрацию и связи. Шаг 4. Откройте Results и проверьте реальные строки. Если строк слишком много или слишком мало, вернитесь к условиям, а не пытайтесь компенсировать ошибку в самом шаблоне.

Перетаскивание полей в SQL Wizard
Поля можно переносить в область композиции, затем задавать фильтрацию и сортировку.
Источник: Apryse Fluent Docs
Область Composition в SQL Wizard
Composition показывает выбранные столбцы и параметры выборки до применения к тегу.
Источник: Apryse Fluent Docs
Панель Results в SQL Wizard
Results позволяет проверить строки, которые вернёт созданная выборка.
Источник: Apryse Fluent Docs
Текст Select Statement, сформированный SQL Wizard
Графические действия в мастере отражаются в итоговом Select Statement.
Источник: Apryse Fluent Docs

Шаг 5. Сопоставьте сформированный Select Statement с ожидаемой логикой, в особенности при нескольких таблицах. Шаг 6. Сохраните выражение в тег и вновь запустите Preview уже из контекста документа. Шаг 7. Для производственного шаблона избегайте выборки данных «на всякий случай»: чем меньше лишних строк и столбцов проходит через генератор, тем легче диагностировать итог и тем меньше ненужной работы выполняется на сервере.

PODs для ещё раз используемых фрагментов

Шаг 1. Выделите фрагмент, который в самом деле должен быть единым во многих шаблонах: стандартный раздел, таблицу, блок с тегами или корпоративный элемент. Шаг 2. Создайте POD по правилам вашей версии и разместите его в доступной библиотеке. Шаг 3. В другом шаблоне откройте POD Bin. Шаг 4. Перенесите нужный POD в документ и проверьте, сохранились ли его данные, переменные и оформление в выбранном режиме применения.

Кнопка POD Bin на ленте
POD Bin открывает библиотеку ещё раз используемых фрагментов шаблона.
Источник: Apryse Fluent Docs

Шаг 5. Сформируйте документ и сопоставьте вставленный фрагмент с эталонным. Шаг 6. Если POD связан с общим источником данных, проверьте, что в новом шаблоне есть соответствующее соединение и оно имеет ожидаемое имя. Шаг 7. Не превращайте POD в контейнер для уникальных фрагментов: смысл механизма — сокращать дублирование. Для обычного одноразового раздела проще оставить его частью шаблона.

Типичные ошибки: причины, исправление и контроль после правки

Большинство сбоев удобно разделить на четыре группы: соединение с данными, выбор данных конкретным тегом, структура циклов и условий, различия между возможностями Office и выходного формата. Диагностика идёт в том же порядке. Начинать с переустановки или полной переделки шаблона практически никогда не рационально: сперва отыщите самый маленький элемент, на котором ошибка воспроизводится.

Источник не подключается или пропал из списка

Шаг 1. Откройте Connection Editor и проверьте, есть ли источник на вкладке Connections. Шаг 2. Для SQL-типа убедитесь, что на машине Designer установлен нужный ADO.NET-провайдер: документация прямо отмечает, что без него тип источника может не появиться в New. Шаг 3. Повторите Test с теми же данными подключения. Шаг 4. Если изменилось имя сервера, путь к файлу или учётная запись, исправьте соединение и сохраните его.

Список Active и Recent Inactive в Connection Editor
Connections — первое место для диагностики источника, который не подключается или исчез из активных соединений.
Источник: Apryse Fluent Docs

Шаг 5. Закройте и заново откройте шаблон, потом проверьте Datasource у одного известного тега. Шаг 6. Выполните Preview. Контроль. Ошибка считается устранённой только когда соединение проходит Test, дерево данных открывается и контрольный Out возвращает заблаговременно известное значение. Один успешный Test без чтения данных ещё не подтверждает весь путь.

Тег возвращает пустое или неожиданное значение

Шаг 1. Выделите тег и сопоставьте его Datasource с ожидаемым. Шаг 2. Откройте выбор данных и проверьте путь. Шаг 3. Запустите Preview. Шаг 4. Если значение пустое, проверьте ту же запись непосредственно в тестовом JSON или базе. Шаг 5. Если данные существуют, временно упростите условие или фильтр тега до прямого выбора поля. Так станет понятно, проблема находится в доступе к данным или в логике отбора.

Исходный шаблон до добавления условия If
Исходный фрагмент шаблона перед добавлением условного вывода.
Источник: Apryse Fluent Docs

Шаг 6. После восстановления прямого значения возвращайте фильтры по одному и всякий раз запускайте Preview. Контроль. Финальный тест должен включать по меньшей мере два набора: тот, где значение есть, и тот, где его нет. Для пустого поля поведение должно быть осознанным — скрытие, значение по умолчанию или ветка Else, а не случайный пустой фрагмент.

ForEach или If нарушает структуру документа

Шаг 1. Откройте Tag Tree. Шаг 2. Отыщите проблемный ForEach или If и его закрывающий тег. Шаг 3. Убедитесь, что EndForEach/EndIf стоит непосредственно после в самом деле повторяемого или условного блока. Шаг 4. Для таблиц проверьте, не попал ли заголовок или строка итогов внутрь цикла. Шаг 5. Для вложенных условий временно отключайте внутренние ветки, пока внешний каркас не станет предсказуемым.

Панель Tag Tree рядом с документом
Парность ForEach/EndForEach и If/EndIf удобнее оценивать по дереву структуры всего шаблона.
Источник: Apryse Fluent Docs

Шаг 6. Сформируйте документы на нулевом, одном и нескольких элементах. Это три различных теста: нулевой выявляет пустые остатки оформления, один — лишние заголовки и границы, несколько — ошибочную область повторения. Контроль. Число повторяющихся строк в результате должно совпадать с тестовым набором, а статические элементы должны появляться ровно один раз.

PDF отличается от офисного шаблона

Шаг 1. Сформируйте одновременно редактируемый формат и PDF из одного набора данных. Шаг 2. Сопоставьте расхождение: шрифт, перенос, изображение, таблица, диаграмма или объект Office. Шаг 3. Если проблема связана со шрифтом, проверьте его наличие в среде Engine и список шрифтов в итоговом PDF. Windward поддерживал настройку подстановки шрифтов, что в особенности важно при серверной генерации. Шаг 4. Если проблема относится к сложному объекту Office, упростите только этот фрагмент и повторите вывод.

Панель Fluent Verify с предупреждением
В современном Fluent панель Verify помогает увидеть часть несовместимых элементов Office ещё до создания итога.
Источник: Apryse Fluent Docs

Шаг 5. В современном Fluent примените Check Template для конкретного формата. В старой версии Windward Core ориентируйтесь на Preview отдельных тегов, тестовый Output и документацию своей сборки. Шаг 6. После исправления заново проверьте не только проблемную страницу, но и соседние: изменение размера шрифта или объекта может сдвинуть разрывы. Контроль. Храните небольшой эталонный набор выходных файлов для регрессионного сравнения после обновления шаблона или Engine.

Тип источника данных не виден в Connection Editor

Для некоторых SQL-систем Designer зависит от установленного ADO.NET-провайдера. Установите поддерживаемый провайдер, перезапустите Office и вновь откройте список New.

Preview тега пустой, но соединение успешно

Проверьте Datasource, путь к полю, контекст текущего ForEach и фильтрацию. Сперва добейтесь прямого вывода поля, потом возвращайте условия по одному.

Строка таблицы повторяется вместе с заголовком

Граница ForEach захватывает статическую строку. Переместите ForEach после заголовка либо EndForEach перед итоговым блоком и протестируйте набор из нескольких строк.

После If остаётся пустая строка

Условие скрывает содержимое, но форматирующий абзац остаётся вне области. Пересмотрите расположение If и EndIf относительно абзаца или ячейки, потом проверьте ложную ветку.

На сервере PDF выглядит иначе, чем на рабочей станции

Сопоставьте доступные шрифты и элементы Office, которые применяет шаблон. Для актуального Fluent вдобавок запустите Check Template для PDF.

После переименования источника часть тегов перестала работать

Проверьте Datasource у контрольных тегов и список активных соединений. В старых Windward-сборках поведение зависит от версии, по этой причине подтвердите привязку в самом Designer, а не по имени файла шаблона.

Преимущества, недостатки, альтернативы и практический выбор

Windward Core силён там, где документ одновременно является офисным макетом и частью программного процесса. Он даёт бизнес-пользователю знакомую среду Word/Excel/PowerPoint, а разработчику — Engine, который можно встроить в приложение. Но это не универсальная замена редакторам PDF и не лучший выбор для каждого небольшого проекта.

Лента Fluent с открытым меню Data Sources
Современный преемник сохранил основную для Windward модель: работа с данными и шаблоном идёт прямо в Microsoft Office.
Источник: Apryse Fluent Docs

Плюсы

  • Шаблоны создаются в Microsoft Office, по этой причине сложное фирменное оформление не нужно переносить в отдельный дизайнер с нуля.
  • Теги Out, ForEach, If/Else и другие элементы позволяют держать данные и условную логику прямо в шаблоне.
  • Поддерживается объединение нескольких источников данных, включая структурированные файлы и SQL-системы.
  • Java, .NET и REST-модель Engine подходят для встраивания генерации документов в серверные и прикладные системы.
  • PODs, Data Bin, Tag Tree и мастера уменьшают объём повторяющейся ручной работы на больших шаблонах.
  • Один шаблон можно применять для нескольких выходных форматов, включая PDF, DOCX, XLSX, PPTX и HTML.

Минусы

  • Архитектура сложнее, чем у обычного PDF-редактора: необходимо понимать шаблон, источник данных, теги и среду Engine.
  • Современная документация и развитие продукта находятся под брендом Fluent, по этой причине старые инструкции Windward и новые снимки интерфейса приходится сопоставлять.
  • Для некоторых источников на машине Designer требуются отдельные провайдеры данных; их отсутствие мешает даже создать соединение.
  • Отличия между возможностями Office и конкретным выходным форматом требуют обязательного тестирования итога, в особенности PDF.
  • Для разового создания или ручной правки одного документа развертывание шаблонной автоматизации экономически и организационно неоправданно.

Кому подойдёт

  • Командам, которые систематически выпускают однотипные договоры, счета, отчёты, письма, выписки или презентации из корпоративных данных.
  • Разработчикам ISV и внутренних систем, которым необходима встроенная генерация документов без ручной верстки каждого типа отчёта в коде.
  • Организациям, где владельцы документа должны самостоятельно менять оформление в Office, не передавая каждую правку разработчикам.

Кому лучше выбрать иной инструмент

  • Пользователям, которым необходимо только открыть, подписать, объединить или слегка исправить уже готовый PDF.
  • Небольшим процессам без стабильного источника данных и без повторяемых шаблонов.
  • Проектам, где шаблоны принципиально создаются в HTML/CSS или в облачном визуальном редакторе и интеграция с Microsoft Office не нужна.

Из реальных альтернатив по подходу стоит смотреть на Docmosis, DocuGenerate и сервисы PDF Generator API. У них другая модель развертывания и шаблонов, по этой причине сопоставлять стоит не число функций, а место, где живёт макет, метод подключения данных и требования к серверу. На Xeon Live есть отдельные материалы про Docmosis, DocuGenerate и PDF Generator API. Если необходим именно родственник Windward Core с централизованным управлением современного поколения, логично сопоставить его с Windward Hub.

Практический выбор простой. Для автоматизированного выпуска большого количества документов с офисной версткой начинайте с маленького рабочего прототипа: одно соединение, один Out, один ForEach, один If и один конечный PDF. Лишь после устойчивого итога переносите в шаблон полный дизайн, добавочные источники и ещё раз используемые фрагменты. Для разовой конвертации или ручной обработки PDF выбирайте более узкий инструмент: Windward Core раскрывается именно как часть постоянного процесса генерации.

xeonlive.ru
Профиль автора на Sostav