Exportação e conversão de registros em tipos de dados complexos

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura

    • Use parâmetros de URL para exportar registros de tabela e convertê-los em tipos de dados complexos, como JSON, XML, PDF, CSV, e XLS.

    Exportando registros como tipos de dados complexos

    Você pode usar um HTTP OBTER solicitação para recuperar registros de uma tabela e colocá-los em um formato especificado. Por exemplo, use PDFparâmetro em a. OBTER Solicitação para exportar registros de uma tabela como arquivos PDF; use XLSParâmetro para exportar registros de uma tabela como arquivos XLS. Por exemplo, para recuperar uma lista de registros de incidentes como arquivos XLS, emita um HTTP OBTER Usando o seguinte URL: https://instance_name.service-now.com/incident.do?XLS . O arquivo retornado é incident.xls . incident.do é basicamente um OBTER retorna uma lista dos registros da tabela de incidentes. . XLSO parâmetro converte esses registros em arquivos XLS.

    A sintaxe geral é: https://<serviceNow-instance-name>/<table-name>.do?<Data-type-parameter>

    Parâmetros de URL

    A tabela a seguir mostra os parâmetros de URL que você pode usar no OBTER solicitações, filtros que você pode usar para filtrar registros de tabela indesejados no retorno e um indicador se você pode PUBLICAR o tipo de dados diretamente para uma tabela. O parâmetro se torna a extensão do arquivo retornado, por exemplo, usando XLSo parâmetro retorna um arquivo no formulário <table-name>.xls .
    Tabela 1. Parâmetros de URL
    Tipo de dados Parâmetro Filtros válidos PUBLICAR diretamente na tabela?
    CSV CSV sysparm_query, sysparm_view Y
    Excel XLS, EXCEL, XLSX sysparm_query, sysparm_view Y
    JSON JSONv2 Vários. Consulte API de recuperação de dados JSON . Y
    PDF PDF sysparm_query, sysparm_view N
    RSS RSS sysparm_query, sysparm_view e muito mais. Consulte Limitar resultados com uma exibição . N
    XML XML, XSD, ESQUEMA Sysparm_query, useUnloadFormat N

    Para obter mais informações sobre como recuperar e converter registros de tabela no formato de arquivo JSON, consulte JSONv2 Web Service .

    Para obter mais informações sobre como recuperar e converter registros de tabela no formato de arquivo RSS, consulte Gerador de feed RSS .

    Convertendo registros em PDFs

    Para exportação de PDF, há uma distinção entre direcionar uma tabela e direcionar sua lista. Para gerar um PDF de uma lista de registros, sufixo o destino com _list . Para direcionar um único registro, você deve especificar sys_idParâmetro para identificar o registro para o qual você está gerando o PDF.

    Filtros

    Todos os parâmetros de URL funcionam com filtros que permitem exportar um subconjunto de registros de tabela. Por exemplo, sysparm_query em a. OBTER a solicitação exporta somente registros ativos. O exemplo a seguir exporta somente registros de incidentes ativos em um formato Excel: https://instance_name.service-now.com/incident.do?EXCEL&sysparm_query=active=true .

    A sintaxe geral é: https://<serviceNow-instance-name>/<table_list>.do?<Data-type-parameter>&<filter>

    Os filtros incluem:
    • Sysparm_query - Filtra os dados usando a consulta codificada antes de exportar arquivos, por exemplo, sysparm_query exporta somente registros ativos.
    • Sysparm_view - Especifique o nome de uma exibição de lista para controlar quais campos serão retornados. Por exemplo, para retornar a exibição ESS, use sysparm_view .
    • UseUnloadFormat - Indica que o formato XML retornado é um formato de descarregamento. O formato de descarregamento é o mesmo formato obtido quando, em uma lista na IU, você seleciona Exportar > XML > ... Você pode importar arquivos XML formatados para descarregamento de volta para as tabelas. Para habilitar o formato de descarregamento de um URL, use UseUnloadFormat: Verdadeiro Parâmetro de URL, por exemplo, https://instance_name.service-now.com/incident.do?XML&useUnloadFormat=true .

    OBTER consultas

    Tabela 2. OBTER exemplos de solicitação
    Tipo de dados Consulta de exemplo
    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

    Arquivos retornados

    OBTER as consultas retornam registros de uma tabela no formato especificado na solicitação. Por exemplo, uma consulta que usa XLSo parâmetro retorna um registro de tabela em um arquivo com .xls extensão.

    O cabeçalho Content-Dispotion na resposta exibe o nome do arquivo e a extensão do arquivo retornado. O nome do arquivo é baseado na tabela da qual você exporta, como incident.xls, incident.pdf ou incident.xml.

    Exportando dados para tabelas

    Você pode PUBLICAR os seguintes tipos de dados diretamente nas tabelas:
    • CSV
    • Excel
    • JSON

    Os cabeçalhos do arquivo devem corresponder às colunas do campo na tabela de destino. Para obter mais informações, consulte Publique arquivos CSV ou Excel diretamente em um conjunto de importação .