호스트 파일용 BizTalk 어댑터 구성

아티클
07/21/2023

개요

호스트 파일용 BizTalk 어댑터는 BizTalk 오케스트레이션이 호스트 시스템과 상호 작용할 수 있도록 하는 송신 및 수신 어댑터입니다. 특히 어댑터는 TCP/IP 및 APPC 연결을 통해 메인프레임 및 IBM i 플랫폼에서 실행되는 파일을 호스트하는 작업을 보내고 받을 수 있습니다. 호스트 통합 서버 기술을 기반으로 어댑터는 데이터 액세스 라이브러리 메타데이터 어셈블리를 사용하여 연결을 구성하고 호스트 파일에 대한 Microsoft .NET Framework 데이터 공급자를 사용하여 SQL 명령 및 저장 프로시저를 실행합니다.

어댑터는 두 가지 기본 기능을 제공합니다.

송신 작업(단방향 및 요청 응답 모두)의 경우 어댑터는 응답을 요청하는 옵션을 사용하여 SQL 명령 및 시스템 명령을 호스트 파일 instance 보냅니다.
수신 작업(단방향만 해당)의 경우 어댑터는 호스트 파일 개체를 폴링하고 행별 메시지를 만드는 SQL 명령을 만든 다음 BizTalk 메시지 시스템에 제출합니다.

또한 호스트 파일용 BizTalk 어댑터는 표준 BizTalk 어댑터 추적 도구를 문제 해결 메커니즘으로 사용합니다.

참고

호스트 파일용 BizTalk 어댑터는 트랜잭션이 아닌 어댑터입니다. 즉, 작업이 수행되면 실행 취소하거나 롤백할 수 없습니다.

메타데이터 어셈블리 만들기

어댑터를 설치한 후 BizTalk Server 원격 시스템을 설명하는 메타데이터 어셈블리를 만들 수 있습니다.

Visual Studio에서 호스트 파일 애플리케이션을 만드는 프로세스의 일부는 호스트 파일 시스템의 레이아웃을 설명하는 것입니다. 이 프로세스는 메타데이터 어셈블리와 스키마를 모두 만듭니다. 메타데이터 어셈블리는 원격 호스트 파일 시스템의 프로그래밍 방식 표현인 반면 스키마는 호스트 파일 시스템의 XML 표현입니다. 메타데이터 어셈블리를 사용하여 BizTalk Server 호스트 파일 시스템을 설명합니다.

Visual Studio에서 호스트 파일 애플리케이션을 만드는 방법에 대한 자세한 내용은 호스트 파일용 관리되는 데이터 공급자를 사용하여 애플리케이션 만들기를 참조하세요.

송신 포트 만들기

BizTalk Server Administrators 그룹의 구성원인 계정으로 로그인합니다.

BizTalk Server 관리에서 BizTalk 그룹을 확장하고 애플리케이션을 확장한 다음 애플리케이션을 선택합니다.
포트 보내기를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 정적 단방향 송신 포트 또는 요청 응답 송신 포트를 선택합니다.

송신 포트 속성에서 전송 유형을호스트 파일로 설정합니다. 구성을 선택하고 다음 속성을 입력합니다.

사용 항목	원하는 작업
연결 문자열	호스트 파일 데이터베이스에 연결하는 데 사용되는 연결 문자열 이름입니다. 새 연결 문자열 또는 기존 연결 문자열 구성하려면 줄임표(...)를 클릭합니다. 그러면 데이터 원본 마법사가 시작됩니다. 도움말에 액세스하려면 마법사 페이지에서 도움말 을 클릭하거나 호스트 통합 서버 도움말을 열고 데이터 원본 마법사(호스트 파일)를 확인합니다.
문서 대상 네임스페이스	호스트로 전송되는 XML 문서에 사용되는 대상 네임스페이스입니다.
응답 루트 요소 이름	호스트에서 받은 XML 문서에 사용되는 루트 요소 이름입니다. 단방향 포트의 경우 이 속성이 비어 있을 수 있습니다.
URI	균일한 리소스 식별자입니다. 송신 포트 위치를 식별하는 이름입니다.

확인을 선택하여 변경 내용을 저장합니다.
송신 처리기의 경우 어댑터를 실행할 호스트 instance 선택하고 송신 파이프라인을 선택합니다.
확인을 선택하여 변경 내용을 저장합니다.
송신 포트에서 새 송신 포트를 마우스 오른쪽 단추로 클릭하고 인리스트먼트를 선택한 다음 시작을 선택합니다.

