289.10. IDoc용 messageECDHE
289.10.1. IDoc 메시지 유형
IDoc Camel SAP 엔드포인트 중 하나를 사용하는 경우 메시지 본문의 유형은 사용 중인 특정 끝점에 따라 달라집니다.
sap-idoc-destination 끝점 또는 sap-qidoc-destination 끝점의 경우 메시지 본문은 Document 유형입니다.
org.fusesource.camel.component.sap.model.idoc.Document
sap-idoclist-destination 끝점의 경우 sap-qidoclist-destination 끝점 또는 sap-idoclist-server 끝점의 경우 메시지 본문은 DocumentList 유형입니다.
org.fusesource.camel.component.sap.model.idoc.DocumentList
289.10.2. IDoc 문서 모델
Camel SAP 구성 요소의 경우 IDoc 문서는 기본 SAP IDoc API에 대한 래퍼 API를 제공하는EMF(Eclipse Modelling Framework)를 사용하여 모델링됩니다. 이 모델의 가장 중요한 유형은 다음과 같습니다.
org.fusesource.camel.component.sap.model.idoc.Document org.fusesource.camel.component.sap.model.idoc.Segment
Document 유형은 IDoc 문서 인스턴스를 나타냅니다. 문서 인터페이스는 다음 방법을 노출합니다.
// Java
package org.fusesource.camel.component.sap.model.idoc;
...
public interface Document extends EObject {
// Access the field values from the IDoc control record
String getArchiveKey();
void setArchiveKey(String value);
String getClient();
void setClient(String value);
...
// Access the IDoc document contents
Segment getRootSegment();
}
Document 인터페이스에서 노출하는 방법은 다음과 같습니다.
- 제어 레코드에 액세스하는 방법
- 대부분의 방법은 IDoc 제어 레코드의 필드 값에 액세스하거나 수정하는 방법입니다. 이러한 메서드는 AttributeName , AttributeName 형식이며 여기서 AttributeName 은 필드 값의 이름입니다( 표 289.2. “IDoc 문서 속성”참조).
- 문서 콘텐츠에 액세스하는 방법
getRootECDHE메서드를 사용하면 문서 내용(IDoc 데이터 레코드)에 액세스할 수 있으며 콘텐츠를 ECDHE 오브젝트로반환합니다. 각 ECDHE 오브젝트는 임의의 수의 하위 세그먼트를 포함할 수 있으며 세그먼트는 임의의 수준에 중첩될 수 있습니다.참고세그먼트 계층 구조의 정확한 레이아웃은 문서의 특정 IDoc 유형으로 정의됩니다. 세그먼트 계층을 생성 (또는 읽기)할 때 IDoc 유형에서 정의한 대로 정확한 구조를 따라야 합니다.
ECDHE 유형은 IDoc 문서의 데이터 레코드에 액세스하는 데 사용되며, 여기서 세그먼트는 문서의 IDoc 유형에 정의된 구조에 따라 다릅니다. 개요에서는 ECDHE 인터페이스 는 다음 방법을 노출합니다.
// Java
package org.fusesource.camel.component.sap.model.idoc;
...
public interface Segment extends EObject, java.util.Map<String, Object> {
// Returns the value of the '<em><b>Parent</b></em>' reference.
Segment getParent();
// Return a immutable list of all child segments
<S extends Segment> EList<S> getChildren();
// Returns a list of child segments of the specified segment type.
<S extends Segment> SegmentList<S> getChildren(String segmentType);
EList<String> getTypes();
Document getDocument();
String getDescription();
String getType();
String getDefinition();
int getHierarchyLevel();
String getIdocType();
String getIdocTypeExtension();
String getSystemRelease();
String getApplicationRelease();
int getNumFields();
long getMaxOccurrence();
long getMinOccurrence();
boolean isMandatory();
boolean isQualified();
int getRecordLength();
<T> T get(Object key, Class<T> type);
}
getgradleren(String segmentType) 방법은 새로운 (nested) 자식을 세그먼트에 추가하는 데 특히 유용합니다. 다음과 같이 정의되는 유형인 ECDHEList 의 오브젝트를 반환합니다.
// Java
package org.fusesource.camel.component.sap.model.idoc;
...
public interface SegmentList<S extends Segment> extends EObject, EList<S> {
S add();
S add(int index);
}
따라서 E1SECDHE_CRE 유형의 데이터 레코드를 만들려면 다음과 같은 Java 코드를 사용할 수 있습니다.
Segment rootSegment = document.getRootSegment();
Segment E1SCU_CRE_Segment = rootSegment.getChildren("E1SCU_CRE").add();289.10.3. IDoc이 Document 오브젝트와 관련된 방법
SAP 문서에 따르면 IDoc 문서는 다음과 같은 주요 부분으로 구성됩니다.
- 제어 레코드
-
자세한 내용은 컨트롤 레코드(IDoc 문서의 메타데이터 포함)는
Documentobject의 속성으로 표시됩니다. 표 289.2. “IDoc 문서 속성” - 데이터 레코드
-
데이터 레코드는
세그먼트의 중첩 계층 구조로 구성된 ECDHE 오브젝트로 표시됩니다.Document.getRootECDHE 메서드를 통해 루트 세그먼트에 액세스할 수 있습니다. - 상태 레코드
-
Camel SAP 구성 요소에서 상태 레코드는 문서 모델로 표시되지 않습니다. 하지만 컨트롤 레코드의 status 특성을 통해 latest
status값에 액세스할 수 있습니다.
289.10.4. 문서 인스턴스 생성 예
예를 들어 예 289.1. “Java에서 IDoc 문서 생성” 은 Java의 IDoc 모델 API를 사용하여 IDoc 유형인 IDoc 문서를 생성하는 방법을 보여줍니다.
예 289.1. Java에서 IDoc 문서 생성
// Java
import org.fusesource.camel.component.sap.model.idoc.Document;
import org.fusesource.camel.component.sap.model.idoc.Segment;
import org.fusesource.camel.component.sap.util.IDocUtil;
import org.fusesource.camel.component.sap.model.idoc.Document;
import org.fusesource.camel.component.sap.model.idoc.DocumentList;
import org.fusesource.camel.component.sap.model.idoc.IdocFactory;
import org.fusesource.camel.component.sap.model.idoc.IdocPackage;
import org.fusesource.camel.component.sap.model.idoc.Segment;
import org.fusesource.camel.component.sap.model.idoc.SegmentChildren;
...
//
// Create a new IDoc instance using the modelling classes
//
// Get the SAP Endpoint bean from the Camel context.
// In this example, it's a 'sap-idoc-destination' endpoint.
SapTransactionalIDocDestinationEndpoint endpoint =
exchange.getContext().getEndpoint(
"bean:SapEndpointBeanID",
SapTransactionalIDocDestinationEndpoint.class
);
// The endpoint automatically populates some required control record attributes
Document document = endpoint.createDocument()
// Initialize additional control record attributes
document.setMessageType("FLCUSTOMER_CREATEFROMDATA");
document.setRecipientPartnerNumber("QUICKCLNT");
document.setRecipientPartnerType("LS");
document.setSenderPartnerNumber("QUICKSTART");
document.setSenderPartnerType("LS");
Segment rootSegment = document.getRootSegment();
Segment E1SCU_CRE_Segment = rootSegment.getChildren("E1SCU_CRE").add();
Segment E1BPSCUNEW_Segment = E1SCU_CRE_Segment.getChildren("E1BPSCUNEW").add();
E1BPSCUNEW_Segment.put("CUSTNAME", "Fred Flintstone");
E1BPSCUNEW_Segment.put("FORM", "Mr.");
E1BPSCUNEW_Segment.put("STREET", "123 Rubble Lane");
E1BPSCUNEW_Segment.put("POSTCODE", "01234");
E1BPSCUNEW_Segment.put("CITY", "Bedrock");
E1BPSCUNEW_Segment.put("COUNTR", "US");
E1BPSCUNEW_Segment.put("PHONE", "800-555-1212");
E1BPSCUNEW_Segment.put("EMAIL", "fred@bedrock.com");
E1BPSCUNEW_Segment.put("CUSTTYPE", "P");
E1BPSCUNEW_Segment.put("DISCOUNT", "005");
E1BPSCUNEW_Segment.put("LANGU", "E");289.10.5. 문서 속성
표 289.2. “IDoc 문서 속성” Document 개체에 설정할 수 있는 컨트롤 레코드 특성을 표시합니다.
표 289.2. IDoc 문서 속성
| 속성 | 길이 | SAP Field | 설명 |
|---|---|---|---|
|
| 70 |
| EDI 아카이브 키 |
|
| 3 |
| 클라이언트 |
|
| 8 |
| IDoc 작성 날짜 |
|
| 6 |
| Time IDoc 생성 |
|
| 1 |
| direction |
|
| 14 |
| 메시지 참조 |
|
| 14 |
| 메시지 그룹에 대한 참조 |
|
| 6 |
| EDI 메시지 유형 |
|
| 1 |
| EDI 표준 |
|
| 6 |
| EDI 표준 버전 |
|
| 14 |
| 상호 교환 파일 참조 |
|
| 8 |
| IDoc 유형 |
|
| 16 |
| IDoc 번호 |
|
| 4 |
| SAP 릴리스 of IDoc |
|
| 30 |
| 기본 IDoc 유형의 이름 |
|
| 30 |
| 확장 유형의 이름 |
|
| 3 |
| 논리 메시지 코드 |
|
| 3 |
| 논리 메시지 함수 |
|
| 30 |
| 논리 메시지 유형 |
|
| 1 |
| 출력 모드 |
|
| 10 |
| 수신자 주소(SADR) |
|
| 70 |
| 수신자의 논리 주소 |
|
| 2 |
| 수신자의 파트너 기능 |
|
| 10 |
| 수신자의 파트너 번호 |
|
| 2 |
| 수신자의 파트너 유형 |
|
| 10 |
| 수신자 포트(SAP 시스템, EDI 하위 시스템) |
|
|
| 보낸 사람 주소 (SADR) | |
|
| 70 |
| 발신자의 논리 주소 |
|
| 2 |
| 발신자의 파트너 기능 |
|
| 10 |
| 발신자의 파트너 번호 |
|
| 2 |
| 발신자의 파트너 유형 |
|
| 10 |
| 보낸 사람 포트 (SAP 시스템, EDI 하위 시스템) |
|
| 20 |
| EDI/ALE: Serialization 필드 |
|
| 2 |
| IDoc 상태 |
|
| 1 |
| 테스트 플래그 |
289.10.6. Java에서 문서 속성 설정
Java에서 제어 레코드 속성을 설정할 때 ( 표 289.2. “IDoc 문서 속성”에서) JavaBean 속성에 대한 일반적인 규칙을 따릅니다. 즉, 속성 값을 가져오고 설정하기 위해 getName 및 setName 메서드를 통해 name 속성에 액세스할 수 있습니다. 예를 들어 iDocType,iDocTypeExtension, messageType 속성은 Document 객체에서 다음과 같이 설정할 수 있습니다.
// Java
document.setIDocType("FLCUSTOMER_CREATEFROMDATA01");
document.setIDocTypeExtension("");
document.setMessageType("FLCUSTOMER_CREATEFROMDATA");289.10.7. XML에서 문서 특성 설정
XML에서 컨트롤 레코드 속성을 설정할 때 idoc:Document 요소에서 특성을 설정해야 합니다. 예를 들어 iDocType,iDocTypeExtension 및 messageType 속성은 다음과 같이 설정할 수 있습니다.
<?xml version="1.0" encoding="ASCII"?>
<idoc:Document ...
iDocType="FLCUSTOMER_CREATEFROMDATA01"
iDocTypeExtension=""
messageType="FLCUSTOMER_CREATEFROMDATA" ... >
...
</idoc:Document>