UpdateEx 메서드
입력 키 매개 변수(key1, key2, … keyn)를 기반으로 속성을 업데이트하는 데 사용됩니다. 를 사용하는 UpdateEx
경우 컬렉션의 항목을 삭제할 수 없습니다. 별도의 방법으로 삭제할 수 있습니다. 자세한 내용은 DeleteOnly 메서드를 참조하세요.
UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,
properties)
매개 변수 | Description |
---|---|
key |
서버 데이터베이스에 반드시 있어야 하는 매개 변수의 집합으로, 없을 경우 오류가 발생합니다. 이러한 키는 특정 구성 요소 인터페이스에 대해 정의된 Get Keys 집합에 해당합니다. |
correctionMode |
부울 플래그입니다. TRUE로 설정하면 필드 값을 업데이트하거나 새 항목을 컬렉션에 삽입하여 적용 날짜가 지정된 항목이 있는 구성 요소 인터페이스를 수정할 수 있습니다. 특히 현재 적용 날짜보다 이전 EFFDT를 가진 항목을 수정할 수 있습니다. 이 플래그를 TRUE로 설정하지 않고 이러한 항목을 수정하면 PeopleSoft 서버에서 오류가 반환됩니다. 인수는 correctionMode 유효 날짜가 지정된 항목을 포함하는 구성 요소 인터페이스에 대해서만 노출됩니다. 그렇지 않으면 인수의 일부로 표시되지 않습니다.프로덕션 환경에서는 TRUE로 설정 correctionMode 하지 않아야 합니다. (PeopleSoft의 권장 사항이기도 합니다.) 이전 EFFDT 키에 의해 결정된 대로 이미 발생한 이벤트는 수정해서는 안 됩니다. 감사 내역의 생성을 허용하기 때문입니다. correctionMode 의 UpdateEx 플래그를 사용하면 이 안전 메커니즘을 바이패스할 수 있습니다. 항목에 필드를 설정하고, 업데이트된 항목을 삭제하는 대신 추가하여 과거 이벤트가 비활성화되도록 하는 것이 좋습니다. |
interactiveMode |
오류를 처리하는 데 사용되는 플래그입니다. 구성 요소 인터페이스의 속성에 액세스할 때 PeopleSoft Enterprise용 BizTalk 어댑터는 구성 요소 인터페이스에서 개별 필드를 읽고 쓰는 PeopleSoft 제공 API를 사용합니다. 그러나 이러한 변경 사항은 PeopleSoft 서버로 하나씩 전파되지 않습니다. 대신 psjoa.jar(PeopleSoft Enterprise용 BizTalk 어댑터와 상호 작용)이 모든 변경 사항을 하나의 패키지로 패키징하여 서버에 보냅니다. 개별 업데이트 중 하나가 실패할 경우 실제 오류를 가리키지 않는 일반 오류가 반환됩니다. 대화형 모드를 TRUE로 설정하면 모든 필드 업데이트가 서버에 개별적으로 전송됩니다. 이 경우 성능에 영향을 줄 수 있지만 업데이트가 실패할 경우(예: 필드 설정에 잘못된 값이 사용된 경우) 특정 오류 정보가 제공됩니다. 는 interactiveMode 최대 성능을 제공하고 필드 업데이트 수준에서 오류 보고를 제공합니다. 이 기능을 제대로 사용하려면 FALSE로 interactiveMode 설정된 일반 호출을 수행하는 것이 좋습니다. 성능에 영향을 주면 안 됩니다. 오류가 반환되면 플래그가 TRUE로 설정된 상태에서 동일한 호출을 interactiveMode 다시 시도하면 됩니다. 호출에 실패하면 서버가 보다 정확한 오류 메시지를 반환합니다. |
이 함수를 호출할 때 키에 해당하는 레코드의 속성은 입력 매개 변수 속성으로 대체됩니다. 원래의 레코드를 가진 모든 컬렉션이 삭제되고 입력 매개 변수의 해당 컬렉션으로 대체됩니다. 이러한 컬렉션의 크기는 기존 컬렉션 항목을 모두 삭제한 다음 지정된 항목을 삽입하는 절차를 UpdateEx
일치시킬 필요가 없습니다.
구성 요소 인터페이스의 속성에 적용 날짜가 지정된 항목이 있을 경우 원래 목록은 대체되므로 속성 매개 변수에 미래의 적용 날짜가 지정된 모든 항목이 포함되어야 합니다. 이를 통해 미래 적용 날짜가 지정된 항목을 추가 및 삭제하는 메커니즘이 제공됩니다. 그러나 속성에 과거 적용 날짜가 지정된 항목도 포함된 경우 이러한 항목은 수정할 수 없으므로 오류가 반환됩니다. 또한 현재 적용 날짜가 지정된 항목이 포함된 경우에는 해당 항목이 무시됩니다. 이렇게 하면 클라이언트가 매개 변수를 False로 getHistoryItems
설정하여 를 호출 Get()
하고 이후 유효 날짜가 지정된 항목을 수정하거나 나중에 유효 날짜가 지정된 새 항목을 추가하고 함수에 대한 UpdateEx()
매개 변수로 구조를 전달할 수 있습니다.
하나의 instance 존재할 수 UpdateEx()
있는 경우와 같이 구성 요소 인터페이스에 키가 없는 경우 메서드에는 다음 형식이 있습니다.
UpdateEx(correctionMode, interactiveMode, properties)
참고
BizTalk Adapter for PeopleSoft Enterprise UpdateEx()
메서드는 구성 요소 인터페이스의 PeopleSoft Get
및 Save
함수를 사용하도록 설정하면 제공됩니다.