---
title: Webservice – Exportação de Dados
slug: dev-pt/webservice-exportacao-de-dados
description: Discover how to retrieve data from CITSmart database tables in XML format using WebService requests. This document includes examples of various query conditions and parameters, such as querying by primary key, primary key with additional clauses, and with
docTags: 
createdAt: 2022-03-07T15:58:04.000Z
---

Por meio dessa funcionalidade, é possível, por solicitação ao WebService, obter dados das tabelas do Banco de Dados do CITSmart para um arquivo XML.
As condições de consulta para os registros que serão retornados são passadas como parâmetros via URL, conforme o exemplo abaixo:

:::BlockQuote
[http://localhost/citsmart/services/data/cargos/19](http://localhost/citsmart/services/data/cargos/19)
:::

Essa solicitação retorna os registros da tabela de posições em que o idcargo, ou seja, a chave primária da tabela de cobranças, é igual a 19. A consulta gerada com essa solicitação é esta:

```mysql
 SELECT IDCARGO, NOMECARGO, DATAINICIO, DATAFIM, IDDESCRICAOCARGO FROM CARGOS WHERE IDCARGO = 19  
```

Abaixo estão listadas as possibilidades e parâmetros que podem ser usados para recuperação de dados usando esta funcionalidade:

## Consulta PK

É possível obter um registro de acordo com o campo Chave Primária da tabela relatada.

:::CodeblockTabs
```html
 	http://<SERVER ADDRESS>/citsmart/services/data/<TABLE>/<PK VALUE>
```

```mysql
	SELECT * FROM <TABLE_NAME> WHERE <PK_FIELD> = <PK_VALUE>
```

Exemplo

```none
	http://localhost/citsmart/services/data/process/19
	   Ele irá procurar na tabela PROCESS com a chave PK igual a 19.
```
:::

## Consulta por PK e Where

É possível obter um registro de acordo com um campo de Chave Primária da tabela fornecida e que atenda às condições de uma cláusula where.

:::CodeblockTabs
```html
 	http://<SERVER ADDRESS*>/citsmart/services/data/<TABLE>/<PK_VALUE>?cond=<ADDITIONAL_CLAUSES>
```

```mysql
	SELECT * FROM <TABLE_NAME> WHERE <PK_FIELD> = <PK_VALUE> AND (<ADDITIONAL_CLAUSES>)
```

Exemplo

```none
        http://localhost/citsmart/services/data/cargos/22?cond=nomecargo like "Diretor"
```
:::

## Where e Consulta Ordenada

É possível obter registros ordenados de uma tabela de acordo com as condições de uma cláusula where e campo para ordenação.

:::CodeblockTabs
```html
 	http://<SERVER ADDRESS*>/citsmart/services/data/<TABLE>?cond=<WHERE_CRITERIA>&order=<ORDERING FIELD>
```

```mysql
	SELECT * FROM <TABLE_NAME> WHERE (<WHERE CRITERIA>) ORDER BY <ORDERING FIELD>
```

Exemplo

```none
	http://localhost/citsmart/services/data/cargos?cond=idcargo<15 and idcargo > 10&order=nomecargo
```
:::

## Consulta com vínculos ao Where e Ordenação

É possível obter registros ordenados de uma tabela, juntamente com os registros com os quais eles estão vinculados, de acordo com as condições de uma cláusula where e de um campo para ordenação.

:::CodeblockTabs
```html
	http://<SERVER ADDRESS*>/citsmart/services/data/<TABLE>?cond=<WHERE_CRITERIA>&order=<ORDERING FIELD>&links=<s_ou_n>
```

```mysql
	SELECT * FROM <TABLE_NAME> WHERE (<WHERE CRITERIA>) ORDER BY <ORDERING FIELD>
```

Exemplo

```none
   	http://localhost/citsmart/services/data/localidade?cond=idlocalidade=1&order=idlocalidade&links=s
```

Campos

```none
	cond = Refere-se às condições da cláusula where;
	order = Campo que será usado na ordem por cláusula;
	links = "S" ou "N". Quando S, a consulta também exportará ligações de chaves estrangeiras. Ou seja, os registros de outras tabelas que fazem referência a esse registro. Por padrão, quando essa opção não é inserida, o valor é N.
```
:::