從使用者的視角出發，Orbeon Forms 架構很簡單。 它由 Form Builder（表單編輯器）和 Form Runner（表單執行時）組成，與資料庫（持久層）對話。 此外，與使用者管理系統的整合也是一種常見的場景。

![](https://img-blog.csdnimg.cn/img_convert/1717ea4de7fc1360d3ae425f73beae9b.png)

您已經使用 Form Builder 建立了表單，釋出了這些表單，並設定了 Orbeon Forms，以便它將表單捕獲的資料儲存在您的關聯式資料庫中。 現在，您的另一個應用程式如何訪問這些資料？

![](https://img-blog.csdnimg.cn/img_convert/a5d3c71c7db19fc1a8dada1a600e8b78.png)

有三種設計方式。

- 當使用者單擊表單中的提交按鈕時，讓 Orbeon 表單將資料傳送到您的應用程式。
- 您的應用程式為此呼叫 Orbeon Forms 提供的 REST API。
- 您的應用程式直接訪問 Orbeon Forms 儲存的資料庫中的資料。

下面逐一介紹。

# 方法1. Send data on submit

在大多數情況下，這是最好的選擇，也是我們推薦的選擇。 本質上，您設定 Orbeon Forms，以便當使用者填寫表單並提交時，Orbeon Forms 會將使用者輸入的資料傳送到您的應用程式。 您的應用程式可以使用這些資料做任何它想做的事情，如果需要，在對 Orbeon Forms 的響應中，您的應用程式可以告訴 Orbeon Forms 使用者接下來應該轉到哪個頁面。

![](https://img-blog.csdnimg.cn/img_convert/732c3b4ae08084535c85670540d0d175.png)

當使用者單擊在 Form Builder 中建立的表單上的提交按鈕（或就此而言表單底部的任何其他按鈕）時，將執行一個流程。 本質上，一個流程定義了一系列要執行的操作，其中之一可以是將資料傳送到您的應用程式。

目前，流程定義在您的 properties-local.xml 中。

在您的流程中，您將使用 send() 操作來指示 Orbeon Forms 將使用者輸入的資料釋出到您選擇的 URL。

你的應用程式可以用它接收的資料做它想做的事情：在資料庫中執行一些操作，呼叫服務等。

如果您將 replace = "all" 引數傳遞給 send()，那麼您的應用程式在 HTTP 響應中傳送回 Orbeon Forms 的內容將被 Orbeon Forms 傳送/代理回瀏覽器。

這允許您傳送自定義確認頁面，或重定向到使用者接下來應該轉到的另一個頁面或表單。

![](https://img-blog.csdnimg.cn/img_convert/20ad319e16121617bcc7ab906b8c00ce.png)

# 方法2. Call the REST API

您的第二個選擇是讓您的應用程式呼叫 Orbeon Forms 永續性 API 來檢索 Orbeon Forms 儲存在資料庫中的資料。 這是一個簡單的 REST API，您需要首先呼叫搜尋 API 以列出使用特定表單提交或儲存的資料，然後呼叫 CRUD API 以檢索您感興趣的任何資料。

![](https://img-blog.csdnimg.cn/img_convert/1dbe9ae0b1919c7c87e2e692863d46cb.png)

如前所述，Orbeon Forms 提供的 API 非常簡單，但在呼叫此類 API 時需要記住一些複雜情況，這通常會使上述選項 1 更可取：

- 您正在決定何時呼叫 API。您很可能希望定期（例如每小時或每天）執行此操作，以處理提交給系統的任何新資料。這意味著您需要有一個類似 cron 的基礎設施來定期執行該任務，並且您的應用程式不會實時瞭解新資料。

- 假設您的應用程式只對處理新資料感興趣，它需要以某種方式跟蹤它已經處理的資料。

- 出於安全原因，開箱即用的 REST API 訪問被阻止。您可以在 Orbeon Forms 級別完全開放對 API 的訪問，並通過其他方式（例如過濾器）保護它，或者通過授權服務在 API 的呼叫者和 Orbeon Forms 之間設定一些身份驗證。

# 方法3. Accessing the database

根據上述選項 2，訪問資料庫中的資料而不是通過 API 會增加升級 Orbeon Forms 時需要更改程式碼的可能性，因為 Orbeon 表的格式比 API 更可能更改。 儘管有此警告，但我們發現客戶訪問資料庫中的資料通常比通過 API 訪問更實用。

![](https://img-blog.csdnimg.cn/img_convert/7a094eb2836b47a76ab517a5643c582c.png)

orbeon form 的架構簡介 - 如何訪問使用者通過 form 儲存的資料

相關文章