分配使用权限

本文档中的示例和示例仅适用于JEE环境上的AEM Forms。

关于Acrobat Reader DC扩展服务

Acrobat Reader DC扩展服务通过扩展Adobe Reader的功能使您的组织能够轻松共享交互式PDF文档。 Acrobat Reader DC扩展服务完全支持任何PDF文档，最高包括PDF 1.7。它可与Adobe Reader 7.0及更高版本一起使用。 该服务将使用权限添加到PDF文档，激活使用Adobe Reader打开PDF文档时通常不可用的功能。 第三方用户不需要附加软件或插件，即可与启用权限的文档配合使用。

您可以使用Acrobat Reader DC扩展服务完成以下任务:

• 将使用权限应用于PDF文档。 有关信息，请参阅将使用权限应用于PDF文档。
• 从PDF文档中删除使用权限。 有关信息，请参阅从PDF文档中删除使用权限。
• 检索凭据详细信息。 有关信息，请参阅检索凭据信息。

将使用权限应用于PDF文档

您可以使用Acrobat Reader DC扩展Java Client API和Web服务将使用权限应用于PDF文档。 使用权限与默认在Acrobat中但在Adobe Reader中不可用的功能有关，例如向表单添加注释或填写表单字段并保存表单的功能。 对其应用了使用权限的PDF文档称为启用权限的文档。 在Adobe Reader中打开启用权限的文档的用户可以执行为该特定文档启用的操作。

步骤的摘要

要对PDF文档应用使用权限，请执行以下步骤：

1. 包括项目文件。
2. 创建Acrobat Reader DC扩展Client对象。
3. 检索PDF文档。
4. 指定要应用的使用权限。
5. 对PDF文档应用使用权限。
6. 保存启用权限的PDF文档。

包括项目文件

在开发项目中包含必要的文件。 如果您使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用Web服务，请确保包含代理文件。

创建Acrobat Reader DC扩展Client对象

要以编程方式执行Acrobat Reader DC extensions服务操作，必须创建Acrobat Reader DC extensions服务客户端对象。 如果您使用Acrobat Reader DC扩展Java API，请创建ReaderExtensionsServiceClient对象。 如果您使用Acrobat Reader DC扩展Web服务API，请创建ReaderExtensionsServiceService对象。

检索PDF文档

您必须检索PDF文档才能应用使用权限。 支持权限的PDF文档包含使用权限词典。 当Adobe Reader打开包含此类词典的文档时，它将启用词典中指定的仅用于该文档的使用权限。 如果文档不包含使用权限词典，Acrobat Reader DC扩展服务将创建一个。 如果它已包含词典，Acrobat Reader DC扩展服务将用您指定的使用权限覆盖现有的使用权限。 词典指定启用哪些使用权限。 当用户在Adobe Reader中打开文档时，仅允许词典中指定的使用权限。

指定要应用的使用权限

您可以设置的使用权限由您从Adobe Systems Incorporated购买的凭据决定。 凭据通常提供设置一组相关使用权限的权限，例如与交互式表单相关的权限。 每个凭据都提供创建特定数量的启用权限的PDF文档的权利。 评估凭证允许创建不限数量的草稿文档。

将使用权限应用于PDF文档

要对PDF文档应用使用权限，请引用您用来应用使用权限的凭据的别名(通常在AEM Forms安装过程中会安装凭据)。 此外，您还必须指定应用使用权限的PDF文档。 有关配置凭据的信息，请参阅应用程序服务器的安装和部署指南。

保存启用权限的PDF文档

在Acrobat Reader DC扩展服务将使用权限应用于PDF文档后，您可以将启用权限的PDF文档另存为PDF文件。

另请参阅

使用Java API应用使用权限

使用Web服务API应用使用权限

包括AEM Forms Java库文件

设置连接属性

Acrobat Reader DC Extensions Service API快速开始

使用Java API应用使用权限

使用Acrobat Reader DC Extensions API(Java)将使用权限应用于PDF文档:

1. 包括项目文件

   在Java项目的类路径中包含客户端JAR文件，如adobe-reader-extensions-client.jar。

2. 创建Acrobat Reader DC扩展Client对象。

   • 创建包含连接属性的ServiceClientFactory对象。
   • 使用ReaderExtensionsServiceClient对象的构造函数并传递ServiceClientFactory对象，创建对象。

3. 检索PDF文档。

   • 使用PDF文档的构造函数并传递一个指定PDF文档位置的字符串值，创建一个表示PDF的java.io.FileInputStream对象。
   • 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。

