# S6.4 - API 端包版撰寫 changelog

## 目錄項目

[TOC]

### CoreAPI

- 修改 CoreMe 增加回傳 config1301-1320 chat專用系統參數並加入容錯機制
- 修改 特定公告 : 取得特定單一系統公告詳細資料 > 檔案附件增加回傳 uuid + mimeType
- 修改 偵錯API(debug/accesstoken) 增加回傳完整的 CoreMe 資訊
- 新增 (`activitylog`)頁面活動紀錄 > 無法取得 ag_aa_sid 則不填寫
- 修改 `系統參數列表` 加入系統參數列表 白名單功能 (如果有設定白名單，則將白名單處理成 int [] 陣列形式傳入，如果沒設定則不用傳 (預設 Null))
- 修改 `取得特定組織系統參數列表` > 不受白名單功能影響
- 新增 Interface_SupportNotifyLib 4.2.0 > 增加公告稽催寄信
- 新增 判斷稽催與通知的 mail 為空的容錯機制
- 修改 系統設定的各項資料統計數據 增加回傳chat teamweb 等相關參數
- 修改 取得暫存公告列表 增加篩選欄位 nn_subject
- 修改 取得組織線上人員列表 移除檢查權限 510
- 修改 取的系統設定的各項資料統計數據 > 增加chat相關功能的事先檢查 , 檢查是否有560的權限才進入取chatcore資料
- 修改 取得個人備忘錄列表 加入最後修改時間排序
- 修改 取的系統設定的各項資料統計數據 > 加入各項資料的權限檢查 ,若沒有該權限則不call 其中資料
- 修改 系統一般登入 加入帳號密碼空值檢查
- 修改 set Session之前 優先執行 Session.ClearAll();
- 修改 個人備忘錄 排序預設為 `pn_sort asc`

### SupportCore

* 修正 "註冊上線人員ID"多人同時呼叫會發生deadlock 的問題
* 修改 "強制離線"不再使用SP p_Agt_OnLine_Delete
* 修改 "新增組織"不再使用SP p_Build_Organization
* 修改 "重新發送公告"不再使用SP p_Ntc_Notice_Copy
* 修改 "刪除個人訊息及附加檔案"不再使用SP p_Psn_Inform_Delete
* 修改 "註冊上線人員ID"不再使用SP p_OnLine_Reg
* 修改 "清除線上登錄的版權人數"不再使用SP p_OnLine_Renew
* 修改 "檢查是否登入"不再使用SP p_OnLine_Update
* 修改 "刪除人員帳號"不再使用SP p_Agt_Account_Delete
* 修改 "匯入人員帳號資訊"支援匯入人員知識群組、知識答案、考試群組設定
* 修改 "匯出部門人員帳號資訊字串"支援匯出人員知識群組、知識答案、考試群組設定
* 修改 權限對應相關功能以支援設定知識答案權限
* 修改 "取得主控台需要的功能參數"回傳參數加上預設值
* 修改 "取得主控台需要的功能參數"新增Chat平台數量限制參數
* 修改 "取得暫存公告列表"增加篩選公告分類參數
* 修正 "取得公告列表"關鍵字搜尋出不符合的項目 的問題
* 修改 "取得系統參數列表"增加系統參數白名單選填參數

### KBAPI

- 修改 特定暫存知識 增加回傳檔案的mimeType
- 修改 附件上傳功能 Drive 增加判斷檔案是否已經被註冊過 ,如果是來自公告的附件 則直接複製一份去註冊 暫存知識附件
- 新增 建立 Support 通知Drive 進行檔案複製
- 新增 刪除知識 發信通知
- 修改 批次刪除知識題目資料(直接刪除) > 增加批次刪除的寄信通知工作
- 修改 審核特定知識審核案件 (特權) > 新增送審 / 刪除送審 / 編輯送審 /審核通過後 會寄信通知
- 新增 編輯審核中知識API
- 修改 取得我的知識閱讀紀錄列表 檢查權限4改成2
- 新增 加入知識搜尋OCR query string 預設為關閉(false) , 並檢查該權限 31 才能執行
- 修改 知識搜尋功能 改為有31權限 就必定會啟用OCR功能進行搜尋
- 新增 刪除個人搜尋紀錄 API
- 新增 特定知識匯出成 word API ( 自帶知識答案html ) 並加入允許跨域
- 修改 取得個人搜尋紀錄列表 加入aa_sid 進行篩選
- 新增 特定知識答案的人員列表 API
- 新增 修改特定知識答案的人員列表 API
- 修改 特定知識答案的人員列表 > 增加篩選 aa_id_name
- 修改 增加所有知識附件的詳細資料回傳mimeType + uuid
- 修改 特定暫存知識 增加回傳uuid
- 修改 特定暫存知識 + 直接發布 (特權) > 檢查是新增 或是知識編輯 >分別寄出相對應的通知信

