구문 분석 규칙 생성

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기6분

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

    시작하기 전에

    필요한 역할: activity_admin, activity_creator

    이 태스크 정보

    프로시저

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

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

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

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

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

    표 2. 소스 구문 분석 중
    템플릿 소스
    SOAP 웹 서비스
    • executionResult.body(기본값)
    • executionResult.status_code
    • executionResult.header
    • 실행 결과.오류
    JDBC
    • executionResult.output(기본값)
    • 실행 결과.오류 메시지
    • executionResult.probeCompletedEccID
    • executionResult.totalRows
    JavaScript 프로브
    • executionResult.payload(기본값)
    • 실행 결과.출력
    • 실행 결과.eccSysId
    • 실행 결과.오류 메시지
    PowerShell
    • executionResult.output(기본값)
    • executionResult.tags
    • 실행 결과.hresult
    • 실행 결과.eccSysId
    • 실행 결과.오류 메시지
    REST 웹 서비스
    • executionResult.body(기본값)
    • executionResult.status_code
    • executionResult.header
    • 실행 결과.오류
    SFTP
    • executionResult.output(기본값)
    • 실행 결과.eccSysId
    • 실행 결과.오류 메시지
    • executionResult.tags
    프로브
    • executionResult.output(기본값)
    • 실행 결과.페이로드
    • 실행 결과.eccSysId
    SSH
    • executionResult.output(기본값)
    • 실행 결과.eccSysId
    • 실행 결과.오류 메시지
    • executionResult.tags
    JMS
    • 실행 결과.상태
    • executionResult.standardHeaders
    • executionResult.customHeaders
    • executionResult.messagePayload
    • 실행 결과.eccSysId
    • 실행 결과.오류 메시지

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

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

    시작하기 전에

    필요한 역할: activity_creator, activity_admin

    이 태스크 정보

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

    프로시저

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

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

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

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

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

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

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

      원하는 결과는 유형 특성이 ipv4인 IP 주소입니다. 표현식 필드에 이 선택 항목이 입력됩니다.

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

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

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

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

      완료된 구문 분석 규칙 목록