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

Для пользователя это выглядит как работа с обычным офисным документом, в который добавлены специальные теги. Тег может вывести одно значение, повторить строку таблицы для набора данных, показать блок лишь при выполнении условия или импортировать внешний фрагмент. В результате оформление остаётся в шаблоне, а изменяемая часть приходит из базы, JSON, XML, OData и других поддерживаемых источников. Для понимания того, чем полученный PDF отличается от исходного офисного файла, полезен материал Xeon Live о том, как устроен формат PDF.
Как устроена связка Designer и Engine
Designer отвечает за шаблон и бизнес-логику, которую видно прямо в документе: текст, таблицы, стили и графика остаются средствами Office, а теги определяют, какие данные подставлять и какие участки повторять или скрывать. Engine запускается уже на стороне приложения или сервера. Исторически Windward поставлял нативные движки для Java и .NET, а для других стеков применял RESTful Engine. Это важное разделение: сотруднику, который правит макет, не требуется открывать код приложения, а разработчик не обязан ручным способом верстать каждую форму.

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

Источник: 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: пока соединение не создано, инструменты выбора данных для тегов не дадут полезного итога.

Источник: 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 — так меньше риск удалить соседний текст шаблона.

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

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

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

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

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

Источник: Apryse Fluent Docs
Что проверить при массиве. Если JSON содержит список объектов, одиночный Out не должен применяться как замена циклу. Сперва определите массив как набор для ForEach, затем внутри области цикла обращайтесь к полям текущего элемента. Иначе в зависимости от выбранного пути вы получите только одно значение, пустой итог или неоднозначную выборку.
Подключение SQL-базы и подготовка схемы
Шаг 1. В Connection Editor выберите нужный SQL-тип на вкладке New. Шаг 2. Заполните имя, провайдер, сервер и базу, затем метод авторизации и учётные данные. Шаг 3. Оставьте чтение метаданных включённым, когда планируете пользоваться SQL Wizard: метаданные помогают мастеру понимать таблицы, представления и связи. Шаг 4. Запустите Test. При ошибке не переходите к тегам — сперва подтвердите доступность сервера, полномочия учётной записи и наличие нужного ADO.NET-провайдера.

Источник: Apryse Fluent Docs
Шаг 5. После успешного подключения откройте SQL Wizard из свойства тега. В области Data выберите таблицы и поля. Перенесите нужные столбцы в Composition, задайте фильтрацию и сортировку, потом откройте Results. Шаг 6. Сверьте строки с тем, что ожидаете получить из базы. Шаг 7. Лишь после этого сохраняйте выражение в тег. Такой порядок предотвращает ситуацию, когда сложная выборка впервые проверяется уже внутри большого шаблона.
Несколько источников в одном шаблоне
Шаг 1. Создайте каждое соединение отдельно и дайте им различимые имена. Шаг 2. Перед редактированием каждого тега смотрите поле Datasource, а не полагайтесь на последний открытый источник. Шаг 3. Для основной сущности — к примеру, клиента — сформируйте внешний цикл или контекст. Шаг 4. Внутри него можно обращаться к другому источнику, используя значение текущей сущности как условие выборки. Windward поддерживает одновременную обработку нескольких источников, по этой причине такая схема подходит, когда реквизиты клиента хранятся в одной системе, а операции — в другой.

Источник: Apryse Fluent Docs
Проверка. Сперва сделайте два независимых временных Out — по одному на каждый источник — и убедитесь, что они возвращают ожидаемые данные. Затем объединяйте их в общий блок. Если после объединения значения начинают пропадать, смотрите область действия циклов и переменных: источник может быть исправен, а контекст текущей строки уже изменился.
Как собрать шаблон: Out, ForEach, If и входные параметры
После подключения данных основной объём работы проходит внутри офисного документа. Сперва полезно построить минимальную версию шаблона: одно поле, одна повторяющаяся таблица и одно условие. После того как эта конструкция стабильно формируется, добавляйте оформление и добавочные ветки. Такой порядок проще диагностировать, чем готовить сложный дизайн сразу.
Вывод одиночного значения через Out
Шаг 1. Поставьте курсор туда, где должно появиться значение: имя клиента, дата, итоговая сумма, наименование подразделения. Шаг 2. Добавьте тег Out. Шаг 3. В редакторе тега выберите Datasource и поле в дереве данных либо задайте путь в области Query редактора. Шаг 4. Нажмите Preview и убедитесь, что возвращается одно ожидаемое значение. Шаг 5. Настройте Format и Type лишь после того, как само значение уже правильно найдено.