### KBCore

* 修改 "指定知識取得審核歷史列表"欄位排序移除前贅詞
* 修改 "取得知識群組列表"欄位排序移除前贅詞
* 修改 "取得知識群組成員列表"欄位排序移除前贅詞
* 修改 "取得知識送審群組列表"欄位排序移除前贅詞
* 修改 "取得知識審核群組成員列表"欄位排序移除前贅詞
* 修改 "取得有特定知識答案權限的人員列表"增加選填參數可篩選人員帳號以及名稱
* 優化 "取得人員可檢視的知識"SQL語法
* 修改 "取得有特定知識答案權限的人員列表"分頁參數改為選填
* 新增 取得有特定知識答案權限的人員列表 功能
* 新增 批次更新特定知識答案的人員權限 功能
* 修改 "從搜尋紀錄取得建義搜尋文字列表"增加選填參數可篩選特定人員搜尋過的關鍵字
* 新增 刪除個人搜尋紀錄 功能
* 修改 龍捲風檔案搜尋增加OCR搜尋功能
* 修正 "取得審核知識列表"篩選提出人員名稱功能無效 的問題
* 新增 檢查特定人員是否可審核特定知識審核案件關卡 功能

### ExamAPI

- 新增 標準版考試寄信模組
- 修改 取得難易度列表 (含試題、試卷、考試) > 修改預設排序 dl_sort ASC
- 修改 寄送通知訊息(ExamAnnounce) > 公告和個人訊息使用特定格式 , mail 腳本使用標準格式

### ExamCore

* 修改 "批次調整特定試題分數(手動評分)"拿掉評分說明額外加上的內容
* 修改 "取得考試卷內容"增加回傳手動評分說明

### SurveyAPI

- 發布 SurveyAPI 4.0.0

### SurveyCore

* 修改 "取得管理用問卷列表"小組網站擁有者可以取得所有問卷

### TeamWebAPI
- 修改 小組網站 取得暫存公告列表 增加篩選欄位 nn_subject
- 修改 小組網站稽催寄信功能
- 修改 批次移動檔案或目錄 增加錯誤回傳

### TeamWebCore

* 修正 "新增或更新行事曆事件"全天活動的結束日期會被自動進到隔天 的問題
* 修改 "新增或更新行事曆事件"針對全天活動修正輸入的活動起訖時間
* 修正 "批次刪除檔案"輸入參數數量超過SQL上限 的問題
* 修正 "批次取得目錄或檔案是否位於資源回收桶狀態"輸入參數數量超過SQL上限 的問題
* 修改 "批次刪除檔案目錄"延長SQL timeout時間
* 修改 "取得目錄列表"延長SQL timeout時間
* 修改 "取得目錄及檔案集合列表"延長SQL timeout時間
* 修改 "取得特定目錄中的子目錄與檔案列表"延長SQL timeout時間
* 修改 "取得特定目錄中的子目錄與檔案列表(只取單層)"優化執行效率
* 修改 "取得特定目錄中的子目錄與檔案列表"優化執行效率

### ChatCore

- 新增部分
- 新增 附件預存回覆相關功能
- 新增 取得包含值機狀態的群組人員列表
- 新增 取得特定社群平台分派規則列表功能
- 新增 新增平台支援LINE平台資訊欄位
- 新增 修改平台支援LINE平台資訊欄位
- 新增 新增平台支援FB平台資訊欄位
- 新增 修改平台支援LINE平台資訊欄位
- 新增 特定社群平台支援LINE平台資訊欄位
- 新增 取得LINE官方帳號密鑰與AccessToken
- 新增 取得FB粉絲專頁密鑰與AccessToken
- 新增 若訊息進線時間為非服務時間，向訪客端發送無系統紀錄的自動回覆
- 新增 各、總平台類型啟用平台數量限制
- 新增 建立聊天群組方法

