웹 서비스 임포트 세트 모드

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

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

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

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

    삽입 동작 제어

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

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

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

    주:
    이 속성을 아니오 로 설정하면 중복 기록이 생성될 수 있습니다.
    주:
    시스템 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 및 테이블 필드 값으로 정의된 기록과 관련하여 웹 서비스 호출의 결과로 발생한 작업을 나타내는 문자열 값
    • 삽입됨 - 기록이 삽입되었습니다.
    • 업데이트됨 - 기록이 업데이트되었습니다.
    • 무시 됨 - 입력이 무시되고 기록이 업데이트되지 않았으며 새 기록이 생성되지 않았습니다.
    • skipped - 누락된 병합 값으로 인해 입력 데이터를 건너뛰었습니다(무시된 것과 유사).
    • 오류 - 입력을 처리하는 동안 오류가 발생했습니다.
    status_message 이 값은 임포트 세트 행의 설명 필드에 있는 값으로 변환되며 일반적으로 상태 값과 관련된 정보를 포함합니다. 예: 상태가 "무시됨"인 경우 "변경된 필드 값 없음". 이 값을 사용자 지정된 문자열 값으로 설정하면 SOAP 응답에 선택적 status_message 필드가 반환됩니다.
    error_message 오류 상태와 관련된 메시지입니다. 오류가 발생할 때 이 값을 사용자 지정된 문자열 값으로 설정하면 SOAP 응답에 선택적 error_message 필드가 반환됩니다

    SOAP 응답 조정

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