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. |
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
- Le paramètre de clé API dans la configuration ci-dessus peut être laissé vide tout en optant pour l'authentification OIDC.
- 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
core.user.read
est une portée obligatoire requise pour effectuer la connexion de test avec succès avec l'authentification OIDC.- 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.
Si vous codez manuellement l'application Mule dans l'éditeur XML de Studio ou dans un autre éditeur de texte, définissez l'espace de noms et l'emplacement du schéma dans l'en-tête de votre XML de configuration, à l'intérieur de la <mule>
balise.
<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>
CONSEIL |
À l'intérieur |
Démonstration des applications de mule à l'aide du connecteur
Démonstration existante montrant comment utiliser le connecteur pour :
Exemple de cas d'utilisation
L'exemple suivant montre comment obtenir une facture à l'aide du connecteur :
Obtenir une facture
- Dans Anypoint Studio, cliquez sur File > New > Mule Project, nommez le projet, puis cliquez sur OK.
- 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.
- 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.
- Laisser les valeurs par défaut et cliquer sur OK.
- Définir la valeur sur "show-invoice".
- 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.
- 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.
- Enfin, vous pouvez essayer la démo en faisant une demande à http ://localhost :8081/show-invoice
Une fois qu'un type d'objet est sélectionné, la vue des métadonnées de sortie est générée en fonction du choix
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.
Une partie ou la totalité de cette page peut avoir été traduite par machine. Toutes nos excuses pour les inexactitudes.