SAP에서 IDOC 작업에 대한 메타데이터 찾아보기, 검색 및 가져오기
이 섹션에서는 어댑터 서비스 참조 플러그 인 추가, 어댑터 메타데이터 추가 마법사 또는 어댑터 서비스 추가 기능 사용을 사용하여 SAP에서 IDOC 작업을 위해 메타데이터를 검색, 검색 및 검색하는 방법에 대한 지침을 제공합니다. 대부분의 지침은 세 가지 사용자 인터페이스 모두에 대해 동일합니다. 해당하는 경우 관련 사용자 인터페이스에 대해 별도의 프로시저가 제공됩니다.
다음 섹션에 제공된 단계를 수행하기 전에 다음이 있어야 합니다.
Visual Studio 프로젝트를 만들었습니다.
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사 또는 어댑터 서비스 참조 플러그 인 추가를 사용하여 SAP 시스템에 연결됩니다. 지침은 VISUAL Studio에서 SAP 시스템에 연결을 참조하세요. SAP 시스템에 연결하여 스키마 또는 WCF 클라이언트를 생성하려면 먼저 특정 바인딩 속성을 설정해야 합니다.
GenerateFlatFileCompatibleIdocSchema
ReceiveIdocFormat
FlatFileSegmentIndicator
이러한 속성은 SAP 시스템에서 IDOC에 대한 메타데이터를 검색하는 방법을 제어합니다. 이러한 속성에 대한 자세한 내용은 MySAP Business Suite 바인딩 속성에 대한 BizTalk Adapter에 대해 읽기를 참조하세요. 바인딩 속성을 설정하는 방법에 대한 지침은 SAP 어댑터에 대한 바인딩 속성 구성을 참조하세요.
SAP 시스템에서IDOC 검색
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사 또는 어댑터 서비스 참조 플러그 인 추가를 사용하여 메타데이터를 검색하는 동안 SAP 어댑터는 SAP 시스템에서 IDOC를 보내고 받기 위한 별도의 작업을 표시합니다.
보내기 및 받기. 어댑터 클라이언트는 이러한 작업을 사용하여 강력한 형식의 스키마를 사용하여 SAP 시스템에서 IOC를 보내고 받을 수 있습니다. 어댑터는 각 IDOC에 대해 이러한 작업을 별도로 표시하며 해당 IDOC 노드에서 사용할 수 있습니다.
SendIdoc 및 ReceiveIdoc. 어댑터 클라이언트는 이러한 작업을 사용하여 약한 형식의 스키마를 사용하여 SAP 시스템에서 IOC를 보내고 받을 수 있습니다. SAP 어댑터는 모든 IOC에 대해 하나의 SendIdoc 및 ReceiveIdoc 작업만 표시합니다. 이러한 작업은 IDOC 노드에서 직접 사용할 수 있습니다.
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사 또는 어댑터 서비스 참조 플러그 인 추가를 사용하여 SAP 시스템의IDOC를 찾아보려면 다음 단계를 수행합니다.
SAP 시스템에서IDOC를 찾아보려면
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사 또는 어댑터 서비스 참조 플러그 인 추가를 사용하여 SAP 서버에 연결합니다. 지침 은 Visual Studio에서 SAP 시스템에 연결을 참조하세요.
계약 유형 선택 드롭다운 목록에서 어댑터를 사용하여 인바운드 또는 아웃바운드 작업을 수행할지 여부에 따라 계약 유형을 선택합니다.
범주 선택 상자에서 IDOC 노드를 클릭하여 사용 가능한 범주 및 작업 상자에 IDOC 메시지 유형을 확인합니다. 또는 IDOC 노드를 확장하여 IDOC 메시지 유형을 볼 수도 있습니다.
팁
포커스가 범주 선택 상자의 트리 뷰에 있는 동안 아티팩트 이름을 입력하여 트리의 "즉시" 범주 노드 또는 하위 범주 노드로 직접 이동합니다. 예를 들어 ACC_BILLING IDOC 메시지 유형으로 이동하려면 IDOC 노드에 포커스를 두고 를 입력합니다
ACC_BILLING.다음 그림에서는 IDOC 메시지 유형을 나열하는 어댑터 서비스 사용 추가 기능을 보여 줍니다. 루트 IDOC 노드는 약한 형식의IDOC를 SAP 시스템에 보내는 SendIdoc 옵션도 표시합니다.
IDOC 에서 참고
인바운드 시나리오의 경우 루트 IDOC 노드는 약한 형식의IDOC를 수신하기 위해 ReceiveIdoc 작업을 표시합니다.
IDOC 메시지 유형을 클릭하여 관련 IDOC 유형을 확인합니다. 다음 그림에서는 IDOC 형식의 특정 IDOC 메시지 형식으로 어댑터 서비스 추가 기능 사용을 보여 줍니다.
IDOC 형식을 클릭하여 IDOC 형식에 대한 다른 버전을 확인합니다. 다음 그림에서는 특정 IDOC 유형에 대한 버전을 사용하여 어댑터 서비스 추가 기능 사용을 보여 줍니다.
의 검색 버전IDOC 형식의 버전을 클릭하여 해당 IDOC 형식에서 지원되는 작업을 확인합니다. 다음 그림에서는 특정 IDOC 유형 버전에 대해 지원되는 작업을 사용하여 어댑터 서비스 추가 기능 사용을 보여 줍니다.
에 대한 검색 작업
SAP 시스템에서IDOC 검색
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사, 어댑터 서비스 참조 플러그 인 추가, SAP 어댑터를 사용하여 SAP 시스템에서 IDOC에 대한 메타데이터를 검색하는 동안:
검색 식에서 와일드카드 문자를 지원합니다.
검색 작업이 수행되는 노드 바로 아래에서 검색을 사용하도록 설정합니다.
다음 표에는 검색에 사용할 수 있는 특수 문자와 SAP 어댑터의 해석이 나와 있습니다.
| 특수 문자 | 해석 |
|---|---|
| +(더하기) | 정확히 하나의 문자와 일치합니다. 예를 들어 A+는 AB, AC, AD와 일치합니다. |
| *(별표) | 0개 이상의 문자와 일치합니다. 예를 들어 A*는 A, AB, ABC와 일치합니다. |
어댑터에서 지원하는 특수 문자에 대한 자세한 내용은 WCF LOB 어댑터 SDK를 사용하여 어댑터 설정을 바인딩 속성으로 노출을 참조하세요.
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사, 어댑터 서비스 참조 플러그 인 추가를 사용하여 SAP 시스템의 IDOC를 검색하려면 다음 단계를 수행합니다.
SAP 시스템에서 IIDOC를 검색하려면
어댑터 서비스 추가 기능 사용, 어댑터 메타데이터 추가 마법사 또는 어댑터 서비스 참조 플러그 인 추가를 사용하여 SAP 서버에 연결합니다. 지침 은 Visual Studio에서 SAP 시스템에 연결을 참조하세요.
계약 유형 선택 드롭다운 목록에서 어댑터를 사용하여 인바운드 또는 아웃바운드 작업을 검색할지 여부에 따라 계약 유형을 선택합니다.
범주 선택 상자에서 IDOC 노드를 클릭합니다.
중요
루트 수준에서만 IDOC를 검색할 수 있습니다.
범주에서 검색 텍스트 상자에 검색 식을 입력하여 특정 IDOC 메시지 유형을 검색합니다. 예를 들어 이름에 "MATMAS"가 있는IDOC를 검색하려면 텍스트 상자에 *MATMAS*를 입력합니다.
오른쪽 화살표 아이콘이 있는 단추를 클릭하여 검색을 시작합니다. 검색이 완료되면 사용 가능한 범주 및 작업 상자에 검색 조건을 충족하는IDOC가 나열됩니다.
다음 그림에서는 IDOC 검색 결과를 나열하는 어댑터 서비스 사용 추가 기능을 보여 줍니다.
검색
BizTalk 프로젝트에 대한 스키마 생성
어댑터 서비스 추가 기능 사용 또는 어댑터 메타데이터 추가 마법사를 사용하여 선택한 SAP 아티팩트에 대한 스키마를 생성할 수 있습니다. 호출하려는 아티팩트가 검색되고 검색되면 해당 아티팩트용 스키마를 생성하고 스키마를 준수하는 메시지를 SAP 시스템에 보낼 수 있습니다.
참고
범주 노드를 선택하여 해당 범주의 하위 트리에 있는 모든 작업을 반환할 수 있습니다. 예를 들어 IDOC 유형을 선택하거나(해당 그룹의 모든 버전의 IDOC에 대한 스키마를 생성하려면) IDOC의 특정 버전을 선택하여 해당 버전의 IDOC에 대해서만 스키마를 생성할 수 있습니다. 노드에 대한 자세한 내용은 메타데이터 노드 ID를 참조하세요.
IDOC에 대한 메타데이터를 검색하려면
어댑터 서비스 추가 기능 사용 또는 어댑터 메타데이터 추가 마법사를 사용하여 SAP 서버에 연결합니다. 지침 은 Visual Studio에서 SAP 시스템에 연결을 참조하세요.
계약 유형 선택 드롭다운 목록에서 어댑터를 사용하여 인바운드 또는 아웃바운드 작업을 수행할지 여부에 따라 계약 유형을 선택합니다.
범주 선택 상자에서 IDOC 메시지 유형 또는 메타데이터를 생성할 IDOC 형식을 클릭합니다.
사용 가능한 범주 및 작업 상자에서 IDOC 유형 또는 메타데이터를 생성할 지원되는 작업을 선택하고 추가를 클릭합니다. 선택한 IDOC 유형 또는 작업이 추가된 범주 및 작업 상자에 나열됩니다.
다음 그림에서는 선택한 IDOC를 나열하는 어댑터 서비스 사용 추가 기능을 보여 줍니다.
IDOC 에 여러 작업에 대한 스키마를 생성하려는 경우 이러한 스키마 중에 BizTalk 프로젝트 컴파일에 실패할 수 있는 중복 요소 정의가 있을 수 있습니다. 예를 들어 작업 "Op1"에 대한 스키마를 생성하는 시나리오를 고려해 보세요. "Op1"의 스키마에는 복합 데이터 형식 "CT1"의 매개 변수가 포함되어 있습니다. "Op1"에 대한 스키마를 생성한 후 어댑터 서비스 사용 추가 기능을 닫고 다시 열어 다른 작업 "Op2"에 대한 스키마를 생성합니다. "Op2"에는 복합 데이터 형식 "CT1"의 매개 변수도 포함되어 있다고 가정합니다. 어댑터 서비스 사용 추가 기능을 종료하고 프로젝트를 컴파일하면 복잡한 데이터 형식 "CT1"이 서로 다른 XSD 파일에서 두 번 정의되므로 컴파일 오류가 발생합니다. 이러한 상황에서는 다음을 권장합니다.
어댑터 서비스 추가 기능 사용을 한 번의 실행으로 모든 작업에 대한 스키마를 생성합니다. 이렇게 하면 어댑터 서비스 사용 추가 기능에서 복잡한 데이터 형식 "CT1"에 대한 정의가 하나만 생성됩니다.
어댑터 서비스 추가 기능 사용의 여러 실행에서 여러 작업에 대한 스키마를 생성하려면 생성된 XSD 파일에 복잡한 데이터 형식 "CT1"에 대한 고유한 네임스페이스가 포함되도록 검사 고유한 스키마 유형 생성 상자를 선택해야 합니다.
확인을 클릭합니다. 스키마 파일은 IDOC 프로젝트와 동일한 위치에 .xsd 확장명으로 저장됩니다.
참고
어댑터 서비스 추가 기능 사용을 사용하는 경우 기본적으로 파일은 생성된 스키마 파일 수에 따라 'n'이 1, 2 등일 수 있는 명명 규칙 "SAPBinding<n.xsd>"로 만들어집니다. 또는 파일 이름 접두 사 텍스트 상자에 이름을 입력하여 스키마 파일에 사용자 지정 이름을 제공할 수 있습니다. 이제 어댑터 서비스 사용 추가 기능은 명명 규칙 <파일 이름 접두사><n.xsd>를 사용하여 스키마 파일을 만듭니다.
참고
또한 어댑터 서비스 사용 추가 기능은 작업에 대한 스키마를 생성하는 동안 지정한 바인딩 속성과 작업을 호출하는 SOAP 작업이 포함된 바인딩 파일(XML 파일)을 만듭니다. BizTalk Server 관리 콘솔에서 이 바인딩 파일을 가져와 연결 URI, 바인딩 속성 및 SOAP 작업 집합이 있는 WCF-Custom 포트를 만들 수 있습니다. 자세한 내용은 SAP에 대한 포트 바인딩 파일을 사용하여 물리적 포트 바인딩 구성을 참조하세요.
파일 메뉴에서 모두 저장을 클릭합니다.
어댑터 서비스 참조 플러그 인 추가를 사용하여 IDOC 작업에 대한 WCF 클라이언트 생성
어댑터 서비스 참조 플러그 인 추가를 사용하여 SAP 시스템에 IDOC를 보내는 WCF 클라이언트 코드 또는 SAP 시스템에서 IDOC를 수신하는 WCF 서비스 계약을 생성할 수 있습니다.
WCF 클라이언트 또는 IDOC에 대한 WCF 서비스 계약을 생성하려면
어댑터 서비스 참조 플러그 인 추가의 계약 유형 선택 드롭다운 목록에서 인바운드(IOC 수신) 또는 아웃바운드(IDOC 전송) 작업을 수행할지 여부에 따라 계약 유형을 선택합니다.
범주 선택 상자에서 IDOC 노드를 확장한 다음 보내거나 받을 IDOC 메시지 유형 또는 IDOC 유형을 찾아보거나 검색합니다.
사용 가능한 범주 및 작업 상자에서 WCF 클라이언트(또는 WCF 서비스 계약)를 생성할 IDOC 유형 또는 지원되는 작업을 선택한 다음 추가를 클릭합니다. 선택한 작업은 추가된 범주 및 작업 상자에 나열됩니다. 사용 가능한 범주 및 작업 상자에 나열된 노드를 선택할 수 있습니다. 범주 노드를 선택하면 해당 노드 및 해당 하위 노드에서 사용할 수 있는 모든 작업이 추가됩니다.
중요
어댑터 서비스 참조 플러그 인 추가는 각 IDOC 유형에 대해 고유한 WCF 클라이언트 클래스(또는 WCF 서비스 계약)를 생성합니다. 선택한 범주 및 작업에 따라 둘 이상의 WCF 클라이언트 클래스가 생성될 수 있습니다. 자세한 내용은 SAP 솔루션 아티팩트용 WCF 클라이언트 또는 WCF 서비스 계약 생성을 참조하세요.
대부분의 시나리오에서는 기본 serialization 옵션으로 충분합니다. 그러나 필요한 경우 생성된 코드와 사용되는 serializer 형식에 대한 여러 측면을 제어할 수 있습니다. 이 옵션을 설정하려면 다음을 수행합니다.
고급 옵션을 클릭하여 고급 옵션 상자를 엽니다.
고급 옵션 상자의 생성된 프록시에 대한 옵션 선택에서 원하는 옵션을 선택합니다. 예를 들어 WCF 클라이언트에 대해 비동기 메서드가 생성되는지 아니면 구성 파일 생성을 사용하지 않도록 설정할지 선택할 수 있습니다.
직렬 변환기에서 사용해야 하는 직렬 변환기를 선택합니다.
다음 그림에서는 기본 선택 항목이 있는 고급 옵션 상자를 보여 줍니다(직렬 변환기에 대해 자동 이 선택되고 다른 옵션은 선택되지 않음).
고급 옵션 상자에서 구성할 수 있는 옵션은 ServiceModel 메타데이터 유틸리티 도구(svcutil.exe)를 사용할 때 사용할 수 있는 옵션 중 일부와 동일합니다. 이러한 옵션에 대한 자세한 내용은 ServiceModel 메타데이터 유틸리티 도구(Svcutil.exe)를 참조하세요.
확인을 클릭합니다. 어댑터 서비스 참조 플러그 인 추가는 프로젝트 디렉터리에서 선택한 작업 및 범주에 대한 WCF 클라이언트 클래스(또는 WCF 서비스 인터페이스) 및 도우미 코드를 저장합니다. 기본적으로 구성 파일도 저장됩니다. 인바운드 및 아웃바운드 작업에 대해 약간 다른 파일이 생성됩니다. 자세한 내용은 SAP 솔루션 아티팩트용 WCF 클라이언트 또는 WCF 서비스 계약 생성을 참조하세요.