Views: 14

官方有提供技轉課程，如果有買的公司可以多利用，官方建議使用的版本是Visual Studio 2019。我這篇使用的是Visual Studio 2022為主，好處是可以用Github Copilot 。

本文教學是先將測試版的資料庫與網站先弄回本機進行開發

快速懶人包

1. 從測試環境打包三樣東西，網站目錄、網站資料、資料庫
2. 將網站架設到IIS上
3. 將資料庫還原、設定資料庫帳號等
4. 設定網站目錄權限、資料庫連線
5. 開發網站做一些調整，以利後續開發

開發所需軟體安裝

1. Windows 10/11 專業版 (因為需要IIS)
2. IIS 安裝教學
3. Visual Studio 2022 任一版本，安裝教學，要安裝舊專案範本跟Webform開發支援。
4. MS SQL Server 開發版 連結 (可以直接使用公司某台SQL Server就好)，安裝時選「基本」即可。
5. 資料庫管理工具SSMS 連結　

這幾個裝好後要先把測試環境「架設」回本機，但不用安裝排程、龍捲風搜尋引擎、文件轉檔等功能。

把UOF安裝到本機

複製幾樣東西回來

1. 網站目錄
2. 網站資料
3. 資料庫

複製網站目錄

這邊使用我本機的開發環境截圖，一般正式版的應用程式名稱會是UOF， 測試版的應用程式名稱會是UOFTEST

1. 開啟IIS
2. 對UOF/UOFTEST瀏覽站台目錄
3. 將整個目錄打包成一個zip檔案

瀏覽後直接將全部檔案壓縮

打包網站資料

資料是放在另一個資料夾，如果不清楚放在哪邊可以從網站目錄的Web.config得知

AppSettings > FileStorageFolder

同樣整個目錄右鍵打包。

打包資料庫

這邊可以直接使用資料庫的備份還原，或者使用匯出資料層應用程式，我選擇的是後者，如果碰不到資料庫的話這邊請DBA協助匯出。

檔案名稱不拘，存檔位置我是放在桌面上。

匯出完成後複製檔案

架設網站

複製回來檔案總共有三包，如圖。

1. 網站本體 UOFTEST
2. 網站資料 UOFTESTDATA
3. 網站資料庫 .bacpac

我這邊用的是測試版網站，原因是測試版網站小非常多…，也比較不會有不該看到的資料。

除了資料庫以外都先解壓縮放到對應的目錄，這次抓回來的檔案是UOF 27.5版，所以我把網站資料夾命名成UOF275

1. 網站本體解壓縮後放到C:\WEB\UOFTEST275
2. 網站資料解壓縮後放到D:\UOFTESTDATA275

做好之後先來匯入資料庫

UOF BPM開發環境匯入資料庫

在開發環境當中（我是在本機），選擇資料庫，匯入資料層應用程式。

新資料庫名稱可以自行命名，我習慣用資料庫名稱+日期，用於辨識資料庫是那個日期匯入的版本。重點是不能跟現有資料庫重複。

匯入完成後可以看到資料庫

設定資料庫帳號與連線-（新增資料庫帳號）

一般來說開發時候可以一個帳號有多個資料庫Owner權限，但如果是測試環境會建議一個資料庫一個帳號就好。這個小節要教學如何新增專用帳號

1. 先選SQL Server驗證
2. 填入登入名稱，這是資料庫帳號
3. 填入密碼，這是資料庫密碼
4. 取消強制執行密碼原則
5. 預設資料庫選先前匯入的資料庫

接著切換到使用者對應。

1. 已登入到使用者對應將目標資料庫打勾
2. 資料庫角色成員資格對象：選db_owner打勾
3. 確定，新增帳號完成。

將已有的資料庫帳號加入資料庫存取權限（如果之前已經有建）

同樣是開啟SSMS （SQL Server Management Studio）

我本機開發時候UOF的資料庫都用同一個連線帳號，所以每次改版重新匯入資料庫時候，只需要增加該帳號的權限即可。

使用SSMS以資料庫管理員角色登入後，找到目標帳號→滑鼠右鍵「屬性」

1. 選使用者對應
2. 選資料庫名稱打勾
3. 選db_owner
4. 確定

UOF BPM開發環境架設IIS

大致上的步驟

1. 新增應用程式集區UOF275。
2. 新增應用程式UOF275，指向目錄C:\Web\UOF275。
3. 修改網站目錄權限。
4. 將倒回資料庫至開發環境（下一大項），新增資料庫連線帳密與相關權限。
5. 修改Web.config，設定檔案目錄與資料庫連線。

