웹 서비스 임포트 세트 모드

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 5분

    • SOAP 메시지가 기록을 임포트 세트 테이블에 삽입하고 로딩 상태의 해당 테이블에 대한 임포트 세트가 없는 경우, 모드 가 동기식으로 설정된 새 임포트 세트가 작성됩니다.

    동기 모드인 임포트 세트는 삽입되는 즉시 데이터를 변환합니다(변환 맵이 이미 존재하는 경우). 또한 이 임포트 세트에는 기본 로드 상태가있습니다. 기본적으로 모든 동기 임포트 세트는 자정에 처리됨 으로 자동 수정됩니다. 따라서 동일한 테이블에 새 삽입이 발생하면 새 동기 가져오기 집합이 만들어집니다.

    그림 1. 동기 임포트 세트
    이 임포트 세트를 비동기모드 및 로드상태로 변경하면 들어오는 데이터가 삽입될 때 변환되지 않고 임포트 세트를 "로드"한 후 나중에 수동으로 또는 예약된 스크립트 작업을 사용하여 데이터 변환을 연기하는 효과가 있습니다.
    표 1. 임포트 세트 모드
    모드 상태 기능
    비동기 로드 중 데이터 변환은 자동으로 즉시 발생하지 않습니다. 임포트 세트 행에 추가된 데이터의 상태가 "보류 중"입니다. 상태가 로드됨으로 변경되면 변환을 수동으로 예약하거나 실행할 수 있습니다.
    비동기 로드됨 데이터 로드가 완료되었음을 표시합니다. 이제 데이터 변환을 예약된 방식으로 또는 수동으로 수행할 수 있습니다.
    동기 로드 중 데이터 변환은 연결된 임포트 세트 행에 데이터가 삽입될 때마다 자동으로 즉시 발생합니다.
    동기 로드됨 이 연결된 임포트 세트에 새 데이터가 삽입되면 동기 및 상태 로딩 모드의 새 임포트 세트가 만들어집니다. 상태를 로드 됨으로 변경하는 것은 다음 임포트 세트 행 삽입을 위해 새 동기 임포트 세트를 작성하고 즉시 변환해야 함을 나타내는 방법입니다

    삽입 동작 제어

    하나 이상의 병합 필드를 지정하는 임포트 세트에서 일치하는 병합 값을 가진 기록은 중복을 방지하기 위해 소스에서 대상 테이블로 순차적으로(한 번에 하나씩) 변환됩니다.

    병합 필드를 지정하지 않은 임포트 세트에서는 기록이 동시에 변환됩니다. 속성을 사용하여 glide.import_set_insert_serialized_when_no_coalesce 이 동작을 제어할 수 있습니다.

    시스템 속성은 인스턴스가 glide.import_set_insert_serialized.<table name> 웹 서비스 호출의 기록을 특정 임포트 세트 테이블에 삽입하는 방법을 제어합니다. true인 경우, 이 속성은 데이터베이스 삽입 조작을 직렬화하여 동일한 동시 삽입이 중복 레코드를 만드는 것을 방지합니다. 대상 테이블에 변환 맵에 정의된 병합 필드가 없는 경우 이 속성을 아니오 로 설정하여 웹 서비스 임포트 세트 성능을 향상시킵니다.

    주:
    이 속성을 False 로 설정하면 중복 기록이 생성될 수 있습니다.
    주:
    이 glide.soap.import_set_insert_serialized.<table name> 시스템 속성은 와 동일한 기능을 glide.import_set_insert_serialized.<table name>제공하지만, 두 속성이 모두 정의 glide.import_set_insert_serialized.<table name>glide.soap.import_set_insert_serialized.<table name>되면 .

    표준 SOAP 응답

    웹 서비스 임포트 세트 삽입 호출의 SOAP 응답은 다음 표준 값을 반환합니다.
    <SOAP-ENV:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"><SOAP-ENV:Body><insertResponse><sys_id>fa648f5f0a0a0b2b0048e7012448b8f1</sys_id><table>incident</table><display_name>number</display_name><display_value>INC10014</display_value><status>inserted</status></insertResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>
    표 2. 표준 SOAP 응답
    필드 설명
    sys_id 작성되거나 수정된 결과 기록의 Sys_id
    테이블 영향을 받은 테이블의 테이블 이름입니다. 비동기 호출의 경우 테이블 이름은 임포트 세트 테이블입니다. 알림 웹 서비스 임포트 세트 테이블에 대한 imp_notification
    display_name 작성되거나 수정된 기록의 표시 필드로 설정되는 필드의 이름
    display_value 표시 필드로 지정된 필드의 값입니다. 예를 들어 인시던트 테이블의 표시 필드는 숫자 필드이고 예시 값은 다음과 같습니다INC10001
    상태 웹 서비스 호출의 결과로 발생한 조치를 나타내는 문자열 값으로, sys_id 및 테이블 필드 값으로 정의된 기록과 관련되어 있습니다
    • inserted - 기록이 삽입되었습니다.
    • 업데이트됨 - 기록이 업데이트되었습니다.
    • 무시됨 - 입력이 무시되었고 기록이 업데이트되지 않았으며 새 기록이 생성되지 않았습니다.
    • 건너뜀 - 병합 값이 누락되어 입력 데이터를 건너뛰었습니다(무시됨과 유사).
    • 오류 - 입력을 처리하는 동안 오류가 발생했습니다
    status_message 이 값은 임포트 세트 행의 설명 필드에 있는 값으로 변환되며 일반적으로 상태 값과 관련된 정보를 포함합니다. 예: 상태가 "무시됨"일 때 "필드 값이 변경되지 않았습니다". 이 값을 사용자 지정된 문자열 값으로 설정하면 SOAP 응답에 반환될 선택적 status_message 필드가 포함됩니다.
    error_message 오류 상태와 관련된 메시지입니다. 오류가 발생할 때 이 값을 사용자 지정된 문자열 값으로 설정하면 SOAP 응답에 반환될 선택적 error_message 필드가 포함됩니다

    SOAP 응답 조정

    변환 스크립트를 사용하여 status_message 의 내용을 덮어써서 WSDL에 지정된 정보 이외의 정보를 포함할 수 있습니다.