一、前言

作為售前顧問，幫助客戶選型低代碼產品是日常工作。考察一家低代碼產品的好壞，其中一個維度就是產品的成熟度。產品成熟度直接影響產品在使用中的穩定性和用戶體驗，對于新工具導入和可持續運用至關重要。

那怎么考察一個產品是否成熟呢？我經常會跟客戶講，一看時間，即上市有多長時間，二看迭代，即多長時間發布新版本，三看“邊角功能”。前兩點相信大家一看就明白，那什么是“邊角功能”？我們說，看某家人是否愛干凈會收拾，應該去看墻角旮旯是否有積塵。同樣道理，我們看某個產品是否覆蓋到了一些貌似邊緣的功能，也能窺出這一產品成熟度。其中邏輯是，只有產品發展到較為成熟的階段時產研團隊才有條件給那些看起來不那么核心的需求予資源投入的優先級。相反，一款早期產品肯定是忙于把核心功能先打造出來，再去顧及非核心功能和需求。

就Mendix來講，它誕生于2005年，至今18年的發展歷程，在低代碼賽道不可謂不“老資歷”。迭代方面，2-4周一個小版本，1-2個月一個中版本，相較同行也保持著快速進化。“邊角功能”也有很多，斷點調試便是其中代表。Mendix Studio Pro很早開始支持本地加斷點甚至條件斷點，進行類似傳統IDE的開發調試，給予開發者更完整的用戶體驗。

本文要介紹的基礎審計模塊可以說是體現Mendix產品成熟度的另一個“邊角功能”。即使是Mx 圈老人也未必聽過或者詳細了解這個模塊的使用，然而在某些業務場合它能短平快地解決問題。

二、需求分析

筆者親身經歷的客戶提到以下兩類業務需求：

Case 1: 某制藥企業，希望選擇一款低代碼產品滿足規劃中的某創新藥研發的項目管理。其中涉及設備、樣品、試驗、巡檢、人員、財務等多方面，且項目耗時預計5～10年，過程中會出現更多不可知的應用需求。然而有一點明確的，制藥企業的某些領域軟件應用，比如試驗、制造，必須滿足FDA（該企業在美國有研發團隊且產品投放海外）和國內NMPA關于過程規范的要求GXP（Good Practices），其中一條要求所有系統內操作必須留有完整的原始記錄，且可導出備查，以確保藥品研制過程可審計和審查。因此，該企業對低代碼產品也提出開發出的應用能記錄核心對象的變更記錄的需求。

Case 2: 某大型流通企業，希望用低代碼快速實現過去在Excel上管理的某些應用。比如，曾經幾千人在Excel中協作目標管理，從目標提出、修改、審批、跟進、更新、回顧到關閉整個過程可能有多人在不同時間點對記錄進行增刪改查。Excel的痛點之一便是無法跟蹤誰做了何種修改。因此，負責人希望上線低代碼應用后能清晰記錄以上事件，包含明確的什么人在什么時間對哪個對象做了何種（增刪改）操作，事件記錄可導出。

Case 1和Case 2分別是行業規范和 IT系統規范的典型體現，需求類似，在Mendix 平臺上都能得到滿足，用的就是Mendix 基礎審計模塊。

三、模塊解析

在Studio Pro中搜索并下載基礎審計 Audittrial 模塊。

在Marketplace Module 下出現新加入模塊。

我們來分析一下本模塊的實現邏輯。首先是核心實體。

• AudittrailSuperClass實體：審計對象父類，核心實現了Before Commit和Before Delete兩個事件。待審計的業務實體從此AudittrailSuperClass實體繼承創建，獲得兩個觸發事件，業務實體在提交和刪除前執行相關操作。

• Log實體：記錄業務對象的一次變更，包括對象名稱、變更時間、變更成員數量、變更類型、描述等信息。

• LogLine實體：記錄業務對象中單個成員的變更信息，包括成員類型、成員名稱、舊值、新值等信息。

• ReferenceLog 和ReferenceLogLine實體：記錄業務對象涉及關聯對象變更的信息。

模塊中的核心邏輯。

• 微流 BCo_AudittrailSuperClass：通過調用CreateLogRecordOfObject JavaAction記錄業務對象提交入庫時刻的變更信息，返回Log對象。JavaAction中實例化該對象及相關關聯對象。

• 微流BDe_AudittrailSuperClass：通過調用CreateLogRecordChangesBeforeDelete JavaAction記錄業務對象刪除時刻的變更信息，邏輯同上。

在關聯和添加事件的模塊使用方式下，需要復制和簡單調整這兩個微流，添加到待記錄的業務實體。

除此之外，模塊提供頁面和頁面片段Snippeet的樣例，開發者可以直接使用或者添加到目標頁面上，展示審計記錄。

四、實際應用

下面展示基礎審計模塊的一個實際應用。這是一個庫存管理的示例應用，包括物料、工廠和庫存量等幾個基礎實體。我們通過兩種方式分別為工廠和物料添加審計記錄，獲得關于這兩個業務對象的一切變更信息。

繼承的使用方式

針對物料實體，我們通過設置繼承父類為AudittrailSuperClass的方式，直接獲得Before Commit和Before Delete兩個事件的處理邏輯。這是最為簡單的模塊使用方式。

