JavaScript 프로브 활동 생성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • MID 서버에 서버측 JavaScript를 실행하도록 지시하는 JavaScript 프로브 활동을 작성합니다.

    시작하기 전에

    필요한 역할: activity_creator 또는 workflow_admin

    이 태스크 정보

    JavascriptProbe 활동은 표준 Java 라이브러리로 '패키지'호출을 수행하는 것과 동일한 기능을 갖습니다. 이를 통해 MID 서버에서 Java 라이브러리를 보다 효과적으로 제어할 수 있습니다. MID 서버에 사용자 고유의 JAR 파일을 로드하고 JavascriptProbe가 해당 Java 파일에 Package를 호출하도록 할 수 있습니다.

    프로시저

    1. 사용자 지정 활동을 생성합니다.
      이 작업은 템플릿을 사용하여 사용자 지정 활동을 생성합니다.
    2. 일반 속성을 설정하고 입력 변수를 생성한 후 JavaScript 프로브 활동 실행 명령을 구성합니다.
      옵션설명
      입력 변수를 매핑합니다. 생성한 변수를 사용하여 오케스트레이션이 MID 서버에서 실행하는 명령을 구성합니다.
      스크립트 유형 포함할 스크립트 유형을 선택합니다. 사용할 수 있는 옵션은 다음과 같습니다.
      • 사용자 지정 JavaScript
      • MID Server 스크립트 포함
      스크립트 이 프로브로 실행할 사용자 지정 JavaScript입니다.
      주:
      이 필드는 선택한 스크립트 유형이사용자 지정 JavaScript인 경우에 사용할 수 있습니다.
      MID Server 스크립트 포함 이 프로브로 실행할 MID 서버의 스크립트입니다.
      주:
      선택한 스크립트 유형이MID 서버 스크립트 포함인 경우 이 필드를 사용할 수 있습니다.
      호스트로 MID 서버 선택 프로브가 실행되는 MID 서버입니다.
      필요한 MID 서버 역량 기능별로 사용할 MID 서버입니다.
      매개변수 이 프로브를 사용하여 호스트에 전달할 이름-값 쌍입니다. 이러한 매개변수를 수동으로 생성하거나 입력 변수를 매개변수 필드로 끌어와 값을 할당할 수 있습니다.
      주:
      테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑할 수 있습니다. 자동 매핑 출력 변수의 내용을 참조하십시오.

    다음에 수행할 작업

    출력 변수를 만들거나구문 분석 규칙을 만들거나조건을 만들어 JavaScript 프로브 활동 만들기를 마칩니다. 템플릿 옵션을 알아보려면 사용자 지정 활동 생성 주제를 참조하십시오.

    JavaScript 프로브 템플릿 실행 매개변수

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

    JavaScript 프로브 명령 필드에 대한 설명은 의 JavaScript 프로브 실행 명령을 구성합니다테이블을 참조하십시오.
    주:
    이 테이블의 모든 변수에 executionParam. 접두사를 사용해야 합니다.
    표 1. JavaScript 템플릿 실행 매개변수
    이름 변수 유형 사용법
    스크립트 유형 script_type 열거 실행할 스크립트의 유형입니다. 가능한 유형은 다음과 같습니다.
    • custom_javascript_typ
    • mid_script_include_type
    스크립트 스크립트 문자열 script_type custom_javascript_type될 때 사용자 지정 JavaScript를 실행하는 스크립트입니다.
    MID 스크립트 포함 mid_script_include 참조 script_type가 mid_script_include_type될 때 호출할 MID 서버 스크립트와 연결된 sys_id 참조입니다.
    소스 소스 문자열 스크립트를 실행할 대상 호스트입니다.
    MID 역량 MID 역량 문자열(쉼표로 구분) 필요한 MID 서버 역량 목록입니다.
    매개변수 parameters JavaScript 객체 배열 executionParam. 접두사로 표현되는 JavaScript 객체의 배열입니다. parameters 배열에 더 많은 이름-값 쌍을 추가하려면 기존 배열에 추가하십시오. 다음 구문을 사용하여 JavaScript 객체를 생성하고 executionParam.parameter 배열에 추가합니다. 이렇게 하면 메시지에 추가 매개변수가 할당됩니다.
    var newParameter = {"name":"parameterName","value":"parameterValue"};
