Как создать автоматическое слияние почты с изображениями в LibreOffice Writer

Вы можете создать вполне работоспособную программу слияния почты в LibreOffice Writer для имен, адресов, дат и других текстовых полей, а затем обнаружить, что как только каждому получателю потребуется разная фотография, подпись, изображение товара, QR-код или бейдж, простой рабочий процесс перестает быть простым. Причина важна: описанные в Writer поля слияния почты — это поля базы данных, используемые в качестве текстовых заполнителей. LibreOffice также поддерживает встроенную и связанную графику, но в его текущей справке не описано собственное «поле изображения для слияния почты», которое автоматически заменяет изображение из столбца с путем к файлу для каждой записи.

Таким образом, остаются два практических варианта. Если во всех объединенных документах используется один и тот же логотип или фоновое изображение, используйте обычную функцию слияния Writer и сохраните это изображение в шаблоне. Если же изображение должно меняться для каждой строки, более контролируемый подход заключается в том, чтобы хранить текстовые и графические данные в Calc, зарезервировать именованный графический объект в шаблоне Writer и автоматизировать слияние с помощью макроса LibreOffice Basic. В этом руководстве используется второй подход.

Инструкции соответствуют документации LibreOffice 26.2, доступной в 2026 году. Меню могут немного отличаться в других версиях или на macOS. В текущем руководстве по Writer в LibreOffice указано, что изображения можно встраивать или создавать ссылки, а API UNO предоставляет доступ к графическим объектам Writer XTextGraphicObjectsSupplierи позволяет автоматизировать выбор графического изображения из внешнего URL-адреса. Эти компоненты позволяют реализовать рабочий процесс с изображениями для каждой записи, даже несмотря на то, что стандартный мастер слияния почты не предоставляет такую ​​возможность в виде отдельного поля для изображения.

Прежде чем начать, выберите подходящий рабочий процесс.

Если вам нужен только фиксированный логотип компании, остановитесь здесь и воспользуйтесь стандартным рабочим процессом создания шаблонов писем в LibreOffice . Остальная часть статьи посвящена вариативным изображениям.

Шаг 1: Подготовьте чистый источник данных Calc.

Создайте лист Calc с одной строкой заголовка и одной записью в каждой строке. Разместите ссылки на изображения в отдельном столбце. Практичный макет: CustomerID, FirstName, LastName, Email, ImagePath, и OutputName.

При сборке и тестировании слияния используйте абсолютные пути. Они менее переносимы, но устраняют неоднозначность. Например, C:\MailMerge\Imageslice.jpgв Windows или /home/user/mailmerge/images/alice.jpgLinux диагностировать проблему проще, чем с помощью относительного пути, базовый каталог которого меняется в зависимости от способа открытия документа.

Не следует смешивать форматы путей Windows и Linux в одном рабочем файле. Примеры на иллюстрации показывают лишь тип значения, которое содержит столбец. В вашем реальном источнике данных должны использоваться пути, действительные на машине, которая выполняет слияние.

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

Шаг 2: Убедитесь, что Writer может читать записи.

Стандартная функция слияния почты в Writer использует зарегистрированный источник данных. Вы можете использовать мастер слияния почты, источник адресных данных или браузер источников данных. В текущей справке LibreOffice описана функция « Инструменты > Мастер слияния почты» , а также возможность вставки полей базы данных через «Вставка > Поле > Дополнительные поля > База данных» . См. официальный справочник по полям базы данных .

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

Для обычной текстовой рассылки слиянием можно перетащить заголовок столбца в документ или вставить поле слияния на вкладке «База данных». Официальная справка Writer подтверждает, что эти поля заменяются содержимым базы данных при выполнении слияния. Однако в случае с переменным изображением не следует предполагать, что перетаскивание его ImagePathна страницу превратит путь в изображение. Оно останется данными, если код не интерпретирует его и не обновит графический объект.

Шаг 3: Создайте шаблон Writer и назовите место для изображения.

Создайте макет письма, сертификата, бейджа или отчета в Writer. Для текстовых значений используйте либо обычные поля слияния почты, либо однозначные токены, такие как {FirstName}, {LastName}, и , {CustomerID}если ваш макрос заменит их самостоятельно.

