---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AssessmentCreation - 전역

# AssessmentCreation - 전역 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분

AssessmentCreation API는 관리자가 평가 및 설문 조사를 생성하는 데 사용할 수 있는 메서드를 제공합니다.
createAssessments() 메서드를 호출하는 방법에는 여러 가지가 있습니다. 메트릭 유형 또는 설문 조사 정의를 식별하려면 모든 경우에 매개변수를 설정해야 typeID 합니다.  
메서드의 동작 방식에 영향을 주는 몇 가지 요소는 다음과 같습니다.

* 대상이 평가 또는 설문 조사인지 여부
* 평가 일정 유형이 주문형인지 예약인지 여부
* 설문 조사 일정 기간
* 제공된 매개변수
{#c_AssessmentCreation__ul_v1j_wdr_lq}

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

## AssessmentCreation - createAssessments(문자열 typeID, 문자열 sourceRecordID, 문자열 userID) {#ariaid-title2}

지정된 메트릭 유형 또는 설문 조사 정의에 대해 하나 이상의 평가 또는 설문 조사를 생성합니다.
{#r_AC-CreateAssessments_S_S_S__table_r4v_xjy_mx__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| typeID | 문자열 | 평가 또는 설문 조사를 생성할 메트릭 유형 또는 설문 조사 정의의 sys_id입니다. |
| 소스 기록 ID | 문자열 | 생성된 평가에 포함할 하나 이상의 쉼표로 구분된 설문 조사 정의 sys_ids. 각 소스 기록에 대해 지정된 메트릭 유형과 연결된 평가 가능한 기록이 있어야 합니다. 이 매개변수를 비워 두면 생성된 평가에는 지정된 유형에 대한 모든 평가 가능한 기록이 포함됩니다. 이 매개변수는 평가에만 사용됩니다. |
| userID | 문자열 | 평가 또는 설문 조사 인스턴스를 전송할 하나 이상의 사용자 sys_ids이며 쉼표로 구분됩니다. 이 매개변수를 비워 두면 평가 이해 관계자 또는 설문 조사 사용자가 인스턴스를 받습니다. 이 매개변수는 주문형 평가에 필요합니다. |
[표 1. 매개변수]

{#r_AC-CreateAssessments_S_S_S__table_r4v_xjy_mx} {#r_AC-CreateAssessments_S_S_S__table_s4v_xjy_mx__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 메서드가 성공하면 7a2ad2253784200044e0bfc8bcbe5de1, 10, b7e8b5d4c0a80169008b49e468920048(인스턴스 ID, 인스턴스 수, 그룹 ID)과 같이 쉼표로 구분된 문자열을 반환합니다. * instanceID: 작성된 평가 또는 설문 조사 인스턴스의 Sys_id입니다(하나만 있는 경우). 인스턴스가 여러 개 있는 경우 인스턴스 중 하나의 Sys_id입니다. 인스턴스가 여러 개인 경우 그룹 ID를 사용하여 데이터를 검색합니다. * #instances: 생성된 평가 또는 설문 조사 인스턴스 수입니다. * groupID: 생성된 평가 또는 설문 조사 인스턴스가 포함된 평가 그룹의 Sys_id입니다. {#r_AC-CreateAssessments_S_S_S__ul_kcc_bfr_lq} 메서드가 평가 또는 설문 조사를 생성할 수 없는 경우 오류 코드 중 하나를 반환합니다. 오류 코드 * isscheduled - 또는 sourceRecordID 매개 변수를 사용하지 않아야 함을 userID 나타냅니다. typeID 값이 일정 유형 필드가 예약 typeID 됨으로 설정된 메트릭 유형을 나타낼 때 매개변수는 사용할 수 있는 유일한 매개변수입니다. * draft_state - 값이 게시되지 않은 메트릭 유형 또는 설문 조사 정의임을 나타냅니다 typeID . 메트릭 유형 또는 설문 조사 정의를 게시합니다. * invalidtype - 값과 일치하는 기존 메트릭 유형이 없음을 typeID 나타냅니다. * 비활성 - 값이 활성 상태가 아닌 메트릭 유형 또는 설문 조사 정의임을 나타냅니다 typeID . 메트릭 유형 또는 설문 조사 정의로 이동하고 활성 확인란을 선택합니다. * not_available - 값이 메트릭 또는 설문 조사 질문이 없는 메트릭 유형 또는 설문 조사 정의임을 나타냅니다 typeID . 하나 이상의 메트릭 또는 설문 조사 질문을 추가합니다. * notyet - 아직 만료되지 않은 지정된 설문 조사 정의에 대한 설문 조사 인스턴스가 값의 userID 사용자 중 적어도 한 명에게 할당되었음을 나타냅니다. 오류 코드는 만료 날짜를 반환합니다. * wip - 해당 값의 userID 사용자 중 적어도 한 명에게 설문 조사에 대한 설문 조사 인스턴스가 이미 할당되었음을 나타냅니다. * not_authorized - 값의 사용자 중 하나 이상이 설문 조사를 수행할 권한이 없음을 userID 나타냅니다. 다음 중 하나가 맞는지 확인합니다. * 지정된 설문 조사 정의에 대한 설문 조사 사용자가 없습니다. * userID 값의 모든 사용자는 지정된 설문 조사 정의에 대한 설문 조사 사용자로 저장됩니다. {#r_AC-CreateAssessments_S_S_S__ul_lhq_ygr_lq} * 완료됨 - 이 값은 일정 기간 필드가 한 번만 설정된 설문 조사 정의이고, 이 값에 userID 있는 사용자 중 적어도 한 명이 해당 설문 조사 정의에 대한 설문 조사 인스턴스를 이미 완료했음을 나타냅니다typeID. * nousers - 매개 변수가 사용되지 않았으며 다음 중 하나가 true임을 나타냅니다 userID . * 지정된 메트릭 유형과 관련된 이해 관계자가 없습니다. 매개변수를 userID 설정하거나 하나 이상의 이해 관계자를 생성합니다. * 지정된 설문 조사 정의와 관련된 설문 조사 사용자가 없습니다. 매개변수를 userID 설정하거나 하나 이상의 설문 조사 사용자를 생성합니다. {#r_AC-CreateAssessments_S_S_S__ul_zsq_chr_lq} * nosources - 값이 일정 유형 필드가 요청 시로 설정된 메트릭 유형이고 nor sourceRecordID 매개변수가 userID 사용되지 않음을 나타냅니다typeID. 이러한 매개 변수 중 하나 이상을 설정합니다. {#r_AC-CreateAssessments_S_S_S__ul_axv_x4h_1t} |
[표 2. 반환]

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

    (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