以编程方式管理端点 programmatically-managing-endpoints

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

关于终结点注册表服务

Endpoint Registry服务提供了以编程方式管理端点的功能。 例如,您可以将以下类型的端点添加到服务中:

  • EJB
  • SOAP
  • 观察文件夹
  • 电子邮件
  • (在AEM表单中已弃用)远程处理
  • 任务管理器
NOTE
SOAP、EJB和(不适用于JEE上的AEM Forms)远程端点会自动为每个激活的服务创建。 SOAP和EJB端点为所有服务操作启用SOAP和EJB。

远程端点使Flex客户端能够调用对该端点所添加到的AEM Forms服务的操作。 将创建与端点同名的Flex目标,并且Flex客户端可以创建指向此目标的RemoteObjects以调用对相关服务的操作。

电子邮件、任务管理器和“观察文件夹”端点仅公开服务的特定操作。 添加这些端点需要第二个配置步骤来选择要调用的方法、设置配置参数以及指定输入和输出参数映射。

您可以将TaskManager端点组织成组,称为 类别. 这些类别随后通过TaskManager向工作区公开,最终用户在分类时看到TaskManager端点。 在工作区中,最终用户可在导航窗格中看到这些类别。 每个类别中的端点将作为进程卡显示在工作区的“启动进程”页面中。

您可以使用Endpoint Registry服务完成以下任务:

添加EJB端点 adding-ejb-endpoints

您可以使用AEM Forms Java API以编程方式将EJB端点添加到服务。 通过将EJB端点添加到服务,可以使客户机应用程序使用EJB模式调用该服务。 即,在设置调用AEM Forms所需的连接属性时,可以选择EJB模式。 (请参阅 设置连接属性.)

NOTE
无法使用Web服务添加EJB端点。
NOTE
通常,EJB端点会默认添加到服务中。但是,EJB端点可以添加到以编程方式部署的进程中,或者在删除了EJB端点且必须再次添加时。

步骤摘要 summary-of-steps

要向服务添加EJB端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistry Client 对象。
  3. 设置EJB终结点属性。
  4. 创建EJB端点。
  5. 启用端点。

包含项目文件

在开发项目中包含必要的文件。 必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

必须先创建EJB端点,然后才能以编程方式添加 EndpointRegistryClient 对象。

设置EJB终结点属性

要为服务创建EJB端点,请指定以下值:

  • 连接器标识符:指定要创建的终结点的类型。 要创建EJB端点,请指定 EJB.
  • 描述:指定终结点描述。
  • 名称:指定端点的名称。
  • 服务标识符:指定终结点所属的服务。
  • 操作名称:指定使用端点调用的操作的名称。 创建EJB端点时,请指定通配符( *)。 但是,如果您要指定特定操作而不是调用所有服务操作,请指定操作名称,而不是使用通配符( *)。

创建EJB端点

设置EJB终结点属性后,可以为服务创建EJB终结点。

启用端点

创建端点后,必须启用它。 启用端点后,便可用于调用服务。 启用该端点后,可在管理控制台中查看它。

另请参阅

使用Java API添加EJB端点

包括AEM Forms Java库文件

设置连接属性

使用Java API添加EJB端点 adding-an-ejb-endpoint-using-the-java-api

