AssessmentCreation - 전역

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

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

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

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

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

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

    표 1. 매개변수
    이름 유형 설명
    typeID 문자열 평가 또는 설문 조사를 생성할 메트릭 유형 또는 설문 조사 정의의 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 - 또는 sourceRecordID 매개변수를 사용하지 않았어야 함을 나타냅니다.userID 값이 일정 유형 필드가 예약됨 typeID 으로 설정된 메트릭 유형을 나타내는 경우 typeID 매개변수는 사용할 수 있는 유일한 매개변수입니다.
    • draft_state - 값이 게시되지 않은 메트릭 유형 또는 설문 조사 정의임을 나타냅니다 typeID . 메트릭 유형 또는 설문 조사 정의를 게시합니다.
    • invalidtype - 값과 typeID 일치하는 기존 메트릭 유형이 없음을 나타냅니다.
    • 비활성 - 값이 활성이 아닌 메트릭 유형 또는 설문 조사 정의임을 나타냅니다 typeID . 메트릭 유형 또는 설문 조사 정의로 이동하여 활성 확인란을 선택합니다.
    • not_available - 메트릭 또는 설문 조사 질문이 없는 메트릭 유형 또는 설문 조사 정의가 값임을 나타냅니다 typeID . 하나 이상의 메트릭 또는 설문 조사 질문을 추가합니다.
    • notyet - 값의 userID 사용자 중 하나 이상에게 아직 만료되지 않은 지정된 설문 조사 정의에 대한 설문 조사 인스턴스가 할당되었음을 나타냅니다. 오류 코드는 만료 날짜를 반환합니다.
    • wip - 값의 userID 사용자 중 하나 이상이 이미 설문 조사에 대한 설문 조사 인스턴스에 할당되었음을 나타냅니다.
    • not_authorized - 값의 userID 사용자 중 하나 이상이 설문 조사에 참여할 권한이 없음을 나타냅니다. 다음 중 하나가 true인지 확인합니다.
      • 지정된 설문 조사 정의에 대한 설문 조사 사용자가 없습니다.
      • 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