개요

Excel 라이브러리에서 제공하는 기능을 이용해 Excel 문서를 제어할 수 있습니다.
새 문서 생성, 문서 열기 및 닫기, 내용 편집, 매크로 및 함수 실행 등 다양한 기능을 활용하여 Excel 문서를 편집 및 제어할 수 있습니다.

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

새 Excel 문서 및 워크시트 생성: NewExcel, HeadlessNewExcel, CreateExcel, CreateWorkSheet
Excel 문서 열기, 활성화, 저장, 닫기, 분리, 가져오기: OpenExcel, HeadlessOpenExcel, SaveExcel, CloseExcel, ActivateExcel, GetActiveExcel, GetExcel, SetHeadlessExcel, SplitExcel, GetSheetName, GetAllSheetNames
워크시트 및 영역 선택: SelectWorkSheet, SelectRange
영역 가져오기, 읽기, 쓰기, 생성: GetActiveRange, GetDataRange, ClearRange, ReadRange, WriteRange, MakeRange, MergeRange, SplitRange, GetRowCount, GetColCount
필터 적용, 해제, 정렬: SetFilter, SetColorFilter, ReleaseFilter, SortData
문자열 검색, 입력, 변경: SearchString, ReplaceString, ReadString, WriteString
복사, 붙여넣기, 삭제, 이동: CopyWorkSheet, MoveWorkSheet, DeleteWorkSheet, CopyRange, PasteRange, CopyPaste
매크로 목록 가져오기, 실행: GetMacroList, ExecuteMacro
행 및 열 추가, 선택, 삭제: AddRow, AddCol, SelectRow, SelectCol, DeleteRow, DeleteCol
수식 가져오기, 입력: ReadCellFormula, WriteCellFormula
스타일, 테두리 적용: SetStyleRange, SetBorderRange
숨기기 적용, 해제: SetHiddenRow, SetHiddenCol
함수: VLookUp
단축키: SendShortCut

Excel 라이브러리 기능의 샘플은 디자이너 혹은 윈도우 탐색기를 이용하여 참조할 수 있습니다.

• 디자이너 경로: 메뉴 > 도움말 > 샘플 > Sample > Excel

• 윈도 탐색기 경로: C:\Users\user\AppData\Roaming\Brity RPA Designer\samples\Excel

[Excel 샘플 프로젝트명과 관련 라이브러리]

• Apply Filter: ReleaseFilter, SetColorFilter, SetFilter

• Apply Style: SetBoardRange, SetHiddenCol, SetHiddenRow, SetStyleRange

• Cell Formula: ReadCellFormula, WriteCellFormula

• Edit Column: AddCol, DeleteCol, GetColCount, SelectCol

• Edit Row: AddRow, DeleteRow, GetRowCount, SelectRow

• Edit WorkSheet: CopyWorkSheet, CreateWorkSheet, DeleteWorkSheet, GetAllSheetNames, GetSheetNames, SelectWorkSheet

• Excel_Filter: ReleaseFilter, SetColorFilter, SetFilter

• Excel_Style: SetBorderRange, SetHiddenCol, SetHiddenRow, SetStyleRange

• headless_Excel: HeadlessNewExcel, HeadlessOpenExcel, SetHeadlessExcel

• Manage Excel: ActivateExcel, CloseExcel, CreateExcel, GetActiveExcel, GetExcel, NewExcel, OpenExcel, SaveExcel, SplitExcel

• Manipulate Range: ClearRange, CopyRange, GetActiveRange, GetDataRange, MakeRange, MergeRange, PasteRange, ReadRange, ReadString, SelectRange, SpiltRange, WriteRange

• OpenExcel: Not_Password, Password_One, PasswordTwo

• Other Samples: CopyPaste, ExecuteMacro, ReplaceString, SearchString, SortData, WriteString, GetMacroList_Sample

Excel 라이브러리에서 주로 사용하는 세 요소는 다음과 같습니다.

• Excel 변수: 현재 열려 있는 Excel 문서를 지정한 변수입니다.

• Excel 워크시트: Excel 통합 문서의 워크시트명입니다.

• Excel 범위(Range): Excel 문서의 셀 범위입니다. 예를 들어, A1 셀부터 C3 셀까지의 범위는 'A1:C3'로 표시할 수 있으며, 문자열로 처리할 수 있습니다.

공통 속성

SHEET

작업 대상 시트에 대한 정보를 설정할 수 있습니다.

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
SheetName	문자	Y	-	Y	대상 시트명을 지정합니다. 별도 설정 없이는 ACTIVE_SHEET가 자동 입력되며, 현재 열려 있는 시트를 의미합니다.
Position	문자	Y	-	N	액티비티가 작업할 위치를 지정합니다. 행이나 열 정보를 입력합니다.
Key	문자	Y	-	Y	기준이 되는 대상의 영역을 지정합니다.
Range	문자	Y	-	Y	대상 영역(Range)을 지정합니다.
Cell	문자	Y	-	Y	대상 셀(Cell)을 지정합니다.
MouseType	콤보박스	Y	-	Y	마우스의 동작 이벤트를 지정합니다. ※ 이벤트 종류 - None, LeftClick, RightClick, DoubleClick, Hover

MORE OPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
On Error	콤보박스	N	-	N	실행 시점에 오류 발생 시 수행할 동작을 지정합니다. - 미지정 시: 오류 출력하고, 작업을 종료합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto: 해당 액티비티가 실패한 경우 지정한 액티비티로 이동하여 시나리오를 수행합니다. - _Event: 프로젝트 내에 생성된 이벤트를 선택합니다.
Timeout	숫자	N	초	Y	활성화 된 엑셀 문서를 가져올 때까지 대기하는 시간을 입력합니다.
GotoStep Relative Position	숫자	N	-	N	해당 액티비티를 기준으로 이동할 액티비티를 선택합니다. Ctrl + F 를 통해 액티비티 번호를 확인 후 [해당 액티비티 번호] - [대상 액티비티 번호] 값을 입력합니다. (기본값: 0)
GotoStep Retry Count	콤보박스	N	-	N	해당 액티비티가 실패한 경우 지정된 횟수만큼 이동을 반복합니다. (기본값: 1)

DESCRIPTION

카드 속성
속성	유형	필수여부	단위	자동입력여부	설명
Description	문자	N	-	N	해당 액티비티 카드에 대한 설명을 추가합니다. Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다.

NewExcel

개요

빈 Excel 문서를 새로 엽니다.

사용 절차

[Output] Excel에 실행 결과를 저장할 변수를 입력하세요.
할당한 변숫값은 Excel 문서를 편집하는 액티비티 카드에서 사용합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Excel	변수	Y	-	Y	실행된 Excel 문서를 할당할 변수를 입력합니다.
N	Invisible	토글버튼	N	-	Y	열린 Excel 문서를 보이게 할지 여부를 설정합니다. (기본값: Off) On 설정 시 다른 Excel 라이브러리에서 ACTIVE_EXCEL 을 사용했을 경우 수행속도가 느려질 수 있어 ACTIVE_EXCEL 대신 해당 액티비티의 Output 값을 명시적으로 입력해야 합니다.
N	Maximize	토글버튼	N	-	Y	열린 Excel 문서의 창 크기를 최대화할지 설정합니다. (기본값: On)
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새 Excel 파일을 생성한 후 파일명을 지정 및 저장하고, Excel 파일을 닫습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_New_Excel_Test

사용된 변수

newExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Output] Excel = this.newExcel
Invisible = Off
Maximize = On

특이 사항

새 Excel 문서를 생성하는 용도로 사용하며, 저장 시 반드시 파일명을 입력해야 합니다.

연관/유사 액티비티

OpenExcel, CreateExcel, SaveExcel, CloseExcel

CreateExcel

개요

새로운 Excel 문서를 생성합니다.

CreateExcel은 NewExcel(빈 문서 열기) → SaveExcel(저장) → CloseExcel(닫기)을 한 것과 동일합니다.

사용 절차

Path에 생성하고자 하는 Excel 문서의 파일 경로와 파일명을 입력하세요.
OverWrite에서 경로에 이미 파일이 존재할 경우 덮어쓸지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Path	문자	Y	-	N	생성할 Excel 문서의 파일 경로와 파일명을 입력합니다. 이 카드를 최초 사용할 때에는 파일 경로가 표시되어 있지 않습니다.
N	OverWrite	토글버튼	N	-	Y	이미 존재하는 Excel 문서를 생성하는 경우 파일을 덮어쓰도록 설정합니다. (기본값: Off)
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

설정한 경로에 지정한 파일명으로 새로운 Excel 문서를 생성합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_CreateExcel_Test

사용된 변수

없음

사용된 속성

Path = 'C:\\CreateExcel_Test'
OverWrite = True

연관/유사 액티비티

NewExcel, OpenExcel, SaveExcel, CloseExcel

OpenExcel

개요

경로(Path)를 지정하여 원하는 Excel 문서를 엽니다.

사용 절차

액티비티 카드의 Path 속성에 입력한 경로에 열고자 하는 Excel 문서가 존재해야 합니다.

