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

아티클
07/21/2023

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

프로시저

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

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

그룹 허브 페이지의 추적 쿼리와 이벤트 뷰어는 배포된 구성 요소에서의 메시지 처리 실패에 대한 유용한 정보를 제공합니다. 이 정보로 문제 원인의 범위를 좁힐 수 있습니다. 사용자 지정 파이프라인에서 문제가 발생한 경우 소스 수준 디버깅을 사용하여 문제가 있는 코드를 식별할 수 있습니다.

Visual Studio를 사용하여 배포된 사용자 지정 파이프라인을 디버깅하려면

사용자 지정 파이프라인 프로젝트 솔루션을 Visual Studio에 로드합니다.
솔루션의 출력 경로를 설치 폴더>\파이프라인 구성 요소로< 변경합니다. 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭하고 빌드 탭을 클릭한 다음 찾아보기 단추를 클릭하고 설치 폴더>\파이프라인 구성 요소 디렉터리를 선택하여< 출력 경로를 변경합니다.
Visual Studio 내에서 배포 빌드 | 를 클릭하여 솔루션을배포합니다.
파이프라인을 실행하는 호스트 인스턴스를 다시 시작합니다. BizTalk Server 관리 콘솔을 사용하여 파이프라인을 실행하는 호스트 instance 이동하고 호스트 instance 마우스 오른쪽 단추로 클릭한 다음 다시 시작을 클릭합니다.
Visual Studio 디버거를 연결하여 BTSNTSVC.exe. 이 작업은 프로세스에 디버그 | 연결을 클릭하고 모든 세션에서 프로세스 표시를 클릭한 다음 BTSNTSVC.exe 두 번 클릭하여 수행할 수 있습니다.
중단점을 설정합니다.
메시지를 적절한 위치에 넣고 사용자 지정 파이프라인 구성 요소를 초기화합니다. 처리는 설정한 중단점에서 중단되어야 합니다.

참고

코드에서 예외를 throw하면 BizTalk Server는 이를 catch하고 결과적으로 메시지를 일시 중단합니다. 이러한 동작을 방지하려면 첫 번째 예외가 발생할 때 중단해야 합니다.

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

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

참고

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

Pipeline.exe 및 Visual Studio를 사용하여 사용자 지정 파이프라인을 디버깅하려면

사용자 지정 파이프라인 프로젝트 솔루션을 Visual Studio에 로드합니다.
솔루션의 출력 경로를 설치 폴더>\파이프라인 구성 요소로< 변경합니다. 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭하고 빌드 탭을 클릭한 다음 찾아보기 단추를 클릭하고 설치 폴더>\파이프라인 구성 요소 디렉터리를 선택하여< 출력 경로를 변경합니다.
솔루션의 시작 작업을 변경합니다. 솔루션 탐색기 프로젝트를 마우스 오른쪽 단추로 클릭하고 디버그 탭을 클릭하고 외부 프로그램 시작을 클릭한 다음 ... 을 클릭한 다음 설치 폴더>\SDK\Utilities\PipelineTools로< 이동하여 Pipeline.exe 선택합니다. 시작 옵션에서 구성 요소에 적합한 명령줄 인수를 입력합니다. Pipeline.exe 대한 자세한 내용은 파이프라인 도구를 참조하세요. 파이프라인 및 샘플 파일을 지정하는 일반적인 구성은 다음과 같습니다.
```
<Path>\YourPipeline.btp -d <Path>\YourTestFile.txt -c  
```
중단점을 설정합니다.
F5를 눌러 디버깅을 시작합니다.

참고 항목

파이프라인 도구

다음을 통해 공유