Создание документа Word (docx) с использованием данных из файла XML / Преобразование XML в документ Word на основе шаблона

Хорошо, нашел здесь подробное руководство по использованию XSLT в качестве шаблона для создания документа Word: Использование XSLT и Open XML для создания документа Word 2007.

Похоже, что хотя эта статья предназначена для Word 2007, она отлично работает в Word 2016.

Единственная проблема с этим методом заключается в том, что если позже потребуются изменения в шаблоне, требуется много усилий для обновления файла xslt, и это неудобно для пользователя, поскольку он не может быть обновлен в самом Word и фактическом XML документа. нужно манипулировать.

С другой стороны, создание документов ОЧЕНЬ гибкое со всеми возможностями, доступными через XSL (foreach, переменные, условия if и т. д.)

Выяснили, как использовать элементы управления содержимым для создания документов и как вставлять данные из XML в элементы управления содержимым. Я разделил это на 2 части:

• Часть 1. Создайте свой шаблон документа для создания документа.
• Часть 2: Используйте код на C# для создания документов на основе шаблона

Часть 1. Создайте свой шаблон документа для создания документа.

1. Создайте образец XML, на основе которого вы можете создать шаблон Word для создания документа. Желательно начать с менее сложной версии, чтобы понять ее.

Я использовал следующий XML для тестирования. Для тестирования у меня не было повторяющихся разделов, картинок и т. д.

<?xml version = "1.0" encoding = "utf-8"?>
<mydata xmlns = "http://CustomDemoXML.htm">
    <field1>This is the value in field1 from the XML file</field1>
    <field2>This is the value in field2 from the XML file</field2>
    <field3>This is the value in field3 from the XML file</field3>
</mydata>

Примечание 1: это будет просто образец XML для создания вашего шаблона Word. XML-файл (ы) с реальными данными в том же формате позже можно будет применить при создании документа (ов) Word из шаблона.

Заметка 2: Атрибут xmlns может содержать буквально все, что вы хотите, и это не обязательно должен быть URL, начинающийся с http.

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

2. Убедитесь, что в вашей копии Word включена вкладка Developer [File -> Options -> Customize Ribbon -> В разделе Customize the Ribbon убедитесь, что выбрано Developer -> OK]. Подробности: Как: показать вкладку разработчика на ленте

3. Создайте новый документ Word (или используйте существующий документ Word), который будет вашим шаблоном для создания документа.

4. На вкладке Developer щелкните XML Mapping Pane. Это откроет XML Mapping Pane в правой части документа.

5. На панели сопоставления XML выберите раскрывающийся список Custom XML Part -> Выбрать (Add new part).

6. Выберите файл XML, который вы сохранили на шаге 1 -> Open.

7. На панели сопоставления XML выберите раскрывающийся список Custom XML Part -> выберите элемент с текстом, который был в атрибуте xmlns настраиваемого файла XML. Если вы используете приведенный выше образец файла, это будет http://CustomDemoXML.htm.

8. Добавьте статический текст в документ Word и добавьте рядом с ним Plain Text Content Control (на вкладке Developer -> раздел Controls. Повторите для всех полей, которые вам нужно добавить.

Для приведенного выше примера XML у меня был следующий документ Word:

9. Щелкните первый Plain Text Content Control -> На панели сопоставления XML щелкните правой кнопкой мыши поле, которое вы хотите сопоставить с этим элементом управления содержимым -> Щелкните Map to Selected Content Control. Повторите эти действия для всех полей, которые хотите сопоставить.

Примечание: В качестве альтернативы, вместо добавления элементов Plain Text Content Control из вкладки разработчика на шаге 8, вы можете щелкнуть правой кнопкой мыши поле, которое вы хотите сопоставить, на панели сопоставления XML -> Щелкните Insert Content Control -> Щелкните Plain Text.

Точно так же вы также можете добавить другие типы элементов управления, такие как флажки, средства выбора даты и даже повторяющиеся разделы (он также поддерживает вложенные повторяющиеся разделы! - начиная с Word 2013) и сопоставить данные из XML с теми, которые используют только встроенные функции Word и без какой-либо третьей стороны. инструменты!

10. Сохраните свой шаблон документа.

Часть 2: Используйте код на C# для создания документов на основе шаблона

При этом используется рекомендованный Microsoft OpenXML SDK для создания документов с использованием XML-файла, содержащего реальные данные.

1. Создайте свой XML-файл / откройте существующий XML-файл, чтобы сгенерировать документ из шаблона, созданного выше. Он должен быть в том же формате, что и образец XML-файла, использованного для создания шаблона.

2. Используйте OpenXML SDK для удаления любых элементов CustomXMLPart из документа. Это предполагает, что в документе не используются никакие другие настраиваемые части XML, как в этом примере. В сложных сценариях при необходимости можно удалить определенные части XML.

3. Используйте OpenXML SDK, чтобы добавить новый CustomXMLPart на основе файла XML на шаге № 1 выше.

Вот пример кода, который я должен «обновить» / «перезагрузить» для образцов данных в шаблоне данными из XML-файла, содержащего реальные данные (при условии, что XML-файл, используемый для создания документа, уже создан и сохранен):

using System.IO;
using DocumentFormat.OpenXml.Packaging;

namespace SampleNamespace
{
    public static class SampleClass
    {
        public static void GenerateDocument()
        {
            string rootPath = @"C:\Temp";
            string xmlDataFile = rootPath + @"\MyNewData.xml";
            string templateDocument = rootPath + @"\MyTemplate.docx";
            string outputDocument = rootPath + @"\MyGeneratedDocument.docx";

            using (WordprocessingDocument wordDoc = WordprocessingDocument.Open(templateDocument, true))
            {
                //get the main part of the document which contains CustomXMLParts
                MainDocumentPart mainPart = wordDoc.MainDocumentPart;

                //delete all CustomXMLParts in the document. If needed only specific CustomXMLParts can be deleted using the CustomXmlParts IEnumerable
                mainPart.DeleteParts<CustomXmlPart>(mainPart.CustomXmlParts);

                //add new CustomXMLPart with data from new XML file
                CustomXmlPart myXmlPart = mainPart.AddCustomXmlPart(CustomXmlPartType.CustomXml);
                using (FileStream stream = new FileStream(xmlDataFile, FileMode.Open))
                {
                    myXmlPart.FeedData(stream);
                }
            }

        }
    }
}

Это оно!

Мы создали автоматизированный способ заполнения данных XML-файла в документе Word или PowerPoint. Мы используем надстройку, которая использует элементы управления содержимым, чтобы связать содержимое Excel (диапазоны, таблицы, диаграммы, фигуры и т. д.) С Word или PowerPoint. Ссылки портативны и надежны. Также легко обновить, если вам нужно внести какие-либо изменения в ваши документы. Вы можете найти надстройку через приложение Excel - просто выполните поиск надстроек «Автоматизация преобразования документов из Excel в Word» через «Получить надстройки» на вкладке «Вставка». Вы также можете узнать об этом больше здесь.