--- 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 --- # JavaScript 프로브 활동 생성 # JavaScript 프로브 활동 생성 {#ariaid-title1} * 릴리스 버전: Xanadu * * 업데이트 날짜 2024년 08월 01일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 5분 MID 서버에 서버측 javascript를 실행하도록 지시하는 JavaScript 프로브 활동을 만듭니다. ## 시작하기 전에 필요한 역할: activity_creator 또는 workflow_admin ## 이 태스크 정보 JavascriptProbe 활동은 표준 Java 라이브러리에 대한 '패키지' 호출을 수행하는 것과 동일한 기능을 가지고 있습니다. 이를 통해 MID 서버의 Java 라이브러리를 더 잘 제어할 수 있습니다. MID Server에서 사용자 고유의 JAR 파일을 로드하고 JavascriptProbe가 해당 java 파일로 패키지 호출을 수행하도록 할 수 있습니다. ## 프로시저 1. [사용자 지정 활동을](https://servicenow-prod.fluidtopics.net/ii2G_13mQolEF~CcfYxxyg "사용자 지정 템플릿을 사용하여 워크플로우 편집기에서 다양한 유형의 사용자 지정 활동을 만들고 업데이트할 수 있습니다.") 생성합니다. 이 작업은 템플릿을 사용하여 사용자 지정 활동을 작성합니다. 2. [일반 속성을](https://servicenow-prod.fluidtopics.net/kCnLmf9qL8MFgpTPrKQDyQ "다음 일반 속성 필드는 모든 활동 디자이너 템플릿에 공통적으로 적용됩니다.") 설정하고 [입력 변수를 만든](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#CreateInputVariables "활동 디자이너의 입력 양식에서 활동에 전달할 변수를 만듭니다.") 후 JavaScript 프로브 활동 실행 명령을 구성합니다. | 옵션 | 설명 | | [입력 변수 매핑](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#t_MapAnInputVariable "입력 변수를 생성한 후 명령 실행 양식의 필드에 매핑합니다.") | 만든 변수를 사용하여 MID 서버에서 Orchestration이 실행하는 명령을 구성할 수 있습니다. | | 스크립트 유형 | 포함할 스크립트 유형을 선택합니다. 사용할 수 있는 옵션은 다음과 같습니다. * 사용자 지정 JavaScript * MID Server 스크립트 포함 {#t_CreateAJavaScriptProbeActivity__ul_klf_3tp_vz} | | 스크립트 | 이 프로브와 함께 실행할 사용자 지정 JavaScript 주: 이 필드는 선택한 스크립트 유형 이 사용자 지정 JavaScript인 경우 사용할 수 있습니다. | | MID Server 스크립트 포함 | 이 프로브와 함께 실행할 MID 서버 스크립트입니다. 주: 선택한 스크립트 유형 이 MID 서버 스크립트 포함인 경우 이 필드를 사용할 수 있습니다. | | 호스트로 MID 서버 선택 | 프로브가 실행되는 MID 서버입니다. | | 필요한 MID 서버 역량 | 역량별로 사용할 MID 서버입니다. | | 매개변수 | 이 프로브를 사용하여 호스트에 전달할 이름-값 쌍입니다. 이러한 매개변수를 수동으로 생성하거나 입력 변수를 매개변수 필드로 끌어 값을 할당할 수 있습니다. | |-|-| {#t_CreateAJavaScriptProbeActivity__choicetable_jlf_3tp_vz} 주: 테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑 할 수 있습니다 . [자동 매핑 출력 변수를](https://servicenow-prod.fluidtopics.net/1V~h9Lmkn7Uze8P1bbOKSw "테스트 페이로드의 매개변수 값을 출력 탭의 변수에 자동으로 매핑 할 수 있습니다 .") 참조하십시오. ## 다음에 수행할 작업 [출력 변수 생성](https://servicenow-prod.fluidtopics.net/_deqfM66q1JCmFBYL2dyDg#t_CreateAnOutputVariable "디자이너의 출력 양식에는 개체 및 배열의 데이터 구조를 만들기 위한 변수 작성기가 포함되어 있습니다."), [구문 분석 규칙](https://servicenow-prod.fluidtopics.net/wpFk5f3z63DSYYFUiJ8p1g#t_CreateAParsingRule "사용자 지정 활동에 정의된 출력 변수를 외부 호스트 또는 엔드포인트의 입력 테스트에서 반환된 페이로드 데이터로 채웁니다.") 생성 또는 [조건을](https://servicenow-prod.fluidtopics.net/fUFtgaHwwBOFJnfhP3rJjQ "조건 열에서 활동에 대한 종료 조건을 만들고 각 조건의 순서를 설정합니다.") 생성하여 JavaScript 프로브 활동 생성을 마칩니다. 템플릿 옵션을 알아보려면 [사용자 지정 활동 생성](https://servicenow-prod.fluidtopics.net/ii2G_13mQolEF~CcfYxxyg "사용자 지정 템플릿을 사용하여 워크플로우 편집기에서 다양한 유형의 사용자 지정 활동을 만들고 업데이트할 수 있습니다.") 주제를 참조하십시오. ## JavaScript 프로브 템플릿 실행 매개변수 {#ariaid-title2} 실행 매개변수를 사용하여 활동 디자이너의 전처리 양식에서 입력 프로세스 스크립트를 생성합니다. JavaScript 프로브 명령 필드에 대한 설명은 의 표를 [JavaScript 프로브 실행 명령 구성](https://servicenow-prod.fluidtopics.net/Vtk0ltaHsmJ4F02HZlw0SQ#t_MapJavaScriptVarsToExecutionComm "사용자가 만든 입력 변수를 사용하여 오케스트레이션이 JavaScript 프로브 대상 호스트에서 실행하는 명령을 구성할 수 있습니다.")참조하십시오. 주: 이 테이블의 모든 변수에 `executionParam.` 접두사를 사용해야 합니다. {#r_JvScrPrbTmpltExctnPrmtrs__table_pbn_kh5_cr__entry__4} | 이름 | 변수 | 유형 | 사용법 | |-|-|-|-| | 스크립트 유형 | script_type | 열거 | 실행할 스크립트의 유형입니다. 가능한 유형은 다음과 같습니다. * custom_javascript_typ * mid_script_include_type {#r_JvScrPrbTmpltExctnPrmtrs__ul_o1l_z35_cr} | | 스크립트 | 스크립트 | 문자열 | script_type가 custom_javascript_type될 때 사용자 지정 JavaScript를 실행하는 스크립트입니다. | | MID 스크립트 포함 | mid_script_include | 참조 | script_type가 mid_script_include_type될 때 호출할 MID 서버 스크립트 포함과 연결된 sys_id 참조입니다. | | 소스 | 소스 | 문자열 | 스크립트를 실행할 대상 호스트입니다. | | 미드역량 | midCapabilities | 문자열(쉼표로 구분) | 필요한 MID 서버 역량 목록입니다. | | 매개변수 | 매개변수 | JavaScript 객체의 배열 | `executionParam으로` 표현된 JavaScript 객체의 배열입니다. 접두사입니다. 파라미터 배열에 이름-값 쌍을 더 추가하려면 기존 배열에 추가하십시오. 다음 구문을 사용하여 JavaScript 객체를 만들고 `executionParam.parameter` 배열에 추가합니다. 이렇게 하면 메시지에 추가 매개변수가 할당됩니다. var newParameter = {"name":"parameterName","value":"parameterValue"}; executionParam.parameters.push(newParameter); | | 값 역량 | valueCapabilities (영문) | 해시맵의 배열 | MID 서버를 선택하는 데 사용되는 역량 값입니다. 자세한 내용은 [MID 서버 기능](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=xanadu&pubname=xanadu-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US)을 참조하십시오. 값에 의해 할당된 추가 역량이 있는 경우 다음 예를 사용하여 MID 서버 선택을 사용자 지정합니다. var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); | [표 1. JavaScript 템플릿 실행 매개변수] {#r_JvScrPrbTmpltExctnPrmtrs__table_pbn_kh5_cr} ## JavaScript 프로브 템플릿 후처리 매개변수 {#ariaid-title3} 이러한 매개변수를 사용하여 후처리 스크립트를 생성합니다. {#r_JvScrPrbTmpltPPPrmtrs__table_xlq_3n5_cr__entry__4} | 이름 | 변수 | 유형 | 사용법 | |-|-|-|-| | 페이로드 | 페이로드 | 문자열 | JavaScript 프로브에서 반환된 원시 페이로드를 포함합니다. | | 출력 | 출력 | 문자열 | JavaScript 프로브에서 반환된 출력 데이터를 포함합니다. | | EccSysId (영문) | eccSysId (영문) | 문자열 | ECC 큐 입력 메시지와 관련된 참조 ID를 포함합니다. | | 오류 메시지 | errorMessages | 문자열 | JavaScript 프로브에서 반환된 오류 메시지를 포함합니다. 오류 메시지가 반환되지 않으면 이 값은 null입니다. | [표 2. JavaScript 프로브 후처리 매개변수] {#r_JvScrPrbTmpltPPPrmtrs__table_xlq_3n5_cr} ## JavaScript 프로브 실행 명령 구성 {#ariaid-title4} 사용자가 만든 입력 변수를 사용하여 오케스트레이션이 JavaScript 프로브 대상 호스트에서 실행하는 명령을 구성할 수 있습니다. ### 시작하기 전에 명령 실행 단계로 진행하기 전에 입력 양식에서 필요한 입력 변수를 생성합니다. 필요한 역할: activity_creator, admin 주: 워크플로우 컨텍스트에서 활성화를 실행할 필요 없이 MID Server와 대상 간의 JavaScript 프로브 연결을 테스트할 수 있습니다. 자세한 내용은 [테스트 템플릿 출력을](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#test-template-inputs "워크플로우 컨텍스트에서 활동을 실행할 필요 없이 개발 중에 사용자 지정 활동의 입력 매개변수를 테스트할 수 있습니다.") 참조하십시오. ### 프로시저 1. 입력 목록에서 변수를 끌어 명령 필드에 놓습니다. 시스템은 명령에 적합한 구문으로 변수 형식을 지정합니다. 그림 1. JavaScript 프로브 실행 명령 2. 테이블에 표시된 필드를 모두 채우십시오. {#t_MapJavaScriptVarsToExecutionComm__table_zmv_v25_cr__entry__2} | 필드 | 설명 | |-|-| | 입력 | 입력 변수 작성기입니다. [입력 변수 생성](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#CreateInputVariables "활동 디자이너의 입력 양식에서 활동에 전달할 변수를 만듭니다.") 을 클릭하여 사용 가능한 필드에 [매핑](https://servicenow-prod.fluidtopics.net/rDFI_n8_VB2XOvQRurs~hQ#t_MapAnInputVariable "입력 변수를 생성한 후 명령 실행 양식의 필드에 매핑합니다.") 합니다. | | 스크립트 유형 | 포함할 스크립트 유형을 선택합니다. 사용할 수 있는 옵션은 다음과 같습니다. * 사용자 지정 JavaScript * MID Server 스크립트 포함 {#t_MapJavaScriptVarsToExecutionComm__ul_akw_z25_cr} | | 스크립트 | 이 프로브와 함께 실행할 사용자 지정 JavaScript 이 필드는 선택한 스크립트 유형 이 사용자 지정 JavaScript인 경우 사용할 수 있습니다. | | MID Server 스크립트 포함 | 이 프로브와 함께 실행할 MID 서버 스크립트입니다. 선택한 스크립트 유형 이 MID 서버 스크립트 포함인 경우 이 필드를 사용할 수 있습니다. | | 호스트로 MID 서버 선택 | 프로브가 실행되는 MID 서버입니다. | | 필요한 MID 서버 역량 | 역량별로 사용할 MID 서버입니다. | | 매개변수 | 이 프로브를 사용하여 호스트에 전달할 이름-값 쌍입니다. 이러한 매개변수를 수동으로 생성하거나 입력 변수를 매개변수 필드로 끌어 값을 할당할 수 있습니다. | [표 3. JavaScript 프로브 실행 명령 필드] {#t_MapJavaScriptVarsToExecutionComm__table_zmv_v25_cr} 3. 저장을 클릭합니다. 4. Continue(계속)를 클릭하여 Outputs(출력) 단계로 이동합니다. {#t_MapJavaScriptVarsToExecutionComm__steps_jjb_jrk_r5}