Creating Watermarks

To create a watermark, perform the following steps:

1. Include project files.

2. Create a Rights Management Client API object.

3. Set the watermarks attributes.

4. Register the watermark with the Rights Management service.

Create a watermark by using the Rights Management API (Java):

1. Include project files.

   Include client JAR files, such as the adobe-rightsmanagement-client.jar, in your Java project’s class path.

2. Create a Rights Management Client API object.

   • Create a ServiceClientFactory object that contains connection properties.

   • Create a RightsManagementClient object by using its constructor and passing the ServiceClientFactory object.

3. Set the watermark attributes

   • Create a Watermark object by invoking the InfomodelObjectFactory object’s static createWatermark method. This method returns a Watermark object.

   • Set the watermark’s name attribute by invoking the Watermark object’s setName method and passing a string value that specifies the policy name.

   • Set the watermark’s background attribute by invoking the Watermark object’s setBackground method and passing true . By setting this attribute, the watermark appears in the background of the document.

   • Set the watermark’s custom text attribute by invoking the Watermark object’s setCustomText method and passing a string value that represents the watermark’s text.

   • Set the watermark’s opacity attribute by invoking the Watermark object’s setOpacity method and passing an integer value that specifies the opacity level. A value of 100 indicates the watermark is completely opaque and a value of 0 indicates the watermark is completely transparent.

4. Register the watermark.

   • Create a WatermarkManager object by invoking the RightsManagementClient object’s getWatermarkManager method. This method returns a WatermarkManager object.

   • Register the watermark by invoking the WatermarkManager object’s registerWatermark method and passing the Watermark object that represents the watermark to register. This method returns a string value that represents the watermark’s identification value.

Create a watermark by using the Rights Management API (web service):

1. Create a Rights Management Client API object.

   Create a Microsoft .NET project that uses MTOM. Ensure that you use the following WSDL definition: http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1 .

   Note: Replace localhost with the IP address of the server hosting LiveCycle.

2. Create a Rights Management Client API object.

   • Create a RightsManagementServiceClient object by using its default constructor.

   • Create a RightsManagementServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the LiveCycle service (for example, http://localhost:8080/soap/services/RightsManagementService?WSDL .) You do not need to use the lc_version attribute. This attribute is used when you create a service reference.)

   • Create a System.ServiceModel.BasicHttpBinding object by getting the value of the RightsManagementServiceClient.Endpoint.Binding field. Cast the return value to BasicHttpBinding .

   • Set the System.ServiceModel.BasicHttpBinding object’s MessageEncoding field to WSMessageEncoding.Mtom . This value ensures that MTOM is used.

   • Enable basic HTTP authentication by performing the following tasks:

     • Assign the AEM forms user name to the field RightsManagementServiceClient.ClientCredentials.UserName.UserName .

     • Assign the corresponding password value to the field RightsManagementServiceClient.ClientCredentials.UserName.Password .

     • Assign the constant value HttpClientCredentialType.Basic to the field BasicHttpBindingSecurity.Transport.ClientCredentialType .

   • Assign the constant value BasicHttpSecurityMode.TransportCredentialOnly to the field BasicHttpBindingSecurity.Security.Mode .

3. Set the watermark attributes.

   • Create a WatermarkSpec object by invoking the WatermarkSpec constructor.

   • Set the watermark’s name by assigning a string value to the WatermarkSpec object’s name data member.

   • Set the watermark’s id attribute by assigning a string value to the WatermarkSpec object’s id data member.

   • For each watermark property to set, create a separate MyMapOf_xsd_string_To_xsd_anyType_Item object.

   • Set the key value by assigning a value to the MyMapOf_xsd_string_To_xsd_anyType_Item object’s key data member (for example, WaterBackCmd:OPACITY) .

   • Set the value by assigning a value to the MyMapOf_xsd_string_To_xsd_anyType_Item object’s value data member (for example, .25 ).

   • Create a MyArrayOf_xsd_anyType object. For each MyMapOf_xsd_string_To_xsd_anyType_Item object, invoke the MyArrayOf_xsd_anyType object’s Add method. Pass the MyMapOf_xsd_string_To_xsd_anyType_Item object.

   • Assign the MyArrayOf_xsd_anyType object to the WatermarkSpec object’s values data member.

4. Register the watermark.

   Register the watermark by invoking the RightsManagementServiceClient object’s registerWatermark method and passing the WatermarkSpec object that represents the watermark to register.