executionParam.parameters.push(newParameter);
    ValueCapabilities 값 역량 해시 맵 배열 MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 MID 서버 기능을 참조하십시오. 값으로 할당된 추가 역량이 있는 경우 다음 예시를 사용하여 MID 서버 선택을 사용자 지정합니다.
    var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'};
executionParam.valueCapabilities.push(valueCapability);

    JavaScript 프로브 템플릿 후처리 매개변수

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

    표 2. JavaScript 프로브 후처리 매개변수
    이름 변수 유형 사용법
    페이로드 페이로드 문자열 JavaScript 프로브에서 반환된 원시 페이로드를 포함합니다.
    출력 출력 문자열 JavaScript 프로브에서 반환된 출력 데이터를 포함합니다.
    EccSysId eccSysId 문자열 ECC 큐 입력 메시지와 연결된 참조 ID를 포함합니다.
    오류 메시지 errorMessages 문자열 JavaScript 프로브에서 반환된 오류 메시지를 포함합니다. 오류 메시지가 반환되지 않는 경우 이 값은 null입니다.

    JavaScript 프로브 실행 명령을 구성합니다

    생성한 입력 변수를 사용하여 오케스트레이션이 JavaScript 프로브 대상 호스트에서 실행하는 명령을 구성합니다.

    시작하기 전에

    명령 실행 단계로 진행하기 전에 입력 양식에 필요한 입력 변수를 생성합니다.

    필요한 역할: activity_creator, admin

    주:
    워크플로우 컨텍스트에서 기능을 실행하지 않고도 MID 서버와 대상 간의 JavaScript 프로브 연결을 테스트할 수 있습니다. 자세한 내용은 테스트 템플릿 출력을 참조하십시오.

    프로시저

    1. 입력 목록에서 변수를 끌어와 명령 필드에 놓습니다.
      시스템은 명령에 적합한 구문으로 변수의 형식을 지정합니다.
      그림 1. JavaScript 프로브 실행 명령
      JavaScript 프로브 실행 명령
    2. 테이블에 표시된 필드를 모두 채우십시오.
      표 3. JavaScript 프로브 실행 명령 필드
      필드 설명
      입력 입력 변수 작성기입니다. 입력 변수 생성 사용 가능한 필드에 매핑 합니다.
      스크립트 유형 포함할 스크립트 유형을 선택합니다. 사용할 수 있는 옵션은 다음과 같습니다.
      • 사용자 지정 JavaScript
      • MID Server 스크립트 포함
      스크립트 이 프로브로 실행할 사용자 지정 JavaScript입니다. 이 필드는 선택한 스크립트 유형이사용자 지정 JavaScript인 경우에 사용할 수 있습니다.
      MID Server 스크립트 포함 이 프로브로 실행할 MID 서버의 스크립트입니다. 선택한 스크립트 유형이MID 서버 스크립트 포함인 경우 이 필드를 사용할 수 있습니다.
      호스트로 MID 서버 선택 프로브가 실행되는 MID 서버입니다.
      필요한 MID 서버 역량 기능별로 사용할 MID 서버입니다.
      매개변수 이 프로브를 사용하여 호스트에 전달할 이름-값 쌍입니다. 이러한 매개변수를 수동으로 생성하거나 입력 변수를 매개변수 필드로 끌어와 값을 할당할 수 있습니다.
    3. 저장을 클릭합니다.
    4. 계속을 클릭하여 출력 단계로 이동합니다.