영어로 읽기

다음을 통해 공유


DeleteOnly 메서드

컬렉션에서 항목을 삭제하도록 허용합니다.

구문

DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,  
    properties)  

매개 변수

매개 변수 Description
key 공급해야 할 매개 변수 집합입니다. 서버 데이터베이스에 반드시 있어야 하는 키의 집합으로, 없을 경우 오류가 발생합니다. 이러한 키는 특정 구성 요소 인터페이스에 대해 정의된 Get Keys 집합에 해당합니다.
correctionMode 부울 플래그입니다. True로 설정하면 컬렉션에서 과거 유효 날짜의 항목을 삭제하도록 허용합니다. 구체적으로 말하면, EFFDT가 현재 적용 날짜보다 이전인 항목의 삭제를 허용합니다. 이 플래그를 TRUE로 설정하지 않고 이러한 항목을 수정하면 PeopleSoft 서버에서 오류가 반환됩니다. 참고: 인수는 correctionMode 유효 날짜가 지정된 항목을 포함하는 구성 요소 인터페이스에 대해서만 노출됩니다. 그렇지 않으면 인수의 일부로 표시되지 않습니다.
interactiveMode 오류 처리에 사용됩니다.

구성 요소 인터페이스에서 속성에 액세스하는 경우 PeopleSoft Enterprise용 BizTalk 어댑터는 구성 요소 인터페이스에서 개별 필드를 읽고 쓰는 PeopleSoft 제공 API를 사용합니다. 그러나 이러한 변경 내용은 한 번에 하나씩 PeopleSoft 서버로 전파되지 않습니다. 대신 PeopleSoft Enterprise용 BizTalk 어댑터가 상호 작용하는 psjoa.jar은 모든 변경 내용을 패키징하고 하나의 패키지로 서버에 보냅니다. 개별 업데이트 중 하나가 실패할 경우 실제 오류를 가리키지 않는 일반 오류가 반환됩니다. 대화형 모드를 TRUE로 설정하면 모든 필드 업데이트가 서버에 개별적으로 전송됩니다. 이 경우 성능에 영향을 줄 수 있지만 업데이트가 실패할 경우(예: 필드 설정에 잘못된 값이 사용된 경우) 특정 오류 정보가 제공됩니다.

매개 변수는 interactiveMode 최대 성능을 제공하고 필드 업데이트 수준에서 오류 보고를 제공합니다. 이 기능을 제대로 사용하려면 FALSE로 interactiveMode 설정된 일반 호출을 수행하는 것이 좋습니다. 성능에 영향을 주면 안 됩니다. 오류가 반환될 경우 interactiveMode 플래그를 TRUE로 설정하여 동일한 호출을 다시 시도할 수 있습니다. 호출에 실패하면 서버가 보다 정확한 오류 메시지를 반환합니다.
properties 서버에 있는 구조의 하위 집합이 포함되어 있습니다. 모든 리프 항목이 삭제됩니다.

설명

속성은 이 구성 요소 인터페이스의 또는 UpdateEx 메서드와 CreateEx 동일한 데이터 형식을 갖습니다. 그러나 키 값만 중요합니다. 키가 아닌 값은 무시됩니다. 키 값이 서버에 있는 값과 일치하지 않는 경우에는 예외가 발생합니다.

다음은 키 값의 사용에 대한 설명입니다. 컬렉션에 다음 항목이 포함되어 있는 경우:

  • item0

  • item1

  • item2

  • item3

    속성에 item1과 item3의 키를 제공하여 item1과 item3을 삭제할 수 있습니다.

  • item1

  • item3

    호출 후에 서버의 컬렉션에는 다음 항목이 남습니다.

  • item0

  • item2

    두 번째 예에서는 다른 컬렉션이 포함된 항목을 보여 줍니다.

  • item0

    • item0a
  • item1

    • item1a

    • item1b

    • item1c

  • item2

    • item2a

    • item2b

    키를 item1b 및 item2에 제공하여 item1b와 item2 전체를 삭제할 수 있습니다.

  • item1

    • item1b
  • item2

    item2에 빈 하위 컬렉션을 제공하면 리프로 변환되어 하위 분기 전체가 삭제됩니다. 호출 후에 서버에는 다음 항목이 남습니다.

  • item0

    • item0a
  • item1

    • item1a

    • item1c

참고 항목

부록 A: 구성 요소 인터페이스 메서드