Exporte diretamente de um URL

Versão de lançamento: Zurich

Atualizado 31 de jul. de 2025

3 min. de leitura

Exporte dados dinamicamente de um script ou serviço web criando uma consulta de URL.

Antes de Iniciar

Função necessária: nenhuma

Nota:

ServiceNow aplica autenticação básica Para acesso direto à URL. Os dados extraídos do URL contêm somente os campos aos quais o usuário autenticado no momento tem acesso de leitura.

Por Que e Quando Desempenhar Esta Tarefa

Você pode usar consultas de URL para gerar listas filtradas de registros de forma programática antes de exportá-los. As consultas de URL são úteis para scripts que geram uma lista de registros ou quando nenhum usuário pode adicionar manualmente o filtro da IU.

Você deve estar familiarizado com ServiceNow Nomes de tabela e coluna para exportar dados diretamente do URL. Consulte Navegue até um registro ou um módulo usando um URL .

Você pode controlar se deseja exportar o valor de exibição ou o valor bruto dos campos e o rótulo do campo ou o nome do campo para cabeçalhos usando parâmetros de consulta ou propriedades do sistema.

Para obter detalhes sobre como usar parâmetros de consulta, consulte Query parameters for display value and header.
Para obter detalhes sobre como usar as propriedades do sistema, consulte System properties for display value and header.

Os parâmetros de consulta, se presentes, substituem as propriedades do sistema.

Procedimento

Especifique o URL da instância.
Por exemplo:
```
https://<instance name>.service-now.com/
```
Especifique o formulário de tabela ou a lista a ser exportada.
Por exemplo:
```
incident_list.do
```
Especifique o processador de formato de exportação a ser usado para a exportação.
Você pode especificar CSV, XLS, JSON, XLSX ou XML. Por exemplo:
```
?CSV
```
Nota:
O processador XML em uma exportação de URL não exporta anexos ou campos de diário. Para exportar anexos e campos de diário, como Anotações de trabalho ou Comentários adicionais campos, exporte os registros de uma lista usando Exportar > XML no menu de contexto.
Opcional: Consulte registros específicos adicionando o. sysparm_queryparâmetro.
A sintaxe necessária é [nome da coluna][operador][valor] . Por exemplo:
```
https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1
```
Nota:
Todas as consultas usam um nome de coluna, um operador e um valor. Consulte Construtor de condições para obter uma lista de operadores disponíveis.
Opcional: Classifique os registros por nome de coluna usando sysparm_orderbyparâmetro.
A sintaxe necessária é [nome da coluna] . Por exemplo:
```
https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to
```
Nota:
Você pode classificar por apenas uma coluna usando sysparm_orderby. Para classificar por várias colunas, use várias entradas orderby. Por exemplo:
```
sysparm_query=ORDERBYassigned_to^ORDERBYpriority
```
Opcional: Exporte campos de uma exibição específica usando sysparm_viewparâmetro.
A sintaxe necessária é [nome da exibição] . Por exemplo:
```
https://<instance name>.service-now.com/incident.do?CSV&sysparm_view=ess
```
Este URL exporta campos de incidente visíveis na exibição Autoatendimento (ess).
- Por padrão, a exportação de dados de uma lista exporta somente os campos que estão visíveis na exibição atual. Se você quiser exportar campos de outra exibição de lista, poderá alternar as exibições da IU. Consulte Gestão de exibição .
- Se você estiver exportando dados CSV ou Excel e não especificar uma exibição, a exportação usará a exibição de lista padrão.
- Se você estiver exportando dados XML, todos os campos serão exportados por padrão, a menos que você especifique uma exibição específica.
Opcional: Exporte campos específicos da tabela usando sysparm_fieldsparâmetro.
A sintaxe necessária é [fields],[field1],[field2] . Por exemplo:
```
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_fields=sys_id,number
```
Opcional: Exporte todos os campos da tabela, incluindo o sys_id, usando sysparm_default_export_fieldsparâmetro.
A sintaxe necessária é _default_export_fields_all . Por exemplo:
```
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_default_export_fields=all
```
. sysparm_default_export_fieldsO parâmetro não tem efeito nas exportações XML, a menos que você inclua o. sysparm_viewparâmetro para especificar uma exibição não padrão.

URLs de amostra


URL	Descrição
https://<instance name>.service-now.com/incident_list.do?CSV	Exporte todos os incidentes para um arquivo de texto de valor separado por vírgulas.
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27	Exporte um incidente específico para um arquivo de texto de valor separado por vírgulas.
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_orderby=sys_id	Exporte todos os incidentes para um arquivo de texto de valor separado por vírgulas e classifique a lista por sys_id.
https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to	Exporte uma lista de todos os incidentes de Prioridade 1 para um arquivo XML e classifique a lista por Atribuído a. campo.