微信咨询

微信咨询

13610*910*9

服务热线 7*24小时

电话咨询

【API操作】明道云API筛选介绍与快速取值方案(FilterType有更新)

iamdu2025-02-17 14:41:37 浏览: 2489

随着客户深入使用明道云,与数据的供给第三方集成或显示。工作表的 API 被越来越多的客户使用。数据对外是需要提取筛选有效数据。API 接口筛选器已经开放出来。但是对于使用赋值,大多客户却是一头雾水。
  小编这里就讲解下筛选器的字段说明以及快速取值方案。(快速取值方案不需要了解字段具体的含义,小白直接上手使用 😄 )

筛选器

参数必填类型说明
controlIdstring控件 ID
dataTypenumber控件类型编号
spliceTypenumber拼接方式,1:And 2:Or
filterTypenumber筛选类型,枚举值 FilterTypeEnum
valueslist[string]根据筛选类型,传多个值,传特殊 AccountID
valuestring根据筛选类型,传单个值,传特殊 AccountID
dateRangenumber日期范围,枚举值 DateRangeEnum
dateRangeTypenumber日期范围类型,1:天 2:周 3:月 4:季 5:年
minValuestring最小值
maxValuestring最大值
isAscbool是否升序(false:降序)
示例
"controlId":"ordernumber"
"dataType":6
"spliceType":1
"filterType":13
"value":"2"
}

FilterTypeEnum

枚举值枚举字符说明
0Default
1Like包含
2Eq是(等于)
3Start开头为
4End结尾为
5NContain不包含
6Ne不是(不等于)
7IsNull为空
8HasValue不为空
11Between在范围内
12NBetween不在范围内
13Gt>
14Gte>=
15Lt<
16Lte<=
17DateEnum日期是
18NDateEnum日期不是
21MySelf我拥有的
22UnRead未读
23Sub下属
24RCEq关联控件是
25RCNe关联控件不是
26ArrEq数组等于
27ArrNe数组不等于
31DateBetween在范围内
32DateNBetween不在范围内
33DateGt>
34DateGte>=
35DateLt<
36DateLte<=
37DateEq日期是(到秒)
38DateLte日期不是(到秒)
41NormalUser常规用户
42PortalUser外部门户用户
51EqRadio是单选
52NeRadio不是单选

DateRangeEnum

枚举值枚举字符说明
0Default
1Today今天
2Yesterday昨天
3Tomorrow明天
4ThisWeek本周
5LastWeek上周
6NextWeek下周
7ThisMonth本月
8LastMonth上月
9NextMonth下月
10LastEnum上..
11NextEnum下..
12ThisQuarter本季度
13LastQuarter上季度
14NextQuarter下季度
15ThisYear本年
16LastYear去年
17NextYear明年
18Customize自定义

特殊 AccountID

ID说明
user-self当前用户
user-sub下属
user-workflow工作流
user-apiAPI

DataType 就是控件类型 ControlType

