Connecteur Coupa pour Mulesoft

Introduction

Ce connecteur facilite l'intégration avec l'API de Coupa en fournissant un moyen d'accéder aux services Web de Coupa. Vous pouvez utiliser le connecteur Coupa dans les flux de mules pour envoyer et recevoir des données à l'aide de l'API Coupa avec la prise en charge de la dernière authentification oAuth2/OIDC.

Il donne accès aux adresses | Avis préalable d'expédition | Approbations | Contrats | Reçus alias Transactions d'inventaire | Articles | Valeurs de recherche | Bons de commande | Demandes | Fournisseurs | Utilisateurs | Frais | Paiements CoupaPay | Rapports de dépenses | Facture | Articles fournisseurs | Adresses de versement | Déclarations | Réduction dynamique | Projets | Tâches | Ligne budgétaire | Ajustements de la ligne budgétaire | Réponses au formulaire facile | Informations sur le fournisseur.

Lisez ce guide de l'utilisateur pour comprendre comment configurer un flux de base à l'aide du connecteur. Suivez les ajouts de fonctionnalités, la compatibilité, les limitations et les mises à jour de la version de l'API à chaque version du connecteur à l'aide des notes de version du connecteur ci-jointes ci-dessous. Passez en revue les opérations et les fonctionnalités du connecteur à l'aide de l'application de démonstration jointe ci-dessous.

Détails supplémentaires sur le connecteur Coupa : Site d'échange de mulets.

MuleSoft maintient ce connecteur dans le cadre de la politique de support certifié.

Prérequis

Ce document suppose que vous connaissez Mule, Anypoint Studio, Anypoint Core Components et Mule Flow Design Center.

Configuration matérielle et logicielle requise

Pour connaître les exigences matérielles et logicielles, veuillez consulter la page Exigences matérielles et logicielles.

Compatibilité

Logiciels	Version
Mule Runtime	4.1.x et supérieur

Installation du connecteur

Vous pouvez installer le connecteur dans Anypoint Studio en suivant les instructions de la section Installation d'un connecteur à partir d'Anypoint Exchange.

Configuration de l'élément global du connecteur

Pour utiliser le connecteur Coupa dans votre application Mule, vous devez configurer un élément Coupa global qui peut être utilisé par le connecteur Coupa. Le connecteur Coupa offre la (les) configuration(s) globale (s) suivante (s), nécessitant les informations d'identification suivantes : Cléet instance de l'API Coupa :

Pour utiliser le connecteur Coupa dans votre application Mule, vous devez configurer un élément Coupa global qui peut être utilisé par le connecteur Coupa. Le connecteur Coupa offre la (les) configuration(s) globale (s) suivante (s), nécessitant les informations d'identification suivantes : Clé API Coupa (obsolète à partir de R35), informations d'identification et instance client OIDC :

Vous pouvez générer des informations d'identification client sur l'instance Coupa à l'adresse suivante : https ://{instance_name}/oauth2/clients

Documentation de référence pour OIDC/Oauth2 : Démarrez avec l'API Coupa

