易企办允许用户通过HTTP请求调用Web服务与第三方系统集成。使用表单操作中的HTTP请求步骤,用户可以轻松从外部系统检索数据或将数据从易企办发送到第三方API。
在本指南中,我们将演示如何创建一个表单操作,通过调用易企办的Restful API从数据列表查询数据并在批准表单上显示结果。
1.设置表单
首先,打开批准表单的表单设计器。按照以下步骤设置必要的控件:
1.1 添加表单控件
从左侧控件面板拖放一个单行控件到表单上。将字段ID更改为“field_ItemID”,字段名称更改为“项目 ID”。
接下来,向表单添加一个多行控件。将字段ID更改为“field_ItemContent”,字段名称更改为“项目内容”。在此控件的属性设置面板中,展开验证组并打开只读设置。
1.2 添加按钮控件
现在,向表单添加一个按钮控件,并将其显示文本设置为“获取列表项数据”。自定义此按钮的样式以匹配表单的设计。
2.创建“HTTP请求”表单操作
2.1 打开操作管理窗口
单击表单设计器右上角的“动作”按钮,打开操作管理窗口。
2.2 添加“HTTP请求”表单操作
单击“+ 新建动作”按钮创建新的表单操作。将此操作的名称更改为“HTTP请求”。
2.3 添加HTTP请求步骤
单击“+ 添加步骤”按钮,并从步骤类型弹出窗口中选择“HTTP请求”。
3.配置HTTP请求步骤
3.1 获取API URL
要通过ID查询数据列表项,我们将调用易企办的“按ID获取项” API。您可以在易企办 API文档中找到此API的URL:
从Get API method中复制API方法:
3.2 配置HTTP请求步骤
回到表单设计器,展开HTTP请求步骤的设置面板。在“HTTP地址”字段中,点击编辑器图标以打开表达式编辑器。从顶部工具栏中点击“文本”按钮并粘贴复制的API方法。
将{appID}替换为固定值41。{listID}是我们要从中查询数据的数据列表的唯一ID,可以在应用设置页面找到。在此示例中,我们将使用“任务管理”数据列表来查询其中一个项。
对于{id}参数,我们想要使用单行控件“Item ID”的值,因此将{id}参数替换为工作流变量:“Item ID”。
点击“确定”按钮关闭表达式编辑器窗口。
从方法下拉列表中选择“GET”。对于“请输入验证信息”,选择“YeeOffice内部服务”。
接下来,从结果字段中选择“流程变量:项目内容”,以将返回的值保存到之前添加的多行控件中。
点击“保存”按钮保存此HTTP请求步骤的设置。
4.将操作绑定到按钮
选择表单上的“获取列表项数据”按钮,打开属性设置面板。在内容选项卡中,展开动作组,并从下拉列表中选择“HTTP请求”操作。
5.测试功能
现在,您可以单击“预览”按钮测试功能。在“Item ID”文本框中输入所需的列表项ID。可以从每个数据项的ID字段中找到项目ID。
然后,单击“获取列表项数据”按钮。查询的项目数据将显示在“Item Content”文本区域控件中。
通过易企办的表单操作和HTTP请求步骤,用户可以无缝地调用Web服务,访问外部数据并与第三方系统集成。通过利用这一强大功能,组织可以实现增强的数据跟踪,更好的集成和改进其易企办应用程序中的工作流程。
发挥表单操作的潜力,提升您的自动化能力,利用易企办的多功能平台。