JMS 활동 작성

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분

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

    시작하기 전에

    필요한 역할: activity_creator 또는 workflow_admin

    이 태스크 정보

    JMS 활동은 JMS 클라이언트 애플리케이션이 일반적인 Java EE 패턴으로 작성된 써드파티 JMS 제공자를 지원하며 다음 조작을 지원할 수 있습니다.
    • JNDI를 사용하여 ConnectionFactory 객체 찾기.
    • JNDI를 사용하여 하나 이상의 대상 객체 찾기.
    • ConnectionFactory를 사용하여 JMS 연결 오브젝트 작성.
    • JMS 연결을 사용하여 하나 이상의 JMS 세션 오브젝트 작성.
    • JMS 세션 및 대상을 사용하여 MessageProducer 및 MessageConsumer 오브젝트 작성.
    • 메시지의 전달 또는 소비를 활성화하기 위해 JMS 연결을 시작합니다.
    주:
    JMS 활동 디자이너는 JMS 제공자인 ActiveMQ 및 Tibco EMS를 사용하여 테스트되었습니다. JMS 제공자에 연결할 때는 외부 공급업체 사용자 문서를 참조하십시오.

    프로시저

    1. JMS 자격 증명을 생성하거나 확인합니다.
      JMS 신임 정보에는 대상 데이터베이스에 대한 권한과 해당 JMS 연결에 대한 적절한 구성이 있어야 합니다. JMS 활동을 작성하려면 먼저 신임 정보를 설정해야 합니다.
    2. JMS 연결을 작성하거나 확인합니다.
      JMS 활동을 작성하기 전에 유효한 JMS 신임 정보를 설정하여 JMS 연결을 구성해야 합니다.
    3. 사용자 지정 활동을 생성합니다.
      이 작업은 템플릿을 사용하여 사용자 지정 활동을 작성합니다.
    4. 일반 특성을 설정하고 입력 변수를 작성한 후 JMS 실행 명령을 구성하십시오.
      옵션설명
      자격 증명 구성 데이터베이스 연결에 필요한 필드를 채웁니다.
      연결 팩토리 JMS 연결 팩토리의 이름입니다. JMS 연결을 작성하거나 확인해야 합니다. 이 구성은 초기 컨텍스트 팩토리의 이름을 JMS 제공자의 URL과 링크합니다.
      대상 유형 이 메시지에 사용되는 대상 유형:
      • 큐: 지점 간 통신을 위해 메시지가 큐에 대기됩니다.
        주:
        GET 작업은 큐 대상 유형에 대해서만 지원됩니다.
      • 주제: 메시지는 게시 및 구독 통신에 사용됩니다.
      대상 이름 JMS 제공자에 구성된 큐 또는 토픽 대상의 이름입니다.
      메시지 유형 JMS 메시지 유형 값입니다. 텍스트 메시지 유형만 지원됩니다. 큐 또는 주제 대상은 텍스트 메시지만 받거나 보내도록 구성되어야 합니다. 다른 메시지 유형은 JMS 활동이 처리할 수 없으므로 삭제됩니다.
      운영 대상에서 수행할 프로그래밍 방식의 작업입니다. 선택 항목은 PUT 또는 GET입니다.
      시간 제한(초) 시간이 초과되기 전에 메시지 큐에서 메시지를 기다리는 데 허용된 시간(초)입니다. 기본값은 30입니다.
      사용자 지정 메시지 헤더 JMS 대상에서 사용할 수 있는 이름/값 쌍 형식의 사용자 정의 헤더 값입니다.
      주:
      이는 PUT 작업에만 지원됩니다.
      메시지 페이로드 JMS 대상으로 전송되는 실제 메시지 컨텐츠 또는 페이로드입니다.
      주:
      이는 PUT 작업에만 지원됩니다.
      자격 증명 태그 오케스트레이션 워크플로우의 JMS 활동에 대한 개별 자격 증명에 대한 태그입니다.
      필요한 MID 서버 역량 역량별로 사용할 MID 서버입니다.

    다음에 수행할 작업

    활동에 오케스트레이션 대한 JMS 연결 작성

    사용자 지정 오케스트레이션 JMS 활동과 함께 JMS(Java 메시징 서비스)를 사용하도록 시스템을 구성합니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

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

    프로시저

    1. 다음으로 이동 MID 서버 > JAR 파일.
    2. 새로 만들기 및 추가를 클릭합니다.
      옵션설명
      이름 인스턴스의 파일을 식별하기 위한 고유하고 설명적인 이름입니다.
      버전 파일의 버전 번호(사용 가능한 경우)입니다.
      소스 참조를 위한 JAR 파일의 위치입니다. 시스템에서 소스 정보를 사용하지 않습니다.
      설명 JAR 파일 및 인스턴스에서의 용도에 대한 짧은 설명입니다.
    3. 배너에서 클립 아이콘을 클릭하고 JMS 드라이버 jar 파일을 첨부하십시오.
      JMS 드라이버 jar 파일은 JMS 제공자 설치의 일부로 사용할 수 있어야 합니다. JMS 공급업체는 이를 별도의 제품으로 제공하는 경우가 거의 없습니다. 클라이언트 애플리케이션이 JMS 제공자에 연결해야 하는 JMS 클라이언트 드라이버 JAR 파일을 판별하려면 JMS 제공자 문서를 참조하십시오. 예를 들어, ActiveMQ V5.10(JMS 제공자)에 연결하려는 경우 activemq-all-5.10.1.jar 파일이 필요합니다.
    4. 다음으로 이동 오케스트레이션 > 자격 증명 및 연결 > JMS 연결 팩토리.
    5. 새로 만들기를 클릭하고 다음을 추가한 다음 제출을 클릭합니다.
      옵션설명
      이름 이 연결 팩토리의 고유한 이름입니다.
      초기 컨텍스트 팩토리 InitialContext를 작성하는 데 사용되는 JNDI 클래스의 이름입니다.
      주:
      예를 들어, ActiveMQ V5.10(JMS 제공자)에 연결하려면 이 값은 org.apache.activemq.jndi.ActiveMQInitialContextFactory입니다.
      제공자 URL 실행 중인 JMS 제공자 설치 위치입니다.
      주:
      예를 들어 ActiveMQ V5.1에 연결하려면 다음을 수행합니다. tcp://ipAddressOrHostName:61616.
    6. 다음으로 이동 오케스트레이션 > 자격 증명.
    7. 새로 만들기를 클릭하고 JMS 자격 증명을 선택한 다음 MID가 JMS 제공자와 통신하는 데 사용해야 하는 사용자 이름 및 암호를 제공합니다.
      자세한 정보는 JMS 신임 정보 JMS 신임 정보를 참조하십시오.
    8. 제출을 클릭합니다.
      사용자 정의 JMS 활동을 작성할 준비가 되었습니다.

    JMS 템플릿 실행 매개변수

    실행 매개변수를 사용하여 전처리 양식에서 입력 프로세스 스크립트를 생성합니다.

    executionParam. 프리픽스를 이 테이블의 모든 변수에 사용해야 합니다.
    표 1. JDBC 실행 매개변수
    이름 변수 유형 사용량
    JMS DS jms_ds 참조 선택한 JMS 데이터 소스입니다.
    대상 유형 destination_type 열거됨
    대상 이름 destination_name 문자열
    메시지 유형 message_type 열거됨
    운영 운영 열거됨
    시간 제한 time_out 정수 쿼리가 결과를 반환할 때까지 기다리는 시간입니다.
    사용자 지정 헤더 custom_headers JavaScript 객체의 배열
    메시지 페이로드 message_payload 문자열
    자격 증명 태그 credential_tag 문자열 필수 MID 서버 역량 목록입니다.
    중간 역량 midCapabilities 문자열(쉼표로 구분)
    값 역량 값 역량 해시 맵의 배열 MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 MID 서버 역량을 참조하십시오. 값으로 할당되는 추가 기능이 있는 경우 다음 예를 사용하여 MID 서버 선택을 사용자 지정합니다.
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    JMS 템플릿 후처리 매개변수

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

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