AntBot Studio > Activity > 오피스 > 엑셀 > 읽기 > 엑셀 읽기-셀
정의 (Description)
- 엑셀에서 특정 셀의 값을 읽는 Activity 입니다.
해당 Activity는 '엑셀 열기' Activity 내부 스코프에서만 동작합니다.
- '엑셀 열기' Activity를 통해 작업할 엑셀이 실행중이어야 한다는 의미
- '엑셀 열기' Activity를 통해 작업할 엑셀이 실행중이어야 한다는 의미
속성 (Properties) (*은 필수값입니다.)
항목 | 설명 | 데이터타입 | 기본값 | 설정가능옵션 |
---|---|---|---|---|
Common | ||||
Activity이름 | 해당 Activity의 이름을 설정합니다. - 기본값은 Activity명이며, 사용자가 직접 변경 가능합니다. |
String | 엑셀 읽기-셀 | |
Input Common | ||||
셀주소 * | 읽어올 데이터의 셀주소를 설정합니다. - 단일 셀 형식으로만 설정 가능하며, 미지정, 범위 셀은 허용되지 않습니다. - 단일 셀(Ex: A1, B53) |
String | A1 | |
시트명 * | 읽어올 데이터가 존재하는 시트명을 설정합니다. | String | Sheet1 | |
Output | ||||
저장할 변수 (String) | 읽어온 셀의 값을 저장할 변수를 설정합니다. | String | Null | |
저장할 변수 (수식, String형태) | 읽어온 셀의 수식을 저장할 변수를 설정합니다. - 셀의 값은 무시되고, 수식을 변수에 문자열 형태로 저장합니다. |
String | Null |
액티비티 사용 예시 (Example Usage)
- 특정 경로에 있는 엑셀을 실행하여 'A2' 셀 값과 수식을 읽어 변수에 저장하고, 메시지 박스에 그 값을 출력하는 에시
'엑셀 열기' 액티비티 시퀀스 내부에서 사용 확인
* '엑셀 읽기-셀' 액티비티는 '엑셀 열기' 액티비티 내부 시퀀스에서만 사용 가능함
* '엑셀 열기' 내부 시퀀스에서 개발이 진행되는지 체크 필요'엑셀 열기' 액티비티 엑셀 파일 경로 설정
- Input Common > 엑셀파일경로
- Ex) "C:\Users\user\Desktop\test.xlsx"
- 예시로 테스트용 엑셀 경로를 활용하므로, 실제 실행시킬 엑셀 절대경로 입력 필요
- Ex) "C:\Users\user\Desktop\test.xlsx"
- Input Common > 엑셀파일경로
'엑셀 열기' 액티비티 Option 항목 설정
- Option > Activity 종료후 저장여부
- 체크 해제
- 직접 엑셀 저장하기위해 체크 해제 처리
- 체크 해제
- Option > 엑셀 App 보이게
- 체크 설정
- 엑셀 화면이 표시되며, 작업 절차를 육안으로 확인 가능
Tip
- 옵션 관련 매뉴얼 참고 링크 - 엑셀 열기
- 체크 설정
- Option > Activity 종료후 저장여부
'엑셀 읽기-셀' 액티비티 설정값 입력
- Input Common > 셀주소
- "A1:C5" 입력
- Input Common > 시트명
- "Sheet1" 입력
- Output > 저장할 변수 (String)
- STR_01 변수 입력
- Output > 저장할 변수 (수식, String형태)
- FORMULA_01 변수 입력
- Input Common > 셀주소
메시지 박스에 결과 값 출력
- 메시지 박스 내용에 변수 값 확인을 위한 수식 작성
"엑셀 읽기 결과" + Environment.NewLine + "==========" + Environment.NewLine + "A2 셀의 값 : " + STR_01 + Environment.NewLine + "A2 셀의 수식 : " + FORMULA_01
실행 결과 확인
- 작업 결과 엑셀 화면
- A2 셀의 값과 수식을 메시지 박스에 출력
- 작업 결과 엑셀 화면