다음을 통해 공유


사용자 지정 파이프라인 디버깅

사용자 지정 파이프라인에서 메시지 처리가 실패하면 원본 수준 디버깅을 사용하여 문제를 식별하고 수정할 수 있습니다. 원본 수준 디버깅은 BTSNTSVC.exe(사용자 지정 파이프라인이 배포된 경우) 또는 Pipeline.exe(독립 실행형 파이프라인 도구를 사용하는 경우)에 연결하여 Visual Studio 디버거를 사용하여 수행됩니다.

절차

다음 절차를 사용하여 사용자 지정 파이프라인을 디버그합니다.

배포된 파이프라인을 디버그하는 방법

그룹 허브 페이지 및 이벤트 뷰어에서 쿼리를 추적하면 배포된 구성 요소의 메시지 처리 실패에 대한 유용한 정보를 제공합니다. 이 정보는 종종 문제의 출처를 좁히는 데 사용할 수 있습니다. 사용자 지정 파이프라인이 연루되면 소스 수준 디버깅을 사용하여 문제가 있는 코드를 식별할 수 있습니다.

Visual Studio를 사용하여 배포된 사용자 지정 파이프라인을 디버그하려면
  1. 사용자 지정 파이프라인 프로젝트 솔루션을 Visual Studio에 로드합니다.

  2. 솔루션의 출력 경로를 설치 폴더>\파이프라인 구성 요소로< 변경합니다. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 빌드 탭을 클릭한 다음 찾아보기 단추를 클릭하고 설치 폴더>\파이프라인 구성 요소 디렉터리를 선택하여< 출력 경로를 변경합니다.

  3. Visual Studio 내에서 빌드 | 배포를 클릭하여 솔루션을배포합니다.

  4. 파이프라인을 실행하는 호스트 인스턴스를 다시 시작합니다. BizTalk Server 관리 콘솔을 사용하여 파이프라인을 실행하는 호스트 인스턴스로 이동하고 호스트 인스턴스를 마우스 오른쪽 단추로 클릭한 다음 다시 시작을 클릭합니다.

  5. Visual Studio 디버거를 BTSNTSVC.exe에 연결하세요. 이 작업은 프로세스연결 디버그 | 를 클릭하고 모든 세션에서 프로세스 표시를 클릭한 다음 BTSNTSVC.exe두 번 클릭하여 수행할 수 있습니다.

  6. 중단점을 설정합니다.

  7. 적절한 위치에 메시지를 놓아 사용자 지정 파이프라인 구성 요소를 시작합니다. 설정한 중단점에서 처리가 중지됩니다.

비고

코드에서 예외를 throw하면 BizTalk Server가 이를 catch하여 그 결과로 메시지를 일시 중단하게 됩니다. 이 동작을 방지하려면 첫 번째 예외를 중단해야 합니다.

Pipeline.exe 사용하여 디버그하는 방법

Pipeline.exe사용하여 사용자 지정 파이프라인을 테스트할 수도 있습니다. 파이프라인을 배포할 필요가 없다는 장점이 있지만, 프로덕션과 유사한 조건에서 실행되지 않는다는 단점이 있습니다.

비고

사용자 지정 파이프라인이 플랫 파일 어셈블러/디스어셈블러를 사용하는 경우 Pipeline.exe 제대로 실행되지 않습니다. Pipeline.exe BizTalk 데이터베이스에 액세스하지 않기 때문입니다. 한 가지 해결 방법은 어셈블러/디스어셈블러 구성 요소를 제거하고 FFDasm.exe 및 FFAsm.exe사용하여 개별적으로 테스트하는 것입니다. 자세한 내용은 파이프라인 도구를 참조하세요.

Pipeline.exe 및 Visual Studio를 사용하여 사용자 지정 파이프라인을 디버그하려면
  1. 사용자 지정 파이프라인 프로젝트 솔루션을 Visual Studio에 로드합니다.

  2. 솔루션의 출력 경로를 설치 폴더>\파이프라인 구성 요소로< 변경합니다. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 빌드 탭을 클릭한 다음 찾아보기 단추를 클릭하고 설치 폴더>\파이프라인 구성 요소 디렉터리를 선택하여< 출력 경로를 변경합니다.

  3. 솔루션의 시작 작업을 변경합니다. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 디버그 탭을 클릭한 다음 외부 프로그램 시작을 클릭한 다음 ...를 클릭하고 설치 폴더>\SDK\Utilities\PipelineTools and choose Pipeline.exe이동합니다<. 시작 옵션에서 구성 요소에 적합한 명령줄 인수를 입력합니다. Pipeline.exe대한 자세한 내용은 파이프라인 도구를 참조하세요. 일반적인 구성은 파이프라인 및 샘플 파일을 지정합니다.

    <Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
    
  4. 중단점을 설정합니다.

  5. F5 키를 눌러 디버깅을 시작합니다.

또한 참조하십시오

파이프라인 도구