Was können wir Ihnen dabei helfen? Produkte Plattform Integrations-Playbooks und -Ressourcen Andere Integrations-Playbooks Coupa Connector für Mulesoft

Coupa Connector für Mulesoft

Revised: 02 March 2021

Einleitung

Dieser Konnektor erleichtert die Integration mit der Coupa-API und ermöglicht den Zugriff auf Coupa-Webdienste. Sie können den Coupa-Connector in Mule-Flows verwenden, um Daten über die Coupa-API mit Unterstützung der neuesten oAuth2/OIDC-Authentifizierung zu senden und zu empfangen.

Lesen Sie dieses Benutzerhandbuch, um zu erfahren, wie Sie einen grundlegenden Ablauf mit dem Connector einrichten und konfigurieren. Verfolgen Sie Funktionserweiterungen, Kompatibilität, Einschränkungen und API-Versionsaktualisierungen mit jeder Version des Connectors mithilfe der unten angehängten Connector-Versionshinweise. Prüfen Sie die Connector-Vorgänge und -Funktionen mithilfe der unten angehängten Demo-Anwendung.

Weitere Details zum Coupa-Anschluss: Maultier-Austauschplatz.

MuleSoft pflegt diesen Connector gemäß der Certified Support-Richtlinie.

Voraussetzungen

In diesem Dokument wird davon ausgegangen, dass Sie mit Mule, Anypoint Studio, Anypoint Core Components und Mule Flow Design Center vertraut sind.

Hardware- und Softwareanforderungen

Hardware- und Softwareanforderungen finden Sie auf der Seite Hardware- und Softwareanforderungen.

Kompatibilität

Software	Version
Maultier-Laufzeit	4.1.x und höher

Verbinder wird installiert

Sie können den Connector in Anypoint Studio mithilfe der Anweisungen unter Installieren eines Connectors von Anypoint Exchange installieren.

Konfigurieren des globalen Connector-Elements

Um den Coupa-Connector in Ihrer Mule-Anwendung zu verwenden, müssen Sie ein globales Coupa-Element konfigurieren, das vom Coupa-Connector verwendet werden kann. Der Coupa-Connector bietet die folgenden globalen Konfigurationen, für die die folgenden Anmeldeinformationen erforderlich sind: Coupa-API-Schlüssel und -Instanz :

Um den Coupa-Connector in Ihrer Mule-Anwendung zu verwenden, müssen Sie ein globales Coupa-Element konfigurieren, das vom Coupa-Connector verwendet werden kann. Der Coupa-Connector bietet die folgende (n) globale (n) Konfiguration(en), für die die folgenden Anmeldeinformationen erforderlich sind: Coupa-API-Schlüssel (veraltet ab R35), OIDC-Client-Anmeldedaten und -Instanz:

Sie können Client-Anmeldeinformationen auf der Coupa-Instanz unter folgendem Pfad generieren: https://{instance_name}/oauth2/clients

Referenzdokumentation für OIDC/Oauth2: Erste Schritte mit der Coupa-API

Feld	Beschreibung
Coupa-API-Schlüssel	Geben Sie den API-Schlüssel ein, der von Ihrem Coupa-Administrator oder Integrationsarchitekten für die API-Authentifizierung abgerufen wurde (Diese Option ist ab R35 veraltet. Verwenden Sie OIDC-Client-Anmeldeinformationen als Alternative zum herkömmlichen API-Schlüssel).
Instanz	Füllen Sie die Coupa-Instanz-URL hier aus. Beispiel: `https://customer_name.coupahost.com`
OIDC-Client-ID	Geben Sie die Client-ID ein, die von Ihrem Coupa-Administrator oder Integrationsarchitekten abgerufen wurde und für die OIDC-Authentifizierung erforderlich ist.
OIDC-Geheimnis	Geben Sie das Clientgeheimnis ein, das von Ihrem Coupa-Administrator oder Integrationsarchitekten abgerufen wurde und für die OIDC-Authentifizierung erforderlich ist.
OIDC-Umfang	Geben Sie die Liste der Bereiche ein, die auf die Client-Anmeldeinformationen für die OIDC-Authentifizierung angewendet werden.

Konfigurationstipps

Der API-Schlüsselparameter in der obigen Konfiguration kann leer bleiben, während Sie sich für die OIDC-Authentifizierung entscheiden.
Wenn der API-Schlüssel zusammen mit den OIDC-Client-Anmeldeinformationen (Client-ID, Secret, Scope) ausgefüllt wird, wird der OIDC-Authentifizierung Vorrang eingeräumt.

Konfigurationshinweise

core.user.read ist ein obligatorischer Umfang, der erforderlich ist, um die Testverbindung mit der OIDC-Authentifizierung erfolgreich abzuschließen.
Mehrere OIDC-Umfänge können mit einem der folgenden Trennzeichen getrennt werden - Komma, Leerzeichen, %20.

Beispiele

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

Benutzung des Connectors

Connector-Namespace und Schema

