วิธีสร้างการผสานจดหมายอัตโนมัติพร้อมรูปภาพใน LibreOffice Writer

คุณสามารถสร้างฟังก์ชันการผสานจดหมาย (mail merge) ที่ดีเยี่ยมใน LibreOffice Writer สำหรับชื่อ ที่อยู่ วันที่ และช่องข้อความอื่นๆ ได้ แต่เมื่อผู้รับแต่ละคนต้องการรูปภาพ ลายเซ็น รูปภาพสินค้า รหัส QR หรือบัตรประจำตัวที่แตกต่างกัน เวิร์กโฟลว์ที่เรียบง่ายก็จะไม่เรียบง่ายอีกต่อไป เหตุผลสำคัญคือ ช่องข้อมูลการผสานจดหมายที่ระบุไว้ใน Writer นั้นเป็นช่องข้อมูลในฐานข้อมูลที่ใช้เป็นตัวแทนข้อความ LibreOffice ยังรองรับกราฟิกแบบฝังและแบบเชื่อมโยง แต่ความช่วยเหลือในปัจจุบันไม่ได้อธิบายถึง "ช่องข้อมูลรูปภาพสำหรับการผสานจดหมาย" ที่จะแทนที่รูปภาพจากคอลัมน์เส้นทางไฟล์โดยอัตโนมัติสำหรับแต่ละรายการ

นั่นทำให้เหลือทางเลือกที่เป็นไปได้สองทาง ถ้าเอกสารที่รวมกันทุกฉบับใช้โลโก้หรือภาพพื้นหลังเดียวกัน ให้ใช้ฟังก์ชันการรวมจดหมายของ Writer ตามปกติและคงภาพนั้นไว้ในเทมเพลต แต่ถ้าภาพต้องเปลี่ยนสำหรับทุกแถว วิธีที่ควบคุมได้มากกว่าคือการเก็บข้อมูลข้อความและภาพไว้ใน Calc จองวัตถุกราฟิกที่มีชื่อในเทมเพลต Writer และทำการรวมโดยอัตโนมัติด้วยมาโคร LibreOffice Basic คู่มือนี้ใช้วิธีที่สอง

คำแนะนำเหล่านี้สอดคล้องกับเอกสาร LibreOffice 26.2 ที่มีให้ใช้งานในปี 2026 เมนูอาจแตกต่างกันเล็กน้อยในเวอร์ชันอื่นหรือบน macOS คู่มือ Writer ปัจจุบันของ LibreOffice ระบุว่าสามารถฝังหรือเชื่อมโยงรูปภาพได้ ในขณะที่ UNO API เปิดเผยออบเจ็กต์กราฟิกของ 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 ใช้แหล่งข้อมูลที่ลงทะเบียนไว้ คุณสามารถใช้ตัวช่วยสร้างการผสานจดหมาย แหล่งข้อมูลที่อยู่ หรือตัวเลือกเรียกดูแหล่งข้อมูล เอกสารช่วยเหลือของ LibreOffice ในปัจจุบันดูที่ เครื่องมือ > ตัวช่วยสร้างการผสานจดหมายและยังอนุญาตให้แทรกฟิลด์ฐานข้อมูลผ่านทางแทรก > ฟิลด์ > ฟิลด์เพิ่มเติม > ฐานข้อมูลดูข้อมูลอ้างอิงฟิลด์ฐานข้อมูล อย่างเป็นทางการ

การตรวจสอบนี้มีประโยชน์แม้ว่ามาโครสุดท้ายจะอ่านสเปรดชีตโดยตรงก็ตาม มันช่วยตรวจจับปัญหาทั่วไปได้ตั้งแต่เนิ่นๆ เช่น ชีตผิด ชื่อส่วนหัวที่ไม่คาดคิด ข้อมูลว่าง หรือสเปรดชีตที่ถูกย้ายหลังจากลงทะเบียนแล้ว

