Variables
Keyword·Script·Reserved 변수를 설명합니다.
스크립트에서 사용되는 모든 변수를 관리하는 영역입니다. 종류는 세 가지 — Keyword, Script, 예약어(Reserved word) — 이며, 명령어 인자 어디에서나 [varname] 형태로 참조할 수 있습니다.
스크립트에서 사용하는 모든 입력에 들어 있는 [ ]는 변수로 판단됩니다. 일반 텍스트로 [ ]를 쓰고 싶다면 의도치 않게 변수로 해석되지 않도록 주의하세요.
한눈에 보기
| 종류 | 생성 시점 | 수명 | 비고 |
|---|---|---|---|
| Keyword | 스크립트 그룹 생성 시 자동 | 스크립트 그룹과 동일 | 이중 변환 [@name] 가능 |
| Script (Variables 패널) | 사용자가 패널에서 등록 | 삭제 전까지 영구 (프로젝트 파일에 저장) | 전역변수처럼 동작 |
Script (Set 명령) | Set 명령 실행 시 | 테스트 종료까지 | 지역변수처럼 동작 |
| 예약어 | 시스템 제공 | — | #으로 시작, [#name]으로 참조 |
Keywords
스크립트 그룹이 생성될 때 자동으로 함께 만들어지는 변수입니다. 스크립트 그룹과 짝지어 생성·삭제됩니다.
- 보통
Call명령어로 스크립트 그룹을 호출할 때, 인자들이 키워드 변수에 기록됩니다. - 스크립트 그룹 안에서는 이 키워드 변수를 통해 전달받은 값을 분석·구분해서 사용합니다.
이중 변환 ([@name])
Keyword Variable은 Aurora 변수 중 유일하게 이중 변환을 지원합니다.
[name]— 변수에 할당된 값으로 치환[@name]— 변수에 할당된 값이 가리키는 또 다른 값으로 치환
이중 변환은 변수에 변수 이름이 들어 있을 때 유용합니다. 예를 들어 name = "target" 이고 target = "OK" 이면, [name] 은 target 으로, [@name] 은 OK 로 치환됩니다.
Script
스크립트를 수행할 때 사용되는 변수입니다. 등록 방식에 따라 동작이 달라집니다.
Variables 패널에 등록
Variables 패널에서 직접 등록한 변수는 전역변수처럼 동작합니다.
- 프로젝트 파일에 저장되어, 삭제 전까지 영구적으로 유지됩니다.
- 같은 스크립트 안의 어디서나 동일한 값을 읽을 수 있습니다.
Set 명령으로 생성
Set 명령어로 설정해 사용하는 변수는 지역변수처럼 동작합니다.
- 명령이 수행되는 시점에 생성되고, 테스트가 종료될 때까지만 존재합니다.
- 일회성 계산값·중간 결과를 담을 때 사용합니다.
Default Script Variable
스크립트가 자동으로 제공하는 기본 변수들입니다. 별도로 선언하지 않아도 바로 사용할 수 있습니다.
| 변수명 | 설명 |
|---|---|
mIndex | Do ~ Loop 명령에서 기본으로 사용할 수 있는 카운터 변수 |
mReturnValue | 명령 수행 후 반환 값이 있을 때 저장 (대부분 문자열이 아닌 값) |
mReturnString | 명령 수행 후 반환 값이 있을 때 저장 (대부분 문자열 값) |
mMeasurementValue | 명령어에서 특수하게 사용하는 변수 |
예약어 (Reserved word)
스크립트를 수행할 때 사용되는 내부 예약 변수입니다. 시스템이 제공하므로 사용자가 선언할 필요가 없습니다.
#으로 시작되는 문자열로, 스크립트 수행과 관련된 정보를 표현합니다.- 일반 변수와 동일하게
[ ]안에 넣어 참조합니다. - 예를 들어 현재 날짜를 얻으려면
[#date]와 같이 사용합니다.
Default Reserved Word Variable
| 변수명 | 값 형식 | 예 |
|---|---|---|
#date | 현재 날짜 | 20221221 |
#time | 현재 시간 | 170900 |
#resdir | 스크립트 리소스 폴더 경로 (\ 포함) | — |
#reportdir | 리포트 폴더 경로 (\ 포함) | — |
#scriptdir | 스크립트 폴더 경로 (\ 포함) | — |
파일을 읽거나 쓸 때 절대 경로를 직접 적기보다 [#resdir] / [#scriptdir] 같은 예약어를 활용하면, 프로젝트 폴더 위치가 바뀌어도 흐름이 깨지지 않습니다.
다음 단계
- 프로젝트 전반에서 공유되는 변수는 Global Variables에서 다룹니다.
- 변수와 함께 사용되는 연산자·치환 문법은 Expression에서 확인하세요.
- 여러 값을 하나의 변수에 묶어 다루는 방법은 Arrays에서 정리합니다.