JMS 활동 작성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기6분

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

    시작하기 전에

    필요한 역할: 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 Messaging Service)를 사용하도록 시스템을 구성하십시오.

    시작하기 전에

    필요한 역할: admin

    이 태스크 정보

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

    프로시저

    1. 다음으로 이동 MID 서버 > JAR 파일.
    2. New(새로 만들기)를 클릭하고 추가합니다.
      옵션설명
      이름 인스턴스에서 파일을 식별하기 위한 고유하고 설명적인 이름입니다.
      버전 파일의 버전 번호(사용 가능한 경우)입니다.
      소스 참조를 위한 JAR 파일의 위치입니다. 소스 정보는 시스템에서 사용되지 않습니다.
      설명 JAR 파일 및 인스턴스에서의 용도에 대한 간단한 설명입니다.
    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.
    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 문자열(쉼표로 구분)
    값 역량 valueCapabilities (영문) 해시맵의 배열 MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 MID 서버 기능을 참조하십시오. 값에 의해 할당된 추가 역량이 있는 경우 다음 예를 사용하여 MID 서버 선택을 사용자 지정합니다.
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    JMS 템플리트 후처리 매개변수

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

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