Beim Entwerfen Ihrer Anwendung in Studio sollte der Vorgang des Ziehens des Connectors von der Palette auf die Anypoint Studio-Leinwand automatisch den XML-Code mit dem Connector-Namespace und dem Schema-Speicherort füllen.

Tipp

Wenn Sie die Mule-Anwendung manuell im XML-Editor von Studio oder einem anderen Texteditor codieren, definieren Sie den Namespace und den Schemaspeicherort in der Kopfzeile Ihres Konfigurations-XML innerhalb des <mule> Tags.

<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">

</mule>

TIPP

Geben Sie innerhalb der <version> Tags die gewünschte Versionsnummer, das Wort RELEASE für die neueste Version oder SNAPSHOT für die neueste verfügbare Version ein. Die bisher verfügbaren Versionen sind: 4.0.0

Demo-Mule-Anwendungen mit Connector

Vorhandene Demo zeigt, wie der Connector verwendet wird für:

Demo-Flows-App

Anwendungsbeispiel

Das folgende Beispiel zeigt, wie Sie mit dem Connector eine Rechnung erhalten:

Rechnung anfordern

Klicken Sie in Anypoint Studio auf Datei > Neu > Maultierprojekt, benennen Sie das Projekt, und klicken Sie auf OK.

Klicken Sie in der Maultierpalette auf die Gruppe „HTTP“ und wählen Sie die Listener-Komponente aus. Ziehen Sie es nun per Drag & Drop in den Flow-Designer.

Zuerst müssen wir eine Konfiguration für den HTTP-Listener erstellen, bevor wir ihn verwenden. Klicken Sie auf den HTTP-Listener und fügen Sie eine neue Konfiguration hinzu, indem Sie auf das grüne Plus-Symbol klicken.

Behalten Sie die Standardeinstellungen bei und klicken Sie auf OK.

Legen Sie den Wert auf "show-invoice" fest.

Klicken Sie in der Maultierpalette auf die Gruppe „Coupa“ und ziehen Sie sie per Drag & Drop in den Flow-Designer, erstellen Sie dann eine neue Konfiguration und legen Sie Ihren API-Schlüssel und die Instanz-URL fest.

Wählen Sie im Abschnitt Coupa General für den Objekttyp Invoice (Rechnung) und geben Sie 1 (oder eine beliebige gültige Rechnungs-ID) in das Feld ID ein.

Schließlich können Sie die Demo ausprobieren, indem Sie eine Anfrage an http://localhost:8081/show-invoice stellen

Hinweis

Nachdem ein Objekttyp ausgewählt wurde, wird die Ausgabe-Metadatenansicht basierend auf der Auswahl generiert

Umgang mit Fehlern

Der Konnektor kann eine andere Art von Fehlern erzeugen, während er in Flows verwendet wird. Es ist gut, eine separate Strategie für jeden Fehlertyp mithilfe der Fehlerbehandlungskomponenten zu konfigurieren.

Coupa-Fehler:

COUPA:KONNEKTIVITÄT

COUPA:AUSFÜHRUNG

COUPA:INVALID_AUTH

COUPA:UNGÜLTIGE_PARAMETER

Konfigurieren von benutzerdefinierten Feldern

Benutzerdefinierte Felder können zusätzlich zu den grundlegenden Datensinn-Feldern hinzugefügt werden. Die verfügbaren Datentypen für benutzerdefinierte Felder sind String, Date, Date_Time, Integer, Double, Float, Long, Decimal, Boolean und Reference.

Beispiel Konfiguration:

some-custom-field,String; other-custom-field,Date_Time; custom-reference-field,Referenz:Benutzer

In der Registerkarte Benutzerdefinierte Metadaten der globalen Coupa-Konfiguration können benutzerdefinierte Felder hinzugefügt werden.

API-Ressourcen

Zugriff auf die Coupa-API-Referenzen

Zugriff auf die Coupa-API-Operatoren

Zugriff auf die Coupa-API-Argumente

Zugriff auf die Coupa-API-Spezialaktionen

Mule-Modul-Dokumente

Mulesoft-Verbindungsdokumentation

Coupa Connector-Freigabehinweise

Coupa Mulesoft Connector - Release-Hinweise v4.1.0.0.pdf

Coupa Mulesoft Connector - Release-Hinweise v4.0.0.0.pdf

Coupa Mulesoft Connector - Release-Hinweise v3.0.0.pdf

Support-Ressourcen

Erfahren Sie, wie sich die Anschlüsse in Mule 4.1 Einführung in Mule 4 geändert haben: Steckverbinder.

Greifen Sie auf das MuleSoft-Forum zu, um Fragen zu stellen und Hilfe von der breiten Community von Mule zu erhalten.

Um auf das Experten-Support-Team von MuleSoft zuzugreifen, abonnieren Sie das Kundenportal von MuleSoft und melden Sie sich an.

Wenden Sie sich an Ihren Coupa-Administrator, um den Coupa-Support zu erreichen.

Parts or all of this page might have been machine-translated. We apologize for any inaccuracies.