在 Oracle Content and Experience Cloud 中使用 Oracle Integration Cloud 中的流程创建文件夹或文档

使用文档开始事件对可由文档启动的进程建模。使用文件夹开始事件对可以由文件夹启动的进程进行建模。

您必须具有 Oracle Content Management 帐户，并且必须配置该服务与 Oracle Integration 之间的连接，然后才能创建这些流程之一。

通过启用 Oracle Content Management 集成，您可以为每个流程实例定义将在 Oracle Content Management 上自动创建的文件夹，从而提供相关文档的预定义组织。您还可以在任务层改写访问类型，以根据您的业务需求为特定任务定义文件夹或文档的正确权限。例如，您可能希望阻止用户查看与任务关联的分类文档或文件夹。

请注意成功集成的以下访问要求：

为了能够启动进程，在 Oracle Integration 中配置的 Oracle Content Management 用户必须对 Oracle Content Management 中配置的文件夹（即传入文档的文件夹）具有完全访问权限。
对于文件夹启动的流程（即具有文件夹开始事件的流程），在 Oracle Integration 中配置的 Oracle Content Management 用户必须具有对该文件夹的经理访问权限，才能在 Oracle Integration 中访问该文件夹。例如，经理需要访问“任务详细信息”页面和“流程跟踪”页面上的文件夹，以便在将流程 UI 组件嵌入外部应用程序时访问该文件夹，或在 Process Mobile 应用程序中查看该文件夹。
要在文件夹的进程列表中查看进程，并在新文档到达时能够启动进程实例，必须为在 Oracle Content Management 中配置的 Oracle Integration 用户授予进程启动器角色。

要设计可由文档或文件夹启动的进程，请执行以下操作：

在 Oracle Integration 中定义传入文档或传入文件夹。
为具有文档开始事件或文件夹开始事件的流程建模。
定制其实施以将开始事件与您创建的相应传入文档或文件夹进行映射。通过实施选项，您可以定义向用户公开文档或文件夹的方式。
（可选）修改可以在任务层访问文档或文件夹的角色。
在 Oracle Content Management 上配置文件夹以在文档到达时启动流程。

您也可以使用 REST API，并提供所有输入值。

定义传入文档或文件夹

您可以使用 Oracle Integration (Process Builder) 中的文档页来定义传入文档或文件夹。

打开要建模的进程应用程序，然后单击文档。“文档”页面列出了已定义的传入文档和传入文件夹。

要创建新的传入文档或文件夹，请单击新建，选择相应的类型，输入名称，然后选择默认访问权限。

可从文档或文件夹开始事件启动的模型流程

您可以在 Oracle Integration 中对可从文档启动或文件夹启动事件启动的进程进行建模。

开始之前，请从“元素”选项板添加文档开始或文件夹开始事件。仅支持您添加到流程的第一个开始事件。

在“应用程序主页”选项卡上，单击进程。
单击新建进程以打开“创建进程”对话框。
选择无
输入进程的名称，确保选中立即打开复选框，然后单击创建。
在元素选项板中，单击事件。
将文档开始事件或文件夹开始事件拖到画布上。
将序列流从新文档或文件夹开始事件添加到结束事件。
删除空开始事件。
继续修改和定义流程。确保对其进行测试和部署。

允许用户角色启动文档或文件夹启动的流程

您可以允许某些用户角色在 Oracle Integration 中启动文档或文件夹启动的流程。

要允许用户角色上载文档以启动进程，请执行以下操作：

打开该过程。
在带有文档或文件夹开始事件的游泳窗格中，单击角色名称，然后单击编辑。
在角色字段中，选择自动处理程序。

自定义文档启动或文件夹启动的流程

在 Oracle Integration 中对流程进行建模后，您可以在流程中添加起始文档或文件夹并对其进行自定义。

要定制文档启动或文件夹启动的流程，请执行以下操作：

在流程图中，单击文档开始或文件夹开始事件。
单击菜单，然后选择打开属性。
定义如何处理传入文档或文件夹。
- 就地：选择此值将保留文档的位置。如果需要，可以将传入文档或文件夹映射到其管理的预定义文档或文件夹之一。（为此，请打开下拉列表。）
  
  如果没有适合此特定流程的预定义传入文档或文件夹，请单击新建创建一个。
- 未管理：当前进程将忽略文档或文件夹。Oracle Integration Cloud 在运行时不会显示不受管理的文档或文件夹。由流程建模者处理传入的文档或文件夹。例如，如果要将传入文件夹或文档移动到其他位置，则可以使用 XPath 表达式获取属性（如 Id 或 Type），并将属性信息传递到 REST 服务。

配置文件夹

要将进程设置为在文档上载到文件夹时自动启动，需要在 Oracle Content Management 上配置文件夹。

要将文件夹配置为在文档到达时启动进程，请执行以下操作：

登录 Oracle Content Management。
选择文件夹。
从菜单栏中选择属性。
启用在文档到达时启动流程设置。
从列表中选择处理。
单击保存。

文件夹及其子文件夹现在可在 Oracle Integration 界面中使用。对文件夹中的文件的任何更改或上载到文件夹的任何新文件都会触发与文件夹关联的过程。可以为子文件夹覆盖继承处理，但不能禁用与处理的关联。

将文件从 Oracle Content Management 上载到配置用于 Oracle Integration 的文件夹中时，该文件将用于与该文件夹关联的任务。Oracle Integration 中的用户可以对其中的文件执行任何操作，例如审批。任务步骤完成后，可以根据定义的进程移动或管理文件。

Oracle Content Management 启动流程时，发送用于启动流程的有效负载包括以下信息：

文档 ID
文档名称
启动流程的用户的标识
类型
角色（指明用于生成后续应用程序链接的角色）
版本

以下示例仅使用文档 ID 和文档名称来显示在 Oracle Integration 中的表单中。此外，在发出 REST API 调用时将文档 ID 用于将 Oracle Content Management 中的文件移动或复制到任务文件夹中。

{
   "processDefId":"testing~UserFileApproval!1.0~FormApprovalProcess",
   "operation": "startEvent",
   "params": {
        "id": "D2806600E495B744E66BF3981212FF6185DE89BE6812",
        "type": "d",
        "name": "document-name",
        "startedBy": "user-id",
        "role": "role that should be used to generate subsequent applinks",
        "version": "version"
   }
}

作为开发者，您必须知道开发的流程的以下要求：

流程必须使用 Oracle Content Management“开始”事件。
部署进程时，需要与指定用于启用集成的用户共享该进程。否则，用户将无权触发处理。
对于上载文件以作为启动任务的用户显示的用户，进程必须使用在 startedby 字段中传递的值作为启动器的显示名称。
如果为文件夹启用流程集成，则需要与 Oracle Content Management 用户帐户共享此文件夹，该帐户用于在 Oracle Integration 中启用集成。