Источник: Apryse Fluent Docs
Шаг 6. Для дат применяйте формат, согласованный с остальным документом; для чисел и валюты не подменяйте числовой тип заблаговременно сформированной строкой, иначе сортировка и расчёты становятся менее предсказуемыми. Шаг 7. Если поле может отсутствовать, задайте подходящее поведение и значение по умолчанию там, где это требуется бизнес-правилами. Проверка. Сформируйте итог на записи с заполненным и пустым полем и сопоставьте оба случая.
Повторяющиеся строки через ForEach и EndForEach
Шаг 1. Подготовьте в Word таблицу с одной строкой-шаблоном для позиции счета, операции или сотрудника. Шаг 2. Перед повторяемой частью вставьте ForEach и укажите набор строк или узлов, по которому необходимо пройти. Шаг 3. Внутри области цикла разместите Out для полей текущей строки — к примеру, наименование, количество и сумму. Шаг 4. После последнего повторяемого элемента поставьте EndForEach. Граница цикла должна охватывать ровно тот фрагмент, который надо размножать.

Источник: Apryse Fluent Docs
Шаг 5. Нажмите Preview для самого ForEach или сформируйте короткий тестовый документ с тремя записями. Шаг 6. Проверьте, что заголовок таблицы не повторяется вместе с данными, если этого не требуется, а итоговая строка находится уже после EndForEach. Шаг 7. Проверьте нулевой набор: при отсутствии строк таблица не должна оставлять сломанные границы или лишний пустой абзац. Для сложных вложенных наборов добавляйте внутренний ForEach лишь после того, как внешний цикл работает отдельно.
Условный контент с If, Else и EndIf
Шаг 1. Сформулируйте условие в терминах данных: к примеру, показывать город только когда поле не пусто, выводить альтернативный текст при отсутствии значения или включать раздел для определённого типа клиента. Шаг 2. Поместите If перед условным фрагментом и EndIf после него. Шаг 3. Укажите условие в редакторе и проверьте Preview. Шаг 4. Сформируйте документ на записи, где условие истинно, и убедитесь, что блок присутствует.

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

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

Источник: 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 корректен, запомните это как контрольную точку и переходите к проверке макета.

Источник: Apryse Fluent Docs
Такой метод в особенности полезен при большом документе: одна и та же визуальная проблема — пустая ячейка — может означать как отсутствие данных, так и условие, которое скрыло блок, или неверную границу ForEach. Preview позволяет сразу исключить первый класс причин.
Вывод в PDF, DOCX, XLSX, PPTX и другие форматы
Шаг 1. Откройте Output и выберите формат, который реально будет применяться в рабочем процессе. Один и тот же шаблон не следует оценивать только по DOCX, если конечный канал — PDF. Шаг 2. Для первого теста применяйте небольшой, но репрезентативный набор данных. Шаг 3. После генерации откройте файл в целевом просмотрщике, а не только в Office. Шаг 4. Сверьте заголовки, номера страниц, повторяемые строки, изображения, диаграммы, переносы и условные разделы.

Источник: 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.

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

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

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

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

Источник: Apryse Fluent Docs

Источник: Apryse Fluent Docs

Источник: Apryse Fluent Docs

