---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# CSVParser - 범위 지정됨

# CSVParser - 범위 지정됨 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

CSVParser API는 CSV(쉼표로 구분된 값) 형식의 레코드를 객체 또는 배열로 구문 분석하기 위한 메서드를 제공합니다.

이 API는 `sn_impex` 네임스페이스에서 실행됩니다.

## CSVParser - parseLineToArray(String cvsLine, 문자열 구분 기호, 문자열 quoteCharacter) {#ariaid-title2}

CSV 형식의 컨텐츠로 전달된 컨텐츠를 배열로 구문 분석합니다.
{#CSVParser-parseLineToArray_S_S_S__table_jn5_hkt_kjb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| csv라인 | 문자열 | 구문 분석할 CSV 콘텐츠입니다. |
| 구분 기호 | 문자열 | 옵션입니다. 소스 CSV 컨텐츠에서 필드를 설명하는 데 사용되는 문자입니다. 기본값: 쉼표 "," |
| 인용문자 | 문자열 | 옵션입니다. 소스 CSV 컨텐츠에서 따옴표 문자로 사용되는 문자입니다. 기본값: 큰따옴표 """ |
[표 1. 매개변수]

{#CSVParser-parseLineToArray_S_S_S__table_jn5_hkt_kjb} {#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 전달된 CSV 컨텐츠의 각 요소에 대해 구문 분석된 값을 포함하는 배열입니다. 예: { Joe, Smith, 470 W Carmen, Chicago IL, 60640 } |
[표 2. 반환]

{#CSVParser-parseLineToArray_S_S_S__table_kn5_hkt_kjb}  
이 예시에서는 반환된 배열로 구문 분석된 간단한 CSV 형식 컨텐츠를 보여줍니다.

    var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
    var delimiter = ',';
    var quoteCharacter = '"';

    var x = new sn_impex.CSVParser().parseLineToArray(csvLine, delimiter, quoteCharacter);

    gs.log(x[0]);
    gs.log(x[1]);
    gs.log(x[2]);

출력:

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

## CSVParser - parseLineToObject(String cvsLine, 배열 헤더, 문자열 구분 기호, 문자열 quoteCharacter) {#ariaid-title3}

CSV 형식의 컨텐츠로 전달된 컨텐츠를 객체에 구문 분석합니다.
{#CSVParser-parseLineToObject_S_A_S_S__table_k54_fgt_kjb__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| csv라인 | 문자열 | 구문 분석할 CSV 콘텐츠입니다. |
| 헤더 | 문자열 배열 | CSV 컨텐츠와 연결된 헤더입니다. 이러한 헤더는 에 있는 csvLine해당 콘텐츠와 동일한 순서로 지정해야 합니다. 예: `var headers = ['first_name', 'last_name', 'address'];` |
| 구분 기호 | 문자열 | 옵션입니다. 소스 CSV 컨텐츠에서 필드를 설명하는 데 사용되는 문자입니다. 기본값: 쉼표 "," |
| 인용문자 | 문자열 | 옵션입니다. 소스 CSV 컨텐츠에서 따옴표 문자로 사용되는 문자입니다. 기본값: 큰따옴표 """ |
[표 3. 매개변수]

{#CSVParser-parseLineToObject_S_A_S_S__table_k54_fgt_kjb} {#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 전달된 CSV 컨텐츠의 각 요소에 대한 헤더와 해당 값을 포함하는 객체입니다. 예: { first_name: Joe, last_name: Smith, address: 1470 W Carmen, Chicago IL, 60640 } |
[표 4. 반환]

{#CSVParser-parseLineToObject_S_A_S_S__table_l54_fgt_kjb}  
이 예에서는 반환된 객체로 구문 분석된 CSV 형식의 컨텐츠를 보여줍니다.

    var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
    var headers = ['first_name', 'last_name', 'address'];
    var delimiter = ',';
    var quoteCharacter = '"';

    var x = new sn_impex.CSVParser().parseLineToObject(csvLine, headers, delimiter, quoteCharacter);

    gs.log(x.first_name);
    gs.log(x.last_name);
    gs.log(x.address);

출력:

    Joe
    Smith
    1470 W Carmen, Chicago IL, 60640

이 예에서는 헤더 매개변수의 잘못된 전달로 인한 예외 응답을 보여줍니다.

    var csvLine = '\"Joe\",\"Smith\",\"1470 W Carmen, Chicago IL, 60640\"';
    var headers = null;
    var delimiter = ',';
    var quoteCharacter = '"';
    try {
    var x = new sn_impex.CSVParser().parseLineToObject(csvLine, headers, delimiter, quoteCharacter);

    gs.log(x.first_name);
    gs.log(x.last_name);
    gs.log(x.address);
    }
    catch(ex) {
          gs.info(ex.message);
    }

출력:

    CSVParser: Header list is empty: no thrown error
    *** Script: CSVParser: Header list is empty