AUD PLATFORM
페이지 트리

버전 비교

이전 버전 1

changes.mady.by.user guide

에 저장

비교대상

새 버전 현재

changes.mady.by.user guide

에 저장

키

  • 이 줄이 추가되었습니다.
  • 이 줄이 삭제되었습니다.
  • 서식이 변경되었습니다.

Easy Heading Macro
titleExpandClickabletrue
navigationTitle목차
navigationExpandOptioncollapse-all-but-headings-1

작성자 : 장민지 김원정  / 검수자 : - 

Release No. 7.0.500.20260122-11 

Process Bot 개요

Process Bot은 RPA처럼 수행되며 복잡한 업무 Logic이나 Process를 처리하는 기술입니다.

화면에서 간단한 드래그 앤 드롭으로 이벤트별 동작을 쉽게 구현할 수 있습니다.

또한 화면이 Workflow 기반으로 구성되어 있어 단계별 또는 전체 프로세스 흐름을 한 눈에 파악할 수 있습니다.

Process Bot 실행 방법

i-AUD Designer 상단 메뉴 영역에서 [Process Bot]을 선택합니다.

image2024-4-16_16-25-35.pngImage Removed

화면 구성 설명

Process Bot 화면은 모듈 목록 , 모듈 배치 영역 , 로그 정보 표시 영역 , 전체 표시 영역으로 표시됩니다.

image2024-4-16_15-11-52.pngImage Removed

1. 모듈 목록 영역

모듈 목록 영역은 [Objects] 탭과 [Activities] 탭으로 구성되어 있습니다.

Objects

현재 보고서에 생성된 컨트롤 목록을 표시합니다.

Image Removed

Activities

워크플로우 구성에 사용할 수 있는 모듈 목록을 제공합니다. 모듈은 크게 두 가지로 구분됩니다.

  • 시스템 모듈: 제품 내에 기본적으로 내장되어 제공되는 표준 모듈입니다.
  • 사용자 정의 모듈: 사용자가 직접 작성한 스크립트(Script)를 모듈화하여 등록한 커스텀 모듈입니다.
Image Removed
정보

사용자 정의 모듈 작성 방법은 Module Editor를 참고하세요.

2. 모듈 배치 영역

보고서에서 사용 중인 컨트롤, 모듈 노드(Node) 및 각각의 연결선(Link)의 배치 정보를 표현하는 화면입니다.

3. 로그 정보 영역

모듈 실행에 대한 로그 정보를 표시하는 화면입니다.

정보

Process Bot 창이 실행된 상태로 보고서 동작을 수행하면 로그 정보가 표시됩니다.

4. 전체 화면 표시 영역

모듈 배치 영역을 전체 화면으로 표시하는 화면입니다.

Process Bot으로 인터랙션 구현하기

Process Bot을 활용하여 Button을 클릭했을 때, 메시지 창이 띄워지는 동작을 구현해 보겠습니다.

Step 1. 컨트롤 생성

보고서에서 클릭 시 사용할 [Button] 컨트롤을 생성합니다.

Image Removed
Image Removed

정보

Button의 [Name]과 [Text]를 설정합니다.

Step 2. Process Bot 실행

i-AUD Designer 상단의 [Process Bot]을 선택합니다.

Image Removed

Image Removed

Step 3. Process Bot 설정

1. 컨트롤 배치

Objects 탭에서 [Button]을 더블 클릭하여 모듈 배치 영역에 배치합니다.

Image Removed

정보

배치한 컨트롤의 유형별로 하위에 표시되는 이벤트가 상이합니다.

Image Removed

2. 모듈 배치

Activities 탭에서 메시지 창이 띄워지는 [MessageBox]를 더블 클릭하여 모듈 배치 영역에 배치합니다.

Image Removed

정보

모듈은 시스템 모듈과 사용자 정의 모듈이 있습니다.

Image Removed

  • 이벤트 비활성화 모듈 (Image Removed): 보고서 실행 시 최초 1회만 실행되는 모듈입니다. 컨트롤의 특정 이벤트(클릭 등)와 직접 연결하여 반복 실행할 수 없습니다.
    • 용도: 주로 보고서 전체에서 사용될 전역 함수(Global Function)를 선언하거나, 초기 로직을 설정할 때 사용합니다. 이 모듈 안에 작성된 이벤트별 동작들은 보고서 로딩 시 미리 등록되어 준비 상태가 됩니다.
    • 연결: 모듈 배치 시 자동으로 Report의 [OnDocumentLoadComplete]와 연결됩니다. 이는 보고서가 열리는 즉시 해당 로직을 가장 먼저 읽어 들이기 위함입니다.
      Image Removed

3. 모듈 설정

모듈 상단의 버튼을 클릭하여 모듈의 파라미터를 설정합니다.

Image Removed

Image Removed

정보

모듈별로 파라미터 설정 값이 상이합니다.

4. 이벤트 모듈 연결

[Button] 클릭 시 [MessageBox]가 실행되도록 배치한 컨트롤과 모듈을 연결합니다.

Button의 [OnClick]에서 [MessageBox]까지 마우스로 드래그 앤 드롭합니다.

Image Removed

Image Removed

Step 4. 저장 및 동작 확인

1. Process Bot 저장

설정이 완료되면 하단의 [저장] 버튼을 클릭하여 설정한 내용을 저장합니다.

Image Removed

2. 보고서 실행 테스트

보고서에서 [Button] 클릭 시 메시지 창이 정상적으로 실행되는지 확인합니다.

Image Removed

3. 로그 확인

Process Bot 창에서 로그 정보를 확인합니다.

Image Removed

정보

