View Categories

2.0. 입력 데이터 구성

Ptero와 Stego에서는 다양한 방식으로 입력 데이터를 정의하고 관리할 수 있습니다. 시나리오 실행 시 필요한 데이터를 효율적으로 구성하여 테스트의 유연성과 재사용성을 높일 수 있습니다.

데이터 유형별 활용 가이드 #

  • System Variables: 시스템에서 자동으로 제공되는 실행 환경 및 디바이스 정보입니다. 시나리오 실행 중 필요한 환경 정보를 참조하거나 활용할 때 사용됩니다.
  • User Variables: 사용자가 직접 정의하는 값으로, 시나리오 내에서 반복적으로 사용하는 값을 정의하여 관리할 때 사용됩니다.
  • Data Set: CSV 파일을 기반으로 다량의 User Variable을 활용한 테스트를 수행할 때 사용됩니다.
  • Credential Info: 자율탐색 테스트에서 로그인 처리에 필요한 계정 정보를 설정할 때 사용됩니다.


User Variables 적용 우선순위 #


동일한 Key에 대해 여러 위치에서 Value가 정의된 경우, 다음 우선순위에 따라 적용됩니다:

  1. Data Set (CSV 파일)
  2. Ptero에서 설정된 User Variables
  3. Stego에서 설정된 User Variables


우선순위 적용 예시

Email Key에 대해 세 개 위치에서 값이 설정된 경우의 적용 방식을 설명합니다.

  • 설정 예시
    • Data Set: dataset@example.com
    • Ptero User Variables: ptero@example.com
    • Stego User Variables: stego@example.com

우선 순위 적용 결과

Data Set 설정Ptero User Variables 설정Stego User Variables 설정최종 적용값
OOOdataset@example.com
XOOptero@example.com
XXOstego@example.com


시나리오 작성 단계에서는 Stego에서 기본값을 설정하고, 실제 테스트 실행 시에는 Ptero나 CSV 파일의 값을 사용하여 다양한 데이터로 테스트를 진행할 수 있습니다.




User Variables #


시나리오 실행 중 반복적으로 사용될 값을 사전에 정의하고, 재사용할 수 있도록 지원하는 기능입니다. 사용자 이름, 전화번호, 나이와 같은 테스트 입력 값을 정의하여 전체 시나리오에서 일관되게 활용할 수 있습니다.

  • key: email
  • value: john.doe@example.com
  • → ${email} 로 사용


설정 위치 #

  1. Stego: Scenario Settings > User Variables
  2. Ptero: Test Suite 설정 > User Variables

동일한 Key 이름이 두 곳에 존재할 경우, Ptero에서 설정된 값이 우선 적용됩니다.


Stego에서 User Variables 설정 #


기본 설정

  • Key: User Variable의 이름 입력
  • Value: 사용할 값 입력
  • + Add Data: 새로운 User Variable 추가

추가 기능

  • : 비밀번호와 같은 민감한 데이터를 암호화할 수 있습니다. 암호화된 값은 마스킹되어 표시됩니다.
  • : 해당 User Variable을 삭제합니다.

⚠️ 주의사항: 암호화 후 해제 시 기존 값이 삭제되므로 새로 입력해야 합니다.
📖 Stego에서 User Variable을 설정하는 자세한 방법은 Stego 사용 가이드 > 6.2. 시나리오 설정에서 확인할 수 있습니다.



Ptero에서 User Variables 설정 #


기본 설정

  • Key: User Variable의 이름 입력
  • Value: 사용할 값 입력
  • + Add Data: 새로운 User Variable 추가

추가 기능

  • : 비밀번호와 같은 민감한 데이터를 암호화할 수 있습니다. 암호화된 값은 마스킹되어 표시됩니다.
  • : 해당 User Variable을 삭제합니다.

⚠️ 주의사항: 암호화 해제 시 기존 값이 삭제되므로 새로 입력해야 합니다.
📖 Ptero에서 User Variable을 설정하는 방법은 Ptero 사용 가이드 > 2.0. Test Suite 관리에서 확인할 수 있습니다.



Data Set #


Data Set은 CSV 파일 업로드를 통해 다량의 User Variable을 효율적으로 관리할 수 있도록 지원하는 기능입니다. CSV 파일을 업로드하여 하나의 시나리오로 여러 데이터 조합을 테스트할 수 있으며, Data-Driven Test를 통해 테스트 커버리지를 확대하고 효율성을 향상시킬 수 있습니다.

Data-Driven Test는 동일한 테스트 과정을 서로 다른 데이터로 반복 실행하는 테스트 방식입니다. 예를 들어 로그인 테스트 시나리오를 한 번 작성한 후, 여러 계정 정보를 적용하여 각각의 로그인 결과를 확인할 수 있습니다.

활용 사례 #

  • 로그인 테스트: 다양한 계정 정보로 검증
  • 상품 주문: 다양한 상품, 수량, 배송지로 주문 프로세스 확인
  • 검색 기능: 다양한 검색어를 사용한 결과 검증


