AS2 over File(BizTalk Server 샘플)

아티클
07/21/2023

AS2 Over File 샘플은 FILE 수신 위치를 통해 AS2 메시지를 받는 방법을 보여 줍니다. 이 샘플을 사용하면 일반적으로 사용되는 HTTP 어댑터 대신 파일 어댑터를 사용하여 AS2 메시지를 받을 수 있습니다. 이를 위해 이 솔루션은 AS2 디코더에 필요한 대로 AS2 메시지의 HTTP 헤더를 InboundHTTPHeaders 컨텍스트 속성에 씁니다.

이 샘플의 용도

이 샘플은 HTTP 어댑터 없이 AS2 메시지의 HTTP 헤더를 처리하는 방법을 보여 줍니다. 특히 이 샘플은 다음 작업을 수행합니다.

테스트 메시지를 입력 폴더에 넣으면 FILE 수신 위치에서 해당 메시지를 선택합니다.
사용자 지정 AS2 수신 파이프라인의 사용자 지정 파이프라인 구성 요소가 InboundHTTPHeaders 컨텍스트 속성에 HTTP 헤더를 기록하여 메시지를 처리합니다.

참고

메시지 처리 시 사용자 지정 파이프라인 구성 요소의 다운스트림에 실패한 경우 메시지 처리를 다시 시작하기 어려울 수 있습니다. 메시지가 XML 인코딩으로 이미 변환되었기 때문입니다.
사용자 지정 파이프라인의 AS2 디코더가 InboundHTTPHeaders 컨텍스트 속성에서 속성을 읽어 메시지를 처리합니다.
송신 포트가 수신 파이프라인에서 생성한 XML 메시지에 등록하고 통과 송신 파이프라인을 통해 메시지를 전달한 다음 입력 폴더에 메시지를 넣습니다.

이 샘플이 있는 위치

이 샘플은 BizTalk Server 설치 폴더 \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 over File에 있습니다.

다음 표는 이 샘플의 파일을 보여 주고 각각의 용도에 대해 설명합니다.

파일	Description
AS2OverFile.csproj	사용자 지정 파이프라인 구성 요소 코드가 포함된 프로젝트입니다.
AS2OverFile.sln	AS2OverFile.btproj 프로젝트가 포함된 솔루션입니다.
Program.cs	헤더 데이터를 나타내는 클래스를 포함합니다.
SampleMessage.txt	HTTP 헤더가 포함된 샘플 메시지입니다.

이 샘플의 구현 및 실행

AS2 Over File 샘플을 구현하려면 다음을 수행해야 합니다.

사용자 지정 파이프라인 구성 요소를 만들어 이 샘플에 대한 BizTalk 프로젝트를 빌드 및 배포합니다.
사용자 지정 파이프라인 구성 요소를 사용하여 사용자 지정 파이프라인을 만들고 이 사용자 지정 파이프라인이 포함된 프로젝트를 빌드 및 배포합니다.
입력 및 출력 파일 폴더를 만듭니다.
수신 포트와 수신 위치를 구성하고 수신 위치를 사용하도록 설정합니다.
송신 포트를 구성하고 시작합니다.
샘플 메시지를 보낼 파티를 만듭니다.

AS2 Over File 에뮬레이터 파이프라인 구성 요소가 포함된 사용자 지정 파이프라인을 빌드하려면