使用Java API添加EJB端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。 (

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 设置EJB终结点属性。

    • 创建 CreateEndpointInfo 对象。
    • 通过调用 CreateEndpointInfo 对象的 setConnectorId 方法和传递字符串值 EJB.
    • 通过调用 CreateEndpointInfo 对象的 setDescription 方法和传递描述端点的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setName 方法,并传递一个指定名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setServiceId 方法,并传递一个指定服务名称的字符串值。
    • 指定通过调用 CreateEndpointInfo 对象的 setOperationName 方法,并传递一个指定操作名称的字符串值。 对于SOAP和EJB端点,请指定通配符( *),这表示所有操作。
  4. 创建EJB端点。

    通过调用 EndpointRegistryClient 对象的 createEndpoint 方法和传递 CreateEndpointInfo 对象。 此方法会返回 Endpoint 表示新EJB端点的对象。

  5. 启用端点。

    通过调用 EndpointRegistryClient 对象的enable方法并传递 Endpoint 返回的对象 createEndpoint 方法。

另请参阅

步骤摘要

快速启动:使用Java API添加EJB端点

包括AEM Forms Java库文件

设置连接属性

添加SOAP端点 adding-soap-endpoints

您可以使用AEM Forms Java API以编程方式将SOAP端点添加到服务。 通过添加SOAP端点,可以使客户端应用程序使用SOAP模式调用该服务。 即,在设置调用AEM Forms所需的连接属性时,可以选择SOAP模式。

NOTE
无法使用Web服务添加SOAP端点。
NOTE
通常,默认情况下会向服务添加SOAP端点。但是,可以将SOAP端点添加到以编程方式部署的进程中,或者在删除了SOAP端点且必须再次添加时。

步骤摘要 summary_of_steps-1

要向服务添加SOAP端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 设置SOAP终结点属性。
  4. 创建SOAP端点。
  5. 启用端点。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

创建SOAP端点需要这些JAR文件。 但是,如果使用SOAP端点调用服务,则需要添加的JAR文件。 有关AEM Forms JAR文件的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

要以编程方式将SOAP端点添加到服务,您必须创建 EndpointRegistryClient 对象。

设置SOAP终结点属性

要向服务添加SOAP端点,请指定以下值:

  • 连接器标识符值:指定要创建的终结点的类型。 要创建SOAP端点,请指定 SOAP.
  • 描述:指定终结点描述。
  • 名称:指定终结点名称。
  • 服务标识符值:指定终结点所属的服务。
  • 操作名称:指定使用端点调用的操作的名称。 创建SOAP端点时,请指定通配符( *)。 但是,如果您要指定特定操作而不是调用所有服务操作,请指定操作名称,而不是使用通配符( *)。

创建SOAP端点

设置SOAP终结点属性后,可以创建SOAP终结点。

启用端点

创建端点后,必须启用它。 启用终结点后,可用于调用服务。 启用该端点后,您可以在管理控制台中查看它。

另请参阅

使用Java API添加SOAP端点

包括AEM Forms Java库文件

设置连接属性

使用Java API添加SOAP端点 add-a-soap-endpoint-using-the-java-api

使用Java API向服务添加SOAP端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 设置SOAP终结点属性。

    • 创建 CreateEndpointInfo 对象。
    • 通过调用 CreateEndpointInfo 对象的 setConnectorId 方法和传递字符串值 SOAP.
    • 通过调用 CreateEndpointInfo 对象的 setDescription 方法和传递描述端点的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setName 方法,并传递一个指定名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setServiceId 方法,并传递一个指定服务名称的字符串值。
    • 指定通过调用 CreateEndpointInfo 对象的 setOperationName 方法,并传递一个指定操作名称的字符串值。 对于SOAP和EJB端点,请指定通配符( *),这表示所有操作。
  4. 创建SOAP端点。

    通过调用 EndpointRegistryClient 对象的 createEndpoint 方法和传递 CreateEndpointInfo 对象。 此方法会返回 Endpoint 表示新SOAP端点的对象。

  5. 启用端点。

    通过调用 EndpointRegistryClient 对象的enable方法并传递 Endpoint 返回的对象 createEndpoint 方法。

另请参阅

步骤摘要

快速启动:使用Java API添加SOAP端点

包括AEM Forms Java库文件

设置连接属性

添加观察文件夹端点 adding-watched-folder-endpoints

您可以使用AEM Forms Java API以编程方式将观察文件夹端点添加到服务。 通过添加“观察文件夹”端点,用户可以将文件(如PDF文件)放置在文件夹中。 将文件放在文件夹中后,将调用配置的服务并操作文件。 服务执行指定的操作后,将修改的文件保存在指定的输出文件夹中。 观察文件夹配置为按固定速率间隔或按cron时间表进行扫描,例如每周一、周三和周五中午。

为了以编程方式将Watched Folder端点添加到服务,请考虑以下名为的短暂进程 加密文档. (请参阅 了解AEM Forms流程.)

aw_aw_encryptdocumentprocess

此过程接受不安全的PDF文档作为输入值,然后将不安全的PDF文档传递到加密服务的 EncryptPDFUsingPassword 操作。 PDF文档使用密码进行加密,而密码加密的PDF文档是此过程的输出值。 输入值(无保护PDF文档)的名称为 InDoc 并且数据类型是 com.adobe.idp.Document. 输出值(密码加密的PDF文档)的名称为 SecuredDoc 并且数据类型是 com.adobe.idp.Document.

NOTE
无法使用Web服务添加Watched文件夹端点。

步骤摘要 summary_of_steps-2

要向服务添加Watched文件夹端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 设置观察文件夹终结点属性。
  4. 指定配置值。
  5. 定义输入参数值。
  6. 定义输出参数值。
  7. 创建观察文件夹端点。
  8. 启用端点。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

要以编程方式添加观察文件夹端点,您必须创建 EndpointRegistryClient 对象。

设置观察文件夹终结点属性

要为服务创建Watched文件夹端点,请指定以下值:

  • 连接器标识符:指定创建的端点的类型。 要创建Watched文件夹端点,请指定 WatchedFolder.
  • 描述:指定端点的描述。
  • 名称:指定端点的名称。
  • 服务标识符:指定终结点所属的服务。 例如,要将Watched文件夹端点添加到此部分介绍的进程(使用Workbench激活时,进程将成为服务),请指定 EncryptDocument.
  • 操作名称:指定使用端点调用的操作的名称。 通常,在为源自在Workbench中创建的进程的服务创建Watched文件夹端点时,操作的名称为 invoke.

指定配置值

以编程方式将观察文件夹端点添加到服务时,指定观察文件夹端点的配置值。 如果使用管理控制台添加观察文件夹终结点,则这些配置值由管理员指定。

以下列表指定以编程方式将Watched文件夹端点添加到服务时设置的配置值:

  • url:指定watched文件夹位置。 在群集环境中,此值必须指向可从群集中的每台计算机访问的共享网络文件夹。
  • 异步:将调用类型标识为异步或同步。 瞬态和同步进程只能同步调用。 默认值为true。 建议使用异步。
  • cronExpression:由Quartz用于安排输入目录的轮询。
  • purgeDuration:这是必需属性。 当结果文件夹中的文件和文件夹早于此值时将清除它们。 此值以天为单位。 此属性有助于确保结果文件夹不会填满。 值为–1天表示从不删除结果文件夹。 默认值为–1。
  • repeateinterval:扫描Watched文件夹以进行输入的间隔,以秒为单位。 除非启用了限制,否则该值应大于处理平均作业的时间;否则,系统可能会过载。 默认值为 5。
  • repeatcount:观察文件夹扫描文件夹或目录的次数。 值–1表示无限扫描。 默认值为–1。
  • throttleOn:限制可在任意给定时间处理的观察文件夹作业数。 最大作业数由batchSize值决定。
  • 用户名:从Watched文件夹调用目标服务时使用的用户名。 此值是必需的。 默认值为SuperAdmin。
  • 域名:用户的域。 此值是必需的。 默认值为DefaultDom。
  • batchSize:每次扫描要提取的文件或文件夹数。 使用此值可防止系统过载;一次扫描太多文件可能会导致崩溃。 默认值为 2。
  • waitTime:创建文件夹或文件后等待扫描的时间,以毫秒为单位。 例如,如果等待时间为36,000,000毫秒(1小时),文件是在一分钟前创建的,则将在59分钟或更长时间后提取此文件。 此属性对于确保文件或文件夹完全复制到输入文件夹非常有用。 例如,如果处理的文件很大,且下载文件需要10分钟,则将等待时间设置为10*60 *1000毫秒。 如果观察文件夹未等待10分钟,则此设置将阻止该文件夹扫描文件。 默认值为 0。
  • excludeFilePattern:观察文件夹用于确定要扫描和选取的文件和文件夹的模式。 将不会扫描任何具有此模式的文件或文件夹以进行处理。 当输入是包含多个文件的文件夹时,此设置非常有用。 文件夹的内容可以复制到一个文件夹,该文件夹具有将被监视文件夹拾取的名称。 此步骤可防止观察文件夹在文件夹完全复制到输入文件夹之前拾取文件夹进行处理。 例如,如果excludeFilePattern值为 data*,所有匹配的文件和文件夹 data* 不会被接收。 这包括名为的文件和文件夹 data1data2,等等。 此外,还可以使用通配符模式对模式进行补充,以指定文件模式。 观察文件夹修改正则表达式以支持通配符模式,例如 *.**.pdf. 正则表达式不支持这些通配符模式。
  • includeFilePattern:观察文件夹用于确定要扫描和选取的文件夹和文件的模式。 例如,如果此值为 *,所有匹配的文件和文件夹 input* 被接走了。 这包括名为的文件和文件夹 input1input2,等等。 默认值为 *。此值指示所有文件和文件夹。 此外,还可以使用通配符模式对模式进行补充,以指定文件模式。 观察文件夹修改正则表达式以支持通配符模式,例如 *.**.pdf. 正则表达式不支持这些通配符模式。 此值为必填项。
  • resultFolderName:存储所保存结果的文件夹。 此位置可以是绝对或相对目录路径。 如果结果未出现在此文件夹中,请检查失败文件夹。 只读文件不会得到处理,将保存在故障文件夹中。 默认值为 result/%Y/%M/%D/。这是watched文件夹中的结果文件夹。
  • preserveFolderName:成功扫描和提取后,文件存储的位置。 此位置可以是绝对、相对或空目录路径。 默认值为 preserve/%Y/%M/%D/
  • failureFolderName:保存失败文件的文件夹。 此位置始终相对于观察文件夹。 只读文件不会得到处理,将保存在故障文件夹中。 默认值为 failure/%Y/%M/%D/
  • preserveOnFailure:如果对服务运行操作失败,则保留输入文件。 默认值为true。
  • overwriteDuplicateFilename:设置为true时,将覆盖结果文件夹和保留文件夹中的文件。 当设置为false时,使用具有数字索引后缀的文件和文件夹作为名称。 默认值为false。

定义输入参数值

创建Watched文件夹端点时,必须定义输入参数值。 也就是说,必须描述传递给由watched文件夹调用的操作的输入值。 例如,请考虑本主题中引入的过程。 它具有一个输入值,名为 InDoc 并且其数据类型为 com.adobe.idp.Document. 为此进程创建Watched文件夹端点时(激活进程后,该进程将成为服务),必须定义输入参数值。

要定义Watched文件夹端点所需的输入参数值,请指定以下值:

输入参数名称:输入参数的名称。 在Workbench中为进程指定输入值的名称。 如果输入值属于服务操作(不是在Workbench中创建的进程的服务),则在component.xml文件中指定输入名称。 例如,本节介绍的进程的输入参数的名称为 InDoc.

映射类型:用于配置调用服务操作所需的输入值。 有两种类型的映射:

  • Literal:观察文件夹端点使用在显示的字段中输入的值。 支持所有基本Java类型。 例如,如果API使用字符串、long、int和Boolean等输入,则字符串将转换为正确类型并调用服务。
  • Variable:输入的值是watched文件夹用来选取输入的文件模式。 例如,如果为映射类型选择“可变”,并且输入文档必须是PDF文件,则可以指定 *.pdf作为映射值。

映射值:指定映射类型的值。 例如,如果您选择 Variable 映射类型,您可以指定 *.pdf 作为文件模式。

数据类型:指定输入值的数据类型。 例如,本节介绍的进程的输入值的数据类型为 com.adobe.idp.Document.

定义输出参数值

创建Watched文件夹端点时,必须定义输出参数值。 也就是说,必须描述由Watched文件夹端点调用的服务返回的输出值。 例如,请考虑本主题中引入的过程。 它有一个输出值,名为 SecuredDoc 并且其数据类型为 com.adobe.idp.Document. 为此进程创建Watched文件夹端点时(激活进程后,该进程将成为服务),必须定义输出参数值。

要定义Watched文件夹端点所需的输出参数值,请指定以下值:

输出参数名称:输出参数的名称。 进程输出值的名称在Workbench中指定。 如果输出值属于服务操作(不是在Workbench中创建的进程的服务),则在component.xml文件中指定输出名称。 例如,本节介绍的进程的输出参数的名称为 SecuredDoc.

映射类型:用于配置服务和操作的输出。 以下选项可供选择:

  • 如果服务返回单个对象(单个文档),则模式为 %F.pdf 源目标是sourcefilename.pdf。 例如,本节介绍的流程返回单个文档。 因此,可将映射类型定义为 %F.pdf ( %F 表示使用给定的文件名)。 模式 %E 指定输入文档的扩展名。
  • 如果服务返回列表,则模式为 Result\%F\,源目标为Result\sourcefilename\source1 (输出1)和Result\sourcefilename\source2 (输出2)。
  • 如果服务返回映射,则模式为 Result\%F\,源目标是Result\sourcefilename\file1和Result\sourcefilename\file2。 如果映射有多个对象,则模式为 Result\%F.pdf 源目标为Result\sourcefilename1.pdf (输出1)、Result\sourcefilenam2.pdf (输出2)等。

数据类型:指定返回值的数据类型。 例如,本节介绍的进程的返回值的数据类型为 com.adobe.idp.Document.

创建观察文件夹端点

在设置端点的属性、配置值并定义输入和输出参数值后,必须创建Watched文件夹端点。

启用端点

创建Watched文件夹端点后,必须启用它。 启用终结点后,可用于调用服务。 启用该端点后,可在管理控制台中查看它。

另请参阅

使用Java API添加观察文件夹端点

包括AEM Forms Java库文件

设置连接属性

使用Java API添加观察文件夹端点 add-a-watched-folder-endpoint-using-the-java-api

使用AEM Forms Java API添加Watched文件夹端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 设置观察文件夹终结点属性。

    • 创建 CreateEndpointInfo 对象。
    • 通过调用 CreateEndpointInfo 对象的 setConnectorId 方法和传递字符串值 WatchedFolder.
    • 通过调用 CreateEndpointInfo 对象的 setDescription 方法和传递描述端点的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setName 方法,并传递一个指定名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setServiceId 方法,并传递一个指定服务名称的字符串值。
    • 指定通过调用 CreateEndpointInfo 对象的 setOperationName 方法,并传递一个指定操作名称的字符串值。 通常,在为源自在Workbench中创建的进程的服务创建Watched文件夹端点时,会调用操作的名称。
  4. 指定配置值。

    对于要为Watched文件夹端点设置的每个配置值,必须调用 CreateEndpointInfo 对象的 setConfigParameterAsText 方法。 例如,要设置 url 配置值,调用 CreateEndpointInfo 对象的 setConfigParameterAsText 方法,并传递以下字符串值:

    • 一个字符串值,它指定配置值的名称。 设置 url 配置值,指定 url.
    • 指定配置值值的字符串值。 设置 url 配置值,指定watched文件夹位置。
    note note
    NOTE
    要查看为EncryptDocument服务设置的所有配置值,请参阅位于以下位置的Java代码示例: 快速启动:使用Java API添加观察文件夹端点.
  5. 定义输入参数值。

    通过调用 CreateEndpointInfo 对象的 setInputParameterMapping 方法并传递以下值:

    • 一个字符串值,它指定输入参数的名称。 例如,EncryptDocument服务的输入参数的名称为 InDoc.
    • 指定输入参数的数据类型的字符串值。 例如,数据类型为 InDoc 输入参数为 com.adobe.idp.Document.
    • 指定映射类型的字符串值。 例如,您可以指定 variable.
    • 一个字符串值,它指定映射类型值。 例如,您可以指定*.pdf作为文件模式。
    note note
    NOTE
    调用 setInputParameterMapping 每个要定义的输入参数值的方法。 由于EncryptDocument进程只有一个输入参数,因此您需要调用此方法一次。
  6. 定义输出参数值。

    通过调用 CreateEndpointInfo 对象的 setOutputParameterMapping 方法并传递以下值:

    • 一个字符串值,它指定输出参数的名称。 例如,EncryptDocument服务的输出参数的名称为 SecuredDoc.
    • 指定输出参数的数据类型的字符串值。 例如,数据类型为 SecuredDoc 输出参数为 com.adobe.idp.Document.
    • 指定映射类型的字符串值。 例如,您可以指定 %F.pdf.
  7. 创建观察文件夹端点。

    通过调用 EndpointRegistryClient 对象的 createEndpoint 方法和传递 CreateEndpointInfo 对象。 此方法会返回 Endpoint 表示观察文件夹端点的对象。

  8. 启用端点。

    通过调用 EndpointRegistryClient 对象的 enable 方法和传递 Endpoint 返回的对象 createEndpoint 方法。

另请参阅

步骤摘要

快速启动:使用Java API添加观察文件夹端点

包括AEM Forms Java库文件

设置连接属性

观察文件夹配置值常量文件 watched-folder-configuration-values-constant-file

快速启动:使用Java API添加观察文件夹端点 使用必须是Java项目一部分的常量文件来编译快速入门。 此常量文件表示添加Watched文件夹端点时必须设置的配置值。 以下Java代码表示常量文件。

 /**
     * This class contains constants that can be used when setting Watched Folder
     * configuration values
     */

 public final class WatchedFolderEndpointConfigConstants {

         public static final String PROPERTY_FILEPROVIDER_URL = "url";
         public static final String PROPERTY_PROPERTY_ASYNCHRONOUS = "asynchronous";
         public static final String PROPERTY_CRON_EXPRESSION = "cronExpression";
         public static final String PROPERTY_PURGE_DURATION = "purgeDuration";
         public static final String PROPERTY_REPEAT_INTERVAL = "repeatInterval";
         public static final String PROPERTY_REPEAT_COUNT = "repeatCount";
         public static final String PROPERTY_THROTTLE = "throttleOn";
         public static final String PROPERTY_USERNAMER = "userName";
         public static final String PROPERTY_DOMAINNAME = "domainName";
         public static final String PROPERTY_FILEPROVIDER_BATCH_SIZE = "batchSize";
         public static final String PROPERTY_FILEPROVIDER_WAIT_TIME = "waitTime";
         public static final String PROPERTY_EXCLUDE_FILE_PATTERN = "excludeFilePattern";
         public static final String PROPERTY_INCLUDE_FILE_PATTERN = "excludeFilePattern";
         public static final String PROPERTY_FILEPROVIDER_RESULT_FOLDER_NAME =  "resultFolderName";
         public static final String PROPERTY_FILEPROVIDER_PRESERVE_FOLDER_NAME = "preserveFolderName";
         public static final String PROPERTY_FILEPROVIDER_FAILURE_FOLDER_NAME = "failureFolderName";
         public static final String PROPERTY_FILEPROVIDER_PRESERVE_ON_FAILURE = "preserveOnFailure";
         public static final String PROPERTY_FILEPROVIDER_OVERWRITE_DUPLICATE_FILENAME = "overwriteDuplicateFilename";
        }

添加电子邮件端点 adding-email-endpoints

您可以使用AEM Forms Java API以编程方式将电子邮件端点添加到服务。 通过添加电子邮件端点,可让用户将包含一个或多个文件附件的电子邮件发送到指定的电子邮件帐户。 然后调用配置服务操作并操作文件。 服务执行指定的操作后,会向发件人发送一封电子邮件,其中包含作为文件附件的修改文件。

为了以编程方式将电子邮件端点添加到服务,请考虑以下名为的短期进程 MyApplication\EncryptDocument. 有关短期进程的信息,请参见 了解AEM Forms流程.

ae_ae_encryptdocumentprocess

此过程接受不安全的PDF文档作为输入值,然后将不安全的PDF文档传递到加密服务的 EncryptPDFUsingPassword 操作。 此过程使用密码对PDF文档进行加密,并将经过密码加密的PDF文档作为输出值返回。 输入值(无保护PDF文档)的名称为 InDoc 并且数据类型是 com.adobe.idp.Document. 输出值(密码加密的PDF文档)的名称为 SecuredDoc 并且数据类型是 com.adobe.idp.Document.

NOTE
无法使用Web服务添加电子邮件端点。

步骤摘要 summary_of_steps-3

要将电子邮件端点添加到服务,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 设置电子邮件端点属性。
  4. 指定配置值。
  5. 定义输入参数值。
  6. 定义输出参数值。
  7. 创建电子邮件端点。
  8. 启用端点。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

在以编程方式添加电子邮件端点之前,您必须创建 EndpointRegistryClient 对象。

设置电子邮件端点属性

要创建服务的电子邮件端点,请指定以下值:

  • 连接器标识符值:指定创建的端点的类型。 要创建电子邮件端点,请指定 Email.
  • 描述:指定端点的描述。
  • 名称:指定端点的名称。
  • 服务标识符值:指定终结点所属的服务。 例如,要向此部分介绍的流程添加电子邮件端点(使用Workbench激活流程时流程会成为服务),请指定 EncryptDocument.
  • 操作名称:指定使用端点调用的操作的名称。 通常,在为源自在Workbench中创建的进程的服务创建电子邮件端点时,操作的名称为 invoke.

指定配置值

以编程方式将电子邮件端点添加到服务时,指定电子邮件端点的配置值。 如果使用管理控制台添加电子邮件端点,则这些配置值由管理员指定。

NOTE
受监视的电子邮件帐户是仅用于电子邮件端点的特殊帐户。 此帐户不是常规用户的电子邮件帐户。 不能将常规用户的电子邮件帐户配置为电子邮件提供商使用的帐户,因为电子邮件提供商在完成邮件的处理之后会从收件箱中删除电子邮件。

以编程方式将电子邮件端点添加到服务时,会设置以下配置值:

  • cronExpression:如果电子邮件必须使用cron表达式计划,则为cron表达式。
  • repeatcount:电子邮件端点扫描文件夹或目录的次数。 值–1表示无限扫描。 默认值为–1。
  • repeateinterval:接收方用于检查传入邮件的扫描速率(以秒为单位)。 默认值为 10。
  • startDelay:计划程序启动后等待扫描的时间。 默认时间为0。
  • batchSize:接收者为获得最佳性能而每次扫描处理的电子邮件数量。 值为–1表示所有电子邮件。 默认值为 2。
  • 用户名:从电子邮件调用目标服务时使用的用户名。 默认值为 SuperAdmin
  • 域名:强制性配置值。 默认值为 DefaultDom
  • domainpattern:指定提供商接受的传入电子邮件的域模式。 例如,如果 adobe.com 使用,仅处理来自adobe.com的电子邮件,忽略来自其他域的电子邮件。
  • filePattern:指定提供程序接受的传入文件附件模式。 这包括具有特定文件扩展名(*.dat、*.xml)的文件、具有特定名称(数据)的文件以及具有名称和扩展名(*)的复合表达式的文件。[分日][aA]'端口')。 默认值为 *
  • recipientSuccessfulJob:发送消息以指示作业成功的电子邮件地址。 默认情况下,成功的工作消息将始终发送给发件人。 如果您键入 sender,则将电子邮件结果发送给发件人。 最多支持100个收件人。 指定具有电子邮件地址的其他收件人,每个收件人之间用逗号分隔。 要关闭此选项,请将此值留空。 在某些情况下,您可能希望触发一个进程,而不希望收到关于结果的电子邮件通知。 默认值为 sender
  • recipientFailedJob:发送消息以指示失败的作业的电子邮件地址。 默认情况下,始终将失败的作业消息发送给发件人。 如果您键入 sender,则将电子邮件结果发送给发件人。 最多支持100个收件人。 指定具有电子邮件地址的其他收件人,每个收件人之间用逗号分隔。 要关闭此选项,请将此值留空。 默认值为 sender
  • inboxHost:要扫描的电子邮件提供程序的收件箱主机名或IP地址。
  • 收件箱端口:电子邮件服务器使用的端口。 POP3的默认值为110,IMAP的默认值为143。 如果启用了SSL,则POP3的默认值为995,而IMAP的默认值为993。
  • inboxProtocol:用于电子邮件端点扫描收件箱的电子邮件协议。 选项包括 IMAPPOP3. 收件箱主机邮件服务器必须支持这些协议。
  • 收件箱超时:电子邮件提供商等待收件箱响应的超时时间(以秒为单位)。 默认值为 60。
  • inboxUser:登录电子邮件帐户所需的用户名。 根据电子邮件服务器和配置,这可能是电子邮件的用户名部分,也可能是完整的电子邮件地址。
  • inboxPassword:收件箱用户的密码。
  • inboxSSLEnabled:设置此值以强制电子邮件提供商在发送结果或错误的通知消息时使用SSL。 确保IMAP或POP3主机支持SSL。
  • smtpHost:电子邮件提供商将结果和错误消息发送到的邮件服务器的主机名。
  • smtpPort:SMTP端口的默认值为25。
  • smtuser:电子邮件提供商在发送结果和错误的电子邮件通知时要使用的用户帐户。
  • smtpPassword:SMTP帐户的密码。 某些邮件服务器不需要SMTP密码。
  • charSet:电子邮件提供商使用的字符集。 默认值为 UTF-8
  • smtpSSLEnabled:设置此值以强制电子邮件提供商在发送结果或错误的通知消息时使用SSL。 确保SMTP主机支持SSL。
  • failedJobFolder:指定当SMTP邮件服务器不工作时,用于存储结果的目录。
  • 异步:当设置为synchronous时,将处理所有输入文档并返回单个响应。 当设置为异步时,将为处理的每个输入文档发送响应。 例如,为本主题中介绍的流程创建了一个电子邮件端点,并会向端点的收件箱发送一封电子邮件,其中包含了多个不安全的PDF文档。 当所有PDF文档都使用密码加密时,如果端点配置为同步,则会发送一条响应电子邮件消息,其中附加所有安全的PDF文档。 如果端点配置为异步,则会为每个受保护PDF文档发送单独的响应电子邮件消息。 每封电子邮件都包含一个PDF文档作为附件。 默认值为asynchronous。