Path에 열고자 하는 Excel 문서의 경로와 파일명을 입력하세요.
[Output] Excel에 실행 결과를 저장할 변수를 입력하세요(기본값: RESULT). 할당한 변숫값은 Excel 문서를 편집하는 액티비티 카드에서 사용합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Excel	변수	Y	-	Y	열린 Excel 문서를 할당할 변수를 입력합니다.(기본값: RESULT) 스크립트 가독성을 위해 Excel Handler를 변수로 정의한 후 입력창에 사용할 수 있습니다.
N	Path	문자	Y	-	N	열고자 하는 Excel 파일이 있는 위치와 파일명을 입력합니다.
N	Invisible	토글버튼	N	-	Y	열린 Excel 문서를 보이게 할지 여부를 설정합니다. (기본값: Off) On 설정 시 다른 Excel 라이브러리에서 ACTIVE_EXCEL 을 사용했을 경우 수행속도가 느려질 수 있어 ACTIVE_EXCEL 대신 해당 액티비티의 Output 값을 명시적으로 입력해야 합니다.
N	Maximize	토글버튼	N	-	Y	열린 Excel 화면의 창 크기를 최대화할지 설정합니다. (기본값: On)
N	Execute Shell	토글버튼	N	-	Y	Excel 문서를 더블클릭으로 실행한 것과 동일하게 열지 설정합니다. (기본값: Off)
N	ReadOnly	토글버튼	N	-	Y	Excel 문서를 읽기 전용으로 열지 설정합니다. (기본값: Off)
N	Use Password	토글버튼	N	-	Y	비밀번호를 사용할지 설정합니다. (기본값: Off)
N	Text Delimiter	콤보박스	N	-	Y	Execute Shell 속성이 Off 인 경우에만 사용됩니다. 텍스트 기반 파일을 분리하여 열기 위한 구분자를 지정합니다. 확장자가 .csv 인 경우, 운영체제의 목록 구분자 설정에 따라 동작하며, Text Delimiter 의 설정 값과 운영체제의 목록 구분자가 다른 경우, 실행 시 오류를 출력합니다. 현재 지원하는 구분자는 다음과 같습니다. Comma(,) Colon(.) Semicolon(;) Caret(^) Pipe(\|) Tab( ) Space( ) Ampersand(&) Ampersat(@);Asterisk(*) Backslash(\) Dollar($) Dot(.) Equals(=) Exclamation(!) Hyphen(-) Percent(%) Plus(+) Question(?) Sharp(#) Slash(/) Tilde(~) Underscore(_)
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

생성된 CreateExcel_Test Excel 파일을 열고 닫습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_OpenExcel_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수

사용된 속성

[Output] Excel = this.openExcel
Path = 'C:\\CreateExcel_Test.xlsx'

특이 사항

Invisible, Maximize, Execute Shell, ReadOnly, UsePassword와 같은 다양한 속성들이 있습니다. 자세한 내용은 OpenExcel의 '카드 속성'을 참고하세요.

연관/유사 액티비티

NewExcel, CreateExcel

SaveExcel

개요

지정한 Excel 문서를 저장합니다.

사용 절차

저장할 Excel 파일이 열려 있어야 합니다.

[Input] Excel에 저장하고자 하는 Excel 문서의 변수를 입력하세요.
다른 이름으로 저장하고자 할 경우 SaveAs에 저장할 경로와 파일명을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	저장할 Excel 문서를 할당할 변수를 입력합니다.
N	SaveAs	문자	N	-	N	다른 이름으로 저장할 경우, 저장 경로와 파일명을 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

생성한 Excel 파일을 열고, 지정한 시트의 'A1:B1' 영역, 'C4:D6' 영역, 'E8:F10' 영역에 데이터를 입력합니다. 이후 Excel을 다른 이름으로 저장하고 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_SaveExcel_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SaveAs = 'C:\\CreateExcel_Test_SaveAs.xlsx'

연관/유사 액티비티

NewExcel, OpenExcel, CloseExcel

CloseExcel

개요

열려 있는 Excel 문서를 닫습니다.

사용 절차

닫고자 하는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 닫고자 하는 Excel 문서의 변수를 입력하세요.
Force에서 문서의 상태와 상관없이 강제로 종료할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Intput] Excel	변수	Y	-	Y	닫고자 하는 Excel 문서를 할당할 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Force	토글버튼	N	-	Y	Excel 문서를 문서 상태와 상관없이 강제로 종료할지 설정합니다.(기본값: Off)
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

생성한 Excel 파일을 열고, 지정한 시트의 'A1:B1' 영역, 'C4:D6' 영역, 'E8:F10' 영역에 데이터를 입력합니다. 이후 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_CloseExcel_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수

사용된 속성

[Input] Excel = this.openExcel

연관/유사 액티비티

NewExcel, OpenExcel, CreateExcel, SaveExcel

ActivateExcel

개요

비활성화된 Excel 문서를 활성화시킵니다.

사용 절차

활성화하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 활성화하고자 하는 Excel 문서의 할당 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	N	활성화할 Excel 문서를 할당할 변수를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

Excel 문서 두 개를 새로 생성(CreateExcel_Test_1.xlsx, CreateExcel_Test_2.xlsx)하여 엽니다. 이후 'CreateExcel_Test_1.xlsx'을 활성화하여 지정한 시트의 A1 셀에 텍스트를 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_ActivateExcel_Test

사용된 변수

openExcel_1 = 열린 첫 번째 Excel 문서를 지정할 변수
openExcel_2 = 열린 두 번째 Excel 문서를 지정할 변수

사용된 속성

[Input] Excel = this.openExcel_1 (첫 번째 Excel 문서를 활성화)

연관/유사 액티비티

GetActiveExcel

개요

활성화된 Excel 문서를 변수로 저장합니다.

사용 절차

열린 Excel 문서가 활성화되어 있어야 합니다.

[Output] Excel에 활성화된 Excel 문서를 지정할 변수를 입력하세요.
Maximize에서 대상 문서의 창 크기를 최대화할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Excel	변수	Y	-	Y	결과로 받을 활성화된 Excel 문서를 할당할 변수를 입력합니다. (기본값: RESULT)
N	Maxmize	토글버튼	N	-	Y	대상 Excel 문서의 창 크기를 최대화할지 설정합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

Excel 문서 두 개를 새로 생성(CreateExcel_Test_1.xlsx, CreateExcel_Test_2.xlsx)하여 엽니다. 이후 활성화된 Excel 파일을 확인한 후 지정한 시트의 A1 셀에 텍스트를 입력한 후 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_GetActiveExcel_Test

사용된 변수

GetActiveExcel = 활성화된 Excel 문서를 지정할 변수
openExcel_1 = 열린 첫 번째 Excel 문서를 지정할 변수
openExcel_2 = 열린 두 번째 Excel 문서를 지정할 변수

사용된 속성

[Output] Excel = this.GetActiveExcel
Maximize = On

연관/유사 액티비티

ActivateExcel

GetExcel

개요

실행된 Excel 문서 중 지정한 이름의 Excel 문서를 가지고 옵니다.

사용 절차

정보를 가져올 Excel 문서가 열려 있어야 합니다.

[Output] Excel에 수행한 결괏값을 저장할 변수를 입력하세요.
FileName에 가져올 대상 Excel 문서의 파일명을 입력하세요.
Maximize에서 대상 문서의 창 크기를 최대화할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Excel	변수	Y	-	Y	결과로 받을 Excel 문서를 할당할 변수를 입력합니다.
N	FileName	문자	Y	-	N	대상 Excel 파일을 지정합니다.
N	Maximize	토글버튼	N		Y	대상 Excel 문서의 창 크기를 최대화할지 설정합니다. (기본값: On)
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

Excel 문서 두 개를 새로 생성(CreateExcel_Test.xlsx, CreateExcel_Test_GetExcel.xlsx)하여 엽니다. 'CreateExcel_Test.xlsx'를 'getExcel' 변수로 지정한 후 지정한 시트의 A1:B3 셀에 텍스트를 입력한 후 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_GetExcel_Test

사용된 변수

getExcel = 가져온 Excel 문서를 지정할 변수

사용된 속성

[Output] Excel = this.getExcel
FileName = 'CreateExcel_Test.xlsx'
Maximize = On

연관/유사 액티비티

GetActiveExcel

SplitExcel

개요

워크시트가 여러 개인 Excel 문서의 워크시트 일부 또는 전체를 복사해 새로운 Excel 문서를 만듭니다.

사용 절차

[Input] Excel에 데이터를 가져올 Excel 문서를 지정한 변수를 입력하세요.
Path에 엑셀 파일이 저장될 디렉토리 경로를 입력합니다.
WholeSheet에서 데이터를 가져올 대상 문서의 모든 시트를 선택할지 설정하세요.
워크시트 일부만 가져올 경우 SheetName에 해당 워크시트명을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	읽어올 영역이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Path	문자	Y	-	N	새 Excel 문서를 저장할 경로를 입력합니다.
N	WholeSheet	토글버튼	Y	-	Y	워크시트 전체 또는 일부만 복사할지 선택합니다.
N	CloseAfterSave	토글버튼	Y	-	Y	복사되어 저장이 완료된, 열린 새로운 Excel 문서를 자동으로 닫을 지 여부를 선택합니다.
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	카드 속성	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새 Excel 파일(CreateExcel_Test.xlsx)을 생성하고 연 후 새 시트를 추가합니다. SpiltExcel 액티비티 카드를 사용하여 'CreateExcel_Test.xlsx'에 있는 시트 전체 또는 일부를 'SpiltExcel.xlsx' 파일에 추가합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manage Excel > P_SplitExcel_Test

사용된 변수

openExcel = 워크시트를 가져올 Excel 문서를 지정할 변수

사용된 속성

[Input] Result = this.openExcel
CloseAfterSave = off

연관/유사 액티비티

SplitRange

CreateWorkSheet

개요

Excel 문서에 새로운 워크시트를 추가합니다.

사용 절차

워크시트를 추가할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 워크시트를 추가할 Excel 문서의 변수를 입력하세요.
SheetName에 생성할 워크시트의 이름 또는 변수를 입력하세요.
[SHEET] Position에 워크시트를 생성할 위치를 지정하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	워크시트를 추가할 대상 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)에 4개의 워크시트(CreateWorkSheet1~4)를 새로 추가한 후, 5번째에 위치한 워크시트명을 확인하고 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit WorkSheet > P_CreateWorkSheet_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'CreateWorkSheet1' (~ 'CreateWorkSheet4')
Position = 1

특이 사항

연관/유사 액티비티

CopyWorkSheet, DeleteWorkSheet, GetAllSheetNames, SelectWorkSheet

SelectWorkSheet

개요

Excel 문서에서 특정 워크시트를 선택합니다.

사용 절차

선택할 워크시트가 있는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 선택할 워크시트가 있는 Excel 문서의 변수를 입력하세요.
SheetName에 선택할 워크시트의 이름 또는 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	선택할 워크시트가 있는 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일에 워크시트 4개를 추가한 후에 1번 워크시트(시트명: CreateWorkSheet1)를 선택합니다. 이후에 파일을 저장하고 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit WorkSheet > P_SelectWorkSheet_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수

사용된 속성

[Input] Excel = this.openExcel

연관/유사 액티비티

SelectRange, SelectRow, SelectCol

CopyWorkSheet

개요

Excel 문서에서 특정 워크시트를 복사합니다.

사용 절차

