API Fiches descriptives

Les fiches de renseignements sont utilisées pour stocker, adapter, organiser et traiter les données depuis diverses sources avant, pendant et après un événement de sourcing dans CSO.

Les champs de faits définissent les données à maintenir, tout comme les champs d'article ou les colonnes dans une feuille de travail Excel. Chaque ligne de faits ne doit contenir qu'une seule valeur pour chaque champ de faits afin de pouvoir utiliser les données efficacement. Les fiches d'information sont utilisées pour entrer des données dans l'événement, par exemple des volumes historiques ou d'autres spécifications d'articles, des scores de performance des fournisseurs, des listes d'adresses et des codes pour les usines, les articles ou les services, des codes postaux, des latitudes, etc. 

Utilisez les API de feuilles de faits pour créer, mettre à jour ou interroger les données des feuilles de faits. Cela inclut des points de terminaison spécifiques pour prendre des mesures (créer/mettre à jour/supprimer) ainsi que les données associées aux lignes et aux champs.

L'URL pour accéder aux API est : https ://.cso.coupahost.com/api/events/<instance> {event-id}/fact-sheets

Voir les meilleures pratiques d'intégration pour plus d'informations.

Actions

Éléments

Ce sont les éléments disponibles pour l'API Fact Sheets

Exemples

Dans cet exemple, nous avons demandé une API Fact Sheets.

https ://<instance>.cso.coupahost.com/api/events/{event-id}/fact-sheets 

Nous avons accédé à l'URL ci-dessous pour un exemple d'Event-id = 9219593444837772101 : 

htpss ://<instance>.cso.coupacloud.com/api/events/9219593444837772101/fact-sheets

Fiches descriptives OBTENIR UNE RÉPONSE

{

		"total" : 4,

		"fiches techniques" : [

				{

						"id" : "9219593444824438589",

						"ordinal" : 0,

						"type" : "Ordinaire",

						"nom" : "B_Supernova 2014 - Analyse Rd2",

						"formula-name" : "b_supernova_2014_rd2_analysis",

						"event-id" : "9219593444837772101",

						"created-time" : "27/02/2015T16:56:09.875+0000"

				},

				{

						"id" : "9219593444824438592",

						"ordinal" : 1,

						"type" : "Ordinaire",

						"nom" : "PD_Détails du projet",

						"formula-name" : "pd_project_details",

						"event-id" : "9219593444837772101",

						"created-time" : "27/02/2015T16:56:09.875+0000"

				},

				{

						"id" : "9219601795978222763",

						"ordinal" : 1,

						"type" : "Rapports",

						"nom" : "Rapports de gestion",

						"formula-name" : "gestion_rapports",

						"event-id" : "9219593444837772101",

						"created-time" : « 2020-02-10T03:17:03.96+0000 »

				},

				{

						"id" : "9219601942217814052",

						"ordinal" : 1,

						"type" : "Rapports",

						"nom" : "Tester le statut de tous les événements",

						"formula-name" : "test_all_event_status",

						"event-id" : "9219593444837772101",

						"description" : "Tester le statut de tous les événements",

						"created-time" : « 2020-09-09T10:30:07.376+0000 »

				} 

	 ]

}

Créer/Mettre à jour/Supprimer

Ce qui suit décrit comment vous pouvez utiliser l'API Coupa pour effectuer des actions sur des fiches d'information.

Créer

/api/events/:id/fact-sheets

La charge utile ci-dessous crée une nouvelle fiche d'information sur un événement(9220538753252871154)

Charge utile : 

{

		"fiches techniques" : [

				{

						"id" : "9220538753431210838",

						"nom" : "demo-factsheet-new",

						"event-id" : "9220538753252871154",

						"description" : "test de la fiche de démonstration à l'aide de l'API"

				}

		]

}



Réponse : 201

{

		"result" : [

				{

						"type" : "api.post.added",

						"description" : "1 objets créés."

				}

		],

		"ajouté" : 1,

		"fiches techniques" : [

				{

						"id" : "9220538753455571178"

				}

		]

}		

Mettre à jour

/api/events/{event-id}/fact-sheets

La charge utile ci-dessous met à jour une ou plusieurs fiches d'informations.  

Pour mettre à jour un ou plusieurs événements à la fois : 

Charge utile :

{

		"fiches techniques" : [

				{

						"id" : "9220538753461853110",

						"name" : "démo-factsheet-newest",

						"formula-name" : "demo_factsheet_newest",

						"description" : "test de la fiche de démonstration à l'aide de l'API avec ordinal"

				}

		]

}



Réponse : 200 OK

{

		"result" : [

				{

						"type" : "api.put.updated",

						"description" : "1 objets mis à jour."

				}

		],

		"mis à jour" : 1

}



Vous ne pouvez mettre à jour que les champs name/formula-name/description d'une fiche de fait.

Supprimer

/api/events/{event-id}/fact-sheets

L'API ci-dessus peut être utilisée pour supprimer plusieurs fiches d'information à la fois. 

Charge utile :

{

		"fiches techniques" : [

				{

						"id" : "9220538753461853110"

				}

		]

}



Réponse : 200 OK

{

		"result" : [

				{

						"type" : "removedFactSheets",

						"description" : "Les fiches d'informations suivantes ont été enlevées : demo-factsheet-newest"

				}

		],

		"supprimé" : 1

}

Les demandes réussies renverront une réponse HTTP 200. Le corps de la réponse inclura la demande créée. Les demandes infructueuses renverront HTTP 400 Bad Request. Le corps de la réponse comprendra des erreurs de validation formatées en XML.