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

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기10분

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

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

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

    참고 항목:

    TestUserApi – cancelJob(문자열, 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 기록에 대한 것이어야 합니다.

    다음 예제에서는 admin 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여 줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 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: 다음 중 하나 이상의 이유로 사용자가 잘못되었습니다.
      • 사용자를 찾을 수 없습니다.
      • 사용자가 비활성 상태입니다.
      • 사용자가 잠깁니다.
      • 사용자는 암호 재설정이 필요합니다.
      • 사용자에게 관리자 역할이 없습니다.
      • 사용자에게 읽기 전용 액세스 권한이 있습니다.
      • 사용자는 웹 서비스에만 액세스할 수 있습니다.

    다음 예제에서는 admin 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여 줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 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 – 진행률(문자열 snboqId)

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

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

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

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

    다음 예제에서는 admin 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여 줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 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입니다. 그렇지 않으면 오류 메시지가 표시됩니다.
    클라우드 사용자를 클라우드 사용자로 설정할 수 없음 유효하지 않음 – 이 오류는 다음 이유 중 하나 이상으로 인해 제공된 사용자가 잘못되었음을 나타냅니다.
    • 사용자를 찾을 수 없습니다.
    • 사용자가 비활성 상태입니다.
    • 사용자가 잠깁니다.
    • 사용자는 암호 재설정이 필요합니다.
    • 사용자에게 관리자 역할이 없습니다.
    • 사용자에게 읽기 전용 액세스 권한이 있습니다.
    • 사용자는 웹 서비스에만 액세스할 수 있습니다.

    다음 예제에서는 admin 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여 줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 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입니다.

    다음 예제에서는 admin 사용자에 대한 테스트 사용자를 시작하고, 진행률을 가져오고, 테스트 사용자를 취소하는 방법을 보여 줍니다. 잠긴 사용자를 유효한 클라우드 사용자로 확인한 후 코드는 클라우드 사용자를 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