Далее вставьте образец изображения там, где должно появиться переменное изображение. Задайте желаемый размер, перенос и привязку перед автоматизацией. LibreOffice описывает настройку размера изображения, позиционирование, привязку, перенос и поведение связанных изображений в текущей главе «Изображения и графика» раздела 26.2 «Writer» .

Присвойте графическому объекту стабильное имя, например , `<имя MergeImageобъекта>`. Точное диалоговое окно свойств может различаться в зависимости от версии, поэтому, если вы не уверены, какой объект доступен в Writer, используйте «Инструменты» > «Инструменты разработки» . Инструменты разработки LibreOffice могут проверять графические объекты, свойства, методы и интерфейсы в текущем документе. Это делает их более безопасным инструментом диагностики, чем попытка угадать внутреннее имя объекта.

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

Шаг 4: Автоматизация экспорта переменных изображений и документов.

Основная операция автоматизации проста: открыть шаблон, заменить текстовые заполнители, найти именованный графический объект, загрузить файл изображения строки в этот объект, а затем экспортировать результат. Документация по API UNO в LibreOffice getGraphicObjects()описывает доступ к встроенным и связанным графическим элементам, а также TextGraphicObjectслужбу для свойств графических элементов. Свойство GraphicURLустарело для общего хранения объектов в пользу Graphic, но текущий API явно указывает, что установка внешнего URL-адреса загружает это изображение в графический объект. Это делает его удобным для простого макроса Basic, использующего локальные пути к файлам.

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

Sub MailMergeWithImages()
    Dim calcDoc As Object, sheet As Object, doc As Object
    Dim graphics As Object, imageObj As Object
    Dim row As Long
    Dim firstName As String, lastName As String
    Dim imagePath As String, outputName As String
    Dim sourceURL As String, templateURL As String, outputDir As String

    sourceURL = ConvertToURL("C:\MailMerge\customers.ods")
    templateURL = ConvertToURL("C:\MailMerge\LetterTemplate.odt")
    outputDir = ConvertToURL("C:\MailMerge\Output")

    calcDoc = StarDesktop.loadComponentFromURL(sourceURL, "_blank", 0, Array())
    sheet = calcDoc.Sheets.getByName("Sheet1")

    row = 1  ' row 0 contains headers
    Do While sheet.getCellByPosition(0, row).String <> ""
        firstName = sheet.getCellByPosition(1, row).String
        lastName = sheet.getCellByPosition(2, row).String
        imagePath = sheet.getCellByPosition(4, row).String
        outputName = sheet.getCellByPosition(5, row).String

        doc = StarDesktop.loadComponentFromURL(templateURL, "_blank", 0, Array())

        ReplaceAll doc, "{FirstName}", firstName
        ReplaceAll doc, "{LastName}", lastName

        graphics = doc.getGraphicObjects()
        If graphics.hasByName("MergeImage") Then
            imageObj = graphics.getByName("MergeImage")
            imageObj.GraphicURL = ConvertToURL(imagePath)
        Else
            MsgBox "Graphic object MergeImage was not found."
            doc.close(True)
            Exit Sub
        End If

        Dim args(1) As New com.sun.star.beans.PropertyValue
        args(0).Name = "FilterName"
        args(0).Value = "writer_pdf_Export"
        args(1).Name = "Overwrite"
        args(1).Value = True

        doc.storeToURL(outputDir & outputName & ".pdf", args())
        doc.close(True)
        row = row + 1
    Loop

    calcDoc.close(True)
End Sub

Sub ReplaceAll(doc As Object, findText As String, replacement As String)
    Dim d As Object
    d = doc.createReplaceDescriptor()
    d.SearchString = findText
    d.ReplaceString = replacement
    doc.replaceAll(d)
End Sub

Этот макрос — шаблон, а не универсальная программа, которую можно просто установить. В разных установках LibreOffice могут быть разные политики безопасности макросов, правила путей операционной системы и макеты шаблонов. Важные проверенные концепции API заключаются в том, что Writer предоставляет доступ к своей коллекции графических объектов, а LibreOffice может задавать графическое изображение по внешнему URL-адресу. Для более крупных развертываний рекомендуется загружать графическое изображение через современный GraphicAPI, а не полагаться на поведение совместимости GraphicURL. Официальными источниками являются XTextGraphicObjectsSupplier и TextGraphicObject .

Шаг 5: Запустите небольшую партию и проверьте результат.

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