สำหรับการผสานจดหมายแบบข้อความธรรมดา คุณสามารถลากหัวคอลัมน์ลงในเอกสาร หรือแทรกฟิลด์ผสานจดหมายจากแท็บฐานข้อมูลได้ คู่มือช่วยเหลืออย่างเป็นทางการของ Writer ยืนยันว่าฟิลด์เหล่านี้จะถูกแทนที่ด้วยเนื้อหาจากฐานข้อมูลเมื่อทำการผสาน อย่างไรก็ตาม สำหรับรูปภาพแบบแปรผัน อย่าคิดว่าการลากImagePathลงในหน้าจะเปลี่ยนเส้นทางนั้นให้เป็นรูปภาพ มันจะยังคงเป็นข้อมูลอยู่ เว้นแต่ว่าโค้ดจะตีความและอัปเดตวัตถุกราฟิก

ขั้นตอนที่ 3: สร้างเทมเพลต Writer และตั้งชื่อตัวยึดตำแหน่งรูปภาพ

สร้างเค้าโครงจดหมาย ใบรับรอง ตราสัญลักษณ์ หรือรายงานใน Writer สำหรับค่าข้อความ ให้ใช้ฟิลด์การผสานจดหมายแบบปกติ หรือใช้โทเค็นที่ชัดเจน เช่น <br> {FirstName}, {LastName}<br> และ <br> {CustomerID}หากมาโครของคุณจะแทนที่ค่าเหล่านั้นเอง

ถัดไป ให้แทรกภาพตัวอย่างในตำแหน่งที่ควรแสดงภาพตัวแปร กำหนดขนาด การจัดวาง และจุดยึดที่ต้องการก่อนที่จะทำการสร้างภาพอัตโนมัติ เอกสารของ LibreOffice อธิบายเกี่ยวกับการกำหนดขนาดภาพ ตำแหน่ง จุดยึด การจัดวาง และพฤติกรรมของภาพที่เชื่อมโยงไว้ในบท "ภาพและกราฟิก" ของ Writer 26.2ฉบับ ปัจจุบัน

ตั้งชื่อวัตถุกราฟิกให้คงที่ เช่นMergeImage`<ชื่อวัตถุ>` หน้าต่างคุณสมบัติอาจแตกต่างกันไปในแต่ละเวอร์ชัน ดังนั้นหากคุณไม่แน่ใจว่า Writer แสดงวัตถุใด ให้ใช้Tools > Development Toolsเครื่องมือพัฒนาของ LibreOffice สามารถตรวจสอบวัตถุกราฟิก คุณสมบัติ เมธอด และอินเทอร์เฟซในเอกสารปัจจุบันได้ ทำให้เป็นเครื่องมือวินิจฉัยที่ปลอดภัยกว่าการเดาชื่อวัตถุภายใน

เพื่อให้การจัดวางดูเป็นระเบียบ ให้ใช้สัดส่วนภาพเดียวกันสำหรับภาพต้นฉบับทั้งหมด หรือตัดสินใจว่าจะตัดขอบภาพอย่างไร โปรแกรม Writer สามารถปรับขนาดภาพให้มีขนาดเท่ากับขนาดของกรอบที่กำหนดไว้ได้ แต่ภาพถ่ายแนวตั้งที่แทรกอยู่ในกรอบรูปทรงแบนเนอร์กว้างๆ จะยังคงดูไม่ถูกต้อง เว้นแต่คุณจะปรับขนาดไฟล์ให้เป็นมาตรฐานก่อน

ขั้นตอนที่ 4: ตั้งค่าการส่งออกรูปภาพและเอกสารแบบอัตโนมัติ

ขั้นตอนการทำงานอัตโนมัติหลักนั้นตรงไปตรงมา: เปิดเทมเพลต แทนที่ข้อความตัวอย่าง ค้นหาวัตถุกราฟิกที่ระบุชื่อ โหลดไฟล์ภาพของแถวนั้นลงในวัตถุ แล้วส่งออกผลลัพธ์ เอกสาร API ของ LibreOffice UNO อธิบายวิธี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 ภายนอกได้ สำหรับการใช้งานขนาดใหญ่ ควรพิจารณาโหลดกราฟิกผ่าน API ที่ทันสมัยแทนที่จะGraphicพึ่งพาพฤติกรรมความเข้ากันได้ของGraphicURLเอกสารอ้างอิงอย่างเป็นทางการคือXTextGraphicObjectsSupplierและTextGraphicObject

ขั้นตอนที่ 5: ทดลองทดสอบในปริมาณน้อยและตรวจสอบผลลัพธ์

