다음을 통해 공유

봉투(Envelope) 스키마에서 열거 사용자 지정

  • 아티클

BizTalk Server 서비스(봉투) 스키마에서 ID 필드 열거형을 사용자 지정할 수 있습니다. 이렇게 하면 봉투(Envelope)의 보낸 사람 또는 받는 사람 ID 필드에 비표준 값(X12 표준 본문에 정의된 값 집합이 아닌 값)이 있는 교환을 받거나 보낼 수 있습니다. 또한 규약 속성 정의에 있는 헤더 값에 대한 드롭다운 목록에서 사용할 수 있는 한정자를 변경할 수도 있습니다.

중요

스키마를 수정하면 수정 내용이 해당 표준에 대한 모든 트랜잭션에 적용됩니다. 단일 파티에 대한 봉투(Envelope) 스키마에서는 수정할 수 없습니다.

BizTalk Server 제품과 함께 제공되는 Microsoft.BizTalk.Edi.BaseArtifacts.dll 정적 서비스 스키마에서 허용되는 값 목록을 가져옵니다. 기본 값 집합을 확장하려면 서비스 스키마 확장을 개발하고 배포해야 합니다. BizTalk Server 열거형을 수정하는 데 사용할 수 있는 서비스(봉투) 스키마 템플릿을 제공합니다. 이러한 서비스 스키마는 X12_ServiceSchemaExtension.xsd 및 EDIFACT_ServiceSchemaExtension.xsd입니다. 각 사용자 지정 스키마에는 표준에 따라 다음 네임스페이스 중 하나가 있습니다. 이 네임스페이스는 변경할 수 없습니다.

표준 네임스페이스
X12 및 HIPAA http://schemas.microsoft.com/BizTalk/EDI/X12/2006
EDIFACT http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006

Visual Studio의 BizTalk 편집기에서 스키마를 변경합니다(아래 절차 참조). 필요한 변경을 수행한 후에는 스키마를 배포해야 합니다.

수신 및 송신 쪽에서 BizTalk Server 봉투 세그먼트(X12의 경우 ISA 및 GS 또는 UNB 및 EDIFACT의 경우 UNG)의 유효성을 검사할 때 네임스페이스를 기반으로 사용자 지정 서비스 스키마가 있는지 검사. 사용자 지정 스키마가 배포된 경우 BizTalk Server 해당 스키마를 일반 서비스 스키마와 병합하고 지정된 경우 사용자 지정 및 표준 열거형 값을 모두 사용합니다. 스키마를 사용자 지정하여 열거 목록을 확장할 수 있으나 열거 목록에서 값을 제거할 수는 없습니다. 사용자 지정 스키마가 배포되지 않은 경우 BizTalk Server 표준 서비스 스키마를 사용합니다.

사용자 지정 스키마를 배포한 후 BizTalk Server 관리 콘솔의 TPM(거래 파트너 관리) 사용자 인터페이스는 사용자 지정 열거형의 값을 사용하여 TPM 속성 페이지의 적절한 드롭다운 목록을 채웁니다. 사용자 지정 스키마를 배포하지 않은 경우 TPM은 표준 서비스 스키마의 열거형에 있는 값을 사용합니다. 또한 BizTalk Server 런타임은 사용자 지정 열거형을 사용하여 메시지의 유효성을 검사합니다.

BizTalk Server 제공된 XML 도구를 사용하여 봉투로 instance 유효성을 검사하고 서비스 스키마를 사용자 지정한 경우 문서(트랜잭션 집합) 스키마 및 필요한 경우 일괄 처리 스키마 외에도 BizTalk 프로젝트에 사용자 지정 서비스 스키마를 포함해야 합니다. 봉투(Envelope)가 없는 트랜잭션 집합 인스턴스의 유효성을 검사하는 경우에는 이 작업이 필요하지 않습니다.

필수 구성 요소

BizTalk Server 관리자 그룹의 구성원으로 로그온해야 합니다.

수정할 수 있는 봉투(Envelope) 필드

다음 봉투(Envelope) 필드만 수정할 수 있습니다. 확장 스키마에는 이러한 필드만 포함됩니다. 서비스 확장 스키마에 추가된 기타 필드는 처리에 영향을 주지 않습니다.

표준 필드
X12 및 HIPAA ISA01 – 인증 한정자

ISA03 – 보안 한정자

ISA05 – 보낸 사람 ID 한정자

ISA07 - 받는 사람 ID 한정자

GS01 - 기능 코드

GS07 - 담당 에이전시
EDIFACT UNB2.2 - 보낸 사람 코드 한정자

UNB3.2 - 받는 사람 코드 한정자

수정할 수 없는 봉투(Envelope) 필드

봉투(Envelope)에 있는 일부 필드는 엔진의 동작을 제어합니다. 따라서 기존 열거 목록에 이러한 필드에 대한 값을 추가해서는 안 됩니다. 이러한 필드는 다음과 같습니다.

표준 필드
X12 및 HIPAA ISA11 – 교환 컨트롤 표준 식별자

ISA12 – 교환 컨트롤 버전 번호

ISA14 – 승인 요청
EDIFACT UNB1.1 – 구문 식별자

UNB1.2 – 구문 버전 번호

UNB9 – 승인 요청

봉투(Envelope) 스키마에서 열거를 사용자 지정하려면

  1. Visual Studio에서 새 프로젝트를 만듭니다.

  2. \Program Files (x86)\Microsoft BizTalk Server VERSION>XSD_Schema\EDI에서 X12_ServiceSchemaExtension.xsd 스키마(X12 또는 HIPAA 열거형 수정) 또는 EDIFACT_ServiceSchemaExtension.xsd <스키마를 BizTalk 편집기에서 BizTalk 프로젝트에 추가합니다. 스키마를 엽니다.

  3. 열거형의 값을 변경하려면 속성 창에서 열거형을 선택한 다음 줄임표를 클릭하여 열거형 편집기를 엽니다. 필요에 따라 값 목록에 를 추가하여 값 창의 각 줄에 하나의 값이 있는지 확인합니다. 확인을 클릭합니다.

    중요

    서비스 스키마에 대한 네임스페이스는 변경할 수 없습니다. 스키마에는 제품에 설치된 원본 확장 스키마와 동일한 네임스페이스 및 루트 노드 이름이 있어야 합니다.

    참고

    스키마에 새 필드를 추가하려고 하면 해당 필드는 무시됩니다. 위의 봉투 필드에 나열된 필드만 수정할 수 있습니다.

  4. 스키마를 저장합니다.

  5. 스키마를 마우스 오른쪽 단추로 클릭하고 배포를 클릭합니다.

    참고

    스키마를 현재 BizTalk 그룹에 배포해야 합니다.

참고 항목

EDI 스키마 개발
EDI 스키마 수정