개요

개요

System 라이브러리에서 제공하는 기능을 이용해 시스템을 제어할 수 있습니다.

파일 생성 및 삭제, 파일 실행 및 종료, 경로 생성 및 삭제, 복사 및 붙여넣기, DB 연결 등의 기능을 활용하여 시스템의 동작을 제어할 수 있습니다.

System 라이브러리에서 사용할 수 있는 기능은 다음과 같습니다.

• 파일 제어: CreateFile, ExecuteFile, CloseFile, CopyFile, DeleteFile, IsFileExist, GetFileList, MoveFile, RenameFile, Zip, UnZip, IsFileLock, WaitFileUnlock, WaitFileCreation, WaitFileDelete

• 디렉토리 제어: CreateDirectory, IsDirectoryExist, CopyDirectory, DelectDirectory, GetDirectoryList, GetSpecialFolder

• 텍스트 파일 제어: ReadTextFile, WriteTextFile

• 입력 박스, 메시지 박스 표시: InputBox, MessageBox

• 편집 관련: GetClipboard, SetClipboard, ClipboardToFile, Screenshot(Alt+PrtSc), Copy(Ctrl+C), Cut(Ctrl+X), Paste(Ctrl+V), SelectAll(Ctrl+A)

• 프로그램 실행: ExecuteCmd

• 경과 시간 계산: TimeStamp

• 레지스트리 관련: GetRegistryValue, SetRegistryValue

• DB 관련: DBConnection, GetDBData, UpdateDBData, SendDBCommand

• 보안 관련: GetWindowsCredential, SetWindowsCredential, IsWindowsCredentialExist, GetWindowsCredentialList

공통 속성

공통 속성

COMMAND

• 명령과 관련된 설정을 입력할 수 있습니다.

MORE OPTION

DESCRIPTION

CreateFile

CreateFile

개요

지정한 경로에 파일을 생성합니다.

사용 절차

1. Path에 생성할 파일 경로와 파일명을 입력하세요.

2. Overwrite에서 경로상에 같은 이름의 파일이 있을 경우 덮어쓸지 선택하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt'라는 Notepad 앱 파일을 생성하고 삭제합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_CreateFile_Test

사용된 변수

• 없음

사용된 속성

• Path = 'C:\\IPA Test.txt'

• OverWrite = On

연관/유사 액티비티

DeleteFile, IsFileExist

ExecuteFile

ExecuteFile

개요

지정한 파일을 실행합니다.

사용 절차

1. [Output] Output에 실행된 앱의 PID를 저장할 변수를 입력하세요.

2. Timeout에 대상 파일이 열릴 때까지의 대기 시간을 입력하세요.

3. Path에 실행할 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt'라는 Notepad 앱 파일을 생성하고 실행합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_Execute_File_Test

사용된 변수

• 없음

사용된 속성

• Timeout(Sec) = 10

• Path = 'C:\\IPA Test.txt'

연관/유사 액티비티

DeleteFile, IsFileExist

CloseFile

CloseFile

개요

실행 중인 파일을 종료합니다.

사용 절차

[Input] PID에 종료할 파일의 PID를 입력하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt'라는 Notepad 앱 파일을 생성하고 연 후 종료합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_CloseFile_Test

사용된 변수

• createFile = 실행된 Notepad 파일을 할당할 변수

사용된 속성

• [Input] PID = this.createFile

연관/유사 액티비티

CreateFile, ExecuteFile

CopyFile

CopyFile

개요

지정한 파일을 복사합니다.

사용 절차

1. SrcFilePath에 복사할 원본 파일의 경로와 파일명을 입력하세요.

2. DestFilePath에 복사한 파일을 저장할 새로운 경로와 파일명을 입력하세요.

3. Overwrite에서 저장할 경로에 같은 이름의 파일이 있을 경우 덮어쓸지 선택하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt'라는 Notepad 앱 파일을 생성하고, 이 파일을 복사하여 새로 지정한 경로에 'IPA Test_Copy.txt'라는 파일명으로 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_CopyFile_Test

사용된 변수

• 없음

사용된 속성

• SrcFilePath = 'C:\\IPA Test.txt'

• DescFilePath = 'C:\\IPA Test_Copy.txt'

연관/유사 액티비티

CreateFile, CloseFile, DeleteFile

DeleteFile

DeleteFile

개요

지정한 파일을 삭제합니다.

사용 절차

Path에 삭제할 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

지정한 경로에 있는 'IPA Test.txt' Notepad 앱 파일을 삭제합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_DeleteFile_Test

사용된 변수

• 없음

사용된 속성

• Path = 'C:\\IPA Test.txt'

연관/유사 액티비티

CreateFile, CloseFile, CopyFile

IsFileExist

IsFileExist

개요

지정한 파일이 존재하는지 확인합니다.

사용 절차

1. [Output] Output에 검사한 결과 값을 저장할 변수를 입력하세요.

2. Path에 파일 존재 여부를 확인할 경로와 파일명을 입력하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt' Notepad 앱 파일 있는지 검사하고,  그 결과를 메시지 박스에 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_IsFileExist_Test

사용된 변수

• isExist = 검사한 결괏값을 저장할 변수

사용된 속성

• [Output] Output = this.isExist

• Path = 'C:\\IPA Test.txt'

연관/유사 액티비티

IsDirectoryExist

ReadTextFile

ReadTextFile

개요

대상 텍스트 파일을 읽어 문자열로 가져옵니다.

사용 절차

1. [Output] Output에 읽어온 텍스트를 저장할 변수를 입력하세요.

