在本博文中，我们将为您展示如何构建一个宏来导入 CSV/TXT 数据并将其转换为可填充的组合框。

最近，ONLYOFFICE 专家团队实现了 <a href="/blog/?p=26435" target="_blank" rel="noopener">ONLYOFFICE 表单</a>编辑器的功能扩展。ONLYOFFICE 表单专为简化电子文档处理工作而打造，可消除许多冗杂任务。一个不错的例子是使用可填写表单来创建<a href="https://oforms.onlyoffice.com/sale-and-purchase-agreement-form?utm_source=blog&amp;utm_medium=article&amp;utm_campaign=top_10_office_documents" target="_blank" rel="noopener">销售协议</a>模板。但是，如果您将客户信息存储在了单独的 CSV/TXT 文件中，这该怎么办呢？在本博文中，我们将为您展示如何构建一个宏来导入 CSV/TXT 数据并将其转换为可填充的组合框。<img decoding="async" loading="lazy" class="aligncenter wp-image-49519" src="https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1.jpg" alt="Convert CSV and TXT data into a fillable combo box with ONLYOFFICE macro" width="736" height="371" srcset="https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1.jpg 1472w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1-300x151.jpg 300w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1-1024x516.jpg 1024w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1-768x387.jpg 768w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1-634x320.jpg 634w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/Illyustratsiya-v-blog-ONLYOFFICE-Convert-CSV-and-TXT-data-into-a-fillable-combo-1-353x178.jpg 353w" sizes="(max-width: 736px) 100vw, 736px" />

<h2>关于 ONLYOFFICE 表单</h2>
ONLYOFFICE 表单继承了<a href="https://api.onlyoffice.com/docbuilder/textdocumentapi" target="_blank" rel="noopener">文本文档</a>的结构并纳入了多个主要的类：
<ul>
<li>文本字段</li>
<li>组合框</li>
<li>复选框</li>
<li>图片表单</li>
<li>复杂表单</li>
</ul>
这些类中包含允许创建文本字段、组合框、下拉列表、单选按钮、图像表单、邮件地址、电话号码以及复杂字段的方法。
我们将在宏中使用组合框类。组合框元素中包含了我们将从外部 CSV/TXT 文件中导入的下拉列表值。
<img decoding="async" loading="lazy" class="aligncenter size-full wp-image-48055 img-popup" src="https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/text-to-OFORM.png" alt="Convert CSV and TXT data into a fillable combo box with ONLYOFFICE macro" width="736" height="364" srcset="https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/text-to-OFORM.png 736w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/text-to-OFORM-300x148.png 300w, https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/text-to-OFORM-353x175.png 353w" sizes="(max-width: 736px) 100vw, 736px" />
<h2>构建宏</h2>
在我们 <a href="https://api.onlyoffice.com/docbuilder/formapi/api/createcomboboxform" target="_blank" rel="noopener">API 文档</a>的表单部分中介绍了 Api.CreateComboBoxForm 方法。其可使用指定的参数来创建组合框：
<pre class="theme:github font:monospace lang:js decode:true"> var oComboBoxForm = Api.CreateComboBoxForm({"key": "Personal information", "tip": "Choose your country", "required": true, "placeholder": "Country", "editable": false, "autoFit": false, "items": ["Latvia", "USA", "UK"]});
</pre>
items 参数中包含要显示在下拉列表中的值数组。所以，我们的做法是从外部 CSV/TXT 文件中获取值来对此数组进行替换。
不过，首先我们需要获取外部文件并对其中的数据进行处理。这里我们使用了与<a href="/blog/?p=41791" target="_blank" rel="noopener">导入 CSV/TXT 数据宏</a>相似的策略。ONLYOFFICE 宏是基于 JavaScript 的，这就使得其具有极强的通用性，允许我们使用 AJAX 请求：
<pre class="theme:github font:monospace lang:js decode:true ">function LoadFile() {
        $.ajax({
            url: 'file:///C:/Users/LEOPARD/Desktop/Book1.csv',
            dataType: 'text',https://wpblogpost.teamlab.info//wp-admin/post-new.php?lang=en#
        }).done(successFunction);
    }
        LoadFile();
