패턴 작업 사용자 지정

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2026년 01월 10일
  • 읽기3분

    • 검색 패턴의 생성 또는 수정의 일부로 기본 시스템의 일부로 제공되는 기존 사용자 지정 작업을 수정하거나 새로 추가합니다.

    시작하기 전에

    필요한 역할: pd_admin

    Java 스크립팅에 대한 실질적인 지식이 필요합니다.

    이 태스크 정보

    표준 패턴 작업의 경우 입력 매개변수만 정의할 수 있습니다. 그러나 입력 매개변수 외에 작업 자체의 메커니즘과 비즈니스 논리를 정의할 수 있는 사용자 지정 작업도 있습니다. 예를 들어 매개변수를 필수로 지정하거나, 사용할 입력 매개변수를 정의할 수 있습니다.

    다음과 같은 사용자 지정 작업을 사용할 수 있습니다.
    클라우드 REST 호출
    Microsoft Azure 또는 Amazon Web Services 같은 PaaS(서비스형 플랫폼) 유형의 구성 항목에서 정보를 추출합니다. 이 Java 기반 사용자 지정 작업은 기본 시스템의 일부입니다.
    HTTP 가져오기 호출
    HTTP 프로토콜을 사용하는 구성 항목(CI)에서 정보를 추출합니다. 이 사용자 지정 작업은 기본 시스템의 일부입니다.
    클라우드 REST 쿼리
    Microsoft Azure 또는 Amazon Web Services 같은 PaaS(서비스형 플랫폼) 유형의 구성 항목에서 정보를 추출합니다. 이 Java 스크립트 기반의 사용자 지정 작업은 ServiceNow Store에서 패턴 버전 1.0.24 이상을 다운로드한 후에만 사용할 수 있습니다. 클라우드 REST 호출 작업 대신 이 작업을 사용하십시오.

    이러한 사용자 지정 작업 외에도 검색 프로세스의 필요를 충족하는 고유한 작업을 생성할 수 있습니다. 직접 생성한 사용자 지정 작업은 기본 시스템의 일부인 작업과 함께 작업 목록에 나타납니다.

    프로시저

    1. 다음으로 이동 모두 > 패턴 디자이너 > 사용자 지정 운영.
    2. 사용자 지정 작업을 추가하려면 새로 생성을 클릭하십시오.
      또는
    3. 기존 사용자 지정 작업을 수정하려면 테이블에서 해당 이름을 클릭합니다.
    4. 새 사용자 지정 작업의 경우 이름 필드에 새 작업을 설명하는 이름을 입력합니다.
      예를 들어, 이 작업의 목적이 특정 프로토콜을 사용하여 정보를 추출하는 것이라면 NetApp 프로토콜 쿼리라고 이름을 지정할 수 있습니다.
    5. 설명 필드에 작업 목적 또는 설명을 입력하거나 수정합니다.
    6. 스크립트 창에 Java 스크립트를 작성하여 작업의 비즈니스 논리를 정의합니다.
      스크립트는 다음 지침을 따라야 합니다.
      • 변수 이름 앞에 달러 기호를 사용하여 작업 매개변수에 대한 변수를 생성합니다(예: $fileName).
      • CTX는 패턴 실행으로 얻어지는 모든 정보를 포함하는 객체입니다.
      • 사용자 지정 작업의 결과인 문자열을 나타내려면 rtrn을 사용합니다.
      예: 
      ms.info('message from Custom operation MIDLogWrite ' + $logMessage);

      여기서 ms.info는 MID 서버 로그입니다. $logMessage 변수는 이 MID 서버 로그 내에 생성되는 메시지를 참조합니다.

    7. 사용자 지정 작업 매개변수 관련 목록에서 Java 스크립트에 사용한 입력 매개변수를 정의합니다.

      예를 들어, Java 스크립트에서 로그 메시지 파일에 대한 변수를 사용한 경우 이 변수에 대한 매개변수도 정의해야 합니다.


      스크립트에 사용되는 변수에 대한 매개변수를 정의합니다.
      필드 설명
      레이블 매개변수에 대한 짧은 설명이 담긴 레이블을 입력합니다. 표에 레이블이 표시됩니다. 예: netapp_query.
      이름 공백 없이 매개변수에 짧고 분명한 이름(예: NetAppquery)을 입력합니다. 이 이름은 패턴 단계 페이지의 작업 목록에 표시됩니다.
      기본값 해당하는 경우 기본값을 입력합니다. 예: POST.
      필수 이 작업에 대해 이 매개변수가 필수인 경우 True로 설정합니다.

      그렇지 않으면 False로 설정합니다.
      순서 작업 페이지에 매개변수가 표시되는 순서를 정의합니다. 자연수를 사용합니다. 여기서 1은 작업 페이지 상단에 이 매개변수가 표시된다는 뜻입니다.
      도메인 도메인 분리 환경의 경우 이 매개변수에 해당하는 도메인의 이름을 지정합니다.
      확인 정규 표현식 매개변수의 유효성을 검사할 Java 정규식을 지정합니다. 검색 프로세스 중에는 MID 서버가 작업 결과의 유효성을 검사합니다. 패턴 디자이너 모듈은 패턴 단계 페이지에서 테스트를 클릭할 때도 유효성 검사를 실행합니다.