2. Encoding에서 텍스트 부호화(인코딩) 방식을 선택하세요.

3. Path에 읽어올 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

지정한 경로에 있는 'IPA Test.txt' Notepad 앱 파일에서 텍스트를 읽어와 'readTextFile' 변수에 저장합니다. 파일에서 읽어온 텍스트를 후속 프로세스에서 활용할 수 있습니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_ReadTextFile_Test

사용된 변수

• readTextFile = 읽어온 결과 값을 저장할 변수

사용된 속성

• [Output] Output = this.readTextFile

• Encoding = Default

• Path = 'C:\\IPA Test.txt'

연관/유사 액티비티

WriteTextFile

WriteTextFile

WriteTextFile

개요

대상 텍스트 파일에 문자열을 입력하고 저장합니다.

사용 절차

1. Encoding에 텍스트 부호화(인코딩) 방식을 선택하세요.

2. Text에 입력할 문자열을 입력합니다.

3. Path에 문자열을 입력할 파일의 경로와 파일명을 입력하세요.

4. Overwrite에 저장할 경로에 같은 이름의 파일이 있을 경우 덮어쓸지 선택하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt'라는 Notepad 앱 파일을 생성하고 연 후 'WriteTextFile Test' 텍스트를 입력하고 파일을 종료합니다. 파일에 쓰기한 텍스트를 후속 프로세스에 활용할 수 있습니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_WriteTextFile_Test

사용된 변수

• 없음

사용된 속성

• Encoding = Default

• Text = 'WriteTextFile Test'

• Path = 'C:\\IPA Test.txt'

• Overwrite = On

연관/유사 액티비티

ReadTextFile

CreateDirectory

CreateDirectory

개요

지정한 경로에 새 디렉토리를 생성합니다.

사용 절차

Path에 디렉토리를 생성할 경로를 입력하세요.

카드 속성

활용 예시

'C:\\IPA Test' 디렉토리를 새로 생성합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage Directory > P_CreateDirectory_Test

사용된 변수

• 없음

사용된 속성

• Path = 'C:\\IPA Test'

연관/유사 액티비티

DeleteDirectory

IsDirectoryExist

IsDirectoryExist

개요

지정한 디렉토리가 존재하는지 확인합니다.

사용 절차

1. [Output] Output에 검사한 결과 값을 저장할 변수를 입력하세요.

2. Path에 디렉토리 존재 여부를 확인할 경로를 입력하세요.

카드 속성

활용 예시

'C:\\IPA Test' 디렉토리가 있는지 검사하고, 그 결과를 메시지 박스로 출력합니다.
디렉토리 존재 여부에 따라 후속 프로세스를 진행할 때 활용할 수 있습니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage Directory > P_IsDirectoryExist_Test

사용된 변수

• isDirExist = 검사한 결괏값을 저장할 변수

사용된 속성

• Output = this.isDirExist

• Path = 'C:\\IPA Test'

연관/유사 액티비티

IsFileExist

CopyDirectory

CopyDirectory

개요

지정한 디렉토리를 복사합니다.

사용 절차

1. SrcDirPath에 복사할 원본 디렉토리 경로를 입력하세요.

2. DescDirPath에 복사한 디렉토리를 저장할 새 디렉토리 경로를 입력하세요.

3. Overwrite에서 저장할 경로에 같은 이름의 디렉토리가 경우 덮어쓸지 선택하세요.

카드 속성

활용 예시

지정한 경로에 생성한 디렉토리를 복사하여 새 경로에 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage Directory > P_CopyDirectory_Test

사용된 변수

• 없음

사용된 속성

• SrcFilePath = 'C:\\IPA Test\\CopyDir_Test1' (첫 번째 CopyDirectory)

• DescFilePath = 'C:\\IPA Test\\CopyDir_Test2' (첫 번째 CopyDirectory)

• SrcFilePath = 'C:\\IPA Test\\CopyDir_Test1\\' (두 번째 CopyDirectory)

• DescFilePath = 'C:\\IPA Test\\CopyDir_Test2' (두 번째 CopyDirectory)

연관/유사 액티비티

CreateFile, CloseFile, DeleteFile

DeleteDirectory

DeleteDirectory

개요

지정한 디렉토리를 삭제합니다.

사용 절차

Path에 삭제할 디렉토리 경로를 입력하세요.

카드 속성

활용 예시

지정한 C:\\IPA Test\\DeleteDir_Test2 디렉토리를 삭제합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage Directory > P_DeleteDirectory_Test

사용된 변수

• 없음

사용된 속성

• Path = 'C:\\IPA Test\\DeleteDir_Test2'

연관/유사 액티비티

CreateDirectory, CopyDirectory

GetFileList

GetFileList

개요

지정한 디렉토리의 파일 목록을 가져옵니다.

사용 절차

1. [Output] Output에 가져온 파일 목록을 저장할 변수를 입력하세요.

2. Path에 파일 목록을 가져올 디렉토리 경로를 입력하세요.

카드 출력 속성

카드 입력 속성

활용 예시

C:\\ 디렉토리의 파일 목록을 가져와 메시지 박스에 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_GetFileList_Test

사용된 변수

• getFileList = 가져온 파일 목록을 저장할 변수

사용된 속성

• [Output] Output = this.getFileList

• Path = 'C:\\'

연관/유사 액티비티

GetDirectoryList

GetDirectoryList

GetDirectoryList

개요

지정한 디렉토리의 하위 디렉토리 목록을 가져옵니다.

사용 절차

