Modifying Watermarks

You can modify an existing watermark using the Rights Management Java API or web service API. To make changes to an existing watermark, you retrieve it, modify its attributes, and then update it on the server. For example, assume that you retrieve an watermark and modify its opacity attribute. Before the change takes effect, you must update the watermark.

When you modify a watermark, the change impacts future documents that have the watermark applied to them. That is, existing PDF documents that contain the watermark are not affected.

Note: Only users with Rights Management administrative privileges can modify watermarks. That is, you must specify such a user when defining connection settings required to create a Rights Management service client object.

Note: For more information about the Rights Management service, see LiveCycle ES Services.

Summary of steps

To modify a watermark, perform the following steps:

1.	Include project files.

2.	Create a Rights Management Client API object.

3.	Retrieve the watermark to modify.

4.	Set the watermarks attributes.

5.	Update the watermark.

Include project files

Include necessary files into your development project. If you are creating a client application using Java, then include the necessary JAR files. If you are using web services, then make sure that you include the proxy files.

Create a Rights Management Client API object

Before you can programmatically perform a Rights Management service operation, you must create a Rights Management service client object. If you are using the Java API, create a RightsManagementClient object. If you are using the Rights Management web service API, create a RightsManagementServiceService object.

Retrieve the watermark to modify

To modify a watermark, you must retrieve an existing watermark. You can retrieve a watermark by specifying its name or by specifying its identifier value.

Set the watermarks attributes

To modify an existing watermark, change the value of one or more watermark attributes. When programmatically updating a watermark using a web service, you must set all of the attributes that were orginally set, even if the value does not change. For example, assume the following watermark attributes are set: WaterBackCmd:IS_USERID_ENABLED, WaterBackCmd:IS_CUSTOMTEXT_ENABLED, WaterBackCmd:OPACITY, and WaterBackCmd:SRCTEXT. Although the only arrtibute that you want to modify is WaterBackCmd:OPACITY, you must set the other values are well.

Note: When using the Java API to modify a watermark, you do not need to specify all attributes. Set the watermark attribute that you want to modify.

Note: For information about the watermark attrbute names, see Set the watermarks attributes.

Update the watermark

After you modify a watermark’s attributes, you must update the watermark.


View Java walkthrough	View web service walkthrough

Current page: http://livedocs.adobe.com/livecycle/8.2/programLC/programmer/help/000556_2.html