定义输入参数值

创建电子邮件端点时,必须定义输入参数值。 即,必须描述传递给电子邮件端点调用的操作的输入值。 例如,请考虑本主题中引入的过程。 它具有一个输入值,名为 InDoc 并且其数据类型为 com.adobe.idp.Document. 为此流程创建电子邮件端点时(激活流程后,该流程将成为服务),必须定义输入参数值。

要定义电子邮件端点所需的输入参数值,请指定以下值:

输入参数名称:输入参数的名称。 在Workbench中为进程指定输入值的名称。 如果输入值属于服务操作(不是在Workbench中创建的进程的Forms服务),则在component.xml文件中指定输入名称。 例如,本节介绍的进程的输入参数的名称为 InDoc.

映射类型:用于配置调用服务操作所需的输入值。 两种类型的映射如下所示:

  • Literal:电子邮件端点使用在显示的字段中输入的值。 支持所有基本Java类型。 例如,如果API使用字符串、long、int和Boolean等输入,则字符串将转换为正确类型并调用服务。
  • Variable:输入的值是电子邮件端点用于选取输入的文件模式。 例如,如果为映射类型选择“可变”,并且输入文档必须是PDF文件,则可以指定 *.pdf 作为映射值。

映射值:指定映射类型的值。 例如,如果选择变量映射类型,则可以指定 *.pdf 作为文件模式。