수신 포트 및 위치 만들기

BizTalk Server Administrators 그룹의 구성원인 계정으로 로그인합니다.

BizTalk Server 관리에서 BizTalk 그룹을 확장하고 애플리케이션을 확장한 다음 애플리케이션을 선택합니다.
수신 포트를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 정적 단방향 수신 포트를 선택합니다. 수신 포트 속성을 구성하고 확인을 선택하여 변경 내용을 저장합니다.
수신 위치를 마우스 오른쪽 단추로 클릭하고 새로 만들기를 선택한 다음 단방향 수신 위치를 선택합니다. 만든 수신 포트를 선택한 다음 확인을 선택합니다.

수신 위치 속성에서 전송 유형을HostFiles로 설정합니다. 구성을 선택하고 다음 속성을 입력합니다.

사용 항목	원하는 작업
연결 문자열	호스트 데이터베이스에 연결하는 데 사용할 연결 문자열 이름을 입력합니다. 새 연결 문자열 또는 기존 연결 문자열 구성하려면 줄임표(...)를 클릭합니다. 그러면 데이터 원본 마법사가 시작됩니다. 도움말에 액세스하려면 마법사 화면에서 도움말 을 클릭하거나 호스트 통합 서버 도움말을 열고 데이터 원본 마법사(호스트 파일)를 확인합니다. 호스트 파일용 BizTalk 어댑터를 기반으로 수신 위치 또는 송신 포트를 구성하는 경우 메타데이터 정의를 레코드 인코딩 및 디코딩을 위한 HIDX(Host Integration Designer XML) 메타데이터 파일로 만들어야 합니다. HIDX 파일을 만드는 방법에 대한 지침은 호스트 파일용 관리되는 데이터 공급자를 사용하여 애플리케이션 만들기를 참조하세요.
문서 루트 요소 이름	호스트에서 받은 XML 문서에 사용되는 루트 요소 이름입니다.
문서 대상 네임스페이스	호스트에서 받은 XML 문서에 사용되는 대상 네임스페이스입니다.
SQL 명령	각 폴링 간격에 대해 한 번 실행되는 Select 명령입니다.
업데이트 명령	수신 작업의 각 행이 처리된 후 실행되는 명령입니다. SQL 명령의 테이블에서 행을 삭제하는 delete 문 또는 하나 이상의 행을 정적으로 수정하는 update 명령일 수 있습니다. 이 옵션을 지정하면 SQL 명령은 Select 문이어야 하며 단일 테이블에 액세스해야 합니다. 줄임표(...) 단추를 클릭하여 추가 속성을 지정할 수 있습니다. 그러면 다음 세 가지 옵션을 제공하는 명령 변경 대화 상자가 열립니다. - 아무것도 하지 않으면 다른 두 옵션이 선택 취소됩니다. - 읽기 후 삭제 는 어댑터가 읽은 후 행을 삭제합니다. - 업데이트 하면 업데이트할 SQL 명령을 입력할 수 있습니다.
URI	균일한 리소스 식별자입니다. 수신 포트 위치를 식별하는 이름입니다.
폴링 간격	폴링 요청 간의 단위 수입니다. 허용되는 범위는 1 - 65535입니다.
폴링 측정 단위	폴링 요청 간에 사용되는 측정 단위(초, 분 또는 시간)입니다. 기본값은 초입니다.

확인을 선택하여 변경 내용을 저장합니다.
수신 처리기의 경우 호스트 instance 선택합니다. 수신 핸들러가 이 호스트에서 실행되고 있어야 합니다. 수신 파이프라인을 선택합니다.
확인을 선택하여 변경 내용을 저장합니다.
수신 위치에서 수신 위치를 마우스 오른쪽 단추로 클릭하고 사용을 선택합니다.

스키마 만들기

호스트 파일 스키마 생성 마법사를 사용하여 호스트 파일용 BizTalk 어댑터에 대한 XSD 스키마를 만듭니다. 스키마를 만든 후에는 BizTalk Server 쪽에서 구성을 계속할 준비가 된 것입니다.

