기록을 복잡한 데이터 유형으로 내보내기 및 변환

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기5분

    • URL 매개변수를 사용하여 테이블 기록을 익스포트하고 JSON, XML, PDF, CSV 및 XLS와 같은 복잡한 데이터 유형으로 변환합니다.

    레코드를 복합 데이터 형식으로 내보내기

    HTTP GET 요청을 사용하여 테이블에서 레코드를 검색하고 지정된 형식으로 넣을 수 있습니다. 예를 들어, GET 요청에서 이 매개변수를 사용하여 테이블의 기록을 PDF 파일로 익스포트하고, 이 매개변수를 사용하여 XLSPDF 테이블의 기록을 XLS 파일로 익스포트합니다. 예를 들어, 인시던트 기록 목록을 XLS 파일로 검색하려면 https://instance_name.service-now.com/incident.do?XLS URL을 사용하여 HTTP GET을 발행합니다. 반환된 파일은 incident.xls입니다. incident.do 는 기본적으로 인시던트 테이블의 기록 목록을 반환하는 GET 입니다. 매개변수는 XLS 이러한 기록을 XLS 파일로 변환합니다.

    일반 구문은 https://<serviceNow-instance-name>/<table-name>.do?<Data-type-parameter입니다>

    URL 매개변수

    다음 표에서는 GET 요청에서 사용할 수 있는 URL 매개 변수, 반환에서 원치 않는 테이블 레코드를 필터링하는 데 사용할 수 있는 필터, 데이터 형식을 테이블에 직접 게시할 수 있는지 여부에 대한 표시기를 보여 줍니다. 매개변수는 반환된 파일의 확장자가 됩니다. 예를 들어, 매개변수를 사용하면 XLS<table-name>.xls 형식으로 파일이 반환됩니다.
    표 1. URL 매개변수
    데이터 유형 매개변수 유효한 필터 테이블에 직접 POST하시겠습니까?
    CSV CSV sysparm_query, sysparm_view Y
    Excel XLS, 엑셀, XLSX sysparm_query, sysparm_view Y
    JSON JSONv2 다양 한. JSON 데이터 검색 API를 참조하세요. Y
    PDF PDF sysparm_query, sysparm_view N
    RSS RSS sysparm_query, sysparm_view 등. 뷰로 결과 제한하기를 참조하십시오. N
    XML XML, XSD, 스키마 sysparm_query, useUnloadFormat N

    테이블 레코드를 검색하고 JSON 파일 형식으로 변환하는 방법에 대한 자세한 내용은 JSONv2 웹 서비스를 참조하세요.

    테이블 레코드를 검색하고 RSS 파일 형식으로 변환하는 방법에 대한 자세한 내용은 RSS 피드 생성기를 참조하십시오.

    레코드를 PDF로 변환

    PDF 익스포트의 경우 테이블 대상 지정과 해당 목록 대상 지정 사이에는 차이가 있습니다. 기록 목록의 PDF를 생성하려면 대상에 _list 접미사를 붙입니다. 단일 기록을 대상으로 지정하려면 PDF를 sys_id 생성할 기록을 식별하는 매개 변수를 지정해야 합니다.

    필터

    모든 URL 매개변수는 테이블 기록의 하위 집합을 익스포트할 수 있는 필터와 함께 작동합니다. 예를 들어 GET 요청의 sysparm_query=active=true는 활성 레코드만 내보냅니다. 다음 예에서는 활성 인시던트 기록만 Excel 형식으로 내보냅니다. https://instance_name.service-now.com/incident.do? EXCEL&sysparm_query=active=true입니다.

    일반 구문은 https://<serviceNow-instance-name>/<table_list>.do?<Data-type-parameter>&<filter입니다>

    필터에는 다음이 포함됩니다.
    • sysparm_query - 파일을 내보내기 전에 인코딩된 쿼리를 사용하여 데이터를 필터링합니다(예: sysparm_query=active=true 는 활성 기록만 내보냅니다).
    • sysparm_view - 반환되는 필드를 제어하는 목록 뷰의 이름을 지정합니다. 예를 들어 ESS 뷰를 반환하려면 sysparm_view=ess를 사용합니다.
    • useUnloadFormat - 반환된 XML 형식이 언로드 형식임을 나타냅니다. 언로드 형식은 UI의 목록에서 XML> 내보내기를 선택할 때 가져오는 것과 동일한 형식입니다> ... 언로드 형식의 XML 파일을 테이블로 다시 가져올 수 있습니다. URL에서 언로드 형식을 사용하도록 설정하려면 useUnloadFormat=true URL 매개변수(예: https://instance_name.service-now.com/incident.do?XML&useUnloadFormat=true)를 사용합니다.

    예제 GET 쿼리

    표 2. GET 요청 예시
    데이터 유형 예제 쿼리
    CSV https://instance_name.service-now.com/incident.do(으)로 이동합니까? CSV&sysparm_query=활성=참
    Excel https://instance_name.service-now.com/incident.do?XLS&sysparm_query=active=true
    PDF https://instance_name.service-now.com/incident.do?PDF&sysparm_view=ess
    RSS https://instance_name.service-now.com/incident.do(으)로 이동합니까? RSS&sysparm_view=ess
    XML https://instance_name.service-now.com/incident.do?XML&sysparm_query=active=true

    반환된 파일

    GET 쿼리는 요청에서 지정된 형식으로 테이블에서 레코드를 반환합니다. 예를 들어 매개변수를 사용하는 XLS 쿼리는 확장자가 .xls 인 파일의 테이블 기록을 반환합니다.

    응답의 Content-Disposition 헤더에는 반환된 파일의 파일 이름과 확장명이 표시됩니다. 파일 이름은 incident.xls, incident.pdf 또는 incident.xml와 같이 내보내는 원본 테이블을 기반으로 합니다.

    테이블로 데이터 내보내기

    다음 데이터 형식을 테이블에 직접 게시할 수 있습니다.
    • CSV
    • Excel
    • JSON

    파일 헤더는 대상 테이블의 필드 열과 일치해야 합니다. 자세한 내용은 CSV 또는 Excel 파일을 가져오기 집합에 직접 게시를 참조하세요.