개요

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

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

새 Word 문서 생성하기: NewWord, CreateWord
Word 문서 열기, 저장하기, 닫기, 가져오기: OpenWord, SaveWord, CloseWord, GetWord
문자열 삽입, 변경: ReplaceString, InsertString
매크로 실행: ExecuteMacro

공통 속성

MORE OPTIONS

속성	유형	필수여부	단위	자동입력여부	설명
On Error	콤보박스	N	-	N	오류 발생 시 수행할 동작을 지정합니다. - 미지정: 오류를 출력하고, 작업을 종료합니다. - Ignore: 해당 오류를 무시합니다. - Retry: 해당 액티비티를 1회 재시도합니다. - Goto : 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다. - Event: 프로젝트에 등록된 이벤트를 호출합니다.

속성

유형

필수여부

단위

자동입력여부

설명

On Error

콤보박스

오류 발생 시 수행할 동작을 지정합니다.

- 미지정: 오류를 출력하고, 작업을 종료합니다.

- Ignore: 해당 오류를 무시합니다.

- Retry: 해당 액티비티를 1회 재시도합니다.

- Goto : 해당 엑티비티가 실패한 경우 지정한 엑티비티로 이동하여 시나리오를 수행합니다.

- Event: 프로젝트에 등록된 이벤트를 호출합니다.

DESCRIPTION

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

속성

유형

필수여부

단위

자동입력여부

설명

Description

문자열

해당 액티비티 카드에 대한 설명을 추가합니다.

Description이 입력되면 플로차트의 해당 액티비티 설명에 표시되고, Description이 없는 경우에는 대푯값이 해당 액티비티 설명에 표시됩니다.

NewWord

개요

새로운 Word 문서를 실행합니다.

사용 절차

[Output] Word에 열린 Word 문서를 할당할 변수를 입력하세요.
할당한 변수값은 Word 문서를 편집하는 액티비티 카드에서 사용합니다.

카드 속성

공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Word	변수	Y	-	N	실행된 Word 문서 객체를 식별하기 위한 변수를 입력합니다.
N	Invisible	토글버튼	Y	-	N	문서를 비활성화할지 지정합니다.
N	Maximize	토글버튼	Y	-	N	문서의 창을 최대화할지 지정합니다.(기본값: On)
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

빈 Word 문서를 엽니다.

NewWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 열린 Word 문서를 할당할 변수

사용된 속성

[Output] Word = this.word
Invisible = Off
Maximize = On

연관/유사 액티비티

CreateWord, OpenWord, SaveWord, CloseWord

OpenWord

개요

지정된 경로의 Word 문서를 실행합니다.

사용 절차

Word 문서가 지정된 경로에 있는지 확인합니다.

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

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Word	변수	Y	-	Y	실행된 Word 문서 객체를 식별하기 위한 변수를 입력합니다.
N	Path	문자열	Y	-	N	실행할 문서의 경로를 입력합니다.(ex. 'C:\\ak\\Test.docx')
N	Invisible	토글버튼	N	-	Y	문서를 비활성화할지 지정합니다.
N	Maximize	토글버튼	N	-	Y	문서의 창을 최대화할지 지정합니다.
N	Execute Shell	토글버튼	N	-	Y	문서를 더블클릭으로 실행한 것과 동일하게 실행할지 지정합니다.
N	ReadOnly	토글버튼	N	-	Y	문서를 읽기 전용으로 실행할지 지정합니다.
N	UsePassword	토글버튼	N	-	Y	패스워드를 사용할지 지정합니다.
Y	MORE OPTIONS	-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Word 라이브러리의 공통 속성입니다.

카드 속성

생성된 Word 문서를 열고 닫습니다.

OpenWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 열린 Word 문서를 지정할 변수
this.fileName = Word 파일명을 지정할 변수

사용된 속성

[Output] Word = this.word
Path = Global.ResourcesDir + this.fileName

특이사항

Invisible, Maximize, Execute Shell, ReadOnly, UsePassword와 같은 다양한 속성들이 있습니다. 자세한 내용은 OpenWord 액티비티 카드의 "카드 속성" 섹션을 참고하십시오.

유관/유사 액티비티

NewWord, CreateWord, SaveWord, CloseWord

CreateWord

개요

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

사용 절차

이 카드를 최초 사용할 때에는 파일 경로가 표시되어 있지 않습니다.

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

카드 속성

