複合データタイプへのレコードのエクスポートと変換

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：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 パラメーター
    データタイプ パラメーター 有効なフィルター テーブルに直接 POST しますか?
    CSV CSV sysparm_query、sysparm_view Y
    Excel XLS、EXCEL、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 Web サービス」を参照してください。

    テーブルレコードを取得して 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=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 ファイルをインポートセットに直接投稿する」を参照してください。