Mulesoft用Coupa Connector

はじめに

このコネクタは、CoupaのAPIとの統合を容易にし、Coupa Webサービスにアクセスする手段を提供します。Coupaコネクタをミュールフロー内で使用して、最新のoAuth 2/OIDC認証をサポートしたCoupa APIを使用してデータを送受信できます。

これは、住所|事前出荷通知|承認|契約|領収書、別名在庫取引|アイテム|ルックアップ値|発注書|申請書|サプライヤー|ユーザー|料金| CoupaPay支払い|経費報告書|請求書|サプライヤーアイテム|支払先住所|明細書|動的割引|プロジェクト|タスク| BudgetLine | BudgetLine調整|簡易フォーム回答|サプライヤー情報へのアクセスを提供します。

このユーザーガイドを読んで、コネクタを使用して基本的なフローを設定および構成する方法を理解してください。以下に添付されているコネクタリリースノートを使用して、コネクタのリリースごとの機能の追加、互換性、制限、APIバージョンの更新を追跡します。以下に添付されているデモアプリケーションを使用して、コネクタの操作と機能を確認します。

Coupaコネクタのその他の詳細：ミュール交換サイト。

MuleSoftは、認定サポートポリシーの下でこのコネクタを維持します。

前提条件

このドキュメントは、Mule、Anypoint Studio、Anypoint Core Components、およびMule Flow Design Centerに精通していることを前提としています。

ハードウェアおよびソフトウェア要件

ハードウェアとソフトウェアの要件については、ハードウェアとソフトウェアの要件のページをご覧ください。

互換性

コネクタの取り付け

Anypoint Exchangeからのコネクタのインストールの手順に従って、Anypoint Studioにコネクタをインストールできます。

コネクタのグローバル要素の設定

MuleアプリケーションでCoupaコネクタを使用するには、Coupaコネクタで使用できるグローバルCoupa要素を構成する必要があります。Coupaコネクタには次のグローバル構成が用意されており、次の資格情報が必要です。Coupa APIキーとインスタンス：

MuleアプリケーションでCoupaコネクタを使用するには、Coupaコネクタで使用できるグローバルCoupa要素を構成する必要があります。Coupaコネクタは、次の認証情報を必要とする次のグローバル構成を提供します。Coupa APIキー（ R 35からの非推奨）、OIDCクライアント資格情報およびインスタンス：

次のパスでCoupaインスタンスのクライアント資格情報を生成できます: https :// {instance_name}/oauth 2/clients

OIDC/Oauth 2の参照文書：Coupa APIを使い始める

設定のヒント

1. 上記の構成のAPIキーパラメータは、OIDC認証を選択している間は空白のままにすることができます。
2. APIキーがOIDCクライアント資格情報（クライアントID、シークレット、スコープ）とともに入力された場合、OIDC認証が優先されます。

構成に関する注意事項

1. core.user.read は、OIDC認証で正常にテスト接続を完了するために必要な必須のスコープです。
2. 複数のOIDCスコープは、カンマ、スペース、% 20のいずれかの区切り文字で区切ることができます。

例

• 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

コネクタを使用する

コネクタの名前空間とスキーマ

Studioでアプリケーションを設計する場合、パレットからAnypoint Studioキャンバスにコネクタをドラッグすると、コネクタの名前空間とスキーマの場所がXMLコードに自動的に入力されます。

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

コネクタを使用したミュールアプリケーションのデモ

既存のデモでは、コネクタの使用方法を次のように説明しています。

• デモフローアプリ

使用例

次の例は、コネクターを使用して請求書を取得する方法を示しています。

請求書を受け取る

1. Anypoint Studioで、[ファイル] > [新規作成] > [ Muleプロジェクト]をクリックし、プロジェクトに名前を付けて[OK]をクリックします。
2. [Mule Palette]で、[HTTP]グループをクリックし、[Listener]コンポーネントを選択します。次に、それをフローデザイナーにドラッグアンドドロップします。
3. まず、HTTPリスナーを使用する前に、HTTPリスナーの設定を作成する必要があります。HTTPリスナーをクリックし、緑色のプラスアイコンを押して新しい設定を追加します。
4. デフォルトのままにして、[OK]をクリックします。
5. 値を「show - invoice」に設定します。
   
6. ミュールパレットで、「Coupa」グループをクリックし、フローデザイナーにドラッグアンドドロップして、新しい構成を作成し、APIキーとインスタンスURLを設定します。
7. [Coupa General]セクションで、[Object type]で[Invoice (請求書)]を選択し、[ID]フィールドに1 (または有効な請求書ID)を入力します。
   
8. 最後に、http :// localhost: 8081/show - invoiceにリクエストするデモを試すことができます。

基本的なデータセンスフィールドの上にカスタムフィールドを追加することができます。カスタムフィールドで使用できるデータ型は、String、Date、Date_Time、Integer、Double、Float、Long、Decimal、Boolean、Referenceです。

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