Exportation des vues de rapports sauvegardés

Utilisez l'opération GET sur l'élément api/reports/report_ID pour exporter une vue de rapport sauvegardé qui pourra ensuite être importée vers une autre instance de BigFix Inventory.

Tableau 1. Descriptions des opérations
Détails de l'opération	Description
Fonctionnement	`GET /api/reports/report_ID`
Finalité	Renvoie la vue de rapport sauvegardé avec l'ID indiqué.
Méthode HTTP	`GET`
URI de resources	https://`server_host_name`:`port_number`/api/reports/`report_ID`
Relation du lien de l'URL	n/a
Paramètres de requête URI	Pour une liste de paramètres de requêtes applicables, voir : Paramètres de requête.
En-têtes de demande	Fonction métier `Accept-Language` (Facultatif) Valeurs en-US (seul l'anglais est pris en charge) Sert à négocier la langue de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la demande	Non disponible
Demande `Content-Type`	`Application/json`
En-têtes de réponse	En-tête `Content-Type` Valeurs `Application/json` Définit le type de contenu de la réponse.
En-têtes de réponse	En-tête `Content-Language` Valeurs en-US, … Définit la langue du contenu de la réponse. Si cet en-tête n'est pas spécifié, le contenu est renvoyé dans la langue du serveur.
Charge de la réponse	élément de rapports sauvegardés
Réponse`Content-Type`	`Application/json`
Codes de réponse normaux HTTP	`200 – OK`
Codes de réponse HTTP d'erreur	`401- There is no match for the provided user name and password` `401 - You are not assigned a Computer Group. You will not be able to access the system until you are assigned a valid Computer Group. Contact your administrator for assistance` `404 - Sequel::RecordNotFound` Pour plus de détails concernant chaque code d'erreur, vérifiez le fichier journal tema.log situé dans le répertoire `install_dir`/wlp/usr/servers/server1/logs/.

Paramètres de requête

Vous pouvez utiliser des paramètres de requête pour limiter le nombre de résultats de votre recherche. Le tableau suivant présente les paramètres de requête que vous pouvez utiliser pour l'élément api/reports.

Tableau 2. Paramètres de requête pour l'extraction de vues de rapports sauvegardés
Paramètre	Description	Requis	Valeur
Jeton	Identificateur d'authentification utilisateur unique.	Oui	Alphanumérique
id	Un identificateur du rapport sauvegardé. Pour trouver un identificateur de rapports, ouvrez le rapport sauvegardé puis vérifiez le dernier numéro dans l'URL du rapport. Dans l'exemple suivant, l'ID du rapport est 3. `server_host_name:port/sam/app_usage_property_values#cafcac39cd0b242b82729377b0b2b872d3af8d8a/3`	Non	Numérique

Exemple de conversation HTTP

Demande

GET/api/reports/1
&token=a070afeca411d2fs25f5s4c962de2d002b14352f

En-tête de réponse

HTTP/1.1 200 OK
Content-Type: Application/json
Content-Language: en-US

Corps de réponse (JSON)

	{
	"id":1,
	"user_id":1,
	"pagestate_id":"eb5743b7cd23316f0bc8a4dd3f63b90d73549042",
	"name":"pvu_test",
	"path":"/sam/pvuonlysubcapreports",
	"private":true,
	"state":{
		"columns":["product","quantity","hwm_history"],
		"criteria":{"and":[["quantity",">","200"]]},
		"grid_options":["autosize_columns"],
		"order":{"asc":true,"col":null},
		"time_range":{
			"max":"2014-07-21T10:18:04Z",
			"min":"2014-04-21T22:00:00Z",
			"type":"absolute_to_now",
			"units":"days",
			"value":"90"
			},
		"column_order":{
			"hwm_history":1,
			"product":0,
			"quantity":2
			},
		"column_widths":{
			"hwm_history":180,
			"product":524,
			"quantity":719
		}}}