레코드를 복잡한 데이터 형식으로 내보내고 변환

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

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

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

    HTTP GET 요청을 사용하여 테이블에서 레코드를 검색하고 지정된 형식으로 배치할 수 있습니다. 예를 들어, GET 요청에서 이 매개변수를 PDF 사용하여 테이블의 기록을 PDF 파일로 내보내고, 이 매개변수를 사용하여 XLS 테이블의 기록을 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 매개 변수, 반환에서 원치 않는 테이블 레코드를 필터링하는 데 사용할 수 있는 필터 및 데이터 형식을 테이블에 직접 POST 할 수 있는지 여부를 나타내는 표시기를 보여 줍니다. 매개 변수는 반환된 파일의 확장자가 됩니다. 예를 들어, 매개 변수를 사용하면 XLS<table-name>.xls 형식으로 파일이 반환됩니다.
    표 1. URL 매개변수
    데이터 유형 매개변수 유효한 필터 테이블에 직접 게시하시겠습니까?
    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=활성=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의 목록에서 Export > 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=active=true
    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와 같이 익스포트하는 테이블을 기반으로 합니다.

    테이블로 데이터 내보내기

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

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