Mala Direta no MS Word com Java

Este guia descreve como realizar mala direta no MS Word com Java. Ele fornece detalhes sobre como configurar o IDE, uma lista de etapas e um código de exemplo demonstrando como fazer mala direta no Word com Java. Todos os dados necessários são gerados neste código para a execução sem recursos ausentes.

Etapas para Criar Mala Direta no Word com Java

  1. Configure o ambiente para usar o Aspose.Words para Java e criar uma mala direta
  2. Crie um modelo de arquivo do Word em um objeto Document usando a classe DocumentBuilder
  3. Adicione todos os campos ao modelo usando o método insertField()
  4. Crie o arquivo XML de entrada de acordo com os campos do modelo do Word
  5. Carregue o arquivo modelo do Word no objeto Document
  6. Chame o método getMailMerge().execute() na classe Document para gerar um arquivo Word de saída
  7. Salve o arquivo Word de saída

As etapas acima descrevem como realizar mala direta com Word e Java. Você pode criar um novo arquivo modelo do Word com campos ou carregar um modelo existente no objeto Document e ler o arquivo XML no objeto DataSet. Por fim, chame o método getMailMerge().execute(), passando a tabela selecionada, e salve o documento gerado.

Código para Criar Mala Direta no MS Word com Java

import com.aspose.words.*;
import com.aspose.words.net.System.Data.DataSet;
import java.io.FileWriter;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws Exception {
License pdfLicense = new License();
pdfLicense.setLicense("license.lic");
// Create a student report template
Document document = createStudentReportTemplate();
document.save("ReportTemplate.docx");
System.out.println("Report Template generated successfully.");
// Generate an XML file with sample student data
String xmlFileName = generateSampleStudentData();
System.out.println("Sample XML file '" + xmlFileName + "' has been created.");
// Perform mail merge using the dataset
Document doc = new Document("ReportTemplate.docx");
DataSet studentDataset = readXmlToDataSet(xmlFileName);
doc.getMailMerge().execute(studentDataset.getTables().get("Student"));
// Save the final report
doc.save("FinalReports.docx");
System.out.println("Mail merge completed. Output saved as 'FinalReports.docx'.");
}
static Document createStudentReportTemplate() throws Exception {
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Insert student name fields
builder.insertField("MERGEFIELD StudentFirstName \\\u002A MERGEFORMAT");
builder.insertField("MERGEFIELD StudentLastName \\\u002A MERGEFORMAT");
builder.writeln();
// Insert academic details
builder.insertField("MERGEFIELD Subject \\\u002A MERGEFORMAT");
builder.insertBreak(BreakType.LINE_BREAK);
builder.insertField("MERGEFIELD MarksObtained \\\u002A MERGEFORMAT");
builder.insertBreak(BreakType.LINE_BREAK);
builder.insertField("MERGEFIELD TotalMarks \\\u002A MERGEFORMAT");
builder.insertBreak(BreakType.LINE_BREAK);
builder.insertField("MERGEFIELD Grade \\\u002A MERGEFORMAT");
builder.writeln();
// Insert teacher comments
builder.insertField("MERGEFIELD TeacherComments \\\u002A MERGEFORMAT");
builder.insertBreak(BreakType.LINE_BREAK);
// Insert principal's name
builder.insertField("MERGEFIELD PrincipalName \\\u002A MERGEFORMAT");
builder.writeln();
return doc;
}
static String generateSampleStudentData() throws IOException {
String fileName = "StudentData.xml";
String xmlContent = """
<Students>
<Student>
<StudentFirstName>Emily</StudentFirstName>
<StudentLastName>Johnson</StudentLastName>
<Subject>Mathematics</Subject>
<MarksObtained>85</MarksObtained>
<TotalMarks>100</TotalMarks>
<Grade>A</Grade>
<TeacherComments>Excellent performance!</TeacherComments>
<PrincipalName>Dr. William Carter</PrincipalName>
</Student>
<Student>
<StudentFirstName>Liam</StudentFirstName>
<StudentLastName>Smith</StudentLastName>
<Subject>Science</Subject>
<MarksObtained>78</MarksObtained>
<TotalMarks>100</TotalMarks>
<Grade>B</Grade>
<TeacherComments>Good effort, keep improving.</TeacherComments>
<PrincipalName>Dr. William Carter</PrincipalName>
</Student>
</Students>
""";
try (FileWriter writer = new FileWriter(fileName)) {
writer.write(xmlContent);
}
return fileName;
}
static DataSet readXmlToDataSet(String xmlFileName) throws Exception {
DataSet dataSet = new DataSet();
dataSet.readXml(xmlFileName);
return dataSet;
}
}

Este código executa todas as etapas de mala direta no MS Word com Java. A classe DocumentBuilder possui vários métodos e propriedades que podem ser configurados para personalizar o modelo e formatar o relatório. O código gerará uma página separada no arquivo Word de saída para cada registro na tabela.

Este artigo explicou como usar mala direta no Word com Java. Para configurar o estilo da tabela em um arquivo existente, consulte o artigo sobre Design de tabelas no Word com Java.

 Português