服务容器中的大多数AEM Forms服务都配置为公开Web服务,并完全支持Web服务定义语言(WSDL)生成。 即,您可以创建使用AEM Forms服务的本机SOAP堆栈的代理对象。 因此,AEM Forms服务可以交换和处理以下SOAP消息:
使用Web服务,您可以执行与使用Java API相同的AEM Forms服务操作。 使用Web服务调用AEM Forms服务的一个好处是,您可以在支持SOAP的开发环境中创建客户端应用程序。 客户端应用程序不绑定到特定的开发环境或编程语言。 例如,可以使用Microsoft Visual Studio .NET和C#作为编程语言创建客户端应用程序。
AEM Forms服务通过SOAP协议公开,并符合WSI Basic用户档案1.1。 Web服务互操作性(WSI)是一个开放标准组织,它促进跨平台的Web服务互操作性。 有关信息,请参阅https://www.ws-i.org/。
AEM Forms支持以下Web服务标准:
要使用Web服务调用AEM Forms服务,通常需要创建一个使用服务WSDL的代理库。 使用Web服务调用AEM Forms部分使用JAX-WS创建Java代理类以调用服务。 (请参阅使用JAX-WS创建Java代理类。)
可通过指定以下URL定义来检索服务WDSL(括号中的项是可选项):
https://<your_serverhost>:<your_port>/soap/services/<service_name>?wsdl[&version=<version>][&async=true|false][lc_version=<lc_version>]
其中:
async
指定值以 true
启用其他异步调用操 false
作(默认)。下表列表服务WSDL定义(假定AEM Forms部署在本地主机上,而帖子为8080)。
服务 |
WSDL定义 |
---|---|
汇编程序 |
|
返回和恢复 |
|
条形码 |
|
转换PDF |
|
Distiller |
|
DocConverter |
|
文档管理 |
|
加密 |
|
表单 |
|
表单数据集成 |
|
生成PDF |
|
生成3D PDF |
|
输出 |
|
PDF实用程序 |
|
Acrobat Reader DC扩展 |
|
存储库 |
|
Rights Management |
|
签名 |
|
XMP实用程序 |
|
AEM Forms进程WSDL定义
必须在WSDL定义中指定应用程序名称和进程名称,才能访问属于在Workbench中创建的进程的WSDL。 假定应用程序的名称为MyApplication
,进程的名称为EncryptDocument
。 在这种情况下,请指定以下WSDL定义:
http://localhost:8080/soap/services/MyApplication/EncryptDocument?wsdl
有关示例MyApplication/EncryptDocument
短寿命进程的信息,请参见短寿命进程示例。
应用程序可以包含文件夹。 在这种情况下,请在WSDL定义中指定文件夹名称:
http://localhost:8080/soap/services/MyApplication/[<folderA>/.../<folderZ>/]EncryptDocument?wsdl
使用Web服务访问新功能
新的AEM Forms服务功能可以使用Web服务访问。 例如,在AEM Forms,引入了使用MTOM对附件进行编码的能力。 (请参阅使用MTOM调用AEM Forms。)
要访问AEM Forms引入的新功能,请在WSDL定义中指定lc_version
属性。 例如,要访问新的服务功能(包括MTOM支持),请指定以下WSDL定义:
http://localhost:8080/soap/services/MyApplication/EncryptDocument?wsdl&lc_version=9.0.1
设置lc_version
属性时,请确保使用三位数字。 例如,9.0.1等于9.0版。
Web服务BLOB数据类型
AEM Forms服务WSDL定义了许多数据类型。 Web服务中公开的最重要数据类型之一是BLOB
类型。 此数据类型在使用AEM FormsJava API时映射到com.adobe.idp.Document
类。 (请参阅使用Java API将数据传递到AEM Forms服务。)
BLOB
对象在AEM Forms服务之间和之间发送和检索二进制数据(例如,PDF文件、XML数据等)。 BLOB
类型在服务WSDL中定义如下:
<complexType name="BLOB">
<sequence>
<element maxOccurs="1" minOccurs="0" name="contentType"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="binaryData"
type="xsd:base64Binary"/>
<element maxOccurs="1" minOccurs="0" name="attachmentID"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="remoteURL"
type="xsd:string"/>
<element maxOccurs="1" minOccurs="0" name="MTOM"
type="xsd:base64Binary"
xmime:expectedContentTypes="*/*"
xmlns:xmime="https://www.w3.org/2005/05/xmlmime"/>
<element maxOccurs="1" minOccurs="0" name="swaRef"
type="tns1:swaRef"/>
<element maxOccurs="1" minOccurs="0" name="attributes"
type="impl:MyMapOf_xsd_string_To_xsd_anyType"/>
</sequence>
</complexType>
MTOM
和swaRef
字段仅在AEM Forms受支持。 仅当指定包含lc_version
属性的URL时,才能使用这些新字段。
在服务请求中提供BLOB对象
如果AEM Forms服务操作需要BLOB
类型作为输入值,请在应用程序逻辑中创建BLOB
类型的实例。 (许多位于使用AEM表单进行编程的Web服务快速开始显示如何使用BLOB数据类型。)
按如下方式将值分配给属于BLOB
实例的字段:
BLOB.binaryData
段中设置数据,并在字段中以MIME格式( application/pdf
例如)设置数 BLOB.contentType
据类型。(请参阅使用Base64编码调用AEM Forms。)BLOB.MTOM
数据。此设置使用Java JAX-WS框架或SOAP框架的本机API将数据附加到SOAP请求。 (请参阅使用MTOM调用AEM Forms。)BLOB.swaRef
数据。此设置使用Java JAX-WS框架将数据附加到SOAP请求。 (请参阅使用SwaRef调用AEM Forms。)BLOB.attachmentID
字段中设置附件标识符。 (请参阅使用Base64编码调用AEM Forms。)BLOB.remoteURL
HTTP URL。(请参阅通过HTTP使用BLOB数据调用AEM Forms。)访问从服务返回的BLOB对象中的数据
返回的BLOB
对象的传输协议取决于多个因素,这些因素按以下顺序考虑,在满足主条件时停止:
目标URL指定传输协议。如果在SOAP调用中指定的目标URL包含参数blob="
BLOB_TYPE",则BLOB_TYPE将确定传输协议。 BLOB_ TYPE是base64、dime、mime、http、mtom或swaref的占位符。
服务SOAP端点为智能。如果满足以下条件,则使用与输入文档相同的传输协议返回输出文档:
服务的SOAP端点参数输出Blob对象的默认协议设置为智能。
对于具有SOAP端点的每个服务,管理控制台允许您为任何返回的Blob指定传输协议。 (请参阅管理帮助。)
AEM Forms服务将一个或多个文档作为输入。
服务SOAP端点不是智能。配置的协议确定文档传输协议,并在相应的BLOB
字段中返回数据。 例如,如果SOAP端点设置为DIME,则返回的blob将位于blob.attachmentID
字段中,而不管任何输入文档的传输协议。
否则。如果服务不将文档类型作为输入,则在HTTP协议的BLOB.remoteURL
字段中返回输出文档。
正如第一个条件中所述,您可以通过扩展带有后缀的SOAP端点URL来确保任何返回文档的传输类型,如下所示:
https://<your_serverhost>:<your_port>/soap/services/<service
name>?blob=base64|dime|mime|http|mtom|swaref
下面是传输类型与从中获取数据的字段之间的关联:
blob
缀设 base64
置为返回字段中的 BLOB.binaryData
数据。blob
缀设 DIME
置 MIME
为或将数据返回为相应的附件类型,并在字段中返回附件 BLOB.attachmentID
标识符。使用SOAP框架的专有API从附件读取数据。blob
缀以 http
保留应用程序服务器上的数据,并返回指向字段中数据的 BLOB.remoteURL
URL。blob
置 mtom
为或 swaref
将数据返回为相应的附件类型,并在或字段中返回附 BLOB.MTOM
件标 BLOB.swaRef
识符。使用SOAP框架的本机API从附件读取数据。通过调用setBinaryData
方法填充BLOB
对象时,建议不要超过30 MB。 否则,可能会发生OutOfMemory
异常。
使用MTOM传输协议的基于JAX WS的应用程序仅限于25MB的发送和接收数据。 此限制是由于JAX-WS中的错误造成的。 如果已发送和已接收文件的总大小超过25MB,请使用SwaRef传输协议而不是MTOM协议。 否则,可能出现OutOfMemory
异常。
基64编码字节阵列的MTOM传输
除了BLOB
对象外,MTOM协议还支持任何复杂类型的字节数组参数或字节数组字段。 这意味着支持MTOM的客户端SOAP框架可以将任何xsd:base64Binary
元素作为MTOM附件发送(而不是基64编码的文本)。 AEM FormsSOAP端点可以读取此类字节数组编码。 但是,AEM Forms服务始终返回一个字节数组类型作为基64编码的文本。 输出字节数组参数不支持MTOM。
返回大量二进制数据的AEM Forms服务使用文档/BLOB类型,而不是字节数组类型。 文档类型在传输大量数据时效率更高。
下表列表了Java数据类型并显示相应的Web服务数据类型。
Java数据类型 |
Web服务数据类型 |
---|---|
|
|
|
|
|
如果AEM Forms服务操作使用 |
|
如果AEM Forms服务操作使用 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
如果AEM Forms服务操作接受 设置 |
|
XML类型,在服务WSDL中定义如下:
如果AEM Forms服务操作以 设置 |
Adobe开发人员网站
Adobe开发人员网站包含以下文章,其中讨论使用Web服务API调用AEM Forms服务:
使用自定义组件调用Web服务描述如何创建调用第三方Web服务的AEM Forms组件。
可以使用JAX-WS将Forms服务WSDL转换为Java代理类。 这些类允许您调用AEM Forms服务操作。 Apache Ant允许您通过引用AEM Forms服务WSDL创建生成Java代理类的构建脚本。 通过执行以下步骤,可以生成JAX-WS代理文件:
在客户端计算机上安装Apache Ant。 (请参阅https://ant.apache.org/bindownload.cgi。)
ANT_HOME
环境变量设置为安装Ant的目录。安装JDK 1.6或更高版本。
[JDK_INSTALL_LOCATION]/jre
目录中。JAVA_HOME
环境变量设置为安装JDK的目录。JDK 1.6包含在build.xml文件中使用的wsimport项目。 JDK 1.5不包含该项目。
在客户机上安装JAX-WS。 (请参阅XML Web服务的Java API。)
使用JAX-WS和Apache Ant生成Java代理类。 创建Ant构建脚本以完成此任务。 以下脚本是名为build.xml的示例Ant构建脚本:
<?xml version="1.0" encoding="UTF-8"?>
<project basedir="." default="compile">
<property name="port" value="8080" />
<property name="host" value="localhost" />
<property name="username" value="administrator" />
<property name="password" value="password" />
<property name="tests" value="all" />
<target name="clean" >
<delete dir="classes" />
</target>
<target name="wsdl" depends="clean">
<mkdir dir="classes"/>
<exec executable="wsimport" failifexecutionfails="false" failonerror="true" resultproperty="foundWSIMPORT">
<arg line="-keep -d classes https://${host}:${port}/soap/services/EncryptionService?wsdl&lc_version=9.0.1"/>
</exec>
<fail unless="foundWSIMPORT">
!!! Failed to execute JDK's wsimport tool. Make sure that JDK 1.6 (or later) is on your PATH !!!
</fail>
</target>
<target name="compile" depends="clean, wsdl" >
<javac destdir="./classes" fork="true" debug="true">
<src path="./src"/>
</javac>
</target>
<target name="run">
<java classname="Client" fork="yes" failonerror="true" maxmemory="200M">
<classpath>
<pathelement location="./classes"/>
</classpath>
<arg value="${port}"/>
<arg value="${host}"/>
<arg value="${username}"/>
<arg value="${password}"/>
<arg value="${tests}"/>
</java>
</target>
</project>
在此Ant构建脚本中,请注意,url
属性已设置为引用在localhost上运行的加密服务WSDL。 username
和password
属性必须设置为有效的AEM表单用户名和密码。 请注意,URL包含lc_version
属性。 如果不指定lc_version
选项,则无法调用新的AEM Forms服务操作。
将EncryptionService
替换为要使用Java代理类调用的AEM Forms服务名称。 例如,要为Rights Management服务创建Java代理类,请指定:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
创建一个BAT文件以执行Ant构建脚本。 以下命令可以位于负责执行Ant构建脚本的BAT文件中:
ant -buildfile "build.xml" wsdl
将ANT构建脚本放在C:\Program Files\Java\jaxws-ri\bin directory目录中。 脚本将JAVA文件写入。/classes文件夹。 脚本生成可调用服务的JAVA文件。
将JAVA文件打包到JAR文件中。 如果您正在使用Eclipse,请按照以下步骤操作:
com.adobe.idp.services
包。com.adobe.idp.services
包,然后将adobe/idp/services文件夹中的JAVA文件导入包中。org/apache/xml/xmlsoap
包。位于使用AEM表单进行编程的所有Java Web服务快速开始(Forms服务除外)均使用JAX-WS创建Java代理文件。 此外,所有Java Web服务快速开始均使用SwaRef。 (请参阅使用SwaRef调用AEM Forms。)
另请参阅
您可以使用Apache Axis WSDL2Java工具将Forms服务转换为Java代理类。 这些类允许您调用Forms服务操作。 使用Apache Ant,可以通过服务WSDL生成Axis库文件。 您可以通过URL https://ws.apache.org/axis/下载Apache Axis。
与Forms服务关联的Web服务快速开始使用使用Apache Axis创建的Java代理类。 FormsWeb服务快速开始也使用Base64作为编码类型。 (请参阅Forms服务API快速开始。)
通过执行以下步骤,可以生成Axis Java库文件:
在客户端计算机上安装Apache Ant。 它位于https://ant.apache.org/bindownload.cgi。
ANT_HOME
环境变量设置为安装Ant的目录。在客户端计算机上安装Apache Axis 1.4。 它位于https://ws.apache.org/axis/。
如https://ws.apache.org/axis/java/install.html的Axis安装说明中所述,设置类路径以在Web服务客户端中使用Axis JAR文件。
使用Axis中的Apache WSDL2Java工具生成Java代理类。 创建Ant构建脚本以完成此任务。 以下脚本是名为build.xml的示例Ant构建脚本:
<?xml version="1.0"?>
<project name="axis-wsdl2java">
<path id="axis.classpath">
<fileset dir="C:\axis-1_4\lib" >
<include name="**/*.jar" />
</fileset>
</path>
<taskdef resource="axis-tasks.properties" classpathref="axis.classpath" />
<target name="encryption-wsdl2java-client" description="task">
<axis-wsdl2java
output="C:\JavaFiles"
testcase="false"
serverside="false"
verbose="true"
username="administrator"
password="password"
url="http://localhost:8080/soap/services/EncryptionService?wsdl&lc_version=9.0.1" >
</axis-wsdl2java>
</target>
</project>
在此Ant构建脚本中,请注意,url
属性已设置为引用在localhost上运行的加密服务WSDL。 username
和password
属性必须设置为有效的AEM表单用户名和密码。
创建一个BAT文件以执行Ant构建脚本。 以下命令可以位于负责执行Ant构建脚本的BAT文件中:
ant -buildfile "build.xml" encryption-wsdl2java-client
JAVA文件将写入C:\JavaFiles folder as specified by the output
属性。 要成功调用Forms服务,请将这些JAVA文件导入类路径。
默认情况下,这些文件属于名为com.adobe.idp.services
的Java包。 建议将这些JAVA文件放入JAR文件中。 然后,将JAR文件导入客户端应用程序的类路径。
将。JAVA文件放入JAR的方法不同。 一种方式是使用Java IDE(如Eclipse)。 创建一个Java项目并创建一个com.adobe.idp.services
包(所有。JAVA文件都属于此包)。 然后,将所有。JAVA文件导入包中。 最后,将项目导出为JAR文件。
修改EncryptionServiceLocator
类中的URL以指定编码类型。 例如,要使用base64,请指定?blob=base64
以确保BLOB
对象返回二进制数据。 即,在EncryptionServiceLocator
类中,找到以下代码行:
http://localhost:8080/soap/services/EncryptionService;
并将其更改为:
http://localhost:8080/soap/services/EncryptionService?blob=base64;
将以下Axis JAR文件添加到Java项目的类路径中:
这些JAR文件位于[install directory]/Adobe/Adobe Experience Manager Forms/sdk/lib/thirdparty
目录中。
另请参阅
可以使用Base64编码调用AEM Forms服务。 Base64编码对随Web服务调用请求发送的附件进行编码。 即,BLOB
数据是Base64编码的,而不是整个SOAP消息。
“使用Base64编码调用AEM Forms”讨论使用Base64编码调用名为MyApplication/EncryptDocument
的以下AEM Forms短时进程。
这一进程不是基于AEM Forms现有进程。 要跟随代码示例,请使用Workbench创建一个名为MyApplication/EncryptDocument
的进程。 (请参阅使用Workbench。)
调用此进程时,它将执行以下操作:
SetValue
操作。 此进程的输入参数是名为inDoc
的document
进程变量。PasswordEncryptPDF
操作。 在名为outDoc
的进程变量中返回密码加密的PDF文档。您可以创建。NET客户端程序集,从Microsoft Visual Studio .NET项目调用Forms服务。 要创建使用base64编码的。NET客户端程序集,请执行以下步骤:
创建代理类
可以使用Microsoft Visual Studio附带的工具创建用于创建。NET客户端程序集的代理类。 该工具的名称为wsdl.exe,它位于Microsoft Visual Studio安装文件夹中。 要创建代理类,请打开命令提示符并导航到包含wsdl.exe文件的文件夹。 有关wsdl.exe工具的详细信息,请参阅MSDN帮助。
在命令提示符下输入以下命令:
wsdl https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1
默认情况下,此工具会在基于WSDL名称的同一文件夹中创建CS文件。 在这种情况下,它将创建一个名为EncryptDocumentService.cs的CS文件。 使用此CS文件创建代理对象,用于调用在调用URL中指定的服务。
将代理类中的URL修改为包含?blob=base64
,以确保BLOB
对象返回二进制数据。 在代理类中,找到以下代码行:
"https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument";
并将其更改为:
"https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=base64";
使用Base64 Encoding调用AEM Forms部分以MyApplication/EncryptDocument
为例。 如果要为另一个Forms服务创建。NET客户端程序集,请确保将MyApplication/EncryptDocument
替换为该服务的名称。
开发。NET客户端程序集
创建生成。NET客户端程序集的Visual Studio类库项目。 可以使用wsdl.exe创建的CS文件可以导入到此项目中。 此项目生成一个DLL文件(.NET客户端程序集),您可以在其他Visual Studio .NET项目中使用它调用服务。
此过程创建一个名为DocumentService.dll的。NET客户端程序集,您可以使用它向MyApplication/EncryptDocument
服务发送SOAP请求。
确保已将?blob=base64
添加到用于创建。NET客户端程序集的代理类中的URL。 否则,无法从BLOB
对象检索二进制数据。
引用。NET客户端程序集
将新创建的。NET客户端程序集放在正在开发客户端应用程序的计算机上。 将。NET客户端程序集放置到目录后,可从项目中引用它。 还可从项目中引用System.Web.Services
库。 如果不引用此库,则无法使用。NET客户端程序集调用服务。
使用使用Base64编码的。NET客户端程序集调用服务
您可以使用使用Base64编码的。NET客户端程序集调用MyApplication/EncryptDocument
服务(在Workbench中构建)。 要调用MyApplication/EncryptDocument
服务,请执行以下步骤:
MyApplication/EncryptDocument
服务WSDL的Microsoft .NET客户端程序集。System.Web.Services
。MyApplication_EncryptDocumentService
对象。System.Net.NetworkCredential
对象设置MyApplication_EncryptDocumentService
对象的Credentials
属性。 在System.Net.NetworkCredential
构造函数中,指定AEM表单用户名和相应的口令。 设置身份验证值,使您的。NET客户端应用程序能够与AEM Forms成功交换SOAP消息。BLOB
对象的构造函数创建<a0/>对象。 BLOB
对象用于存储到MyApplication/EncryptDocument
进程的PDF文档传递。System.IO.FileStream
对象。 传递一个字符串值,它表示PDF文档的文件位置以及打开文件的模式。System.IO.FileStream
对象内容的字节数组。 通过获取System.IO.FileStream
对象的Length
属性,可以确定字节数组的大小。System.IO.FileStream
对象的Read
方法,用流数据填充字节数组。 传递要读取的字节数组、开始位置和流长度。binaryData
对象的<a1/>属性指定字节数组的内容,填充BLOB
对象。MyApplication_EncryptDocumentService
对象的invoke
方法并传递包含PDF文档的BLOB
对象来调用MyApplication/EncryptDocument
进程。 此过程在BLOB
对象中返回加密的PDF文档。System.IO.FileStream
对象的构造函数并传递一个字符串值来创建一个<a0/>对象,该字符串值表示密码加密文档的文件位置。MyApplicationEncryptDocumentService
对象的invoke
方法返回的BLOB
对象的数据内容。 通过获取BLOB
对象的binaryData
数据成员的值,填充字节数组。System.IO.BinaryWriter
对象的构造函数并传递System.IO.FileStream
对象,创建<a0/>对象。System.IO.BinaryWriter
对象的Write
方法并传递字节数组,将字节数组内容写入PDF文件。可以使用Java代理类和Base64调用AEM Forms服务。 要使用Java代理类调用MyApplication/EncryptDocument
服务,请执行以下步骤:
使用使用MyApplication/EncryptDocument
服务WSDL的JAX-WS创建Java代理类。 使用以下WSDL端点:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1
将hiro-xp
替换为承载AEM Forms的J2EE应用程序服务器的IP地址。
将使用JAX-WS创建的Java代理类打包到JAR文件中。
在以下路径中包含Java代理JAR文件和JAR文件:
<install Directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty
到Java客户端项目的类路径中。
使用MyApplicationEncryptDocumentService
对象的构造函数创建<a0/>对象。
通过调用MyApplicationEncryptDocumentService
对象的getEncryptDocument
方法创建MyApplicationEncryptDocument
对象。
通过为以下数据成员分配值来设置调用AEM Forms所需的连接值:
为javax.xml.ws.BindingProvider
对象的ENDPOINT_ADDRESS_PROPERTY
字段指定WSDL端点和编码类型。 要使用Base64编码调用MyApplication/EncryptDocument
服务,请指定以下URL值:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=base64
将AEM forms用户分配给javax.xml.ws.BindingProvider
对象的USERNAME_PROPERTY
字段。
为javax.xml.ws.BindingProvider
对象的PASSWORD_PROPERTY
字段指定相应的口令值。
以下代码示例显示此应用程序逻辑:
//Set connection values required to invoke AEM Forms
String url = "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=base64";
String username = "administrator";
String password = "password";
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);
通过使用java.io.FileInputStream
对象的构造函数创建<a1/>对象,检索要发送到MyApplication/EncryptDocument
进程的PDF文档。 传递一个指定PDF文档位置的字符串值。
创建一个字节数组,并用java.io.FileInputStream
对象的内容填充它。
使用BLOB
对象的构造函数创建<a0/>对象。
通过调用setBinaryData
方法并传递字节数组来填充BLOB
对象。 BLOB
对象的setBinaryData
是使用Base64编码时要调用的方法。 请参阅在服务请求中提供BLOB对象。
通过调用MyApplicationEncryptDocument
对象的invoke
方法调用MyApplication/EncryptDocument
进程。 传递包含PDF文档的BLOB
对象。 invoke方法返回一个BLOB
对象,它包含已加密的PDF文档。
通过调用BLOB
对象的getBinaryData
方法,创建包含已加密PDF文档的字节数组。
将加密的PDF文档另存为PDF文件。 将字节数组写入文件。
另请参阅
您可以通过使用Web服务标准MTOM调用AEM Forms服务。 此标准定义二进制数据(如PDF文档)如何通过Internet或Intranet传输。 MTOM的一个功能是使用XOP:Include
元素。 此元素在XML二进制优化打包(XOP)规范中定义,以引用SOAP消息的二进制附件。
此处讨论的是使用MTOM调用以下名为MyApplication/EncryptDocument
的AEM Forms短期进程。
这一进程不是基于AEM Forms现有进程。 要跟随代码示例,请使用Workbench创建一个名为MyApplication/EncryptDocument
的进程。 (请参阅使用Workbench。)
调用此进程时,它将执行以下操作:
SetValue
操作。 此进程的输入参数是名为inDoc
的document
进程变量。PasswordEncryptPDF
操作。 在名为outDoc
的进程变量中返回密码加密的PDF文档。MTOM支持在AEM Forms第9版中添加。
使用MTOM传输协议的基于JAX WS的应用程序仅限于25MB的发送和接收数据。 此限制是由于JAX-WS中的错误造成的。 如果已发送和已接收文件的总大小超过25MB,请使用SwaRef传输协议而不是MTOM协议。 否则,可能出现OutOfMemory
异常。
此处讨论的是在Microsoft .NET项目中使用MTOM调用AEM Forms服务。 使用的。NET框架为3.5,开发环境为Visual Studio 2008。 如果您的开发计算机上已安装Web服务增强(WSE),请将其删除。 .NET 3.5框架支持名为Windows Communication Foundation(WCF)的SOAP框架。 使用MTOM调用AEM Forms时,仅支持WCF(而不是WSE)。
您可以创建一个Microsoft .NET项目,它可以使用Web服务调用AEM Forms服务。 首先,使用Visual Studio 2008创建Microsoft .NET项目。 要调用AEM Forms服务,请创建要在您的项目中调用的AEM Forms服务的服务引用。 创建服务引用时,请指定AEM Forms服务的URL:
http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1
将localhost
替换为承载AEM Forms的J2EE应用程序服务器的IP地址。 将MyApplication/EncryptDocument
替换为要调用的AEM Forms服务的名称。 例如,要调用Rights Management操作,请指定:
http://localhost:8080/soap/services/RightsManagementService?WSDL&lc_version=9.0.1
lc_version
选项确保AEM Forms功能(如MTOM)可用。 如果不指定lc_version
选项,则无法使用MTOM调用AEM Forms。
创建服务引用后,与AEM Forms服务关联的数据类型可在您的。NET项目中使用。 要创建调用AEM Forms服务的。NET项目,请执行以下步骤:
使用Microsoft Visual Studio 2008创建。NET项目。
在项目菜单中,选择添加服务引用。
在地址对话框中,指定AEM Forms服务的WSDL。 例如,
http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1
单击转至,然后单击确定。
请考虑MyApplication/EncryptDocument
流程,它接受一个不安全的PDF文档并返回一个密码加密的PDF文档。 要使用MTOM调用MyApplication/EncryptDocument
进程(在Workbench中构建),请执行以下步骤:
创建Microsoft .NET项目。
使用其默认构造函数创建MyApplication_EncryptDocumentClient
对象。
使用System.ServiceModel.EndpointAddress
构造函数创建MyApplication_EncryptDocumentClient.Endpoint.Address
对象。 将指定WSDL的字符串值传递给AEM Forms服务和编码类型:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=mtom
您无需使用lc_version
属性。 此属性在您创建服务引用时使用。 但是,请确保指定?blob=mtom
。
将hiro-xp
替换为承载AEM Forms的J2EE应用程序服务器的IP地址。
通过获取EncryptDocumentClient.Endpoint.Binding
数据成员的值创建System.ServiceModel.BasicHttpBinding
对象。 将返回值转换为BasicHttpBinding
。
将System.ServiceModel.BasicHttpBinding
对象的MessageEncoding
数据成员设置为WSMessageEncoding.Mtom
。 此值确保使用MTOM。
通过执行以下任务启用基本HTTP身份验证:
MyApplication_EncryptDocumentClient.ClientCredentials.UserName.UserName
分配AEM表单用户名。MyApplication_EncryptDocumentClient.ClientCredentials.UserName.Password
分配相应的口令值。HttpClientCredentialType.Basic
指定给数据成员BasicHttpBindingSecurity.Transport.ClientCredentialType
。BasicHttpSecurityMode.TransportCredentialOnly
指定给数据成员BasicHttpBindingSecurity.Security.Mode
。以下代码示例显示了这些任务。
//Enable BASIC HTTP authentication
encryptProcess.ClientCredentials.UserName.UserName = "administrator";
encryptProcess.ClientCredentials.UserName.Password = "password";
b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
b.MaxReceivedMessageSize = 4000000;
b.MaxBufferSize = 4000000;
b.ReaderQuotas.MaxArrayLength = 4000000;
使用BLOB
对象的构造函数创建<a0/>对象。 BLOB
对象用于存储PDF文档,以传递到MyApplication/EncryptDocument
进程。
通过调用其构造函数创建System.IO.FileStream
对象。 传递一个字符串值,它表示PDF文档的文件位置以及打开文件的模式。
创建存储System.IO.FileStream
对象内容的字节数组。 通过获取System.IO.FileStream
对象的Length
属性,可以确定字节数组的大小。
通过调用System.IO.FileStream
对象的Read
方法,用流数据填充字节数组。 传递要读取的字节数组、开始位置和流长度。
通过为MTOM
数据成员分配字节数组的内容,填充BLOB
对象。
通过调用MyApplication_EncryptDocumentClient
对象的invoke
方法调用MyApplication/EncryptDocument
进程。 传递包含PDF文档的BLOB
对象。 此过程在BLOB
对象中返回加密的PDF文档。
通过调用System.IO.FileStream
对象的构造函数并传递一个字符串值,该字符串值表示受保护PDF文档的文件位置。
创建一个字节数组,用于存储invoke
方法返回的BLOB
对象的数据内容。 通过获取BLOB
对象的MTOM
数据成员的值,填充字节数组。
通过调用System.IO.BinaryWriter
对象的构造函数并传递System.IO.FileStream
对象,创建<a0/>对象。
通过调用System.IO.BinaryWriter
对象的Write
方法并传递字节数组,将字节数组的内容写入PDF文件。
大多数AEM Forms服务业务都具有MTOM快速开始。 您可以在服务的相应快速视图部分开始这些快速开始。 例如,要查看“输出快速开始”部分,请参阅输出服务API快速开始。
另请参阅
创建一个ASP.NET Web应用程序,它调用以人为中心的长寿命流程
您可以使用SwaRef调用AEM Forms服务。 wsi:swaRef
XML元素的内容作为附件发送到存储对附件引用的SOAP主体中。 使用SwaRef调用Forms服务时,请使用Java API for XML Web Services(JAX-WS)创建Java代理类。 (请参阅XML Web服务的Java API。)
此处讨论的是使用SwaRef调用名为MyApplication/EncryptDocument
的以下Forms短期进程。
这一进程不是基于AEM Forms现有进程。 要跟随代码示例,请使用Workbench创建一个名为MyApplication/EncryptDocument
的进程。 (请参阅使用Workbench。)
调用此进程时,它将执行以下操作:
SetValue
操作。 此进程的输入参数是名为inDoc
的document
进程变量。PasswordEncryptPDF
操作。 在名为outDoc
的进程变量中返回密码加密的PDF文档。AEM Forms增加了SwaRef支持
以下讨论如何在Java客户端应用程序中使用SwaRef调用Forms服务。 Java应用程序使用使用JAX-WS创建的代理类。
要使用使用JAX-WS和SwaRef创建的Java代理文件调用MyApplication/EncryptDocument
进程,请执行以下步骤:
使用使用MyApplication/EncryptDocument
服务WSDL的JAX-WS创建Java代理类。 使用以下WSDL端点:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1
有关信息,请参阅使用JAX-WS创建Java代理类。
将hiro-xp
替换为承载AEM Forms的J2EE应用程序服务器的IP地址。
将使用JAX-WS创建的Java代理类打包到JAR文件中。
在以下路径中包含Java代理JAR文件和JAR文件:
<install Directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty
到Java客户端项目的类路径中。
使用MyApplicationEncryptDocumentService
对象的构造函数创建<a0/>对象。
通过调用MyApplicationEncryptDocumentService
对象的getEncryptDocument
方法创建MyApplicationEncryptDocument
对象。
通过为以下数据成员分配值来设置调用AEM Forms所需的连接值:
为javax.xml.ws.BindingProvider
对象的ENDPOINT_ADDRESS_PROPERTY
字段指定WSDL端点和编码类型。 要使用SwaRef编码调用MyApplication/EncryptDocument
服务,请指定以下URL值:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=swaref
将AEM forms用户分配给javax.xml.ws.BindingProvider
对象的USERNAME_PROPERTY
字段。
为javax.xml.ws.BindingProvider
对象的PASSWORD_PROPERTY
字段指定相应的口令值。
以下代码示例显示此应用程序逻辑:
//Set connection values required to invoke AEM Forms
String url = "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=swaref";
String username = "administrator";
String password = "password";
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);
通过使用java.io.File
对象的构造函数创建<a1/>对象,检索要发送到MyApplication/EncryptDocument
进程的PDF文档。 传递一个指定PDF文档位置的字符串值。
使用FileDataSource
构造函数创建javax.activation.DataSource
对象。 传递java.io.File
对象。
使用javax.activation.DataHandler
对象的构造函数并传递javax.activation.DataSource
对象,创建<a0/>对象。
使用BLOB
对象的构造函数创建<a0/>对象。
通过调用setSwaRef
方法并传递javax.activation.DataHandler
对象,填充BLOB
对象。
通过调用MyApplicationEncryptDocument
对象的invoke
方法并传递包含PDF文档的BLOB
对象来调用MyApplication/EncryptDocument
进程。 invoke方法返回一个BLOB
对象,该对象包含加密的PDF文档。
通过调用BLOB
对象的getSwaRef
方法填充javax.activation.DataHandler
对象。
通过调用javax.activation.DataHandler
对象的getInputStream
方法,将javax.activation.DataHandler
对象转换为java.io.InputSteam
实例。
将java.io.InputSteam
实例写入表示已加密PDF文档的PDF文件。
大多数AEM Forms服务操作都有SwaRef快速开始。 您可以在服务的相应快速视图部分开始这些快速开始。 例如,要查看“输出快速开始”部分,请参阅输出服务API快速开始。
另请参阅
您可以使用Web服务调用AEM Forms服务并通过HTTP传递BLOB数据。 通过HTTP传递BLOB数据是一种替代技术,而不是使用base64编码、DIME或MIME。 例如,可以在使用Web服务增强3.0的Microsoft .NET项目中通过HTTP传递数据,该增强不支持DIME或MIME。 通过HTTP使用BLOB数据时,在调用AEM Forms服务之前上传输入数据。
“通过HTTP使用BLOB数据调用AEM Forms”讨论通过通过HTTP传递BLOB数据来调用名为MyApplication/EncryptDocument
的以下AEM Forms短时进程。
这一进程不是基于AEM Forms现有进程。 要跟随代码示例,请使用Workbench创建一个名为MyApplication/EncryptDocument
的进程。 (请参阅使用Workbench。)
调用此进程时,它将执行以下操作:
SetValue
操作。 此进程的输入参数是名为inDoc
的document
进程变量。PasswordEncryptPDF
操作。 在名为outDoc
的进程变量中返回密码加密的PDF文档。建议您熟悉使用SOAP调用AEM Forms。 (请参阅使用Web服务调用AEM Forms。)
要创建通过HTTP使用数据的客户端程序集,请按照使用Base64编码调用AEM Forms中指定的过程操作。 但是,请修改代理类中的URL,使其包含?blob=http
而不是?blob=base64
。 此操作确保数据通过HTTP传递。 在代理类中,找到以下代码行:
"http://localhost:8080/soap/services/MyApplication/EncryptDocument";
并将其更改为:
"http://localhost:8080/soap/services/MyApplication/EncryptDocument?blob=http";
引用。NET clienMyApplication/EncryptDocument程序集
将新的。NET客户端程序集放在要开发客户端应用程序的计算机上。 将。NET客户端程序集放置到目录后,可从项目中引用它。 从您的项目中引用System.Web.Services
库。 如果不引用此库,则无法使用。NET客户端程序集调用服务。
使用通过HTTP使用BLOB数据的。NET客户端程序集调用服务
您可以使用通过HTTP使用数据的。NET客户端程序集调用MyApplication/EncryptDocument
服务(在Workbench中构建)。 要调用MyApplication/EncryptDocument
服务,请执行以下步骤:
System.Web.Services
。MyApplication_EncryptDocumentService
对象。System.Net.NetworkCredential
对象设置MyApplication_EncryptDocumentService
对象的Credentials
属性。 在System.Net.NetworkCredential
构造函数中,指定AEM表单用户名和相应的口令。 设置身份验证值,使您的。NET客户端应用程序能够与AEM Forms成功交换SOAP消息。BLOB
对象的构造函数创建<a0/>对象。 BLOB
对象用于将数据传递给MyApplication/EncryptDocument
进程。BLOB
对象的remoteURL
数据成员分配一个字符串值,它指定要传递到MyApplication/EncryptDocument
服务的PDF文档的URI位置。MyApplication_EncryptDocumentService
对象的invoke
方法并传递BLOB
对象来调用MyApplication/EncryptDocument
进程。 此过程在BLOB
对象中返回加密的PDF文档。System.UriBuilder
对象的构造函数并传递返回的BLOB
对象的remoteURL
数据成员的值,创建<a0/>对象。System.UriBuilder
对象转换为System.IO.Stream
对象。 (此列表后面的C#快速开始说明了如何执行此任务。)System.IO.Stream
对象中的数据填充它。System.IO.BinaryWriter
对象的构造函数并传递System.IO.FileStream
对象,创建<a0/>对象。System.IO.BinaryWriter
对象的Write
方法并传递字节数组,将字节数组内容写入PDF文件。您可以使用Java代理类和BLOB数据通过HTTP调用AEM Forms服务。 要使用Java代理类调用MyApplication/EncryptDocument
服务,请执行以下步骤:
使用使用MyApplication/EncryptDocument
服务WSDL的JAX-WS创建Java代理类。 使用以下WSDL端点:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?WSDL&lc_version=9.0.1
有关信息,请参阅使用JAX-WS创建Java代理类。
将hiro-xp
替换为承载AEM Forms的J2EE应用程序服务器的IP地址。
将使用JAX-WS创建的Java代理类打包到JAR文件中。
在以下路径中包含Java代理JAR文件和JAR文件:
<install Directory="">\Adobe\Adobe_Experience_Manager_forms\sdk\client-libs\thirdparty
到Java客户端项目的类路径中。
使用MyApplicationEncryptDocumentService
对象的构造函数创建<a0/>对象。
通过调用MyApplicationEncryptDocumentService
对象的getEncryptDocument
方法创建MyApplicationEncryptDocument
对象。
通过为以下数据成员分配值来设置调用AEM Forms所需的连接值:
为javax.xml.ws.BindingProvider
对象的ENDPOINT_ADDRESS_PROPERTY
字段指定WSDL端点和编码类型。 要使用BLOB over HTTP编码调用MyApplication/EncryptDocument
服务,请指定以下URL值:
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=http
将AEM forms用户分配给javax.xml.ws.BindingProvider
对象的USERNAME_PROPERTY
字段。
为javax.xml.ws.BindingProvider
对象的PASSWORD_PROPERTY
字段指定相应的口令值。
以下代码示例显示此应用程序逻辑:
//Set connection values required to invoke AEM Forms
String url = "https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=http";
String username = "administrator";
String password = "password";
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY, url);
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
((BindingProvider) encryptDocClient).getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);
使用BLOB
对象的构造函数创建<a0/>对象。
通过调用setRemoteURL
方法填充BLOB
对象。 传递一个字符串值,它指定要传递到MyApplication/EncryptDocument
服务的PDF文档的URI位置。
通过调用MyApplicationEncryptDocument
对象的invoke
方法并传递包含PDF文档的BLOB
对象来调用MyApplication/EncryptDocument
进程。 此过程在BLOB
对象中返回加密的PDF文档。
创建一个字节数组以存储表示加密的PDF文档的数据流。 调用BLOB
对象的getRemoteURL
方法(使用invoke
方法返回的BLOB
对象)。
使用java.io.File
对象的构造函数创建<a0/>对象。 此对象表示加密的PDF文档。
使用java.io.FileOutputStream
对象的构造函数并传递java.io.File
对象,创建<a0/>对象。
调用java.io.FileOutputStream
对象的write
方法。 传递包含表示加密PDF文档的数据流的字节数组。
您可以使用带附件的SOAP调用AEM Forms服务。 AEM Forms支持MIME和DIME Web服务标准。 DIME允许您发送二进制附件(如PDF文档)以及调用请求,而不是对附件进行编码。 使用DIME调用AEM Forms部分讨论使用DIME调用名为MyApplication/EncryptDocument
的以下AEM Forms短期进程。
调用此进程时,它将执行以下操作:
SetValue
操作。 此进程的输入参数是名为inDoc
的document
进程变量。PasswordEncryptPDF
操作。 在名为outDoc
的进程变量中返回密码加密的PDF文档。这一进程不是基于AEM Forms现有进程。 要与代码示例一起使用,请使用Workbench创建一个名为MyApplication/EncryptDocument
的进程。 (请参阅使用Workbench。)
已弃用使用DIME调用AEM Forms服务操作。 建议您使用MTOM。 (请参阅使用MTOM调用AEM Forms。)
要创建可使用DIME调用Forms服务的。NET项目,请执行以下任务:
安装Web服务增强2.0
在开发计算机上安装Web Services Enhancements 2.0,并将其与Microsoft Visual Studio .NET集成。 您可以从Microsoft下载中心下载Web服务增强2.0。
从此网页中,搜索Web服务增强2.0并将其下载到开发计算机上。 此下载将名为Microsoft WSE 2.0 SPI.msi的文件放在您的计算机上。 运行安装项目并遵循联机指示。
Web服务增强2.0支持DIME。 使用Web服务增强2.0时,支持的Microsoft Visual Studio版本为2003。Web服务增强3.0不支持DIME;但是,它支持MTOM。
创建对AEM Forms服务的Web引用
在开发计算机上安装Web服务增强2.0并创建Microsoft .NET项目后,请创建对Forms服务的Web引用。 例如,要创建对MyApplication/EncryptDocument
进程的Web引用并假定本地计算机上已安装Forms,请指定以下URL:
http://localhost:8080/soap/services/MyApplication/EncryptDocument?WSDL
创建Web引用后,可在。NET项目中使用以下两种代理数据类型:EncryptDocumentService
和EncryptDocumentServiceWse
。 要使用DIME调用MyApplication/EncryptDocument
进程,请使用EncryptDocumentServiceWse
类型。
在创建对Forms服务的Web引用之前,请确保在项目中引用Web服务增强2.0。 (请参阅“安装Web服务增强2.0”。)
引用WSE库
创建对Forms服务的Web引用
确保启用。NET项目以使用WSE库。 在项目资源管理器中,右键单击项目名称并选择“启用WSE 2.0”。确保选中出现的对话框上的复选框。
在。NET项目中使用DIME调用服务
您可以使用DIME调用Forms服务。 请考虑MyApplication/EncryptDocument
流程,它接受一个不安全的PDF文档并返回一个密码加密的PDF文档。 要使用DIME调用MyApplication/EncryptDocument
进程,请执行以下步骤:
创建一个Microsoft .NET项目,它允许您使用DIME调用Forms服务。 确保包含Web服务增强2.0并创建对AEM Forms服务的Web引用。
在设置对MyApplication/EncryptDocument
进程的Web引用后,使用其默认构造函数创建一个EncryptDocumentServiceWse
对象。
将EncryptDocumentServiceWse
对象的Credentials
数据成员设置为System.Net.NetworkCredential
值,该值指定AEM表单用户名和口令值。
使用Microsoft.Web.Services2.Dime.DimeAttachment
对象的构造函数并传递以下值,创建<a0/>对象:
System.Guid.NewGuid.ToString
方法获取GUID值。application/pdf
。TypeFormat
明细列表值。 指定TypeFormat.MediaType
。使用BLOB
对象的构造函数创建<a0/>对象。
通过将Microsoft.Web.Services2.Dime.DimeAttachment
对象的Id
数据成员值分配给BLOB
对象的attachmentID
数据成员,将DIME附件添加到BLOB
对象。
调用EncryptDocumentServiceWse.RequestSoapContext.Attachments.Add
方法并传递Microsoft.Web.Services2.Dime.DimeAttachment
对象。
通过调用EncryptDocumentServiceWse
对象的invoke
方法并传递包含DIME附件的BLOB
对象来调用MyApplication/EncryptDocument
进程。 此过程在BLOB
对象中返回加密的PDF文档。
通过获取返回的BLOB
对象的attachmentID
数据成员的值,获取附件标识符值。
对位于EncryptDocumentServiceWse.ResponseSoapContext.Attachments
的附件进行迭代,并使用附件标识符值获取加密的PDF文档。
通过获取Attachment
对象的Stream
数据成员的值,获取System.IO.Stream
对象。
创建一个字节数组并将该字节数组传递给System.IO.Stream
对象的Read
方法。 此方法使用表示加密的PDF文档的数据流填充字节数组。
通过调用System.IO.FileStream
对象的构造函数并传递一个表示PDF文件位置的字符串值,创建一个<a0/>对象。 此对象表示加密的PDF文档。
通过调用System.IO.BinaryWriter
对象的构造函数并传递System.IO.FileStream
对象,创建<a0/>对象。
通过调用System.IO.BinaryWriter
对象的Write
方法并传递字节数组,将字节数组的内容写入PDF文件。
您可以使用Apache Axis WSDL2Java工具将服务WSDL转换为Java代理类,以便调用服务操作。 使用Apache Ant,您可以通过AEM Forms服务WSDL生成Axis库文件,它允许您调用服务。 (请参阅使用Apache Axis创建Java代理类。)
Apache Axis WSDL2Java工具生成JAVA文件,其中包含用于向服务发送SOAP请求的方法。 由服务接收的SOAP请求由Axis生成的库进行解码,并返回为方法和参数。
要使用Axis生成的库文件和DIME调用MyApplication/EncryptDocument
服务(在Workbench中构建),请执行以下步骤:
使用Apache Axis创建使用MyApplication/EncryptDocument
服务WSDL的Java代理类。 (请参阅使用Apache Axis创建Java代理类。)
将Java代理类包含到类路径中。
使用MyApplicationEncryptDocumentServiceLocator
对象的构造函数创建<a0/>对象。
使用URL
对象的构造函数并传递指定AEM Forms服务WSDL定义的字符串值,创建<a0/>对象。 确保在SOAP端点URL的末尾指定?blob=dime
。 例如,使用
https://hiro-xp:8080/soap/services/MyApplication/EncryptDocument?blob=dime.
通过调用EncryptDocumentSoapBindingStub
对象的构造函数并传递MyApplicationEncryptDocumentServiceLocator
对象和URL
对象,创建<a0/>对象。
通过调用EncryptDocumentSoapBindingStub
对象的setUsername
和setPassword
方法设置AEM表单用户名和密码值。
encryptionClientStub.setUsername("administrator");
encryptionClientStub.setPassword("password");
通过创建java.io.File
对象检索要发送到MyApplication/EncryptDocument
服务的PDF文档。 传递指定PDF文档位置的字符串值。
使用javax.activation.DataHandler
对象的构造函数创建javax.activation.FileDataSource
对象。 可以使用javax.activation.FileDataSource
对象的构造函数并传递表示PDF文档的java.io.File
对象来创建<a0/>对象。
使用org.apache.axis.attachments.AttachmentPart
对象的构造函数创建javax.activation.DataHandler
对象。
通过调用EncryptDocumentSoapBindingStub
对象的addAttachment
方法并传递org.apache.axis.attachments.AttachmentPart
对象来连接附件。
使用BLOB
对象的构造函数创建<a0/>对象。 通过调用BLOB
对象的setAttachmentID
方法并传递附件标识符值,用附件标识符值填充BLOB
对象。 可通过调用org.apache.axis.attachments.AttachmentPart
对象的getContentId
方法来获取此值。
通过调用EncryptDocumentSoapBindingStub
对象的invoke
方法调用MyApplication/EncryptDocument
进程。 传递包含DIME附件的BLOB
对象。 此过程在BLOB
对象中返回加密的PDF文档。
通过调用返回的BLOB
对象的getAttachmentID
方法获取附件标识符值。 此方法返回一个字符串值,它表示返回的附件的标识符值。
通过调用EncryptDocumentSoapBindingStub
对象的getAttachments
方法检索附件。 此方法返回一个Objects
的数组,它表示附件。
对附件(Object
数组)进行迭代,然后使用附件标识符值获取加密的PDF文档。 每个元素都是org.apache.axis.attachments.AttachmentPart
对象。
通过调用org.apache.axis.attachments.AttachmentPart
对象的getDataHandler
方法,获取与附件关联的javax.activation.DataHandler
对象。
通过调用javax.activation.DataHandler
对象的getInputStream
方法获取java.io.FileStream
对象。
创建一个字节数组并将该字节数组传递给java.io.FileStream
对象的read
方法。 此方法使用表示加密的PDF文档的数据流填充字节数组。
使用java.io.File
对象的构造函数创建<a0/>对象。 此对象表示加密的PDF文档。
使用java.io.FileOutputStream
对象的构造函数并传递java.io.File
对象,创建<a0/>对象。
调用java.io.FileOutputStream
对象的write
方法并传递包含表示已加密PDF文档的数据流的字节数组。
另请参阅
AEM Forms在调用服务时支持各种web服务身份验证模式。 一种身份验证模式是使用Web服务调用中的基本授权头指定用户名和密码值。 AEM Forms还支持基于SAML断言的身份验证。 当客户端应用程序使用Web服务调用AEM Forms服务时,客户端应用程序可以以下列方式之一提供身份验证信息:
AEM Forms不支持标准的基于证书的身份验证,但支持不同形式的基于证书的身份验证。
《AEM Forms编程》中的Web服务快速开始指定用户名和口令值以执行授权。
AEM表单用户的标识可以通过使用密钥签名的SAML断言来表示。 以下XML代码显示SAML断言的示例。
<Assertion xmlns="urn:oasis:names:tc:SAML:1.0:assertion"
xmlns:saml="urn:oasis:names:tc:SAML:1.0:assertion"
xmlns:samlp="urn:oasis:names:tc:SAML:1.0:protocol"
AssertionID="fd4bd0c87302780e0d9bbfa8726d5bc0" IssueInstant="2008-04-17T13:47:00.720Z" Issuer="LiveCycle"
MajorVersion="1" MinorVersion="1">
<Conditions NotBefore="2008-04-17T13:47:00.720Z" NotOnOrAfter="2008-04-17T15:47:00.720Z">
</Conditions>
<AuthenticationStatement
AuthenticationInstant="2008-04-17T13:47:00.720Z"
AuthenticationMethod="urn:oasis:names:tc:SAML:1.0:am:unspecified">
<Subject>
<NameIdentifier NameQualifier="DefaultDom">administrator</NameIdentifier>
<SubjectConfirmation>
<ConfirmationMethod>urn:oasis:names:tc:SAML:1.0:cm:sender-vouches</ConfirmationMethod>
</SubjectConfirmation>
</Subject>
</AuthenticationStatement>
<ds:Signature >
<ds:SignedInfo>
<ds:CanonicalizationMethod Algorithm="https://www.w3.org/2001/10/xml-exc-c14n#"></ds:CanonicalizationMethod>
<ds:SignatureMethod Algorithm="https://www.w3.org/2000/09/xmldsig#hmac-sha1"></ds:SignatureMethod>
<ds:Reference URI="#fd4bd0c87302780e0d9bbfa8726d5bc0">
<ds:Transforms>
<ds:Transform Algorithm="https://www.w3.org/2000/09/xmldsig#enveloped-signature"></ds:Transform>
<ds:Transform Algorithm="https://www.w3.org/2001/10/xml-exc-c14n#">
<ec:InclusiveNamespaces
PrefixList="code ds kind rw saml samlp typens #default">
</ec:InclusiveNamespaces>
</ds:Transform>
</ds:Transforms>
<ds:DigestMethod Algorithm="https://www.w3.org/2000/09/xmldsig#sha1"></ds:DigestMethod>
<ds:DigestValue>hVrtqjWr+VzaVUIpQx0YI9lIjaY=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue>UMbBb+cUcPtcWDCIhXes4n4FxfU=</ds:SignatureValue>
</ds:Signature>
</Assertion>
此示例断言是为管理员用户发出的。 此断言包含以下值得注意的项目:
客户端应用程序可以从返回AuthResult
对象的任何AEM FormsAuthenticationManager API检索断言。 通过执行以下两种方法之一,可以获得AuthResult
实例:
AuthenticationManager.getAuthResultOnBehalfOfUser
方法。 此方法允许客户端应用程序为任何AEM表单用户获取AuthResult
对象。可以使用获取的SAML令牌对AEM表单用户进行身份验证。 此SAML断言(xml片段)可作为WS-Security头的一部分发送,该头包含用于用户身份验证的Web服务调用。 通常,客户端应用程序已对用户进行身份验证,但未存储用户凭据。 (或者用户已通过除使用用户名和密码之外的其他机制登录到该客户端。) 在这种情况下,客户端应用程序必须调用AEM Forms并模拟允许调用AEM Forms的特定用户。
要模拟特定用户,请使用Web服务调用AuthenticationManager.getAuthResultOnBehalfOfUser
方法。 此方法返回一个AuthResult
实例,该实例包含该用户的SAML断言。
然后,使用该SAML断言调用任何需要身份验证的服务。 此操作涉及将断言作为SOAP头的一部分进行发送。 当使用此断言进行Web服务调用时,AEM Forms将用户标识为由该断言表示的用户。 即,断言中指定的用户是调用服务的用户。
可以通过使用Axis库创建的Java代理类调用AEM Forms服务。 (请参阅使用Apache Axis创建Java代理类。)
当使用使用基于SAML的身份验证的AXIS时,请用Axis注册请求和响应处理程序。 Apache Axis在向AEM Forms发送调用请求之前调用该处理函数。 要注册处理程序,请创建扩展org.apache.axis.handlers.BasicHandler
的Java类。
创建带轴的AssertionHandler
以下名为AssertionHandler.java
的Java类显示扩展org.apache.axis.handlers.BasicHandler
的Java类的示例。
public class AssertionHandler extends BasicHandler {
public void invoke(MessageContext ctx) throws AxisFault {
String assertion = (String) ctx.getProperty(LC_ASSERTION);
//no assertion hence nothing to insert
if(assertion == null) return;
try {
MessageElement samlElement = new MessageElement(convertToXML(assertion));
SOAPHeader header = (SOAPHeader) ctx.getRequestMessage().getSOAPHeader();
//Create the wsse:Security element which would contain the SAML element
SOAPElement wsseHeader = header.addChildElement("Security", "wsse", WSSE_NS);
wsseHeader.appendChild(samlElement);
//remove the actor attribute as in LC we do not specify any actor. This would not remove the actor attribute though
//it would only remove it from the soapenv namespace
wsseHeader.getAttributes().removeNamedItem("actor");
} catch (SOAPException e) {
throw new AxisFault("Error occured while adding the assertion to the SOAP Header",e);
}
}
}
注册处理程序
要向Axis注册处理程序,请创建client-config.wsdd文件。 默认情况下,Axis会查找具有此名称的文件。 以下XML代码是client-config.wsdd文件的示例。 有关详细信息,请参阅Axis文档。
<deployment xmlns="https://xml.apache.org/axis/wsdd/" xmlns:java="https://xml.apache.org/axis/wsdd/providers/java">
<transport name="http" pivot="java:org.apache.axis.transport.http.HTTPSender"/>
<globalConfiguration >
<requestFlow >
<handler type="java:com.adobe.idp.um.example.AssertionHandler" />
</requestFlow >
</globalConfiguration >
</deployment>
调用AEM Forms服务
以下代码示例使用基于SAML的身份验证调用AEM Forms服务。
public class ImpersonationExample {
. . .
public void authenticateOnBehalf(String superUsername,String password,
String canonicalName,String domainName) throws UMException, RemoteException{
((org.apache.axis.client.Stub) authenticationManager).setUsername(superUsername);
((org.apache.axis.client.Stub) authenticationManager).setPassword(password);
//Step 1 - Invoke the Auth manager api to get an assertion for the user to be impersonated
AuthResult ar = authenticationManager.getAuthResultOnBehalfOfUser(canonicalName, domainName, null);
String assertion = ar.getAssertion();
//Step 2 - Setting the assertion here to be picked later by the AssertionHandler. Note that stubs are not threadSafe
//hence should not be reused. For this simple example we have made them instance variable but care should be taken
//regarding the thread safety
((javax.xml.rpc.Stub) authorizationManager)._setProperty(AssertionHandler.LC_ASSERTION, assertion);
}
public Role findRole(String roleId) throws UMException, RemoteException{
//This api would be invoked under bob's user rights
return authorizationManager.findRole(roleId);
}
public static void main(String[] args) throws Exception {
ImpersonationExample ie = new ImpersonationExample("http://localhost:5555");
//Get the SAML assertion for the user to impersonate and store it in stub
ie.authenticateOnBehalf(
"administrator", //The Super user which has the required impersonation permission
"password", // Password of the super user as referred above
"bob", //Cannonical name of the user to impersonate
"testdomain" //Domain of the user to impersonate
);
Role r = ie.findRole("BASIC_ROLE_ADMINISTRATOR");
System.out.println("Role "+r.getName());
}
}
您可以通过使用。NET客户端程序集和基于SAML的身份验证来调用Forms服务。 为此,必须使用Web服务增强3.0(WSE)。 有关创建使用WSE的。NET客户端程序集的信息,请参阅创建使用DIME的。NET项目。
DIME部分使用WSE 2.0。要使用基于SAML的身份验证,请按照与DIME主题中指定的相同说明操作。 但是,将WSE 2.0替换为WSE 3.0。在开发计算机上安装Web服务增强功能3.0,并将其与Microsoft Visual Studio .NET集成。 您可以从Microsoft下载中心下载Web服务增强3.0。
WSE体系结构使用策略、断言和SecurityToken数据类型。 对于Web服务调用,请简要指定策略。 策略可以有多个断言。 每个断言都可以包含过滤器。 在Web服务调用的特定阶段调用过滤器,当时,过滤器可以修改SOAP请求。 有关详细信息,请参阅Web服务增强3.0文档。
创建断言和筛选器
以下C#代码示例创建过滤器和断言类。 此代码示例创建一个SamlAssertionOutputFilter。 在将SOAP请求发送到AEM Forms之前,WSE框架会调用此过滤器。
class LCSamlPolicyAssertion : Microsoft.Web.ServicES4.Design.PolicyAssertion
{
public override Microsoft.Web.ServicES4.SoapFilter CreateClientOutputFilter(FilterCreationContext context)
{
return new SamlAssertionOutputFilter();
}
. . .
}
class SamlAssertionOutputFilter : SendSecurityFilter
{
public override void SecureMessage(SoapEnvelope envelope, Security security)
{
// Get the SamlToken from the SessionState
SamlToken samlToken = envelope.Context.Credentials.UltimateReceiver.GetClientToken<SamlToken>();
security.Tokens.Add(samlToken);
}
}
创建SAML令牌
创建一个类以表示SAML断言。 此类执行的主要任务是将数据值从字符串转换为xml并保留空格。 此断言xml稍后会导入到SOAP请求中。
class SamlToken : SecurityToken
{
public const string SAMLAssertion = "https://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1";
private XmlElement _assertionElement;
public SamlToken(string assertion)
: base(SAMLAssertion)
{
XmlDocument xmlDoc = new XmlDocument();
//The white space has to be preserved else the digital signature would get broken
xmlDoc.PreserveWhitespace = true;
xmlDoc.LoadXml(assertion);
_assertionElement = xmlDoc.DocumentElement;
}
public override XmlElement GetXml(XmlDocument document)
{
return (XmlElement)document.ImportNode(_assertionElement, true);
}
. . .
}
调用AEM Forms服务
以下C#代码示例使用基于SAML的身份验证调用Forms服务。
public class ImpersonationExample
{
. . .
public void AuthenticateOnBehalf(string superUsername, string password, string canonicalName, string domainName)
{
//Create a policy for UsernamePassword Token
Policy usernamePasswordPolicy = new Policy();
usernamePasswordPolicy.Assertions.Add(new UsernameOverTransportAssertion());
UsernameToken token = new UsernameToken(superUsername, password, PasswordOption.SendPlainText);
authenticationManager.SetClientCredential(token);
authenticationManager.SetPolicy(usernamePasswordPolicy);
//Get the SAML assertion for impersonated user
AuthClient.AuthenticationManagerService.AuthResult ar
= authenticationManager.getAuthResultOnBehalfOfUser(canonicalName, domainName, null);
System.Console.WriteLine("Received assertion " + ar.assertion);
//Create a policy for inserting SAML assertion
Policy samlPolicy = new Policy();
samlPolicy.Assertions.Add(new LCSamlPolicyAssertion());
authorizationManager.SetPolicy(samlPolicy);
//Set the SAML assertion obtained previously as the token
authorizationManager.SetClientCredential(new SamlToken(ar.assertion));
}
public Role findRole(string roleId)
{
return authorizationManager.findRole(roleId);
}
static void Main(string[] args)
{
ImpersonationExample ie = new ImpersonationExample("http://localhost:5555");
ie.AuthenticateOnBehalf(
"administrator", //The Super user which has the required impersonation permission
"password", // Password of the super user as referred above
"bob", //Cannonical name of the user to impersonate
"testdomain" //Domain of the user to impersonate
);
Role r = ie.findRole("BASIC_ROLE_ADMINISTRATOR");
System.Console.WriteLine("Role "+r.name);
}
}
有时,使用Web服务调用某些AEM Forms服务操作时会出现问题。 本讨论的目的是确定这些问题,并提供解决办法(如果有)。
如果尝试异步调用AEM Forms服务操作(如“生成PDF”的htmlToPDF
操作),则会出现SoapFaultException
。 要解决此问题,请创建一个自定义绑定XML文件,将ExportPDF_Result
元素和其他元素映射到不同的类中。 以下XML表示自定义绑定文件。
<bindings
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
xmlns:jxb="https://java.sun.com/xml/ns/jaxb" jxb:version="1.0"
xmlns:wsdl="https://schemas.xmlsoap.org/wsdl/"
wsdlLocation="http://localhost:8080/soap/services/GeneratePDFService?wsdl&async=true&lc_version=9.0.0"
xmlns="https://java.sun.com/xml/ns/jaxws">
<enableAsyncMapping>false</enableAsyncMapping>
<package name="external_customize.client"/>
<enableWrapperStyle>true</enableWrapperStyle>
<bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='ExportPDF_Result']">
<jxb:class name="ExportPDFAsyncResult">
</jxb:class>
</bindings>
<bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='CreatePDF_Result']">
<jxb:class name="CreatePDFAsyncResult">
</jxb:class>
</bindings>
<bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='HtmlToPDF_Result']">
<jxb:class name="HtmlToPDFAsyncResult">
</jxb:class>
</bindings>
<bindings node="/wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='https://adobe.com/idp/services']/xsd:element[@name='OptimizePDF_Result']">
<jxb:class name="OptimizePDFAsyncResult">
</jxb:class>
</bindings>
<!--bindings node="//wsdl:portType[@name='GeneratePDFService']/wsdl:operation[@name='HtmlToPDF_Result']">
<jxb:class name="HtmlToPDFAsyncResult"/>
</bindings-->
</bindings>
使用JAX-WS创建Java代理文件时,请使用此XML文件。 (请参阅使用JAX-WS创建Java代理类。)
使用- b
命令行选项执行JAX-WS工具(wsimport.exe)时,请引用此XML文件。 更新绑定XML文件中的wsdlLocation
元素以指定AEM Forms的URL。
要确保异步调用正常工作,请修改端点URL值并指定async=true
。 例如,对于使用JAX-WS创建的Java代理文件,请为BindingProvider.ENDPOINT_ADDRESS_PROPERTY
指定以下内容。
https://server:port/soap/services/ServiceName?wsdl&async=true&lc_version=9.0.0
以下列表指定异步调用时需要自定义绑定文件的其他服务:
有时,使用特定J2EE应用程序服务器创建的代理库无法成功调用托管在其他J2EE应用程序服务器上的AEM Forms。 考虑使用部署在WebSphere上的AEM Forms生成的代理库。 此代理库无法成功调用部署在JBoss应用程序服务器上的AEM Forms服务。
与JBoss Application Server相比,在WebSphere上部署AEM Forms时,某些AEM Forms复杂数据类型(如PrincipalReference
)的定义方式有所不同。 不同J2EE应用程序服务使用的JDK中的差异是WSDL定义存在差异的原因。 因此,请使用从同一J2EE应用程序服务器生成的代理库。
由于命名空间冲突,数据对象无法在多个服务WSDL之间共享。 不同的服务可以共享数据类型,因此服务在WSDL中共享这些类型的定义。 例如,不能向同一。NET客户端项目添加包含BLOB
数据类型的两个。NET客户端程序集。 如果尝试这样做,则会发生编译错误。
以下列表指定了无法在多个服务WSDL之间共享的数据类型:
User
Principals
PrincipalReference
Groups
Roles
BLOB
为避免出现此问题,建议您完全限定数据类型。 例如,考虑一个。NET应用程序,它使用服务引用引用Forms服务和签名服务。 两个服务引用都将包含BLOB
类。 要使用BLOB
实例,请在声明BLOB
对象时完全限定该对象。 下面的代码示例说明了这种方法。 有关此代码示例的信息,请参阅对交互式Forms进行数字签名。
以下C#代码示例签署由Forms服务呈现的交互式表单。 客户端应用程序有两个服务引用。 与Forms服务关联的BLOB
实例属于SignInteractiveForm.ServiceReference2
命名空间。 同样,与签名服务关联的BLOB
实例属于SignInteractiveForm.ServiceReference1
命名空间。 签名的交互式表单将保存为名为LoanXFASpid.pdf的PDF文件。
???/**
* Ensure that you create a .NET project that uses
* MS Visual Studio 2008 and version 3.5 of the .NET
* framework. This is required to invoke a
* AEM Forms service using MTOM.
*
* For information, see "Invoking AEM Forms using MTOM" in Programming with AEM forms
*/
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.IO;
//A reference to the Signature service
using SignInteractiveForm.ServiceReference1;
//A reference to the Forms service
using SignInteractiveForm.ServiceReference2;
namespace SignInteractiveForm
{
class Program
{
static void Main(string[] args)
{
try
{
//Because BLOB objects are used in both service references
//it is necessary to fully-qualify the BLOB objects
//Retrieve the form -- invoke the Forms service
SignInteractiveForm.ServiceReference2.BLOB formData = GetForm();
//Create a BLOB object associated with the Signature service
SignInteractiveForm.ServiceReference1.BLOB sigData = new SignInteractiveForm.ServiceReference1.BLOB();
//Transfer the byte stream from one Forms BLOB object to the
//Signature BLOB object
sigData.MTOM = formData.MTOM;
//Sign the Form -- invoke the Signature service
SignForm(sigData);
}
catch (Exception ee)
{
Console.WriteLine(ee.Message);
}
}
//Creates an interactive PDF form based on a XFA form - invoke the Forms service
private static SignInteractiveForm.ServiceReference2.BLOB GetForm()
{
try
{
//Create a FormsServiceClient object
FormsServiceClient formsClient = new FormsServiceClient();
formsClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/FormsService?blob=mtom");
//Enable BASIC HTTP authentication
BasicHttpBinding b = (BasicHttpBinding)formsClient.Endpoint.Binding;
b.MessageEncoding = WSMessageEncoding.Mtom;
formsClient.ClientCredentials.UserName.UserName = "administrator";
formsClient.ClientCredentials.UserName.Password = "password";
b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
b.MaxReceivedMessageSize = 2000000;
b.MaxBufferSize = 2000000;
b.ReaderQuotas.MaxArrayLength = 2000000;
//Create a BLOB to store form data
SignInteractiveForm.ServiceReference2.BLOB formData = new SignInteractiveForm.ServiceReference2.BLOB();
SignInteractiveForm.ServiceReference2.BLOB pdfForm = new SignInteractiveForm.ServiceReference2.BLOB();
//Specify a XML form data
string path = "C:\\Adobe\Loan.xml";
FileStream fs = new FileStream(path, FileMode.Open);
//Get the length of the file stream
int len = (int)fs.Length;
byte[] ByteArray = new byte[len];
fs.Read(ByteArray, 0, len);
formData.MTOM = ByteArray;
//Specify a XML form data
string path2 = "C:\\Adobe\LoanSigXFA.pdf";
FileStream fs2 = new FileStream(path2, FileMode.Open);
//Get the length of the file stream
int len2 = (int)fs2.Length;
byte[] ByteArray2 = new byte[len2];
fs2.Read(ByteArray2, 0, len2);
pdfForm.MTOM = ByteArray2;
PDFFormRenderSpec renderSpec = new PDFFormRenderSpec();
renderSpec.generateServerAppearance = true;
//Set out parameter values
long pageCount = 1;
String localValue = "en_US";
FormsResult result = new FormsResult();
//Render an interactive PDF form
formsClient.renderPDFForm2(
pdfForm,
formData,
renderSpec,
null,
null,
out pageCount,
out localValue,
out result);
//Write the data stream to the BLOB object
SignInteractiveForm.ServiceReference2.BLOB outForm = result.outputContent;
return outForm;
}
catch (Exception ee)
{
Console.WriteLine(ee.Message);
}
return null;
}
//Sign the form -- invoke the Signature service
private static void SignForm(SignInteractiveForm.ServiceReference1.BLOB inDoc)
{
try
{
//Create a SignatureServiceClient object
SignatureServiceClient signatureClient = new SignatureServiceClient();
signatureClient.Endpoint.Address = new System.ServiceModel.EndpointAddress("https://hiro-xp:8080/soap/services/SignatureService?blob=mtom");
//Enable BASIC HTTP authentication
BasicHttpBinding b = (BasicHttpBinding)signatureClient.Endpoint.Binding;
b.MessageEncoding = WSMessageEncoding.Mtom;
signatureClient.ClientCredentials.UserName.UserName = "administrator";
signatureClient.ClientCredentials.UserName.Password = "password";
b.Security.Transport.ClientCredentialType = HttpClientCredentialType.Basic;
b.Security.Mode = BasicHttpSecurityMode.TransportCredentialOnly;
b.MaxReceivedMessageSize = 2000000;
b.MaxBufferSize = 2000000;
b.ReaderQuotas.MaxArrayLength = 2000000;
//Specify the name of the signature field
string fieldName = "form1[0].grantApplication[0].page1[0].SignatureField1[0]";
//Create a Credential object
Credential myCred = new Credential();
myCred.alias = "secure";
//Specify the reason to sign the document
string reason = "The document was reviewed";
//Specify the location of the signer
string location = "New York HQ";
//Specify contact information
string contactInfo = "Tony Blue";
//Create a PDFSignatureAppearanceOptions object
//and show date information
PDFSignatureAppearanceOptionSpec appear = new PDFSignatureAppearanceOptionSpec();
appear.showDate = true;
//Sign the PDF document
SignInteractiveForm.ServiceReference1.BLOB signedDoc = signatureClient.sign(
inDoc,
fieldName,
myCred,
HashAlgorithm.SHA1,
reason,
location,
contactInfo,
appear,
true,
null,
null,
null);
//Populate a byte array with BLOB data that represents the signed form
byte[] outByteArray = signedDoc.MTOM;
//Save the signed PDF document
string fileName = "C:\\Adobe\LoanXFASigned.pdf";
FileStream fs2 = new FileStream(fileName, FileMode.OpenOrCreate);
//Create a BinaryWriter object
BinaryWriter w = new BinaryWriter(fs2);
w.Write(outByteArray);
w.Close();
fs2.Close();
}
catch (Exception ee)
{
Console.WriteLine(ee.Message);
}
}
}
}
使用Microsoft .Net 3.5和WCF时,某些AEM Forms生成的代理类的名称不正确。 当为IBMFilenetContentRepositoryConnector、IDPShedulerService或其名称开始字母I的任何其他服务创建代理类时,会发生此问题。例如,在IBMFileNetContentRepositoryConnector的情况下,生成的客户端的名称为BMFileNetContentRepositoryConnectorClient
。 生成的代理类中缺少字母I。