1. [Output] Output에 가져온 디렉토리 목록을 저장할 변수를 입력하세요.

2. Path에 디렉토리 목록을 가져올 상위 디렉토리 경로를 입력하세요.

카드 출력 속성

카드 입력 속성

활용 예시

C:\\ 디렉토리의 하위 디렉토리 가져와 메시지 박스에 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage Directory > P_GetDirectoryList_Test

사용된 변수

• getDirectoryList = 가져온 하위 디렉토리 목록을 저장할 변수

사용된 속성

• [Output] Output = this.getDirectoryList

• Path = 'C:\\'

연관/유사 액티비티

GetFileList

InputBox

InputBox

개요

화면에 사용자 입력을 받을 수 있는 입력 박스를 표시합니다.

사용 절차

1. [Output] Variable에 입력한 값을 저장할 변수를 입력하세요.

2. DefaultValue에 입력 박스에 표시할 값을 입력하세요.

카드 속성

활용 예시

지정한 경로에 'IPA Test.txt'라는 Notepad 앱 파일을 생성하고 사용자가 입력한 텍스트를 this.inputBox 변수에 저장합니다. 디자이너에서 문자로 사용자 입력을 받아 후속 프로세스에 활용할 때 사용합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_InputBox_Test

사용된 변수

• inputBox = 입력 박스의 입력란에 표시할 값이 입력된 변수(초깃값: 'inputBox_Test')

사용된 속성

• [Output] Variable = this.inputBox

• DefaultValue = this.inputBox

특이 사항

연관/유사 액티비티

MessageBox

MessageBox

MessageBox

개요

화면에 메시지 박스를 표시합니다.

사용 절차

Arguments에 메시지 박스에 표시할 값을 입력하세요.

카드 속성

활용 예시

InputBox로 입력 받은 문자열(변수)을 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_MessageBox_Test

사용된 변수

• inputBox = 입력 박스의 입력란에 표시할 값이 입력된 변수(초깃값: null)

사용된 속성

• Arguments = this.inputBox

특이 사항

연관/유사 액티비티

MessageBox

GetClipboard

GetClipboard

개요

시스템 클립보드에 저장된 값을 가져옵니다.

사용 절차

[Output] Output에 클립보드에서 읽어온 값을 저장할 변수를 입력하세요.

카드 속성

활용 예시

구글 사이트에서 GetImageBounds 액티비티로 찾은 구글 이미지의 특정 위칫값을 클립보드로 가져옵니다. 클립보드에 저장된 값을 가져와 후속 프로세스에 활용할 수 있습니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Utilize Clipboard > P_GetClipboard_Test

사용된 변수

• browser_id = 실행된 브라우저를 할당할 변수

• setClip = 가져온 영역 정보를 저장할 변수

• getClip = 클립보드에서 읽어온 값을 저장할 변수

사용된 속성

• [Output] Output = this.getClip

연관/유사 액티비티

SetClipboard

SetClipboard

SetClipboard

개요

입력한 값을 시스템 클립보드에 저장합니다.

사용 절차

Input에 클립보드에 저장할 값을 입력하세요.

카드 속성

활용 예시

그림판의 특정 위치에 있는 텍스트를 클립보드로 가져와 Notepad 앱에 붙여넣습니다. 클립보드에 저장된 값을 가져와 후속 프로세스에 활용할 수 있습니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Utilize Clipboard > P_SetClipboard_Test

사용된 변수

• setClip = 가져온 텍스트 값을 저장할 변수

• paint_id = 실행된 그림판 앱을 할당할 변수

• notepad_id = 실행한 Notepad 앱을 지정할 변수

사용된 속성

• Input = this.setClip

연관/유사 액티비티

GetClipboard

ClipboardToFile

ClipboardToFile

개요

이미지, 텍스트 등 클립보드에 있는 내용을 파일로 저장합니다.

사용 절차

1. DataFormat에서 클립보드에 저장할 데이터 형식을 선택하세요.

2. Path에 클립보드 내용을 저장할 파일 경로와 파일명을 입력하세요.

카드 속성

활용 예시

Notepad 앱에 있는 내용을 클립보드에 저장한 후 해당 내용을 지정한 파일 형식으로 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Utilize Clipboard > P_ClipboardToFile_Test

사용된 변수

• process_id = 실행한 Notepad 앱을 지정할 변수

• getClip = 클립보드에서 읽어온 값을 저장할 변수

• setClip = 가져온 텍스트를 저장할 변수

• filename = 클립보드의 내용을 저장할 경로가 입력된 변수(초깃값: 'C:\\IPATest_ClipboardToFile.txt')

사용된 속성

• DataFormat = TXT

• Path = this.filename

연관/유사 액티비티

GetClipboard, SetClipboard

GetSpecialFolder

GetSpecialFolder

개요

Windows에서 기본 제공되는 시스템 폴더의 경로를 가져옵니다.

사용 절차

1. [Output] Output에 가져온 시스템 폴더 경로를 저장할 변수를 입력하세요.

2. FolderType에서 시스템 폴더 형식을 선택하세요.

카드 출력 속성

카드 입력 속성

활용 예시

시스템 폴더의 경로를 읽어와 'RESULT' 변수값으로 반환합니다.
클립보드에 저장된 내용을 지정 경로(RESULT+test_RPA.txt)에 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_GetSpecialFolder_Test

사용된 변수

• getClip = 클립보드에서 읽어온 값을 저장할 변수

• setClip = 가져온 텍스트를 저장할 변수

사용된 속성

• FolderType = Desktop

특이 사항

연관/유사 액티비티

