SOAP 결함(<Fault> 요소)은 SOAP 본문의 하위 요소이며 오류를 보고하는 데 사용됩니다.
있는 경우 SOAP 결함 요소는 본문 항목으로 표시되어야 하고 본문 요소에 두 번 이상 표시되어서는 안됩니다. SOAP 결함 요소의 하위 요소는 SOAP 1.1에서와 SOAP 1.2에서 다릅니다.
SOAP 1.1
SOAP 1.1에서 SOAP 결함은 다음 하위 요소를 포함합니다.
<faultcode>- 의
<faultcode>요소는 다음의 필수 요소입니다.<Fault>사용하십시오. 이 요소는 소프트웨어가 처리할 수 있는 양식으로 결함에 대한 정보를 제공합니다. SOAP은 기본 SOAP 결함을 포함한 작은 SOAP 결함 코드 세트를 정의하고 이 세트는 애플리케이션에서 확장될 수 있습니다.
<faultstring>- 의
<faultstring>요소는 다음의 필수 요소입니다.<Fault>사용하십시오. 독자를 대상으로 하는 양식으로 결함에 대한 정보를 제공합니다.
<faultactor>- 의
<faultactor>요소에는 결함을 생성한 SOAP 노드의 URI가 포함되어 있다. 최종 SOAP 수신자가 아닌 SOAP 노드는 다음을 포함해야 한다.<faultactor>이 요소를 포함하지 않아도 되지만, 궁극적인 SOAP 수신자는 이 요소를 포함하지 않아도 되지만 그렇게 할 수도 있다.
<detail>- 의
<detail>요소에 애플리케이션 특정 오류 정보가 포함되어 있습니다.<Body>사용하십시오. 이 값은 다음과 같은 경우에 표시되어야 합니다.<Body>요소가 성공적으로 처리되지 않았습니다. 의<detail>요소는 헤더 항목에 속하는 오류 정보에 대한 정보를 전달하는 데 사용되지 않아야 합니다. 헤더 입력 항목에 속한 세부 오류 정보는 헤더 입력 항목으로 전달되어야 합니다.
SOAP 1.2
SOAP 1.2에서 SOAP 결함은 다음 하위 요소를 포함합니다.
<Code>- 의
<Code>요소는 다음의 필수 요소입니다.<Fault>사용하십시오. 이 요소는 소프트웨어가 처리할 수 있는 양식으로 결함에 대한 정보를 제공합니다. 여기에는<Value>요소 및 선택 사항<Subcode>사용하십시오.
<Reason>- 의
<Reason>요소는 다음의 필수 요소입니다.<Fault>사용하십시오. 독자를 대상으로 하는 양식으로 결함에 대한 정보를 제공합니다. 의<Reason>요소에 하나 이상의<Text>각각 다른 언어로 결함에 대한 정보를 포함하는 요소입니다.
<Node>- 의
<Node>요소에는 결함을 생성한 SOAP 노드의 URI가 포함되어 있다. 최종 SOAP 수신자가 아닌 SOAP 노드는 다음을 포함해야 한다.<Node>이 요소를 포함하지 않아도 되지만, 궁극적인 SOAP 수신자는 이 요소를 포함하지 않아도 되지만 그렇게 할 수도 있다.
<Role>- 의
<Role>요소에는 결함이 발생한 지점에서 노드가 작동 중인 역할을 식별하는 URI가 포함되어 있다.
<Detail>- 의
<Detail>"요소" 요소는 선택적 요소이며, 이 요소는 결함을 설명하는 SOAP 결함 코드와 관련된 애플리케이션 특정 오류 정보를 포함한다. 그들의 존재는<Detail>요소는 결함이 있는 SOAP 메시지의 어떤 부분이 처리되었는지에 대한 중요성을 갖지 않는다.