설정한 Process가 정상적으로 실행됐는지 확인할 수 있습니다.

변수 개요

변수는 변하는 데이터(값)을 저장할 수 있는 메모리 공간입니다.

데이터 유형별 변수명 규칙

시스템이 데이터(문자/숫자)를 올바르게 인식할 수 있도록, 반드시 데이터 유형에 맞는 예약어를 사용하여 변수명을 지정해야 합니다.

변수 유형예약어 형식SQL 바인딩 규칙쿼리 적용 예시
문자형 변수(Variable String)VS_로 시작SQL 바인딩 시 앞뒤로 '(Single Quotation)이 붙여 선언

:VS_USER_NAME → '홍길동'

수치형 변수(Variable Numeric)VN_로 시작별도의 처리 없이 단순 치환으로 선언:VN_AGE → 28


참고사항

변수명을 왜 데이터 타입에 맞춰 지정해야 하나요?

· 문자형(:VS_)은 SQL 문법상 문자열은 작은따옴표로 감싸야 하므로, 시스템에서 자동으로 이를 처리해 줍니다.

· 수치형(:VN_)은 숫자 값은 따옴표 없이 사용되므로 입력된 값이 그대로 쿼리에 반영됩니다.


데이터 소스에 연결 시, 변수명 앞에 콜론(:)을 왜 붙이나요?

데이터소스에서 변수를 활용하려면 반드시 변수명 앞에 콜론(:)이 작성되어야 합니다.

· (X) 잘못된 예: WHERE NAME = VS_USER_NAME → 시스템은 VS_USER_NAME이라는 글자 자체를 이름으로 인식하여 데이터를 찾으려 합니다. (결과가 나오지 않음)

· (O) 올바른 예: WHERE NAME = :VS_USER_NAME → 시스템이 변수임을 인식합니다.


실제 데이터 조회 쿼리 예시

Image AddedImage Added

변수 활용하기

사용자가 선택한 월(변수)에 따라 데이터가 조회 되는 보고서를 만드는 과정을 설명합니다.

조회 조건(변수) 컨트롤 생성 및 지정

  1. 컨트롤 생성:UI Bot > Month 컨트롤을 배치합니다.
  2. 변수명 설정: 우측 속성 창의 Name 항목에 변수명 규칙을 적용하여 작성합니다.
    예시: VS_YM (문자형 변수)
    Image Added

i-META 활용 데이터 연결

i-META 파일을 활용하여 데이터를 연결해 보겠습니다.

참고사항

컨트롤 유형별 META를 활용한 데이터 연결 방법

1. 데이터 표시 컨트롤 생성

데이터를 화면에 보여주기 위해 UI Bot에서 List-Grid를 생성합니다.

Image Added

2. 데이터 연결

List Grid에서 마우스 우클릭 > [i-META]를 선택합니다.
Image Added

  1. i-META목록에서 조회할 META 선택하고, 조회항목과 조회조건을 배치합니다.

  2. 조회조건 [년월]에 변수 이름(VS_YM)을 콜론(:)과 함께 작성합니다.
    Image Added

    참고사항

    변수명 앞에 콜론(:)이 빠지면 시스템이 변수로 인식하지 못합니다.


  3. 확인 버튼을 클릭합니다.
    Image Added

3. 데이터 확인

보고서를 열었을 때, List Grid에 데이터가 바로 나오도록 우측 속성 창 [Event] > [AutoRefresh]를 활성화 합니다.

Image Added


달력 컨트롤의 날짜를 변경하고 보고서 상단의 [실행] 버튼을 클릭하면 조회 조건에 해당하는 데이터가 정상적으로 조회됩니다.

Image Added

SQL 활용 데이터 연결

SQL 쿼리를 작성하여 데이터를 연결해 보겠습니다.

참고사항

컨트롤 유형별 SQL 활용한 데이터 연결 방법

1. 데이터 표시 컨트롤 생성

데이터를 화면에 보여주기 위해 UI Bot에서 List-Grid를 생성합니다.

Image Added

2. 데이터 연결

List Grid에서 마우스 우클릭 > [SQL]을 선택합니다.
Image Added

  1. 데이터소스 창에서 데이터소스를 추가합니다.

  2. 데이터베이스를 선택합니다.

  3. SQL 쿼리를 작성합니다.
    조회조건 ym 컬럼에 변수 이름(VS_YM)을 콜론(:)과 함께 작성합니다.

    코드 블럭
    languagesql
    firstline1
    title사용한 SQL 쿼리
    linenumberstrue
    collapsetrue
    SELECT T3.ym AS 년월,
	   T2.store_region AS 매장지역,
	   SUM(T1.quantity) AS 매출수량,
	   SUM(T1.revenue_amt) AS 매출금액

FROM sales_performance T1
INNER JOIN sales_store T2
	ON (T1.store_cd = T2.store_cd)
INNER JOIN sales_std_date T3
	ON (T1.std_date = T3.ymd)

WHERE 1=1
AND T3.ym = :VS_YM

GROUP BY T3.ym, T2.store_region


    참고사항

    변수명 앞에 콜론(:)이 빠지면 시스템이 변수로 인식하지 못합니다.


  4. 확인 버튼을 클릭하여 데이터를 연결합니다.

    Image Added

3. 데이터 확인

보고서를 열었을 때, List Grid에 데이터가 바로 나오도록 우측 속성 창 [Event] > [AutoRefresh]를 활성화 합니다.

Image Added


달력 컨트롤의 날짜를 변경하고 보고서 상단의 [실행] 버튼을 클릭하면 조회 조건에 해당하는 데이터가 정상적으로 조회됩니다.

Image Added