Champ	Description
Clé API Coupa	Entrez la clé API récupérée auprès de votre administrateur Coupa ou de votre architecte d'intégration pour l'authentification API (cette option sera dépréciée à partir de R35. Utiliser les informations d'identification du client OIDC comme alternative à la clé API traditionnelle).
Session	Remplissez l'URL de l'instance Coupa ici. Exemple : https://customer_name.coupahost.com
ID du client OIDC	Entrez l'ID client récupéré par votre administrateur Coupa ou votre architecte d'intégration requis pour l'authentification OIDC.
Secret OIDC	Entrez le secret client récupéré par votre administrateur Coupa ou votre architecte d'intégration requis pour l'authentification OIDC.
Champ d'application de l'OIDC	Entrez la liste des étendues appliquées aux informations d'identification du client pour l'authentification OIDC.

Conseils de configuration

1. Le paramètre de clé API dans la configuration ci-dessus peut être laissé vide tout en optant pour l'authentification OIDC.
2. Dans le cas où la clé API est renseignée avec les informations d'identification du client OIDC (ID client, secret, portée), la priorité sera donnée à l'authentification OIDC.

Notes de configuration

1. core.user.read est une portée obligatoire requise pour effectuer la connexion de test avec succès avec l'authentification OIDC.
2. Plusieurs étendues OIDC peuvent être séparées avec l'un des délimiteurs suivants - virgule, espace, %20.

Exemples

• core.invoice.read,core.purchase_order.read,core.user.read
• core.invoice.read, core.purchase_order.read, core.user.read
• core.invoice.read core.purchase_order.read core.user.read
• core.invoice.read%20core.purchase_order.read%20core.user.read

Utilisation du connecteur

Espace de noms et schéma du connecteur

Lors de la conception de votre application dans Studio, le fait de faire glisser le connecteur de la palette sur le canevas Anypoint Studio doit automatiquement remplir le code XML avec l'espace de noms et l'emplacement du schéma du connecteur.

<mule xmlns :coupa="http://www.mulesoft.org/schema/mule/coupa" xmlns="http://www.mulesoft.org/schema/mule/core"
 xmlns :doc="http://www.mulesoft.org/schema/mule/documentation"
 xmlns :xsi="http://www.w3.org/2001/XMLSchema-instance" xsi :schemaLocation="http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/coupa http://www.mulesoft.org/schema/mule/coupa/current/mule-coupa.xsd">
   <!-- put your global 0configuration elements and flows here -->
</mule>

Démonstration des applications de mule à l'aide du connecteur

Démonstration existante montrant comment utiliser le connecteur pour :

• Application DE flux de DÉMO

Exemple de cas d'utilisation

L'exemple suivant montre comment obtenir une facture à l'aide du connecteur :

Obtenir une facture

1. Dans Anypoint Studio, cliquez sur File > New > Mule Project, nommez le projet, puis cliquez sur OK.
2. Dans la palette Mule, cliquez sur le groupe « HTTP » et sélectionnez le composant Listener. Maintenant, faites-le glisser et déposez-le dans le concepteur de flux.
3. Tout d'abord, nous devons créer une configuration pour l'écouteur HTTP avant de l'utiliser. Cliquer sur l'écouteur HTTP et ajouter une nouvelle configuration en appuyant sur l'icône verte plus.
4. Laisser les valeurs par défaut et cliquer sur OK.
5. Définir la valeur sur "show-invoice".
   
6. Dans la palette de mules, cliquez sur le groupe « Coupa » et faites glisser le curseur  dans le concepteur de flux, puis créez une nouvelle configuration et définissez votre clé API et l'URL de l'instance.
7. Dans la section Coupa Général, pour Type d'objet, choisissez Facture (facture) et mettez 1 (ou tout identifiant de facture valide) dans le champ ID.
   
8. Enfin, vous pouvez essayer la démo en faisant une demande à http ://localhost :8081/show-invoice

Traitement des erreurs

Le connecteur peut générer un type d'erreurs différent lors de son utilisation dans les flux. Il est bon de configurer une stratégie distincte pour chaque type d'erreur à l'aide des composants de gestion des erreurs.

Erreurs Coupa :

• COUPA :CONNECTIVITÉ
• COUPA :EXÉCUTION
• COUPA :INVALID_AUTH
• COUPA :INVALID_PARAMS

Configurer les champs personnalisés

Des champs personnalisés peuvent être ajoutés en plus des champs de détection de données de base. Les types de données disponibles pour les champs personnalisés sont String, Date, Date_Time, Integer, Double, Float, Long, Decimal, Boolean et Reference.       

Exemple de configuration :

some-custom-field,String ; other-custom-field,Date_Time ; custom-reference-field,Reference :user

Les champs personnalisés peuvent être ajoutés dans l'onglet Métadonnées personnalisées de la configuration globale de Coupa.

API Resources

• Accéder aux références de l'API Coupa
• Accédez aux opérateurs Coupa API
• Accéder aux arguments de l'API Coupa
• Accédez aux actions spéciales de l'API Coupa

Documentation sur le module mule

Documentation sur les connecteurs Mulesoft

Notes de version du connecteur Coupa

• Notes de version du connecteur Coupa Mulesoft v4.1.0.0.pdf
• Notes de version du connecteur Coupa Mulesoft v4.0.0.0.pdf
• Notes de version du connecteur Coupa Mulesoft v3.0.0.pdf

Ressources d'assistance

• Découvrez comment les connecteurs ont changé dans Mule 4.1 Introduction à Mule 4 : Connecteurs.
• Accédez au forum MuleSoft pour publier des questions et obtenir de l'aide de la vaste communauté d'utilisateurs de Mule.
• Pour accéder à l'équipe d'assistance experte de MuleSoft, abonnez-vous et connectez-vous au portail client de MuleSoft.
• Pour joindre l'équipe d'assistance Coupa, contactez votre administrateur Coupa.