- 修正部分
- 修正 取得預存回覆詳細回傳檔案大小
- 修正 取得個人預存回覆列表回傳檔案大小
- 修正 取得預存回覆增加回傳檔案大小
- 修正 新增預存回覆不再檢查名稱是否重複
- 修正 預存回覆不再檢查名稱是否重複
- 修正 取得預存回覆列表，增加回傳檔案類型描述
- 修正 取得預存回覆詳細，增加回傳檔案類型描述
- 修正 取得個人預存回覆列表，增加回傳檔案類型描述
- 修正 ChatClientCore合併至ChatCore
- 修正 值機狀態切換異常
- 修正 監控案件列表搜尋異常
- 修正 監控案件列表時間區間搜尋結果錯誤
- 修正 新增平台時，若原本就有此平台(status = 0)時， 只需將 status 更新為1 (平台啟用)
- 修正 修改平台啟用狀態，需確認平台是否設定完整，才可啟用平台
- 修正 判斷案件是否在非服務時段處理中，如果在處理中不傳送非服務時段自動回覆
- 修正 ChatCore Client 將DeleteSignalRConnection部分抽離成extension，此extension 可以針對SignalR的部分增加客製功能，並將此extension 裝至ChatCore
- 修正 取得案件訊息詳細資料未撈取SEEN資料表的錯誤
- 修正 內部交談發送訊息未正確顯示已讀\未讀的問題

- 優化部分
- 優化 ChatAPI使用到DB的程式碼片段，移至ChatCore控管
- 優化 將Chat DB部分的Stored procedure移至ChatCore控管

### ChatAPI

- 新增部分
- 新增 特定文字交談群組人員(包含值機狀態)列表
- 新增 判斷 xp_insert_ticket > 回傳 tid = -1 則 加入 非服務時段 的訊息提示 或 LOG
- 新增 取得預存回復列表 / 取得預存回復詳細 > 增加回傳附件 URL
- 新增 取得群組預存回復列表 / 取得群組預存回復詳細 > 增加回傳附件 URL
- 新增 發送訊息 (欄位要有值) > xp_insert_ticket 回傳 tid = -1 則 加入 非服務時段 的訊息提示
- 新增 發送插話 (欄位要有值)> xp_insert_ticket 回傳 tid = -1 則 加入 非服務時段 的訊息提示
- 新增 將前端傳遞之檔案格式對應至系統格式
- 新增 特定社群平台分派規則列表
- 新增 MessageProcessor 類別，為現有類別 Messaging, HolidayRelpy, ServiceReply 類別功能合併併進行抽象化之 abstract 抽象類別
- 新增 取得特定社群平台列表新增LINE平台欄位
- 新增 新增社群平台新增LINE平台欄位
- 新增 更新社群平台資訊新增LINE平台欄位
- 新增 取得 LINE 官方帳號密鑰資訊
- 新增 取得 LINE 官方帳號社群會員資訊
- 新增 發送訊息新增支援LINE欄位
- 新增 MessengerMessageProcessor 支援 LINE 與 Messager平台類型
- 新增 同步第三方平台資訊API 支援LINE 與 Messager
- 新增 建立內部聊天群組API
- 修正部分
- 修正 預存回覆新增用模型 , 輸入欄位 > messagetype 改為 content_type
- 修正 值機狀態更新到錯誤資料表導致狀態紀錄異常的問題
- 修正 無法正常以時間區間篩選監控案件列表問題
- 修正 監控案件列表時間區間搜尋結果錯誤
- 修正 將交談群組人員列表 API 權限改為需要有 文字交談群組權限(5601)或客服移轉權限(180106)
- 修正 客服在對話中輸入訪客敏感字，也會觸發敏感字的BUG
- 修正 發送已讀廣播時，當使用者沒有設定頭像時，不需要串URL給前端，直接回傳NULL給前端
- 修正 LINE與FB 取得平台資訊及密鑰API 添加平台驗證Header(ValidPlatform)
- 修正 結案時滿意度問卷發送對象只發送給web進線的訪客
- 修正 ChatAPI 添加容錯檢查，並將程式中有問題的寫法添加容錯機制
- 修正 服務時段回覆，未Release導致死結問題
- 修正 發送服務時段自動回覆訊息 與 發送非服務時段自動回覆 改寫成處理發送回覆訊息方法
- 修正 八維機器人與使用者對話時，當案件轉為真人情況時，客服人員未接案時，無法看到使用者與機器人的對話內容
- 修正 ChatAPI inbound 所有錯誤訊息，統一訊息格式符合S6規則
- 修正 ChatAPI 將編輯與新增平台中的 SPX 八維 Webhook API Path 改記錄至 Config
- 修正 發送更新案件廣播，先將案件設為已讀
- 修正 取得內部交談歷史紀錄參數，移除url to_aa_sid參數
- 修正 發送內部交談時，自己發送訊息設為已讀，其他聊天群組成員設為未讀
- 修正 ChatAPI 建立內部聊天群組 需有內部訊息權限(180103的)，才能使用此功能
- 修正 將編輯平台中的 SPX 八維 Webhook API Path 改記錄至 Config
- 優化部分
- 優化 ChatAPI使它能夠整合測試
- 優化 ChatAPI使用到DB的程式碼片段，移至ChatCore控管
- 優化 ChatAPI MessageProcess Input Model 規格，將非共通資訊移動至 ModelInboundMessagePayload 集中管理，第一層只保留通用參數

