# T-ERP AutoTest

T系列ERP自动化测试 Postman Collection 仓库，用于 Jenkins 集成。

## 项目结构

```
├── collections/
│   └── t-erp-auto-test.json    # Postman 集合文件
├── environments/
│   └── api-tests-env.json      # Postman 环境变量文件
├── images/                     # 操作截图
├── .gitignore                  # Git 忽略规则
└── README.md                   # 项目说明文档
```

## Git 配置

首次使用需配置 Git 身份信息，提交记录会关联到你的账号：

```bash
git config --global user.name "你的姓名"
git config --global user.email "你的邮箱"
```

> 如果只想在当前仓库生效，去掉 `--global` 即可。

## 快速上手

### 1. 克隆仓库

```bash
git clone http://122.112.209.52/Testing/AutoTest.git
cd AutoTest
```

![克隆仓库](images/1.git-clone.png)

### 2. 导入 Collection

打开 Postman → 点击左上角 **Import** → 选择 `collections/t-erp-auto-test.json`。

![导入集合](images/2.import-collection.png)

### 3. 导入环境变量

同样方式导入 `environments/api-tests-env.json`。

![导入环境变量](images/3.import-enviroment.png)

### 4. 应用环境变量到集合

在 Postman 右上角环境变量下拉框中选择 **api-tests-env**，使集合使用该环境配置。

![应用环境](images/4.apply-enviroment-2-collection.png)

### 5. 导出并提交

修改完成后，右键集合 → **Export** → 选择 **Collection v2.1** 格式（默认）→ 导出为 `t-erp-auto-test.json`，覆盖 `collections/t-erp-auto-test.json`，然后提交到 Git：

```bash
git add collections/t-erp-auto-test.json
git commit -m "update collection"
git push
```

![导出集合](images/5.export-collection.png)

## 用例维护

- Newman 每次运行只执行一个 Collection 文件，因此所有用例统一维护在 `t-erp-auto-test` 集合中。
- 如需维护个人测试用例、又担心误改他人用例，可在 `t-erp-auto-test` 集合下创建**自己的子文件夹**，将个人用例放入其中即可，互不影响。
- 自动化测试的执行顺序为 `t-erp-auto-test` 集合中**从上到下依次执行**全部用例。

## 测试环境

当前 `environments/api-tests-env.json` 配置的 API 连接信息：

| 项目 | 值 |
| ---- | --- |
| 主机 | `192.168.10.237` |
| 账套 | `TAPI` |
| 用户 | `API` |
| 密码 | `123` |

> TAPI 账套设置了 SQL Server 代理作业，**每天凌晨 0 点自动还原为空账套**。如需调整请联系陈工（<chengc@amtxts.com>）。

## 自动执行与报告

Jenkins 每天凌晨 2 点多自动执行 `t-erp-auto-test` 集合的全部用例，测试报告可在线查看：

👉 [https://attnserver.com/Updates/AutoTest/index.html](https://attnserver.com/Updates/AutoTest/index.html)

## 注意事项

- **不要覆盖或上传 `environments/` 目录下的文件**。环境变量文件仅供本地导入使用，不应提交到仓库。
- 需要新增环境变量时，以 **集合变量（Collection Variable）** 形式添加，**不要创建全局变量（Global Variable）**。
- 集合变量应在postman脚本中动态创建，保证每次运行时的变量状态干净、可复现。