URL から直接エクスポート

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • URL クエリをビルドすることで、スクリプトまたは Web サービスからデータを動的にエクスポートします。

    始める前に

    必要なロール：なし

    注:
    ServiceNow は、直接 URL アクセスにベーシック認証を適用します。URL から抽出されたデータには、現在認証されているユーザーが読み取りアクセス権を持つフィールドのみが含まれています。

    このタスクについて

    URL クエリを使用して、エクスポートする前にプログラムでフィルタリングされたレコードリストを生成できます。URL クエリは、レコードリストを生成するスクリプトで、ユーザーが UI から手動でフィルターを追加できない場合に便利です。

    URL から直接データをエクスポートするには、ServiceNow テーブルと列の名前に精通している必要があります。「Navigate to a record or a module using a URL (URL を使用してレコードまたはモジュールに移動する)」を参照してください。

    クエリパラメーターまたはシステムプロパティを使用して、フィールドの表示値または生の値、およびヘッダーのフィールドラベルまたはフィールド名をエクスポートするかどうかをコントロールできます。
    • クエリパラメーターの使用の詳細については、「」を参照してください。
    • システムプロパティの使用の詳細については、「」を参照してください。
    クエリパラメーター (存在する場合) はシステムプロパティを上書きします。

    手順

    1. インスタンスの URL を指定します。
      例：
      https://<instance name>.service-now.com/
    2. エクスポートするテーブルフォームまたはリストを指定します。
      例：
      incident_list.do
    3. エクスポートに使用するエクスポート形式のプロセッサーを指定します。
      CSV、XLS、JSON、XLSX、または XML を指定できます。例： 
      ?CSV
      注:
      URL エクスポートの XML プロセッサーは、添付ファイルやジャーナルフィールドをエクスポートしません。[ 作業メモ ] フィールドや [追加コメント ] フィールドなどの添付ファイルとジャーナルフィールドをエクスポートするには、 エクスポート > XML オプションを選択します。
    4. オプション: sysparm_query パラメーターを追加して、特定のレコードをクエリします。
      必要な構文は、sysparm_query=[列名][演算子][値] です。例：
      https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1
      注:
      すべてのクエリで列名、演算子、および値が使用されます。使用可能な演算子のリストについては、「条件ビルダー」を参照してください。
    5. オプション: sysparm_orderby パラメーターを使用して、レコードを列名でソートします。
      必要な構文は、sysparm_orderby=[列名] です。例：
      https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to
      注:
      sysparm_orderby を使用すると、1 つの列でのみソートできます。複数の列でソートするには、複数の orderby エントリを使用します。例：
      sysparm_query=ORDERBYassigned_to^ORDERBYpriority
    6. オプション: sysparm_view パラメーターを使用して、特定のビューからフィールドをエクスポートします。
      必要な構文は、sysparm_view=[ビュー名] です。例：
      https://<instance name>.service-now.com/incident.do?CSV&sysparm_view=ess
      この URL から、セルフサービス (ess) ビューに表示されるインシデントフィールドがエクスポートされます。
      • デフォルトでは、リストからデータをエクスポートすると、現在のビューに表示されているフィールドのみがエクスポートされます。別のリストビューからフィールドをエクスポートする場合は、UI からビューを切り替えることができます。「ビューの管理」を参照してください。
      • CSV または Excel データをエクスポートするときにビューを指定しない場合、エクスポートではデフォルトのリストビューが使用されます。
      • XML データをエクスポートする場合、特定のビューを指定しない限り、デフォルトですべてのフィールドがエクスポートされます。
    7. オプション: sysparm_fields パラメーターを使用して、テーブルから特定のフィールドをエクスポートします。
      必要な構文は、sysparm_fields=[field1],[field2] です。例：
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_fields=sys_id,number
    8. オプション: sysparm_default_export_fields パラメーターを使用して、すべてのフィールド (sys_id を含む) をテーブルからエクスポートします。
      必要な構文は、sysparm_default_export_fields=all です。例：
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_default_export_fields=all
      sysparm_default_export_fields パラメーターを含めてデフォルト以外のビューを指定しない限り、sysparm_view パラメーターは XML エクスポートには影響しません。

    サンプル URL

    URL 説明
    https://<インスタンス名>.service-now.com/incident_list.do?CSV すべてのインシデントをカンマ区切り値のテキストファイルにエクスポートします。
    https://<インスタンス名>.service-now.com/incident_list.do?CSV&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27 特定のインシデントをカンマ区切りの値のテキストファイルにエクスポートします。
    https://<インスタンス名>.service-now.com/incident_list.do?CSV&sysparm_orderby=sys_id すべてのインシデントをカンマ区切りの値のテキストファイルにエクスポートし、リストを sys_id でソートします。
    https://<インスタンス名>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to 優先度 1 のすべてのインシデントのリストを XML ファイルにエクスポートし、リストを [アサイン先] フィールドでソートします。