注意事項：當業務實體本身已經繼承自某個實體時，無法直接使用這一方式。如果當前父類沒有再繼承，可以考慮讓該父類繼承AudittrailSuperClass。但請注意Mendix 關于繼承層數的最佳實踐。如果遇到父類是系統實體的情況，無法修改父類，那就要考慮第二種使用方式了。

關聯和添加事件的使用方式

針對工廠實體，我們首先將它和基礎審計模塊的Log實體建立1對多的關聯關系，然后為工廠實體添加Before Commit和Before Delete的事件處理邏輯。這里我們只需要復用模塊下已有的BCo_AudittrailSuperClass和BDe_AudittrailSuperClass兩個微流即可。

復用方式：拷貝兩個微流至業務模塊，給予合適的名字，同時將微流入參對實體類型改為工廠實體。

復用審計查看頁面

本應用中我們直接使用模塊自帶的審計查看頁面，效果已經很不錯。具體做法，將Log_Overview頁面拷貝至業務模塊，設置當前布局模板確保UX一致性，并添加到導航菜單欄。

賦予角色與權限

最后不要忘記，為需要訪問審計頁面的用戶添加合適的角色。基礎審計模塊有兩個角色，差別在于MxAdministrator角色才有查詢關聯對象變更信息的權限。因此，對于想查看業務對象變更時關聯對象變更信息時，需要添加這一角色。

效果展示

首先我們添加一個物料M005，名稱為Basket，當前用戶名是demo_user

打開審計頁面，我們看到該變更已經被記錄，包括變更人、變更時間和變更詳情。

然后我們修改工廠實體，經理由demo_user變更為Tom.

打開審計頁面，我們同樣看到變更被記錄。

這里需要注意的是，變更的經理字段并未在這個頁面的表格中顯示出來，在新值上顯示為reference changed。這是因為manager屬性是來自system.user這一關聯對象。其變更信息的顯示需要用到前面介紹的ReferenceLog和ReferenceLogLine兩個實體，并在其他頁面上展示。這時候選中該行，點擊View，我們就能看到此關聯實體的變更信息了。

至此，我們看到兩種使用方式下達到了同樣的預期效果。

在審計頁面點擊切換到表格視圖，我們可以看到所有業務對象的變更記錄，并且可以進行實體名、變更日期、變更人、變更類型的篩選，最后導出為Excel或CSV格式，用于歸檔或外部審閱。

此外，模塊提供一些配置參數，允許開發者自行設定變更記錄的類型和時間戳時區和格式等。詳情請查看配置頁面說明文字，非常清晰。

五、總結與展望

本文介紹了Mendix官方的基礎審計模塊。審計是一個重要但一般低代碼產品可能忽略的長尾功能，利益于Mendix早些年在金融行業客戶（如荷蘭RaboBank、蘇黎世保險、加拿大BDC等）的應用，這一需求很早就在產品中得到覆蓋。這恰恰是前言中所說產品成熟度的重要標志。模塊提供兩種使用方式，且很容易復用內部頁面，上手簡單，是項目實戰中的好幫手。該模塊已經發布到9.1版本，用戶眾多，在Marketplace 上收獲了大量的正向用戶反饋。

使用該模塊時，也有些注意事項，比如性能方面。考慮到變更記錄的邏輯觸發在業務對象提交入庫或刪除的時間點，如果需要審計的實體很多，并且變更非常頻繁，可能帶來較多的延時以及審計數據量劇增的情況。以及某些情況下需要更快捷和完善的記錄搜索。為此，Mendix推出了收費版本的高級審計模塊，重新設計了架構，借助Kafka、ElasticSeach、Kibana等開源組件增強了可無限擴展、索引化檢索、外部永久存儲等特點。該模塊已經在美國Johnson&Johnson項目上得到運用，以滿足FDA CFR 21 Part 11 的計算機系統合規要求。

我們將在今后擇機向大家介紹此高級模塊，有需求的小伙伴也可以聯系Mendix熱線獲得更多信息。

六、參考資料

• Mendix Documentation: Audit Trial

• Mendix Marketplace: Advanced Audit Trial

關于Mendix公司

在一個數字化先行的世界中，客戶希望自己的每一項需求都得到滿足，員工希望使用更好的工具來完成工作，而企業意識到自己只有通過全面數字化轉型才能生存并取得成功。Mendix公司，a Siemens business正在迅速成為企業數字化轉型的推動者。其業內領先的低代碼平臺和全方位的生態系統整合最先進的技術，幫助企業創造出提高互動性、簡化操作和克服IT瓶頸的解決方案。Mendix公司以抽象化、自動化、云和協作為四大支柱，大幅提升開發者的生產力，并且依靠自己的工程協作能力和直觀的可視化界面，幫助大量不熟悉技術的“公民”開發者在他們所擅長的領域創建應用程序。Mendix公司是權威行業分析師眼中的領導者和遠見者，也是一個云原生、開放、可擴展、敏捷和飽經考驗的平臺。從人工智能和增強現實，到智能自動化和原生移動，Mendix公司已成為數字化先行企業的骨干。Mendix公司企業低代碼平臺已被全球4000多家領先的公司采用。