1. 开发用于修改 PDF 文档的 Web 应用程序
  2. 开发修改 PDF 文档的 Web 应用程序

开发修改 PDF 文档的 Web 应用程序

Oracle Visual Builder 提供了工具和模板，允许您构建可使用外部 JavaScript 库创建、更新和下载 PDF 文档的 Web 应用程序。

应用用户在许多上下文中出于各种目的使用、修改和生成 PDF 文档。通常，应用程序必须读取上载的 PDF 文档，并相应地更改此文档的内容。应用程序应该能够对 PDF 执行的一些常见更改可能包括：
  • 正在添加新文本。
  • 在文档的一部分周围绘制矩形。
  • 在不同的页面中拆分 PDF。
  • 插入图像。
在某些情况下，需要从头开始创建新的 PDF 文档并使用应用程序生成的信息进行填充。

此解决方案提供了在 Web 和移动 Visual Builder 应用程序上实施 PDF 修改功能所需的指导。本文档介绍了如何开发一个单页 Web 应用程序，用户可以使用该应用程序上载或创建新 PDF 文件，使用定制文本修改此文档，然后在应用程序的主页上显示该文档。如有必要，应用程序还将允许用户将文件下载到其本地客户机系统信息库。

GitHub 资料档案库 (SampleVBCSModifyingPDFApplication) 包含 Oracle Visual Builder Web 应用程序的源代码，可用作此类实施的示例。您可以从此手册的“浏览更多”部分访问此资料档案库。

开始之前

开发人员可以使用 Oracle 的低代码 Visual Builder 创建 Web 或移动应用来处理 PDF 文件以执行下列任务：

  • 创建 PDF 文件。
  • 修改 PDF 内容（例如，添加或删除页面、文本、图像）。
  • 将不同的 PDF 文档合并为一个文档或拆分多页 PDF 文档。
然后，应用程序可以生成 PDF 文档，该文档可以：
  • 在应用程序 UI 上显示。
  • 由应用程序用户下载。
  • 存储在存储桶上。
  • 发送到其他 OCI 服务以供进一步处理（例如 OCI 文档理解服务）。
当 Oracle Visual Builder 是此类操作的开发平台时，您需要导入外部库来生成和更新 PDF 文档。因此，在开始之前，您需要评估可用的 JavaScript 库并确定其 API 是否可以满足您的应用需求。

此解决方案使用 PDF-LIB API 创建新的 PDF 文档并修改现有的 PDF 文档。

体系结构

此体系结构图显示了开发和集成由 Oracle Visual Builder 实施和部署的 Web 应用程序的常见方法。


后面是 webapp-vb-arch.png 的说明
插图 webapp-vb-arch.png 的说明

webapp-vb-arch-oracle.zip

Oracle Visual Builder 允许您开发可与后端存储服务通信的应用程序。使用此页可以创建呈现应用程序界面的页，创建连接到 REST 服务的服务连接，以及定义构建配置，以便 Oracle Visual Builder 的构建服务可以创建 Android、iOS、Progressive 和基本 Web 应用程序。