BizTalk Server Visual Studio 프로젝트를 엽니다.
프로젝트를 마우스 오른쪽 단추로 클릭하고 , 추가를 선택하고, 생성된 항목 추가를 선택한 다음, 어댑터 메타데이터 추가를 선택합니다.
어댑터 추가 마법사의 어댑터 선택 페이지에서 호스트 파일을 선택한 다음 , 다음을 선택합니다.
호스트 파일 어댑터 스키마 생성 마법사에서 다음을 수행합니다.
1. 데이터베이스 정보에서 기존 연결 문자열 찾거나 새 연결 문자열 만듭니다.
  
  초기 카탈로그, 패키지 컬렉션(TCP 주소 및 포트) 또는 (APPC 로컬 LU, 원격 LU 및 모드), (사용자 이름 및 암호) 또는 (통합 보안)일 수 있습니다. 최대 길이는 1024입니다.
2. 스키마 정보에서 스키마에서 사용할 기본 네임스페이스, 루트 요소 및 포트 형식을 정의합니다.
  
  수신 포트를 선택하는 경우 요청 문서 루트 요소 이름만 필요합니다. 포트 보내기를 선택하면 요청 및 응답 문서 루트 요소 이름이 필요합니다.
3. 문 형식 정보에서 실행할 데이터베이스 명령의 유형을 선택합니다.
  
  이전 페이지에서 송신 포트를 선택한 경우 updategram, 저장 프로시저 또는 SELECT 문을 실행하도록 선택할 수 있습니다. 수신 포트를 선택한 경우 이 단계는 필요하지 않습니다.
4. 문 정보에 호스트 파일에 대한 세부 정보를 입력합니다. 이전 페이지에서 이전에 입력한 정보에 따라 다음 속성을 입력합니다. 송신 포트를 선택한 경우:
  - Updategram 보내기 송신 포트 및 updategram을 사용하도록 선택한 경우 여기에서 updategram 작업과 updategram에 표시될 테이블 및 열을 선택할 수 있습니다.
  - 시스템 명령 보내기 송신 포트를 사용하고 저장 프로시저를 실행하도록 선택한 경우 현재 연결 카탈로그에서 저장 프로시저를 선택할 수 있습니다. 이 페이지의 모든 매개 변수에 대한 값을 입력할 필요는 없습니다.
  - Select 문 보내기 SQL Select 문과 함께 송신 포트를 사용하도록 선택한 경우 여기에서 문을 선택하거나 찾아볼 수 있습니다.
  수신 포트를 선택한 경우:
  - Select 문 받기 SQL 문과 함께 수신 포트를 사용하도록 선택한 경우 여기에서 문을 선택하거나 찾아볼 수 있습니다.
  - Updategram 보내기 송신 포트 및 updategram을 사용하도록 선택한 경우 여기에서 updategram 작업과 updategram에 표시될 테이블 및 열을 선택할 수 있습니다.
  - 저장 프로시저 보내기 송신 포트를 사용하고 저장 프로시저를 실행하도록 선택한 경우 현재 연결 카탈로그에서 저장 프로시저를 선택할 수 있습니다. 이 페이지의 모든 매개 변수에 대한 값을 입력할 필요는 없습니다.
  - Select 문 보내기 SQL Select 문과 함께 송신 포트를 사용하도록 선택한 경우 여기에서 문을 선택하거나 찾아볼 수 있습니다.
완료되면 마침을 선택합니다.

BizTalk 애플리케이션 만들기

스키마를 만든 후 BizTalk 애플리케이션을 코딩할 수 있습니다. 애플리케이션은 사용자가 만든 스키마 및 포트 외에도 Visual Studio에서 만든 메타데이터 어셈블리를 사용합니다.

Visual Studio에서 BizTalk 프로젝트를 만듭니다.
만든 스키마를 사용하여 BizTalk 애플리케이션에 대한 호스트 파일 시스템을 설명합니다.
만든 송신 포트를 사용하여 호스트 파일 시스템으로 데이터를 보냅니다.
필요한 경우 만든 수신 포트 및 위치를 사용합니다.
필요에 따라 추가 오케스트레이션, 구성 요소 또는 코드를 추가합니다.
애플리케이션을 테스트합니다.
애플리케이션 테스트를 완료한 후 .msi 패키지를 만들어 애플리케이션을 스테이징 또는 라이브 서버로 이동합니다. BizTalk Server .msi 패키지를 만들 때 만든 호스트 파일 메타데이터 어셈블리를 포함해야 합니다.

참고 항목

호스트 파일용 관리되는 데이터 공급자

다음을 통해 공유