创建全局连接

通过全局连接，Oracle Fusion Cloud Enterprise Data Management 可以与外部系统集成。一些全局连接类型用于与外部应用程序共享数据，而另一些全局连接类型用于将数据发送到外部服务以进行验证。

支持以下连接类型：

  • 外部验证：通过 REST API 调用将请求信息发送到外部系统，并接收返回的验证信息。
  • Microsoft Azure Blob 存储：将数据发送到 Microsoft Azure Blob 存储文件容器。
  • Oracle 地址、电子邮件和电话验证：通过连接到外部验证服务来验证请求中的地址。
  • Oracle Cloud EPM：将数据发送到 Enterprise Performance Management 收件箱以供元数据导入过程使用。
  • Oracle Cloud ERP：将数据发送到通用内容管理 (Universal Content Management, UCM) 文档帐户以供基于文件的数据导入 (File Based Data Import, FBDI) 过程使用。
  • Oracle Object Storage：用作技术适配器以支持更通用的外部系统。

用例

数据共享

  • 与 Microsoft Azure Blob 存储的全局连接可用于将提取和提取包的输出传输到 Microsoft Azure Blob 存储文件容器。
  • 可以使用与 Oracle Cloud ERP 的全局连接来传输数据（例如，帐户组合、映射集和相关的值集）以导入到 Financials Cloud 中。
  • 可以按以下方式使用与 Oracle Cloud EPM 的全局连接：
    • 管理 Account Reconciliation 业务流程的通用应用程序可以使用全局连接将配置文件发送到应用程序收件箱。
    • 管理 Profitability and Cost Management 业务流程的维的通用应用程序可以使用全局连接将元数据文件发送到 profitinbox。
    • 将映射文件发送到数据管理收件箱

验证

您可以限制连接类型，以便它们只能由云 EDM 中的特定应用程序使用。与 Oracle 地址、电子邮件和电话验证服务的全局连接适用于所有应用程序。

创建全局连接

注：

您必须是服务管理员才能创建全局连接。

注意事项

  • 创建全局连接后，您可以在提取中使用它。可以在多个提取中使用全局连接后，但每个提取只能使用一个全局连接。

    注：

    您无法在提取中使用 Oracle 地址、电子邮件和电话验证连接类型。
  • 创建全局连接后无法更改连接类型。

  • 应用程序导入和导出并不使用全局连接。而是，使用注册应用程序时指定的应用程序连接信息。

  • 为全局连接指定的参数由连接类型确定。
  • 与 Oracle Cloud EPM 和 Oracle Cloud ERP 应用程序的全局连接支持基本和 OAuth2 身份验证。必须为每个全局连接注册 OAuth2 客户端。请参阅“将 OAuth2 用于应用程序和全局连接”。
  • 与 Oracle Object Storage 的全局连接支持基本身份验证和 API 签名密钥身份验证。
  • 与 Oracle 地址、电子邮件和电话验证的全局连接仅支持 OAuth2 身份验证。
  • 用于外部验证的全局连接仅支持基本身份验证。

