
# 在CodeArts TestPlan接口脚本中调用MongoDBDelete关键字
MongoDB删除文档操作使用，根据输入的参数删除集合中的文档。
| 参数         | 是否必选 | 参数类型    | 描述                                                                  |
|:---|:---|:---|:---|
| Ip         | 是    | String  | 数据库ip地址                                                             |
| Port       | 是    | Integer | 数据库端口                                                               |
| User Name  | 是    | String  | 用户名                                                                 |
| Password   | 是    | String  | 密码（登录密码属于个人敏感信息，须在环境参数中定义为敏感参数）                                     |
| DB Name    | 是    | String  | 数据库实例名称                                                             |
| Collection | 是    | String  | 集合名称                                                                |
| Query      | 是    | String  | 删除操作指定的条件（BSON格式数据），默认为空查询集合下的所有数据进行删除                              |
| JustOne    | 否    | Boolean | 是否删除单条数据（如果设为 false，则删除所有匹配条件的文档，如果不设置该参数，或使用默认值 true，则只删除匹配的一个文档）。 |
   
#### MongoDBDelete响应
状态：成功
| 参数                 | 参数类型    | 描述        |
|:---|:---|:---|
| affected_row_count | Integer | 删除文档影响的行数 |
   
#### MongoDBDelete响应示例
```
{
  "affected_row_count" : 1
}
```
#### MongoDBDelete使用示例
根据输入的查询参数数据进行文档删除，系统关键字返回删除的记录数。
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001964152513.png "点击放大")
根据justOne参数设置为false来删除匹配到的所有文档。
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001964152517.png "点击放大")
判断结果是否成功，更新条数是否是预期值。
![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001936914126.png "点击放大")
