96 lines
4.7 KiB
Markdown
96 lines
4.7 KiB
Markdown
# 活動管理
|
||
|
||
## 畫面檔：
|
||
~/Forms/ClassesList.aspx
|
||
|
||
## 資料存取類別
|
||
~/Models/DAC_Classes1.cs（自動產生，勿修改）
|
||
~/Models/DAC_Classes2.cs（自訂擴充）
|
||
- DAC_Classes：資料處理類別
|
||
- ClassesList：資料集類別
|
||
- ClassesItem：資料項目類別
|
||
|
||
## 畫面排列：
|
||
上方：搜尋列
|
||
- 使用 CourseCode、CourseName、CourseDate_1（CourseDate 起）、CourseDate_2（CourseDate 迄）、CourseLocation 為查詢條件
|
||
下方：搜尋結果列表
|
||
- 顯示欄位為 CourseCode、CourseName、CourseDate、CourseLocation、操作
|
||
- 新增按鈕放置在表頭的操作欄
|
||
- 更正、刪除按鈕放置在操作欄
|
||
- CourseCode、CourseDate 向中對齊，其餘向左對齊
|
||
|
||
## UI 規範：
|
||
- 小窗尺寸：700x500px
|
||
- 搜尋結果每頁顯示 20 筆
|
||
- 操作按鈕使用 Bootstrap 樣式
|
||
|
||
## 錯誤處理：
|
||
- 使用系統共用的 $message 來顯示
|
||
|
||
## 新增更正：
|
||
- 新增更正時彈出小窗
|
||
- 新增有兩個存檔按鈕
|
||
存檔：存檔後關閉小窗
|
||
存檔後繼續新增：存檔後清除輸入內容重新進入新增模式
|
||
- 更正存檔後關閉小窗
|
||
|
||
## 刪除：
|
||
- 彈 confirm 確認後刪除
|
||
|
||
## 資料輸入：
|
||
- CourseCode 不可輸入，不可修改，自動編號（BeforeInsertOne 處理）
|
||
- CourseName 必填，可輸入，可修改，單行文字框，最長 100 Unicode 字元
|
||
- CourseDate 必填，可輸入，可修改，日期輸入框，YYYY-MM-DD 格式，不必驗證是否晚於今天
|
||
- CourseLocation 非必填，可輸入，可修改，單行文字框
|
||
- NotificationTitle 非必填，可輸入，可修改，單行文字框，最長 100 Unicode 字元
|
||
- NotificationTemplate 非必填，可輸入，可修改，多行文字框，最長 500 Unicode 字元
|
||
NotificationTemplate 插入規則：
|
||
- 插入格式：{活動日期}、{活動名稱}、{活動地點}
|
||
- 插入位置：游標當前位置
|
||
- 範例：「提醒您，{活動名稱}將於{活動日期}在{活動地點}舉行」
|
||
- AgreedTerms 非必填
|
||
|
||
## 前端程式碼：
|
||
- 使用 Vue.js 實現動態資料綁定與操作。
|
||
- 不使用 Server control
|
||
|
||
## 後端程式碼：
|
||
- 使用 WebService 實現非同步資料交換。
|
||
|
||
## WebService 端點：
|
||
Services/ClassesService.asmx
|
||
- EnableSession(True)
|
||
|
||
- SearchClasses(int pageIndex, int pageSize, string courseCode, string courseName, DateTime? courseDate1, DateTime? courseDate2, string courseLocation, bool? closed, string projectID)：搜尋活動
|
||
- pageIndex 從 1 開始
|
||
- 查詢 function 用 DAC_Classes.SelectPage(bool noInputReturnAll, int startRowIndex, int maximumRows, string CourseCode, string CourseName, DateTime? CourseDate_1, DateTime? CourseDate_2, string CourseLocation, bool? Closed, string ProjectID, string orderBy = "")
|
||
- 筆數 function 用 DAC_Classes.SelectCount(bool noInputReturnAll, string CourseCode, string CourseName, DateTime? CourseDate_1, DateTime? CourseDate_2, string CourseLocation, bool? Closed, string ProjectID, string orderBy = "")
|
||
- 查詢條件為 AND 關係
|
||
- 空白條件視為不限制（noInputReturnAll = true）
|
||
- CourseDate 為範圍查詢
|
||
- 每筆結果補填 ProjectName（由 DAC_BPAA.SelectProjectName 查詢）
|
||
- 回傳：BaseResponse（Success, Message, Data: ClassesList.ToDict(), TotalCount: 總筆數）
|
||
|
||
- SaveClasses(bool isNew, ClassesItem item)：存檔
|
||
- isNew：是否為新增
|
||
- item：新增或更正的活動資料（型別 ClassesItem）
|
||
- 回傳：BaseResponse（Success, Message, Data: 儲存後的 ClassesItem）
|
||
|
||
- DeleteClasses(int id, int dbAppNo)：刪除活動
|
||
- 呼叫 DAC_Classes.DeleteOne(int ID, int DB_APPNO)
|
||
- 回傳：BaseResponse（Success, Message）
|
||
|
||
- SearchProjects(string keyword)：搜尋計畫（用於自動完成）
|
||
- 呼叫 DAC_BPAA.Select(keyword)
|
||
- 回傳：BaseResponse（Success, Message, Data: NameValueList）
|
||
|
||
- ExportClassesReport(int classesID, string timeFormat = "datetime")：匯出學員簽到表
|
||
- 輸入參數：classesID（課程 ID）、timeFormat（時間格式，"datetime" 或 "time"）
|
||
- 查詢課程及參加人員資料，使用 NPOI 產生 Excel
|
||
- 回傳：BaseResponse（Success, Message, Data: { FileName, FileBase64, FileSize, DataCount }）
|
||
|
||
- ExportClassesList(DateTime? courseDate1, DateTime? courseDate2, string projectID)：匯出課程清單
|
||
- 輸入參數：courseDate1（課程日期起）、courseDate2（課程日期迄）、projectID（計畫代號）
|
||
- 查詢課程清單及各課程的參加人員統計，使用 NPOI 產生 Excel
|
||
- 回傳：BaseResponse（Success, Message, Data: { FileName, FileBase64, FileSize }）
|