GetFileList, GetDirectoryList, GetClipboard, GetRegistryValue

Screenshot(Alt+PrtSc)

Screenshot(Alt+PrtSc)

개요

현재 포커스를 가진 화면을 캡처합니다.

사용 절차

1. 액티비티 카드(OpenApp, ChromeOpen 등)을 이용하여 캡처하고자 하는 화면을 구성하세요.

2. BeforeDelay와 AfterDelay에 각각 화면 캡처 이벤트 전, 후 대기시간을 입력하세요.

3. Path에 캡처된 화면을 저장할 파일 경로와 파일명을 입력하세요.

4. FullScreen에서 화면 전체를 캡처할지 설정하세요.

카드 속성

활용 예시

실행한 Notepad 앱 화면을 캡처(Screenshot(Alt+PrtSc))하여 'C:\IPA ScreenShotTest.png'에 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_ScreenShot_Test

사용된 변수

• RESULT = 실행된 Notepad 앱을 할당할 변수

사용된 속성

• BeforeDelay(ms) = 1000

• AfterDelay(ms) = 2000

• Path = 'C:\\IPA ScreenShotTest.png'

• FullScreen = On

연관/유사 액티비티

ExecuteFile

Copy(Ctrl+C)

Copy(Ctrl+C)

개요

지정한 파일을 복사합니다. 키보드의 'Ctrl+C' 단축키와 동일한 효과를 가집니다.

사용 절차

1. 화면에서 특정 문자, 파일 등이 포커스되도록 설정하세요.

2. BeforeDelay와 AfterDelay에 각각 복사하기 전, 후 대기 시간을 입력하세요.

카드 속성

활용 예시

새로 생성한 Notepad 앱 파일을 열어 'Ctrl+C Test'를 입력하고, 입력한 내용을 복사(Copy(Ctrl+C))한 후 붙여넣기(Pastre(Ctrl+V))를 수행합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_Copy_Ctrl_C_Test

사용된 변수

• exefile = 실행된 Notepad 앱을 할당할 변수

사용된 속성

• BeforeDelay(ms) = 0

• AfterDelay(ms) = 0

연관/유사 액티비티

SelectAll(CTRL+A), Paste(CTRL+V), Cut(CTRL+X)

Cut(Ctrl+X)

Cut(Ctrl+X)

개요

현재 포커스된 대상 문자, 파일 등을 잘라냅니다. 키보드의 'Ctrl+X' 단축키와 동일한 효과를 가집니다.

사용 절차

1. 화면에서 특정 문자, 파일 등이 포커스되도록 설정하세요.

2. BeforeDelay와 AfterDelay에 각각 잘라내기 전, 후 대기 시간을 입력하세요.

카드 속성

활용 예시

새로 생성한 Notepad 앱 파일을 열어 'Ctrl+X Test'를 입력하고, 입력한 내용을 모두 선택(SelectAll(Ctrl+A))해 잘라낸(Copy(Ctrl+X)) 후 붙여넣기(Paste(Ctrl+V))를 수행합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_Cut_Ctrl_X_Test

사용된 변수

• exefile = 실행된 Notepad 앱을 할당할 변수

사용된 속성

• BeforeDelay(ms) = 0

• AfterDelay(ms) = 0

• Input Text = 'Ctrl+X Test'

• Path = 'C:\\IPA Test.txt'

연관/유사 액티비티

SelectAll(CTRL+A), Paste(CTRL+V), Cut(CTRL+C)

Paste(Ctrl+V)

Paste(Ctrl+V)

개요

현재 포커스를 가진 화면을 대상으로 붙여넣기 합니다. 키보드의 'Ctrl+V' 단축키와 동일한 효과를 가집니다.

사용 절차

1. 붙여넣을 대상 화면이 포커스되도록 설정하세요.

2. BeforeDelay와 AfterDelay에 각각 붙여넣기 전, 후 대기 시간을 입력하세요.

카드 속성

활용 예시

새로 생성한 Notepad 앱 파일을 열어 'Ctrl+V Test'를 입력하고, 입력한 내용을 모두 선택(SelectAll(Ctrl+A))해 잘라낸(Cut(Ctrl+X)) 후 붙여넣기(Paste(Ctrl+V))를 수행합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_Paste_Ctrl_V_Test

사용된 변수

• 없음

사용된 속성

• BeforeDelay(ms) = 0

• AfterDelay(ms) = 0

연관/유사 액티비티

SelectAll(CTRL+A), Copy(CTRL+C), Cut(CTRL+X)

SelectAll(Ctrl+A)

SelectAll(Ctrl+A)

개요

현재 포커스를 가진 화면을 대상으로 모두 선택합니다. 키보드의 Ctrl+A 단축키와 동일한 효과를 가집니다.

사용 절차

1. 모두 선택할 대상 화면이 포커스되도록 설정하세요.

2. BeforeDelay와 AfterDelay에 각각 모두 선택하기 전, 후 대기 시간을 입력하세요.

카드 속성

활용 예시

새로 생성한 Notepad 앱 파일을 열어 'Ctrl+V Test'를 입력하고, 입력한 내용을 모두 선택(SelectAll(Ctrl+A))해 잘라낸(Cut(Ctrl+X)) 후 붙여넣기(Paste(Ctrl+V))를 수행합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_SelectAll_Ctrl_A_Test

사용된 변수

• 없음

사용된 속성

• BeforeDelay(ms) = 0

• AfterDelay(ms) = 0

연관/유사 액티비티

Paste(CTRL+V), Copy(CTRL+C), Cut(CTRL+X)

