# 新增及查詢請購單

### 1. 新增請購單按鈕
* 點擊後開啟 **[新增請購單](https://hackmd.io/@help-vue/BJNkWWfUI/%2F0UUimX87TQ6NmVJcRSjmNA)** 彈窗。
### 2. 查詢表單 - 查詢資料的表單。
| 欄位 | 型態&輸出格式 | 輸入規範&預設值 |
| ------| ------------ | ------------- |
|請購日期|靠左對齊 | YYYY/MM/DD |
|請購人員|靠左對齊 | MaxLength:50 |
|請購單號|靠左對齊 | MaxLength:15 |
|案件狀態| |預設值:請選擇 |
|採購類型| |預設值:全選 |
|請購類型| |預設值:全選 |
### 3. 查詢按鈕
* 點擊後查詢資料,並更新列表。
### 4. 資料列表 - 顯示請購單資料。
* 必須有分頁,一頁20筆資料
* 無符合查詢條件的結果:畫面顯示為空資料,告知使用者無符合其所勾選的條件結果。
| 圖示 | 說明 | 顯示判斷 |
| -------- | -------- | -------- |
||編輯按鈕,點選後可編輯表單 ||
||刪除按鈕,點選後跳出確認視窗 ||
||審核按鈕,點選後送交給處長。 ||
||檢視按鈕,點選後可檢視案件歷程||
## 1. 畫面初始 API :star2:
:::success
取得 **新增及查詢請購單** 查詢下拉式選單。
:::
### Request 資訊
| 項目 | 說明 |
| ------- | -------- |
| 傳送方式 | POST |
| 網址路徑 | purchase/requisition/home |
### Resopnse 欄位
| 參數名稱 | 型態 | 說明 |
| ---------------------------- | --------------- | ---------------- |
| statusOptions | [SelectList](/c_JGS7cpQkKGe41tOwJ-0g) | 狀態 (下拉選單) |
| purchasingOrderOptions | [SelectList](/c_JGS7cpQkKGe41tOwJ-0g) | 採購類型 (勾選項目) |
| purchasingRequisitionOptions | [SelectList](/c_JGS7cpQkKGe41tOwJ-0g) | 請購類型 (勾選項目) |
| addNewButton | [ElementProperty](/UL2mQnnzRv-8HKDZTkDrdw) | 新增請購單 (按鈕) |
| queryButton | [ElementProperty](/UL2mQnnzRv-8HKDZTkDrdw) | 查詢 (按鈕) |
## 2. 請購單查詢 API :star2:
| 項目 | 說明 |
| ------- | -------- |
| 傳送方式 | POST |
| 網址路徑 | purchase/requisition/queryAction |
### Request 欄位
| 參數名稱 | 型態 | 說明 |
| ------------------ | -------- | ------------ |
| applyDateStartDate | String | 請購日期(起日) |
| applyDateEndDate | String | 請購日期(迄日) |
| applyEmpId | String | 請購人員 |
| applyId | String | 請購單號 |
| status | String | 狀態 |
| prsTypeList | String[] | 採購類型 |
| applyTypeList | String[] | 請購類型 |
### Request 範例 (待補)
``` json
{
"applyDateStartDate": "2020/02/29",
"applyDateEndDate": "2020/03/30",
"applyEmpId": "",
"applyId": "",
"status": "",
"prsTypeList" : "",
"applyTypeList" : ""
}
```
### Response 欄位
| 參數名稱 | 資料型別 | 說明 |
| -------------- | ---------------------- |---------------- |
| applyDate | String | 請購日期 |
| empName | String | 請購人員 |
| applyId | String | 請購單號 |
| item | String | 請購項目 |
| status | String | 狀態 |
| displayStatus | String | 狀態(對應語系顯示) |
| lastUpdater | String | 最後更新人員 |
| buttonAction | RequistionButtonAction | 操作 |
| lastUpdatetime | String | 最後更新時間 |
#### RequistionButtonAction
| 參數名稱 | 資料型別 | 說明 |
| --------- | ------- |-------- |
| canDelete | Boolean | 可刪除 |
| canEdit | Boolean | 可修改 |
| canView | Boolean | 可檢視 |
| history | Boolean | 案件歷程 |
{"metaMigratedAt":"2023-06-15T05:28:45.111Z","metaMigratedFrom":"Content","title":"新增及查詢請購單","breaks":true,"contributors":"[{\"id\":\"5675c4cf-38cb-4324-9e9c-23eeed300d84\",\"add\":970,\"del\":172},{\"id\":\"4a421f1e-c0f5-4640-9160-1228f2607ab4\",\"add\":5,\"del\":0},{\"id\":\"fe005bd4-2bb5-4cee-804c-ffc10af3b0b6\",\"add\":3944,\"del\":1331}]"}