</pre>
现在我们已经获取了文件，下一步就是对原始数据进行处理与格式化。这里我们添加了 succesFunction。其会接收数据并将文本按行拆分为项目数组：
<pre class="theme:github font:monospace lang:js decode:true "> function successFunction(data) {
      var arrAllItems = data.split(/\r?\n|\r/);
}
</pre>
然后我们将目光转回活动文档，使用 items 参数中的 arrAllItems 数组创建组合框：
<pre class="theme:github font:monospace lang:js decode:true "> var oDocument = Api.GetDocument();
 var oComboBoxForm = Api.CreateComboBoxForm({ "key": "Personal information1", "tip": "Choose your country", "required": true, "placeholder": "Country", "editable": false, "autoFit": false, "items": arrAllItems });</pre>
之后我们创建一个段落并在其中加入组合框：
<pre class="theme:github font:monospace lang:js decode:true">  var oParagraph = Api.CreateParagraph();
oParagraph.AddElement(oComboBoxForm);
</pre>
现在我们需要将组合框插入到文档中。这里有好几种方式，不过我们建议使用 InsertContent 方法。其会在光标所在位置插入一个元素。我们同时还建议在参数中对文本和段落属性进行声明。这可防止出现可能的错误和宏问题：
<pre class="theme:github font:monospace lang:js decode:true ">oDocument.InsertContent([oParagraph], { "KeepTextOnly": true });
</pre>
完整的宏代码如下：
<pre class="theme:github font:monospace lang:js decode:true ">(function()
{
   function LoadFile() {
      $.ajax({
          url: 'file:///filePath,
          dataType: 'text',
      }).done(successFunction);
    }
        LoadFile();

   function successFunction(data) {
        var arrAllItems = data.split(/\r?\n|\r/);
        var oDocument = Api.GetDocument();
        var oComboBoxForm = Api.CreateComboBoxForm({ "key": "Personal information", "tip": "Choose your option", "required": true, "placeholder": "Option", "editable": false, "autoFit": false, "items": arrAllItems });
        var oParagraph = Api.CreateParagraph();
oParagraph.AddElement(oComboBoxForm);
oDocument.InsertContent([oParagraph], { "KeepTextOnly": true });
    }
})();
</pre>
现在让我们来运行一下宏，看看效果如何！
<div style="width: 640px;" class="wp-video">
<video class="wp-video-shortcode" id="video-49701-1" width="640" height="334" preload="metadata" controls="controls"><source type="video/mp4" src="https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/importToOformRev.mp4?_=1" /><a href="https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/importToOformRev.mp4">https://static-blog.onlyoffice.com/wp-content/uploads/2022/12/importToOformRev.mp4</a></video></div>
注意！
<ul>
<li>如需插入组合框，请在运行宏后按下空格。</li>
<li>如需在文档中插入多个组合框，请在 Api.CreateComboBoxForm 方法中使用不同的 key 参数。</li>
</ul>
这里的宏只是借助我们的 API 方法可以实现的众多功能之一。我们鼓励各位亲自上手实践，也希望大家能够利用本文中的概念来创建自己的宏。
我们的宏是基于 JavaScript 的，这使得其具有极强的通用性和实用性。欢迎大家随时提问，也欢迎与我们分享您的想法。我们已做好与您探讨和合作的准备。祝您的探索之旅一帆风顺！
<div class="useful-links">
<h3>相关链接</h3>
<a href="https://api.onlyoffice.com/docbuilder/formapi/api/createcomboboxform?utm_source=blog&amp;utm_medium=article&amp;utm_id=combo_box_oforms" target="_blank" rel="noopener">ONLYOFFICE API</a>
<a href="https://oforms.onlyoffice.com/zh/?utm_source=blog&amp;utm_medium=article&amp;utm_id=combo_box_oforms" target="_blank" rel="noopener">OFORM 表单模板库</a>
<a href="/blog/?p=26435" target="_blank" rel="noopener">如何创建可填写的表单</a>
<a href="/blog/?p=27407&amp;utm_source=blog&amp;utm_medium=article&amp;utm_id=combo_box_oforms" target="_blank" rel="noopener">OFORM 和 DOCXF 格式简介</a>
<a href="/blog/?p=41791&amp;utm_source=blog&amp;utm_medium=article&amp;utm_id=combo_box_oforms" target="_blank" rel="noopener">使用 ONLYOFFICE 宏向电子表格中导入 CSV 与文本数据</a>
</div>

借助 ONLYOFFICE 宏将 CSV 与 TXT 数据转换为可填充组合框

最新博文

618限时大促已开启，满额立减拒绝套路！

ONLYOFFICE 协作空间：安全核查清单

2023 夏季 ONLYOFFICE 网络研讨会和国际活动介绍