更新时间:2026-07-13 GMT+08:00
分享

预览视图模型

本文介绍如何预览视图模型。通过预览功能,您可以模拟调用视图模型API,验证接口参数配置及返回结果是否符合业务预期。

约束与限制

  • 如果当前视图模型处于未发布的“正在工作”状态,预览时将默认采用其上一个已发布版本的属性入参。
  • 单个视图模型最多支持配置20个搜索条件和10个排序条件。
  • 每个搜索条件最多支持包含10个值,且单个值的内容长度限制为100个字符。

前提条件

目标视图模型必须至少发布过1次。具体操作请参见发布视图模型

操作步骤

  1. 在左侧导航栏中,选择数据模型管理 > 视图模型,进入“视图模型”页面。
  2. 视图模型列表中,找到目标视图模型,单击其“编码”超链接,进入该视图模型详情页面。
  3. 切换至“预览”页签。
  4. 在左侧的“模拟API-输入参数”区域,配置如下接口请求参数。

    表1 视图模型接口请求参数说明

    参数位置

    参数名称

    参数说明

    Parameters(路径参数)

    pageSize

    页大小(每页显示条数),默认为10。

    仅在“视图配置”中将“是否支持分页”设置为“是”时需要填写。

    curPage

    当前页码,默认为1。

    仅在“视图配置”中将“是否支持分页”设置为“是”时需要填写。

    Body(请求体)

    params

    条件参数根对象,用于聚合所有查询与排序逻辑。

    filter

    过滤条件对象,用于精细化筛选数据。

    joiner

    多个搜索条件间的逻辑连接符,仅支持and(与)或or(或)。

    conditions

    查询条件列表(数组格式),最多支持20个条件。每个条件包含:

    • conditionName:筛选字段名,请填写视图模型中视图字段对应属性的字段名(可前往视图模型详情页查阅对照)。
    • operator:条件操作符(如=、like等)。
    • conditionValues:查询条件值数组。每个条件最多支持10个值,单个值的内容长度限制为100个字符。

    sorts

    排序条件列表(数组格式),最多支持10个排序条件。每个条件包含:

    • orderBy:排序字段名。
    • sort:排序方式,支持ASC(升序)或DESC(降序)。

  5. 完成参数填写后,单击“运行”。

    运行成功后,在页面右侧“输出结果”区域,查看接口返回的模拟响应数据。

相关文档