클라우드 실행기 TestUserApi – 범위 지정, 전역

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 10분

    • Automated Test Framework(ATF)용 클라우드 실행기에서 실행할 테스트 사용자 작업을 관리합니다. 이 API는 CloudRunnerApi 스크립트 포함의 일부입니다.

    다음 작업에 이 API를 사용할 수 있습니다.
    • 사용자 테스트 작업을 시작합니다.
    • 클라우드 사용자를 설정합니다.
    • 지정된 사용자가 유효한지 확인하십시오.
    • 사용자 테스트 작업의 진행률을 확인합니다.
    • 테스트 작업을 취소합니다.

    전역 범위에서 이 API는 sn_atf_tg 네임스페이스 내에서 실행됩니다. 이 API를 사용하려면 (sn_atf_tg) 플러그인이 ATF Test Generator and Cloud Runner 활성화되어 있어야 합니다.

    참조:

    TestUserApi – cancelJob(String snboqId)

    브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블에서 테스트 사용자 작업 상태를 완료하도록 설정합니다.

    표 1. 매개변수
    이름 유형 설명
    snboqId 문자열 필수 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.
    표 2. 반환
    유형 설명
    null 성공하면 Null, 그렇지 않으면 오류 메시지입니다.
    오류 실패하면 다음과 같은 오류 메시지가 나타날 수 있습니다.
    • BOQ ID가 전달되지 않음 – 제공된 JSON 개체에 BOQ ID 항목이 없습니다. JSON 객체가 {snboqId: "<sys_id>"}로 구조화되어 있는지 확인합니다.
    • 잘못된 BOQ sys_id 전달됨 – 입력한 ID는 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록에 대한 것이어야 합니다.

    다음 예제에서는 관리자 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여줍니다. 코드는 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

    출력:

    {progress: 64, state: running}
User is missing the following criteria: 
	User is locked out
False

    TestUserApi – isValidCloudUser(문자열 사용자 이름)

    제공된 사용자가 올바른 클라우드 사용자인지 확인합니다.

    표 3. 매개변수
    이름 유형 설명
    username 객체 필수 사용자 [sys_user] 테이블에 나열된 유효한 사용자의 사용자 ID입니다. 이 값은 JSON 객체에서 문자열로 제공됩니다. 예: {username: "abel.tuter"}.
    표 4. 반환
    유형 설명
    부울

    제공된 사용자가 올바른 클라우드 사용자인지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 제공된 사용자가 올바른 클라우드 사용자입니다.
    • false: 제공된 사용자가 다음 이유 중 하나 이상으로 인해 잘못되었습니다.
      • 사용자를 찾을 수 없습니다.
      • 사용자가 비활성 상태입니다.
      • 사용자가 잠깁니다.
      • 사용자는 암호 재설정이 필요합니다.
      • 사용자에게 관리자 역할이 없습니다.
      • 사용자에게 읽기 전용 액세스 권한이 있습니다.
      • 사용자에게 웹 서비스만 접근할 수 있습니다.

    다음 예제에서는 관리자 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여줍니다. 코드는 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

    출력:

    {progress: 64, state: running}
User is missing the following criteria: 
	User is locked out