복사하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 복사할 워크시트가 있는 Excel 문서의 변수를 입력하세요.
SourceSheet에 복사할 원본 워크시트의 이름 또는 변수를 입력하세요.
DestSheet에 복사한 내용을 붙여넣기할 워크시트의 이름 또는 변수를 입력하세요.
BeforeSheet에 복사 대상 뒤에 위치할 워크시트의 이름 또는 변수를 입력하세요.
AfterSheet에 복사 대상 앞에 위치할 워크시트의 이름 또는 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	시트를 복사할 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	[SHEET] SourceSheet	문자	Y	-	Y	복사할 원본 워크시트를 입력합니다. (기본값: ACTIVE_SHEET) ACTIVE_SHEET는 현재 열려 있는 시트를 의미합니다.
N	[SHEET] DestSheet	문자	N	-	N	복사한 내용을 붙여넣기할 대상 워크시트를 입력합니다.
N	[SHEET] BeforeSheet	문자	Y	-	N	복사 대상 뒤에 위치하는 워크시트를 입력합니다. (기본값: ACTIVE_SHEET) ACTIVE_SHEET는 현재 열려 있는 시트를 의미합니다.
N	[SHEET] AfterSheet	문자	N	-	N	복사 대상 앞에 위치하는 워크시트를 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)에 2개의 새 워크시트(CreateWorkSheet1, CreateWorkSheet2)를 추가합니다. 이후 워크시트 'Sheet1'을 복사하여 'Sheet1' 시트 앞에 워크시트명이 'CopyWorkSheet'인 워크시트로 붙여넣습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit WorkSheet > P_CopyWorkSheet_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수

사용된 속성

[Input] Excel = this.openExcel
SourceSheet = 'Sheet1'
DestSheet = 'CopyWorkSheet'
BeforeSheet = 'Sheet1'
AfterSheet = ''

연관/유사 액티비티

CreateWorkSheet, SelectWorkSheet, MoveWorkSheet, DeleteWorkSheet

MoveWorkSheet

개요

Excel 문서에서 특정 워크시트를 옮깁니다.

사용 절차

대상 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 이동할 워크시트가 있는 Excel 문서의 변수를 입력하세요.
SourceSheet에 옮길 대상 워크시트의 이름 또는 변수를 입력하세요.
BeforeSheet 또는 AfterSheet에서 대상 워크시트 앞 또는 뒤에 위치할 워크시트의 이름 또는 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	옮길 워크시트가 있는 Excel 문서가 할당된 변수를 입력합니다.
N	[SHEET] SourceSheet	문자	Y	-	Y	이동할 원본 워크시트를 입력합니다. (기본값: ACTIVE_SHEET) ACTIVE_SHEET는 현재 열려 있는 시트를 의미합니다.
N	[SHEET] BeforeSheet	문자	Y	-	N	옮겨진 워크시트 위치의 바로 앞 워크시트 이름을 작은따옴표 안에 입력합니다.
N	[SHEET] AfterSheet	문자	Y	-	N	옮겨진 워크시트 위치의 바로 뒤 워크시트 이름을 작은따옴표 안에 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

특이 사항

워크시트의 위치 지정 속성은 BeforeSheet와 AfterSheet 중 하나만 사용할 수 있습니다.

연관/유사 액티비티

CreateWorkSheet, SelectWorkSheet, CopyWorkSheet, DeleteWorkSheet

DeleteWorkSheet

개요

Excel 문서에서 특정 워크시트를 삭제합니다.

사용 절차

대상 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 삭제할 워크시트가 있는 Excel 문서의 변수를 입력하세요.
SheetName에 삭제할 워크시트의 이름 또는 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	삭제할 워크시트가 있는 Excel 문서가 할당된 변수를 입력합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)에 추가한 두 개의 워크시트('CreateWorkSheet1~2') 중 두번째 워크시트를 삭제하고 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit WorkSheet > P_DeleteWorkSheet_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'CreateWorkSheet2' (DeleteWorkSheet)
SheetName = 'CreateWorkSheet1' (~'CreateWorkSheet2') (CreateWorkSheet)
Path = 'C:\\CreateExcel_Test'

특이 사항

연관/유사 액티비티

CreateWorkSheet, SelectWorkSheet, CopyWorkSheet, MoveWorkSheet

GetSheetName

개요

Excel 문서의 특정 위치(순번)에 있는 Excel 문서 워크시트의 이름을 가져옵니다. 반환된 시트명을 변수로 받아서 후속 프로세스에 활용할 수 있습니다.

사용 절차

대상 Excel 문서가 열려 있어야 합니다.

[Output] SheetName에 결과로 받을 워크시트명을 저장할 변수를 입력하세요.
[Input] Excel에 대상 워크시트가 있는 Excel 문서의 변수를 입력하세요.
Position에 이름을 가져올 워크시트의 순번을 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
SheetName	string	-	해당 Excel 문서에서 지정한 순서(Position)의 워크시트명을 반환합니다.	'Sheet1'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	검색 대상 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

openExcel 변수로 지정한 Excel 파일의 첫 번째 시트명을 받아서 this.SheetName이라는 변수에 할당합니다. 새로 생성한 Excel 파일에 워크시트 4개(CreateWorkSheet1~4)를 추가한 후, 첫 번째 시트명이 'Sheet1'이면 파일을 다른 이름으로 저장하고, 아니면 Exception 발생시킨 후 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit WorkSheet > P_GetSheetName_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수
getSheetName = 가져온 워크시트명을 저장할 변수

사용된 속성

[Output] SheetName = this.getSheetName
[Input] Excel = this.openExcel
Position = 1

특이 사항

워크시트명을 기준으로 데이터를 처리할 필요가 있거나, 후속 프로세스에서 대상 워크시트를 명시적으로 지정하는 용도로 사용합니다.

연관/유사 액티비티

GetAllSheetNames

개요

Excel 문서에 포함된 워크시트명을 모두 가져옵니다. 반환된 시트명 목록을 변수로 받아서 후속 프로세스에 활용할 수 있습니다.

사용 절차

대상 Excel 문서가 열려 있어야 합니다.

[Output] SheetName에 결과로 받을 워크시트명 배열을 저장할 변수를 입력하세요.
[Input] Excel에 이름을 가져올 워크시트가 있는 Excel 문서의 변수를 입력하세요.
Visibility 를 선택하여 숨김 시트를 포함하여 가져올 지 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
SheetNames	1차원 배열	string	해당 Excel 문서에서 모든 워크시트명을 반환합니다.	0: 'Sheet1' 1: 'Sheet2' 2: 'Sheet3'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	검색 대상 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Visibility	Select	Y	-	N	통합 문서에 포함된 숨김 시트를 선택적으로 가지고 올 수 있습니다. - All : 숨김 시트를 포함한 모든 시트명 가져오기 - OnlyVisible : 숨김 시트를 제외한 모든 시트명 가져오기 - OnlyHidden : 숨김 시트만 가져오기
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

openExcel 변수로 지정한 Excel 파일의 워크시트명 배열을 받아 this.getAllSheetName이라는 변수에 할당합니다. 새로 생성한 Excel 파일에 워크시트 4개(CreateWorkSheet1~4)를 추가한 후, 모든 워크시트명을 읽어와 순서대로 하나씩 메시지 박스로 출력한 후 CreateExcel_Test_SaveAs.xlsx로 저장하고 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit WorkSheet > P_GetAllSheetNames_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수
getAllSheetName = 가져온 워크시트명을 저장할 변수

사용된 속성

[Output] SheetName = this.getAllSheetName
[Input] Excel = this.openExcel

특이 사항

Excel 워크시트명 배열을 받아와 워크시트명을 기준으로 순차적으로 데이터를 처리하거나, 후속 프로세스에서 활용하는 용도로 사용합니다.

연관/유사 액티비티

GetSheetName

SelectRange

개요

Excel 문서에서 특정 영역을 선택합니다. 반환된 영역 정보를 변수로 받아서 후속 프로세스에 활용할 수 있습니다.

사용 절차

선택할 영역이 있는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 영역을 선택할 Excel 문서의 변수를 입력하세요.
SheetName에 영역을 선택할 워크시트명 또는 변수를 입력하세요.
Range에 선택할 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	영역을 선택할 Excel 문서의 변수를 입력합니다. (기본값: RESULT)
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에서 A6:H41까지의 영역을 선택합니다. 선택된 영역 정보를 메시지박스로 출력하고 문서를 저장한 후에 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_SelectRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 지정할 변수
range = 선택한 Excel 영역 정보를 저장할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Range = this.range (A6:H41)

특이 사항

Excel 파일의 특정 영역을 선택한 후 단축키 사용, 키 입력, 메뉴 조작 등을 통한 후속 처리를 할 수 있습니다.

연관/유사 액티비티

SelectWorkSheet, SelectRow, SelectCol

GetActiveRange

개요

Excel 문서에서 현재 선택된 영역을 가져옵니다.

사용 절차

선택된 영역을 가져오려는 Excel 문서가 열려 있어야 합니다.

[Output] Range에 가져온 영역 정보를 저장할 변수를 입력하세요.
[Input] Excel에 선택된 영역이 있는 Excel 문서의 변수를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Range	string	-	Input된 Excel 문서에서 활성화 상태의 영역 정보를 반환합니다.	'A1:E5'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	선택된 영역 정보를 가져올 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

Excel 문서 안에 선택된 영역정보인 'A6:H41' 값을 변수 getActRange에 저장합니다.
새로 생성한 Excel 파일(CreateExcel_Test.xlsx)에서 'Sheet1' 워크시트의 'A6:H41' 셀을 선택합니다. 현재 선택된 영역값을 다시 읽어 확인하고, 영역값이 지정된 값과 같으면 문서를 다른 이름으로 저장하고, 아니면 Exception 발생시킨 후 Excel을 종료합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_GetActiveRange_Test

사용된 변수

openExcel: 열린 Excel 문서를 지정할 변수
getActRange: 가져온 영역 정보를 저장할 변수

사용된 속성

[Output] Range = this.getActRange
SheetName = 'Sheet1'
Range = this.range (A6:H41)

연관/유사 액티비티

SelectRange, GetDataRange, ClearRange, ReadRange, WriteRange, MakeRange, MergeRange, SplitRange, CopyRange, PasteRange, CopyPaste, SetStyleRange, SetBorderRange

GetDataRange

개요

Excel 문서에서 데이터가 입력된 영역을 가져옵니다. 반환된 영역 정보를 변수로 받아서 후속 프로세스에 활용할 수 있습니다.

사용 절차

데이터가 입력된 영역을 가져오려는 Excel 문서가 열려 있어야 합니다.

[Output] Range에 반환된 영역 정보를 저장할 변수를 입력하세요.
[Input] Excel에 데이터 영역을 가져올 Excel 문서의 변수를 입력하세요.
SheetName에 데이터 영역을 가져올 워크시트의 이름 또는 변수를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Range	string	-	Input된 Excel 문서에서 데이터가 입력되어있는 영역 정보를 반환합니다.	'A1:E5'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	데이터 영역을 가져올 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1), 'HongGildong'(C4:D6), '오늘날짜'(E8:F10) 데이터를 입력하고, 데이터가 입력된 영역(A1:F10)을 확인합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_GetDataRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
getDataRange = 가져온 영역 정보를 저장할 변수
sheetName = 데이터 영역 정보를 가져올 워크시트명이 입력된 변수