4. 指定要应用的使用权限。

   • 使用其构造函数创建表示使用权限的UsageRights对象。
   • 对于要应用的每个使用权，调用属于UsageRights对象的相应方法。 例如，要添加enableFormFillIn使用权限，请调用UsageRights对象的enableFormFillIn方法并传递true。 （对要应用的每个使用权重重复此步骤）。

5. 对PDF文档应用使用权限。

   • 使用ReaderExtensionsOptionSpec对象的构造函数创建对象。 此对象包含Acrobat Reader DC扩展服务所需的运行时选项。 调用此构造函数时，必须指定以下值：

     • UsageRights对象，其中包含要应用于文档的使用权限。
     • 一个字符串值，它指定用户在Adobe Reader 7.x中打开启用权限的PDF文档时看到的消息。Adobe Reader 8.0中不显示此消息。

   • 通过调用ReaderExtensionsServiceClient对象的applyUsageRights方法并传递以下值，将使用权限应用于PDF文档:

     • com.adobe.idp.Document对象，其中包含应用了使用权限的PDF文档。
     • 一个字符串值，它指定用于应用使用权限的凭据的别名。
     • 一个字符串值，它指定相应的密码值。 (当前忽略此参数。 您可以传递null。)

   • 包含运行时选项的ReaderExtensionsOptionSpec对象。

   applyUsageRights方法返回一个com.adobe.idp.Document对象，该对象包含启用权限的PDF文档。

6. 保存启用权限的PDF文档。

   • 创建一个java.io.File对象，并确保文件扩展名为.pdf。
   • 调用com.adobe.idp.Document对象的copyToFile方法，将com.adobe.idp.Document对象的内容复制到文件（请确保使用由applyUsageRights方法返回的com.adobe.idp.Document对象）。

另请参阅

将使用权限应用于PDF文档

快速开始（SOAP模式）：使用Java API应用使用权限

包括AEM Forms Java库文件

设置连接属性

使用Web服务API应用使用权限

使用Acrobat Reader DC Extensions API（Web服务）将使用权限应用于PDF文档:

1. 包括项目文件。

   创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1。

   注意

   将localhost替换为承载AEM Forms的服务器的IP地址。

2. 创建Acrobat Reader DC扩展Client对象。

   • 使用ReaderExtensionsServiceClient对象的默认构造函数创建对象。

   • 使用System.ServiceModel.EndpointAddress构造函数创建ReaderExtensionsServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom）。 确保指定?blob=mtom。)

   • 通过获取ReaderExtensionsServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。 将返回值转换为BasicHttpBinding。

   • 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值确保使用MTOM。

   • 通过执行以下任务，启用基本HTTP身份验证：

     • 为字段ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
     • 为字段ReaderExtensionsServiceClient.ClientCredentials.UserName.Password分配相应的密码值。
     • 将常量值HttpClientCredentialType.Basic赋给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
     • 将常量值BasicHttpSecurityMode.TransportCredentialOnly赋给字段BasicHttpBindingSecurity.Security.Mode。

3. 检索PDF文档。

   • 使用BLOB对象的构造函数创建对象。 BLOB对象用于存储应用了使用权限的PDF文档。
   • 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示PDF文档的文件位置以及打开文件的模式。
   • 创建一个字节数组，用于存储System.IO.FileStream对象的内容。 可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。
   • 通过调用System.IO.FileStream对象的Read方法，用流数据填充字节数组。 传递要读取的字节数组、起始位置和流长度。
   • 通过将MTOM属性赋予字节数组的内容，填充BLOB对象。

4. 指定要应用的使用权限。

   • 使用其构造函数创建表示使用权限的UsageRights对象。
   • 对于要应用的每个使用权，将值true分配给属于UsageRights对象的相应数据成员。 例如，要添加enableFormFillIn使用权限，请将true分配给UsageRights对象的enableFormFillIn数据成员。 （对要应用的每个使用权重重复此步骤）。

5. 对PDF文档应用使用权限。

   • 使用ReaderExtensionsOptionSpec对象的构造函数创建对象。 此对象包含Acrobat Reader DC扩展服务所需的运行时选项。

   • 将UsageRights对象指定给ReaderExtensionsOptionSpec对象的usageRights数据成员。

   • 为ReaderExtensionsOptionSpec对象的message文档成员指定一个字符串值，该值指定用户在Adobe Reader中打开启用权限的PDF时看到的消息。

   • 通过调用ReaderExtensionsServiceClient对象的applyUsageRights方法并传递以下值，将使用权限应用于PDF文档:

     • BLOB对象，其中包含应用了使用权限的PDF文档。
     • 一个字符串值，它指定用于应用使用权限的凭据的别名。
     • 一个字符串值，它指定相应的密码值。 (当前忽略此参数。 您可以传递null。)

   • 包含运行时选项的ReaderExtensionsOptionSpec对象。

   applyUsageRights方法返回一个BLOB对象，该对象包含启用权限的PDF文档。

