We are performing mailmerge operation to generate a document using aspose words cloud api, is there any specific to dynamically add images to the document?
To dynamically add images to a document during a mail merge operation using the Aspose.Words Cloud API, you can utilize the Image merge field. This allows you to specify an image source for each record in your data source.
Here’s a step-by-step guide on how to achieve this:
-
Prepare your document: In your template document, insert a merge field where you want the image to appear, for example,
{{ImageField}}. -
Set up your data source: Ensure your data source includes a field that contains the image paths or base64 strings.
-
Perform the mail merge: Use the
MailMergemethod to execute the merge, passing the data source.
Here’s a sample code snippet:
import aspose.words as aw
# Load the document
doc = aw.Document("template.docx")
# Create a data source
data = [
{"ImageField": "path/to/image1.png"},
{"ImageField": "path/to/image2.png"}
]
# Execute mail merge
doc.mail_merge.execute(data)
# Save the output document
doc.save("output.docx")
In this example, replace "path/to/image1.png" and "path/to/image2.png" with the actual paths to your images. The ImageField in the data source should correspond to the merge field in your document.
If you have any further questions or need additional examples, please feel free to ask!
@skitzosiva You can use special field name like Image:MyImage to insert am image upon executing mail merge. For example see the attached template and sample code:
Document doc = new Document(@"C:\Temp\in.docx");
doc.MailMerge.Execute(new string[] { "MyImage" }, new string[] { @"C:\Temp\test.png" });
doc.Save(@"C:\Temp\out.docx");
You can also implement ImageFieldMerging in IFieldMergingCallback to control image insertion process upon executing mail merge.
Also, you can use DocumentBuilder in FieldMerging to insert images upon executing mail merge:
Document doc = new Document(@"C:\Temp\in.docx");
doc.MailMerge.FieldMergingCallback = new MyFieldMergingCallback();
doc.MailMerge.Execute(new string[] { "test" }, new string[] { @"C:\Temp\test.png" });
doc.Save(@"C:\Temp\out.docx");
private class MyFieldMergingCallback : IFieldMergingCallback
{
public void FieldMerging(FieldMergingArgs args)
{
DocumentBuilder builder = new DocumentBuilder(args.Document);
builder.MoveToField(args.Field, true);
builder.InsertImage((string)args.FieldValue);
args.Field.Remove();
}
public void ImageFieldMerging(ImageFieldMergingArgs args)
{
// Do nothing
}
}
How to do this using api? can you explain please? ( we are trying to generate the report using Apex(salesforce))
yes right now we perform mail merge using this endpoint:
we send our data as a json