구문 분석 규칙 생성

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

    • 외부 호스트 또는 엔드포인트의 입력 테스트에서 반환된 페이로드 데이터로 사용자 지정 활동에 정의된 출력 변수를 채웁니다.

    시작하기 전에

    필요한 역할: activity_admin, activity_creator

    이 태스크 정보

    프로시저

    1. 다음으로 이동 모두 > 워크플로우 > 워크플로우 편집기.
    2. 팔레트의 사용자 지정 탭에서 사용자 지정 활동을 엽니다.
    3. 활동 디자이너 양식에서 출력 스테이지로 진행합니다.
    4. 데이터 구조 작성기에서 구문 분석 규칙 작성기의 변수 이름 필드로 출력 변수를 끌어다 놓습니다 .
      그림 1. 구문 분석 규칙에 변수 매핑
      구문 분석 규칙에 변수 매핑

      선택한 변수에 대한 구문 분석 규칙 양식이 나타납니다. 기본적으로 구문 분석 유형은 직접 설정되며, 컨텐츠를 구문 분석하지 않고 선택한 페이로드의 모든 데이터로 변수를 채웁니다. 각 템플릿에는 특정 기본 구문 분석 소스가 있습니다.

    5. 테이블의 필드를 사용하여 양식을 작성합니다.
      이 예에서 선택한 구문 분석 유형은 XML이며, 이를 통해 구문 분석할 페이로드의 특정 매개변수를 선택할 수 있습니다.
      구문 분석 규칙 양식
      표 1. 구문 분석 규칙 필드
      필드 설명
      구문 분석 소스 대상 호스트 또는 엔드포인트에서 반환되는 데이터의 소스입니다. 각 템플릿은 특정 기본 페이로드로 열립니다. 사용 가능한 항목은 활동에 대해 선택한 실행 템플릿에 따라 다릅니다. 구문 분석 규칙이 이전에 정의된 경우 지역 변수를 구문 분석 소스로 사용할 수도 있습니다. 각 템플릿에 사용할 수 있는 페이로드 목록은 다음 문서를 참조하십시오 활동 디자이너 구문 분석 소스.
      표현식 선택한 구문 분석 소스에서 특정 데이터를 추출하는 데 사용되는 표현식입니다. 이 표현식은 샘플 페이로드의 클릭 가능한 데이터 에서 생성되며 구문 분석 유형 필드에서 선택한 형식으로 나타납니다. 테스트할 때 식은 여러 결과를 반환할 수 있습니다. 표현식을 선택하기 전에 어떤 선택 항목이 신뢰할 수 있거나 예측 가능한 결과를 제공하는지 식별하십시오.
      주:
      시스템이 샘플 데이터에서 클릭 가능한 정규 표현 식을 생성할 수 없습니다. 모든 정규 표현식을 수동으로 작성해야 합니다.
      변수 이름 최종 출력 표현식에 사용되는 변수 이름을 수정했습니다. 시스템에서 지정한 변수에 activityOutput 또는 activityLocal 프리픽스를 추가합니다.
      구문 분석 유형 대상 호스트의 페이로드를 쿼리하는 데 사용할 언어입니다. 선택 항목은 다음과 같습니다.
      • 직접: 구문 분석 없이 구문 분석 소스 필드에서 선택한 페이로드의 전체 컨텐츠에 매핑합니다. 기본 구문 분석 유형입니다.
      • XML: XML 페이로드에서 노드를 선택하는 데 사용되는 XPath 쿼리입니다.
      • JSON: JSON 페이로드의 일부를 선택하기 위한 JSONPath 쿼리입니다.
      • 정규 표현식: 정규 표현식을 사용하여 페이로드에서 데이터를 추출하는 구문 분석 메서드입니다. RegEx 구문 분석 유형은 여러 줄 구문 분석을 지원하지 않으며 대/소문자를 구분하지 않습니다.
      간단한 설명 이 구문 분석 규칙에 대한 간략한 설명입니다.
      샘플 페이로드 데이터 요청된 데이터를 포함하는 소스의 샘플 데이터입니다. 이 필드는 직접 구문 분석 유형에 사용할 수 없습니다. 샘플 데이터 구문 분석을 클릭하면 이 필드의 데이터를 편집할 수 없지만 표현식을 만들기 위해 클릭할 수 있게 됩니다. 필드를 다시 편집 가능하게 만들려면 샘플 데이터 편집을 클릭하십시오.
      구문 분석 결과 선택한 식으로 소스에서 반환된 데이터를 표시합니다. 이 필드는 직접 구문 분석 유형에 사용할 수 없습니다.
    6. 입력을 다시 테스트하려면 테스트에서 샘플 페이로드 가져오기를 클릭합니다.
      이 작업을 수행하면 테스트 양식이 다시 열리고 다른 테스트 값을 대체하고 다른 페이로드를 생성할 수 있습니다.
    7. 구문 분석 규칙이 이전 페이로드를 방금 생성한 페이로드로 덮어쓰도록 하려면 저장 을 클릭합니다.
    8. 구문 분석 규칙에 대한 표현식을 만들려면 샘플 페이로드에서 보려는 특정 매개변수를 클릭합니다.
      해당 매개변수의 값이 구문 분석 결과 필드에 나타나고 시스템이 표현식 필드에 적절한 표현식을 만듭니다.
    9. 제출을 클릭하여 해당 변수에 대한 구문 분석 규칙을 저장합니다.

    활동 디자이너 구문 분석 소스

    이 테이블에는 각 실행 템플릿에서 사용할 수 있는 구문 분석 소스가 나열되어 있습니다.

    표 2. 소스 구문 분석 중
    템플릿 소스
    SOAP 웹 서비스
    • executionResult.body(기본값)
    • executionResult.status_code
    • executionResult.header
    • executionResult.error
    JDBC
    • executionResult.output(기본값)
    • executionResult.errorMessages
    • executionResult.probeCompletedEccId
    • executionResult.totalRows
    JavaScript 프로브
    • executionResult.payload(기본값)
    • executionResult.output
    • executionResult.eccSysId
    • executionResult.errorMessages
    PowerShell
    • executionResult.output(기본값)
    • executionResult.tags
    • executionResult.h결과
    • executionResult.eccSysId
    • executionResult.errorMessages
    REST 웹 서비스
    • executionResult.body(기본값)
    • executionResult.status_code
    • executionResult.header
    • executionResult.error
    SFTP
    • executionResult.output(기본값)
    • executionResult.eccSysId
    • executionResult.errorMessages
    • executionResult.tags
    프로브
    • executionResult.output(기본값)
    • executionResult.payload
    • executionResult.eccSysId
    SSH
    • executionResult.output(기본값)
    • executionResult.eccSysId
    • executionResult.errorMessages
    • executionResult.tags
    JMS
    • executionResult.status
    • executionResult.standardHeaders
    • executionResult.customHeaders
    • executionResult.messagePayload
    • executionResult.eccSysId
    • executionResult.errorMessages

    활동 디자이너 구문 분석 규칙 예

    이 예에서 구문 분석 규칙은 PowerShell을 사용하여 도메인 서버의 IP 주소 값으로 activityOutput.ipv4 변수를 채우도록 구성됩니다.

    시작하기 전에

    필요한 역할: activity_creator, activity_admin

    이 태스크 정보

    샘플 데이터를 생성하려면 관리자가 실제로 호스트에서 명령을 실행한 다음 구문 분석 규칙을 만들 때 반환된 데이터를 샘플 페이로드 데이터 필드에 붙여넣어야 합니다. 그런 다음 관리자는 해당 샘플의 IP 주소를 ipv4 및 ipv6의 두 가지 형식으로 반환하는 식을 만들 수 있습니다. 이 예에서 시스템은 구문 분석 규칙에 사용할 두 개의 식을 생성합니다.

    프로시저

    1. 다음으로 이동 모두 > 워크플로우 > 워크플로우 편집기 을 클릭하고 호스트에서 실행되는 활동을 엽니다.
    2. 입력 탭을 클릭하고 명령을 기록해 둡니다.
      그림 2. 구문 분석 규칙 PowerShell 입력 명령
      구문 분석 규칙 PowerShell 입력 명령
    3. PowerShell 콘솔에서 호스트 에 명령을 실행 하여 필요한 값이 포함된 XML 샘플을 추출합니다.
    4. 클립보드에 반환된 데이터를 복사합니다.
    5. 활동 디자이너에서 출력 탭을 클릭하고 반환된 데이터를 샘플 페이로드 데이터 필드에 붙여넣습니다.

      이 예에서 데이터에는 두 가지 형식의 IP 주소와 도메인 이름이 포함됩니다.

    6. 소스의 구문 분석 유형을 선택합니다.
      다음 예제에서는 XML을 선택합니다.
      구문 분석 규칙 원시 페이로드 데이터
    7. 샘플 데이터 구문 분석을 클릭합니다.

      시스템이 알맞은 형식으로 XML을 표시하고 클릭 가능하게 됩니다. 이 뷰에서 시스템은 샘플에서 클릭한 데이터를 표현식으로 변환할 수 있습니다.

      구문 분석 규칙 구문 분석된 페이로드 데이터
    8. 표현식을 만들려면 변수에 매핑할 데이터 샘플의 요소를 클릭합니다.

      클릭한 샘플 데이터를 기반으로 시스템은 두 개의 식을 생성합니다.

      구문 분석 규칙 식 생성
    9. 목록에서 표현식을 선택합니다.

      원하는 결과는 유형 속성이 ipv4인 IP 주소입니다. 시스템이 이 선택으로 표현식 필드를 채웁니다.

      구문 분석 규칙 표현식 선택
    10. 테스트 표현식을 클릭합니다.

      시스템은 선택한 식을 사용하여 페이로드를 구문 분석하고 구문 분석 결과 필드에 요청된 데이터를 반환합니다.

      구문 분석 규칙 표현식 테스트
    11. 제출을 클릭합니다.

      뷰가 활동 디자이너의 출력 탭으로 돌아갑니다. 새 구문 분석 규칙이 나열되고 빈 행을 다른 규칙에 사용할 수 있습니다.

      완료된 구문 분석 규칙 목록