6. 保存启用权限的PDF文档。

   • 通过调用其构造函数创建System.IO.FileStream对象。 传递一个字符串值，该值表示启用权限的PDF文档的文件位置。
   • 创建一个字节数组，用于存储applyUsageRights方法返回的BLOB对象的数据内容。 通过获取BLOB对象的MTOM数据成员的值来填充字节数组。
   • 通过调用其构造函数并传递System.IO.FileStream对象，创建System.IO.BinaryWriter对象。
   • 通过调用System.IO.BinaryWriter对象的Write方法并传递字节数组，将字节数组的内容写入PDF文件。

另请参阅

将使用权限应用于PDF文档

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

从PDF文档删除使用权限

您可以从启用权限的文档中删除使用权限。 要对具有权限的PDF文档执行其他AEM Forms操作，还必须从该应用程序中删除使用权限。 例如，在设置使用权限之前，您必须对PDF文档进行数字签名（或验证）。 因此，如果要对启用权限的文档执行操作，则必须从PDF文档中删除使用权限，执行其他操作，如对文档进行数字签名，然后对文档重新应用使用权限。

步骤的摘要

要从启用权限的PDF文档中删除使用权限，请执行以下步骤：

1. 包括项目文件。
2. 创建Acrobat Reader DC扩展Client对象。
3. 检索启用权限的PDF文档。
4. 从PDF文档中删除使用权限。
5. 保存PDF文档。

包括项目文件

在开发项目中包含必要的文件。 如果您使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用Web服务，请确保包含代理文件。

创建Acrobat Reader DC扩展Client对象

在以编程方式执行Acrobat Reader DC扩展服务操作之前，必须创建Acrobat Reader DC扩展服务客户端对象。 如果您使用Java API，请创建ReaderExtensionsServiceClient对象。 如果您使用Acrobat Reader DC扩展Web服务API，请创建ReaderExtensionsServiceService对象。

检索启用权限的PDF文档

检索启用权限的PDF文档以删除使用权限。

从PDF文档中删除使用权限

在检索启用了权限的PDF文档后，您可以删除使用权限。 删除使用权限后，在Adobe Reader中查看PDF文档时，将不再具有任何其他功能。

保存PDF文档

您可以将不再包含使用权限的PDF文档另存为PDF文件。 保存为PDF文件后，可在Adobe Reader或Acrobat中查看PDF文档。

另请参阅

使用Java API删除使用权限

使用Web服务API删除使用权限

包括AEM Forms Java库文件

设置连接属性

Acrobat Reader DC Extensions Service API快速开始

将使用权限应用于PDF文档

使用Java API删除使用权限

使用Acrobat Reader DC扩展API(Java)从启用权限的PDF文档中删除使用权限：

1. 包括项目文件。

   在Java项目的类路径中包含客户端JAR文件，如adobe-reader-extensions-client.jar。

2. 创建Acrobat Reader DC扩展Client对象。

   使用ReaderExtensionsServiceClient对象的构造函数并传递包含连接属性的ServiceClientFactory对象，创建对象。

3. 检索PDF文档。

   • 使用java.io.FileInputStream对象的构造函数并传递一个指定PDF文档位置的字符串值，创建一个对象，该对象表示启用权限的PDF文档。
   • 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。

4. 从PDF文档中删除使用权限。

   通过调用ReaderExtensionsServiceClient对象的removeUsageRights方法并传递包含启用权限的PDF文档的com.adobe.idp.Document对象，从PDF文档中删除使用权限。 此方法返回一个com.adobe.idp.Document对象，该对象包含没有使用权限的PDF文档。

5. 对PDF文档应用使用权限。

   • 创建一个java.io.File对象，并确保文件扩展名为.PDF。
   • 调用Document对象的copyToFile方法，将Document对象的内容复制到文件（请确保使用由removeUsageRights方法返回的Document对象）。

另请参阅

从PDF文档中删除使用权限

快速开始（SOAP模式）：使用Java API从PDF文档中删除使用权限

包括AEM Forms Java库文件

设置连接属性

使用Web服务API删除使用权限