공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Path	문자열	Y	-	N	생성할 문서의 경로를 입력합니다.(ex. 'C:\\ak\\Test.docx')
N	OverWrite	토글버튼	N	-	Y	기존 파일을 덮어쓸지 지정합니다.(기본값: Off)
Y	MORE OPTIONS	-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

CreateWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.fileName = Word 파일명을 지정할 변수

사용된 속성

Path = Global.ResourcesDir + this.fileName
OverWrite = On

연관/유사 액티비티

NewWord, OpenWord, SaveWord, CloseWord

CloseWord

개요

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

사용 절차

닫을 Word 문서가 열려 있는지 확인합니다.

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

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Word	변수	Y	-	Y	닫고자 하는 Word 문서 객체를 입력합니다.
N	Force	토글버튼	N	-	Y	문서 상태와 상관없이 문서를 강제로 닫을 것인지 지정합니다.
Y	MORE OPTIONS	-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

Word 문서를 생성 및 열기를 실행합니다. 그 후 다른 이름으로 저장하고 Word를 종료합니다.

CloseWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 열린 Word 문서를 지정할 변수

사용된 속성

[Input] Word = this.word
Force = On

연관/유사 액티비티

NewWord, CreateWord, OpenWord, SaveWord

GetWord

개요

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

사용 절차

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

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	[Output] Word	변수	Y	-	Y	가져온 Word 문서 객체를 식별할 변수를 입력합니다.
N	FileName	문자열	Y	-	N	가져올 Word 문서의 파일명을 입력합니다.
N	Maximize	토글버튼	N		Y	Word 문서의 창을 최대화할지 지정합니다. (기본값: On)
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

GetWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.wordDocument = 결과로 반환할 Word 문서를 할당할 변수

사용된 속성

[Output] Word = this.wordDocument
File Name = 'TestData_Word.doc'
Maximize = True

연관/유사 액티비티

InsertString

개요

Word 문서에 텍스트를 삽입합니다.

사용 절차

Word에 문자열을 삽입할 Word 문서의 변수를 입력하세요.
InsertString에 삽입할 문자열을 입력하세요.
Target Element, Target Position을 선택하여 문자열이 삽입될 상대적 위치를 정하세요.

카드 속성

공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Word	변수	Y	-	Y	문자열을 삽입할 Word 문서가 할당된 변수를 입력합니다.
N	Target Element	콤보박스	Y	-	N	문자열이 삽입되는 상대적 위치를 선택합니다.
N	InputString	문자열	N	-	N	검색할 문자열을 작은 따옴표 안에 입력합니다. (Target Element가 Text일 경우, 속성이 나타납니다.)
N	InsertString	문자열	N	-	N	삽입할 문자열을 작은 따옴표 안에 입력합니다.
N	PartMatch	토글버튼	N	-	Y	부분 검색 허용 여부를 선택합니다. (기본값: 사용 - 청색)
N	CaseMatch	토글버튼	N	-	Y	대소문자 구분 여부를 설정합니다. (기본값: 미사용 - 회색)
N	Match Option	콤보박스	Target Element가 Text라면 Y, 아니라면 N	-	N	문자열 삽입 옵션을 선택합니다: All - 검색된 문자열 모두의 설정된 위치에 삽입합니다. First - 검색된 문자열의 첫번째 문자열의 설정된 위치에 삽입합니다. Last - 검색된 문자열의 마지막 문자열의 설정된 위치에 삽입합니다. Specific - 검색된 문자열의 Match Index 번째 문자열의 설정된 위치에 삽입합니다. (Target Element가 Text일 경우, 속성이 나타납니다.)
N	Match Index	숫자	N	-	N	검색된 문자열의 특정 인덱스를 설정합니다. (Target Element가 Text이며 Match Option이 Specific일 경우, 속성이 나타납니다.)
N	Target Position	콤보박스	Y	-	N	삽입될 문자열의 상대적 위치를 설정합니다. (Target Element가 Document일 경우, Start/End 옵션이 나타납니다.) (Target Element가 Text일 경우, Before/After 옵션이 나타납니다.)
N	New Line	토글버튼	N	-	Y	문자열이 삽입되기 전 새로운 라인이 추가될지 설정합니다. (기본값: Off)
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

새 Word 문서를 생성하고 'Insert Text'를 입력합니다. 입력된 문자열 'Inserted Text'를 'Replaced Text'로 변경합니다.

GetWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 생성된 Word 문서를 지정할 변수
this.stringToInsert = 삽입할 문자열을 지정할 변수

사용된 속성

[Input] Word = this.word
Target Element = Document
InsertString = this.stringToInsert
Target Position = End
New Line = On