ก่อนที่จะประมวลผลแหล่งข้อมูลทั้งหมด ให้ลองประมวลผลข้อมูลสองหรือสามแถวที่แตกต่างกันโดยเจาะจง เช่น ไฟล์ JPG หนึ่งไฟล์ ไฟล์ PNG หนึ่งไฟล์ และถ้าเป็นไปได้ควรมีภาพที่มีอัตราส่วนภาพแตกต่างกันอีกหนึ่งภาพ ตรวจสอบสิ่งต่อไปนี้ทั้งหมดก่อนที่จะขยายขนาด:

• ชื่อผู้รับในเอกสารตรงกับรูปภาพในแถวเดียวกันของสเปรดชีต
• ในเอกสารฉบับสุดท้าย จะไม่มีการแสดงเส้นทางของรูปภาพเป็นข้อความตรงๆ
• ชื่อไฟล์ผลลัพธ์ตรงกับข้อมูลที่ต้องการและจะไม่เขียนทับข้อมูลของผู้รับรายอื่น
• รูปภาพจะพอดีกับพื้นที่ที่สงวนไว้โดยไม่ทำให้ข้อความต้องไปอยู่ในหน้าใหม่หรือทับซ้อนกับวัตถุอื่น
• ไฟล์ PDF หรือ ODT ที่สร้างขึ้นจะเปิดได้โดยอิสระหลังจากปิดโปรแกรม LibreOffice และ Calc แล้ว

การตรวจสอบครั้งสุดท้ายนี้สำคัญมาก เพราะกราฟิกที่เชื่อมโยงและกราฟิกที่ฝังอยู่ในเอกสารมีพฤติกรรมที่แตกต่างกัน คู่มือการใช้งาน Writer ฉบับปัจจุบันอธิบายว่า รูปภาพที่เชื่อมโยงยังคงเป็นการอ้างอิงไฟล์แยกต่างหาก ในขณะที่รูปภาพที่ฝังอยู่ในเอกสารจะกลายเป็นส่วนหนึ่งของเอกสาร หากคุณกำลังส่งไฟล์ ODT ไปยังเครื่องอื่น โปรดตรวจสอบให้แน่ใจว่าผลลัพธ์ไม่ได้ขึ้นอยู่กับเส้นทางภายในเครื่องที่อยู่เฉพาะในคอมพิวเตอร์ที่ทำการรวมไฟล์เท่านั้น

ข้อผิดพลาดที่พบบ่อยและวิธีแก้ไขที่รวดเร็วที่สุด

ผลลัพธ์ที่แสดงคือเส้นทางของไฟล์แทนที่จะเป็นรูปภาพ

คุณได้แทรกImagePathข้อมูลในรูปแบบฟิลด์ผสานจดหมายปกติ ซึ่งคาดว่าจะสร้างข้อความออกมา ให้คงเส้นทางไว้ในแหล่งข้อมูล แต่ให้มาโครโหลดข้อมูลนั้นลงในวัตถุกราฟิกที่กำหนดชื่อไว้

ทุกบันทึกจะได้รับภาพเดียวกัน

รูปภาพแม่แบบไม่เคยเปลี่ยนแปลงระหว่างระเบียน หรือลูปของคุณกำลังอ่านเซลล์คงที่ บันทึกหมายเลขแถวและImagePathระหว่างการทดสอบสองระเบียน หากเส้นทางเปลี่ยนแปลงแต่รูปภาพไม่เปลี่ยนแปลง ให้ตรวจสอบชื่อวัตถุกราฟิกด้วยเครื่องมือสำหรับนักพัฒนา

มาโครแจ้งว่า MergeImage ไม่มีอยู่จริง

ภาพกราฟิกถูกเปลี่ยนชื่อ ถูกแทนที่ หรือไม่แสดงภายใต้ชื่อที่คุณคาดหวัง เลือกภาพและตรวจสอบด้วยTools > Development Tools API ของ UNO แสดงวัตถุกราฟิกตามชื่อ ดังนั้นมาโครและเทมเพลตต้องตรงกันทุกประการ

ภาพหายไปในคอมพิวเตอร์เครื่องอื่น

