1. 開發修改 PDF 文件的 Web 應用程式
  2. 開發可修改 PDF 文件的 Web 應用程式

開發可修改 PDF 文件的 Web 應用程式

Oracle Visual Builder 提供工具和範本，可讓您建置 Web 應用程式，使用外部 JavaScript 程式庫來建立、更新及下載 PDF 文件。

應用程式使用者可在許多環境定義中使用、修改及產生 PDF 文件，供各種用途使用。通常，應用程式必須讀取已上傳的 PDF 文件，而且此文件的內容會相應地變更。應用程式可以在 PDF 上執行的一些常見變更可能包括：
  • 新增新的文字。
  • 在文件的某個部份周圍畫一個矩形。
  • 在不同頁面中分割 PDF。
  • 插入圖像。
在某些情況下，必須從頭開始建立新的 PDF 文件，並填入由應用程式產生的資訊。

此解決方案提供在 Web 和行動視覺化產生器應用系統上導入 PDF 修改功能的必要指引。其中說明如何開發一頁式網頁應用程式，讓使用者可以上傳或建立新的 PDF 檔案、使用自訂文字修改此文件，然後在應用程式的主要頁面上顯示該文件。如有必要，應用程式也會允許使用者將檔案下載至其本機用戶端儲存庫。

GitHub 儲存區域 (SampleVBCSModifyingPDFApplication) 包含 Oracle Visual Builder Web 應用程式的原始程式碼，可作為這類實行的範例。您可以從此手冊的「瀏覽更多」段落存取此儲存區域。

開始之前

開發者可以使用 Oracle 的低程式碼視覺化產生器建立 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、漸進式和基本 Web 應用程式。

此架構包含下列元件：
  • Visual Builder Cloud Service

    Oracle Visual Builder Cloud Service 是一種雲端軟體開發「平台即服務」(PaaS)，也是一種代管應用程式開發基礎架構的環境。它提供運用開放原始碼標準的解決方案，能夠在 Oracle Cloud 內開發、協作及部署應用程式。它也提供一個整合的視覺化開發環境，具有靈活的協同合作開發、版本控制及持續交付自動化。藉由吸引人的客製化 UI 強化應用系統，它是透過標準 JavaScript、HTML、CSS 及 REST 提供的可擴充平台。

  • 視覺化產生器軟體
    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 映像檔，或從組建執行程式樣板建立映像檔。Docker 執行程式與 VM 執行程式不同，不會直接與任何特定 VM 相關聯。當貴組織的成員建立工作時，只要將 Docker 映像檔關聯成為該工作的組建樣板即可。當工作的組建觸發程式時，VB Studio 會在任何 Docker 部署 VM 上執行組建。要記住 Docker 映像檔的部分金鑰點：
    • 當您從組建執行程式樣板建立映像檔時，VB Studio 會安裝在該樣板中設定的軟體，以建立新的 Docker 映像檔。當您從登錄建立映像檔時，VB Studio 會從登錄中提取映像檔、新增組建代理程式，以及建立新映像檔。
    • 您可以指定可以從影像建立的執行程式數目上限。
    • 只要管理 VM 的空間足夠，您就可以視需要建立任意數量的 Docker 映像檔。
  • 函數

    Oracle Cloud Infrastructure Functions 是一個完全託管、多租用戶、高度可擴展、隨選、Functions 即服務平台。它建置在企業級 Oracle Cloud Infrastructure 上，並由 Fn Project 開源引擎提供支援。OCI Functions 的無伺服器和彈性架構代表沒有可供您執行的基礎架構管理或軟體管理。OCI Functions，您可以在 Java、Python、Node、Go、Ruby 和 C# 中撰寫程式碼 (若為進階使用案例，可自備 Dockerfile 和 Graal VM)。接著您就可以部署程式碼、直接呼叫程式碼或觸發程式碼以回應事件，並只對執行期間使用的資源計費。您可以使用主控台、CLI 和 REST API 存取 OCI 函數。您可以使用 CLI 或發出簽署的 HTTP 要求，呼叫部署到 OCI 函數的函數。OCI Functions 已與 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. 從獨立視覺化產生器服務或 Oracle Integration Cloud (OIC) 的新整合執行處理 (如果尚未建立) 建立視覺化產生器服務執行處理 (如果尚未建立)。
  2. 新建視覺化產生器應用程式。
  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 服務，以取得您需要的雲端服務。