DOCX Converter — Setup and User Guide

Conversion Process

The DOCX Converter tool performs conversion in two ways: 

  1. Convert DOCX files into XML file format and save the output XML file into your local system 

  2. Convert DOCX files into XML file format and upload them directly to your QPP NextGen repository 

Convert DOCX files into XML files

Once you have successfully set up the DOCX Converter tool, you can start conversion of your DOCX files into XML. To do that, follow the steps shown below –

  1. In the field Content Type, select the content type (corresponding to the content model you want to add support for) from the content types available on the connected server. 

    If a content model corresponding to your DOCX files is not available, you must create one. For more information, see how to create a content model in QPP NextGen. 
  2. In the field Source Folder, set the path to the folder on your local machine where DOCX files are stored for conversion. 

    Important: Make sure that all the DOCX files in the source folder are based on the selected content type beforehand. Otherwise, QPP NextGen would not allow you to open the converted XML files. 
  3. After selecting the source folder, you need to select the check-in preference – 

    • QPP NextGen: This will upload the converted files to QPP NextGen repository 

    • Local: This will save the converted files to your local system 

  4. Upon selecting QPP NextGen as your check-in preference, the destination collection option will appear. Here you need to select the collection within your QPP NextGen Server where you want to upload the output XML files. 

  5. There's an option to add the document to workflow after saving. Click on the checkbox to enable this option, and then click on OK. 

  6. Now you need to select the workflow to begin. Click the dropdown arrow and select the desired workflow. 

    This new enhancement empowers you to fine-tune your content management process, ensuring a more streamlined and customizable experience within the DOCX Converter tool. 
  7. After selecting the workflow, you need to select the Status. Then click on Save. 

  8. Upon selecting Local as your check-in preference, the destination folder option will appear. Here you need to select the folder on your local system where you want to store the output XML files. 

  9. Finally, click on the Convert and Check-in button to start the conversion process. 

  10. The DOCX Converter window displays the progress of the conversion by generating logs in the lower part of the window. The logs also display any errors that may occur during the conversion. 

  11. Once the conversion process is completed, the log will display a summary section at the top of the log files. The summary will include: total number of files processes, number of successful conversions, and number of failed conversions, along with a brief description of the errors encountered. 

DOCX Converter tool creates a folder with the name of the content model in the destination collection to store the converted files. 

After successfully converting DOCX files into XML format and uploading them directly to your QPP NextGen Server, you can easily open and edit them like a native asset you create on the server. 

Please be aware that certain unsupported content will not be converted as part of this process. Examples of unsupported content include shapes, objects (OLE), citations, and TOC (table of contents). 

DOCX Converter also creates a folder Images inside the content model folder to store any image files in the source DOCX files. The images associated with the uploaded XML files are stored separately in a collection (which can be the same as the XML files). You can set the collection path to store images in the file AppConfig.xml, which is described ahead in the section Configurations. 

Automatic log file rolling

The DOCX Converter tool monitors the size of the migration log file and initiate a rolling process when it reaches 1 MB, ensuring that historical logs are preserved while maintaining an optimal file size for easier management and analysis. This will streamline the migration process and provide users with a more reliable and efficient logging mechanism. 

Enhanced logging details

The logging mechanism has been upgraded to provide more comprehensive and detailed information during the conversion process. You can access detailed logs that include timestamps, file-specific information, and conversion statuses. 

Accessing DOCX Migration Log

To check the DOCX migration log, follow the steps shown below: 

  1. Open the Run application (Win+R), type %appdata% and press Enter. 

  2. This will open the "Roaming" file explorer. Click on the Quark folder. 

  3. Click on the DOCXMigrationTool folder. 

  4. Then click on the Logs folder. 

  5. In the Logs folder, you will find the required information. 

Some known data loss fixes during conversion

We've fixed some reported data loss issues that were identified during conversion. This improvement represents our steadfast commitment to data integrity and user satisfaction. Currently, only unsupported content like shapes, citations, OLE (Object Linking & Embedding), embedded images, and clip arts will not be converted.