数据类型:指定输入值的数据类型。 例如,本节介绍的进程输入值的数据类型是com.adobe.idp.Document。

定义输出参数值

创建电子邮件端点时,必须定义输出参数值。 即,必须描述由电子邮件端点调用的服务返回的输出值。 例如,请考虑本主题中引入的过程。 它有一个输出值,名为 SecuredDoc 并且其数据类型为 com.adobe.idp.Document. 为此流程创建电子邮件端点时(流程激活后,即成为服务),必须定义输出参数值。

要定义电子邮件端点所需的输出参数值,请指定以下值:

输出参数名称:输出参数的名称。 进程输出值的名称在Workbench中指定。 如果输出值属于服务操作(不是在Workbench中创建的进程的服务),则在component.xml文件中指定输出名称。 例如,本节介绍的进程的输出参数的名称为 SecuredDoc.

映射类型:用于配置服务和操作的输出。 以下选项可供选择:

  • 如果服务返回单个对象(单个文档),则模式为 %F.pdf 源目标是sourcefilename.pdf。 例如,本节介绍的流程返回单个文档。 因此,可将映射类型定义为 %F.pdf ( %F 表示使用给定的文件名)。 模式 %E 指定输入文档的扩展名。
  • 如果服务返回列表,则模式为 Result\%F\,源目标为Result\sourcefilename\source1 (输出1)和Result\sourcefilename\source2 (输出2)。
  • 如果服务返回映射,则模式为 Result\%F\,源目标是Result\sourcefilename\file1和Result\sourcefilename\file2。 如果映射有多个对象,则模式为 Result\%F.pdf 源目标为Result\sourcefilename1.pdf (输出1)、Result\sourcefilenam2.pdf (输出2)等。

