Exemples d'appels API Lookup Values

Différentes options de requête pour les valeurs de recherche

Voici d'autres exemples d'utilisation de l'API Lookup Values pour interroger et obtenir le jeu de résultats souhaité.

Cette requête vous donnera les valeurs de recherche qui sont actives

https://<instance>.coupahost.com/api/lookup_values?active=true

Cette requête vous donnera les valeurs de recherche qui ont été créées après une certaine date

https://<instance>.coupahost.com/api/lookup_values?created_at[gt]=2014-04-22

Cette requête vous donnera toutes les valeurs de recherche pour toutes les recherches qui ont été créées après une certaine date

https://<instance>.coupahost.com/api/lookup_values?[lookup][created-at][gt]=2014-04-22

Exemple d'obtention d'API Lookup Values

Dans cet exemple, nous avons recherché une valeur de recherche unique avec un ID de 1.

Nous avons accédé à l'URL :

https://<instance url>/api/lookup_values/1
ou
https://<instance url>/api/lookup_values?1

Voici la réponse correspondant aux critères de recherche :

<?xml version="1.0" encoding="UTF-8"?>
<lookup-value>
	 <id type="integer">1</id>
	 <created-at type="datetime">2014-04-23T11:24:10-07:00</created-at>
	 <updated-at type="datetime">2014-04-24T09:08:41-07:00</updated-at>
	 <active type="boolean">true</active>
	 <name>TestAccount1</name>
	 <description>DescAccountNo1</description>
	 <external-ref-num>ExtRefAccnt1</external-ref-num>
	 <external-ref-code>ExtRefAccnt1</external-ref-code>
	 <parent-id nil="true" />
	 <lookup-id type="integer">1</lookup-id>
	 <depth type="integer">0</depth>
	 <account-type nil="true" />
	 <lookup>
			<id type="integer">1</id>
			<created-at type="datetime">2014-04-23T11:22:10-07:00</created-at>
			<updated-at type="datetime">2014-04-23T11:22:10-07:00</updated-at>
			<active type="boolean">true</active>
			<name>Account</name>
			<description>Account</description>
			<fixed-depth type="integer">0</fixed-depth>
			<level-1-name />
			<level-2-name />
			<level-3-name />
			<level-4-name />
			<level-5-name />
			<level-6-name />
			<level-7-name />
			<level-8-name />
			<level-9-name />
			<level-10-name />
	 </lookup>
	 <created-by>
			<id type="integer">1</id>
			<login>coupasupport</login>
			<email>upgrade@coupa.com</email>
			<employee-number nil="true" />
			<firstname>Coupa</firstname>
			<lastname>Support</lastname>
			<salesforce-id nil="true" />
			<mycustom-userfield />
	 </created-by>
	 <updated-by>
			<id type="integer">1</id>
			<login>coupasupport</login>
			<email>upgrade@coupa.com</email>
			<employee-number nil="true" />
			<firstname>Coupa</firstname>
			<lastname>Support</lastname>
			<salesforce-id nil="true" />
			<mycustom-userfield />
	 </updated-by>
</lookup-value>

Création de valeurs de recherche

Dans cet exemple, nous insérons des valeurs de recherche pour l'une des recherches existantes dans COUPA. Nous n'utilisons aucun ID système Coupa pour les objets de référence.

Nous l'avons publié sur l'URL : https://<instance url>/api/lookup_values.

<?xml version="1.0" encoding="UTF-8"?>
<lookup-value>
	 <name>TestAccount2</name>
	 <description>DescAccountNo2</description>
	 <external-ref-num>ExtRefAccnt2</external-ref-num>
	 <external-ref-code>ExtRefAccnt2</external-ref-code>
	 <active>yes</active>
	 <lookup>
			<name>Account</name>
	 </lookup>
</lookup-value>

 API de valeurs de recherche - Exemple PUT

Exemple pour un PUT :

Pour activer ou désactiver une valeur de recherche

URL : https://<instance>/api/lookup_values/<id>

Exemple de code pour désactiver une valeur de recherche

<?xml version="1.0" encoding="UTF-8"?>
<lookup-value>
	 <active>false</active>
</lookup-value>

Pour mettre à jour la description d'une valeur de recherche

URL : https://<instance>/api/lookup_values/<id>

Exemple de code pour mettre à jour la recherche d'une valeur de recherche

<?xml version="1.0" encoding="UTF-8"?>
<lookup-value>
	 <lookup-id>2</lookup-id>
</lookup-value>