---
sourceDocument: Xanadu 애플리케이션과의 통합 생성
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 애플리케이션과의 통합 생성

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# JMS 활동 작성

# JMS 활동 작성 {#ariaid-title1}

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

Java 메시징 서비스를 사용하여 외부 시스템으로 메시지를 검색하거나 전송하는 사용자 정의 JMS 활동을 만듭니다.

## 시작하기 전에

필요한 역할: activity_creator 또는 workflow_admin

## 이 태스크 정보

JMS 활동은 JMS 클라이언트 애플리케이션이 일반 Java EE 패턴으로 작성되고 다음 조작을 지원할 수 있는 써드파티 JMS 제공자를 지원합니다.

* JNDI를 사용하여 ConnectionFactory 오브젝트 찾기.
* JNDI를 사용하여 하나 이상의 대상 객체 찾기.
* ConnectionFactory를 사용하여 JMS 연결 오브젝트 작성.
* JMS 연결을 사용하여 하나 이상의 JMS 세션 오브젝트 작성.
* JMS 세션과 대상을 사용하여 MessageProducer 및 MessageConsumer 오브젝트 작성
* 메시지 전달 또는 이용을 가능하게 하기 위해 JMS 연결을 시작합니다.

{#t_CreateAJMSActivity__ul_mgt_1yv_rs}  
주:  
JMS 활동 디자이너는 JMS 제공자 ActiveMQ 및 Tibco EMS로 테스트되었습니다. JMS 제공자에 연결할 때는 써드파티 사용자 문서를 참조하십시오.

## 프로시저

1. [JMS 자격 증명을](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 만들거나 확인합니다.  
   JMS 자격 증명에는 대상 데이터베이스에 대한 권한과 해당 JMS 연결에 대한 적절한 구성이 있어야 합니다. JMS 활동을 작성하려면 먼저 자격 증명을 설정해야 합니다.
2. [JMS 연결을](https://servicenow-prod.fluidtopics.net/HML8D6muHJsiodTNoFI1hQ#t_ConfigureAnInstanceToUseJMS "사용자 정의 오케스트레이션 JMS 활동과 함께 JMS(Java Messaging Service)를 사용하도록 시스템을 구성하십시오.") 만들거나 확인합니다.  
   JMS 활동을 작성하기 전에 설정된 유효한 JMS 자격 증명으로 JMS 연결을 구성해야 합니다.
3. [사용자 지정 활동을](https://servicenow-prod.fluidtopics.net/ii2G_13mQolEF~CcfYxxyg "사용자 지정 템플릿을 사용하여 워크플로우 편집기에서 다양한 유형의 사용자 지정 활동을 만들고 업데이트할 수 있습니다.") 생성합니다.  
   이 작업은 템플릿을 사용하여 사용자 지정 활동을 작성합니다.
4. [일반 속성을](https://servicenow-prod.fluidtopics.net/kCnLmf9qL8MFgpTPrKQDyQ "다음 일반 속성 필드는 모든 활동 디자이너 템플릿에 공통적으로 적용됩니다.") 설정하고 [입력 변수를 만든](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#CreateInputVariables "활동 디자이너의 입력 양식에서 활동에 전달할 변수를 만듭니다.") 후 JMS 실행 명령을 구성합니다.

   | 옵션 | 설명 |
   | 자격 증명 구성 | 데이터베이스 연결에 필요한 필드를 채웁니다. |
   | 연결 팩토리 | JMS 연결 팩토리의 이름입니다. JMS 연결을 만들거나 확인해야 합니다. 이 구성은 초기 컨텍스트 팩토리의 이름을 JMS 제공자의 URL과 연결합니다. |
   | 대상 유형 | 이 메시지에 사용되는 대상 유형: * 큐: 지점 간 통신을 위해 메시지가 큐에 대기됩니다. 주: GET 조작은 큐 대상 유형에 대해서만 지원됩니다. * 주제: 메시지는 게시 및 구독 통신에 사용됩니다. {#t_CreateAJMSActivity__ul_e31_chy_ds} |
   | 대상 이름 | JMS 제공자에 구성된 큐 또는 토픽 대상의 이름입니다. |
   | 메시지 유형 | JMS 메시지 유형 값입니다. 텍스트 메시지 유형만 지원됩니다. 큐 또는 주제 대상은 텍스트 메시지만 받거나 보내도록 구성해야 합니다. 다른 메시지 유형은 JMS 활동이 처리할 수 없으므로 삭제됩니다. |
   | 운영 | 대상에서 수행할 프로그래밍 방식 작업입니다. PUT 또는 GET 중에서 선택할 수 있습니다. |
   | 시간 제한(초) | 시간이 초과되기 전에 메시지 큐에서 메시지를 대기할 수 있는 시간(초)입니다. 기본값은 30입니다. |
   | 사용자 지정 메시지 헤더 | JMS 대상에서 사용할 수 있는 이름/값 쌍 형식의 사용자 정의 헤더 값입니다. 주: 이는 PUT 작업에 대해서만 지원됩니다. |
   | 메시지 페이로드 | JMS 대상으로 전송되는 실제 메시지 컨텐츠 또는 페이로드입니다. 주: 이는 PUT 작업에 대해서만 지원됩니다. |
   | 자격 증명 태그 | 오케스트레이션 워크플로우에서 JMS 활동의 개별 자격 증명에 대한 태그입니다. |
   | 필요한 MID 서버 역량 | 역량별로 사용할 MID 서버입니다. |
   |-|-|

   {#t_CreateAJMSActivity__choicetable_py3_zmj_4y}
{#t_CreateAJMSActivity__steps_jbm_5qy_ds}

## 다음에 수행할 작업

* [자동 매핑](https://servicenow-prod.fluidtopics.net/1V~h9Lmkn7Uze8P1bbOKSw "테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑 할 수 있습니다 .")을 사용하여 출력 및 구문 분석 규칙 작성
* 자동 매핑을 사용하지 않는 경우 [수동으로 출력 변수를 만들고](https://servicenow-prod.fluidtopics.net/_deqfM66q1JCmFBYL2dyDg#t_CreateAnOutputVariable "디자이너의 출력 양식에는 개체 및 배열의 데이터 구조를 만들기 위한 변수 작성기가 포함되어 있습니다.")[구문 분석 규칙을 만들 수 있습니다](https://servicenow-prod.fluidtopics.net/wpFk5f3z63DSYYFUiJ8p1g#t_CreateAParsingRule "사용자 지정 활동에 정의된 출력 변수를 외부 호스트 또는 엔드포인트의 입력 테스트에서 반환된 페이로드 데이터로 채웁니다.")
{#t_CreateAJMSActivity__ul_u45_vbq_xz}

## 활동에 대한 오케스트레이션 JMS 연결 작성 {#ariaid-title2}

사용자 정의 오케스트레이션 JMS 활동과 함께 JMS(Java Messaging Service)를 사용하도록 시스템을 구성하십시오.

### 시작하기 전에

필요한 역할: admin

### 이 태스크 정보

MID 서버에는 조직에 맞는 올바른 JMS 연결 팩토리가 있어야 합니다. 에 mid.property.jms.command.allowed_factory_names 있는 속성에서 해당 값을 구성합니다. MID 서버속성. 이 특성의 기본값은 써드파티 JMS 제공자가 광고하는 임의의 값 또는 쉼표로 구분된 값 목록으로 변경될 수 있습니다.

### 프로시저

1. 다음으로 이동 MID 서버JAR 파일.
2. New(새로 만들기)를 클릭하고 추가합니다.

   | 옵션 | 설명 |
   | 이름 | 인스턴스에서 파일을 식별하기 위한 고유하고 설명적인 이름입니다. |
   | 버전 | 파일의 버전 번호(사용 가능한 경우)입니다. |
   | 소스 | 참조를 위한 JAR 파일의 위치입니다. 소스 정보는 시스템에서 사용되지 않습니다. |
   | 설명 | JAR 파일 및 인스턴스에서의 용도에 대한 간단한 설명입니다. |
   |-|-|

   {#t_ConfigureAnInstanceToUseJMS__choicetable_yqs_2c4_5y}
3. 배너에서 클립 아이콘을 클릭하고 JMS 드라이버 jar 파일을 첨부합니다.  
   JMS 드라이버 jar 파일은 JMS 제공자 설치의 일부로 사용할 수 있어야 합니다. 별도의 제품으로 제공하는 JMS 공급업체는 거의 없습니다. JMS 제공자 문서를 참조하여 클라이언트 애플리케이션이 JMS 제공자에 연결해야 하는 JMS 클라이언트 드라이버 jar 파일을 판별하십시오. 예를 들어 ActiveMQ V5.10(JMS 공급자)에 연결하려는 경우 activemq-all-5.10.1.jar 파일이 필요합니다.
4. 다음으로 이동 오케스트레이션자격 증명 및 연결JMS 연결 팩토리.
5. New(새로 만들기)를 클릭하고 다음을 추가한 다음 Submit(제출)을 클릭합니다.

   | 옵션 | 설명 |
   | 이름 | 이 연결 팩토리의 고유한 이름입니다. |
   | 초기 컨텍스트 팩토리 | InitialContext를 만드는 데 사용되는 JNDI 클래스의 이름입니다. 주: 예를 들어, ActiveMQ V5.10(JMS 제공자)에 연결하기 위한 값은 org.apache.activemq.jndi.ActiveMQInitialContextFactory입니다. |
   | 제공자 URL | 실행 중인 JMS 제공자 설치의 위치입니다. 주: 예를 들어 ActiveMQ V5.1에 연결하려면 다음을 수행합니다. tcp://ipAddressOrHostName:61616. |
   |-|-|

   {#t_ConfigureAnInstanceToUseJMS__choicetable_gqc_pd4_5y}
6. 다음으로 이동 오케스트레이션자격 증명.
7. 새로 만들기를 클릭하고 JMS 자격 증명을 선택한 다음 MID가 JMS 제공자와 통신하는 데 사용해야 하는 사용자 이름 및 암호를 제공합니다.  
   자세한 정보는 [JMS 신임 정보 JMS](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) [신임 정보의](https://www.servicenow.com/docs/access?context=r_JMSCredentialsForm&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US) 내용을 참조하십시오.
8. 제출을 클릭합니다.  
   사용자 정의 JMS 활동을 작성할 준비가 되었습니다.

## JMS 템플릿 실행 매개변수 {#ariaid-title3}

실행 파라미터를 사용하여 전처리 양식에서 입력 프로세스 스크립트를 생성합니다.
이 테이블의 모든 변수에 `executionParam.` 접두사를 사용해야 합니다.{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r__entry__4}

| 이름 | 변수 | 유형 | 사용법 |
|-|-|-|-|
| Jms ds | jms_ds | 참조 | 선택한 JMS 데이터 소스. |
| 대상 유형 | destination_type | 열거 |   |
| 대상 이름 | destination_name | 문자열 |   |
| 메시지 유형 | message_type | 열거 |   |
| 운영 | 운영 | 열거 |   |
| 시간 제한 | time_out | 정수 | 쿼리가 결과를 반환할 때까지 대기하는 시간입니다. |
| 사용자 지정 헤더 | custom_headers | JavaScript 객체의 배열 |   |
| 메시지 페이로드 | message_payload | 문자열 |   |
| 자격 증명 태그 | credential_tag | 문자열 | 필요한 MID 서버 역량 목록입니다. |
| 미드역량 | midCapabilities | 문자열(쉼표로 구분) |   |
| 값 역량 | valueCapabilities (영문) | 해시맵의 배열 | MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 [MID 서버 기능](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform&section=r_MIDServerCapabilities&ft:locale=en-US)을 참조하십시오. 값에 의해 할당된 추가 역량이 있는 경우 다음 예를 사용하여 MID 서버 선택을 사용자 지정합니다. var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); |
[표 1. JDBC 실행 매개변수]

{#r_JMSTemplateExecutionParameters__table_o2p_3q4_4r}

## JMS 템플리트 후처리 매개변수 {#ariaid-title4}

이러한 매개변수를 사용하여 후처리 스크립트를 생성합니다.
{#r_JMSTemplatePostProcessParams__table_grr_t2v_cr__entry__4}

| 이름 | 변수 | 유형 | 사용법 |
|-|-|-|-|
| 상태 | 상태 | 문자열 | JMS 대상의 조작 상태(Put 또는 Get)입니다. |
| 표준 헤더 | standardHeaders | 문자열 | JMS에서 지정한 대로 Get 조작 중에 JMS 메시지의 일부로 확보되는 모든 표준 헤더입니다. 이 필드는 가져오기 작업에만 적용할 수 있습니다. |
| CustomHeaders (사용자 지정 헤더) | customHeaders | 문자열 | 가져오기 조작 중 JMS 메시지의 일부로 가져온 생성자 또는 발행자 애플리케이션에 의해 추가된 모든 사용자 정의 헤더입니다. 이 필드는 가져오기 작업에만 적용할 수 있습니다. |
| 메시지 페이로드 | 메시지 페이로드 | 문자열 | 가져오기 작업 중에 JMS 메시지의 일부로 가져오는 메시지 페이로드입니다. 이 필드는 가져오기 작업에만 적용할 수 있습니다. |
| EccSysID | eccSysID | 문자열 | 활동에서 리턴한 ECC 큐 입력 메시지와 연관된 참조 ID를 포함합니다. |
| 오류 메시지 | errorMessages | 문자열 | JMS 명령에서 검색된 모든 오류 메시지를 포함합니다. 오류 메시지가 없는 경우 이 값은 null 입니다. |
[표 2. JMS 후처리 매개변수]

{#r_JMSTemplatePostProcessParams__table_grr_t2v_cr}