GroupDocs.Metadata for Java 20.6 Release Notes

Major Features

There are the following features, enhancements and fixes in this release:

  • Implement the ability to add, update and remove IPTC metadata in TIFF images
  • Implement the ability to export metadata properties to an xls/xlsx worksheet
  • Exception: Could not read MPP format

Full List of Issues Covering all Changes in this Release

KeySummaryCategory
METADATANET-2495Implement the ability to add, update and remove IPTC metadata in TIFF imagesNew Feature
METADATANET-3332Implement the ability to export metadata properties to an xls/xlsx worksheetImprovement
METADATANET-3338Exception: Could not read MPP formatBug

Public API and Backward Incompatible Changes

Implement the ability to add, update and remove IPTC metadata in TIFF images

This new feature allows the user to add, update and remove IPTC metadata packages in TIFF images.

Public API changes

The TiffRootPackage class now implements the IIptc interface

The setIptcPackage method has been added to the TiffRootPackage class

Use cases

Add or update IPTC metadata in a TIFF image

Java

 try (Metadata metadata = new Metadata("D:\\input.tif")) {
	IIptc root = (IIptc) metadata.getRootPackage();

	// Set the IPTC package if it's missing
	if (root.getIptcPackage() == null) {
		root.setIptcPackage(new IptcRecordSet());
	}

	if (root.getIptcPackage().getEnvelopeRecord() == null) {
		root.getIptcPackage().setEnvelopeRecord(new IptcEnvelopeRecord());
	}

	root.getIptcPackage().getEnvelopeRecord().setDateSent(new Date());
	root.getIptcPackage().getEnvelopeRecord().setProductID("test project id");

	// ...
	if (root.getIptcPackage().getApplicationRecord() == null) {
		root.getIptcPackage().setApplicationRecord(new IptcApplicationRecord());
	}

	root.getIptcPackage().getApplicationRecord().setByLine("GroupDocs");
	root.getIptcPackage().getApplicationRecord().setHeadline("test");
	root.getIptcPackage().getApplicationRecord().setByLineTitle("code sample");
	root.getIptcPackage().getApplicationRecord().setReleaseDate(new Date());

	// ...
	metadata.save("D:\\output.tif");
}

Implement the ability to export metadata properties to an xls/xlsx worksheet

This improvement allows the user to export an arbitrary set of metadata properties to an Excel workbook.

Public API changes

The com.groupdocs.metadata.export package has been introduced

The ExportFormat class has been added to the com.groupdocs.metadata.export package

The ExportManager class has been added to the com.groupdocs.metadata.export package

Use cases

Export the whole metadata tree to an Excel workbook

Java

try (Metadata metadata = new Metadata(Constants.InputDoc)) {
	RootMetadataPackage root = metadata.getRootPackage();
	if (root != null) {
		// Initialize the export manager with the root metadata package to export the whole metadata tree
		ExportManager manager = new ExportManager(root);
		manager.export(Constants.OutputXls, ExportFormat.Xls);
	}
}