사용된 속성

[Output] Range = this.getDataRange
[Input] Excel = this.openExcel
SheetName = this.sheetName

연관/유사 액티비티

GetActiveRange

ClearRange

개요

Excel 문서에서 특정 영역의 데이터를 삭제합니다.

사용 절차

데이터를 삭제하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 데이터를 삭제할 Excel 문서의 변수를 입력하세요.
SheetName에 데이터를 삭제할 워크시트명 또는 변수를 입력하세요.
Range에 삭제할 데이터 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	데이터를 삭제할 Excel 문서의 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	AutoSave	토글버튼	N	-	N	데이터를 삭제한 후 자동으로 저장할지 설정합니다. (기본값: Off) 별도의 설정 없이는 자동으로 저장하지 않습니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1), 'HongGildong'(C4:D6), '오늘날짜'(E8:F10) 데이터를 입력하고, 데이터가 입력된 영역(A1:F10)을 찾아 해당 영역의 데이터를 지웁니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_ClearRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
getDataRange = 가져온 영역 정보를 저장할 변수
sheetName = 데이터 영역 정보를 가져올 워크시트명이 입력된 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = this.sheetName
Range = this.getDataRange

연관/유사 액티비티

SelectRange, GetActiveRange, GetDataRange, ReadRange, WriteRange, MakeRange, MergeRange, SplitRange, CopyRange, PasteRange, CopyPaste, SetStyleRange, SetBorderRange

ReadRange

개요

Excel 문서에서 지정한 영역을 읽어옵니다.

사용 절차

읽어오려는 Excel 문서가 열려 있어야 합니다.

[Output] DataArray에 읽어온 결과를 할당할 변수를 입력하세요.
[Input] Excel에 읽어올 데이터 영역이 있는 Excel 문서의 변수를 입력하세요.
ReadCellType에서 읽어올 데이터 영역의 각 셀 값을 읽는 방식을 선택하세요.
SheetName에 읽어올 데이터 영역이 있는 워크시트명 또는 변수를 입력하세요.
Range에 읽어올 데이터 영역을 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
DataArray	2차원배열	object	Input된 Excel 문서에서 Range로 선택된 영역의 정보를 반환합니다.	0: 'Col1' \| 'Col2' 1: 'Value1' \| 'Value2'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	읽어올 영역이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	[SHEET] ReadCellType	콤보박스	N	-	N	읽어올 영역의 타입을 지정합니다. ※ 타입 종류 - Data, Value, Formula, Text
N	[SHEET]Read2DAlways	True/False	Y	-	Y	대상 Range가 단일 셀이라도 항상 2차원 배열로 출력할 수 있도록 설정하는 속성입니다. 기본값은 False이며, 단일셀이 대상이라면 문자열로 출력합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

ReadCellType에서 Text를 선택하는 경우 항상 값을 Range상 좌상단 값 하나만 출력합니다.

Text가 가져오는 영역은 아래 그림의 붉은 박스의 값입니다.

Excel_NewExcel_1K

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에서 'A1:C3' 영역에 'Hello' 데이터를 입력한 후 그 데이터를 배열로 저장합니다. 저장한 배열을 메시지 박스로 각각 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_ReadRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
readRange = 영역을 읽어온 결괏값을 저장할 변수

사용된 속성

[Output] DataArray = this.readRange
[Input] Excel = this.openExcel
ReadCellType = Value
SheetName = 'Sheet1'
Range = 'A1:C3'

특이 사항

DataArray 참조 방법(읽어 들인 Range 기준)

N/A
- DataArray[0] → 1번째 Row
- DataArray[0].Length → 1번째 Row의 개수
- DataArray[0][1] → 1번째 Row, 2번째 Column 값

연관/유사 액티비티

WriteRange

개요

Excel 문서에서 선택된 영역에 데이터를 입력합니다.

사용 절차

입력하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 데이터를 입력할 Excel 문서의 변수를 입력하세요.
DataArray에 입력할 데이터 영역이 할당된 변수를 입력하세요.
SheetName에 데이터를 입력할 워크시트명 또는 변수를 입력하세요.
StartCell에 데이터 입력을 시작할 셀의 주소를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	데이터를 입력할 Excel 문서가 할당된 변수를 입력합니다.
N	DataArray	문자	Y	-	N	입력할 데이터 영역이 할당된 Excel 문서의 변수를 입력합니다. 이차원 배열을 입력해야 합니다.
N	AutoSave	토글버튼	N	-	Y	데이터를 입력한 후 자동으로 저장할지 설정합니다.
N	[SHEET] StartCell	문자	Y	-	Y	데이터가 입력될 좌측 상단의 셀 이름을 작은따옴표 안에 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1), 'HongGildong'(C4:D6), '오늘날짜'(E8:F10) 데이터를 입력합니다. 이 중 A1:B1 영역을 데이터를 읽어와 지정한 워크시트의 셀 주소에 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_WriteRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
readRange = 영역을 읽어온 결괏값을 저장할 변수

사용된 속성

[Input] Excel = this.openExcel
DataArray = this.readRange
SheetName = 'Sheet1'
StartCell = 'A20'

연관/유사 액티비티

ReadRange

MakeRange

개요

특정 Excel 문서의 영역을 지정하여 변수에 할당합니다.

사용 절차

[Output] Range에 가져온 영역 정보를 저장할 변수를 입력하세요.
Range에 지정할 영역을 입력하세요.
InputValue에 Range 항목에서 입력한 위치를 기준으로 행과 열을 증가 또는 감소시킬 값을 입력하세요.
IsRow에서 행 또는 열을 변경할지 선택하세요.(On: 행 변경 / Off: 열 변경)
IsIncrease에서 Range 증가 여부를 선택하세요.
FirstAddress에서 Range 항목에 입력한 값이 하나의 셀이 아니라 영역일 경우 콜론(:) 앞의 주소를 선택할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Range	변수	Y	-	Y	만들어진 영역이 할당될 변수를 입력합니다. (기본값: RESULT)
N	Range	문자	Y	-	N	지정된 영역이 만들어질 시작점의 위치를 입력합니다.
N	InputValue	문자	Y	-	Y	Range 항목의 위치를 기준으로 행 또는 열을 증가 또는 감소시킬 숫자를 입력합니다.
N	IsRow	토글버튼	Y	-	Y	행을 계산할지 여부를 지정합니다. 행을 변경하려면 On, 열을 변경하려면 Off를 선택합니다.
N	IsIncrease	토글버튼	Y	-	Y	Range를 증가시킬지 여부를 지정합니다. 증가시키려면 On, 감소기키려면 Off를 선택합니다.
N	FirstAddress	토글버튼	Y	-	Y	Range 항목이 하나의 셀이 아닌 영역으로 지정된 경우 MakeRange 대상을 시작 주소로 할지 선택합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1), 'HongGildong'(C4:D6), '오늘날짜'(E8:F10) 데이터를 입력합니다. 이후 Excel 파일의 지정될 영역을 설정하고, 증가할 열과 증가 값을 설정한 후, 그 결과를 변수(this.makeRange)에 저장합니다. WriteString 액티비티 카드를 사용하여 지정된 영역(this.makeRange)에 값을 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_MakeRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
makeRange = 영역을 읽어온 결괏값을 저장할 변수

사용된 속성

[Output] Result = this.makeRange
Range = 'B20'
InputValue = 5
IsRow = Off
IsInclease = On
FirstAddress = Off

특이 사항

열이나 행이 증가하여 셀 주소를 입력하기 어려울 때 사용합니다.

연관/유사 액티비티

MergeRange, SplitRange

MergeRange

개요

Excel 문서의 지정된 셀 영역을 병합합니다.

사용 절차

[Input] Excel에 지정된 영역를 병합할 Excel 문서의 변수를 입력하세요.
IncludeAllData에서 셀 병합 시 모든 데이터를 병합된 셀에 포함할지 선택하세요.
SheetName에 병합할 영역이 있는 워크시트명 또는 변수를 입력하세요.
Range에 병합할 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	영역을 병합할 Excel 문서가 할당된 변수를 입력합니다.
N	IncludeAllData	토글버튼	Y	-	Y	셀 병합 시 모든 데이터를 병합된 셀에 포함할지 선택합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1), 'Merge Range Test'(C4:D8) 데이터를 입력합니다. 셀 영역('C4:F11')을 지정하여 병합합니다. 셀 병합 시 첫 번째 셀의 데이터만 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_MergeRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
IncludeAllData = False
SheetName = 'Sheet1'
Range = 'C4:F11'

연관/유사 액티비티

SplitRange

개요

Excel 문서 영역의 행과 열을 분리하여 변수에 배열로 할당합니다

사용 절차

[Output] DataArray에 분리된 배열을 저장할 변수를 입력하세요.
Range에 분리할 영역을 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
DataArray	Object	Dictionary<string, object>	분리된 영역의 결과를 반환합니다.	Range가 'A1:B2'의 경우 { 0: A 1: 1 2: B 3: 2 }

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Range	문자	Y	-	N	분리할 영역을 입력합니다.
N	Name or Number	토글버튼	N	-	Y	열(Column) 정보를 영문자 또는 숫자(A=1)로 받을지 선택합니다. (On: 영문자/Off: 숫자)
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1) 데이터를 입력합니다. 행과 열을 분리할 영역을 지정하고 변수로 할당합니다. A1:B2이면  A, 1, B, 2가 문자열 리스트로 반환됩니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_SplitRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
splitRange = 행과 열을 분리한 결괏값을 저장할 변수
getDataRange: 분리할 행과 열의 영역 정보를 저장한 변수(GetDataRange 수행 결괏값을 저장한 변수)

사용된 속성

[Output] Result = this.splitRange
Range = this.getDataRange
Name or Number = On

특이 사항

'A6:BB2' 입력으로 'A', '6', 'BB', '2'가 this.range 변수에 배열로 할당됩니다.

연관/유사 액티비티

MergeRange

CopyRange

개요

Excel 문서에서 지정한 영역의 데이터를 복사합니다.

사용 절차

[Input] Excel에 영역을 복사할 Excel 문서의 변수를 입력하세요.
SheetName에 복사할 영역이 있는 워크시트명 또는 변수를 입력하세요.
Range에 복사할 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	영역을 복사할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1) 데이터를 입력합니다. 입력한 영역의 데이터를 복사한 후 지정 위치 'D1:E2'에 붙여 넣습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_CopyRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Range = 'A1:B2'

연관/유사 액티비티

PasteRange

개요

Excel 문서에서 복사한 영역 데이터를 붙여 넣습니다.

사용 절차