• Имя получателя в документе совпадает с изображением из той же строки электронной таблицы.
• В итоговом документе путь к изображению не отображается в виде текста.
• Имя выходного файла соответствует нужной записи и не перезаписывает данные другого получателя.
• Изображение занимает отведенное место, не перенося текст на новую страницу и не закрывая другой объект.
• Сгенерированный PDF-файл или ODT-документ откроется автоматически после закрытия LibreOffice и Calc.

Последняя проверка важна, потому что связанные и встроенные графические элементы ведут себя по-разному. В текущем руководстве по Writer поясняется, что связанное изображение остается отдельной ссылкой на файл, в то время как встроенное изображение становится частью документа. Если вы передаете файлы ODT на другой компьютер, убедитесь, что результат не зависит от локального пути, который существует только на компьютере, выполнившем слияние.

Типичные неисправности и самые быстрые способы их устранения

В результате отображается путь к файлу вместо изображения.

Вы вставили данные ImagePathкак обычное поле для слияния почты. Ожидается, что это будет текст. Сохраните путь в источнике данных, но позвольте макросу загрузить его в именованный графический объект.

Каждая запись получает одно и то же изображение.

Изображение-шаблон не менялось между записями, или ваш цикл считывает фиксированную ячейку. Запишите номер строки ImagePathво время проверки двух записей. Если путь меняется, а изображение остается прежним, проверьте имя графического объекта с помощью инструментов разработки.

Макрос сообщает, что объект MergeImage не существует.

Графический объект был переименован, заменен или отображается не под ожидаемым вами именем. Выберите изображение и просмотрите его с помощью меню «Инструменты» > «Инструменты разработки» . API UNO предоставляет доступ к графическим объектам по имени, поэтому макрос и шаблон должны точно совпадать.

Изображения исчезают на другом компьютере.

Вероятно, вы сохранили документ, который по-прежнему ссылается на внешние файлы. Если важна переносимость, убедитесь, что сгенерированный документ включает в себя изображение, или экспортируйте его в PDF после загрузки изображения. В руководстве по работе с изображениями LibreOffice объясняется разница между связанными и встроенными графическими файлами, а также как можно разорвать ссылки для встраивания файлов.

В результате слияния HTML-почты теряются изображения.

Это задокументированное ограничение, которое стоит проверить, прежде чем выбирать способ отправки по электронной почте. В справке LibreOffice указано, что если типовое письмо представлено в формате HTML, встроенные или связанные изображения не отправляются вместе с письмом. Если изображение необходимо, используйте PDF-вложение или протестируйте другой способ доставки, вместо того чтобы предполагать, что слияние почты в формате HTML сохранит его. См. раздел « Создание типового письма» .

Когда следует использовать сервис MailMerge UNO в LibreOffice вместо стандартного?

Если ваши текстовые поля уже используют встроенную функцию слияния почты Writer и вам требуется программный контроль над выводом, LibreOffice также предоставляет соответствующий MailMergeсервис. Его документированные свойства включают DataSourceName, Command, DocumentURL, OutputURL, FileNameFromColumn, и SaveAsSingleFile. Этот API полезен, когда вы хотите автоматизировать стандартное слияние почты из кода. Однако сам по себе он по-прежнему не документирует поле пути к файлу изображения для каждой записи, поэтому вам может потребоваться объединить выполнение слияния почты с обработкой графических объектов. См. официальную справочную информацию по сервису MailMerge .

Итоговый контрольный список

• Используйте стандартную функцию слияния почты Writer, если изображение фиксировано для всех получателей.
• Используйте один чистый ImagePathстолбец, если изображение различается в зависимости от записи.
• Присвойте имя графическому элементу-заполнителю "Автор" и сохраните его размеры неизменными.
• В автоматическом режиме определяйте путь к изображению; не ожидайте, что текстовое поле автоматически преобразуется в изображение.
• Перед запуском обработки всей партии проверьте две-три записи.
• Откройте экспортированные файлы после закрытия исходных документов, чтобы убедиться в самодостаточности выходных данных.

Для большинства небольших и средних задач лист Calc, шаблон Writer и короткий макрос Basic обеспечивают наилучший баланс прозрачности и контроля. Это требует больше настройки, чем обычная рассылка текстовых писем, но вы можете точно видеть, из какой строки взято каждое изображение, выбрать имя выходного файла и проверить результат перед отправкой сотен персонализированных файлов.