ONLYOFFICE 表單可以輕松收集結(jié)構(gòu)化輸入，但空的、非必填字段經(jīng)常會(huì)被忽略。在本篇博文中，我們將演示如何構(gòu)建一個(gè)宏，用于突出顯示表單中所有空的、非必填字段，或者僅突出顯示包含特定提示文本的字段。

ONLYOFFICE Docs 最新下載

構(gòu)建宏

1. 檢索表單數(shù)據(jù)和實(shí)時(shí)表單對(duì)象

該宏首先使用 Api.GetDocument() 訪問(wèn)活動(dòng)文檔。然后，我們檢索兩組信息：

• 表單數(shù)據(jù)：使用 doc.GetFormsData()，我們獲取所有表單字段的 JSON 表示。此 JSON 包含諸如鍵、類(lèi)型、值、提示以及字段是否必填等屬性。
• 活動(dòng)表單對(duì)象：我們使用 doc.GetAllForms() 來(lái)檢索與這些表單字段對(duì)應(yīng)的活動(dòng)對(duì)象。

    var doc = Api.GetDocument();
    var forms = doc.GetAllForms();
    var formsData = JSON.parse(JSON.stringify(doc.GetFormsData()));

2. 可選的基于提示的驗(yàn)證

有時(shí)您可能只想檢查那些帶有特定提示文本的空字段。在我們的宏中，您可以通過(guò)切換 checkSpecificTip 變量來(lái)啟用或禁用此功能。例如，您可能需要只驗(yàn)證提示為“請(qǐng)輸入您的第二個(gè)地址”的字段。

   // Optional: set to true to check only fields with a specific tip text.
    var checkSpecificTip = false;
    var requiredTipText = "Please enter your second address"; // Change this as needed.

3. 循環(huán)遍歷每個(gè)表單字段

然后，該宏會(huì)遍歷 JSON 數(shù)據(jù)中的每個(gè)表單字段。我們只關(guān)注文本表單字段（類(lèi)型為“text”）。對(duì)于每個(gè)未標(biāo)記為必填的文本字段，我們會(huì)檢查其值是否為空。

forms.forEach(function(form) {
        if (form.GetFormType() === "textForm") {
            var key = form.GetFormKey();
            var required = form.IsRequired()
            // Find corresponding form data by key.
            var formData = formsData.find(function(fd) {
                return fd.key === key;
            });
            if (formData) {
                // A field is considered empty if its value is missing or only whitespace.
                var isEmpty = !formData.value || formData.value.trim() === "";
                // Use the live form's GetTip() to get the tip (if available).
                var tip = form.GetTipText() ? form.GetTipText() : "";
                
                var shouldCheck = !checkSpecificTip || (checkSpecificTip && tip.trim() === requiredTipText.trim());


                if (shouldCheck && isEmpty && !required) {
                    form.SetBorderColor(0,255,127); // spring green border.
                    form.SetBackgroundColor(171, 242, 255); // Light blue background.
                    invalidCount++;
                }
            }
        }
    });

• 檢查字段值：
  如果字段的 JSON“值”屬性缺失或僅存在空格，則該字段被視為空。
• 提示過(guò)濾：
  如果啟用了 checkSpecificTip，我們只檢查提示與 requiredTipText 匹配的字段。
• 高亮：
  對(duì)于符合條件的字段，我們找到對(duì)應(yīng)的實(shí)時(shí)表單對(duì)象（通過(guò)匹配鍵），并設(shè)置春綠色邊框和淺藍(lán)色背景。

4.記錄結(jié)果

最后，宏記錄突出顯示的空的不需要的文本字段的總數(shù)。

console.log("Form Field Validator complete. " + invalidCount + " empty unrequired text field(s) highlighted.");

完整的宏代碼

(function () {
    // Optional: set to true to check only fields with a specific tip text.
    var checkSpecificTip = false;
    var requiredTipText = "Please enter your second address"; // Change this as needed.


    var doc = Api.GetDocument();
    var forms = doc.GetAllForms();
    var formsData = JSON.parse(JSON.stringify(doc.GetFormsData()));
    var invalidCount = 0;



    forms.forEach(function(form) {
        if (form.GetFormType() === "textForm") {
            var key = form.GetFormKey();
            var required = form.IsRequired()
            // Find corresponding form data by key.
            var formData = formsData.find(function(fd) {
                return fd.key === key;
            });
            if (formData) {
                // A field is considered empty if its value is missing or only whitespace.
                var isEmpty = !formData.value || formData.value.trim() === "";
                // Use the live form's GetTip() to get the tip (if available).
                var tip = form.GetTipText() ? form.GetTipText() : "";
                
                var shouldCheck = !checkSpecificTip || (checkSpecificTip && tip.trim() === requiredTipText.trim());


                if (shouldCheck && isEmpty && !required) {
                    form.SetBorderColor(0,255,127); // spring green border.
                    form.SetBackgroundColor(171, 242, 255); // Light blue background.
                    invalidCount++;
                }
            }
        }
    });
    console.log("Form Field Validator complete. " + invalidCount + " empty unrequired text field(s) highlighted.");
})();

現(xiàn)在，讓我們運(yùn)行宏并看看它是如何工作的！

此宏會(huì)自動(dòng)檢測(cè)并高亮顯示包含預(yù)定義占位符文本的空文本字段，從而節(jié)省時(shí)間并減少重復(fù)工作。我們希望它能夠幫助您優(yōu)化 ONLYOFFICE 表單并提升整體工作流程效率。

關(guān)于慧都科技：

慧都科技是一家行業(yè)數(shù)字化解決方案公司，長(zhǎng)期專(zhuān)注于軟件、油氣與制造行業(yè)。公司基于深入的業(yè)務(wù)理解與管理洞察，以系統(tǒng)化的業(yè)務(wù)建模驅(qū)動(dòng)技術(shù)落地，幫助企業(yè)實(shí)現(xiàn)智能化運(yùn)營(yíng)與長(zhǎng)期競(jìng)爭(zhēng)優(yōu)勢(shì)。在軟件工程領(lǐng)域，我們提供開(kāi)發(fā)控件、研發(fā)管理、代碼開(kāi)發(fā)、部署運(yùn)維等軟件開(kāi)發(fā)全鏈路所需的產(chǎn)品，提供正版授權(quán)采購(gòu)、技術(shù)選型、個(gè)性化維保等服務(wù)，幫助客戶實(shí)現(xiàn)技術(shù)合規(guī)、降本增效與風(fēng)險(xiǎn)可控。慧都科技ONLYOFFICE在中國(guó)的官方授權(quán)代理商，提供ONLYOFFICE系列產(chǎn)品免費(fèi)試用，咨詢，正版銷(xiāo)售等于一體的專(zhuān)業(yè)化服務(wù)。ONLYOFFICE是文檔在線編輯領(lǐng)域的優(yōu)秀產(chǎn)品，幫助企業(yè)實(shí)現(xiàn)高效的文檔協(xié)同處理。

下載|體驗(yàn)更多ONLYOFFICE產(chǎn)品，請(qǐng)咨詢，或撥打產(chǎn)品熱線：023-68661681