ExecuteCmd

ExecuteCmd

개요

백그라운드에서 프로그램 명령을 실행한 후 실행 결과를 반환합니다. 화면에 보이지 않는 상태로 실행됩니다.

사용 절차

1. [Output] Output에 대상 프로그램의 실행 결과를 저장할 변수를 입력하세요.

2. Command에 실행할 명령어를 입력하세요.

카드 속성

활용 예시

백그라운드에서 dir 명령을 실행한 후 결과를 'cmdVar1' 변수로 반환 및 메시지 박스로 출력합니다.
반환값은 명령 수행 시 발생하는 표준 출력(Standard Output) 문자열이 됩니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_ExecuteCmd_Test

사용된 변수

• cmdVar1 = CMD를 실행한 결과를 저장할 변수

사용된 속성

• [Output] Output = this.cmdVar1

• Command = 'cmd'

• Arguments = '/c dir'

특이 사항

연관/유사 액티비티

ExecuteFile

TimeStamp

TimeStamp

개요

지정한 시간부터 현재 시간까지의 경과 시간을 밀리초(millisecond) 단위로 반환합니다.

사용 절차

1. Output에 경과 시간을 저장할 변수를 입력하세요.

2. BaseTime에 계산할 시작 시간을 입력하세요.

카드 출력 속성

카드 입력 속성

활용 예시

Notepad 앱을 열고, 텍스트 입력, 잘라내기, 붙여넣기 등을 수행한 시간을 메시지 박스로 출력합니다.
경과 시간에 대한 처리가 필요할 때 활용할 수 있습니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Other Samples > P_TimeStamp_Test

사용된 변수

• openApp1 = 실행된 Notepad 앱을 할당할 변수

• baseTime = 경과 시간을 계산할 시작 시간이 입력된 변수(초깃값: 0)

• elapsedTime = 경과한 시간을 저장할 변수

사용된 속성

• [Output] Output = this.elapsedTime

• BaseTime = this.startTime

연관/유사 액티비티

MessageBox

GetRegistryValue

GetRegistryValue

개요

지정한 레지스트리 경로의 키 값을 가져옵니다.

사용 절차

1. [Output] Output에 레지스트리 키 값을 저장할 변수를 설정하세요.

2. BaseKey에서 레지스트리 상위 키(루트 키)를 선택하세요.

3. KeyName에 레지스트리 키 이름을 입력하세요.

4. ValueName에 레지스트리 키 값을 입력하세요.

카드 출력 속성

카드 입력 속성

활용 예시

지정한 경로의 레지스트리 값을 읽어와 'getRegistryValue' 변수로 반환하고, 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Edit Registry > P_GetRegistryValue_Test

사용된 변수

• getRegistryValue = 가져온 레지스트리 키 값을 저장할 변수

사용된 속성

• [Output] Output = this.getRegistryValue

• BaseKey = CurrentConfig

• KeyName = 'Software\\Fonts'

• ValueName = 'Path'

연관/유사 액티비티

SetRegistryValue

SetRegistryValue

SetRegistryValue

개요

지정한 레지스트리 경로에 키 값을 입력합니다.

사용 절차

1. BaseKey에서 레지스트리 상위 키(루트 키)를 선택하세요.

2. ValueKind에서 레지스트리 키 종류를 선택하세요.

3. KeyName에 레지스트리 키 이름을 입력하세요.

4. ValueName에 레지스트리 키 값을 입력하세요.

5. Value에 레지스트리 데이터 값을 입력하세요.

카드 속성

활용 예시

지정한 경로에 레지스트리 값을 입력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Edit Registry > P_SetRegistryValue_Test

사용된 변수

• 없음

사용된 속성

• BaseKey = CurrentConfig

• ValueKind = String

• KeyName = 'Software\\Fonts'

• ValueName = 'Path'

• Value = 'C:\\Program Files\\7-Zip\\123\\'

연관/유사 액티비티

GetRegistryValue

MoveFile

MoveFile

개요

파일을 현재 디렉토리에서 다른 디렉토리로 이동시킵니다.

사용 절차

1. SrcFilePath에 이동할 원본 파일의 경로와 파일명을 입력하세요.

2. DescFilePath에 이동한 파일을 저장할 새로운 경로를 입력하세요.

3. Overwrite에서 저장할 경로에 같은 이름의 파일이 있을 경우 덮어쓸지 선택하세요.

카드 속성

활용 예시

폴더와 파일을 각각 생성한 후 생성한 파일을 지정한 폴더로 이동하고, 폴더는 삭제합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_MoveFile_Test

사용된 변수

• 없음

사용된 속성

• SrcFilePath = 'C:\\IPA Test.txt'

• DescFilePath = 'C:\\MoveFileDesc\\IPA Test.txt'

• Overwrite = True

연관/유사 액티비티

CopyFile, DeleteFile, CloseFile

RenameFile

RenameFile

개요

대상 파일의 이름을 변경합니다.

사용 절차

1. NewName에 변경할 새 파일명을 입력하세요.

2. SrcFilePath에 이름을 변경할 대상 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

새로 생성한 파일의 이름을 변경합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_Rename_Test

사용된 변수

• 없음

사용된 속성

• NewName = 'IPA Test_Rename.txt'

• SrcFilePath = 'C:\\IPA Test.txt'

연관/유사 액티비티

CreateFile

DBConnection

DBConnection

개요

MsSQL, Oracle 등의 DB와 연결합니다.

사용 절차

1. [Output] DataSource에 데이터 소스 정보를 저장할 변수를 입력하세요.

