--- 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 --- # 이벤트 - 전역 # 이벤트 - 전역 {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 7분 이벤트 API는 이벤트 내에서 값을 설정하고 가져올 수 있는 메서드를 제공합니다. 이러한 이벤트는 A MID 서버 에서 인스턴스로 전송됩니다 ServiceNow . 이벤트를 성공적으로 전송하려면 먼저 인스턴스 MID 서버 간의 ServiceNow 연결을 정의해야 합니다. 이벤트 API를 사용하여 이벤트 내에서 필드를 추가/업데이트합니다. SNEventSenderProvider API를 사용하여 이벤트 보낸 사람 개체를 인스턴스화합니다. 그런 다음 IEventSender API를 사용하여 이벤트를 인스턴스로 ServiceNow 보냅니다. 이 API에 접근하기 전에 이벤트 관리(com.glideapp.itom.snac) 플러그인을 활성화해야 합니다. 이벤트 관리 플러그인은 별도의 구독이 필요하므로 활성화되어야 합니다. 이 플러그인은 데모 데이터를 포함하며 관련 플러그인이 아직 활성화되지 않은 경우 이를 활성화합니다. 이벤트 관리에 대한 자세한 내용은 [이벤트 관리를](https://www.servicenow.com/docs/access?context=c_EM&version=australia&pubname=australia-it-operations-management&ft:locale=en-US) 참조하십시오. ## 이벤트 - event() {#ariaid-title2} 이벤트 생성자를 인스턴스화합니다. {#Event-Event__table_zk1_mcl_jkb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 안 함 | | | [표 1. 매개변수] {#Event-Event__table_zk1_mcl_jkb} var event = new Event(); var esource = event.getField("source"); var eseverity = event.getField("severity"); ## 이벤트 - getField(문자열 필드) {#ariaid-title3} 이벤트 관리 필드에 전달된 현재 값을 반환합니다. {#Event-getField_S__table_ky4_4mk_jkb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 필드 | 문자열 | 반환할 이벤트 관리 필드 값의 이름입니다. | [표 2. 매개변수] {#Event-getField_S__table_ky4_4mk_jkb} {#Event-getField_S__table_ly4_4mk_jkb__entry__2} | 유형 | 설명 | |-|-| | 문자열 | 요청된 이벤트 관리 필드의 값입니다. | [표 3. 반환] {#Event-getField_S__table_ly4_4mk_jkb} var event = new Event(); var eventSource = event.getField("source"); var eventSeverity = event.getField("severity"); ## 이벤트 - setAdditionalInfo(문자열 additionalInfo) {#ariaid-title4} 연결된 이벤트의 기존 additional_info 필드를 전달된 JSON 문자열로 바꿉니다. 주: [setField()](https://servicenow-prod.fluidtopics.net/WssPRWgL7qIOMxvl1NZFsQ#Event-setField_S_S "연결된 이벤트에서 지정된 필드를 설정합니다.") 메서드를 사용하여 필드 내의 additional_info 특정 필드를 업데이트할 수 있습니다. {#Event-setAdditionalInfo_S__table_pc2_dbh_kkb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | additionalInfo | 문자열 | 필드에 저장할 JSON 문자열(키/값 쌍)입니다.additional_info 주: 이 매개변수는 기존 정보를 대체합니다. 기존 필드는 업데이트되지 않습니다. | [표 4. 매개변수] {#Event-setAdditionalInfo_S__table_pc2_dbh_kkb} {#Event-setAdditionalInfo_S__table_qc2_dbh_kkb__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 5. 반환] {#Event-setAdditionalInfo_S__table_qc2_dbh_kkb} event.setAdditionalInfo("{\"evtComponent\":\"Microsoft-Windows- WindowsUpdateClient\",\"evtMessage\":\"Installation Failure: Windows failed. Error 0x80070490\"}"); ## 이벤트 - setField(String key, String value) {#ariaid-title5} 연결된 이벤트에서 지정된 필드를 설정합니다. 전달 key 된 항목이 미리 정의된 이벤트 필드와 일치하면 메서드는 해당 이벤트 필드를 업데이트합니다. 그렇지 않으면 메서드 keyadditional_info 는 전달된 value. 다음은 이 방법을 사용하여 수정할 수 있는 미리 정의된 이벤트 필드입니다. {#Event-setField_S_S__table_ddd_32g_pkb__entry__2} | 필드 | 설명 | |-|-| | additional_info | 연결된 이벤트의 필드에 추가할 키-값 쌍입니다.additional_info 전달된 키가 이미 있으면 해당 값을 덮어씁니다. 최대 길이: 4,000자 연결된 UI 필드: 추가 정보 | | ci_identifier | 구성 항목을 고유하게 식별하는 JSON 문자열입니다. 예: `{"name":"SAP ORA01","type":"Oracle"}`. 최대 길이: 1,000자 | | cmdb_ci | 이벤트를 바인딩할 구성 항목 \[cmdb_ci\] 기록의 Sys_id입니다. 기본값: null | | 설명 | 이벤트에 대한 자유 형식 설명입니다. 최대 길이: 4,000자 연결된 UI 필드: 설명 기본값: null | | event_class | 이벤트를 생성한 EMS(Enterprise Message Service)입니다. 예: "Solarwinds" 또는 "SCOM". 최대 길이: 100 연결된 UI 필드: 소스 인스턴스 기본값: null | | message_key | 고유 이벤트 식별자입니다. 기존 이벤트 심각도를 재정의하려면 동일한 message_key 값을 사용합니다. 최대 길이: 1024자 연결된 UI 필드: 메시지 키 기본값: , node, resourcetype, 및 metric name의 조합source입니다. | | resolution_state | 이벤트 해결 상태입니다. 유효한 값은 다음과 같습니다. * 신규: 해당 이벤트의 해결 상태가 오픈입니다. * 종결: 해당 이벤트의 해결 상태는 종결/종결입니다. {#Event-setField_S_S__ul_szv_dmg_pkb} 연결된 UI 필드: 해결 상태 기본값: 신규 | | 자원 | 이벤트와 연결할 노드 자원입니다. 예를 들면 "디스크 C:", "CPI-1" 또는 프로세스나 서비스의 이름입니다. 최대 길이: 100자 연결된 UI 필드: 자원 | | 심각도 | 이벤트 심각도입니다. 유효한 값은 다음과 같습니다. * 0: 해제 - 조치가 필요하지 않습니다. 이 이벤트에서는 경보가 생성되지 않습니다. 기존 경보는 종결됩니다. * 1: 확인 - 경보가 생성됩니다. 자원이 여전히 작동하고 있습니다. * 2: 경고 - 자원은 여전히 작동하지만 주의가 필요합니다. * 3: 경미 - 부분적이거나 중요하지 않은 기능 손실 또는 성능 저하가 발생했습니다. * 4: 중요 - 주요 기능에 심각한 장애가 있거나 성능이 저하되었습니다. * 5: 중요 - 즉각적인 조치가 필요합니다. 자원이 작동하지 않거나 중요한 문제가 곧 발생합니다. {#Event-setField_S_S__ul_ol1_d4g_pkb} 연결된 UI 필드: 심각도 기본값: null | | 소스 | 이벤트를 트리거한 EMS의 인스턴스입니다. 일반적으로 커넥터 인스턴스 이름입니다. 최대 길이: 200자 연결된 UI 필드: 소스 기본값: null | | time_of_event | 이벤트가 소스 시스템에서 발생한 UTC 시간입니다. 형식: "yyyy-MM-dd HH:mm:ss" 최대 길이: 40자 연결된 UI 필드: 이벤트 시간 기본값: 현재 날짜/시간 | | 유형 | 이벤트가 관련된 메트릭 유형입니다(예: 디스크 또는 CPU). 이 값은 경보가 생성되는 이벤트 기록을 식별하는 데 사용됩니다. 최대 길이: 100자 연결된 UI 필드: 유형 기본값: null | [ ] {#Event-setField_S_S__table_ddd_32g_pkb} 주: [setText()](https://servicenow-prod.fluidtopics.net/WssPRWgL7qIOMxvl1NZFsQ#Event-setText_S "연결된 이벤트의 필드를 description 전달된 값으로 설정합니다.") 메서드를 사용하여 필드를 description 업데이트하고 [setTimeOfEvent()](https://servicenow-prod.fluidtopics.net/WssPRWgL7qIOMxvl1NZFsQ#Event-setTimeOfEvent_S "연결된 이벤트의 필드를 time_of_event UTC 시간 값으로 설정합니다.") 메서드를 사용하여 이벤트 시간을 업데이트할 수도 있습니다. 이벤트에 대한 자세한 내용은 [이벤트 관리를](https://www.servicenow.com/docs/access?context=c_EM&version=australia&pubname=australia-it-operations-management&ft:locale=en-US) 참조하십시오. {#Event-setField_S_S__table_ijd_4ck_jkb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 키 | 문자열 | 이벤트에서 추가하거나 업데이트할 키의 이름입니다. 미리 정의된 이벤트 필드에 대한 자세한 내용은 [이벤트 수집의 이벤트 필드 형식을 참조하십시오.](https://www.servicenow.com/docs/access?context=c_EMIntegrateRequirementEvent&version=australia&pubname=australia-it-operations-management&ft:locale=en-US) | | 값 | 문자열 | 연결된 이벤트 필드에 저장할 정보입니다. 주: 문자열은 value 저장되기 전에 잘리지므로 여러 공백이 단일 공백으로 바뀝니다. | [표 6. 매개변수] {#Event-setField_S_S__table_ijd_4ck_jkb} {#Event-setField_S_S__table_jjd_4ck_jkb__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 7. 반환] {#Event-setField_S_S__table_jjd_4ck_jkb} var event = new Event(); event.setField("source","SAP Solman"); event.setField("severity","3"); event.setField("time_of_event", "2019-18-05 13:12:05"); event.setField("type", "SAP object"); event.setField("user", "admin"); // parameter will be added to additional_info section ## 이벤트 - setText(문자열 텍스트) {#ariaid-title6} 연결된 이벤트의 필드를 description 전달된 값으로 설정합니다. 주: 이 메서드를 [이벤트 - setField(String key, String value)](https://servicenow-prod.fluidtopics.net/WssPRWgL7qIOMxvl1NZFsQ#Event-setField_S_S "연결된 이벤트에서 지정된 필드를 설정합니다.") 사용하여 현재 이벤트의 필드를 text 설정할 수도 있습니다. setField() 메서드와 달리 이 메서드는 전달된 텍스트를 트리밍하지 않습니다. {#Event-setText_S__table_r2j_mgh_kkb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 텍스트 | 문자열 | 관련 이벤트의 필드에 저장할 description 텍스트입니다. 최대 길이: 4000자 | [표 8. 매개변수] {#Event-setText_S__table_r2j_mgh_kkb} {#Event-setText_S__table_s2j_mgh_kkb__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 9. 반환] {#Event-setText_S__table_s2j_mgh_kkb} var event = new Event(); event.setText("SAP Solman"); ## 이벤트 - setTimeOfEvent(문자열 timeOfEvent) {#ariaid-title7} 연결된 이벤트의 필드를 time_of_event UTC 시간 값으로 설정합니다. 주: 이 메서드를 [이벤트 - setField(String key, String value)](https://servicenow-prod.fluidtopics.net/WssPRWgL7qIOMxvl1NZFsQ#Event-setField_S_S "연결된 이벤트에서 지정된 필드를 설정합니다.") 사용하여 필드를 설정할 수도 있습니다.time_of_event {#Event-setTimeOfEvent_S__table_m43_kwg_kkb__entry__3} | 이름 | 유형 | 설명 | |-|-|-| | 이벤트 시간(timeOfEvent) | 문자열 | 필드에 설정할 UTC 시간 값입니다.time_of_event 형식: "yyyy-MM-dd HH:mm:ss" 최대 길이: 40자 | [표 10. 매개변수] {#Event-setTimeOfEvent_S__table_m43_kwg_kkb} {#Event-setTimeOfEvent_S__table_n43_kwg_kkb__entry__2} | 유형 | 설명 | |-|-| | 무효 | | [표 11. 반환] {#Event-setTimeOfEvent_S__table_n43_kwg_kkb} var event = new Event(); event.setTimeOfEvent("2019-18-05 13:12:05");