다른 시스템/서비스 연계

다른 시스템/서비스와의 연계

다른 시스템 또는 서비스와 연동하려면, 해당 시스템 및 서비스가 다음과 같은 기능을 갖추고 있어야 합니다.

  1. 지정된 PC(윈도우)에서 명령어를 실행할 수 있습니다.
  2. 지정된 PC(윈도우)의 파일을 가져올 수 있습니다.

RoboBuddy Assist가 다른 시스템 또는 서비스로 전달할 수 있는 정보는 다음과 같습니다.

  1. 홈 화면 및 아카이브 뷰 화면에 표시되는 날짜에 해당하는 실행 파일별 작업 정보
  2. 아카이브 리포트 화면에 표시되는 날짜별 작업 수 통계 정보

현재 시점부터 최대 365일分の 정보를 CSV 파일로 다른 시스템 또는 서비스에 데이터를 전송할 수 있습니다.
※ 화면에서 UI 조작 없이 CSV 파일로 출력할 수 있습니다.
※ Enterprise 버전에서만 사용할 수 있습니다.

연동하는 기본적인 흐름

여기서는 연동하는 예시로 당사 제품인
AI Agent Robot Controller를 예시로 RoboBuddy Assist가 실행 중인 윈도우와의 연동 방법을 설명드리겠습니다.

참고로 RBF의 그리드 네트워크를 통해 PC가 회사에서 원격 근무 등으로 가정으로 이동된 경우 등
RBF + RoboBuddy Assist가 실행 중인 PC의 CSV 파일 출력 및 취득이 가능합니다.

  1. AI Agent Robot Controller에서 대상 사용자의 윈도우에 있는 RoboBuddyAsist.exe를 실행합니다.

    Run Command

  2. RoboBuddyAsist.exe가 출력한 CSV 파일을 AI Agent Robot Controller에서 가져옵니다.

    Run Command

  3. 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 인수를 지정하면 지정된 파일이 복호화됩니다.

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 파일로 출력되지만, 프로그램에서 읽어들일 경우 조건이므로 반드시 날짜가 새로운 순서로 출력됩니다.