数据类型:指定返回值的数据类型。 例如,本节介绍的进程的返回值的数据类型为 com.adobe.idp.Document.

创建电子邮件端点

在设置电子邮件端点属性和配置值并定义输入和输出参数值后,必须创建电子邮件端点。

启用端点

创建电子邮件端点后,必须启用它。 启用终结点后,可用于调用服务。 启用该端点后,可在管理控制台中查看它。

另请参阅

使用Java API添加电子邮件端点

包括AEM Forms Java库文件

设置连接属性

使用Java API添加电子邮件端点 add-an-email-endpoint-using-the-java-api

使用Java API添加电子邮件端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 设置电子邮件端点属性。

    • 创建 CreateEndpointInfo 对象。
    • 通过调用 CreateEndpointInfo 对象的 setConnectorId 方法和传递字符串值 Email.
    • 通过调用 CreateEndpointInfo 对象的 setDescription 方法和传递描述端点的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setName 方法,并传递一个指定名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setServiceId 方法,并传递一个指定服务名称的字符串值。
    • 指定通过调用 CreateEndpointInfo 对象的 setOperationName 方法,并传递一个指定操作名称的字符串值。 通常,在为源自在Workbench中创建的进程的服务创建电子邮件端点时,会调用操作的名称。
  4. 指定配置值。

    对于要为电子邮件端点设置的每个配置值,您必须调用 CreateEndpointInfo 对象的 setConfigParameterAsText 方法。 例如,要设置 smtpHost 配置值,调用 CreateEndpointInfo 对象的 setConfigParameterAsText 方法并传递以下值:

    • 一个字符串值,它指定配置值的名称。 设置 smtpHost 配置值,指定 smtpHost.
    • 指定配置值值的字符串值。 设置 smtpHost 配置值,指定指定SMTP服务器名称的字符串值。
    note note
    NOTE
    要查看本节介绍的EncryptDocument服务的所有配置值集,请参阅位于以下位置的Java代码示例: 快速入门:使用Java API添加电子邮件端点.
  5. 定义输入参数值。

    通过调用 CreateEndpointInfo 对象的 setInputParameterMapping 方法并传递以下值:

    • 一个字符串值,它指定输入参数的名称。 例如,EncryptDocument服务的输入参数的名称为 InDoc.
    • 指定输入参数的数据类型的字符串值。 例如,数据类型为 InDoc 输入参数为 com.adobe.idp.Document.
    • 指定映射类型的字符串值。 例如,您可以指定 variable.
    • 一个字符串值,它指定映射类型值。 例如,您可以指定*.pdf作为文件模式。
    note note
    NOTE
    调用 setInputParameterMapping 每个要定义的输入参数值的方法。 由于EncryptDocument进程只有一个输入参数,因此您需要调用此方法一次。
  6. 定义输出参数值。

    通过调用 CreateEndpointInfo 对象的 setOutputParameterMapping 方法并传递以下值:

    • 一个字符串值,它指定输出参数的名称。 例如,EncryptDocument服务的输出参数的名称为 SecuredDoc.
    • 指定输出参数的数据类型的字符串值。 例如,数据类型为 SecuredDoc 输出参数为 com.adobe.idp.Document.
    • 指定映射类型的字符串值。 例如,您可以指定 %F.pdf.
  7. 创建电子邮件端点。

    通过调用 EndpointRegistryClient 对象的 createEndpoint 方法和传递 CreateEndpointInfo 对象。 此方法会返回 Endpoint 表示电子邮件端点的对象。

  8. 启用端点。

    通过调用 EndpointRegistryClient 对象的 enable 方法和传递 Endpoint 返回的对象 createEndpoint 方法。