CSV 작성 규칙 #

  • 첫 번째 행: User Variables의 Key
    • 최대 15개의 Key까지 지원
  • 두 번째 행부터: User Variables의 Value
    • Value 개수 제한 없음
  • 구분자: 쉼표(,) 또는 세미콜론(;)
  • 권장 업로드 용량: 100KB 이하


예시:

username,password,expected_result
user1@test.com,pass123,success
user2@test.com,wrongpass,failure
admin@test.com,admin123,successCSVCopyMore options

파일 업로드 및 설정 #

Scenario Test Suite 설정에서 CSV 파일을 업로드하여 Data Set을 설정할 수 있습니다.

  • 설정 방법:
    1. Data-Driven Test 토글 활성화
    2. Upload CSV 버튼을 클릭하거나, 파일을 드래그하여 CSV 파일 업로드
    3. Data Range 설정
      • All rows: 전체 데이터 사용
      • Range: 특정 행 범위 지정
        • 연속 범위: 1-5 (1행부터 5행까지)
        • 개별 행: 3, 7, 10 (3행, 7행, 10행만)
        • 혼합 사용: 1-3, 8, 11-13 (1-3행, 8행, 11-13행)

파일 관리 #

업로드한 CSV 파일은 Edit Scenario Test Suite 페이지의 Download CSV 버튼으로 다운로드할 수 있습니다.

Edit Scenario Test Suite 페이지 접근 방법은 Ptero 사용 가이드 > 2.0. Test Suite 관리에서 확인할 수 있습니다.

주의사항 #

  • CSV 파일 업로드 후 Data-Driven Test 토글을 비활성화하면 CSV 파일이 적용되지 않습니다.
  • 토글 비활성화 후 다시 활성화할 경우, CSV 파일을 다시 업로드해야 합니다.
  • 업로드된 CSV 파일은 수정할 수 없으며, 변경이 필요한 경우 새 파일을 업로드해야 합니다.



System Variables #


시스템에서 자동으로 정의되며, 사용자가 별도로 설정하지 않아도 시나리오에서 활용할 수 있습니다.

사용 방법 #


시나리오에서 사용 예시:

  • 디바이스 OS 정보: @OS
  • 현재 실행된 앱의 ID: @ACTIVE_APP_ID


System Variable 목록 #

System Variable 이름설명수정 가능 여부
@OS디바이스의 운영체제 정보 (예: Android, iOS)읽기 전용
@OS_VERSION운영체제 버전 (예: 14.4, 13.0.1 등)읽기 전용
@MODEL_NAME디바이스 모델 번호 (예: SM-G991N)읽기 전용
@DEVICE_NAME디바이스 이름읽기 전용
@ACTIVE_APP_ID현재 화면에 표시된 앱의 패키지명 또는 번들 ID읽기 전용
@HTTP_PROXY_SERVER_URLHAR(HTTP Archive format) 수집을 위한 프록시 서버 URL읽기 전용
@HTTP_PROXY_PORT프록시 서버 포트 번호읽기 전용
@AUTHORING_MODE시나리오가 Stego에서 실행 중이면 ON, Ptero에서는 OFF읽기 전용
@CLIPBOARD현재 디바이스 클립보드에 저장된 값수정 가능
@WAIT_FOR_NAVIGATION_TIMEOUT스텝 간 실행 간격 지연 시간 (단위: ms, 기본값: 3,000)수정 가능
@PHASE저장된 마지막 값이 Ptero 테스트 결과의 라벨로 자동 추가됨수정 가능

주의사항 #

  • 시나리오에서 System Variables 이름으로 참조 (예: @OS)
  • 시스템에서 실행 시점에 자동으로 값 제공
  • 일부 액션에서 System Variables를 지원합니다.

📖 자세한 내용은 Stego 사용 가이드 > 7.2. 액션 설정에서 확인할 수 있습니다.




Credential Info #


자율탐색 테스트 수행 중 로그인 페이지를 탐지했을 때 자동으로 입력되는 로그인 정보입니다. 미리 설정한 Credential Info가 자동으로 해당 필드에 입력되어 로그인 절차를 수행합니다.

설정 방법

  1. Ptero에서 Autonomous Test Suite 설정 페이지로 이동합니다.
  2. Credential Info 섹션에 다음 항목을 입력합니다:
    • Login ID: 사용자 ID
    • Password: 비밀번호
  3. 저장 후 자율탐색 테스트 실행 시 자동으로 적용됩니다.

🔒 보안: 비밀번호 필드는 자동으로 마스킹 처리됩니다.

주의사항

  • 로그인 UI가 탐지되지 않으면 자동 입력이 작동하지 않습니다.
  • 하나의 Credential Info(ID/PW 쌍)만 등록 가능하며, 복수 계정은 지원되지 않습니다.
  • 민감 정보 보호를 위해 보안 관리가 가능한 계정을 등록할 것을 권장합니다.

📖 Credential Info를 설정하는 방법은 Ptero 사용 가이드 > 2.1. Test Suite 관리 – Mobile App에서 확인할 수 있습니다.

Scroll to Top