使用Acrobat Reader DC扩展API（Web服务）从启用权限的PDF文档中删除使用权限：

1. 包括项目文件。

   创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1。

   注意

   将localhost替换为承载AEM Forms的服务器的IP地址。

2. 创建Acrobat Reader DC扩展Client对象。

   • 使用ReaderExtensionsServiceClient对象的默认构造函数创建对象。

   • 使用System.ServiceModel.EndpointAddress构造函数创建ReaderExtensionsServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom）。 确保指定?blob=mtom。)

   • 通过获取ReaderExtensionsServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。 将返回值转换为BasicHttpBinding。

   • 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值确保使用MTOM。

   • 通过执行以下任务，启用基本HTTP身份验证：

     • 为字段ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
     • 为字段ReaderExtensionsServiceClient.ClientCredentials.UserName.Password分配相应的密码值。
     • 将常量值HttpClientCredentialType.Basic赋给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
     • 将常量值BasicHttpSecurityMode.TransportCredentialOnly赋给字段BasicHttpBindingSecurity.Security.Mode。

3. 检索PDF文档。

   • 使用BLOB对象的构造函数创建对象。 BLOB对象用于存储启用权限的PDF文档，从中删除了使用权限。
   • 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值，该字符串值表示PDF文档的文件位置以及打开文件的模式。
   • 创建一个字节数组，用于存储System.IO.FileStream对象的内容。 可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。
   • 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
   • 通过将MTOM属性赋予字节数组的内容，填充BLOB对象。

4. 从PDF文档中删除使用权限。

   通过调用ReaderExtensionsServiceClient对象的removeUsageRights方法并传递包含启用权限的PDF文档的BLOB对象，从PDF文档中删除使用权限。 此方法返回一个BLOB对象，该对象包含没有使用权限的PDF文档。

5. 对PDF文档应用使用权限。

   • 通过调用System.IO.FileStream对象的构造函数并传递一个表示PDF文件位置的字符串值，创建一个对象。
   • 创建一个字节数组，用于存储removeUsageRights方法返回的BLOB对象的数据内容。 通过获取BLOB对象的MTOM数据成员的值来填充字节数组。
   • 通过调用其构造函数并传递System.IO.FileStream对象，创建System.IO.BinaryWriter对象。

另请参阅

从PDF文档中删除使用权限

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

检索凭据信息

您可以检索有关用于将使用权限应用于启用权限的PDF文档的凭据的信息。 通过检索有关凭据的信息，您可以获取诸如证书失效日期等信息。

步骤的摘要

要检索有关将使用权限应用于PDF文档的凭据的信息，请执行以下步骤：

1. 包括项目文件。
2. 创建Acrobat Reader DC扩展Client对象。
3. 检索启用权限的PDF文档。
4. 检索有关凭据的信息。

包括项目文件

在开发项目中包含必要的文件。 如果您使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用Web服务，请确保包含代理文件。

创建Acrobat Reader DC扩展Client对象

在以编程方式执行Acrobat Reader DC扩展服务操作之前，必须创建Acrobat Reader DC扩展服务客户端对象。 如果您使用Java API，请创建ReaderExtensionsServiceClient对象。 如果您使用Acrobat Reader DC扩展Web服务API，请创建ReaderExtensionsServiceService对象。

检索启用权限的PDF文档

您必须检索启用权限的PDF文档才能检索有关凭据的信息。 您还可以通过指定凭据的别名来检索有关凭据的信息；但是，如果要检索有关用于将使用权限应用于启用权限的特定PDF文档的凭据的信息，则必须检索该文档。

检索有关凭据的信息

在检索启用权限的PDF文档后，您可以获取有关用于向其应用使用权限的凭据的信息。 您可以获取有关凭据的以下信息：

• 打开启用权限的PDF文档时Adobe Reader中显示的消息。
• 此凭据不再有效的日期。
• 此凭据无效的日期。
• 为此启用权限的PDF文档设置的使用权限。
• 已使用凭据的次数。

另请参阅

使用Java API删除使用权限

使用Web服务API删除使用权限

包括AEM Forms Java库文件

设置连接属性

Acrobat Reader DC Extensions Service API快速开始

使用Java API检索凭据信息

使用Acrobat Reader DC扩展API(Java)检索凭据信息：

1. 包括项目文件。

   在Java项目的类路径中包含客户端JAR文件，如adobe-reader-extensions-client.jar。

2. 创建Acrobat Reader DC扩展Client对象。

   使用ReaderExtensionsServiceClient对象的构造函数并传递包含连接属性的ServiceClientFactory对象，创建对象。

