---
# System prepended metadata

title: 新增及查詢請購單

---

# 新增及查詢請購單

![](https://i.imgur.com/iehegb4.png)

### 1. 新增請購單按鈕 
* 點擊後開啟 **[新增請購單](https://hackmd.io/@help-vue/BJNkWWfUI/%2F0UUimX87TQ6NmVJcRSjmNA)** 彈窗。
### 2. 查詢表單 - 查詢資料的表單。




| 欄位   | 型態&輸出格式  | 輸入規範&預設值 |
| ------| ------------ | ------------- |
|請購日期|靠左對齊        |	YYYY/MM/DD	  |
|請購人員|靠左對齊        |	MaxLength:50  |
|請購單號|靠左對齊        |	MaxLength:15  |
|案件狀態|		         |預設值:請選擇    |
|採購類型|		         |預設值:全選	  |	
|請購類型|		         |預設值:全選      |



### 3. 查詢按鈕 
* 點擊後查詢資料，並更新列表。
### 4. 資料列表 - 顯示請購單資料。
* 必須有分頁，一頁20筆資料
* 無符合查詢條件的結果：畫面顯示為空資料，告知使用者無符合其所勾選的條件結果。

| 圖示                                | 說明                     |  顯示判斷  | 
| --------                           | --------                | -------- |
|![](https://i.imgur.com/9JlPVbY.png)|編輯按鈕，點選後可編輯表單    ||
|![](https://i.imgur.com/es0RNWL.png)|刪除按鈕，點選後跳出確認視窗  ||
|![](https://i.imgur.com/ZQ9uHRv.png)|審核按鈕，點選後送交給處長。  ||
|![](https://i.imgur.com/70mUbKz.png)|檢視按鈕，點選後可檢視案件歷程||





## 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 | 案件歷程 |
