다른 시스템/서비스 연계
다른 시스템/서비스와의 연계
다른 시스템 또는 서비스와 연동하려면, 해당 시스템 및 서비스가 다음과 같은 기능을 갖추고 있어야 합니다.
- 지정된 PC(윈도우)에서 명령어를 실행할 수 있습니다.
- 지정된 PC(윈도우)의 파일을 가져올 수 있습니다.
RoboBuddy Assist가 다른 시스템 또는 서비스로 전달할 수 있는 정보는 다음과 같습니다.
- 홈 화면 및 아카이브 뷰 화면에 표시되는 날짜에 해당하는 실행 파일별 작업 정보
- 아카이브 리포트 화면에 표시되는 날짜별 작업 수 통계 정보
현재 시점부터 최대 365일分の 정보를 CSV 파일로 다른 시스템 또는 서비스에 데이터를 전송할 수 있습니다.
※ 화면에서 UI 조작 없이 CSV 파일로 출력할 수 있습니다.
※ Enterprise 버전에서만 사용할 수 있습니다.
연동하는 기본적인 흐름
여기서는 연동하는 예시로 당사 제품인
AI Agent Robot Controller
를 예시로 RoboBuddy Assist
가 실행 중인 윈도우와의 연동 방법을 설명드리겠습니다.
참고로 RBF의 그리드 네트워크를 통해 PC가 회사에서 원격 근무 등으로 가정으로 이동된 경우 등
RBF + RoboBuddy Assist
가 실행 중인 PC의 CSV 파일 출력 및 취득이 가능합니다.
-
AI Agent Robot Controller
에서 대상 사용자의 윈도우에 있는RoboBuddyAsist.exe
를 실행합니다. -
RoboBuddyAsist.exe
가 출력한 CSV 파일을AI Agent Robot Controller
에서 가져옵니다. -
AI Agent Robot Controller
에서 가져온 다중 사용자의 CSV 파일(UI 정보)을 집계하여 웹 서비스 등에 등록합니다.
RoboBuddyAsist.exe 명령어 인수
인수 | 설명 |
---|---|
-csvout=arcrep |
아카이브 보고서 화면에 표시되는 일별 작업 수 통계 목록을 CSV 파일로 출력합니다. |
-csvout=arcview |
홈 화면 및 아카이브 뷰 화면에 표시되는 실행 파일 작업 수를 일별로 CSV 파일로 출력합니다. |
CSV 파일로 출력하려면 위의 두 가지 중 하나를 반드시 지정해야 합니다.
인수의 문자는 대소문자를 구분하지 않습니다.
이미 RoboBuddyAist.exe
가 PC에서 실행 중이어도 명령어로 실행됩니다.
인수를 잘못 지정하거나 처리 실패 시 오류 메시지 상자는 표시되지 않습니다.
기본(기본값) CSV 파일 출력 경로는,
[설치 폴더]⁄RoboBuddyAssist⁄CSV
기본(기본값) CSV 파일 이름
-csvout=arcrep : ArcRep.csv
-csvout=arcview : ArcView.csv
CSV 파일 출력 인수에 대한 옵션 인수
인수 | 설명 |
---|---|
-csvpastdays=[Days] | [Days]에는 출력하려는 과거 일수를 지정합니다. 0 : 오늘의 현재 데이터만 출력합니다. 1~365 : 오늘부터 지정된 과거 일수까지의 데이터를 출력합니다. 366 이상을 지정하면 365일까지 됩니다. 과거 일수 데이터가 없는 날짜(휴일로 UI 데이터가 없는 경우 등)는 출력되지 않습니다. 인수를 지정하지 않으면 30으로 설정됩니다. |
-csvfile=[FileName] | [FileName]에는 출력할 파일의 전체 경로를 지정합니다. 기본 경로와 파일명을 변경하려는 경우에 지정합니다. 공백 문자가 있는 경우 이중 따옴표 “~“로 묶어야 합니다. |
-csvutf8 | 출력할 파일의 문자 코드를 UTF-8로 지정할 경우 지정합니다. BOM은 추가되지 않습니다. 인수를 지정하지 않을 경우 윈도우의 기본 문자 코드가 사용됩니다. US:CP437, KR:CP949, JP:CP932 |
-csvtsv | CSV의 구분 문자를 콤마[ , ]에서 TAB(0x09) 코드로 출력합니다. 확장자는 .csv → .tsv로 변경됩니다. 주로 프로그램에서 파일 데이터를 읽어들일 때 지정합니다. CSV 파일에서는 모든 데이터가 “~“로 둘러싸입니다. TSV 파일에서는 모든 데이터가 “~“로 둘러싸이지 않습니다. |
-csvmsgout | 디버그 시 오류 메시지 상자를 표시하려면 지정합니다. |
-csvpwd=[PWD] | 암호화된 파일로 출력하려면 비밀번호를 지정합니다. [PWD]의 비밀번호 지정은 1~64자(바이트) 범위에서 지정합니다. 공백 문자가 있는 경우 이중 따옴표 “~“로 둘러싸야 합니다. |
-csvdecrypt | 암호화된 파일을 복호화합니다. 복호화 시에는 반드시 인자 -csvpwd 를 지정하고 암호화 시와 동일한 비밀번호를 지정해야 합니다. |
-csvfile | 인수를 지정하면 지정된 파일이 복호화됩니다. |
예제
Archive Report 화면에 표시되는 목록을 오늘부터 365일까지 CSV 파일로 출력
RoboBuddyAsist.exe -csvout=arcrep -csvpastdays=365 -csvfile="C:/Temp/ArcRepList.csv"
Archive Report 화면에 표시되는 목록을 오늘부터 365일까지 CSV 파일로 출력
RoboBuddyAsist.exe -csvout=arcview -csvpastdays=365 -csvfile="C:/Temp/ArcViewList.csv"
AI 에이전트 로봇 컨트롤러의 작업 명령 등록
AI 에이전트 로봇 컨트롤러의 작업 명령 등록을 위한 참고 설정은 다음과 같습니다.
항목명 | 지정 |
---|---|
작업 명령 제목 | RoboBuddy UI 정보 취득 |
통신 상대방의 Robo 번호 | [Robo 번호에 있는 프로그램을 실행]을 지정합니다. 실행할 프로그램은 대상 PC(윈도우: RBF Host)에 있는 RoboBuddyAsist.exe를 지정합니다. 다중 사용자에서 데이터를 수집하는 경우 동일한 경로로 통일하는 것을 권장합니다. [통신 대상 Robo No.]를 지정해야 합니다. 통신 대상 Robo No.의 통신 타임아웃은 10초 이상으로 지정해야 합니다. CSV 파일 출력 처리 시간보다 긴 통신 타임아웃을 지정해야 합니다. 통신 타임아웃 설정은 [Home] 화면에서 대상 Robo No.(PC)를 선택한 후 [Set RBF Host Robo No.] 화면에서 [Set Com] 버튼을 클릭합니다. [Set Communication for RBF Host Robo No.] 화면에서 통신 타임아웃을 지정합니다. |
사용할 스크립트 | None (사용하지 않음)을 지정합니다. |
프로그램 입력 인수 | 위의 인수 설명을 참조하십시오. |
프로그램 성공, 종료 코드 | 0(제로)를 지정합니다 (하한: 0, 상한: 0).RoboBuddyAsist.exe 를 실행하여 파일을 정상적으로 출력하면 종료 코드 0(제로)를 반환합니다. |
실행 프로그램의 창 표시 | Hide를 지정합니다. 기본적으로 화면이 표시되지 않지만, Hide(비표시)를 지정합니다. |
데스크톱 화면 사용 | Yes를 지정하고 Retry에 [Until Desktop](데스크톱 화면이 될 때까지)를 지정합니다. 즉, 윈도우에로그인되면 실행되도록 지정합니다. Window의 시작에 시간이 걸릴 수 있으므로 [Delay Startup]에는 180초를 지정합니다. |
위의 설정을 Job Command로 등록합니다.
다음으로, 위의 Job Command의 Run Job(Job 실행) 화면을 열고 실행 일정을 저장합니다.
Job Command 실행은 [주 단위로 실행]을 선택하고
요일 : 월~금
시간 : 09:00
을 선택하여 저장합니다.
여기서는 평일 09:00(출근 시간)에 전일까지의 조작 정보를 수집하도록 설정했습니다.
다음으로 작업 정보를 집계한 정보를 AI Agent Robot Controller
의 PC에 가져오는 Job Command를 생성합니다.
Job Command에 등록할 프로그램은,
- RBF API
FileTransfer()
를 통해 CSV 파일을AI Agent Robot Controller
의 PC에 가져오기 (파일 전송) - 사용자별 CSV 파일에서 작업(UI) 정보 집계
- 필요에 따라 다른 시스템/서비스에 집계 데이터 등록
을 작성하고, 해당 프로그램을 Job 제목 RoboBuddy UI 정보 집계
로 등록합니다.
위의 RoboBuddy UI 정보 집계
Job Command의 실행은 RoboBuddy UI 정보 취득
과 동일
[주 단위 실행]을 선택하고
요일 : 월~금
시간 : 10:00
을 선택하고 저장합니다. 여기서는 평일 10:00에 조작 정보를 집계하도록 지정했습니다.
위의 두 개의 Job Command 등록이 완료되면, Job Command를 실행하여 완료됩니다.
ArcReport.csv 파일 열 데이터 설명
1행에는 열의 항목명이 출력됩니다.
열명 | 설명 |
---|---|
Elapsed days | 오늘 날짜로부터 경과일수 (서식: %d) 0 : 오늘 1~365 : 오늘부터 지정된 과거 일수 |
Date | 데이터를 취득한 날짜 |
Year | 데이터를 취득한 서기 연도 (서식: %d) |
Month | 데이터를 수집한 월 (서식: %d) |
Day | 데이터를 수집한 날짜 (서식: %d) |
HP | HP 수준 (단위: %[퍼센트], 서식: %d) |
Click | 클릭 총 수 (서식: %llu). 휠 조작 수는 포함되지 않습니다. 데스크톱 화면(배경 표시 부분)의 클릭도 포함되지 않습니다. |
KeyPress | 키보드 버튼을 눌렀을 때의 총 수 (서식: %llu). 휠 조작 수는 포함되지 않습니다. 키보드의 눌림 수는 키 버튼의 장시간 눌림으로 인한 연속 문자 입력의 눌림 수는 포함되지 않습니다. |
Mouse Move(m) | 마우스 커서의 이동 거리 (단위: 미터, 소수점 이하 2자리까지 출력) |
MK Events | Click과 KeyPress의 합계 (서식: %llu) |
MK 중앙 평균값 | MK 중앙 평균값 (서식: %llu) |
UI Start | 첫 번째 조작이 시작된 시간 (서식: %02d:%02d) |
UI End | 마지막으로 조작한 시간 (서식: %02d:%02d). PC를 날짜를 넘어 조작한 경우, UI End 시간은 24:00으로 표시됩니다. |
Elapsed | 작업 소요 시간 (UI End - UI Start) (서식: %02d:%02d) |
※ 화면에서 CSV 파일로 출력 시, 열별로 정렬된 표시 순서대로 CSV 파일에 출력되지만, 프로그램에서 읽어들일 경우 조건이므로 반드시 날짜가 새로운 순서로 출력됩니다.
ArcView.csv 파일 열 데이터 설명
1행에는 열의 항목명이 출력됩니다.
열명 | 설명 |
---|---|
Elapsed days | 오늘 날짜로부터 경과일수 (서식: %d) 0 : 오늘 1~365 : 오늘부터 지정된 과거 일수 |
Date | 데이터를 취득한 날짜 |
Year | 데이터를 취득한 서기 연도 (서식: %d) |
월 | 데이터를 수집한 월 (서식: %d) |
일 | 데이터를 수집한 날짜 (서식: %d) |
번호 | 시퀀스 번호 (서식: %d) 시작 1부터 실행 파일로 입력된 분 단위의 시퀀스에 번호가 출력됩니다. |
Exec Name | 실행한 실행 파일 이름 (확장자 .exe는 출력되지 않습니다) |
Window Text | 실행 파일이 표시한 창 화면에서 마지막으로 조작한 창 제목 이름 |
UI Rate | 전체 조작의 조작률 (실행 파일의 MK 이벤트 / MK 이벤트 총수) (서식: %2.1f) |
UI Start | 실행 파일의 조작을 시작한 시간 (서식: %02d:%02d:%02d) |
UI End | 실행 파일을 마지막으로 조작한 시간 (서식: %02d:%02d:%02d) 날짜를 넘어 조작한 경우, UI End 시간은 24:00:00으로 출력됩니다. Update 버튼으로 표시 데이터를 업데이트하고, 저장 사이클(기본 1분 사이클로 집계)이 경과한 후 날짜를 넘어간 경우, 다음 날의 집계 대상이 됩니다. |
Click | 실행 파일에서 마우스 클릭 조작을 수행한 횟수 (서식: %llu) 휠 조작 횟수는 포함되지 않습니다. |
KeyPress | 실행 파일에서 키 버튼을 눌렀을 때의 횟수 (서식: %llu) 키 버튼의 장시간 눌러서 연속 문자 입력 시의 횟수는 포함되지 않습니다. |
※ 화면에서 CSV 파일 출력은 열별로 정렬된 표시 순서대로 CSV 파일로 출력되지만, 프로그램에서 읽어들일 경우 조건이므로 반드시 날짜가 새로운 순서로 출력됩니다.