另请参阅

步骤摘要

快速启动:使用Java API添加观察文件夹端点

包括AEM Forms Java库文件

设置连接属性

电子邮件配置值常量文件 email-configuration-values-constant-file

快速入门:使用Java API添加电子邮件端点 使用必须是Java项目一部分的常量文件来编译快速入门。 此常量文件表示添加电子邮件端点时必须设置的配置值。 以下Java代码表示常量文件。

 /**
     * This class contains constants that can be used when setting email endpoint
     * configuration values
     */
 public class EmailEndpointConfigConstants {

     public static final String PROPERTY_EMAILPROVIDER_CRON_EXPRESSION = "cronExpression";
     public static final String PROPERTY_EMAILPROVIDER_REPREAT_COUNT = "repeatCount";
     public static final String PROPERTY_EMAILPROVIDER_REPREAT_INTERVAL = "repeatInterval";
     public static final String PROPERTY_EMAILPROVIDER_START_DELAY = "startDelay";
     public static final String PROPERTY_EMAILPROVIDER_BATCH_SIZE = "batchSize";
     public static final String PROPERTY_EMAILPROVIDER_USERNAME = "userName";
     public static final String PROPERTY_EMAILPROVIDER_DOMAINNAME = "domainName";
     public static final String PROPERTY_EMAILPROVIDER_DOMAINPATTERN = "domainPattern";
     public static final String PROPERTY_EMAILPROVIDER_FILEPATTERN = "filePattern";
     public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_SUCCESSFUL_JOB = "recipientSuccessfulJob";
     public static final String PROPERTY_EMAILPROVIDER_RECIPIENT_FAILED_JOB = "recipientFailedJob";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_HOST = "inboxHost";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_PORT = "inboxPort";
     public static final String PROPERTY_EMAILPROVIDER_PROTOCOL = "inboxProtocol";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_TIMEOUT = "inboxTimeOut";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_USER = "inboxUser";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_PASSWORD = "inboxPassword";
     public static final String PROPERTY_EMAILPROVIDER_INBOX_SSL = "inboxSSLEnabled";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_HOST = "smtpHost";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_PORT = "smtpPort";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_USER = "smtpUser";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_PASSWORD = "smtpPassword";
     public static final String PROPERTY_EMAILPROVIDER_CHARSET = "charSet";
     public static final String PROPERTY_EMAILPROVIDER_SMTP_SSL = "smtpSSLEnabled";
     public static final String PROPERTY_EMAILPROVIDER_FAILED_FOLDER = "failedJobFolder";
     public static final String PROPERTY_EMAILPROVIDER_ASYNCHRONOUS = "asynchronous";
 }

添加远程端点 adding-remoting-endpoints

NOTE
JEE上的AEM表单已弃用LiveCycle RemotingAPI。

您可以使用AEM Forms Java API以编程方式将远程端点添加到服务。 通过添加远程端点,您可以使Flex应用程序通过使用远程来调用服务。 (请参阅 使用AEM Forms调用(已为AEM表单弃用) AEM Forms远程处理.)

为了以编程方式将远程端点添加到服务,请考虑以下名为的短暂进程 加密文档.

ar_ar_encryptdocumentprocess

此过程接受不安全的PDF文档作为输入值,然后将不安全的PDF文档传递到加密服务的 EncryptPDFUsingPassword 操作。 PDF文档使用密码进行加密,而密码加密的PDF文档是此过程的输出值。 输入值(无保护PDF文档)的名称为 InDoc 并且数据类型是 com.adobe.idp.Document. 输出值(密码加密的PDF文档)的名称为 SecuredDoc 并且数据类型是 com.adobe.idp.Document.

为了演示如何向服务添加远程端点,本节将远程端点添加到名为EncryptDocument的服务。

NOTE
无法使用Web服务添加远程端点。

步骤摘要 summary_of_steps-4

要从服务中删除端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 设置远程终结点属性。
  4. 创建远程端点。
  5. 启用端点。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

要以编程方式添加远程端点,您必须创建 EndpointRegistryClient 对象。

设置远程终结点属性

要为服务创建远程端点,请指定以下值:

  • 连接器标识符值:指定创建的端点的类型。 要创建远程端点,请指定 Remoting.
  • 描述:指定端点的描述。
  • 名称:指定端点的名称。
  • 服务标识符值:指定终结点所属的服务。 例如,要将Remoting端点添加到此部分介绍的进程(在Workbench中激活进程时,该进程将成为服务),请指定 EncryptDocument.
  • 操作名称:指定使用端点调用的操作的名称。 创建远程端点时,请指定通配符(*)。

创建远程端点

设置远程端点属性后,可以为服务创建远程端点。

启用端点

创建端点后,必须启用它。 启用远程端点后,Flex客户端将能够调用该服务。

另请参阅

使用Java API添加远程端点

包括AEM Forms Java库文件

设置连接属性

使用Java API添加远程端点 add-a-remoting-endpoint-using-the-java-api

使用Java API添加远程端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 设置远程终结点属性。

    • 创建 CreateEndpointInfo 对象。
    • 通过调用 CreateEndpointInfo 对象的 setConnectorId 方法和传递字符串值 Remoting.
    • 通过调用 CreateEndpointInfo 对象的 setDescription 方法和传递描述端点的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setName 方法,并传递一个指定名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setServiceId 方法,并传递一个指定服务名称的字符串值。
    • 指定由调用的 CreateEndpointInfo 对象的 setOperationName 方法,并传递一个指定操作名称的字符串值。 对于远程端点,请指定通配符(*)。
  4. 创建远程端点。

    通过调用 EndpointRegistryClient 对象的 createEndpoint 方法和传递 CreateEndpointInfo 对象。 此方法会返回 Endpoint 表示新远程端点的对象。

  5. 启用端点。

    通过调用 EndpointRegistryClient 对象的 enable 方法和传递 Endpoint 返回的对象 createEndpoint 方法。