### ChatClientAPI

- 新增部分
- 新增 可讓管理者設定是否要由訪客端顯示來源分類或服務類別
- 修正部分
- 修正 取得訪客 IP 時，以 Header 中 X-Forwarded-For 所帶 IP 資訊優先
- 修正 將移除的ChatClientCore 改為使用 ChatCore
- 修正 添加ChatClientAPI容錯檢查，並將程式中有問題的寫法添加容錯機制

### ChatClientCore

> 已經合併到 ChatCore

### ChatSPXAPI

- 新增部分
- 新增 LINE 官方API實作邏輯(發送回應訊息、發送推播訊息、取得用戶資訊、取得官方帳號基本資訊)
- 新增 LINE Webhook，接收使用者發送至LINE官方帳號的訊息、圖像、視頻、音頻和文件
- 新增 WebhookEventProcessor，統一 Webhook 訊息處理架構
- 新增 OutboundMessagePublisher，統一 Outbound 訊息處理架構
- 新增 FB 官方API實作邏輯(發送回應訊息、取得用戶資訊、取得官方帳號基本資訊)
- 新增 FB 第一次驗證Webhook API
- 新增 FB Webhook，接收使用者發送至FB粉專的訊息、圖像、視頻、音頻和文件
- 新增 ChatbotReplyProcess，統一機器人回應處理
- 修正部分
- 修正 FB 與ChatAPI 取得會員資訊及應用程式密鑰API，添加只供內部API使用平台驗證(ValidPlatform)
- 修正 LINE 與ChatAPI 取得會員資訊及官方帳號密鑰API，添加只供內部API使用平台驗證(ValidPlatform)
- 修正 當無法取得FB與LINE 會員頭像時，增加容錯機制。若沒有會員頭像則不上傳至drive
- 修正 當ChatAPI 同時發送多筆訊息時，同時寫入LOG檔 引發的錯誤。並移除SPXlog 統一由MyLog來記錄LOG
- 修正 D8aiWebhookEventProcessor 將機器人流程更改至介面標準流程
- 修正 LINE和FB 當使用者上傳檔案失敗時，將此錯誤訊息傳遞給客服人員，並記錄LOG
- 修正 LINE和FB 當無法取得使用者詳細資訊時，將訪客識別碼串成訪客加上最後6碼當姓名，並記錄LOG
- 優化部分
- 將ChatSPXAPI 殼層化，使他能夠當殼安裝其他專案客製SPX套件

# 其他客製模組

### (新)Interface-SignalR-Hub-Ext 專案
- 新增部分
- 新增 定義SignalR 刪除連線介面

### (新)Empty-SignalR-Hub-Ext 專案
- 新增部分
- 新增 標準版SignalR 刪除連線流程

### (新) Tradevan-SignalR-Hub-Ext 專案
- 新增部分
- 新增 關貿客製版SignalR 刪除連線流程

### TradevanCore專案
- 新增部分
- 新增 取得一件案時間排序的個人案件列表
- 新增 更新人員擴充資訊方法

### (新)TradevanSPX專案
- 新增部分
- 新增 客製化關貿介接八維傳送的客戶資料
- 新增 關貿客製版 D8AI Webhook

### TradevanAPI專案
- 新增部分
- 新增 取得一件案時間排序的個人案件列表API
- 新增 更新案件及人員擴充資訊 API