如何通过自定义连接器实现ComboBox的后端搜索功能？

问题原因 #

Office365User连接器的SearchUser属于非行为函数，可直接绑定到ComboBox的Items这类数据源属性；但自定义连接器生成的SearchCategory默认是行为函数，仅能在OnSelect、OnTextChange这类行为事件中调用，直接绑定Items就会触发「Behavior function in a non-behavior property」错误。

解决方案 #

方案1：文本变化事件+变量实时更新

1. 初始化全局变量：在App的OnStart事件中添加 Set(varCategoryResults, []);，创建一个空集合
2. 配置ComboBox的OnTextChange事件：

   Set(varCategoryResults, MyConnector.SearchCategory({keyword: Self.SearchText}));
   

3. 将ComboBox的Items属性设置为 varCategoryResults

用户每输入一个字符，就会触发API调用并更新下拉列表内容。

方案2：防抖优化（减少频繁API请求）

如果实时搜索会导致过多API调用，可添加计时器实现防抖逻辑：

1. 插入计时器控件Timer1，设置以下属性：
   • Duration：500（单位毫秒，可根据需求调整）
   • AutoStart：false
   • Repeat：false
   • OnTimerEnd：

     Set(varCategoryResults, MyConnector.SearchCategory({keyword: ComboBox1.SearchText}));
     

2. 配置ComboBox的OnTextChange事件：

   Reset(Timer1); Timer1.Start();
   

3. 同样将ComboBox的Items属性设为 varCategoryResults

用户输入停止后，等待指定时长才会调用API，避免频繁请求。

注意事项 #

• 如果自定义连接器返回的是复杂对象，可能需要在Items中用ShowColumns或AddColumns提取需要显示的字段，例如 ShowColumns(varCategoryResults, "CategoryName", "CategoryId")
• 确保自定义连接器的API支持根据keyword参数返回正确的搜索结果，不存在权限或参数格式问题

内容的提问来源于stack exchange，提问作者becory