붙여 넣으려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 복사한 데이터를 붙여 넣을 대상 Excel 문서의 변수를 입력하세요.
속성에서 붙여 넣을 데이터 유형, 붙여넣기 연산 방식, 내용이 있는 셀만 붙여 넣을지, 복사한 데이터의 행과 열을 바꿔서 붙여 넣을지 등을 설정하세요.
SheetName에 복사한 데이터를 붙여 넣을 워크시트명 또는 변수를 입력하세요.
Range에 붙여 넣을 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	붙여넣기를 수행할 대상 Excel 문서가 할당된 변수를 선택합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Paste Type	콤보박스	N	-	Y	붙여넣기할 데이터의 유형을 선택합니다. ※ 방식 종류 - UsingSourceTheme, Formulas, ExceptBorders,Values, ColumnWidths, Formats, FormulasAndNumberFormats, Comments, ValuesAndNumberFormats, Validation, MergingConditionalFormats
N	Paste Operation	콤보박스	N	-	Y	붙여넣기할 작업의 연산 방식을 선택합니다. ※ 연산 종류 - Add, Subract, Multiply, Divide
N	PasteSkipBlanks	토글버튼	Y	-	Y	내용이 있는 셀만 붙여 넣을지 설정합니다.
N	PasteTranspose	토글버튼	Y	-	Y	복사한 데이터의 행/열을 바꿔 붙여 넣을지 설정합니다.
N	PasteUseLinks	토글버튼	Y	-	Y	복사한 데이터의 링크를 붙여 넣기할지를 선택합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'Test'(A1:B1) 데이터를 입력합니다. 입력한 영역의 데이터를 복사한 후 지정 위치 'D1:E2'에 붙여 넣습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_PasteRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
Paste Type = All
Paste Operation = None
PasteSkipBlanks = On
PasteTranspose = On
PasteUseLinks = On
SheetName = 'Sheet1'
Range = 'D1:E2'

특이 사항

PasteRange의 속성은 Excel 옵션인 '선택하여 붙여넣기'의 각 기능과 대응합니다.

연관/유사 액티비티

CopyRange

CopyPaste

개요

Excel 문서의 특정 영역을 복사하고 붙여넣습니다.

사용 절차

복사 및 붙여넣기를 수행할 Excel 문서가 열려 있어야 합니다.

[Input] SourceExcel에 영역을 복사할 Excel 문서의 변수를 입력하세요.
[Input] DestExcel에 복사한 데이터를 붙여 넣을 대상 Excel 문서의 변수를 입력하세요.
속성에서 붙여 넣을 데이터 유형, 붙여넣기 연산 방식, 붙여 넣을 대상 Excel 문서 자동 저장 여부, 내용이 있는 셀만 붙여 넣을지, 복사한 데이터의 행과 열을 바꿔서 붙여 넣을지, 복사한 데이터의 링크를 붙여넣을지 등을 설정하세요.
SourceSheet에 영역을 복사할 워크시트명 또는 변수를 입력하세요.
SourceRange에 복사할 영역을 입력하세요.
DestName에 복사한 데이터를 붙여 넣을 워크시트명 또는 변수를 입력하세요.
TargetRange에 붙여 넣을 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	N	붙여넣기를 수행할 대상 Excel 문서가 할당된 변수를 입력합니다.
N	[Input] SourceExcel	변수	Y	-	N	복사할 원본 Excel 문서가 할당된 변수를 입력합니다.
N	PasteType	콤보박스	N	-	Y	붙여넣기할 값의 유형을 선택합니다. ※ 방식 종류 - UsingSourceTheme, Formulas, ExceptBorders,Values, ColumnWidths, Formats, FormulasAndNumberFormats, Comments, ValuesAndNumberFormats, Validation, MergingConditionalFormats
N	Paste Operation	콤보박스	N	-	Y	붙여넣기 작업의 연산 방식을 선택합니다. ※ 연산 종류 - Add, Subract, Multiply, Divide
N	DestAutoSave	토글버튼	Y	-	Y	붙여넣기를 수행한 후 문서를 자동으로 저장할지 설정합니다. (기본값: 미사용 - 회색)
N	PasteSkipBlanks	토글버튼	Y	-	Y	내용이 있는 셀만 붙여 넣을지 설정합니다. (기본값: 미사용 - 회색)
N	PasteTranspose	토글버튼	Y	-	Y	복사한 데이터의 행/열을 바꿔 붙여 넣을지 설정합니다. (기본값: 미사용 - 회색)
N	PasteUseLinks	토글버튼	Y	-	Y	복사한 데이터의 링크를 붙여 넣기할지를 선택합니다. (기본값: 미사용 - 회색)
N	[SHEET-SourceSheet]	문자	Y	-	Y	복사할 원본의 대상 워크시트명을 작은따옴표 안에 입력합니다.
N	[SHEET-SourceRange]	문자	Y	-	Y	복사할 영역을 작은따옴표 안에 입력합니다.
N	[SHEET-DestSheet]	문자	Y	-	Y	붙여넣기할 대상 워크시트명을 작은따옴표 안에 입력합니다.
N	[SHEET-TargetRange]	문자	Y	-	Y	붙여넣기할 영역을 작은따옴표 안에 입력합니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로 생성한 Excel 파일(CreateExcel_Test.xlsx)의 'Sheet1' 워크시트에 'TestData'(A1:B1) 데이터를 입력합니다. 입력한 영역의 데이터를 복사한 후 지정 위치 'D1:E2'에 붙여 넣습니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Other Samples > P_CopyPaste_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] SourceExcel = this.openExcel
[Input] DestExcel = this.openExcel
SourceSheet = 'Sheet1'
SourceRange = 'A1:B1'
DestSheet = 'Sheet1'
TargetRange = 'F3'
Paste Type = All
Paste Operation = None
DestAutoSave = Off
PasteSkipBlanks = Off
PasteTranspose = Off

연관/유사 액티비티

CopyRange, PasteRange

SetStyleRange

개요

Excel 문서에서 지정한 영역의 스타일(글꼴, 정렬, 배경색, 셀 사이즈 등)을 설정합니다.

사용 절차

스타일을 적용할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 스타일을 설정할 Excel 문서의 변수를 입력하세요.
SheetName에 스타일을 적용할 워크시트명 또는 변수를 입력하세요.
Range에 스타일을 적용할 영역을 입력하세요.
CELL 그룹 속성에 글꼴, 가로/세로 맞춤, 글꼴 크기, 글꼴 색상, 배경색 등의 스타일을 설정하세세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	스타일을 적용할 대상 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	[CELL] FontName	콤보박스	N	-	N	글꼴을 선택합니다.
N	[CELL] AlignHorizontal	콤보박스	N	-	N	콘텐츠 가로 정렬 방식을 선택합니다. ※ 정렬 방식 종류 - Right, Left, Justify, Distributed, Center, General, Fill, CenterAcrossSelection
N	[CELL] AlignVertical	콤보박스	N	-	N	콘텐츠 세로 정렬 방식을 선택합니다. ※ 정렬 방식 종류 - Top, Justify, Distributed, Center, Bottom
N	[CELL] FontSize	숫자	N	-	Y	글꼴 크기를 입력합니다. (기본값: 0) 기본값 '0'은 글꼴 크기를 변경하지 않는다는 의미입니다.
N	[CELL] FontColor	문자	N	-	Y	글꼴 색상을 입력합니다. 색상은 RGB 숫자를 작은따옴표 안에 콤마(,)로 구분하여 입력합니다. 예를 들어, 파란색의 경우 '0,0,255' 를 입력합니다.
N	[CELL] FontBackgroundColor	문자	N	-	Y	셀 배경 색상을 입력합니다. 색상은 RGB 숫자를 작은따옴표 안에 콤마(,)로 구분하여 입력합니다. 예를 들어, 파란색의 경우 '0,0,255' 를 입력합니다.
N	[CELL] Width	숫자	N	-	Y	셀의 너비를 입력합니다.(기본값: 0) '0'은 너비를 변경하지 않는다는 의미입니다.
N	[CELL] Height	숫자	N	-	Y	셀의 높이를 입력합니다. (기본값: 0) 기본값 '0'은 높이를 변경하지 않는다는 의미입니다.
N	[CELL] FontBold	기타	N	-	Y	텍스트 굵게 표시(볼드체) 여부를 선택합니다. 'Current'는 현재 Excel 문서에 설정된 내용을 변경하지 않는다는 의미입니다.
N	[CELL] FontItalic	기타	N	-	Y	텍스트 기울임꼴(이탤릭체)로 표시 여부를 선택합니다. 'Current'는 현재 Excel 문서에 설정된 내용을 변경하지 않는다는 의미입니다.
N	[CELL] FontUnderline	기타	N	-	Y	텍스트 밑줄 표시 여부를 선택합니다. 'Current'는 현재 Excel 문서에 설정된 내용을 변경하지 않는다는 의미입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성한 후 'Sheet1' 워크시트의 'A1:B2'에 'Test'를 입력하고 스타일을 적용합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Style > P_SetStyleRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Range = 'A1:B2'
FontName = 'Arial'
AlignHorizontal = 'General'
AlignVertical = 'Center'
FontSize = '15'
FontColor = '255,0,0'
BackgroundColor = '255,255,0'
Width = '0'
Height = '0'
FontBold = 'True'
FontItalic = 'True'
FontUnderline = 'True'

연관/유사 액티비티

SetBorderRange

개요

Excel 문서에서 지정한 영역에 테두리를 설정합니다.

사용 절차

테두리를 적용할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 테두리를 설정할 Excel 문서의 변수를 입력하세요.
SheetName에 테두리를 지정할 워크시트명 또는 변수를 입력하세요.
Range에 테두리를 적용할 영역을 입력하세요.
Border에서 적용할 테두리 종류를 선택하세요.
Overlay에서 기존 테두리와 겹치게 할지 선택하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	테두리를 적용할 대상 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	[CELL] Border	콤보박스	N	-	N	적용할 테두리를 선택합니다. ※ 테두리 종류 - Bottom Border, Top Border, Left Border, Right Border, No Border, All Borders, Outside Borders, Thick Box Border, Bottom Double Border, Thick Bottom Border, Top and Bottom Border, Top and Thick Bottom Border, Top and Double Bottom Border
N	[CELL] Overlay	토글버튼	Y	-	Y	현재 문서에서 설정된 테두리에 선택한 테두리를 추가할지(On), 현재 문서에 설정된 테두리를 삭제하고 선택한 테두리를 추가할지(Off) 선택합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성한 후 'Sheet1' 워크시트의 'A1:B2'에 'Test'를 입력하고 테두리를 그립니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Style > P_SetBorderRange_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Range = 'A1:B2'
Border = All Borders
Overlay = On

