Coupa で IBM App Connect を使用する方法

Coupaは、クラウドベースのソフトウェアで、調達から請求書発行、経費に至るまで、従業員の支出を管理・分析することができる。

空室状況
  • App Connect コネクタ
  • IBM App Connect in containers の Designer インスタンスのローカル コネクタ（継続的デリバリ リリース）コンテナ内のローカルコネクタ（継続的デリバリー版）
  • IBM App Connect in containers の Designer インスタンスのローカル コネクタ（サポート サイクル 2）コンテナ内のローカルコネクタ（ Cycle-2 の長期サポート版）

対応製品およびAPIバージョン

このコネクタがサポートする製品およびAPIのバージョンを確認するには、 IBM のサポートページにある 「詳細なシステム要件」 をご覧ください。

Coupaへの接続

重要:

Coupa エンドポイントは、リリース35（2023年1月）において、APIキーによる認証を非推奨とし、 OAuth 2.0 による認証へ移行します。 すべてのCoupa 管理者は、API連携の設定を、 OAuth 2.0 を使用してCoupa に認証するように、できるだけ早く移行する必要があります。 詳細については、 「API キーの廃止に関するよくある質問」 をご覧ください。

以下の変化を考えてみよう。 App Connect 移行後の
  • API KEYベースの認証は廃止されたため、アカウントを再作成する必要があります。 新しいアカウントは、 OAuth 2.0 の認証方法を使用して作成する必要があります。
  • Coupa コネクタは、 Coupaの最新のリリース35（2023年1月）のみをサポートしています。
  • Coupa APIには、いくつかのプロパティレベルの変更（例えば、アンダースコアを持つプロパティ名がハイフンに置き換えられました）があります。 マッピングが壊れないように、必ずフローを再作成して再構築してください。
  • を追加する必要がある。 App Connect を追加する必要がある。 以下は該当するスコープのリストである：
    • core.common.read
    • core.common.write
    • core.expense.read
    • core.expense.write
    • core.inventory.receiving.read
    • core.inventory.receiving.write
    • core.invoice.read
    • core.invoice.write
    • core.purchase_order.read
    • core.purchase_order.write
    • core.supplier.read
    • core.supplier.write
    • core.user.read
    • core.user.write
    • core.inventory.transaction.read
    スコープに関する詳細については、 OAuth および 2.0 の 「 Coupa Compass 」ページにある「Coupa API のはじめ方」をご覧ください。

「 App Connect Designer」 の [Connect ] > [Applications and APIs ] ページ（旧 [Catalog ] ページ） またはフローエディタに表示される接続フィールドに入力してください。 必要に応じて、 Coupa 管理者と協力してこれらの値を取得してください。

Coupa 接続フィールド：

接続フィールド 説明
API URL Coupa REST API URL の形式は http://<instance-name>.<coupahost>.com。 例えば、https://companyname.coupacloud.com などです。
クライアント ID Coupa クライアント・アプリケーションの一意の識別子。 Coupa アカウントのユーザーインターフェイスからクライアントIDを取得します。
ヒント： クライアント ID の生成に関する詳細については、 Coupa Compass ページの 「 OAuth2.0 」 の「Getting Started with Coupa API」をご覧ください。
クライアント・シークレット Coupa クライアント・アプリケーションのクライアント・シークレット。 Coupa アカウントのユーザーインターフェイスからクライアントシークレットを取得します。
ヒント： クライアントシークレットの生成に関する詳細については、 Coupa Compass ページの 「Coupa API のはじめ方」（ OAuth2.0 ）をご覧ください。

Coupaの接続値を取得するには、 Coupaの接続値の取得を参照してください。

App Connect デザイナー アプリケーションとAPI ページ から クーパ エンドポイントに初めて接続するには、 クーパ を展開し、 接続 をクリックします。 詳細については、 アカウントの管理を参照してください。

一般的な考慮事項

