AssessmentCreation - 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기5분
  • AssessmentCreation 클래스는 관리자가 평가 및 설문 조사를 생성하는 데 사용할 수 있는 메서드를 제공합니다.

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

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

    예를 들어 매개변수만 설정된 상태에서 typeID 메서드를 호출하면 메서드는 초대를 보낼 이해 관계자 또는 설문 조사 사용자를 검색합니다. 반면, 및 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 사용자 중 적어도 한 명이 설문 조사에 참여할 수 있는 권한이 없음을 나타냅니다. 다음 중 하나가 참인지 확인합니다.
      • 지정된 설문 조사 정의에 대한 설문 조사 사용자가 없습니다.
      • userID 값의 모든 사용자는 지정된 설문 조사 정의에 대한 설문 조사 사용자로 저장됩니다.
    • 완료됨 - 일정 기간 필드가 한 번만 설정된 설문 조사 정의이며, userID 해당 값에 있는 사용자 중 적어도 한 명이 해당 설문 조사 정의에 대한 설문 조사 인스턴스를 이미 완료했음을 나타냅니다typeID.
    • nousers - 매개변수가 userID 사용되지 않았으며 다음 중 하나가 참임을 나타냅니다.
      • 지정된 메트릭 유형과 관련된 이해 관계자가 없습니다. userID 매개변수를 설정하거나 하나 이상의 이해 관계자를 생성합니다.
      • 지정된 설문 조사 정의와 관련된 설문 조사 사용자가 없습니다. userID 매개변수를 설정하거나 설문 조사 사용자를 한 명 이상 생성합니다.
    • nosources - 값이 일정 유형 필드가 요청 시로 설정된 메트릭 유형이고 nor sourceRecordID 매개변수가 사용되지 않았 userID 음을 나타냅니다typeID. 이러한 매개 변수 중 하나 이상을 설정합니다.

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

    (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