Assembling Non-Interactive PDF Documents

Include project files.

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

NOTE

Replace localhost with the IP address of the server hosting AEM Forms.

Create an Assembler client.

• Create an AssemblerServiceClient object by using its default constructor.

• Create an AssemblerServiceClient.Endpoint.Address object by using the System.ServiceModel.EndpointAddress constructor. Pass a string value that specifies the WSDL to the AEM Forms service (for example, http://localhost:8080/soap/services/AssemblerService?blob=mtom). 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 AssemblerServiceClient.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 AssemblerServiceClient.ClientCredentials.UserName.UserName.
  • Assign the corresponding password value to the field AssemblerServiceClient.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.

Reference an existing DDX document.

• Create a BLOB object by using its constructor. The BLOB object is used to store the DDX document.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the DDX document and the mode to open the file in.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method. Pass the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM field with the contents of the byte array.

Reference an interactive PDF document.

• Create a BLOB object by using its constructor. The BLOB object is used to store the input PDF document. This BLOB object is passed to the invokeOneDocument as an argument.
• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the input PDF document and the mode to open the file in.
• Create a byte array that stores the content of the System.IO.FileStream object. You can determine the size of the byte array by getting the System.IO.FileStream object’s Length property.
• Populate the byte array with stream data by invoking the System.IO.FileStream object’s Read method. Pass the byte array, the starting position, and the stream length to read.
• Populate the BLOB object by assigning its MTOM field with the contents of the byte array.

Set run-time options.

• Create an AssemblerOptionSpec object that stores run-time options by using its constructor.
• Set run-time options to meet your business requirements by assigning a value to a data member that belongs to the AssemblerOptionSpec object. For example, to instruct the Assembler service to continue processing a job when an error occurs, assign false to the AssemblerOptionSpec object’s failOnError data member.

Assemble the PDF document.

Invoke the AssemblerServiceClient object’s invokeOneDocument method and pass the following values:

• A BLOB object that represents the DDX document
• A BLOB object that represents the interactive PDF document
• An AssemblerOptionSpec object that specifies run-time options

The invokeOneDocument method returns a BLOB object that contains a non-interactive PDF document.

Save the non-interactive PDF document.

• Create a System.IO.FileStream object by invoking its constructor and passing a string value that represents the file location of the non-interactive PDF document and the mode to open the file in.
• Create a byte array that stores the content of the BLOB object that the invokeOneDocument method returned. Populate the byte array by getting the value of the BLOB object’s MTOM field.
• Create a System.IO.BinaryWriter object by invoking its constructor and passing the System.IO.FileStream object.
• Write the contents of the byte array to a PDF file by invoking the System.IO.BinaryWriter object’s Write method and passing the byte array.