CS_AN_AZ_employee_manager

員工經理

使用 Angular 版本 8 作為前端 UI 和 Asp.Net Core 作為後端 Web Api 的管理系統。

範圍

這是一個展示將概念擴展到更大項目的項目。它是一個使用 Angular 和 ASP.Net Core 進行表單驗證的員工管理系統。這些概念是熟悉流行的 JavaScript 框架並將其與 C#/ASP.Net Core 相結合，同時提供 Api 版本控制、控制器端點測試以及為未來功能實現設定整合測試。

使用自動映射器使用資料傳輸物件 (Dtos) 可以保護 Api 的DataEntities目錄中找到的原始實體類別並將其映射到用於特定任務（即獲取、建立和編輯）的類別。

開發堆疊

該應用程式是使用以下工具和框架建立的：

• C#/ASP.Net 核心 2.2

• 角度版本 8.3

• 引導程式4

• SQL Server 或 PostgreSQL 資料庫（在 DbContext 類別中輕鬆設定）

內建端點測試

該項目包含使用 Swagger 建構的 Api 端點測試。這是在啟動時使用的設定服務和 IConfiguration 中的Startup.cs類別中進行設定的。在本機環境中啟動專案後，導覽至https://localhost:5001/swagger以查看測試索引頁面。

設定

為了測試/使用此應用程序，您將需要以下內容：

• Asp.Net Core 2.0 SDK，最好是2.2.1

• Node.js 版本 8 或更高版本

• Angular CLI

• Microsoft SQL Server 或 PostgreSQL 的 pgAdmin

安裝

透過下載 zip 檔案或克隆專案來取得儲存庫。

克隆或解壓縮檔案後，導覽至包含解決方案檔案的目錄：

 ~$ cd src/EmployeeManager/

無論哪種順序，導航到客戶端或 api/伺服器端檔案並安裝它們的依賴項。再次，您將需要安裝 Node.js 和npm以及 .Net Core 2.2 SDK。

對於客戶端相依性：

 ~$ cd src/EmployeeManager/client~$ npm install

確保@angularcli也已安裝：

 # 對於 Angular~$ npm install -g @angular/cli @angular/core

對於伺服器端程式碼，建置和復原相依性和 NuGet 套件：

 ~$ cd src/EmployeeManager/server/~$ dotnet 恢復

運作環境

若要在客戶端執行本機環境：在../client目錄中的終端機/命令框中使用npm script 命令：

 # 對於 Angular 用戶端~$ ng build -options

這將透過angular.json腳本在 API 的wwwroot目錄中輸出縮小的 JavaScript 檔案。

要在伺服器端執行本機環境：使用dotnet 工具在終端機中執行它或使用 Visual Studio 透過CTL + F5運行它

在瀏覽器中導航至localhost:5001 （或 ）以查看目前正在執行的建置。

待辦事項

• 新增授權和登入。

• 啟用按員工姓名搜尋。

已知問題和錯誤

• ApiVersion 2（即 api/v2/endpoint）下的控制器端點類別中的 Update 操作在向伺服器發送成功請求時存在問題，因為 AutoMapper 無法將EmployeeDto綁定到EmployeeUpdateDto ，因此它改用 context 類別在/v1/...路線下的版本 1 上。 （問題已修復）