Correspondence Management | Handling user data correspondence-management-handling-user-data

CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

AEM Forms Correspondence Management enables you to create, manage, and streamline secure and personalized customer correspondences. It provides an intuitive user interface for business users to create correspondences using pre-approved content blocks and media elements. For more information about creating correspondences, see Create Correspondence.

When a business user or an agent saves a correspondence as draft or submits it, a letter instance is saved in the AEM repository. The letter instance includes correspondence data and metadata.

NOTE
In AEM 6.4 Forms, correspondence management is not available out of the box. If you are upgrading from a previous AEM Forms version, install the compatibility package and migrate your correspondence management assets to continue to use them in AEM 6.4 Forms. For more information, see Compatibility package.

User data and data stores data

Correspondence management stores data for draft and submitted letters in AEM repository only if the publish instance is configured to manage letter instances. For more information about the configuration, see Correspondence Management configuration properties.

Depending on the data store persistence configured for your AEM deployment, drafts and submitted correspondence data is stored at the following locations.

Persistence type
Data store
Location
Default
AEM repository of publish instance and author instances specified in reverse replication configuration
/content/apps/cm/letterInstances/[yyyy]/[mm]/[dd]/[node-id]/[letter-instance-name]/
Remote
AEM repository of the remote processing author instance
/content/apps/cm/letterInstances/[yyyy]/[mm]/[dd]/[node-id]/[letter-instance-name]/

In the above specified AEM repository location:

  • [yyyy]/[mm]/[dd] is the node structure based on the date when the letter instance was created
  • [node-id] is the ID assigned to the folder containing the letter
  • [letter-instance-name] is the name specified when saving or submitting a letter

Under the [letter-instance-name] node, the following node structure is created and the data for each letter instance is stored in the AEM repository:

Node
Description
extendedProperties
Stores metadata properties of the letter instance.
dataXML
Stores a downloadable dataXML file containing the correspondence data in binary format.
processedXDP
Includes the details of the XDP template used to create the submitted letter. This node is created only for submitted correspondences.
submittedLetter
Stores the submitted letter data in downloadable binary format. This node is created only for submitted correspondences.

Access and delete user data access-and-delete-user-data

You can access draft and submitted correspondence data in the configured data stores, and if necessary, delete it.

Access user data access-user-data

Correspondence management provides APIs that you can use to find and access draft and submitted letter instances. Using the APIs, you can find and open letter instances using the letter instance ID or the user who saved or submitted the correspondence. For more information, see APIs to access letter instances.

Alternatively, you can navigate to the letter instance in AEM repository using CRX DELite. See User data and data stores for information about stored data and repository location.

Delete user data delete-user-data

To find a letter instance containing the data of a specific user, you can:

  • Use correspondence management APIs if letter instance name or the user who saved the draft or submitted the correspondence is known
  • Use AEM repository search using personally identifiable information like the email ID or name to find the node where the information is stored

To delete user data from draft and submitted correspondences completely from AEM systems, you must manually delete the letter instance node from all applicable AEM instances.

recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da