# 视图

在O2OA中，视图是展现、查询流程和内容管理数据的重要途径，也是各应用进行数据关联的工具。

## 入口

点系统的左上角导航->设计中心->数据中心->具体应用->视图打开。

## 视图的后台服务

[http://applicationServer:20020/x\_query\_assemble\_surface/jest/index.html](http://****:20020/x_query_assemble_surface/jest/index.html)

![](/files/-Lm_8iV7kes3fuZF1G3G)

## 视图属性

### 基本

| 属性名   | 说明                            |
| ----- | ----------------------------- |
| 标识    | 视图ID                          |
| 名称    | 视图名称                          |
| 别名    | 视图别名                          |
| 隐藏视图  | 隐藏后不会在点左上角导航->应用中显示           |
| 最大行数  | 视图展现的时候返回数据的最多数目              |
| 每页行数  | 视图展现的时候每页的数据数目                |
| 可执行人  | 允许执行视图的人。和可执行组织同时为空的时候，所有人可执行 |
| 可执行组织 | 允许执行视图的组织                     |

### 范围

| 属性名  | 说明                                                                                             |
| ---- | ---------------------------------------------------------------------------------------------- |
|      | 可以选择流程平台数据或者是内容管理平台的数据                                                                         |
| 权限   | <p>带权限：当前人员只能看到流转过的工作</p><p>忽略：当前人员可以看到符合过滤条件所有工作，但是没有流转过的不能打开</p>                             |
| 流转状态 | 只有选择流程平台数据的时候起作用                                                                               |
| 选择应用 | 只对应流程平台应用的数据                                                                                   |
| 选择流程 | 只对应流程的数据，如果应用和流程同时选择的情，取并集                                                                     |
| 数据类型 | <p>信息类：只显示内容管理栏目或分类里文档类型设置为“信息”的数据</p><p>数据类：只显示内容管理栏目或分类里文档类型设置为“数据”的数据</p><p>全部：对文档类型无限制</p> |
| 选择栏目 | 只显示对应内容管理栏目的数据                                                                                 |
| 选择分类 | 只显示对应内容管理分类的数据，如果栏目和分类同时选择                                                                     |
| 拟稿组织 | 只显示选择的拟稿组织的数据                                                                                  |
| 拟稿人员 | 只显示选择的拟稿人员的数据                                                                                  |
| 拟稿身份 | 只显示选择的拟稿身份的数据                                                                                  |
| 隐藏视图 | 隐藏后不会在点左上角导航->应用中显示                                                                            |
| 时段   | <p>只显示符合时段内的数据，允许有偏移量</p><p><strong>视图默认返回一年内的数据，如果需要返回更早时间的数据，请配置时段。</strong></p>             |

### 过滤

当选择“作为默认过滤条件”时，视图在执行的时候既根据该过滤条件进行过滤。

当选择“作为自定义过滤数据”时，用户可以根据配置自定义进行过滤。

路径：

#### 平台流程填写对应的以下路径：

```
{
    "$work" : {
        "title" : "" , //标题
        "startTime" : "", //创建时间
        "startTimeMonth": "", //创建月份
        "completedTime": "", //完成时间
        "completedTimeMonth": "", //完成月份
        "creatorPerson": "", //拟稿人
        "creatorIdentity": "", //拟稿人身份
        "creatorUnit": "", //拟稿组织
        "creatorUnitLevelName": "", //拟稿组织层级
        "application": "", //应用ID
        "applicationName": "", //应用名称
        "applicationAlias": "", //应用别名
        "process": "", //流程ID
        "processName": "", //流程名称
        "processAlias": "", //流程别名
        "serial": "", //编号
        "activityType": "", //活动类型
        "activityName": "", //活动名称
        "activityArrivedTime": "", //活动到达时间
        "workId": "", //工作ID
        "workCompletedId": "", //已完成工作ID
        "job": "", //JOB的ID(job)
        "completed": "", //是否已完成(completed)
    },
    "subject" : "", //标题
    "identity1" : [{ //身份/人员/组织/职务/群组 的存储形式
        {
            "name": "李四",  //身份名称，不唯一
            "unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2", //身份唯一标识
            "description": "", //身份描述
            "distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I", //身份全称
            "person": "李四@lisi@P", //人员
            "unit": "开发部@kfb@U",  //组织
            "unitName": "开发部",   //组织名称, 不唯一
            "unitLevel": 2,         //组织层级
            "unitLevelName": "浙江兰德纵横/开发部", //组织层级名
            "orderNumber": 24920439 //排序号
        }
        ...
    }] 
    ...
}
```

如：流程ID "$work.workId"

标题填写：subject

身份dn填写：identity1.0.distinguishedName (数组用 “.0” 来表示下标)

#### 内容管理填写对应的以下路径：

```
{
    "$document" : {
        "title" : "", //标题
        "publishTime" : "", //发布时间
        "creatorPerson" : "", //拟稿人
        "creatorIdentity" : "", //拟稿人身份
        "creatorUnitName" : "", //拟稿组织
        "creatorTopUnitName" : "", //拟稿顶级组织
        "appId" : "", //栏目ID
        "appName" : "", //栏目名称
        "categoryId" : "", //分类ID
        "categoryName" : "", //分类名称
        "categoryAlias" : "", //分类别名
        "docid" : "", //文档ID
    },
    "subject" : "", //标题
    "identity1" : [{ //身份/人员/组织/职务/群组 的存储形式
        {
            "name": "李四",  //身份名称，不唯一
            "unique": "23dd1b53-feed-485d-8c9c-1a4e64ff58a2", //身份唯一标识
            "description": "", //身份描述
            "distinguishedName": "李四@23dd1b53-feed-485d-8c9c-1a4e64ff58a2@I", //身份全称
            "person": "李四@lisi@P", //人员
            "unit": "开发部@kfb@U",  //组织
            "unitName": "开发部",   //组织名称, 不唯一
            "unitLevel": 2,         //组织层级
            "unitLevelName": "浙江兰德纵横/开发部", //组织层级名
            "orderNumber": 24920439 //排序号
        }
        ...
    }] 
    ...
}
```

如：文档ID填写 "$document.docid"

标题填写：subject

身份dn填写：identity1.0.distinguishedName (数组用 “.0” 来表示下标)

## 列属性

| 属性    | 说明                                                                                                     |
| ----- | ------------------------------------------------------------------------------------------------------ |
| 列标题   | 表格的标题                                                                                                  |
| 列名    | 列名，当需要操作数据的时候要用到（比如嵌入到表单中选择数据的时候）                                                                      |
| 默认值   | 列值为空时的默认值                                                                                              |
| 打开文档  | 点击该列的时候，是否打开文档                                                                                         |
| 数据路径  | 查看本章-视图属性-过滤-路径的介绍                                                                                     |
| 排序    | 该列是否排序，只有第一个排序列有效                                                                                      |
| 分类    | 该列是否分类，只能有一个分类列                                                                                        |
| 隐藏    | 显示的时候，该列是否隐藏                                                                                           |
| 组织对象  | 如果选是，那么只显示数组第一个值的 name 属性                                                                              |
| HTML值 | 如果选择是，则作为单元格的innerHTML显示                                                                               |
| 显示脚本  | <p>可以通过脚本对列值进行计算。</p><p>this.value：为列原来的值</p><p>this.entry.data: 该行所有列的值</p><p>显示脚本最终需要 return 放回值</p> |

## 视图的使用

### 在表单、页面中嵌入视图

可以在表单中使用“嵌入视图”组件

![](/files/-Lm_01bJbUZmeo9unXyK)

### 选择视图的数据到表单&#x20;

在表单中使用“选择视图”组件，可以进行流程、内容管理分类直接的数据关联。

![](/files/-Lm_6514xtS0lxnWfPba)

当 选择结果处理 选择 “赋值”的时候：

上图中的 field\_1 为本表单的组件标识，column\_1 为视图的列名。

当用户选择视图后，会将选中行 column\_1 列的值赋值给 field\_1 。

当 选择结果处理 选择 “脚本”的时候，可以通过 *this.target.selectedData* 来获取用户选择行的数据。数据格式如下：

```
{[
  bundle : "xxxx", //CMS文档Id/流程jobId
  data : {  //列数据
    column1Name : column1Value, //第一列的列名，第一列的列值
    column2Name : column2Value, //第二列的列名，第二列的列值
    ...
  },
  ...
]}
```

## 在脚本中的使用

可以查看API的 view章节进行学习，[点击打开链接](http://www.o2oa.net/x_desktop/portal.html?id=dcd8e168-2da0-4496-83ee-137dc976c7f6\&page=99d67d72-b744-4c36-852e-50254b5775ff)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://o2oa.gitbook.io/course/liu-cheng-guan-li/untitled-3/shi-tu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.