연관/유사 액티비티

ReplaceString

RepalceString

개요

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

사용 절차

Word에 문자열을 검색하고 변경할 Word 문서의 변수를 입력하세요.
InputString에 검색할 문자열을 입력하세요.
ReplaceString에 변경할 문자열을 입력하세요.

카드 속성

공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Word	변수	Y	-	Y	교체할 문자열를 포함하는 Word 문서 객체를 입력합니다.
N	InputString	문자열	N	-	N	검색할 문자열을 작은 따옴표 안에 입력합니다.
N	ReplaceString	문자열	Y	-	N	변경할 문자열을 작은 따옴표 안에 입력합니다.
N	PartMatch	토글버튼	N	-	Y	부분 검색 허용 여부를 선택합니다. (기본값: 사용 - 청색)
N	CaseMatch	토글버튼	N	-	Y	대소문자 구분 여부를 설정합니다. (기본값: 미사용 - 회색)
N	Match Option	콤보박스	Y	-	N	문자열 변경 옵션을 선택합니다: All - 검색된 문자열 모두를 변경합니다. First - 검색된 문자열의 첫번째 문자열을 변경합니다. Last - 검색된 문자열의 마지막 문자열을 변경합니다. Specific - 검색된 문자열의 Match Index 번째 문자열을 변경합니다.
N	Match Index	숫자	Match Option이 Specific일 경우 Y, 아니라면 N	-	N	검색된 문자열의 특정 인덱스를 설정합니다. (Match Option이 Specific일 경우, 속성이 나타납니다.)
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y		-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

새 Word 문서를 생성하고 'Insert Text'를 입력합니다. 입력된 문자열 'Inserted Text'를 'Replaced Text'로 변경합니다.

GetWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 생성된 Word 문서를 지정할 변수
this.inputString = 입력할 위치의 문자열을 지정할 변수
this.replaceString = 바꾸기 대상 문자열을 지정할 변수

사용된 속성

[Input] Word = this.word
InputString = this.inputString
ReplaceString = this.replaceString
PartMatch = On
CaseMatch = Off
Match Option = First

연관/유사 액티비티

InsertString

ExecuteMacro

개요

Word 문서에서 특정 매크로를 실행합니다.

사용 절차

Word에 매크로를 실행할 Word 문서의 변수를 입력하세요.
MacroName에 실행할 매크로명을 입력하세요.
Parameters 에 매크로에서 필요한 파라미터를 입력하세요.

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Word	변수	Y	-	Y	매크로를 실행할 Word 문서 객체를 입력합니다.
N	MacroName	문자열	Y	-	N	실행할 매크로명을 입력합니다.
N	Parameters	문자열	N	-	N	실행할 매크로에서 필요한 파라미터를 입력합니다. 입력할 파라미터가 없으면 입력하지 않아도 됩니다. - '' 안에 각 파라미터를 ,로 구분하여 입력합니다. - '' 안에 문자와 숫자를 별도 구분 없이 입력하면 처리가 됩니다.
Y	MORE OPTIONS	-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

매크로가 있는 Word 문서를 열고, 매크로를 실행합니다.

ExecuteMacro

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 열린 Word 문서를 지정할 변수
this.macroName = 실행할 매크로의 이름을 입력할 변수

사용된 속성

Word = this.word
MacroName = this.macroName

연관/유사 액티비티

SaveWord

개요

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

사용 절차

저장할 Word 문서가 열려 있는지 확인합니다.

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

카드 속성

카드 속성
공통여부	속성	유형	필수여부	단위	자동입력여부	설명
N	Word	변수	Y	-	Y	저장할 Word 객체를 식별하기 위한 변수를 입력합니다.
N	SaveAs	문자열	N	-	N	다른 이름으로 문서를 저장하려면 경로와 파일이름을 입력합니다.(ex. 'C:\\ak\\Test.docx')
Y	MORE OPTIONS	-	-	-	-	Word 라이브러리의 공통 속성입니다.
Y	DESCRIPTION	-	-	-	-	Word 라이브러리의 공통 속성입니다.

활용 예시

Word 문서를 생성 및 열기를 실행합니다. 그 후 다른 이름으로 저장하고 Word를 종료합니다.

SaveWord

예제 파일

메뉴 > 도움말 > 샘플 > Sample > Word > Word

사용된 변수

this.word = 열린 Word 문서를 할당할 변수

사용된 속성

Word = this.openWord
SaveAs =

연관/유사 액티비티

NewWord, CreateWord, OpenWord, CloseWord