public enum ControlType
   {
       /// <summary>
       /// 单行文本
       /// </summary>
       [Description("文本框")]
       Text =1,
       /// <summary>
       /// 多行文本
       /// </summary>
       [Description("文本框")]
       TextArea =2,
       /// <summary>
       /// 手机号
       /// </summary>
       [Description("手机")]
       MobilePhone =3,
       /// <summary>
       /// 座机号
       /// </summary>
       [Description("座机")]
       Landline =4,
       /// <summary>
       /// 电子邮箱
       /// </summary>
       [Description("邮件地址")]
       Email =5,
       /// <summary>
       /// 数值
       /// </summary>
       [Description("数值")]
       Number = 6,
       /// <summary>
       /// 证件
       /// </summary>
       [Description("证件")]
       Certificates =7,
       /// <summary>
       /// 金额
       /// </summary>
       [Description("金额")]
       Amount =8,
       /// <summary>
       /// 单选框
       /// </summary>
       [Description("单选")]
       Radio =9,
       /// <summary>
       /// 多选框
       /// </summary>
       [Description("多选")]
       CheckBox =10,
       /// <summary>
       /// 下拉框
       /// </summary>
       [Description("单选")]
       Select =11,
       /// <summary>
       /// 人员单
       /// </summary>
       [Description("成员")]
       Personnel = 12,
       /// <summary>
       /// 人员多
       /// </summary>
       [Description("成员")]
       People =13,
       /// <summary>
       /// 附件
       /// </summary>
       [Description("附件")]
       Attachment =14,
       /// <summary>
       /// 日期
       /// </summary>
       [Description("日期")]
       Date =15,
       /// <summary>
       /// 日期时间
       /// </summary>
       [Description("日期和时间")]
       DateTime =16,
       /// <summary>
       /// 日期段
       /// </summary>
       [Description("日期段")]
       DateSpan =17,
       /// <summary>
       /// 日期时间段
       /// </summary>
       [Description("日期时间段")]
       DateTimeSpan =18,
       /// <summary>
       /// 地区(省)
       /// </summary>
       [Description("地区(省)")]
       District1 = 19,
       /// <summary>
       /// 公式
       /// </summary>
       [Description("公式")]
       Formula =20,
       /// <summary>
       /// 关联到
       /// </summary>
       [Description("自由连接")]
       Relation = 21,
       /// <summary>
       /// 分割线(无编辑行为)
       /// </summary>
       [Description("分段")]
       SplitLine =22,
       /// <summary>
       /// 地区(省市)
       /// </summary>
       [Description("地区(省-市)")]
       District2 = 23,
       /// <summary>
       /// 地区(省市县)
       /// </summary>
       [Description("地区(省-市-县)")]
       District3 = 24,

       /// <summary>
       /// 大写金额
       /// </summary>
       [Description("大写金额")]
       BigAmount = 25,

       /// <summary>
       /// 人员选择
       /// </summary>
       [Description("成员")]
       UserSelect = 26,

       /// <summary>
       /// 部门选择
       /// </summary>
       [Description("部门")]
       DepartmentSelect = 27,

       /// <summary>
       /// 评分控件
       /// </summary>
       [Description("等级")]
       Score =28,

       /// <summary>
       /// 连接他表
       /// </summary>
       [Description("表关联")]
       RelationWorksheet = 29,

       /// <summary>
       /// 他表字段
       /// </summary>
       [Description("关联表字段")]
       RelationWSColumn = 30,

       /// <summary>
       /// 工作表公式(其他模块可调用)
       /// </summary>
       [Description("公式")]
       WSFormula = 31,

       /// <summary>
       /// 文本拼接
       /// </summary>
       [Description("文本组合")]
       FormulaString = 32,

       /// <summary>
       /// 自动编号
       /// </summary>
       [Description("自动编号")]
       Increase = 33,

       /// <summary>
       /// 子表
       /// </summary>
       [Description("子表")]
       DetailTable = 34,

       /// <summary>
       /// 级联选择
       /// </summary>
       [Description("级联选择")]
       Cascade = 35,

       /// <summary>
       /// 检查框
       /// </summary>
       [Description("检查框")]
       CheckRadio = 36,

       [Description("汇总")]
       Summary = 37,

       [Description("公式(日期)")]
       FormulaDate = 38,

       [Description("扫码")]
       ScanCode = 39,

       [Description("定位")]
       Location = 40,

       [Description("富文本")]
       RichText = 41,

       [Description("签名")]
       Signature = 42,

       //////////////////////////////////////以下放只读控件////////////////////////////////////////////////////
       /// <summary>
       /// 申请人
       /// </summary>
       RO_Applicant =10001,
       /// <summary>
       /// 申请日期
       /// </summary>
       RO_ApplyDate =10002,
       /// <summary>
       /// 所属部门
       /// </summary>
       RO_Department =10003,
       /// <summary>
       /// 职位
       /// </summary>
       RO_Position = 10004,
       /// <summary>
       /// 工作地点
       /// </summary>
       RO_WorkPlace =10005,
       /// <summary>
       /// 公司
       /// </summary>
       RO_Company =10006,
       /// <summary>
       /// 工作电话
       /// </summary>
       RO_WorkPhone=10007,
       /// <summary>
       /// 移动电话
       /// </summary>
       RO_MobilePhone =10008,
       /// <summary>
       /// 工号
       /// </summary>
       RO_JobNumber =10009,
       /// <summary>
       /// 备注
       /// </summary>
       [Description("备注")]
       RO_Remark = 10010,

   }

有一些用不到 ,用到的有:2,3,4,5,6,7,8,9,10,11,14,15,16,19,23,24,26,27,28,29,30,31,32,33,34,35,36,37,38

快速取值方案

浏览器 F12 找到 Network –> 点击 XHR–》找到 GetFilterRows–> 点击–> 点击【Header】–> 找到 Request Payload 展开 –> 复制出 filterControls 的内容–> 放到 API 筛选器的 filters 中。具体步骤如下图:

欢迎留下你的看法

共 0 条评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注