title: 00_01_SETM003(ACMM003)會計科目維護_畫面操作說明
date: 2024-09-29 19:18:25
permalink: /SET/SETM003/SETM003_ProcessHOWto/
categories: WDS
tags: [C# , SA , UML ,SET]
description: 00_01_SETM003(ACMM003)會計科目維護_畫面操作說明

00_01_SETM003(ACMM003)會計科目維護_畫面操作說明

系統說明文件：SETM003Controller API

簡介

SETM003Controller 是一組 Web API，用於會計科目維護作業。該 API 包含多項功能，包括科目查詢、科目新增、修改、刪除等操作。本文將詳細描述每個 API 方法的運作流程、使用情境、輸入與輸出格式，以及檢核邏輯。

1. 科目查詢（GetAccountList）

• 授權：不需要 [Authorize] 屬性，任何用戶都可以調用。

目的

• 提供會計科目的列表供前端顯示，並包含額外的科目信息。

假設情境

使用者在進行會計科目管理時，需要查詢現有的科目。當使用者點擊查詢按鈕時，前端會調用 GetAccountList API 來獲取會計科目列表。

運作流程

1. 前端發送 GET 請求到 GetAccountList API。
2. API 調用相關的服務方法從資料庫中取得會計科目列表。
3. API 返回科目的詳細資訊，包括科目編號、科目名稱、科目類型等。
4. 前端顯示這些科目資訊。

輸出結果（OutputList: AccountList_OutputVo）

• ACCOUNT_NO：科目編號，例如 "1001"。
• ACCOUNT_NAME：科目名稱，例如 "現金"。
• ACCOUNT_TYPE：科目類型，例如 "資產"。

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "查詢成功",
    "RESULT": [
        {
            "ACCOUNT_NO": "1001",
            "ACCOUNT_NAME": "現金",
            "ACCOUNT_TYPE": "資產"
        },
        {
            "ACCOUNT_NO": "2001",
            "ACCOUNT_NAME": "應付帳款",
            "ACCOUNT_TYPE": "負債"
        }
    ]
}

2. 新增科目（CreateAccount）

• 授權：需要 [Authorize] 屬性，必須經過身份驗證的用戶才能調用。

目的

• 新增會計科目，將科目資訊寫入資料庫。

假設情境

會計人員需要新增一個新的會計科目。輸入科目資料後，點擊「新增」按鈕，前端會調用 CreateAccount API。

運作流程

1. 前端將科目資料打包成 JSON 格式，並發送 POST 請求到 CreateAccount API：

   {
       "ACCOUNT_NO": "3001",
       "ACCOUNT_NAME": "投資收益",
       "ACCOUNT_TYPE": "收益"
   }
   

2. API 調用服務層方法進行科目資料的檢核，例如檢查科目編號是否已存在。
3. 若檢核成功，API 將資料寫入資料庫，並返回操作結果。

輸入參數（InputList: Account_InputVo）

• ACCOUNT_NO：科目編號（如 "3001"）。
• ACCOUNT_NAME：科目名稱（如 "投資收益"）。
• ACCOUNT_TYPE：科目類型（如 "收益"）。

輸出結果

• RESULT_CODE：操作狀態碼，例如 "S0000001" 代表成功。
• RESULT_MESSAGE：操作結果的描述，例如 "新增成功"。

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "新增成功"
}

3. 修改科目（UpdateAccount）

• 授權：需要 [Authorize] 屬性，必須經過身份驗證的用戶才能調用。

目的

• 修改現有的會計科目信息。

假設情境

會計人員需要修改現有科目的名稱或類型。輸入新的科目信息後，點擊「修改」按鈕，前端會調用 UpdateAccount API。

運作流程

1. 前端將更新後的科目資料打包成 JSON 格式，並發送 PUT 請求到 UpdateAccount API：

   {
       "ACCOUNT_NO": "3001",
       "ACCOUNT_NAME": "投資收益調整",
       "ACCOUNT_TYPE": "收益"
   }
   

2. API 調用服務層方法，根據科目編號查詢資料庫並進行更新操作。
3. 返回操作結果。

輸入參數（InputList: Account_InputVo）

• ACCOUNT_NO：科目編號（如 "3001"）。
• ACCOUNT_NAME：科目名稱（如 "投資收益調整"）。
• ACCOUNT_TYPE：科目類型（如 "收益"）。

輸出結果

• RESULT_CODE：操作狀態碼，例如 "S0000001" 代表成功。
• RESULT_MESSAGE：操作結果的描述，例如 "修改成功"。

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "修改成功"
}

4. 刪除科目（DeleteAccount）

• 授權：需要 [Authorize] 屬性，必須經過身份驗證的用戶才能調用。

目的

• 刪除指定的會計科目。

假設情境

會計人員需要刪除一個不再使用的科目。點擊「刪除」按鈕，前端會調用 DeleteAccount API。

運作流程

1. 前端發送 DELETE 請求到 DeleteAccount API，包含要刪除的科目編號：

   {
       "ACCOUNT_NO": "3001"
   }
   

2. API 調用服務層方法，根據科目編號進行刪除操作。
3. 返回操作結果。

輸入參數（InputList: Account_InputVo）

• ACCOUNT_NO：科目編號（如 "3001"）。

輸出結果

• RESULT_CODE：操作狀態碼，例如 "S0000001" 代表成功。
• RESULT_MESSAGE：操作結果的描述，例如 "刪除成功"。

範例結果

{
    "RESULT_CODE": "S0000001",
    "RESULT_MESSAGE": "刪除成功"
}

這是 SETM003Controller API 文件的系統說明，包含了查詢、新增、修改和刪除會計科目的功能，並詳細描述了每個 API 方法的運作流程、假設情境、輸入參數與輸出結果。