คุณอาจบันทึกเอกสารที่ยังคงอ้างอิงถึงไฟล์ภายนอกอยู่ หากความสะดวกในการพกพาเป็นสิ่งสำคัญ โปรดตรวจสอบให้แน่ใจว่าไฟล์ที่ส่งออกนั้นฝังรูปภาพไว้ หรือส่งออกเป็น PDF หลังจากโหลดรูปภาพแล้ว คู่มือเกี่ยวกับรูปภาพของ LibreOffice อธิบายความแตกต่างระหว่างกราฟิกที่เชื่อมโยงและกราฟิกที่ฝังอยู่ และวิธีการตัดการเชื่อมโยงเพื่อฝังไฟล์

การผสานจดหมายด้วย HTML จะทำให้รูปภาพหายไป

นี่เป็นข้อจำกัดที่มีการบันทึกไว้และควรตรวจสอบก่อนเลือกรูปแบบการส่งออกทางอีเมล คู่มือช่วยเหลือของ LibreOffice ระบุว่า เมื่อจดหมายแบบฟอร์มอยู่ในรูปแบบ HTML รูปภาพที่ฝังหรือลิงก์จะไม่ถูกส่งไปพร้อมกับอีเมล หากรูปภาพมีความสำคัญ ให้ใช้ไฟล์ PDF แนบมาด้วย หรือทดสอบวิธีการส่งอื่นๆ แทนที่จะคิดว่าการผสานจดหมาย HTML จะรักษารูปภาพไว้ได้ ดูหัวข้อการสร้างจดหมายแบบฟอร์ม

เมื่อใดควรใช้บริการ MailMerge UNO ของ LibreOffice แทน

หากช่องข้อความของคุณใช้การผสานจดหมายจากฐานข้อมูลแบบดั้งเดิมของ Writer อยู่แล้ว และคุณต้องการควบคุมผลลัพธ์ด้วยโปรแกรม LibreOffice ก็มีMailMergeบริการนี้ให้ใช้งานเช่นกัน คุณสมบัติที่ระบุไว้ในเอกสารประกอบด้วยDataSourceName, Command, DocumentURL, OutputURL, FileNameFromColumn, และSaveAsSingleFileAPI นี้มีประโยชน์เมื่อคุณต้องการทำให้การผสานจดหมายมาตรฐานเป็นไปโดยอัตโนมัติจากโค้ด อย่างไรก็ตาม API นี้ยังไม่ได้ระบุฟิลด์เส้นทางไฟล์ภาพต่อระเบียน ดังนั้นคุณอาจต้องรวมการดำเนินการผสานจดหมายเข้ากับการจัดการวัตถุกราฟิก ดูเอกสารอ้างอิงบริการ MailMergeอย่าง เป็นทางการ

รายการตรวจสอบขั้นสุดท้าย

• ใช้ฟังก์ชันการผสานจดหมายของ Writer ตามปกติเมื่อรูปภาพถูกกำหนดไว้ตายตัวสำหรับผู้รับทุกคน
• ใช้ImagePathคอลัมน์ที่สะอาดเพียงคอลัมน์เดียวเมื่อภาพมีความแตกต่างกันในแต่ละระเบียน
• ตั้งชื่อให้กับภาพกราฟิกของนักเขียนและคงขนาดให้คงที่
• แก้ไขเส้นทางของรูปภาพในระบบอัตโนมัติ อย่าคาดหวังว่าฟิลด์การผสานข้อความจะกลายเป็นรูปภาพโดยอัตโนมัติ
• ทดสอบข้อมูลสองหรือสามชุดก่อนที่จะทำการประมวลผลข้อมูลทั้งหมด
• หลังจากปิดเอกสารต้นฉบับแล้ว ให้เปิดไฟล์ที่ส่งออกเพื่อตรวจสอบว่าไฟล์ที่ได้นั้นสมบูรณ์ในตัวเอง

สำหรับงานขนาดเล็กและขนาดกลางส่วนใหญ่ การใช้ชีต Calc ร่วมกับเทมเพลต Writer และมาโคร Basic สั้นๆ จะให้ความสมดุลที่ดีที่สุดระหว่างความโปร่งใสและการควบคุม ถึงแม้จะต้องมีการตั้งค่ามากกว่าการผสานข้อความธรรมดา แต่คุณจะเห็นได้อย่างชัดเจนว่าแถวใดเป็นแหล่งที่มาของภาพแต่ละภาพ เลือกชื่อไฟล์เอาต์พุต และตรวจสอบความถูกต้องของผลลัพธ์ก่อนส่งไฟล์ส่วนบุคคลหลายร้อยไฟล์