[comment]: # ({38b63d3a-e5b69436})
# 1 操作日志
[comment]: # ({/38b63d3a-e5b69436})
[comment]: # ({099dbeb6-7950f8a2})
### 描述
这些参数以及相应 dashboard widget 字段对象的可选属性值，可用于在 `dashboard.create` 和 `dashboard.update` 方法中配置 [*Action log*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log) widget。
::: noteimportant
在创建或更新 dashboard 时，不会对 widget `fields` 属性进行验证。
这使用户能够修改 [内置 widget](/manual/web_interface/frontend_sections/dashboards/widgets) 并创建 [自定义 widget](/devel/modules/tutorials/widget)，但也会带来错误创建或更新 widget 的风险。
为确保成功创建或更新 *Action log* widget，请参阅下方表格中概述的参数行为。
:::
[comment]: # ({/099dbeb6-7950f8a2})
[comment]: # ({351a02b1-74bdffdc})
### 参数
以下参数适用于 *Action log* 小组件。
|参数|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|-----|-|-----|-------------------|
|*刷新间隔*|<|0|rf_rate|0 - 不刷新；
10 - 10 秒；
30 - 30 秒；
60 - *(默认)* 1 分钟；
120 - 2 分钟；
600 - 10 分钟；
900 - 15 分钟。|
|*收件人*|<|11|userids.0|[用户](/manual/api/reference/user/get) ID。
注意：要配置多个用户，请为每个用户创建一个 dashboard widget field 对象，并在属性名中递增编号。|
|*操作*|<|12|actionids.0|[操作](/manual/api/reference/action/get) ID。
注意：要配置多个操作，请为每个操作创建一个 dashboard widget field 对象，并在属性名中递增编号。|
|*媒体类型*|<|13|mediatypeids.0|[媒体类型](/manual/api/reference/mediatype/get) ID。
注意：要配置多个媒体类型，请为每个媒体类型创建一个 dashboard widget field 对象，并在属性名中递增编号。|
|*状态*|<|0|statuses.0|0 - 进行中；
1 - 已发送/已执行；
2 - 失败。
注意：要配置多个值，请为每个值创建一个 dashboard widget field 对象，并在属性名中递增编号。|
|*搜索字符串*|<|1|message|任意字符串值。|
|*时间段*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - 将 [*时间段* 选择器](/manual/web_interface/time_period_selector) 设为数据源；
`ABCDE._timeperiod` - 将 [兼容的小组件](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility)（其 *Reference* 参数设置为 "`ABCDE`"）设为数据源。
默认值：`DASHBOARD._timeperiod`
或者，您也可以仅在 *From* 和 *To* 参数中设置时间段。|
|<|*From*|1|time_period.from|有效的绝对时间字符串（`YYYY-MM-DD hh:mm:ss`）或 [相对](/manual/web_interface/time_period_selector) 时间语法（`now`、`now/d`、`now/w-1w` 等）。
[参数行为](/manual/api/reference_commentary#parameter-behavior)：
- 如果未设置 *时间段*，则为 *supported*
- 如果设置了 `time_period.to`，则为 *required*|
|^|*To*|1|time_period.to|有效的绝对时间字符串（`YYYY-MM-DD hh:mm:ss`）或 [相对](/manual/web_interface/time_period_selector) 时间语法（`now`、`now/d`、`now/w-1w` 等）。
[参数行为](/manual/api/reference_commentary#parameter-behavior)：
- 如果未设置 *时间段*，则为 *supported*
- 如果设置了 `time_period.from`，则为 *required*|
|*按以下方式排序条目*|<|0|sort_triggers|3 - 时间（升序）；
4 - *(默认)* 时间（降序）；
5 - 类型（升序）；
6 - 类型（降序）；
7 - 状态（升序）；
8 - 状态（降序）；
11 - 收件人（升序）；
12 - 收件人（降序）。|
|*显示行数*|<|0|show_lines|可选值范围为 1-100。
默认值：25。|
[comment]: # ({/351a02b1-74bdffdc})
[comment]: # ({211d52e5-2dd9270a})
### 示例
以下示例仅用于描述为 *动作日志* 小组件配置仪表板 widget 字段 objects 的过程。
有关配置仪表板的更多信息，请参见 [`dashboard.create`](/manual/api/reference/dashboard/create)。
[comment]: # ({/211d52e5-2dd9270a})
[comment]: # ({93e6111e-bf9fdcfc})
#### 配置 *操作日志* 部件
配置一个*操作日志* widget，用于显示10操作详细信息的条目，并按时间排序（升序）。
此外，仅显示那些尝试向用户"1"发送邮件但未成功的行为操作的详细信息。
[执行请求](/manual/api#执行请求):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "actionlog",
"name": "Action log",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "show_lines",
"value": 10
},
{
"type": 0,
"name": "sort_triggers",
"value": 3
},
{
"type": 11,
"name": "userids.0",
"value": 1
},
{
"type": 13,
"name": "mediatypeids.0",
"value": 1
},
{
"type": 0,
"name": "statuses.0",
"value": 2
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Response:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/93e6111e-bf9fdcfc})
[comment]: # ({e9d30322-5780d59d})
### 另请参阅
- [Dashboard widget field](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-5780d59d})