Exportar diretamente de uma URL

Versão de lançamento: Yokohama

Atualizado 30 de jan. 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 impõe 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á-las. 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 a tabela ServiceNow e os nomes de coluna para exportar dados diretamente do URL. Consulte Como navegar até um registro ou módulo usando uma 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 Parâmetros de consulta para valor de exibição e cabeçalho.
Para obter detalhes sobre como usar as propriedades do sistema, consulte Propriedades do sistema para valor de exibição e cabeçalho.

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 os campos Anotações de trabalho ou Comentários adicionais, exporte os registros de uma lista usando o Exportar > XML opção no menu de contexto.
Opcional: Consulte registros específicos adicionando o parâmetro sysparm_query.
A sintaxe necessária é sysparm_query=[column name][operator][value]. 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 o Construtor de condições para obter uma lista de operadores disponíveis.
Opcional: Classifique os registros por nome de coluna usando o parâmetro sysparm_orderby.
A sintaxe necessária é sysparm_orderby=[column name]. 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 o parâmetro sysparm_view.
A sintaxe necessária é sysparm_view=[view name]. Por exemplo:
```
https://<instance name>.service-now.com/incident.do?CSV&sysparm_view=ess
```
Este URL exporta campos de incidentes visíveis na exibição de 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 Gerenciamento 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 o parâmetro sysparm_fields.
A sintaxe necessária é sysparm_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 o parâmetro sysparm_default_export_fields.
A sintaxe necessária é sysparm_default_export_fields=all. Por exemplo:
```
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_default_export_fields=all
```
O parâmetro sysparm_default_export_fields não tem efeito nas exportações XML, a menos que você inclua o parâmetro sysparm_view 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 com valores separados 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 com valores separados 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 com valores separados por vírgula 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 campo Atribuído a.