AssessmentCreation - 전역

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분
  • AssessmentCreation API는 관리자가 평가 및 설문 조사를 생성하는 데 사용할 수 있는 메서드를 제공합니다.

    createAssessments() 메서드를 호출하는 방법에는 여러 가지가 있습니다. 메트릭 유형 또는 설문 조사 정의를 식별하려면 모든 경우에 매개변수를 설정해야 typeID 합니다.

    메서드의 동작 방식에 영향을 주는 몇 가지 요인은 다음과 같습니다.
    • 대상이 평가 또는 설문 조사인지 여부
    • 평가 일정 유형이 요청 시인지 예약인지 여부
    • 설문 조사 일정 기간
    • 매개변수 제공됨

    예를 들어, 매개 변수 집합만 typeID 사용하여 메서드를 호출하면 메서드는 초대를 보낼 이해 관계자 또는 설문 조사 사용자를 검색합니다. 반면, and userID 매개 변수를 사용하여 typeID 메서드를 호출하면 지정된 사용자에게 초대를 보내려고 시도합니다.

    AssessmentCreation - createAssessments(문자열 typeID, 문자열 sourceRecordID, 문자열 userID)

    지정된 메트릭 유형 또는 설문 조사 정의에 대해 하나 이상의 평가 또는 설문 조사를 만듭니다.

    표 1. 매개변수
    이름 유형 설명
    유형 ID 문자열 평가 또는 설문 조사를 생성할 메트릭 유형 또는 설문 조사 정의의 sys_id입니다.
    소스 기록 ID 문자열 생성된 평가에 포함할 하나 이상의 쉼표로 구분된 설문 조사 정의 sys_ids. 각 소스 기록에 대해 지정된 메트릭 유형과 연결된 평가 가능한 기록이 있어야 합니다. 이 매개변수를 비워 두면 생성된 평가에는 지정된 유형에 대한 모든 평가 가능한 기록이 포함됩니다. 이 매개변수는 평가에만 사용됩니다.
    userID 문자열 평가 또는 설문 조사 인스턴스를 보낼 쉼표로 구분된 하나 이상의 사용자 sys_ids입니다. 이 매개변수를 비워 두면 평가 이해 관계자 또는 설문 조사 사용자가 인스턴스를 받습니다. 이 매개변수는 요청 시 평가에 필요합니다.
    표 2. 반환
    유형 설명
    문자열 메서드가 성공하면 다음 값을 사용하여 7a2ad2253784200044e0bfc8bcbe5de1, 10, b7e8b5d4c0a80169008b49e468920048(인스턴스 ID, 인스턴스 수, 그룹 ID)과 같은 쉼표로 구분된 문자열을 반환합니다.
    • instanceID: 생성된 평가 또는 설문 조사 인스턴스의 Sys_id입니다(있는 경우). 인스턴스 중 하나의 Sys_id입니다(여러 개가 있는 경우). 인스턴스가 여러 개인 경우 그룹 ID를 사용하여 데이터를 검색합니다.
    • #instances: 생성된 평가 또는 설문 조사 인스턴스 수입니다.
    • groupID: 생성된 평가 또는 설문 조사 인스턴스가 포함된 평가 그룹의 Sys_id입니다.

    메서드가 평가 또는 설문 조사를 생성할 수 없는 경우 오류 코드 중 하나를 반환합니다.

    오류 코드
    • isscheduled - or sourceRecordID 매개변수를 사용하지 말았어야 함을 userID 나타냅니다. typeID 값이 일정 유형 필드가 예약됨 typeID 으로 설정된 메트릭 유형을 나타내는 경우 매개변수는 사용할 수 있는 유일한 매개변수입니다.
    • draft_state - 값이 게시되지 않은 메트릭 유형 또는 설문 조사 정의임을 나타냅니다 typeID . 메트릭 유형 또는 설문 조사 정의를 게시합니다.
    • invalidtype - 값과 일치하는 typeID 기존 메트릭 유형이 없음을 나타냅니다.
    • 비활성 - 값이 메트릭 유형 또는 설문 조사 정의가 활성화되지 않음을 typeID 나타냅니다. 메트릭 유형 또는 설문 조사 정의를 찾아 활성 확인란을 선택합니다.
    • not_available - 값이 메트릭 또는 설문 조사 질문이 없는 메트릭 유형 또는 설문 조사 정의임을 typeID 나타냅니다. 하나 이상의 메트릭 또는 설문 조사 질문을 추가합니다.
    • notyet - 값의 사용자 userID 중 하나 이상이 지정된 설문 조사 정의에 대한 설문 조사 인스턴스가 할당되었으며 아직 만료되지 않았음을 나타냅니다. 오류 코드는 만료 날짜를 반환합니다.
    • WIP - 값의 사용자 userID 중 하나 이상에게 설문 조사에 대한 설문 조사 인스턴스가 이미 할당되었음을 나타냅니다.
    • not_authorized - 값의 사용자 userID 중 적어도 한 명이 설문 조사를 수행할 권한이 없음을 나타냅니다. 다음 중 하나가 맞는지 확인합니다.
      • 지정된 설문 조사 정의에 대한 설문 조사 사용자가 없습니다.
      • userID 값의 모든 사용자는 지정된 설문 조사 정의에 대한 설문 조사 사용자로 저장됩니다.
    • 완료됨 - 값이 일정 기간 필드가 한 번으로 설정된 설문 조사 정의이고 값의 사용자 userID 중 하나 이상이 해당 설문 조사 정의에 대한 설문 조사 인스턴스를 이미 완료했음을 나타냅니다typeID.
    • nousers - 매개변수가 userID 사용되지 않았으며 다음 중 하나가 true임을 나타냅니다.
      • 지정된 메트릭 유형과 관련된 이해 관계자가 없습니다. userID 매개변수를 설정하거나 하나 이상의 이해 관계자를 생성합니다.
      • 지정된 설문 조사 정의와 관련된 설문 조사 사용자가 없습니다. userID 매개변수를 설정하거나 최소 한 명의 설문 조사 사용자를 생성합니다.
    • nosources - 값이 일정 유형 필드가 요청 시로 설정된 메트릭 유형이고 nor sourceRecordID 매개변수가 userID 사용되지 않았음을 나타냅니다typeID. 이러한 매개변수 중 하나 이상을 설정합니다.

    이 코드 예시에서는 서비스 포털 위젯에서 평가 인스턴스를 생성하는 방법을 보여줍니다. 일정 유형이 요청 시로 설정된 경우 이 예시가 작동하지 않습니다.

    (function() {
      var gdtSurvey = new GlideDateTime();
      if (gdtSurvey.getDayOfMonthUTC() == 23) {
        (new SNC.AssessmentCreation()).createAssessments('d902e09a075730101263f19d7c1ed03a', // Assessment metric type sys_id
          '4baec2fe07d3f0101263f19d7c1ed0a6', // Assessable record which is the source of the assessment
          gs.getUserID()); // Users ID to send the assessment instances to
      }
    })();

    반환 결과:

    bbf0b9b8072330101263f19d7c1ed00b,1,33f0f978072330101263f19d7c1ed05f