웹 서비스 임포트 세트 모드

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

    SOAP 응답 조정

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