[comment]: # translation:outdated
[comment]: # ({38b63d3a-e5b69436})
# 1 动作日志
[comment]: # ({/38b63d3a-e5b69436})
[comment]: # ({e7f14619-7950f8a2})
### 说明
各个仪表盘组件字段对象中的这些参数和可用属性值允许在`dashboard.create` 和 `dashboard.update` 方法中配置[*动作日志*](/manual/web_interface/frontend_sections/dashboards/widgets/action_log)组件。
::: noteimportant
在创建或更新仪表盘期间不会验证组件的 `fields` 属性。
这个方法允许用户修改[内置组件](/manual/web_interface/frontend_sections/dashboards/widgets)和创建[自定义组件](/devel/modules/tutorials/widget)，但也会导致存在错误创建或更新组件的风险。
为确保成功创建或更新*动作日志*组件，请参阅下表中概述的参数行为。
:::
[comment]: # ({/e7f14619-7950f8a2})
[comment]: # ({5e4588ec-74bdffdc})
### 参数
*动作日志*组件支持以下参数：
|参数|<|[类型](/manual/api/reference/dashboard/object#仪表盘组件字段)|参数名称|参数值或参数说明|
|--|-----|--|-----|-------------------|
|*刷新频率*|<|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。
注意: 如果需要配置多个用户，则需要给每个用户创建一个仪表盘组件字段对象，参数名称 `userids.0` 中的数字按照顺序进行递增。|
|*动作*|<|12|actionids.0|[动作](/manual/api/reference/action/get) ID。
注意: 如果需要配置多个动作，则需要给每个动作创建一个仪表盘组件字段对象，参数名称 `actionids.0` 中的数字按照顺序进行递增。|
|*媒介类型*|<|13|mediatypeids.0|[媒介类型](/manual/api/reference/mediatype/get) ID。
注意: 如果需要配置多个媒介类型，则需要给每个媒介类型创建一个仪表盘组件字段对象，参数名称 `mediatypeids.0` 中的数字按照顺序进行递增。|
|*状态*|<|0|statuses.0|0 - 执行中；
1 - 已发起/已执行；
2 - 失败。
注意: 如果需要配置多个值，则需要给每个值创建一个仪表盘组件字段对象，参数名称 `statuses.0` 中的数字按照顺序进行递增。|
|*查找字符串*|<|1|message|任意字符串。|
|*时间期间*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - 将[*时间期间选择器*选择器](/manual/web_interface/time_period_selector)作为数据源。
`ABCDE._timeperiod` - 将一个 *标识符* 参数为 `ABCDE` 的[兼容性组件](/manual/web_interface/frontend_sections/dashboards/widgets#组件兼容性)作为数据源。
默认值： `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#参数行为)：
- *支持* (如果未设置 *时间期间*)。|
|^|*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#参数行为)：
- *支持* (如果未设置 *时间期间*)。|
|*排序类型*|<|0|sort_triggers|3 - 时间 (升序)；
4 - *(默认)* 时间 (倒序)；
5 - 类型 (升序)；
6 - 类型 (倒序)；
7 - 状态 (升序)；
8 - 状态 (倒序)；
11 - 接收者 (升序)；
12 - 接收者 (倒序)。|
|*展示行数*|<|0|show_lines|可用值范围： 1-100。
默认值：25。|
[comment]: # ({/5e4588ec-74bdffdc})
[comment]: # ({211d52e5-2dd9270a})
### 示例
以下示例仅用于介绍如何在仪表盘组件字段对象中配置 *动作日志* 组件。
更多信息，请参考[创建仪表盘](/manual/api/reference/dashboard/create)。
[comment]: # ({/211d52e5-2dd9270a})
[comment]: # ({93e6111e-bf9fdcfc})
#### 配置一个*动作日志* 组件
配置一个*动作日志*组件，用于展示按时间倒序排序的 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
}
```
响应:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/93e6111e-bf9fdcfc})
[comment]: # ({e9d30322-5780d59d})
### 参考
- [仪表盘组件字段](/manual/api/reference/dashboard/object#仪表盘组件字段)
- [创建仪表盘](/manual/api/reference/dashboard/create)
- [更新仪表盘](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-5780d59d})