Coupa で App Connect Designer を使用する前に、以下の点に注意してください：

  • (一般的な考察) App Connect Designerの Applications and APIs ページで利用可能なトリガーイベントとアクションのリストを見ることができます。

    アプリケーションによっては、イベントとアクションは環境と、コネクタが設定可能なイベントとアクションの動的検出をサポートしているかどうかに依存する。 アプリケーションが設定可能なイベントをサポートしている場合、イベント・リストの下に Show more configurable events リンクが表示されます。 アプリケーションがアクションのダイナミックディスカバリーをサポートしている場合、アクションリストの下に Show more リンクが表示されます。

  • (一般的な考慮事項）アプリケーションに複数のアカウントを使用している場合、そのアプリケーションのアクションを選択したときに表示されるフィールドのセットは、アカウントによって異なる可能性があります。 フローエディターでは、アプリケーションによっては、常にアクションのための静的フィールドのキュレーションセットを提供します。 他のアプリケーションは、接続先のインスタンスで設定されているフィールドのセットを取得するために、ダイナミック・ディスカバリーを使用します。 例えば、あるアプリケーションの2つのインスタンスに2つのアカウントがある場合、最初のアカウントはすぐに使える設定を使うかもしれません。 しかし、2つ目のアカウントには余分なカスタムフィールドが設定されている可能性があります。

出来事と行動

クーパイベント

これらのイベントは、フロー内のアクションを完了するためにフローを開始するトリガーとなる、このアプリケーションの変更に対するものである。

より多くの設定可能なイベントを表示します：デフォルトで表示されるイベントは、最適化された接続を使用して事前に設定されています。 新しいオブジェクトや更新されたオブジェクトについてこのアプリケーションをポーリングしてフローをトリガーできるイベントを設定すると、さらに多くの項目が利用できるようになります。

クーパの活動

あなたのフローは、このアプリケーション上でこれらのアクションを完了します。

オブジェクト アクション 説明
アドレス 住所の作成 Coupaにアドレスを作成する
アドレスの取得 Coupaからアドレスを取得
住所の更新 Coupaのアドレスを更新する
為替レート 為替レートの作成 Coupaで為替レートを作成する
為替レートを取得する Coupaの為替レートの詳細を取得します
為替レートの更新 Coupaで為替レートを更新する
経費報告書 経費報告書の作成 経費報告書の作成
経費報告書の取得 Coupaから経費報告の詳細を取得
経費報告書の更新 Coupaで経費報告書を更新する
在庫取引 在庫トランザクションの作成 Coupaで在庫トランザクションを作成する
在庫トランザクションの取得 Coupaから在庫取引の詳細を取得する
請求書 請求書の作成 Coupaで請求書を作成する
請求書の取得 Coupaから請求書の詳細を取得する
請求書の更新 Coupaで請求書を更新する
ルックアップ値 ルックアップ値の作成 Coupaでルックアップ値を作成する
ルックアップ値の取得 Coupaからルックアップ値を取得する
ルックアップ値の更新 Coupaのルックアップ値を更新する
発注書 発注書の取得 Coupaから発注書の詳細を取得する
送金先住所 送金先アドレスの作成 Coupaに送金先アドレスを作成します
送金先アドレスの取得 Coupaから送金先アドレスを取得する
送金先住所の更新 Coupaの送金先アドレスを更新する
サプライヤー サプライヤー作成 Coupaにサプライヤーを作成する
サプライヤーの検索 Coupaからサプライヤーの詳細を取得する
更新サプライヤー Coupaでサプライヤの詳細を更新する
ユーザー ユーザーの作成 Coupaにユーザーを作成する
ユーザーの取得 Coupaユーザーの詳細を取得
ユーザーの更新 Coupaでユーザーの詳細を更新する

例

Coupaを使用するテンプレートのダッシュボード・タイル

テンプレートを使って Coupa 用のフローを素早く作成する

テンプレートを使用して App Connect テンプレートを使用して、 Coupa 上でアクションを実行するフローをすばやく作成する方法を学びます。 例えば、 Discoverを開き、 Coupa を検索する。

詳細はこちら

Coupaを使用するテンプレートのダッシュボード・タイル
Coupaフローの詳細表示

使用方法 App Connect を使用して、 Coupaと統合するフローを構築します。

IBM Maximo®から取得した各発注書に対して、 Coupaで仕入先と請求書を作成する方法については、 IBM® Communityのブログをお読みください。 ブログを読む] をクリックしてブログをご覧ください。

ブログを読む(英語)