本教程将实现表单自动加载CRM客户列表,并自动填充客户信息功能。员工在提交表单时,通过输入客户名称关键字实现客户检索,客户列表将填充到表单的单选列表,当用户选择某一具体客户后,到CRM中查询该客户的详细信息,并将信息填充到当前表单的相应字段。
教程说明
本例中涉及到两个外部接口:
根据名字模糊搜索客户:入参为客户名,出参为客户列表信息。
根据客户ID获取客户详情:入参为客户id,出参为客户详情信息。
前提条件
在开始本教程前,确保你已经完成了以下准备工作:
已经完成了钉钉开发者的注册与激活并拥有了子管理员和开发者权限。若尚未完成,请参考成为钉钉开发者。
已经成为钉钉专业版用户,若未完成,请参考钉钉专业版。
已完成连接器和执行动作的创建,若未完成,详情请参考创建连接器和配置连接器。
新建审批单
在表单设计界面,添加流程表单必要参数。
搜索客户:单行输入框,用户输入客户名称关键字。
客户列表:单选框,用户接收外部数据源的客户列表。
客户名称:单行输入框,用于接收外部数据源中客户的名称。
手机号:单行输入框,用于接收外部数据源中客户的手机号。
年龄:单行输入框,用于接收外部数据源中客户的年龄。
新建搜索客户列表连接器实例
在表单设计界面,单击连接器,然后单击配置连接器。
在配置连接器界面设置触发条件下,选择控件值发生变化时,绑定触发事件的控件并确定,单击下一步。
在配置连接器界面选择连接器下,依次选择相应的连接器和执行动作,然后单击下一步。
在配置连接器界面配置执行动作下,填写控件的值用于获取数据,并设置获取的数据填充到控件。
客户列表.选项列表.ID列表:表示选项的key,类似于身份证号码,每一个选项的key唯一,不展示。
客户列表.选项列表.值列表:表示选项展示的值,可重复。
单击保存后,在表单设计界面可看到已配置的执行动作。
新建查询客户信息连接器实例
在表单设计界面,单击连接器,然后单击配置连接器。
在配置连接器界面设置触发条件下,选择控件值发生变化时,绑定触发事件的控件并确定,单击下一步。
在配置连接器界面选择连接器下,依次选择相应的连接器和执行动作,然后单击下一步。
在配置连接器界面配置执行动作下,填写控件的值用于获取数据,并设置获取的数据填充到控件。
说明
在新建搜索客户列表连接器实例中已经把customerId映射到客户列表.选项列表.ID列表,这样就可以获取客户列表.ID的值。
客户列表.ID:表示获取客户列表单选框选中后的ID值。
配置完成后,单击发布,发布当前流程表单。