2. [Output] Connection에 연결 정보를 저장할 변수를 입력하세요.

3. DSN에서 연결할 DSN를 선택하세요.

4. SourceType에 데이터 소스 타입을 선택하세요.

5. Source에 데이터 소스를 선택하세요.

카드 속성

활용 예시

DB에 연결하여 연결 정보와 소스 정보를 변수로 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > DBLibrary > MSSQL

사용된 변수

• sourceinfo = 데이터 소스 정보를 저장할 변수

• connection = 연결 정보를 저장할 변수

사용된 속성

• [Output] DataSource = this.sourceinfo

• [Output] Connection = this.connection

• DSN =

• UID = 'ibscity'

• PWD = ****** (Secure)

• SourceType = TABLE

• Source = aa

연관/유사 액티비티

GetDBData, UpdateDBData, SendDBCommand

GetDBData

GetDBData

개요

연결한 DB에서 특정 필드의 데이터를 가져옵니다.

사용 절차

1. [Output] Output에 가져온 필드 데이터를 저장할 변수를 입력하세요.

2. [Input] Connection에 가져올 DB의 연결 정보 변수를 입력하세요.

3. [Input] DataSource에 가져올 DB의 데이터 소스 변수를 입력하세요.

4. UseSource에서 데이터 소스를 사용할지 설정하세요.

카드 속성

활용 예시

연결한 DB에서 특정 필드의 데이터를 가져와 변수로 저장합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > DBLibrary > MSSQL

사용된 변수

• data = 가져온 필드 데이터를 저장할 변수

• sourceinfo = 데이터 소스 정보가 저장된 변수

• connection = 연결 정보가 저장된 변수

사용된 속성

• [Output] Output = this.data

• [Input] Connection = this.connection

• [Output] DataSource = this.sourceinfo

• UseSource = On

연관/유사 액티비티

DBConnection, UpdateDBData, SendDBCommand

UpdateDBData

UpdateDBData

개요

연결한 DB의 특정 필드를 업데이트합니다.

사용 절차

1. [Output] Output에 필드 데이터를 업데이트한 결과를 저장할 변수를 입력하세요.

2. [Input] Input에 업데이트할 대상 필드를 입력하세요.

3. [Input] Connection에 업데이트할 DB의 연결 정보 변수를 입력하세요.

4. [Input] DataSource에 업데이트할 DB의 데이터 소스 변수를 입력하세요.

카드 속성

활용 예시

연결한 DB의 특정 필드를 변경된 정보로 업데이트합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > DBLibrary > MSSQL

사용된 변수

• data = 필드 데이터를 저장한 변수

• connection = 연결 정보가 저장된 변수

• sourceinfo = 데이터 소스 정보가 저장된 변수

• data2 = 필드 데이터를 업데이트한 결괏값을 저장할 변수

사용된 속성

• [Output] Output = this.data2

• [Input] DataSource = this.sourceinfo

• [Input] Connection = this.connection

• [Input] Input = this.data

연관/유사 액티비티

DBConnection, GetDBData, SendDBCommand

SendDBCommand

SendDBCommand

개요

연결한 DB에 특정 쿼리를 실행합니다.

사용 절차

1. [Output] Output에 쿼리를 실행한 결과를 저장할 변수를 입력하세요.

2. [Input] Connection에 연결할 DB의 변수를 입력하세요.

3. Command에 연결된 DB로 실행될 쿼리 명령문을 입력하세요.

카드 속성

활용 예시

연결된 DB의 테이블 정보를 조회하는 쿼리를 실행하여, 조회된 결과를 'data3' 변수에 저장하고 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > DBLibrary > MSSQL

사용된 변수

• data = 필드 데이터를 저장한 변수

• connection = 연결 정보가 저장된 변수

• sourceinfo = 데이터 소스 정보가 저장된 변수

• data3 = 쿼리를 실행한 결괏값을 저장할 변수

사용된 속성

• [Output] Output = this.data3

• [Input] Connection = this.connection

• Command = 'SELECT*FROM AA'

연관/유사 액티비티

DBConnection, GetDBData, UpdateDBData

Zip

Zip

개요

지정한 폴더 또는 파일을 압축합니다.

사용 절차

1. SrcFilePath에 압축할 원본 파일의 경로를 입력하세요.

2. SrcDirPath에 압축할 원본 폴더의 경로를 입력하세요.

3. DestDirPath에 압축한 파일을 저장할 경로를 입력하세요.

4. DirectoryOrFile에 압축 대상이 폴더인지 파일인지를 선택하세요.

5. IncludeDirectoryPath에 압축 대상이 파일인 경우 상위 디렉토리명을 포함할지 여부를 선택하세요.

6. MaxMegaBytes에 압축 시 제한 용량을 설정하세요.

카드 속성

활용 예시

C:\\IPA_SAMPLE 폴더를 압축합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_ZipUnZip_Test

사용된 변수

• 없음

사용된 속성

• [폴더 압축]

• SrcDirPath = 'C\\IPA_SAMPLE'

• DestDirPath = 'C:\\'

• MaxMegaBytes = 100

• DirectoryOrFile = Directory

• Overwrite = On

• [파일 압축]

• SrcFilePath = 'C\\SampleTest.pdf'

• DestDirPath = 'C:\\'

• MaxMegaBytes = 100

• DirectoryOrFile = File

• IncludeDirectoryPath = Off

• Overwrite = On

연관/유사 액티비티

UnZip

UnZip

UnZip

개요

지정한 압축 파일을 해제합니다.