Visual Studio에서 \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2\AS2 Over File 폴더에서 AS2OverFile 프로젝트를 엽니다.
강력한 이름 키 파일을 만든 후 AS2OverFile 프로젝트에 대한 속성 대화 상자를 열고 프로젝트에 해당 키 파일을 할당합니다.
프로젝트를 빌드합니다.
Visual Studio에서 AS2OverFile_Pipeline 라는 새 BizTalk 프로젝트를 만듭니다.
AS2OverFile_Pipeline 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 새 항목을 클릭합니다.
새 항목 추가 대화 상자의 왼쪽 창에서 파이프라인 파일을 선택하고 오른쪽 창에서 수신 파이프라인을 선택하고 파이프라인 이름을 AS2OverFile_Receive.btp로 지정한 다음 추가를 클릭합니다.
메뉴 모음에서 보기를 클릭한 다음 도구 상자를 클릭하여 도구 상자를 표시합니다.
도구 상자에서 BizTalk 파이프라인 구성 요소를 마우스 오른쪽 단추로 클릭한 다음 항목 선택을 클릭합니다.
도구 상자 항목 선택 대화 상자에서 BizTalk 파이프라인 구성 요소 탭을 클릭합니다. AS2 Over File Emulator를 클릭한 다음 확인을 클릭합니다.
Visual Studio 명령 프롬프트를 열고 \AS2 Over File\obj\Debug 폴더의 Microsoft.BizTalk.Sdk.Components.AS2OverFile.dll 명령을 gacutil /if "<file name and path>" 실행하여 AS2OverFile.dll 파일을 전역 어셈블리 캐시에 추가합니다.
Visual Studio에서 AS2 Over File Emulator 파이프라인 구성 요소를 도구 상자에서 사용자 지정 파이프라인의 디코딩 단계로 끌어옵니다.
AS2 디코더 구성 요소를 AS2 Over File 구성 요소 다음에 있는 사용자 지정 파이프라인의 디코딩 단계로 끌어옵니다.

참고

MDN을 생성하려면 사용자 지정 파이프라인 구성 요소의 디스어셈블 단계에 AS2 디스어셈블러를 추가합니다. MDN을 반환하지 않을 경우에는 AS2 디스어셈블러가 필요하지 않습니다.
강력한 이름 키 파일을 만든 후 AS2OverFile_Pipeline 프로젝트에 대한 속성 대화 상자를 열고 프로젝트에 해당 키 파일을 할당합니다.
사용자 지정 파이프라인을 빌드 및 배포합니다.
BizTalk Server 관리 콘솔에서 파이프라인 노드를 클릭한 다음 새로 고침을 클릭하여 파이프라인 노드에 사용자 지정 파이프라인을 추가합니다.

이 샘플의 솔루션을 구현하려면

Windows Explorer \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File 폴더에서 In 입력 폴더와 Out 출력 폴더를 만듭니다.

BizTalk Server 관리 콘솔에서 AS2OverFile_Receive 라는 단방향 수신 포트를 만듭니다. 그런 다음 이 수신 포트에서 다음과 같은 속성을 가진 수신 위치를 만듭니다.

속성	설정
이름	AS2OverFile_Receive
형식	FILE
수신 폴더	\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 over file/In
파일 마스크	*.txt
수신 파이프라인	AS2OverFile

수신 위치 노드에서 AS2OverFile_Receive 수신 위치를 마우스 오른쪽 단추로 클릭한 다음 사용을 클릭합니다.

송신 포트 노드에서 다음과 같은 속성을 가진 정적 단방향 송신 포트를 만듭니다.

속성	설정
이름	AS2OverFile_Send
형식	FILE
수신 폴더	\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 over File/Out
파일 마스크	%MessageID%.xml
송신 파이프라인	Passthru
필터	BTS.REceivePortName == AS2OverFile_Receive

송신 포트 노드에서 AS2OverFile_Send 송신 포트를 마우스 오른쪽 단추로 클릭한 다음 시작을 클릭합니다.
파티 노드에서 "파트너"라는 파티를 만듭니다. 별칭 목록에 EDIINT-AS2 From Value, AS2-From의 한정자 및 파트너 값의 이름을 가진 별칭을 추가합니다.

이제 BizTalk Server에서 이 샘플을 사용할 준비가 완료되었습니다.

이 샘플 실행

다음 절차를 사용하여 AS2 Over File 샘플을 실행할 수 있습니다.

이 샘플을 실행하려면

\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File 폴더의 SampleMessage.txt 파일을 \AS2 Over File\In 폴더에 복사합니다.
출력 XML 메시지가 \AS2 Over File\Out 출력 폴더에 들어 있는지 확인합니다.
텍스트 편집기에서 입력 메시지 SampleMessage.txt 열고 텍스트 편집기에서 출력 메시지 <GUID>.xml 엽니다. SampleMessage.txt 입력 메시지에는 HTTP(및 AS2) 헤더가 있고, 출력 메시지에는 HTTP 헤더가 없는지 확인합니다.

이 샘플에서 사용된 클래스 또는 메서드

None

참고 항목

EDI 및 AS2(BizTalk Server 샘플 폴더)
FILE 송신 포트를 통해 AS2 메시지 보내기

다음을 통해 공유