구문 분석 규칙 생성

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

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

    시작하기 전에

    필요한 역할: activity_admin, activity_creator

    이 태스크 정보

    프로시저

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

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

    5. 테이블의 필드를 사용하여 양식을 작성합니다.
      이 예시에서 선택한 구문 분석 유형은 XML이며, 이를 통해 페이로드에서 구문 분석할 특정 매개변수를 선택할 수 있습니다.
      구문 분석 규칙 양식
      표 1. 구문 분석 규칙 필드
      필드 설명
      구문 분석 소스 대상 호스트 또는 엔드포인트에서 반환된 데이터의 소스입니다. 각 템플릿은 특정한 기본 페이로드에 대해 열립니다. 활동에 대해 선택한 실행 템플릿에 따라 선택 가능한 선택 항목이 달라집니다. 구문 분석 규칙이 이전에 정의된 경우 지역 변수를 구문 분석 소스로 사용할 수도 있습니다. 각 템플릿에 사용 가능한 페이로드 목록은 문서를 활동 디자이너 구문 분석 소스참조하십시오.
      표현식 선택한 구문 분석 소스에서 특정 데이터를 추출하는 데 사용되는 표현식입니다. 이 표현식은 샘플 페이로드의 클릭 가능한 데이터 에서 생성되며 구문 분석 유형 필드에서 선택한 형식으로 나타납니다. 테스트할 때 표현식에서 여러 결과를 반환할 수 있습니다. 표현식을 선택하기 전에 어떤 선택이 신뢰할 수 있거나 예측 가능한 결과를 제공하는지 분별하십시오.
      주:
      시스템은 샘플 데이터에서 클릭 가능한 정규 표현식 을 생성할 수 없습니다. 모든 정규 표현식을 수동으로 작성해야 합니다.
      변수 이름 최종 출력 표현식에 사용되는 변수 이름을 수정했습니다. 시스템은 activityOutput 또는 activityLocal 접두사를 지정한 변수에 추가합니다.
      구문 분석 유형 대상 호스트의 페이로드를 쿼리하는 데 사용할 언어입니다. 선택 항목은 다음과 같습니다.
      • 직접: 구문 분석 없이 소스 구문 분석 필드에서 선택한 페이로드의 전체 컨텐츠에 매핑합니다. 기본 구문 분석 유형입니다.
      • XML: XML 페이로드에서 노드를 선택하는 데 사용되는 XPath 쿼리입니다.
      • JSON: JSON 페이로드의 일부를 선택하기 위한 JSONPath 쿼리입니다.
      • RegEx: 페이로드에서 데이터를 추출하기 위해 정규식을 사용하는 구문 분석 메서드입니다. RegEx 구문 분석 유형은 여러 줄 구문 분석을 지원하지 않으며 대/소문자를 구분하지 않습니다.
      간단한 설명 이 구문 분석 규칙에 대한 간략한 설명입니다.
      샘플 페이로드 데이터 요청된 데이터를 포함하는 소스의 샘플 데이터입니다. 이 필드는 직접 구문 분석 유형에 사용할 수 없습니다. 샘플 데이터 구문 분석을 클릭하면 이 필드의 데이터를 편집할 수 없지만 식을 만들 수 있도록 클릭할 수 있습니다. Edit sample data(샘플 데이터 편집)를 클릭하여 필드를 다시 편집할 수 있도록 합니다.
      구문 분석 결과 선택한 표현식에 의해 소스에서 반환된 데이터를 표시합니다. 이 필드는 직접 구문 분석 유형에 사용할 수 없습니다.
    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.hresult
    • 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의 type 속성이 있는 IP 주소입니다. 표현식( Expression ) 필드에 이 선택 항목이 채워집니다.

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

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

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

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

      완료된 구문 분석 규칙 목록