要创建全局连接：

  1. 从连接群集中，单击创建。
  2. 选择连接类型：
    • 外部验证
    • Microsoft Azure Blob 存储
    • Oracle 地址、电子邮件和电话验证

      注：

      只能为 Oracle 地址、电子邮件和电话验证创建一个全局连接。
    • Oracle Cloud EPM
    • Oracle Cloud ERP
    • Oracle Object Storage
  3. 输入连接的名称和（可选）描述，然后单击创建。

    全局连接将显示在连接检查器中。

  4. 单击编辑，然后指定连接的参数。指定的参数依赖于连接类型：
    • 外部验证参数：
      字段 描述
      位置 外部验证 REST 端点的 URL。执行 GET 操作来测试连接，执行 POST 操作来运行验证。

      示例：https://externalhostname.example.com/api/rest/externalValidation
      用户名/密码 基本身份验证的凭据
      最大批大小 外部系统应在单个批中验证的最大节点数，最多 10,000 个。默认值为 1,000。
      最大并发进程数 外部系统应运行的最大并发验证进程数，最多 3 个。默认值为 1。
    • Microsoft Azure Blob 存储参数：
      字段 描述
      位置 Microsoft Azure Blob 存储帐户的 URL。例如：https://myblobstorageaccount.blob.core.windows.net

      注意：URL 必须包含您的 Azure Blob 存储帐户的名称（在上面的示例中为 myblobstorageaccount）。在 Azure 中必须为此帐户分配存储 Blob 数据贡献者角色。
      租户 ID Microsoft Azure 租户中用于应用程序注册的租户 ID。
      客户端 ID Microsoft Azure 租户中服务主体的应用程序（客户端）ID。
      客户端密钥 Microsoft Azure 租户中客户端密钥的值。
      默认容器名称 Microsoft Azure 租户中要向其写入数据的数据存储 容器。该容器必须存在于 Azure 租户中。
      默认子文件夹 可选：Microsoft Azure 租户中要向其写入数据的容器内子文件夹。

      注意：如果指定的子文件夹不存在，将在提取或提取包运行并指向此连接时创建该子文件夹。您可以使用正斜杠 (/) 字符指定其他子文件夹（例如 Application/Extract Data）。
    • Oracle 地址、电子邮件和电话验证参数：
      字段 描述
      位置 Oracle 地址、电子邮件和电话验证服务器的 URL。例如：https://mydataservice-myidentitydomain.data.us2.oraclecloud.com

      注意：

      如果要从浏览器粘贴地址，请勿在您的 URL 中包含上下文（例如 /data/ui）。
      客户端 ID 连接到地址验证服务时要使用的 OAuth 客户端 ID。

      注意：必须为 Oracle 地址、电子邮件和电话验证服务创建 OAuth 客户端凭据。请参阅《Using Oracle Address, Email, and Phone Verification》中的 "How to Begin with Address, Email, and Phone Verification"。
      客户端密钥 连接到地址验证服务时要使用的 OAuth 客户端密钥。
    • Oracle Cloud EPM 参数：
      字段 描述
      位置 EPM 收件箱的 URL。例如：https://acme-test-epmidm.epm.us-phoenix-1.ocs.oraclecloud.com

      注意：

      如果要从浏览器粘贴地址，请勿在您的 URL 中包含上下文（例如 /epmcloud）。
      身份验证类型 选择一个选项：
      • 基本：使用提供的用户凭据进行身份验证。
      • OAuth：使用 OAuth2 ID 和令牌进行身份验证。（仅适用于 Oracle Cloud Infrastructure (OCI)/第 2 代体系结构上的环境。）将 OAuth2 用于应用程序和全局连接

      默认文件夹（可选）

      		 云 EPM 环境中要将提取文件发送到的默认文件夹：
      • Planning、自由形式、Financial Consolidation and Close、Enterprise Profitability and Cost Management 默认应用程序收件箱
      • 数据管理文件夹（例如，inbox/repository）
      • Profitability and Cost Management 收件箱（例如，profitinbox）
      基本身份验证参数：
      用户名/密码 基本身份验证所需的凭据

      身份域（可选）

      		 授权时附加在用户名前面的身份域。
      OAuth 身份验证参数：
      客户端 ID 为全局连接创建的客户端的客户端 ID。
      访问令牌 为全局连接创建的客户端的访问令牌。
      刷新令牌 为全局连接创建的客户端的刷新令牌。
    • Oracle Cloud ERP 参数：
      字段 描述
      位置 EPM 服务器的 URL。例如：https://erp.mycloud.com
      身份验证类型 选择一个选项：
      • 基本：使用提供的用户凭据进行身份验证。
      • OAuth：使用 OAuth2 ID 和令牌进行身份验证。（仅适用于 Oracle Cloud Infrastructure (OCI)/第 2 代体系结构上的环境。）将 OAuth2 用于应用程序和全局连接

      默认文档帐户

      		 Oracle Cloud ERP 中要将文件提取到的文件夹。例如 fin/generalLedger/import。
      基本身份验证参数：
      用户名/密码 基本身份验证所需的凭据

      身份域（可选）

      		 授权时附加在用户名前面的身份域。
      OAuth 身份验证参数：
      IDCS 令牌 URL 提供方身份验证服务器。用于将授权码交换为访问令牌。
      客户端 ID 为全局连接创建的客户端的客户端 ID。
      范围 提供一种监管向 JSON Web 令牌授予的访问量的方法。
      证书别名 将证书导入到云 ERP 中时指定的别名。
      私有密钥上传 导入到云 ERP 中的证书文件。单击上传文件位置以上传文件。该文件的文件扩展名必须为 .PEM。
    • Oracle Object Storage 参数：
      字段 描述
      位置 Oracle Object Storage Cloud 存储桶的 Swift URL。URL 的格式为：https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace，其中：
      • host name（使用 Swift API 类型），例如 swiftobjectstorage。
      • region_identifier 是托管 Oracle Cloud Infrastructure (OCI)，例如 us-phoenix-1。请参阅“区域和可用性域”。
      • namespace 是所有存储桶和对象的顶级容器。在创建帐户时，会为每个 Oracle Cloud Infrastructure 租户分配一个唯一的对象存储命名空间名称，该名称由系统生成而且不可变。

      提示：

      Oracle Object Storage Swift URL 应包含版本和命名空间。位置参数中不包含尾部正斜杠。
      身份验证类型 选择“基本”或“API 签名密钥”身份验证方法。
      基本
      用户名/密码 身份验证所需的凭据，具体如下：
      1. 生成身份验证令牌（请参阅 Oracle Cloud Infrastructure Documentation 中的 "To create an Auth token"）。
      2. 在“用户名”字段，输入为其生成身份验证令牌的 OCI 用户名。
      3. 在“密码”字段，输入生成的身份验证令牌。此参数区分大小写。
      API 签名密钥
      • 租户 OCID
      • 用户 OCID
      • 公共密钥指纹
      • 私有密钥上传

      API 签名密钥所需的凭据，如下所示：

      1. 在 Oracle Cloud 控制台中，生成 API 签名密钥。请参阅《Oracle Cloud Infrastructure Developer Guide》中的 "How to Generate an API Signing Key"。
      2. 从控制台中，下载私有密钥并将其保存到 .oci 目录，然后单击添加。

        签名密钥的参数将显示在控制台中。

      3. 从控制台复制以下参数并将其粘贴到云 EDM 中：
        • 在租户 OCID 中，粘贴从控制台复制的租户值。
        • 在用户 OCID 中，粘贴从控制台复制的用户值。
        • 在公共密钥指纹中，粘贴从控制台复制的指纹值。
      4. 在私有密钥上传中，单击上传并上传您在步骤 b 中下载的私有密钥文件。
      默认存储桶（可选）

      注意：测试连接需要此字段。

      		 对象存储的命名空间中用于存储提取的文件的容器。此参数区分大小写。
      默认子文件夹（可选） “默认存储桶”下要写入提取文件的子文件夹。如果指定的子文件夹不存在，则将创建该文件夹。此参数区分大小写。
  5. （可选）：在支持的应用程序中，单击指定，然后选择可以使用此全局连接的应用程序。
  6. 单击测试连接以验证连接详细信息。

    注：

    对于 Oracle Object Storage 连接，必须输入默认存储桶才能测试连接。
  7. 单击保存。

    注：

    保存连接之前，必须更正所有连接中的所有问题。如果任何连接的连接详细信息中缺少任何必需字段，则会在该连接上显示一个指示符，并显示一个错误，指示一个或多个连接存在必须修复的问题。

要删除全局连接，请从“操作”列中单击 操作，然后单击删除。不能删除提取正在使用的全局连接。如果地址属性正在使用 Oracle 地址、电子邮件和电话验证全局连接，则无法将其删除。