---
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


---

# MIDHermesProducer - 전역

# MIDHermesProducer - 전역 {#ariaid-title1}

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

MIDHermesProducer API는 에서 MID 서버 주제로 Hermes 데이터를 보내는 메서드를 제공합니다.

를 사용하는 [MID Server ECC Queue](https://www.servicenow.com/docs/access?context=ecc-queue-mid-server&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 대신 를 [Hermes Messaging Service](https://www.servicenow.com/docs/access?context=hermes-messaging-service&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 통해 데이터를 보내는 것이 인스턴스로 ServiceNow 데이터를 가져오는 더 효율적인 방법이 될 수 있습니다.

이 API에는 MID Hermes API(com.glide.mid.hermes_api) 플러그인이 ServiceNow 필요합니다. 호출 사용자에게 kafka_admin 역할이 있어야 합니다. 이 API를 호출하기 전에 다음 단계를 따르십시오.[Configure the MID Hermes API Extension](https://www.servicenow.com/docs/access?context=MID-hermes-API&version=australia&pubname=australia-integrate-applications&section=configure-mid-hermes-api&ft:locale=en-US)

[워크플로우 스튜디오](https://www.servicenow.com/docs/access?context=workflow-studio&version=australia&pubname=australia-build-workflows&ft:locale=en-US) 에서 실행 MID 서버MID 서버되는 스크립트에서 이 API를 사용하십시오. (예: 백그라운드 스크립트) 또는필요한 런타임이MID로 설정된 작업 스크립트 단계입니다.

## MIDHermesProducer - MIDHermesProducer() {#ariaid-title2}

주제에 메시지를 전송하기 위한 MIDHermesProducer 를 Hermes 작성합니다.
{#MIDHermesProd-MIDHermesProd__table_j1w_c1c_23c__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#MIDHermesProd-MIDHermesProd__table_j1w_c1c_23c}  
이 예시에서는 MIDHermesProducer를 인스턴스화합니다.

    var producer = new MIDHermesProducer();

## MIDHermesProducer - 보내기(객체 옵션) {#ariaid-title3}

MID 서버 에서 지정된 Hermes주제로 메시지를 보냅니다.
주제에 Hermes 메시지를 보내려면 4000-4050 포트 범위를 열어야 합니다. 자세한 내용은 [Producing and consuming messages from a Kafka client](https://www.servicenow.com/docs/access?context=producing-consuming-hermes&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US) 문서를 참조하십시오.
{#MIDHermesProd-send_O__table_n1j_g1c_23c__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 옵션 | 객체 | 메시지에 대한 구성 매개변수를 포함합니다. { applicationId: "String", callbackFunction: function(), headers: {Object}, key: "String", message: "String", topic: "String" } |
| options.applicationId | 문자열 | 옵션입니다. 주제 라우팅에 대한 애플리케이션 식별자입니다. 제공된 경우 메시지는 `snc.{ instance}를 사용합니다. {applicationId}입니다. {topic}`, 그렇지 않으면 `snc로 라우팅됩니다.{ instance}를 사용합니다. {주제}`입니다. |
| options.onErrorCallback | 함수 | 옵션입니다. 메시지 전달이 실패할 경우 실행할 JavaScript 함수입니다. 이 함수는 문자열 `errorMessage` 및 문자열 `errorType` (정규화된 Java 예외 클래스 이름)의 두 가지 매개변수를 허용합니다. function(errorMessage, errorType) { //implement error handling here }; |
| 옵션.헤더 | 객체 | 옵션입니다. 메시지 헤더에 대한 키-값 쌍입니다. 에서 지원하는 Apache Kafka 모든 헤더가 유효합니다. |
| options.key | 문자열 | 옵션입니다. 에서 파티셔닝 Apache Kafka을 위한 메시지 키입니다. 동일한 키를 가진 메시지는 동일한 파티션으로 전송되어 순서가 보장됩니다. |
| 옵션.메시지 | 문자열 | 주제에 보낼 메시지의 내용입니다. 문자열로 형식화된 모든 값이 유효합니다. |
| 옵션.주제 | 문자열 | 메시지를 보낼 주제의 Hermes 이름입니다. 주: 인스턴스 프리픽스를 포함하지 마십시오. 자동으로 추가됩니다. |
[표 2. 매개변수]

{#MIDHermesProd-send_O__table_n1j_g1c_23c} {#MIDHermesProd-send_O__table_o1j_g1c_23c__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 | 이 메서드는 값을 반환하지 않습니다. 메시지 배달은 비동기식입니다. 성공: 메시지가 Kafka 브로커에 Hermes 비동기적으로 전달됩니다. 배송 확인 로그를 확인합니다 MID 서버 . 실패: 메시지 전달에 실패하면 오류 상세 정보와 함께 선택적 콜백 함수(제공된 경우)가 호출됩니다. 일반적인 오류는 다음과 같습니다. * `org.apache.kafka.common.errors.TimeoutException`: Kafka 브로커에 연결할 수 없거나 네트워크 문제가 있습니다. 부트스트랩 주소 및 포트에 대한 방화벽 규칙을 Hermes 확인합니다. * `com.service_now.mid.hermes_api.exception.MIDHermesAPIExtensionNotStartedException`: 확장이 시작되지 않았습니다. MID Hermes API 확장 컨텍스트가 활성 상태인지 확인합니다. * `java.lang.IllegalArgumentException`: 잘못된 매개변수입니다. 주제와 메시지가 제공되었는지 확인합니다. {#MIDHermesProd-send_O__ul_tdc_1x5_33c} 오류를 해결하기 위한 추가 단계: * MID Hermes API 확장이 UI에서 MID 서버 실행 중인지 검증합니다. * Hermes에 대한 네트워크 연결을 확인합니다. * 자세한 진단을 위해 속성 mid.hermes.debug=true 이 있는 로그를 검토 MID 서버 합니다. * 키 스토어에서 MID 서버 IPKI 인증서가 유효한지 확인합니다. {#MIDHermesProd-send_O__ul_xx4_ky5_33c} |
[표 3. 반환]

{#MIDHermesProd-send_O__table_o1j_g1c_23c}  
이 예시에서는 주제에 Hermes 메시지를 보냅니다.

    // Create producer instance 
    var producer = new MIDHermesProducer(); 

    // Define error callback function 
    var errorCallback = function(errorMessage, errorType) {
        gs.error("Message delivery failed: " + errorType + " - " + errorMessage);
    }; 

    // Send message with all optional parameters 
    producer.send({ 
        topic: "order-events", 
        applicationId: "sn_streamconnect", 
        message: JSON.stringify({ 
            orderId: "ORD-12345", 
            status: "completed", 
            timestamp: new Date().getTime() 
        }), 
        key: "customer-456", 
        headers: { 
            "content-type": "application/json", 
            "source": "mid-server", 
            "version": "1.0" 
        }, 
        onErrorCallback: errorCallback 
    });

메시지는 비동기적으로 전송됩니다. 배송 확인 로그를 확인합니다 MID 서버 .