編 號: I005023
日 期: 2021-04-15
目錄
方法一、701ServerSQL 接收到訊息時，同時主動轉發第三方
方法二、701ClientSQL 定時或即時轉成文字檔，由第三方軟體自行提取
方法三、控制器直接上雲端(企業版系列網路型控制器主動傳送記錄功能)
3-1 控制器於事件發生當下直接以文字訊息上傳雲端，不需等待確認
3-2 控制器於事件發生當下直接將HEX訊息上傳雲端，需等待確認後才傳下一筆
方法五、使用11v版701 Server Data Base資料庫取得
一、基本介紹：
不同的跨平台系統如考勤軟體、中央監控系統、監視系統等需使用即時門禁記錄，來進行報表分析或警報連動功能，茂旭資訊提供以下四種方式讓異質第三方平台能取得即時記錄
二、檔案系統與資料庫模式支援的匯出方式(事件紀錄取得方式)
方法一、701ServerSQL 接收到訊息時，同時主動轉發第三方
方法二、701ClientSQL 定時或即時轉成文字檔，由第三方軟體自行提取
方法三、控制器直接上雲端(企業版系列網路型控制器主動傳送記錄功能)
方法四、利用701門禁軟體的.msg單日記錄檔
方法五、使用10v版701 Server Data Base資料庫取得
三、紀錄匯出方式詳細介紹:
方法一、701ServerSQL 接收到訊息時，同時主動轉發第三方
參考文件➔ 701ServerSQL轉傳訊息Event Log到第二Server範例教學
方法二、701ClientSQL 定時或即時轉成文字檔，由第三方軟體自行提取
搭配轉出所有記錄的701ClientSQL軟體版本，設定〝轉成卡鐘格式〝來即時轉出控制器事件記錄的.txt文字檔到指定路徑，跨平台系統可利用所轉出的文字檔來執行所需功能；而所轉出的文字檔內容可依照需求自行設定欄位與格式，設定方式可參照下圖：
方法三、控制器直接上雲端(企業版系列網路型控制器主動傳送記錄功能)
E系列TCPIP網路型控制器具備主動發送訊息功能，可設定遠端Server IP並提供有兩種訊息發送格式：
3-1 控制器於事件發生當下直接以文字訊息上傳雲端，不需等待確認
Message Server Port 設為[主動傳送]單向通知不等待回覆(8031)：
以文字檔text本文方式發送，發送後無需Server端確認便自動刪除訊息；由於此模式不等待回覆，故無需設定第二組IP位址。
3-2 控制器於事件發生當下直接將HEX訊息上傳雲端，需等待確認後才傳下一筆
Message Server Port 設為[主動傳送]雙向確認須等待回覆(8033)：
以SOYAL communication Protocol 編碼方式傳送(HEX格式)，送出訊息後需待Server端送出確認訊息才刪除已發送訊息；此模式需接收確認訊息，可設定第二組IP位址，主控端未收到確認訊息超過五秒後，會自動傳送訊息至第二組備用IP位址。
方法四、利用701門禁軟體的.msg單日記錄檔
701軟體於收取到事件log記錄後產生〝日期檔名.msg〞即為系統訊息記錄檔，而701 Server可設定備份第二路徑，於軟體收取到事件log時同時產生同一份.msg事件檔到所指定備份路徑，設定方式如下圖：
而下圖為訊息記錄檔.msg的資料格式定義，第三方平台能藉此資料用以解析所需要的資訊：
方法五、使用V11版701 Server Data Base資料庫取得
茂旭資訊V11版本701 Server 軟體支援既有File Base以及Data Base軟體架構，而選用Data Base時第三方平台可以直接於資料庫內的eventlog資料表內取得所需的即時事件資訊，以下為eventlog資料表各欄位定義：
Eventlog 格式說明請參考 ➤附錄一: Eventlog 格式
方法六、輸出文字格式
支援轉出格式 ANSI、UTF-8、UTF-8-BOM
四、第三方軟體檔案匯入701Client軟體方式
基本介紹:
SOYAL控制器主要由701ServerSQL與701ClientSQL進行門禁管控與卡片資料管理，若中大型企業主要使用第三方軟體進行管理時，可透過軟體開發方式主動更新卡片資料至701ClientSQL軟體系統，免除人資單位需同時管理多個軟體的操作流程。
701ClientSQL支援第三方軟體主動更新卡片資料並自動下載至控制器，可設定固定時間自動匯入與下載，請參考以下流程:
Step1. 開啟701ClientSQL > 工具 > 卡片匯出入格式
Step2. 勾選定時自動匯入使用者資料並設定時間
Step3. 可勾選匯入時主動下載至控制器
*請依需求勾選，不勾選時須手動於701Client軟體- F下載進行下載動作
Step4. 設定檔案路徑與檔案名稱
Step5. 確認時間到之後確認8.用戶卡片資料更新成功即可，選擇同時下載至控制器亦可進行刷卡測試。
附錄一 : Eventlog 資料格式
| Table | Linked to | Example | Explanation |
| *REC_INDEX | sequences no. | ||
| TM_EVENT | Actual date & time of event log | ||
| TM_ACK | confirming alarm notified time (currently not available) | ||
| TM_REC | Event log recorded by system date & time | ||
| CTL_TYPE | Controller Type | ||
| CTL_NODE | Node ID of the controller | ||
| SUB_NODE | Subnode ID, controller under multi door control panel | ||
| DOORNO | Door_id of tbl_areadoorname | 0x01 refer to Door_id 1 | Door no of the controller/reader |
| LOG_CODE | Function code MXX, refer to "Message File Structure" Function Code define | ||
| LOG_SUBCODE | Subcode for DUTY refer to protocol 2.11.3 Duty Key Value 00 Duty ON, 01=Duty OFF, etc | ||
| LOG_SUBFUNC | Function subcode for example on M29 Di status has changed SubCode 00=OFF; 01=ON | ||
| LOG_EXTCODE | Extension code for weighted value command such as 20*. For example, setting reader as anti passback, access differentiation between IN （0xd0) OUT(0x90) code is define here | ||
| LOG_LEVEL | reserved | ||
| LOG_LEN | return length polling command H & E series length difference | ||
| LOG_BUFFER | polling return actual time (EVENT LOG FORMAT after date&time, from card no. #11 onward) --the message obtain like sending command 25H | ||
| LOG_NUMBER | |||
| USER_ADDR | ADDR_OF_CTL of tbl_users_profile | ||
| TAG_UID | TAG64 of tbl_tags_uid | ||
| TAG_PAY | SOR deduction | ||
| TAG_BALANCE | SOR balance | ||
| AREA_CODE | reserved | ||
| LOG_TYPE | reserved | ||
| LOG_IMAGE | picture of user (if picture data is saved) | ||
| LOG_FLAG | reserved | ||
| ACK_ADM_ID | user confirming the alarm notification,related to ack alarm (TM_ACK) | ||
| Details | Additional feature on 10.5 | ||
| LOG_PROMPT | Additional feature on 10.5 |