연관/유사 액티비티

SetStyleRange

SetFilter

개요

Excel 문서에 필터를 설정합니다. 아래 그림과 같이 필터 지정이 필요할 때 사용할 수 있습니다.

사용 절차

필터를 설정할 Excel 문서가 열려 있어야 합니다.

[Output] Range에 실행 결과를 저장할 변수를 입력하세요.
[Input] Excel에 필터를 설정할 대상 Excel 문서의 변수를 입력하세요.
SheetName에 필터를 설정할 워크시트의 이름 또는 변수를 입력하세요.
FilterQuery에 필터링할 쿼리를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Range	변수	N	-	Y	결과 값을 저장할 변수를 입력합니다. 결과 값은 필터링 결과로 만들어진 영역의 리스트가 반환됩니다. (기본값: RESULT)
N	[Input] Excel	변수	Y	-	Y	필터를 설정할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	FilterQuery	문자	N	-	N	필터에 적용할 첫 번째 쿼리 값을 작은따옴표 안에 입력합니다.
N	FilterQuery2	문자	N	-	N	필터에 적용할 두 번째 쿼리 값을 작은따옴표 안에 입력합니다.
N	IncludeHeader	토글버튼	Y	-	Y	데이터를 가져올 때 필터가 있는 Header까지 포함할지 설정합니다.
N	FilterOperAND	토글버튼	N	-	Y	필터 쿼리 조건을 선택합니다. 두 가지 쿼리를 모두 만족하는 조건(On) 또는 둘 중 하나라도 만족하는 조건(Off)으로 설정할 수 있습니다.
N	GetTotalRange	토글버튼	N	-	Y	필터가 있는 전체 영역의 데이터를 가져올 것인지 선택합니다.
N	[SHEET-FilterCell]	문자	Y	-	-	필터가 있는 셀의 위치를 입력합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 문자열을 입력한 후 'B1' 셀에 '24344' 필터를 적용하고 메시지 박스를 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Filter > P_SetFilter_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
setFilter = 필터를 적용한 결괏값을 저장할 변수

사용된 속성

[Output] Range = this.setFilter
[Input] Excel = this.Excel
FilterQuery = '24344'
SheetName = 'Sheet1'
FilterCell = 'B1'

특이 사항

필터 쿼리 값 알아보기

'=test' → test 문자열만 필터링

'<>test' → test 문자열만 제외하고 필터링

'=test*' → test로 시작하는 문자열을 필터링

'=*test' → test로 끝나는 문자열을 필터링

'=*test*' → test가 포함된 모든 문자열을 필터링

'<>*test*' → test가 포함되지 않은 모든 문자열을 필터링

'=test??' → test로 시작하여 끝에 두 문자가 더 있는 문자열을 필터링

'=??test' → 앞에 두 문자가 더 있고 test로 끝나는 문자열을 필터링

'=??test??' → test 양쪽으로 두 문자 이상 있는 모든 문자열을 필터링

'<>??test??' → test 양쪽으로 두 문자 이상 포함되지 않은 모든 문자열을 필터링

'>10' → 10보다 큰 숫자만 필터링

'>=10' → 10보다 크거나 같은 숫자만 필터링

'<10' → 10보다 작은 숫자만 필터링

연관/유사 액티비티

ReleaseFilter

SetColorFilter

개요

Excel 문서에서 글꼴이나 셀의 색상으로 필터를 설정합니다.

사용 절차

필터를 설정할 Excel 문서가 열려 있어야 합니다.

[Output] Range에 실행 결과를 저장할 변수를 입력하세요.
[Input] Excel에 필터를 설정할 대상 Excel 문서의 변수를 입력하세요.
속성에 필터링할 색상, 필터링 대상(셀 또는 글꼴), 헤더 포함 여부 등을 설정하세요.
SheetName에 필터를 설정할 워크시트의 이름 또는 변수를 입력하세요.
FilterCell에 필터를 설정할 셀의 위치를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Excel	변수	N	-	Y	결과로 받을 저장할 변수를 입력합니다.(기본값: RESULT) 값은 필터링 결과로 만들어진 영역의 리스트가 반환됩니다.
N	[Input] Excel	변수	Y	-	Y	필터를 설정할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_SHEET) ACTIVE_SHEET는 현재 열려 있는 시트를 의미합니다.
N	FontColor	토글버튼	Y	-	Y	필터 기준을 글꼴 색상으로 할지(On), 셀 색상으로 할지(Off) 선택합니다.
N	IncludeHeader	토글버튼	Y	-	Y	데이터를 가져올 때 필터가 있는 헤더까지 포함할지 설정합니다.
N	GetTotalRange	토글버튼	N	-	Y	필터가 있는 전체 영역의 데이터를 가져올지 설정합니다.
N	UseFontAuto	토글버튼	N	-	Y	기본(default) 색상을 사용할지(On)하고, RGB값을 사용할지(Off) 선택합니다. Off로 설정하면 FilterColor 속성이 표시되며, RGB값('255,255,255'')을 입력할 수 있습니다.
N	[SHEET-FilterCell]	문자	Y	-	-	필터가 있는 셀의 위치를 입력합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 문자열과 스타일을 지정한 후 'A1'에서 노란색을 기준으로 필터를 적용합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Filter > P_SetColorFilter_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
setColorFilter = 필터를 적용한 결괏값을 저장할 변수

사용된 속성

[Output] Range = this.setFilter
[Input] Excel = this.openExcel
FilterColor = '255,255,0'
FontColor = Off
IncludeHeader = On
GetTotalRange = On
SheetName = 'Sheet1'
FilterCell = 'A1'

연관/유사 액티비티

SetFilter, ReleaseFilter

ReleaseFilter

개요

Excel 문서에 설정된 필터를 해제합니다.

사용 절차

필터가 설정된 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 필터를 해제할 Excel 문서의 변수를 입력하세요.
SheetName에 필터를 해제할 워크시트명 또는 변수를 입력하세요.
FilterCell에 해제할 필터가 있는 셀의 위치를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	해제할 필터가 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	[SHEET-FilterCell]	문자	N	-	N	필터가 있는 셀의 위치를 작은따옴표 안에 입력합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 문자열과 스타일 및 필터를 지정한 후 'B1'에 적용된 필터를 해제합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Filter > P_ReleaseFilter_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = openExcel
SheetName = 'Sheet1'
FilterCell = 'B1'

연관/유사 액티비티

SetFilter

SearchString

개요

대상 Excel 문서에서 문자열을 검색하고, 문자열을 찾은 경우 문자열이 있는 위치를 읽어옵니다.

사용 절차

문자열을 검색할 Excel 문서가 열려 있어야 합니다.

[Output] RangeArray에 실행 결과를 저장할 변수를 입력하세요.
[Input] Excel에 문자열을 검색할 Excel 문서의 변수를 입력하세요.
SearchString에 검색할 문자열을 입력하세요.
SheetName에 문자열을 읽어올 워크시트명 또는 변수를 입력하세요.
Range에 검색할 범위를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
RangeArray	1차원배열	string	검색된 문자열의 위치가 반환됩니다.	0: 'A1' 1: 'B1' 2: 'C1'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	검색할 문자열이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	SearchString	문자	Y	-	Y	검색할 문자열을 작은따옴표 안에 입력합니다.
N	ParMatch	토글버튼	N	-	Y	부분 검색 허용 여부를 선택합니다.
N	CaseMatch	토글버튼	N	-	Y	대소문자 구분 여부를 선택합니다.
N	Value of Formula	토글버튼	N	-	Y	값을 검색할지(On), 수식을 검색할지(Off) 선택합니다.
N	[SHEET-Range]	문자	Y	-	Y	문자열을 검색할 범위를 설정합니다. (기본값: 1:1048576) 1:1048576은 1번째 줄부터 1048576번째 줄까지 검색한다는 의미입니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 문자열 입력하고, 입력한 문자열 'Test'을 검색하여 해당 위치를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Other Samples > P_SearchString_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
searchStr = 찾은 문자열의 위치를 저장할 변수

사용된 속성

[Output] RangeArray = this.searchStr
[Input] Excel = this.openExcel
SearchString = 'Test'
SheetName = 'Sheet1'
Range = '1:1048576'

연관/유사 액티비티

ReplaceString

개요

Excel 문서에서 특정 문자열을 검색하여 다른 문자열로 변경합니다.

사용 절차

문자열을 검색할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 문자열을 검색하고 변경할 Excel 문서의 변수를 입력하세요.
InputString에 검색할 문자열을 입력하세요.
ReplaceString에 변경할 문자열을 입력하세요.
Range에 검색하여 변경할 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	검색할 문자열이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	InputString	문자	N	-	N	검색할 문자열을 작은따옴표 안에 입력합니다.
N	ReplaceString	문자	Y	-	N	변경할 문자열을 작은따옴표 안에 입력합니다.
N	PartMatch	토글버튼	N	-	Y	부분 검색 허용 여부를 선택합니다. (기본값: 사용 - 청색)
N	CaseMatch	토글버튼	N	-	Y	대소문자 구분 여부를 설정합니다. (기본값: 미사용 - 회색)
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 문자열 입력하고, 입력한 문자열 'Test'을 'Running'으로 변경합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Other Samples > P_ReplaceString_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
InputString = 'Test'
ReplaceString = 'Running'
SheetName = 'Sheet1'
Range = 'B1:B2'

연관/유사 액티비티

SearchString, ReadString, WriteString

ReadString

개요

Excel 문서에서 지정한 영역의 문자열을 읽어옵니다.

사용 절차

문자열을 읽어올 Excel 문서가 열려 있어야 합니다.

[Output] ReadData에 읽어온 값을 저장할 변수를 입력하세요.
[Input] Excel에 문자열을 읽어올 Excel 문서의 변수를 입력하세요.
SheetName에 문자열을 읽어올 워크시트명 또는 변수를 입력하세요.
Cell에 읽어올 셀을 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
ReadData	string	-	선택된 Cell의 문자열이 반환됩니다.	'HongGildong'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	읽어올 문자열이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 문자열을 입력한 후 'A1' 셀에 있는 문자열을 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Manipulate Range > P_ReadString_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Output] ReadData = RESULT
[Input] Excel = ACTIVE_EXCEL
SheetName = ACTIVE_SHEET
Cell = 'A1'

연관/유사 액티비티

WriteString

개요

Excel 문서에서 지정한 영역에 문자열을 입력합니다.

사용 절차