另请参阅

步骤摘要

快速启动:使用Java API添加远程端点

包括AEM Forms Java库文件

设置连接属性

添加TaskManager端点 adding-taskmanager-endpoints

您可以使用AEM Forms Java API以编程方式将TaskManager端点添加到服务。 通过将TaskManager端点添加到服务,可以使Workspace用户能够调用该服务。 也就是说,在工作区中工作的用户可以调用具有相应TaskManager端点的进程。

NOTE
无法使用Web服务添加TaskManager端点。

步骤摘要 summary_of_steps-5

要向服务添加TaskManager端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 为端点创建类别。
  4. 设置TaskManager端点属性。
  5. 创建TaskManager端点。
  6. 启用端点。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

您必须先创建 EndpointRegistryClient 对象。

为端点创建类别

类别用于在工作区中组织服务。 也就是说,Workspace用户可以通过在Workspace中选择类别来调用具有TaskManager端点的服务。 创建TaskManager端点时,您可以引用现有类别或以编程方式创建类别。

NOTE
本部分将创建一个新类别作为将TaskManager端点添加到服务的一部分。

设置TaskManager端点属性

要为服务创建TaskManager端点,请指定以下值:

  • 连接器标识符:指定创建的端点的类型。 要创建TaskManager端点,请指定 TaskManagerConnector.
  • 描述:指定端点的描述。
  • 名称:指定端点的名称。
  • 服务标识符:指定终结点所属的服务。
  • 类别:指定与TaskManager端点关联的类别标识符值。
  • 操作名称:通常,在为源自在Workbench中创建的进程的服务创建TaskManager端点时,操作的名称为 invoke.

创建TaskManager端点

设置TaskManager端点属性后,可以为服务创建TaskManager端点。

启用端点

创建端点后,必须启用它。 启用端点后,便可用于从工作区中调用服务。 启用该端点后,可在管理控制台中查看它。

另请参阅

使用Java API添加TaskManager端点

包括AEM Forms Java库文件

设置连接属性

使用Java API添加TaskManager端点 add-a-taskmanager-endpoint-using-the-java-api

使用Java API添加TaskManager端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 为端点创建类别。

    • 创建 CreateEndpointCategoryInfo 对象,方法是使用其构造函数并传递以下值:

      • 一个字符串值,它指定类别的标识符值
      • 指定类别说明的字符串值
    • 通过调用 EndpointRegistryClient 对象的 createEndpointCategory 方法和传递 CreateEndpointCategoryInfo 对象。 此方法会返回 EndpointCategory 表示新类别的对象。

  4. 设置TaskManager端点属性。

    • 创建 CreateEndpointInfo 对象。
    • 通过调用 CreateEndpointInfo 对象的 setConnectorId 方法和传递字符串值 TaskManagerConnector.
    • 通过调用 CreateEndpointInfo 对象的 setDescription 方法和传递描述端点的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setName 方法,并传递一个指定名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setServiceId 方法,并传递一个指定服务名称的字符串值。
    • 通过调用 CreateEndpointInfo 对象的 setCategoryId 和传递指定类别标识符值的字符串值。 您可以调用 EndpointCategory 对象的 getId 用于获取此类别的标识符值的方法。
    • 指定通过调用 CreateEndpointInfo 对象的 setOperationName 方法,并传递一个指定操作名称的字符串值。 通常,在创建 TaskManager 源自在Workbench中创建的进程的服务的端点,该操作的名称为 invoke.
  5. 创建TaskManager端点。

    通过调用 EndpointRegistryClient 对象的 createEndpoint 方法和传递 CreateEndpointInfo 对象。 此方法会返回 Endpoint 表示新TaskManager端点的对象。

  6. 启用端点。

    通过调用 EndpointRegistryClient 对象的 enable 方法和传递 Endpoint 返回的对象 createEndpoint 方法。

另请参阅

步骤摘要

快速启动:使用Java API添加TaskManager端点

包括AEM Forms Java库文件

设置连接属性

修改端点 modifying-endpoints

您可以使用AEM Forms Java API以编程方式修改现有端点。 通过修改端点,可以更改端点的行为。 例如,考虑指定用作观察文件夹的观察文件夹端点。 您可以通过编程方式修改属于Watched文件夹端点的配置值,从而产生另一个文件夹作为观察文件夹。 有关属于观察文件夹端点的配置值的信息,请参见 添加观察文件夹端点.

为了演示如何修改端点,本节通过更改作为Watched文件夹的文件夹来修改Watched文件夹端点。

NOTE
无法使用Web服务修改端点。

步骤摘要 summary_of_steps-6

要修改端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 检索端点。
  4. 指定新的配置值。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

要以编程方式修改端点,您必须创建 EndpointRegistryClient 对象。

检索要修改的端点

必须先检索端点,然后才能修改端点。 要检索端点,您必须以能够访问端点的用户的身份连接。 建议您以管理员身份连接。 (请参阅 设置连接属性)。

您可以通过检索端点列表来检索端点。 然后,您可以遍历列表,搜索要删除的特定端点。 例如,您可以通过确定与端点和端点类型对应的服务来定位端点。 在查找端点时,可以对其进行修改。

指定新的配置值

修改端点时,请指定新的配置值。 例如,要修改Watched Folder端点,请重置所有Watched Folder端点配置值,而不仅仅是要修改的值。 有关属于观察文件夹端点的配置值的信息,请参见 添加观察文件夹端点.

NOTE
有关属于电子邮件端点的配置值的信息,请参阅 添加电子邮件端点.
NOTE
您无法修改终结点调用的服务。 如果尝试修改服务,则会引发异常。 要修改与给定端点关联的服务,请移除该端点并创建一个服务。 (请参阅 删除端点.)

另请参阅

使用Java API修改端点

包括AEM Forms Java库文件

设置连接属性

使用Java API修改端点 modifying-an-endpoint-using-the-java-api

使用Java API修改端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 检索要修改的端点。

    • 通过调用,检索当前用户(在连接属性中指定)可以访问的所有端点的列表。 EndpointRegistryClient 对象的 getEndpoints 方法和传递 PagingFilter 用作过滤器的对象。 您可以传递 (PagingFilter)null 值返回所有端点。 此方法会返回 java.util.List 每个元素为 Endpoint 对象。 有关 PagingFilter 对象,请参见 AEM Forms API参考.
    • 循环访问 java.util.List 对象以确定它是否具有端点。 如果存在端点,则每个元素都为 EndPoint 实例。
    • 通过调用 EndPoint 对象的 getServiceId 方法。 此方法返回指定服务名称的字符串值。
    • 通过调用 EndPoint 对象的 getConnectorId 方法。 此方法返回一个指定终结点类型的字符串值。 例如,如果端点是“观察文件夹”端点,则此方法将返回 WatchedFolder.
  4. 指定新的配置值。

    • 创建 ModifyEndpointInfo 对象通过调用其构造函数。

    • 对于要设置的每个配置值,调用 ModifyEndpointInfo 对象的 setConfigParameterAsText 方法。 例如,要设置url配置值,请调用 ModifyEndpointInfo 对象的 setConfigParameterAsText 方法并传递以下值:

      • 一个字符串值,它指定配置值的名称。 例如,要设置 url 配置值,指定 url.
      • 指定配置值值的字符串值。 要定义值 url 配置值,指定watched文件夹位置。
    • 调用 EndpointRegistryClient 对象的 modifyEndpoint 方法并传递 ModifyEndpointInfo 对象。