此体系结构包含以下组件：
  • Visual Builder Cloud Service（可视化构建器云服务）

    Oracle Visual Builder Cloud Service 是基于云的软件开发平台即服务 (PaaS)，也是应用程序开发基础设施的托管环境。它提供了基于标准的开源解决方案，可用于开发、协作处理应用程序并在 Oracle Cloud 中部署应用程序。它还提供了一个集成的可视化开发环境，其中包含敏捷的协作开发、版本控制以及持续交付自动化。使用吸引人的定制 UI 扩充应用，这是一个可通过标准 JavaScript、HTML、CSS 和 REST 实现扩展的平台。

  • Visual Builder Studio
    Oracle Visual Builder Studio (VB Studio) 是一个强大的应用程序开发平台，可帮助您的团队在应用程序开发生命周期的各个阶段（设计、构建、测试和部署）高效地规划和管理您的工作。通过 Oracle Visual Builder Studio，您可以获得：
    • 用于在 Git 中托管代码和托管二进制文件（例如 Maven 依赖项）的内置资料档案库。
    • 连续集成服务，使构建和测试系统自动化。
    • 与 Oracle Cloud Applications 紧密集成的连续交付服务。
    • 与源控制 (Git) 集成的可视化设计器，可帮助开发人员管理更改、应用版本控制优秀实践以及与团队成员协作开发应用。
    • 能够构建和显示 UI 的不同风格，以满足特定 Oracle Cloud Applications（使用 VB Studio 和 Oracle JavaScript Extension Toolkit (Oracle JET) 构建的用户的离散用户需求，也可以在 Git 框架中实现。
    • 敏捷板和用于跟踪冲刺、任务、缺陷和功能的问题跟踪系统。
    Oracle Visual Builder Studio 允许您轻松地将其应用程序部署到其首选目标，无论是 Oracle Cloud Applications 的暂存实例还是生产实例，还是 Oracle Cloud Infrastructure (OCI) 服务实例。
  • VM（虚拟机构建执行程序）

    VM 构建执行程序是 OCI VM 计算实例，专用于运行贵组织成员在 VB Studio 项目中定义的作业构建。VM 执行程序始终与构建执行程序模板关联。当组织的成员创建职务时，他们只是将相应的执行程序模板与职务相关联。当作业的构建触发器时，VB Studio 在与执行程序模板关联的 VM 执行程序上运行构建。当引用其执行程序模板的作业生成时，VM 执行程序会自动启动，并相应地更改其状态。请记住，仅当 VM 执行程序处于活动状态、运行构建或准备运行构建时，它才会对您产生成本。

  • Docker 容器（构建执行程序和映像）
    Docker 映像定义了组织成员在 Docker 执行程序上运行构建所需的操作系统和软件包。您可以从外部 Docker 注册表（例如 DockerHub）导入 Docker 映像，或者从构建执行程序模板创建映像。与 VM 执行程序不同，Docker 执行程序不直接与任何特定 VM 关联。当组织的成员创建作业时，他们只是将 Docker 映像作为构建模板与作业关联。当作业的构建触发器时，VB Studio 在任何 Docker 部署 VM 上运行构建。记住 Docker 映像的一些要点：
    • 从构建执行程序模板创建映像时，VB Studio 通过安装该模板中配置的软件来创建新的 Docker 映像。从注册表创建映像时，VB Studio 会从注册表提取映像，添加构建代理并创建新映像。
    • 可以指定可从映像创建的最大执行程序数。
    • 您可以根据需要创建任意数量的 Docker 映像，前提是管理 VM 具有足够的空间。
  • 功能

    Oracle Cloud Infrastructure Functions 是一个完全托管的多租户、高度可扩展的按需函数即服务平台。它基于企业级 Oracle Cloud Infrastructure 构建，由 Fn 项目开源引擎提供支持。OCI 功能的无服务器和弹性体系结构意味着您无需执行基础设施管理或软件管理。OCI Functions 可使用 Java、Python、Node、Go、Ruby 和 C# 编写代码（对于高级用例，请自备 Dockerfile 和 Graal VM）。然后，您可以部署代码、直接调用代码或触发代码以响应事件，并且仅对执行过程中使用的资源计费。您可以使用控制台、CLI 和 REST API 访问 OCI 函数。可以使用 CLI 或发出签名的 HTTP 请求来调用部署到 OCI 函数的功能。OCI 函数与 Oracle Cloud Infrastructure Identity and Access Management (IAM) 集成，可提供具有本机 Oracle Cloud Infrastructure 身份功能的轻松验证。

  • 事件

    在 Oracle Visual Builder Studio 实例发出事件时执行的操作。可以使用 Oracle Cloud 控制台定义在发生事件时触发特定操作的规则。通过 Oracle Cloud Infrastructure Events，您可以基于整个租户中资源的状态更改创建自动化。使用“事件”允许开发团队在资源更改其状态时自动响应。例如，可以定义一个规则，在有人创建、删除或更新实例时向管理员发送通知。

  • 项目

    项目是 VB Studio 功能的集合。您可以使用项目托管源代码文件、跟踪问题、协作编写代码、构建和部署应用。一个项目可以托管多个 Git 资料档案库。每个 Git 资料档案库可以有多个分支和数百个代码文件。您可以为 Git 资料档案库的每个分支创建合并请求，并要求审核者查看代码。您可以创建和配置多个构建作业来生成可以部署到 Oracle Cloud 或内部部署 Web 服务器的不同项目构件。

  • Git 资源库

    源代码管理 (SCM) 和分布式版本控制工具到主机源代码文件。

  • 代码复核和合并请求

    将 Git 资料档案库分支与其他分支合并的方法。在合并分支之前，团队成员可以查看两个分支的文件之间的差异并提供反馈。

  • 连续集成 (CI) 和连续交付 (CD) 管道

    连续集成是一组练习，允许开发团队实施小代码更改并将代码频繁推送到 Git 等控制资料档案库版本。持续交付的做法让开发人员能够在短时间内生成软件。

  • 虚拟云网络 (VCN) 云服务

    VCN 是您在 Oracle Cloud Infrastructure 区域中设置的可定制软件定义网络。与传统数据中心网络一样，VCN 允许您完全控制您的网络环境。一个 VCN 可以具有多个不重叠的 CIDR 块，您可以在创建 VCN 后对其进行更改。您可以将 VCN 细分为多个子网，这些子网可以限定到区域或可用性域。每个子网包含一系列不与 VCN 中的其他子网重叠的连续地址。创建后可以更改子网的大小。子网可以是公共子网，也可以是专用子网。

  • 数据资料档案库（使用 Oracle Autonomous Transaction Processing）

    Oracle Autonomous Transaction Processing 是一项自治驱动、自我保护和自我修复的数据库服务，针对事务处理负载进行了优化。您不需要配置或管理任何硬件，也不需要安装任何软件。Oracle Cloud Infrastructure 处理数据库创建以及备份、打补丁、升级和优化数据库。

  • Identity Cloud Services (IdCS)

    Oracle Identity Cloud Service 提供创新、完全集成的服务，通过多租户云平台提供所有核心身份和访问管理功能。

  • 审计

    OCI 审计服务自动将支持的所有 OCI 公共 API 端点的调用记录为日志事件。

  • 对象存储

    通过对象存储，可以快速访问任意内容类型的大量结构化和非结构化数据，包括数据库备份、分析数据以及丰富的内容（例如图像和视频）。您可以安全可靠地存储数据，然后直接从互联网或云平台检索数据。您可以无缝扩展存储，而不会降低性能或服务可靠性。将标准存储用于“热”存储，您需要快速、立即和频繁地访问这些存储。将归档存储用于保留很长时间、很少或很少访问的“冷”存储。

