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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AssessmentCreation - 전역

# AssessmentCreation - 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](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 사용자 중 하나 이상이 설문 조사에 참여할 권한이 없음을 나타냅니다. 다음 중 하나가 true인지 확인합니다. * 지정된 설문 조사 정의에 대한 설문 조사 사용자가 없습니다. * userID 값의 모든 사용자가 지정된 설문 조사 정의에 대한 설문 조사 사용자로 저장됩니다. {#r_AC-CreateAssessments_S_S_S__ul_lhq_ygr_lq} * 완료됨 - 값이 일정 기간 필드가 단 한 번으로 설정된 설문 조사 정의이고, 값의 userID 사용자 중 최소 한 명이 이미 해당 설문 조사 정의에 대한 설문 조사 인스턴스를 완료했음을 나타냅니다typeID. * nousers - 매개변수가 userID 사용되지 않았으며 다음 중 하나가 true임을 나타냅니다. * 지정된 메트릭 유형과 연결된 이해 관계자가 없습니다. 매개변수를 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