문자열을 입력할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 문자열을 입력할 Excel 문서의 변수를 입력하세요.
InputString에 입력할 문자열을 입력하세요.
SheetName에 문자열을 입력할 워크시트명 또는 변수를 입력하세요..
Range에 문자열을 입력할 영역을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	입력할 문자열이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	InputString	변수	Y	-	N	입력할 문자열을 입력합니다.
N	AutoSave	토글버튼	N	-	Y	문자열을 입력한 후 문서를 자동으로 저장할지 설정합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀(영역)에 문자열을 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Other Samples > P_WriteString_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
var1 = 입력할 텍스트가 저장된 변수(초깃값: '홍길동')

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
InputString = 'Test' (첫 번째 WriteString)
Range = 'A1:B1' (첫 번째 WriteString)
InputString = this.var1 (두 번째 WriteString)
Range = 'C4:D6' (두 번째 WriteString)
InputString = '=today()' (세 번째 WriteString)
Range = 'E8:F10' (세 번째 WriteString)

연관/유사 액티비티

ReadString

GetMacroList

개요

대상 Excel 문서에서 매크로를 목록을 가져옵니다.

사용 절차

Excel 문서 매크로가 만들어져 있어야 사용할 수 있습니다.

매크로 사용을 위해서는 엑셀의 보안 센터 설정에서 매크로 설정이 필요할 수 있습니다.

[Output] MacroList에 매크로 목록을 가져올 변수를 입력하세요.
[Input] Excel에 매크로를 실행할 Excel 문서의 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output]MacroList	변수	Y	-	Y	매크로 목록을 가져올 변수를 입력합니다.
N	[Input] Excel	변수	Y	-	Y	매크로가 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

매크로가 포함된 Excel 파일을 열고, 매크로 목록을 가져와 첫번째 매크로를 실행합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > GetMacroList_Sample > ExecuteMacro_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Intput] Excel = this.openExcel
[Output]MacroList = this.macroList

연관/유사 액티비티

ExcuteMacro

ExecuteMacro

개요

대상 Excel 문서에서 특정 매크로를 실행합니다.

사용 절차

Excel 문서 매크로가 만들어져 있어야 사용할 수 있습니다.

[Input] Excel에 매크로를 실행할 Excel 문서의 변수를 입력하세요.
MacroName에 실행할 매크로명을 입력하세요.
SheetName 매크로를 실행할 워크시트명 또는 변수를 입력하세요.
Parameters 에 매크로에서 필요한 파라미터를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	매크로가 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	MacroName	문자열	Y	-	N	실행할 매크로명을 '매크로명' 과 같은 형식으로 입력합니다. 다른 파일에 정의된 매크로를 사용하려면, '\'다른엑셀파일명\'!매크로명' 의 형식으로 입력합니다. 다른 파일에 정의된 매크로 실행 기능은, v2.1.1 핫픽스 버전 이후부터 지원됩니다.
N	Parameters	문자열	N	-	N	실행할 매크로에서 필요한 파라미터를 입력합니다. 입력할 파라미터가 없으면 입력하지 않아도 됩니다. '' 안에 각 파라미터를 ,로 구분하여 입력합니다. '' 안에 문자와 숫자를 별도 구분 없이 입력하면 처리가 됩니다. 파라미터 내부에 , 가 포함되어야 하는 경우 \"를 사용하여 파라미터를 구분하여 처리할 수 있습니다. 예> \"123,456\",abc
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

매크로가 포함된 Excel 파일을 열고, 'Sheet1' 워크시트에서 매크로(first) 실행합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Other Samples > P_ExecuteMacro_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Intput] Excel = this.openExcel
MacroName = 'first'
SheetName= 'Sheet1'

연관/유사 액티비티

GetMacroList

SendShortCut

개요

Excel 문서에서 단축키 기능을 실행합니다.

사용 절차

단축키 기능을 실행할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 단축키 기능을 실행할 Excel 문서의 변수를 선택하세요.
Keys에 입력될 키를 문자열로 입력하세요.
ALT, CTRL, SHIFT 키 사용 여부를 설정하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	단축키 입력 대상 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Keys	기타	Y	-	N	단축키 문자열을 작은따옴표 안에 입력합니다.
N	BeforeDelay	기타	N	밀리초	Y	단축키를 실행하기 전의 지연 시간을 입력합니다. (기본값: 1000)
N	AfterDelay	기타	N	밀리초	Y	단축키를 실행한 후의 지연 시간을 입력합니다. (기본값: 500)
N	ShortCutName	기타	Y	-	N	단축키 이름을 작은따옴표 안에 입력합니다.
N	ALT	토글버튼	Y	-	Y	ALT 키를 사용하도록 설정합니다.
N	CTRL	토글버튼	Y	-	Y	CTRL 키를 사용하도록 설정합니다.
N	SHIFT	토글버튼	Y	-	Y	SHIFT 키를 사용하도록 설정합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

Keys 속성에 입력 가능한 특수키는 아래 표를 참고하세요.

Key	Code
BACKSPACE	{BACKSPACE} or {BS}
BREAK	{BREAK}
CAPS LOCK	{CAPSLOCK}
CLEAR	{CLEAR}
DELETE or DEL	{DELETE} or {DEL}
DOWN ARROW	{DOWN}
END	{END}
ENTER (numeric keypad)	{ENTER}
ESC	{ESCAPE} or {ESC}
HELP	{HELP}
HOME	{HOME}
INS	{INSERT}
LEFT ARROW	{LEFT}
NUM LOCK	{NUMLOCK}
PAGE DOWN	{PGDN}
PAGE UP	{PGUP}
RETURN	{RETURN}
RIGHT ARROW	{RIGHT}
SCROLL LOCK	{SCROLLLOCK}

AddRow

개요

대상 Excel 문서에서 행을 추가합니다.

사용 절차

행을 추가하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 행을 추가할 Excel 문서의 변수를 입력하세요.
SheetName에 행을 추가할 워크시트명 또는 변수를 입력하세요.
Position에 추가할 위치의 행 번호를 입력하세요. 행 번호는 '1', '1:2', '1, 2' 등과 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	행을 추가할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 'A1:B1'과 'A2:B2' 셀에 데이터를 입력한 후 'Sheet1' 워크시트에 2번째 행을 추가합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Row > P_AddRow_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Position = '2'

연관/유사 액티비티

AddCol, DeleteRow

AddCol

개요

대상 Excel 문서에서 열을 추가합니다.

사용 절차

열을 추가하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 열을 추가할 Excel 문서의 변수를 입력하세요.
SheetName에 열을 추가할 워크시트명 또는 변수를 입력하세요.
Position에 추가할 위치의 열 문자를 입력하세요. 열 문자는 'A', 'A:B', 'A, B' 등과 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	열을 추가할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 'A1:B1'과 'C4:D6', 'E8:F10' 셀에 데이터를 입력한 후 'Sheet1' 워크시트에 C열을 추가합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Column > P_AddCol_Test

사용된 변수

this.openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Position = 'C'

연관/유사 액티비티

AddRow, DeleteCol

SelectRow

개요

Excel 문서에서 특정한 행을 선택합니다.

사용 절차

행을 선택하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 행을 선택할 Excel 문서의 변수를 입력하세요.
SheetName에 행을 선택할 워크시트명 또는 변수를 입력하세요.
Position에 선택할 행 번호를 입력하세요. 행 번호는 '1', '1:2', '1, 2' 등과 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	행을 선택할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 지정한 셀에 데이터를 입력한 후 'Sheet1' 워크시트의 3번째 행을 선택합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Row > P_SelectRow_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Position = '3'

특이 사항

[SHEET-Position] 속성에 선택할 행의 번호를 작은따옴표 안에 입력합니다.

행 번호 사이에 콜론(:)을 입력할 경우, 첫 번째 숫자부터 두 번째 숫자까지의 행이 모두 선택됩니다.

행 번호 사이에 콤마(,)를 입력할 경우, 해당되는 숫자의 행이 모두 선택됩니다.

연관/유사 액티비티

SelectCol

개요

Excel 문서에서 특정한 열을 선택합니다.

사용 절차

열을 선택하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 열을 선택할 Excel 문서의 변수를 입력하세요.
SheetName에 열을 선택할 워크시트명 또는 변수를 입력하세요.
Position에 선택할 열 문자를 입력하세요. 열 문자는 'A', 'A:B', 'A, B' 등과 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	열을 선택할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 데이터를 입력한 후 'Sheet1' 워크시트의 B열부터 E열까지 선택합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Column > P_SelectCol_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Position = 'B:E'

특이 사항

[SHEET-Position] 속성에 선택할 열의 문자를 작은따옴표 안에 입력합니다.

열 문자 사이에 콜론(:)을 입력할 경우, 첫 번째 문자부터 두 번째 문자까지의 열이 모두 선택됩니다.

열 문자 사이에 콤마(,)를 입력할 경우, 해당되는 문자의 열이 모두 선택됩니다.

연관/유사 액티비티

SelectRow

DeleteRow

개요

Excel 문서에서 특정한 행을 삭제합니다.

사용 절차

행을 삭제하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 행을 삭제할 Excel 문서의 변수를 입력하세요.
SheetName에 행을 삭제할 워크시트명 또는 변수를 입력하세요.
Position에 삭제할 행 번호를 입력하세요. 행 번호는 '1', '1:2', '1, 2' 등과 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	행을 삭제할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 데이터를 입력한 후 'Sheet1' 워크시트의 2번째 행을 삭제합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Row > P_DeleteRow_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Position = '2'

특이 사항

[SHEET-Position] 속성에 삭제할 행의 번호를 작은따옴표 안에 입력합니다.

행 번호 사이에 콜론(:)을 입력할 경우, 첫 번째 숫자부터 두 번째 숫자까지의 행이 모두 삭제됩니다.

행 번호 사이에 콤마(,)를 입력할 경우, 해당되는 숫자의 행이 모두 삭제됩니다.

연관/유사 액티비티

DeleteCol, AddRow

DeleteCol

개요

Excel 문서에서 특정한 열을 삭제합니다.

사용 절차

열을 삭제하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 열을 삭제할 Excel 문서의 변수를 입력하세요.
SheetName에 열을 삭제할 워크시트명 또는 변수를 입력하세요.
Position에 삭제할 위치의 열 문자를 입력하세요. 열 문자는 'A', 'A:B', 'A, B' 등과 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	열을 삭제할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 데이터를 입력한 후 'Sheet1' 워크시트의 B열을 삭제합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Column > P_DeleteCol_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = ACTIVE_EXCEL
SheetName = 'Sheet1'
Position = 'B'

특이 사항

[SHEET-Position] 속성에 삭제할 열의 문자를 작은따옴표 안에 입력합니다.