使用 Oracle Visual Builder 构建应用程序的步骤

使用 Oracle Visual Builder 开发应用程序时要遵循的基本步骤：

  1. 从独立 Visual Builder 服务或新的集成实例（如果尚未创建）从 Oracle Integration Cloud (OIC) 创建 Visual Builder 服务实例（如果尚未创建）。
  2. 创建新的 Visual Builder 应用程序。
  3. 在 Oracle Visual Builder 中创建新的 Web 应用程序。
  4. 创建页面和公开控件的整体用户界面，例如用于上载文件的按钮、创建新 PDF 文档以及下载更新的文档。
  5. 创建变量和常量以托管从 PDF 文档中提取或包含的信息。
  6. 导入必要的外部资源和库
  7. 开发所需的 JavaScript 代码以：
    • 从本地系统上载文件。
    • 使用输入的文本修改上载的 PDF 文件。
    • 创建新的 PDF 文档。
    • 下载 PDF 文件。
  8. 使用相应的用户和文档测试应用程序。
  9. 暂存和发布 Web 应用程序。

关于必需的服务和角色

此解决方案需要 Oracle Visual Builder 服务以及以下附加服务和相应角色：

服务名：职责 必需至
Oracle Cloud Infrastructure：管理员 管理移动用户、角色和领域。
Oracle Visual Builder：映射到 ServiceDeveloper 应用程序层预定义角色的 Visual Builder Developer 预定义角色。 创建、管理、保护和发布 Web 和移动应用。

要获取所需的云服务，请参阅 了解如何获取 Oracle 解决方案的 Oracle Cloud 服务。