웹 서비스 임포트 세트 모드

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 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 이 값은 임포트 세트 행의 설명 필드에 있는 값으로 변환되며 일반적으로 상태 값과 관련된 정보를 포함합니다. 예: 상태가 &quot;무시됨&quot;일 때 &quot;변경된 필드 값이 없습니다.&quot; 이 값을 사용자 지정된 문자열 값으로 설정하면 SOAP 응답에 반환될 선택적 status_message 필드가 포함됩니다.
    error_message 오류 상태와 관련된 메시지입니다. 오류가 발생할 때 이 값을 사용자 지정된 문자열 값으로 설정하면 SOAP 응답에 선택적 error_message 필드가 반환됩니다

    SOAP 응답 조정

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