insertMultiple

URL의 대상 테이블에 대해 여러 개의 새 기록을 작성합니다.

입력 필드

insertMultiple 요소에는 시스템 필드를 제외하고 대상 테이블의 모든 필드를 포함하는 1개 이상의 기록 태그가 포함될 수 있습니다. 단일 작업에 삽입되는 기록 수를 200개 이하로 제한합니다. 증가가 인스턴스 성능에 부정적인 영향을 주지 않는 경우 후속 익스포트에서 이 수를 점진적으로 늘릴 수 있습니다.

출력 필드

insertMultipleResponse 태그 뒤에는 다음을 포함하는 1개 이상의 레코드 태그가 뒤따릅니다.

표 1. 메서드 출력 필드 삽입

테이블 유형	출력 필드
정규	대상 테이블(테이블)의 sys_id 필드와 표시 값이 반환됩니다.
임포트 세트	임포트 세트 행의 sys_id, 변환된 대상 테이블(테이블)의 이름, 변환된 대상 테이블의 display_name, 변환된 대상 행의 display_value 및 삽입, 업데이트 또는 오류를 포함할 수 있는 상태 필드입니다. 상태=오류일 때 선택적 status_message 필드 또는 error_message 필드 값이 있을 수 있습니다. 삽입으로 인해 대상 행이 변환되지 않으면(키 값이 지정되지 않아 건너뜀) sys_id 필드에는 대상 변환 테이블이 아닌 임포트 세트 행의 sys_id 포함됩니다.
여러 변환이 있는 임포트 세트	이 삽입 유형의 응답에는 multiInsertResponse 상위 요소에 래핑된 일반 임포트 세트 테이블 삽입의 여러 필드 세트가 포함됩니다. 각 세트에는 응답을 생성한 변환 맵을 보여 주는 맵 필드가 포함됩니다.

일반 테이블에 대한 샘플 SOAP 메시지

다음 예제에서는 짧은 설명만 지정하는 삽입을 보여 줍니다.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inc="http://www.service-now.com/incident">
   <soapenv:Header/>
   <soapenv:Body>
      <inc:insertMultiple>
         <record>
            <short_description>this is test 1</short_description>
         </record>
         <record>
            <short_description>this is test 2</short_description>
         </record>
         <record>
            <short_description>this is test 3</short_description>
         </record>
      </inc:insertMultiple>
   </soapenv:Body>
</soapenv:Envelope>

결과 응답은 다음과 같습니다.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:inc="http://www.service-now.com/incident">
   <soapenv:Header/>
   <soapenv:Body>
      <insertMultipleResponse>
         <insertResponse>
            <sys_id>168160ad4a36231200a89091281dc803</sys_id>
            <number>INC0055180</number>
         </insertResponse>
         <insertResponse>
            <sys_id>1681622e4a36231200a8909115e5c388</sys_id>
            <number>INC0055181</number>
         </insertResponse>
         <insertResponse>
            <sys_id>1681626e4a36231200a89091fa3c0aa8</sys_id>
            <number>INC0055182</number>
         </insertResponse>
      </insertMultipleResponse>
   </soapenv:Body>
</soapenv:Envelope>

임포트 세트 테이블의 샘플 SOAP 메시지

다음 예제에서는 짧은 설명만 지정하는 삽입을 보여 줍니다.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:imp="http://www.service-now.com/imp_notification">
   <soapenv:Header/>
   <soapenv:Body>
      <imp:insertMultiple>:-->
         <imp:record>
            <imp:message>one</imp:message>
            <imp:uuid>a</imp:uuid>
         </imp:record>
         <imp:record>
            <imp:message>two</imp:message>
            <imp:uuid>b</imp:uuid>
         </imp:record>
         <imp:record>
            <imp:message>three</imp:message>
            <imp:uuid>c</imp:uuid>
         </imp:record>
      </imp:insertMultiple>
   </soapenv:Body>
</soapenv:Envelope>

결과 응답은 다음과 같습니다.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:imp="http://www.service-now.com/imp_notification">
   <soapenv:Header/>
   <soapenv:Body>
      <insertMultipleResponse>
         <insertResponse>
            <sys_id>1296b3ab0a0a0b5b73e966fbfab7acde</sys_id>
            <table>incident</table>
            <display_name>number</display_name>
            <display_value>INC0010033</display_value>
            <status>ignored</status>
            <status_message>No field values changed</status_message>
         </insertResponse>
         <insertResponse>
            <sys_id>1296b48e0a0a0b5b62513bb5974a7d96</sys_id>
            <table>incident</table>
            <display_name>number</display_name>
            <display_value>INC0010034</display_value>
            <status>ignored</status>
            <status_message>No field values changed</status_message>
         </insertResponse>
         <insertResponse>
            <sys_id>1296b58b0a0a0b5b468f534659538b9a</sys_id>
            <table>incident</table>
            <display_name>number</display_name>
            <display_value>INC0010035</display_value>
            <status>ignored</status>
            <status_message>No field values changed</status_message>
         </insertResponse>
      </insertMultipleResponse>
   </soapenv:Body>
</soapenv:Envelope>