False

    TestUserApi – progress(String snboqId)

    제공된 BOQ(브라우저 오케스트레이션 큐) 기록에 대한 각 사용자 테스트의 상태를 제공합니다.

    표 5. 매개변수
    이름 유형 설명
    snboqId 문자열 필수 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.
    표 6. 반환
    유형 설명
    객체 테스트 진행률을 나타내는 JSON 객체입니다.
    {
  "progress": Number,
  "state": "String"
}
    객체.진행률 테스트 진행률 백분율 완료를 나타냅니다.

    유형: 번호
    객체.상태 BOQ 기록의 상태입니다.
    가능한 값:
    • 보류 중 - 요청한 테스트 활동이 생성되어 실행 대기 중입니다.
    • 처리 중 – 요청이 클라우드 인프라로 전송되기 전에 인스턴스가 실행 추적기가 클라우드 실행기에 대해 표시되는지 확인하기 위해 기록을 스캔합니다.
    • 브라우저 요청됨 – 테스트 생성 또는 테스트 실행을 위해 브라우저를 시작하기 위해 요청이 클라우드 인프라로 전송되었습니다.
    • 실행 중 – 클라우드 인프라 브라우저에서 보류 중인 테스트를 찾아 실행합니다.
    • 완료됨 – 테스트 작업이 완료되었습니다.
    • 실패 상태 - 테스트 작업이 실패했습니다.

    유형: 문자열
    오류 실패하면 다음과 같은 오류 메시지가 나타날 수 있습니다.
    • BOQ ID가 전달되지 않음 – 제공된 JSON 개체에 BOQ ID 항목이 없습니다. JSON 객체가 {snboqId: "<sys_id>"}로 구조화되어 있는지 확인합니다.
    • 잘못된 BOQ sys_id 전달됨 – 입력한 ID는 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록에 대한 것이어야 합니다.

    다음 예제에서는 관리자 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여줍니다. 코드는 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

    출력:

    {progress: 64, state: running}
User is missing the following criteria: 
	User is locked out
False

    TestUserApi – selectCloudUser(문자열 사용자 이름)

    클라우드 실행기에서 엔드 투 엔드 테스트 사용자 작업을 시작합니다. 사용자가 관리자 역할로 올바르게 로그인할 수 있는 경우 클라우드 실행기 인프라에서 향후 테스트 실행 및 테스트 생성을 위해 클라우드 사용자 속성이 이 사용자로 설정됩니다.

    표 7. 매개변수
    이름 유형 설명
    username 객체 필수 사용자 [sys_user] 테이블에 나열된 유효한 사용자의 사용자 ID입니다. 이 값은 JSON 객체에서 문자열로 제공됩니다. 예: {username: "abel.tuter"}.
    표 8. 반환
    유형 설명
    영 성공할 경우 Null입니다. 그렇지 않으면 오류 메시지가 표시됩니다.
    클라우드 사용자를 클라우드 사용자로 설정할 수 없음 - 이 오류는 제공된 사용자가 다음 이유 중 하나 이상으로 인해 잘못되었음을 나타냅니다.
    • 사용자를 찾을 수 없습니다.
    • 사용자가 비활성 상태입니다.
    • 사용자가 잠깁니다.
    • 사용자는 암호 재설정이 필요합니다.
    • 사용자에게 관리자 역할이 없습니다.
    • 사용자에게 읽기 전용 액세스 권한이 있습니다.
    • 사용자에게 웹 서비스만 접근할 수 있습니다.

    다음 예제에서는 관리자 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여줍니다. 코드는 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

    출력:

    {progress: 64, state: running}
User is missing the following criteria: 
	User is locked out
False

    TestUserApi – startJob(문자열 사용자 이름)

    클라우드 실행기에서 엔드 투 엔드 테스트 사용자 작업을 시작합니다.

    표 9. 매개변수
    이름 유형 설명
    username 문자열 필수 클라우드 실행기의 엔드 투 엔드 인프라를 테스트할 sys_user의 사용자 이름입니다.
    표 10. 반환
    유형 설명
    문자열 브라우저 오케스트레이션 큐 [sn_atf_tg_sn_boq] 테이블의 BOQ 기록 sys_id입니다.

    다음 예제에서는 관리자 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여줍니다. 코드는 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 클라우드 사용자를 ITIL 관리자로 설정합니다. 전역 범위에서는 sn_atf_tg 네임스페이스를 사용합니다.

    var snboqId = CloudRunnerAPI.TestUserAPI.startJob({username: "abel.tuter"});

gs.info(JSON.stringify(CloudRunnerAPI.TestUserAPI.progress({snboqId: snboqId})));

CloudRunnerAPI.TestUserAPI.cancelJob({snboqId: snboqId});

gs.info(CloudRunnerAPI.TestUserAPI.isValidCloudUser({username: <name of the user who has been locked out>}));

CloudRunnerAPI.TestUserAPI.selectCloudUser({username: "itil_admin"});

    출력:

    {progress: 64, state: running}
User is missing the following criteria: 
	User is locked out
False