3. 检索PDF文档。

   • 使用java.io.FileInputStream对象的构造函数并传递一个字符串值，该字符串值指定启用权限的PDF文档的位置，以创建表示启用权限的PDF文档的对象。
   • 使用com.adobe.idp.Document对象的构造函数并传递java.io.FileInputStream对象，创建对象。

4. 从PDF文档中删除使用权限。

   • 通过调用ReaderExtensionsServiceClient对象的getDocumentUsageRights方法并传递包含启用权限的PDF文档的com.adobe.idp.Document对象，检索有关用于将使用权限应用到PDF文档的凭据的信息。 此方法返回包含凭据信息的GetUsageRightsResult对象。
   • 通过调用GetUsageRightsResult对象的getNotAfter方法检索此凭据不再有效的日期。 此方法返回一个java.util.Date对象，它表示凭据不再有效的日期。
   • 通过调用GetUsageRightsResult对象的getMessage方法，检索打开启用权限的PDF文档时在Adobe Reader中显示的消息。 此方法返回表示消息的字符串值。

另请参阅

检索凭据信息

快速开始（SOAP模式）：使用Java API检索凭据信息

包括AEM Forms Java库文件

设置连接属性

使用Web服务API检索凭据信息

使用Acrobat Reader DC扩展API（Web服务）检索凭据信息：

1. 包括项目文件。

   创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义：http://localhost:8080/soap/services/ReaderExtensionsService?WSDL&lc_version=9.0.1。

   注意

   将localhost替换为承载AEM Forms的服务器的IP地址。

2. 创建Acrobat Reader DC扩展Client对象。

   • 使用ReaderExtensionsServiceClient对象的默认构造函数创建一个对象。

   • 使用System.ServiceModel.EndpointAddress构造函数创建ReaderExtensionsServiceClient.Endpoint.Address对象。 将指定WSDL的字符串值传递给AEM Forms服务（例如http://localhost:8080/soap/services/ReaderExtensionsService?blob=mtom）。 确保指定?blob=mtom。)

   • 通过获取ReaderExtensionsServiceClient.Endpoint.Binding字段的值，创建System.ServiceModel.BasicHttpBinding对象。 将返回值转换为BasicHttpBinding。

   • 将System.ServiceModel.BasicHttpBinding对象的MessageEncoding字段设置为WSMessageEncoding.Mtom。 此值确保使用MTOM。

   • 通过执行以下任务，启用基本HTTP身份验证：

     • 为字段ReaderExtensionsServiceClient.ClientCredentials.UserName.UserName指定AEM表单用户名。
     • 为字段ReaderExtensionsServiceClient.ClientCredentials.UserName.Password分配相应的密码值。
     • 将常量值HttpClientCredentialType.Basic赋给字段BasicHttpBindingSecurity.Transport.ClientCredentialType。
     • 将常量值BasicHttpSecurityMode.TransportCredentialOnly赋给字段BasicHttpBindingSecurity.Security.Mode。

3. 检索PDF文档。

   • 使用BLOB对象的构造函数创建对象。 BLOB对象用于存储启用权限的PDF文档。
   • 通过调用System.IO.FileStream对象的构造函数并传递一个字符串值来创建对象，该字符串值表示启用权限的PDF文档的文件位置以及打开文件的模式。
   • 创建一个字节数组，用于存储System.IO.FileStream对象的内容。 可以通过获取System.IO.FileStream对象的Length属性来确定字节数组的大小。
   • 通过调用System.IO.FileStream对象的Read方法并传递要读取的字节数组、开始位置和流长度，用流数据填充字节数组。
   • 通过将MTOM属性赋予字节数组的内容，填充BLOB对象。

4. 从PDF文档中删除使用权限。

   • 通过调用ReaderExtensionsServiceClient对象的getDocumentUsageRights方法并传递包含启用权限的PDF文档的com.adobe.idp.Document对象，检索有关用于将使用权限应用到PDF文档的凭据的信息。 此方法返回包含凭据信息的GetUsageRightsResult对象。
   • 获取GetUsageRightsResult对象notAfter数据成员的值，以检索凭据不再有效的日期。 此数据成员的数据类型为System.DateTime。
   • 通过获取GetUsageRightsResult对象的message文档成员的值，检索在Adobe Reader中打开启用权限的PDF时显示的消息。 此数据成员的数据类型是字符串。
   • 通过获取GetUsageRightsResult对象的useCount数据成员的值来检索凭据的使用次数。 此数据成员的数据类型是整数。

另请参阅

检索凭据信息

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms