143 lines
2.8 KiB
Markdown
143 lines
2.8 KiB
Markdown
# 🚀 党籍保留附件查看功能 - 快速参考
|
|
|
|
**版本**: v1.0 | **日期**: 2025-10-13 | **状态**: ✅ 已完成
|
|
|
|
---
|
|
|
|
## 📍 功能位置
|
|
|
|
```
|
|
人事管理 → 出国申请管理 → 出国申请 → 查看详情 → 党籍保留附件区域
|
|
```
|
|
|
|
---
|
|
|
|
## 🎯 核心功能
|
|
|
|
| 功能 | 说明 |
|
|
|------|------|
|
|
| **查看按钮** | 在线预览党籍保留附件 |
|
|
| **下载按钮** | 下载附件到本地 |
|
|
|
|
---
|
|
|
|
## 📄 支持格式
|
|
|
|
### ✅ 在线预览
|
|
|
|
- **PDF**: `.pdf` → 新标签页打开
|
|
- **图片**: `.jpg`, `.jpeg`, `.png`, `.gif`, `.bmp`, `.webp` → 新窗口显示
|
|
|
|
### ⚠️ 自动下载
|
|
|
|
- **Word**: `.doc`, `.docx`
|
|
- **Excel**: `.xls`, `.xlsx`
|
|
- **其他**: 所有其他格式
|
|
|
|
---
|
|
|
|
## 💻 代码位置
|
|
|
|
### 前端文件
|
|
|
|
**文件**: `web/src/views/rs/overseas/index.vue`
|
|
|
|
| 内容 | 行号 |
|
|
|------|------|
|
|
| 界面代码 | 1024-1060 |
|
|
| 图标导入 | 1260 |
|
|
| 预览方法 | 3437-3515 |
|
|
|
|
### 核心方法
|
|
|
|
```typescript
|
|
// 预览方法
|
|
handlePreviewPartyRetentionFile(data: OverseasApplicationVO)
|
|
|
|
// 下载方法（已有）
|
|
handleDownloadPartyRetentionFile(data: OverseasApplicationVO)
|
|
```
|
|
|
|
---
|
|
|
|
## 🔧 技术实现
|
|
|
|
### 请求方式
|
|
|
|
```typescript
|
|
const response = await request({
|
|
url: `/resource/oss/download/${ossId}`,
|
|
method: 'get',
|
|
responseType: 'blob'
|
|
});
|
|
```
|
|
|
|
### 预览方式
|
|
|
|
```typescript
|
|
// PDF
|
|
const blob = new Blob([response.data], { type: 'application/pdf' });
|
|
const blobUrl = window.URL.createObjectURL(blob);
|
|
window.open(blobUrl, '_blank');
|
|
|
|
// 图片
|
|
const previewWindow = window.open('', '_blank');
|
|
previewWindow.document.write(/* HTML模板 */);
|
|
```
|
|
|
|
---
|
|
|
|
## 🧪 测试清单
|
|
|
|
- [ ] 界面显示正确
|
|
- [ ] PDF预览正常
|
|
- [ ] 图片预览正常
|
|
- [ ] 不支持格式自动下载
|
|
- [ ] 错误提示友好
|
|
- [ ] 权限验证正常
|
|
- [ ] 浏览器兼容性
|
|
|
|
---
|
|
|
|
## 📚 相关文档
|
|
|
|
| 文档 | 说明 |
|
|
|------|------|
|
|
| `✅党籍保留附件查看功能实现说明.md` | 详细技术文档 |
|
|
| `📖党籍保留附件查看功能-使用说明.md` | 用户操作手册 |
|
|
| `🧪党籍保留附件查看功能-测试指南.md` | 测试用例文档 |
|
|
| `📝党籍保留附件查看功能-开发总结.md` | 开发总结报告 |
|
|
|
|
---
|
|
|
|
## ❓ 常见问题
|
|
|
|
### Q: 点击查看没反应？
|
|
**A**: 检查浏览器弹窗拦截，允许网站弹出窗口
|
|
|
|
### Q: PDF显示空白？
|
|
**A**: 等待加载完成，或使用Chrome/Edge浏览器
|
|
|
|
### Q: 提示不支持预览？
|
|
**A**: 正常，系统会自动触发下载
|
|
|
|
---
|
|
|
|
## 🔗 快速链接
|
|
|
|
- **前端规范**: `.cursor/cursorrules-frontend.md`
|
|
- **API文档**: `docs/开发文档/API/出国申请管理API.md`
|
|
- **项目规范**: `.cursor/cursorrules.md`
|
|
|
|
---
|
|
|
|
## 📞 支持
|
|
|
|
**问题反馈**: 联系开发团队
|
|
**功能建议**: 提交到项目管理系统
|
|
|
|
---
|
|
|
|
**创建**: Cursor AI | **更新**: 2025-10-13
|
|
|