打開IIS之後先[新增應用程式集區]

名稱隨意，但自己取的要記住，CLR選v4 ，UOF BPM的程式是使用.Net framework 4.8開發的

新增應用程式

修改UOF BPM 開發環境網站目錄權限

要改兩個地方的權限

1. 網站目錄的App_Data，C:\Web\UOF275\App_Data
2. 網站資料的App_Data，D:\UOFTESTDATA275\App_Data

修改網站目錄權限

1. 從這個位置：如果你電腦是有加入AD的，這邊要點「位置」，跳出的AD帳密按下取消，接著選擇自己的電腦。
2. 輸入物件名稱來選取這邊直接輸入IIS AppPool\應用程式集區名稱 ，以我的案例是輸入IIS AppPool\UOF275，大小寫不拘。
3. 按下確定。

這邊名稱顯示只會顯示集區名稱，勾選「允許」，「確定」

修改網站資料權限（略）

跟上一節步驟相同

修改資料庫連線與網站資料目錄位置

我的網站位置是"C:\WEB\UOF275\"，網站相關的設定放置在"C:\WEB\UOF275\web.config"

使用軟體NotePad++或記事本找到下面兩個值。

1. appSettings>FileStorageFolder ，這是網站目錄設定
2. connectionStrings>connectionstring，這是資料庫連線設定

網站資料目錄設定

<add key="FileStorageFolder" value="目錄設定" />

網站資料庫連線設定

<add name="connectionstring" connectionString="data source='資料庫位置';initial catalog='資料庫名稱';User Id='UOF';Password='資料庫密碼';Max Pool Size=300" providerName="System.Data.SqlClient" />

這邊請依照實際您設定填入，資料庫位置如果是裝在本機，可以直接填入「.」。

完工測試

目前大致上把環境架起來了

在網址輸入站台 http://localhost/應用程式名稱/ 以我的開發環境是 http://localhost/uof275/

第一次載入要很久….這是UOF BPM的通病

然後使用測試環境的admin帳號登入看看是否可以使用。

其它為了開發方便的設定

1. 開啟除錯模式，Web.config 改 debug="true"
2. 開啟一等一站台的除錯模式+移除郵件。
3. 刪除各種logo
4. 換一個布景
5. 關掉首頁的各種功能、只留下表單快速簽核。

開啟web.config的除錯模式

搜尋debug，改為這樣

<compilation debug="true" targetFramework="4.8" optimizeCompilations="true">

開啟UOF BPM的除錯模式、移除EMAIL設定

使用admin帳號登入後，系統管理→一般組態設定→基本設定

移除郵件設定

雖然沒有設定排程，應該是不會寄信，不過還是移除掉比較好

勾選顯示錯誤訊息

同樣在基本設定底下，將「顯示錯誤訊息」勾選「啟用」

儲存

刪除Logo

Logo有兩個地方要調整

1. 登入後左上的Logo刪除： 系統管理 > 部門Logo維護
2. 登入畫面的Logo刪除 ： 系統管理 > 一般組態設定 > 基本設定

登入畫面的Logo刪除

登入後左上的Logo刪除

換一個布景

換布景蠻重要的，方便用於區分測試版跟正式版還有開發環境

系統管理 > 一般組態設定 > 基本設定 > 系統介面 > 預設主題 > 時尚簡約

關掉首頁的各種功能、只留下表單快速簽核

在首頁，左下有個設計，進去後就能移除版面了，這個可以大幅加速系統載入

授權問題

如果您測試環境的授權沒有到期，搬家回來是可以正常啟動網站的。

如果使用少遇到有授權問題，可以請恰原廠更換授權檔案（但需要有維護合約） 授權檔案會在程式底下

以我的開發環境是C:\WEB\UOF275\App_Data\License.xml。

刪除這個檔案開發上還是可以正常使用（？），系統會變Trail version，有需求的人可以試試看。

無法啟動系統

錯誤500

如果是看到上面的畫面，資料庫有關的問題居多，可能的幾個問題

1. 無法登入
2. 沒資料庫權限
3. 資料庫名字打錯
4. 資料庫的IP打錯
5. 帳密打錯
6. 資料庫沒啟動

我會先檢查Webconfig的資料庫設定，然後用那組帳密使用SSMS登入。

圖片無法顯示

這個問題會是Webconfig的FileStorageFolder有問題

1. 指向的路徑錯誤，要指向網站上傳資料的地方。
2. 路徑沒錯，但沒有設定權限。
3. 資料庫跟網站資料夾其中一個錯誤，例如用了正式版的資料庫，但資料夾的資料是測試版的。