茂旭資訊股份有限公司

會員專區
0
瀏覽紀錄
第三方軟體和異質跨平台系統如何取得SOYAL控制器即時事件記錄?
2021-04-15
編號:I005023

編  號: I005023

日  期: 2021-04-15

目錄

一、基本介紹

二、檔案系統與資料庫模式支援的匯出方式

三、事件紀錄匯出方式詳細介紹

       方法一、701ServerSQL 接收到訊息時,同時主動轉發第三方

       方法二、701ClientSQL 定時或即時轉成文字檔,由第三方軟體自行提取

       方法三、控制器直接上雲端(企業版系列網路型控制器主動傳送記錄功能)

        3-1  控制器於事件發生當下直接以文字訊息上傳雲端,不需等待確認

        3-2  控制器於事件發生當下直接將HEX訊息上傳雲端,需等待確認後才傳下一筆

       方法四、利用701門禁軟體的.msg單日記錄檔

       方法五、使用11v版701 Server Data Base資料庫取得

       方法六、輸出文字格式

四、第三方軟體檔案匯入701ClientSQL軟體方式

        異質軟體主動更新卡片資料並下載到控制器

附錄一 : Eventlog 資料格式


 

一、基本介紹:

不同的跨平台系統如考勤軟體、中央監控系統、監視系統等需使用即時門禁記錄,來進行報表分析或警報連動功能,茂旭資訊提供以下四種方式讓異質第三方平台能取得即時記錄

 

二、檔案系統與資料庫模式支援的匯出方式(事件紀錄取得方式)

方法一、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 資料格式

TableLinked toExampleExplanation
*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

 

瀏覽紀錄
Go Top