사용 절차

1. SrcDirPath에 압축을 해제할 파일의 경로를 입력하세요.

2. DestDirPath에 압축을 해제할 대상 폴더의 경로를 입력하세요.

카드 속성

활용 예시

C:\\IPA_SAMPLE.zip 경로의 압축 파일을 C:\\IPA_SAMPLE 경로에 압축을 해제합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_ZipUnZip_Test

사용된 변수

• 없음

사용된 속성

• SrcDirPath = 'C\\IPA_SAMPLE.zip'

• DestDirPath = 'C:\\IPA_SAMPLE'

• Overwrite = True

• MakeDirectory = True

연관/유사 액티비티

Zip

IsFileLock

IsFileLock

개요

지정한 파일이 다른 프로세스에서 실행되어 현재 잠금(Locked) 상태인지 검사합니다.

사용 절차

1. [Output] Output에 잠금 상태를 검사한 결과를 저장할 변수를 입력하세요.

2. Path에 잠금 상태(실행 여부)를 검사할 파일의 경로를 입력하세요.

카드 속성

활용 예시

새로운 Excel 파일을 생성한 후 파일 실행 여부를 확인하여 그 결과를 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > IsFileLock_Test

사용된 변수

• hExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

• [Output] Output = RESULT

• Path = 'C:\\1.xlsx'

연관/유사 액티비티

IsFileExist, WaitFileUnlock

WaitFileUnlock

WaitFileUnlock

개요

실행 중인 특정 파일이 종료될 때까지 기다립니다.

사용 절차

1. Timeout(Sec)에 대기할 시간을 입력하세요.

2. Path에 종료될 때까지 대기할 대상 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

새로운 Excel 파일을 생성하고 실행한 후 해당 파일이 종료될 때까지 지정 시간 동안 대기합니다. 이후 종료되었는지를 점검하고 그 결과를 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_WaitFileUnlock_Test

사용된 변수

• excel: 열린 Excel 문서를 할당할 변수

사용된 속성

• [Output] Output = RESULT

• Timeout(Sec) = 10

• Path = 'C:\\BrityWorksTestExcel.xlsx'

연관/유사 액티비티

WaitFileCreation, WaitFileDelete

WaitFileCreation

WaitFileCreation

개요

특정 파일이 생성될 때까지 기다립니다.

사용 절차

1. Timeout(Sec)에 대기할 시간을 입력하세요.

2. Path에 생성될 때까지 대기할 대상 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

새로운 Excel 파일이 생성될 때까지 지정 시간 동안 대기합니다. 이후 생성되었는지 점검하고 그 결과를 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_WaitFileCreation_Test

사용된 변수

• excel: 열린 Excel 문서를 할당할 변수

사용된 속성

• [Output] Output = RESULT

• Timeout(Sec) = 5

• File Size(KB) = 0

• Path = 'C:\\BrityWorksTestExcel.xlsx'

연관/유사 액티비티

WaitFileUnlock, WaitFileDelete

WaitFileDelete

WaitFileDelete

개요

특정 파일이 삭제될 때까지 기다립니다.

사용 절차

1. Timeout(Sec)에 대기할 시간을 입력하세요.

2. Path에 삭제될 때까지 대기할 대상 파일의 경로와 파일명을 입력하세요.

카드 속성

활용 예시

지정한 파일이 삭제될 때까지 지정 시간 동안 대기합니다. 이후 삭제되었는지 점검하고 그 결과를 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Manage File > P_WaitFileDelete_Test

사용된 변수

• 없음

사용된 속성

• Timeout(Sec) = 10

• Path = 'C:\\BrityWorksTestExcel.xlsx'

연관/유사 액티비티

WaitFileCreation, WaitFileUnLock

GetWindowsCredential

GetWindowsCredential

개요

Windows 일반 자격 증명을 가져옵니다.

사용 절차

1. Target Credential에 Windows 일반 자격 증명 이름을 입력하세요.

2. Property Name에서 대상 자격 증명을 속성 이름을 선택하세요.

카드 속성

활용 예시

지정한 Windows 자격 증명 정보 (사용자명, 암호)로 메일을 읽고 결과를  메세지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Credential > P_GetWindowsCredential_Test

사용된 변수

• username : Windows 일반 자격 증명의 사용자명을 저장할 변수

• pwd : Windows 일반 자격 증명의 암호를 저장할 변수

사용된 속성

• Target Credential = 'MyMail'

• Property Name = Username

연관/유사 액티비티

IsWindowsCredentialExistGetWindowsCredentialListRemoveWindowsCredentialSetWindowsCredential

SetWindowsCredential

SetWindowsCredential

개요

Register Windows Common Credentials.

사용 절차

1. Target Credential에 Windows 일반 자격 증명 이름을 입력하세요.

2. Username에서 대상 자격 증명의 사용자명을 입력합니다.

3. Password에서 대상 자격 증명의 암호를 입력합니다.

카드 속성

활용 예시

지정한 Windows 자격 증명 정보 (사용자명, 암호)를 시스템에 등록합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Credential > P_SetWindowsCredential_Test

사용된 변수

• target : Windows 일반 자격 증명 이름을 저장할 변수

• username : Windows 일반 자격 증명의 사용자명을 저장할 변수

사용된 속성

• Target Credential = this.target

• Username = this.username

• Password = 'xxxxxx'

연관/유사 액티비티

RemoveWindowsCredentialIsWindowsCredentialExistGetWindowsCredentialListGetWindowsCredential

IsWindowsCredentialExist

IsWindowsCredentialExist