열 문자 사이에 콜론(:)을 입력할 경우, 첫 번째 문자부터 두 번째 문자까지의 열이 모두 삭제됩니다.

열 문자 사이에 콤마(,)를 입력할 경우, 해당되는 문자의 열이 모두 삭제됩니다.

연관/유사 액티비티

DeleteRow, AddCol

GetRowCount

개요

Excel 문서에서 행의 개수를 가져옵니다.

사용 절차

행의 개수를 가져오려는 Excel 문서가 열려 있어야 합니다.

[Output] RowCount에 가져온 결과를 저장할 변수를 입력하세요.
[Input] Excel에 행 개수를 가져올 Excel 문서의 변수를 입력하세요.
SheetName에 행 개수를 가져올 워크시트명 또는 변수를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
RowCount	int	-	선택된 Excel 문서에서 데이터가 있는 범위의 행 개수가 반환됩니다.	10

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	행의 개수를 가져오려는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 문자열을 입력한 후 문자열이 입력된 행의 개수를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Row > P_GetRowCount_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
getRowCnt = 가져온 행의 개수를 저장할 변수

사용된 속성

[Output] RowCount = this.getRowCnt
[Input] Excel = this.openExcel
SheetName = 'Sheet1'

연관/유사 액티비티

GetColCount

개요

Excel 문서에서 열의 개수를 가져옵니다.

사용 절차

열의 개수를 가져오려는 Excel 문서가 열려 있어야 합니다.

[Output] ColCount에 가져온 결과를 저장할 변수를 입력하세요.
[Input] Excel에 열 개수를 가져올 Excel 문서의 변수를 입력하세요.
SheetName에 열 개수를 가져올 워크시트명 또는 변수를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
ColCount	int	-	선택된 Excel 문서에서 데이터가 있는 범위의 열 개수가 반환됩니다.	6

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	열의 개수를 가져오려는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 문자열을 입력한 후 문자열이 입력된 열의 개수를 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Edit Column > P_GetColCount_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
getColCnt = 가져온 열의 개수를 저장할 변수

사용된 속성

[Output] ColCount = this.getColCnt
[Input] Excel = this.openExcel
SheetName = 'Sheet1'

연관/유사 액티비티

GetRowCount

SetHiddenRow

개요

Excel 문서에서 지정한 행을 숨기거나 숨기기를 취소합니다.

사용 절차

행을 숨기거나 숨기기를 취소하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 행을 숨기거나 숨기기를 취소할 Excel 문서의 변수를 입력하세요.
Rows에 대상 행 번호를 입력하세요. 행 번호는 '1', '1:2', '1, 2' 등과 같은 형태로 표현하여 입력해주어야 합니다.
Hidden에서 행을 숨길지, 숨기기를 취소할지 설정하세요.
SheetName에 행을 숨기거나 숨기기를 취소할 워크시트명 또는 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	행을 숨기거나 숨기기를 취소할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Rows	문자	Y	-	N	행을 숨기거나 숨기기를 취소할 행의 범위를 작은따옴표 안에 입력합니다. 한 행만 선택할 경우에는 '1'과 같이 입력할 수 있습니다.
N	Hidden	토글버튼	Y	-	Y	행을 숨길지(On), 숨기기를 취소할지(Off) 설정하세요.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성한 후 'Sheet1' 워크시트의 'A1:B5'에 'Test'를 입력하고 1:3행을 숨깁니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Style > P_SetHiddenRow_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
Rows = '1:3'
Hidden = On
SheetName = 'Sheet1'

연관/유사 액티비티

SetHiddenCol

개요

Excel 문서에서 지정한 열을 숨기거나 숨기기를 취소합니다.

사용 절차

열을 숨기거나 숨기기를 취소하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 열을 숨기거나 숨기기를 취소할 Excel 문서의 변수를 입력하세요.
Columns에 대상 열 문자를 입력하세요. 열 문자는 'A', 'A:B', 'A, B' 등과 같은 형태로 표현하여 입력해주어야 합니다.
Hidden에서 열을 숨길지, 숨기기를 취소할지 설정하세요.
SheetName에 열을 숨기거나 숨기기를 취소할 워크시트명 또는 변수를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	열을 숨기거나 숨기기를 취소할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Culumns	문자	Y	-	N	열을 숨기거나 숨기기를 취소할 열의 범위를 작은따옴표 안에 입력합니다. 한 열만 선택할 경우에는 'A'과 같이 입력할 수 있습니다.
N	Hidden	토글버튼	Y	-	Y	열을 숨길지(On), 숨기기를 취소할지(Off) 설정하세요.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성한 후 'Sheet1' 워크시트의 'A1:B5'에 'Test'를 입력하고 A열을 숨깁니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Apply Style > P_SetHiddenCol_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
Columns = 'A:A'
Hidden = On
SheetName = 'Sheet1'

연관/유사 액티비티

SetHiddenRow

SortData

개요

Excel 문서에서 지정한 행이나 열을 오름차순/내림차순으로 정렬합니다.

사용 절차

행이나 열을 정렬하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 정렬을 실행할 Excel 문서의 변수를 입력하세요.
SortOrder에서 정렬 방식을 오름차순 또는 내림차순으로 선택하세요.
SheetName에 행 또는 열을 정렬할 워크시트명 또는 변수를 입력하세요.
Key에 기준이 되는 대상 영역을 지정하세요. 'A1:B2'와 같은 형태로 표현하여 입력해주어야 합니다.
Range에 대상 영역을 지정하세요.입력하세요. 'A1:B2'와 같은 형태로 표현하여 입력해주어야 합니다.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	정렬할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려있는 Excel 문서를 의미합니다.
N	SortOrder	토글버튼	N	-	Y	오름차순(On) 또는 내림차순(Off)으로 지정합니다. (기본값: 오름차순)
N	SortOrientation	토글버튼	N	-	N	정렬 기준을 열(On) 또는 행(Off)으로 지정합니다. (기본값: 열)
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성한 후 'Sheet1' 워크시트의 'A1:A5'에 과일명 5개를 입력하고 오름차순으로 정렬합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Other Samples > P_SortData_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수

사용된 속성

[Input] Excel = this.openExcel
SortOrder = On
SortOrientation = On
SheetName = 'Sheet1'
Key = 'A1:A5'
Range = 'A1:A5'

연관/유사 액티비티

SetFilter

VLookUp

개요

Excel 문서에서 VLookUp 기능을 수행합니다. (Excel 문서 내에서 배열(표) 첫 열의 값을 검색하여, 그 열의 데이터를 표시해 줍니다.)

사용 절차

VLookUp 기능을 수행하려는 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 VLookUp 기능을 수행할 Excel 문서의 변수를 입력하세요.
LookupValue에 검색할 키 값을 입력하세요.
TableRange에 검색할 배열(표) 영역을 입력하세요. 영역은 'A1:B2'와 같은 형태로 표현하여 입력해주어야 합니다.
TableIndex에 가져올 값이 있는 열의 위치를 입력하세요.
SheetName에 기능을 수행할 대상 워크시트명 또는 변수를 입력하세요.
Cell에 가져온 값을 표시할 셀을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	VLookUp 수행할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	LookupValue	문자	Y	-	N	원하는 값을 찾기 위한 키 값을 작은따옴표 안에 입력합니다.
N	TableRange	문자	Y	-	Y	값을 찾을 영역을 작은따옴표 안에 입력합니다.
N	TableIndex	문자	Y	-	Y	찾을 영역에서 가져올 값이 있는 열의 위치를 입력합니다. (기본값: 0)
N	PartMatch	토글버튼	Y	-	Y	정확하게 일치하는 값을 찾을 것인지(On), 유사한 값을 찾을지(Off) 지정합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

연관/유사 액티비티

WriteCellFormula, ReadCellFormula

ReadCellFormula

개요

대상 Excel 문서에서 특정 셀에 입력된 수식을 가져옵니다.

사용 절차

가져올 수식이 입력된 Excel 문서가 열려 있어야 합니다.

[Output] Formula에 가져온 결과를 저장할 변수를 입력하세요.
[Input] Excel에 수식을 가져올 Excel 문서의 변수를 입력하세요.
SheetName에 수식을 가져올 워크시트명 또는 변수를 입력하세요.
Cell에 수식을 가져올 셀 위치를 입력하세요.

카드 출력 속성

카드 속성
속성	리턴타입	리턴 추가설명	설명	결과 예시
Formula	string	-	선택된 "Cell"의 수식을 반환합니다.	'=A1+C4'

카드 입력 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	가져올 수식이 있는 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 문자열을 입력한 후 'Sheet1' 워크시트의 'E8'에 적용된 수식을 메시지 박스로 출력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Cell Formula > P_ReadCellFormula_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
readcellFor = 가져온 결과를 저장할 변수

사용된 속성

[Output] Formula = this.readcellFor
[Input] Excel = this.openExcel
SheetName = 'Sheet1'
Cell = 'E8'

연관/유사 액티비티

WriteCellFormula

개요

Excel 문서에서 특정 셀에 수식을 입력합니다.

사용 절차

수식을 입력할 Excel 문서가 열려 있어야 합니다.

[Input] Excel에 수식을 입력할 Excel 문서의 변수를 입력하세요.
Formula에 셀에 입력할 수식 또는 변수를 입력하세요.
SheetName에 수식을 입력할 워크시트명 또는 변수를 입력하세요.
Cell에 수식을 입력할 셀을 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Input] Excel	변수	Y	-	Y	수식을 입력할 Excel 문서가 할당된 변수를 입력합니다. (기본값: ACTIVE_EXCEL) ACTIVE_EXCEL은 현재 열려 있는 Excel 문서를 의미합니다.
N	Formula	문자	Y	-	N	입력할 수식을 작은따옴표 안에 입력합니다.
N	AutoSave	토글버튼	N	-	Y	수식을 입력한 후 문서를 자동으로 저장할지 설정합니다.
Y	SHEET	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	MORE OPTIONS	-	-	-	-	Excel 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Excel 라이브러리의 공통 속성입니다.

활용 예시

새로운 Excel 파일을 생성하고 'Sheet1' 워크시트의 지정한 셀에 문자열을 입력한 후 'Sheet1' 워크시트의 'A'에 적용된 수식을 'A2:B2'에 입력합니다.

Excel_NewExcel_1K

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Excel > Cell Formula > P_WriteCellFormula_Test

사용된 변수

openExcel = 열린 Excel 문서를 할당할 변수
outFormula = 가져온 수식을 저장할 변수

사용된 속성

[Input] Excel = this.openExcel
Formula = this.outFormula
SheetName = 'Sheet1'
Cell = 'A2:B2'

연관/유사 액티비티

ReadCellFormula