インテグレーション設計チェックリスト

Revised: 12 November 2021

はじめに

このドキュメントでは、Coupaと他のシステムとのインテグレーションを構築している顧客またはパートナーと確認する必要がある標準チェックリストを提供し、以下の目標を達成するための取り組みを行います。

  • 統合は、システム間でユーザーが入力したデータを統合する際に発生する可能性があるすべてのデータシナリオに対応するように設計されていることを確認します
  • インテグレーションが疎結合の方法で設計されていることを確認し、システムのフォーマット変更によってインテグレーションが破損するのを防ぎます

CSVインテグレーション

ステップ 詳細 承認が必要*
  列名による解析は位置ではありません はい
  Coupa/オブジェクトに送信される増分/デルタデータのみ、Coupaで使用されるデータのみを送信する はい
  Coupaから送信されるのは増分/デルタデータのみで、最終ステータス(例:請求書OKOTOPAY:承認済みまたは無効化済みステータス)のみです はい
  Coupaは標準インテグレーションとしてサポートしていないため、自動インテグレーションにはスケジュール済みレポート(オブジェクトのカスタムビュー)を使用しないでください。データ出力を制限する条件を持つ必要がある場合のスケジュール済みレポート(例:日次実行、最終更新時間は24時間以内のみ) はい
  フィールド名と形式はハードコードではなく設定可能です いいえ
  CSVファイルは、RFC 4180で採用されている次の規則を使用しています。
  • 区切り文字はコンマです:
  • すべてのフィールドは常に、二重引用符で囲まれたテキスト修飾されます。「
  • フィールド内の二重引用符は、別の二重引用符によってエスケープされます。ユーザーがコメントフィールドに「ステータスが「緑」と入力した場合、これは「ステータスが「緑」と表示されます」
  • 修飾されたフィールド値の中に新しい行の文字を入れることができます
  • テキストエンコーディング:UTF-8(バイトオーダーマーカー(BOM)なし)
いいえ
 

ユーザーが入力したすべてのテキストシナリオに対応

  • テキストフィールドのキャリッジリターンおよびその他の特殊文字
  • テキストブロックフィールドのテキスト長に制限なし
  • 長いテキスト値をターゲットシステムの長さに切り捨てる
  • マルチバイト文字と長さの考慮事項(必要な場合)
はい
  お客様はCoupaがホストするsftpの送信ディレクトリからファイルを削除する必要があります はい
  Coupaへのインバウンド定期デルタフィードは1つのファイルにまとめる必要があります。ソースシステム内のすべてのデルタレコード更新は1つのファイルとして送信しないでください。例: 
シナリオ1:
  • Coupaへのインバウンドのサプライヤーは1日1回実行されます
  • 5サプライヤーが1日で更新されました
  • サプライヤーファイルは5ファイルではなく、1日の終わりにCoupaに送信する必要があります
シナリオ2:
  • Coupaへのサプライヤーインバウンドは1日3回(午前10時/午後4時/午後8時)実行されます
  • 1日で更新された10のサプライヤー(午前10時前に3回、午前10時から午後4時の間に4回、午後4時から午後8時の間に3回)
  • 3つのサプライヤーファイルをCoupaに送信する必要があります。各ファイルには、午前10時、午後4時、午後8時にそれぞれ3つのレコードまたは4つのレコードがあります
はい
  受信および送信のCSV統合データの場合、Coupaで必須であり、Coupaのビジネスプロセスに必要なフィールドのみをマッピングします。 いいえ
  Coupaのペイロード構造は将来的に値のない特定のフィールドやnull値を表示しないように変更する可能性があるため、値を取得する前に常にXML/JSONの要素の存在を検証してください。 はい

*お客様/パートナーの承認は開発前に必要であり、MTPチケットの一部である必要があります

APIインテグレーション

ステップ 詳細 承認が必要*
  データを一括でエクスポートまたはインポートしない はい
  厳密なXSD検証を使用しない はい
  Coupa/オブジェクトに送信される増分/デルタデータのみ、Coupaで使用されるデータのみを送信する  はい
  すべてのAPI呼び出しはIRDの一部である必要があり、Coupaインテグレーションアーキテクトと共有および承認する必要があります  はい
  Coupaのペイロード構造は将来的に値のない特定のフィールドやnull値を表示しないように変更される可能性があるため、値を取得する前にXML/JSON内の要素の存在を検証します。 はい
  特殊XML文字のエスケープの実行 いいえ
  50レコードを超える可能性があるGET呼び出しの代わりにページングを実行する いいえ
  PUT/POST呼び出しのエラー処理が実施されました いいえ
  受信および送信API統合データの場合、Coupaで必要な、Coupaのビジネスプロセスに必要なフィールドのみをマッピングします いいえ
  最適なAPIパフォーマンスのためにAPIフィルター/浅い/制限されたオプションを使用 いいえ

このページに表示されている一部、または全ての内容は、機械翻訳によるものです。ご了承ください。