136 lines
3.1 KiB
Markdown
136 lines
3.1 KiB
Markdown
|
---
|
|||
|
|
name: chinaweal-pms
|
|||
|
|
description: |
|
|||
|
|
众望通 PMS 系统数据查询工具。用于查询 PMS 系统中的待办任务数据。
|
|||
|
|
|
|||
|
|
当用户提到以下场景时使用此 Skill：
|
|||
|
|
(1) 查询待办、待办详情、待办任务
|
|||
|
|
(2) 需要从 PMS 系统获取任务信息
|
|||
|
|
(3) 用户提到 "PMS"、"待办"、"todo"、"所有待办"、"未完成待办"
|
|||
|
|
version: 1.0.0
|
|||
|
|
license: Apache-2.0
|
|||
|
|
metadata:
|
|||
|
|
author: lirh
|
|||
|
|
category: development
|
|||
|
|
tags:
|
|||
|
|
- pms
|
|||
|
|
- chinaweal
|
|||
|
|
- enterprise
|
|||
|
|
- todo
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Chinaweal PMS 系统查询
|
|||
|
|
|
|||
|
|
## 概述
|
|||
|
|
|
|||
|
|
此 Skill 用于查询众望通 PMS 系统（Project Management System）的数据。
|
|||
|
|
|
|||
|
|
## 认证配置
|
|||
|
|
|
|||
|
|
使用此 Skill 前，需要配置环境变量 `CHINAWEAL_PMS_TOKEN`：
|
|||
|
|
|
|||
|
|
- **环境变量名称**: `CHINAWEAL_PMS_TOKEN`
|
|||
|
|
- **用途**: PMS 系统的用户授权 Token
|
|||
|
|
|
|||
|
|
### 请求鉴权方式
|
|||
|
|
|
|||
|
|
所有 API 请求需要在请求头中携带 Authorization 信息：
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
其中 `{CHINAWEAL_PMS_TOKEN}` 需要替换为环境变量 `CHINAWEAL_PMS_TOKEN` 的值。
|
|||
|
|
|
|||
|
|
## 功能清单
|
|||
|
|
|
|||
|
|
### 功能1: 查询所有未完成待办
|
|||
|
|
|
|||
|
|
查询当前用户的所有未完成待办任务列表。
|
|||
|
|
|
|||
|
|
**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all`
|
|||
|
|
|
|||
|
|
**请求方法**: GET
|
|||
|
|
|
|||
|
|
**请求头**:
|
|||
|
|
```
|
|||
|
|
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
|||
|
|
Content-Type: application/json
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**查询参数**:
|
|||
|
|
- `status` - 任务状态，0 表示未完成
|
|||
|
|
|
|||
|
|
**响应关键字段**:
|
|||
|
|
- `todoNo` - 待办编号
|
|||
|
|
- `todoTitle` - 待办标题
|
|||
|
|
- `todoDescription` - 待办描述
|
|||
|
|
- `createTime` - 创建时间
|
|||
|
|
|
|||
|
|
**使用示例**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
帮我查询所有待办
|
|||
|
|
查询所有未完成的待办
|
|||
|
|
看看我有哪些待办任务
|
|||
|
|
我的待办有哪些
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 功能2: 查询待办详情
|
|||
|
|
|
|||
|
|
查询指定待办编号的详细信息。
|
|||
|
|
|
|||
|
|
**接口地址**: `https://www.chinaweal.com.cn/pms-api/api/todo/detail/{todoNo}`
|
|||
|
|
|
|||
|
|
**请求方法**: GET
|
|||
|
|
|
|||
|
|
**请求头**:
|
|||
|
|
```
|
|||
|
|
Authorization: Bearer {CHINAWEAL_PMS_TOKEN}
|
|||
|
|
Content-Type: application/json
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**路径参数**:
|
|||
|
|
- `todoNo` - 待办编号
|
|||
|
|
|
|||
|
|
**响应关键字段**:
|
|||
|
|
- `todoTitle` - 待办标题
|
|||
|
|
- `todoDescription` - 待办任务的详情描述
|
|||
|
|
- `todoAtt` - 待办附件下载地址清单（下载地址中包含 `filename` 参数，表示附件原名）
|
|||
|
|
|
|||
|
|
### 使用示例
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
帮我查询待办号 TODO2024030001 的详情
|
|||
|
|
查询一下 todoNo 为 12345 的待办信息
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 调用方式
|
|||
|
|
|
|||
|
|
使用 exec 工具执行 curl 命令进行 API 调用。
|
|||
|
|
|
|||
|
|
**查询所有未完成待办**:
|
|||
|
|
```bash
|
|||
|
|
CHINAWEAL_PMS_TOKEN="your-token-here"
|
|||
|
|
|
|||
|
|
curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/unfinished/list/all" \
|
|||
|
|
-H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
|
|||
|
|
-H "Content-Type: application/json"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**查询单个待办详情**:
|
|||
|
|
```bash
|
|||
|
|
CHINAWEAL_PMS_TOKEN="your-token-here"
|
|||
|
|
TODO_NO="TODO2024030001"
|
|||
|
|
|
|||
|
|
curl -X GET "https://www.chinaweal.com.cn/pms-api/api/todo/detail/${TODO_NO}" \
|
|||
|
|
-H "Authorization: Bearer ${CHINAWEAL_PMS_TOKEN}" \
|
|||
|
|
-H "Content-Type: application/json"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
1. 确保环境变量 `CHINAWEAL_PMS_TOKEN` 已正确配置
|
|||
|
|
2. 待办编号 `todoNo` 需要从 PMS 系统获取
|
|||
|
|
3. 附件下载地址中包含 `filename` 参数，即为附件原文件名
|