另请参阅

步骤摘要

快速启动:使用Java API修改端点

包括AEM Forms Java库文件

设置连接属性

删除端点 removing-endpoints

您可以使用AEM Forms Java API以编程方式从服务中删除端点。 删除终结点后,无法使用终结点启用的调用方法调用该服务。 例如,如果从服务中删除SOAP端点,则无法使用SOAP模式调用该服务。

为了演示如何从服务中删除端点,本节从名为的服务中删除EJB端点 加密文档.

NOTE
无法使用Web服务删除端点。

步骤摘要 summary_of_steps-7

要从服务中删除端点,请执行以下任务:

  1. 包括项目文件。
  2. 创建 EndpointRegistryClient 对象。
  3. 检索端点。
  4. 删除端点。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

有关这些JAR文件位置的信息,请参见 包括AEM Forms Java库文件.

创建EndpointRegistry客户端对象

要以编程方式删除端点,您必须创建 EndpointRegistryClient 对象。

检索要删除的端点

在删除端点之前,必须检索它。 要检索端点,您必须以能够访问端点的用户的身份连接。 建议您以管理员身份连接。 (请参阅 设置连接属性)。

您可以通过检索端点列表来检索端点。 然后,您可以遍历列表,搜索要删除的特定端点。 例如,您可以通过确定与端点和端点类型对应的服务来定位端点。 找到端点后,可以将其删除。

删除端点

创建端点后,必须启用它。 启用终结点后,可用于调用服务。 启用该端点后,可在管理控制台中查看它。

另请参阅

使用Java API删除端点

包括AEM Forms Java库文件

设置连接属性

使用Java API删除端点 removing-an-endpoint-using-the-java-api

使用Java API删除端点:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建EndpointRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 EndpointRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 检索要删除的端点。

    • 通过调用 EndpointRegistryClient 对象的 getEndpoints 方法和传递 PagingFilter 用作过滤器的对象。 你可以通过 (PagingFilter)null 以返回所有端点。 此方法会返回 java.util.List 每个元素为 Endpoint 对象。
    • 循环访问 java.util.List 对象以确定它是否具有端点。 如果存在端点,则每个元素为 EndPoint 实例。
    • 通过调用 EndPoint 对象的 getServiceId 方法。 此方法返回指定服务名称的字符串值。
    • 通过调用 EndPoint 对象的 getConnectorId 方法。 此方法返回一个指定终结点类型的字符串值。 例如,如果端点是EJB端点,则此方法将返回 EJB.
  4. 删除端点。

    通过调用 EndpointRegistryClient 对象的 remove 方法和传递 EndPoint 表示要删除的端点的对象。

另请参阅

步骤摘要

快速启动:使用Java API删除端点

包括AEM Forms Java库文件

设置连接属性

正在检索端点连接器信息 retrieving-endpoint-connector-information

您可以使用AEM Forms API以编程方式检索有关端点连接器的信息。 连接器允许端点使用各种调用方法调用服务。 例如,Watched文件夹连接器允许端点使用watched文件夹调用服务。 通过以编程方式检索有关端点连接器的信息,可以检索与连接器关联的配置值,例如哪些配置值是必需的以及哪些是可选的。

为了演示如何检索有关端点连接器的信息,本节检索有关Watched Folder连接器的信息。 (请参阅 添加观察文件夹端点.)

NOTE
无法使用Web服务检索有关端点的信息。
NOTE
本主题使用 ConnectorRegistryClient 用于检索有关端点连接器信息的API。 (请参阅 AEM Forms API参考.)

步骤摘要 summary_of_steps-8

要检索终结点连接器信息,请执行以下任务:

  1. 包括项目文件。
  2. 创建 ConnectorRegistryClient 对象。
  3. 指定连接器类型。
  4. 检索配置值。

包含项目文件

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

必须将以下JAR文件添加到项目的类路径中:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar(如果在JBoss Application Server上部署了AEM Forms,则此为必填字段)
  • jbossall-client.jar(如果将AEM Forms部署在JBoss Application Server上,则此为必需字段)

如果AEM Forms部署在受支持的J2EE应用程序服务器(不是JBoss)上,请将adobe-utilities.jar和jbossall-client.jar替换为特定于部署AEM Forms的J2EE应用程序服务器的JAR文件。 有关所有AEM Forms JAR文件的位置的信息,请参见 包括AEM Forms Java库文件.

创建ConnectorRegistry客户端对象

要以编程方式检索端点连接器信息,请创建 ConnectorRegistryClient 对象。

指定连接器类型

指定要从中检索信息的连接器的类型。 存在以下类型的连接器:

  • EJB:使客户端应用程序能够使用EJB模式调用服务。
  • SOAP:允许客户端应用程序使用SOAP模式调用服务。
  • 观察文件夹:启用watched文件夹调用服务。
  • 电子邮件:启用电子邮件以调用服务。
  • 远程处理:允许Flex客户端应用程序调用服务。
  • 任务管理器连接器:允许Workspace用户从Workspace中调用服务。

检索配置值

指定连接器类型后,可以检索有关连接器的信息,如支持的配置值。 例如,对于任何连接器,您可以确定哪些配置值是必需的,哪些是可选的。

另请参阅

使用Java API检索端点连接器信息

包括AEM Forms Java库文件

设置连接属性

使用Java API检索端点连接器信息 retrieve-endpoint-connector-information-using-the-java-api

使用Java API检索端点连接器信息:

  1. 包括项目文件。

    将客户端JAR文件(如adobe-livecycle-client.jar)包含在Java项目的类路径中。

  2. 创建ConnectorRegistry客户端对象。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 ConnectorRegistryClient 对象,使用它的构造函数传递 ServiceClientFactory 对象。
  3. 指定连接器类型。

    通过调用 ConnectorRegistryClient 对象的 getEndpointDefinition 方法,并传递一个指定连接器类型的字符串值。 例如,要指定观察文件夹连接器类型,请传递字符串值 WatchedFolder. 此方法会返回 Endpoint 对应于连接器类型的对象。

  4. 检索配置值。

    • 通过调用 Endpoint 对象的 getConfigParameters 方法。 此方法返回的数组 ConfigParameter 对象。
    • 通过检索数组中的每个元素来检索有关每个配置值的信息。 每个元素都是一个 ConfigParameter 对象。 例如,通过调用 ConfigParameter 对象的 isRequired 方法。 如果需要配置值,则此方法将返回 true.

另请参阅

步骤摘要

快速启动:使用Java API检索端点连接器信息

包括AEM Forms Java库文件

设置连接属性

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2