장치
장치 탭에서는 트랜잭션 장치를 추가, 편집, 활성화, 비활성화 및 삭제합니다. 트랜잭션 장치 연결 유형을 설정하고, 트랜잭션 정보 필터 조건을 지정하고, 카메라를 페어링하고, 화면 표시 형식을 선택합니다.
장치 추가
트랜잭션 장치 추가하기:
- 추가를 클릭합니다. 트랜잭션 장치 추가 마법사 창이 나타납니다.
- 이름 필드에 이 장치를 식별할 수 있는 이름을 입력합니다.
- Transactions 소스 드롭다운 메뉴에서 트랜잭션 소스를 선택합니다. 트랜잭션 소스는 장치를 식별하는 하나의 방식이며, 실제 작동에는 영향을 미치지 않습니다.
- 연결 유형 드롭다운 메뉴에서 다음 연결 유형 중 하나를 선택합니다.
- TCP: IP 주소와 포트 필드에 소스의 네트워크 정보를 입력합니다.
- 직렬 포트: 모든 설정이 연결 소스와 일치하는지 확인합니다.
- Surveillance Station WebAPI: IP 주소와 포트를 입력하여 연결 상태를 확인합니다. 필수 필드는 아니지만 잘못 설정하면 연결이 해제되거나 기타 문제가 발생할 수 있습니다. 보다 자세한 내용은 아래 Surveillance Station WebAPI 섹션을 참조하십시오.
- 다음을 클릭하여 데이터 정의 설정을 계속합니다. 연결 형식으로 Surveillance Station WebAPI를 선택한 경우, 디스플레이 설정으로 이동합니다.
- 올바른 인코딩 방식을 선택하고 원시 데이터 수집 시작을 클릭한 후 장치에 데이터를 입력합니다. 수신된 데이터는 원시 데이터 필드에 표시됩니다.
- 트랜잭션 시작 및 종료 규칙을 설정합니다.
- 오른쪽 상단 모서리의 버튼을 클릭하여 필터 규칙을 추가할 수 있습니다. 문자를 무시하고, 줄 바꿈 또는 다른 문자로 교체할 수 있습니다.
- 필터링된 데이터 결과는 필터링된 데이터 필드에 직접 표시됩니다. 그리고 해당 데이터는 원본 데이터에 표시됩니다.
- 다음을 클릭하여 디스플레이 설정을 계속 진행합니다.
- 페어링된 카메라에서 이 장치용으로 페어링된 카메라를 설정할지 여부를 선택합니다.
- 화면 표시에서 트랜잭션 데이터를 설정하여 라이브 뷰와 비디오 클립에서 표시할 수 있습니다.
- 종료를 클릭하여 설정을 완료합니다.
제한 사항:
- 장치 이름은 대소문자를 구분합니다. 1~32자의 Unicode 문자를 사용할 수 있으며 다음 기호들은 제외됩니다.
! " # $ % & ' ( ) * + , / : ; < = > ? @ [ ] \ ^ ` { } | ~
- 인코딩 목록에 사용하는 인코딩이 없는 경우, 수동으로 인코딩을 입력할 수도 있습니다.
- 필터 조건의 경우, 제어 문자를 필터링하려면 "<" and ">" 안에 문자를 포함하십시오.
- 페어링된 카메라를 설정하는 경우, 라이브 뷰와 관련 녹화물 클립에서 카메라와 트랜잭션 데이터를 볼 수 있습니다.
장치 편집
트랜잭션 장치 편집하기:
- 수정하려는 장치를 선택하고 편집 을 클릭합니다. 또는 카메라를 더블 클릭하여 설정을 변경할 수도 있습니다.
- 고급 페이지에서 사용자 정의 이벤트를 설정합니다. 동작 규칙, 라이브 뷰 경고 및 알림에서 이를 사용할 수 있습니다.
- 종료를 클릭하여 변경 사항을 저장합니다.
장치를 활성화 또는 비활성화합니다.
지원되는 모든 동작을 관리하려면 먼저 새 장치를 활성화해야 합니다.
장치 활성화 또는 비활성화하기:
- 활성화/비활성화하려는 장치를 선택한 다음 활성화 드롭다운 메뉴에서 활성화 또는 비활성화를 클릭합니다.
참고:
- 장치를 비활성화해도 해당 설정은 삭제되지 않습니다.
장치 삭제
- 삭제하려는 장치를 선택한 다음 삭제를 클릭합니다.
- 확인 창이 표시됩니다. 장치의 트랜잭션을 유지하기로 선택한 경우 예를 클릭하여 계속합니다.
참고:
- 장치를 삭제할 때 모든 트랜잭션을 삭제하도록 선택하면 잠겨 있는 트랜잭션도 Surveillance Station에서 영구 제거됩니다.
Surveillance Station Web API
Surveillance Station Web API는 사용자 장치를 더욱 간편하게 연결하는 방식을 제공하고, 사양에 따른 형식으로 Web API 요청을 전송하고, 트랜잭션 데이터를 기록합니다.
Web API 요청을 전송하는 표준 형식:
- API: SYNO.SurveillanceStation.Transactions는 트랜잭션 정보를 기록하기 위한 다음과 같은 4가지 유형의 메서드(Begin, Complete, Cancel 및 AppendData)를 제공합니다.
Begin:
Surveillance Station에 트랜잭션의 기록을 시작하도록 알립니다. 다음 매개변수를 포함합니다:
- device_name: 문자열 유형 - Surveillance Station의 트랜잭션 장치 이름.
- session_id: 문자열 유형 - 트랜잭션 세션 ID.
- timeout: 정수 유형 - 트랜잭션 시간 제한(초). 트랜잭션 시간 제한이 초과되면 트랜잭션은 자동으로 종료됩니다.
Complete:
Surveillance Station에 트랜잭션을 종료하도록 알리고 트랜잭션을 완료합니다. 다음 매개변수를 포함합니다:
- device_name: 문자열 유형 - Surveillance Station의 트랜잭션 장치 이름.
- session_id: 문자열 유형 - 트랜잭션 세션 ID.
Cancel:
Surveillance Station에 트랜잭션을 종료하도록 알리고 트랜잭션을 취소합니다. 다음 매개변수를 포함합니다:
- device_name: 문자열 유형 - Surveillance Station의 트랜잭션 장치 이름.
- session_id: 문자열 유형 - 트랜잭션 세션 ID.
AppendData:
Surveillance Station에 트랜잭션의 내용을 기록하도록 알립니다. 다음 매개변수를 포함합니다:
- device_name: 문자열 유형 - Surveillance Station의 트랜잭션 장치 이름.
- session_id: 문자열 유형 - 트랜잭션 세션 ID.
- content: 문자열 유형 - 트랜잭션의 내용. 들어오는 각각의 데이터는 별도의 줄에 작성되지만 \ n을 사용하여 들어오는 데이터에서 줄 바꿈을 할 수 있습니다.
- 기본 요청 형식: http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="{method}"&version=1&device_name="{device name}"&session_id="{session id}"
Web API 요청 예:
- 트랜잭션 시작:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Begin"&version=1&device_name="POS01"&session_id="1"&timeout=300
- 트랜잭션 기록:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Start\n2017/01/01"
- 트랜잭션 기록:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Pen $40\nBook $300"
- 트랜잭션 기록:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Total $340\nEnd"
- 트랜잭션 종료:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Complete"&version=1&device_name="POS01"&session_id="1"
참고:
- Surveillance Station WebAPI 요청을 전송하기 전에 세션에 로그인해야 합니다. 로그인 방법에 대한 자세한 내용은 Web API 문서를 참조하십시오.
- Session_id는 여러 가지 트랜잭션 이벤트를 구별하기 위해 사용됩니다. 동일한 device_name과 session_id는 같은 기록으로 처리됩니다. 동일한 매개변수가 다시 전송된 경우, 트랜잭션이 완료되거나, 취소되거나, 트랜잭션 시간 제한을 초과할 때까지 Begin 메서드는 무시됩니다. 그 후에 session_id를 다시 사용할 수 있습니다.
- 트랜잭션을 시작한 후 Complete 또는 Cancel 메서드를 수신하기 전에 시간 제한이 초과되면 트랜잭션 기록이 저장되고 미완료로 표시됩니다.