Источник: Apryse Fluent Docs
Шаг 5. Сопоставьте сформированный Select Statement с ожидаемой логикой, в особенности при нескольких таблицах. Шаг 6. Сохраните выражение в тег и вновь запустите Preview уже из контекста документа. Шаг 7. Для производственного шаблона избегайте выборки данных «на всякий случай»: чем меньше лишних строк и столбцов проходит через генератор, тем легче диагностировать итог и тем меньше ненужной работы выполняется на сервере.
PODs для ещё раз используемых фрагментов
Шаг 1. Выделите фрагмент, который в самом деле должен быть единым во многих шаблонах: стандартный раздел, таблицу, блок с тегами или корпоративный элемент. Шаг 2. Создайте POD по правилам вашей версии и разместите его в доступной библиотеке. Шаг 3. В другом шаблоне откройте POD Bin. Шаг 4. Перенесите нужный POD в документ и проверьте, сохранились ли его данные, переменные и оформление в выбранном режиме применения.

Источник: Apryse Fluent Docs
Шаг 5. Сформируйте документ и сопоставьте вставленный фрагмент с эталонным. Шаг 6. Если POD связан с общим источником данных, проверьте, что в новом шаблоне есть соответствующее соединение и оно имеет ожидаемое имя. Шаг 7. Не превращайте POD в контейнер для уникальных фрагментов: смысл механизма — сокращать дублирование. Для обычного одноразового раздела проще оставить его частью шаблона.
Типичные ошибки: причины, исправление и контроль после правки
Большинство сбоев удобно разделить на четыре группы: соединение с данными, выбор данных конкретным тегом, структура циклов и условий, различия между возможностями Office и выходного формата. Диагностика идёт в том же порядке. Начинать с переустановки или полной переделки шаблона практически никогда не рационально: сперва отыщите самый маленький элемент, на котором ошибка воспроизводится.
Источник не подключается или пропал из списка
Шаг 1. Откройте Connection Editor и проверьте, есть ли источник на вкладке Connections. Шаг 2. Для SQL-типа убедитесь, что на машине Designer установлен нужный ADO.NET-провайдер: документация прямо отмечает, что без него тип источника может не появиться в New. Шаг 3. Повторите Test с теми же данными подключения. Шаг 4. Если изменилось имя сервера, путь к файлу или учётная запись, исправьте соединение и сохраните его.

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

Источник: Apryse Fluent Docs
Шаг 6. После восстановления прямого значения возвращайте фильтры по одному и всякий раз запускайте Preview. Контроль. Финальный тест должен включать по меньшей мере два набора: тот, где значение есть, и тот, где его нет. Для пустого поля поведение должно быть осознанным — скрытие, значение по умолчанию или ветка Else, а не случайный пустой фрагмент.
ForEach или If нарушает структуру документа
Шаг 1. Откройте Tag Tree. Шаг 2. Отыщите проблемный ForEach или If и его закрывающий тег. Шаг 3. Убедитесь, что EndForEach/EndIf стоит непосредственно после в самом деле повторяемого или условного блока. Шаг 4. Для таблиц проверьте, не попал ли заголовок или строка итогов внутрь цикла. Шаг 5. Для вложенных условий временно отключайте внутренние ветки, пока внешний каркас не станет предсказуемым.

Источник: Apryse Fluent Docs
Шаг 6. Сформируйте документы на нулевом, одном и нескольких элементах. Это три различных теста: нулевой выявляет пустые остатки оформления, один — лишние заголовки и границы, несколько — ошибочную область повторения. Контроль. Число повторяющихся строк в результате должно совпадать с тестовым набором, а статические элементы должны появляться ровно один раз.
PDF отличается от офисного шаблона
Шаг 1. Сформируйте одновременно редактируемый формат и PDF из одного набора данных. Шаг 2. Сопоставьте расхождение: шрифт, перенос, изображение, таблица, диаграмма или объект Office. Шаг 3. Если проблема связана со шрифтом, проверьте его наличие в среде Engine и список шрифтов в итоговом PDF. Windward поддерживал настройку подстановки шрифтов, что в особенности важно при серверной генерации. Шаг 4. Если проблема относится к сложному объекту 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 и не лучший выбор для каждого небольшого проекта.

Источник: 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 раскрывается именно как часть постоянного процесса генерации.