개요

Windows 일반 자격 증명이 존재하는지 확인합니다.

사용 절차

1. [Output] Output에 Windows 자격 증명 정보가 존재하는지 여부를 저장하는 변수를 지정합니다.

2. Target Credential에 Windows 일반 자격 증명 이름을 입력하세요.

카드 속성

활용 예시

지정한 Windows 자격 증명이 시스템에 존재하는지 여부를 읽어와 메시지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Credential > P_IsWindowsCredentialExist_Test

사용된 변수

• RESULT : Windows 자격 증명이 존재하는지 여부를 저장하는 변수

사용된 속성

• Output = RESULT

• Target Credential = 'test'

연관/유사 액티비티

GetWindowsCredentialListRemoveWindowsCredentialGetWindowsCredentialSetWindowsCredential

GetWindowsCredentialList

GetWindowsCredentialList

개요

Windows 일반 자격 증명 목록을 가져옵니다.

사용 절차

1. [Output] Output에 Windows 자격 증명 목록을 저장할 변수를 지정합니다.

카드 속성

활용 예시

Windows 자격 증명 정보 목록을 읽어와  메세지 박스로 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Credential > P_GetWindowsCredentialList_Test

사용된 변수

• RESULT : Windows 일반 자격 증명 목록을 저장할 변수

사용된 속성

• Output = RESULT

연관/유사 액티비티

IsWindowsCredentialExistRemoveWindowsCredentialSetWindowsCredentialGetWindowsCredential

RemoveWindowsCredential

RemoveWindowsCredential

개요

Windows 일반 자격 증명을 삭제합니다.

사용 절차

1. Target Credential에 삭제할 Windows 자격 증명 이름을 입력합니다.

카드 속성

활용 예시

지정한 Windows 자격 증명 두 개를 등록하고 메시지 박스로 목록을 출력합니다. 등록된 Windows 자격 증명 두 개중 한나를 삭제 후 메시지 박스로 목록을 출력합니다.

예제 파일

• 메뉴 > 도움말 > 샘플 > Sample > System > Credential > P_RemoveWindowsCredential_Test

사용된 속성

• Target Credential = 'test2'

연관/유사 액티비티

GetWindowsCredentialListSetWindowsCredentialSetWindowsCredentialIsWindowsCredentialExist

Encrypt

Encrypt

개요

일반 문자열 또는 파일을 암호화합니다. 이미 암호화 된 경우에는 암호화를 추가로 수행하지 않습니다. 파일을 암호화하는 경우, 파일 크기에 따라 수 분 이상의 시간이 소요될 수 있습니다.

사용 절차

1. DataType 에 암호화할 데이터 형식을 입력하세요.String 또는 File 중에서 선택하세요.

2. Crypto Password 에 암호화에 사용할 비밀번호를 입력하세요. 복호화 시에 동일한 비밀번호를 사용해야 합니다.

3. String 에 암호화 할 일반 문자열을 입력하세요. DataType 이 String 인 경우에 사용합니다.

4. FilePath에 암호화 할 원본 파일 경로를 입력하세요. DataType 이 File 인 경우에 사용합니다.

5. Target FilePath에 암호화 한 결과를 저장할 대상 파일 경로를 입력하세요. DataType 이 File 인 경우에 사용합니다.

암호화 규칙

카드 속성

활용 예시

지정한 일반 문자열과 일반 파일을 암호화 하고, 해당 결과를 사용자 메시지 박스로 표시한다.

예제 파일

• 메뉴 > 학습 > 샘플 실행하기 > samples > System > System_Crypto

사용된 변수

• encrypted : 암호화 된 결과를 저장할 변수

• decrypted : 복호화 된 결과를 저장할 변수

사용된 속성

• DataType = 'String' or 'File'

• String = 'hello'

• FilePath = 'c:\\normal.txt'

• Target FilePath = 'c:\\normal.txt.e'

연관/유사 액티비티

Decrypt

Decrypt

Decrypt

개요

암호화 된 문자열 또는 파일을 복호화합니다. 이미 복호화 된 경우에는 복호화를 추가로 수행하지 않습니다. 파일을 복호화하는 경우, 파일 크기에 따라 수 분 이상의 시간이 소요될 수 있습니다.

사용 절차

1. DataType 에 복호화할 데이터 형식을 입력하세요.String 또는 File 중에서 선택하세요.

2. Crypto Password 에 복호화에 사용할 비밀번호를 입력하세요. 암호화 시와 동일한 비밀번호를 사용해야 합니다.

3. String 에 복호화 할 일반 문자열을 입력하세요. DataType 이 String 인 경우에 사용합니다.

4. FilePath에 복호화 할 원본 파일 경로를 입력하세요. DataType 이 File 인 경우에 사용합니다.

5. Target FilePath에 복호화 한 결과를 저장할 대상 파일 경로를 입력하세요. DataType 이 File 인 경우에 사용합니다.

복호화 규칙

카드 속성

활용 예시

지정한 암호화 된 문자열과 파일을 복호화 하고, 해당 결과를 사용자 메시지 박스로 표시한다.

예제 파일

• 메뉴 > 학습 > 샘플 실행하기 > samples > System > System_Crypto

사용된 변수

• encrypted : 암호화 된 결과를 저장할 변수

• decrypted : 복호화 된 결과를 저장할 변수

사용된 속성

• DataType = 'String' or 'File'

• String = this.encrypted

• FilePath = this.encrypted

• Target FilePath = 'c:\\normal.d.txt'

연관/유사 액티비티

Encrypt