AssessmentCreation - 전역

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기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 나타냅니다. 다음 중 하나가 맞는지 확인합니다.
      • 지정된 설문 조사 정의에 대한 설문 조사 사용자가 없습니다.
      • userID 값의 모든 사용자는 지정된 설문 조사 정의에 대한 설문 조사 사용자로 저장됩니다.
    • 완료됨 - 이 값은 일정 기간 필드가 한 번만 설정된 설문 조사 정의이고, 이 값에 userID 있는 사용자 중 적어도 한 명이 해당 설문 조사 정의에 대한 설문 조사 인스턴스를 이미 완료했음을 나타냅니다typeID.
    • nousers - 매개 변수가 사용되지 않았으며 다음 중 하나가 true임을 나타냅니다 userID .
      • 지정된 메트릭 유형과 관련된 이해 관계자가 없습니다. 매개변수를 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