SAP Concurをデータパイプラインソースとして設定する ​

SAP Concurをデータパイプラインソースとして設定し、SAP Concur APIから経費レポート、請求書、ユーザー、リスト、および関連する出張と経費のレコードを抽出して送信先に同期します。

このガイドを使用して、機能と前提条件の確認、SAP Concur認証情報の生成、SAP Concurのデータパイプラインソースとしての接続、パイプラインの設定を行い、サポートされるオブジェクト、同期モード、スキーマ処理、機密データ処理、制限事項について理解します。

サポートされている機能 ​

SAP Concurをパイプラインソースとして使用する場合、次の機能がサポートされます。

• クラウド接続: https経由でSAP Concur APIに接続します。 SAP Concurはクラウドホスト型プラットフォームであるため、オンプレミスエージェントは不要です。 コネクターは各リクエストを、割り当てられたSAP Concurデータセンターに自動的にルーティングします。
• プロダクションとサンドボックスのサポート: 実装インスタンス設定を使用して、プロダクションインスタンスまたは実装（サンドボックス）インスタンスに接続します。
• オブジェクトレベルの選択: パイプラインを設定するときに、同期するサポート対象オブジェクトを選択します。
• 同期モード: report、payment_request、travel_requestオブジェクトは増分同期されます。 その他のすべてのオブジェクトはフル同期を使用します。
• 削除追跡: オブジェクトの一部には、ソース駆動の論理削除シグナルがあります。 完全同期オブジェクトは、送信先側のスナップショット比較を通じて削除を反映します。
• スキーマドリフト処理: ソースで新しく追加されたフィールドを自動同期するかブロックするかを選択します。
• フィールドレベルのデータ保護：転送先に到達する前に、フィールド値をそのままレプリケートするか、機密値をハッシュ化します。
• 設定可能な同期頻度：時間ベースまたはcronベースのスケジュールで同期をスケジュールします。 最小間隔は15分です。

前提条件 ​

SAP Concurをデータパイプラインソースとして設定する前に、次の要件を満たしてください。

• 同期する予定のモジュールのライセンスが付与されたSAP Concurアカウント。 SAP Concurでは、Expense、Invoice、Travel、Requestが個別のモジュールとしてライセンス付与されます。 詳細については、モジュールライセンスを参照してください。
• SAP Concur内のOAuth 2.0アプリケーション。クライアントIDとクライアントシークレット、および最低限EXPRPTスコープが必要です。 設定手順については、OAuth 2.0アプリケーションを作成するを参照してください。
• 選択した認証方法の認証情報:
  • 認可コード付与: ブラウザーのサインインフローを通じてコネクションを認可できるSAP Concurユーザーに加え、クライアントIDとクライアントシークレットを保存するWorkatoのCustom OAuth profiles。
  • パスワード付与: SAP Concurのユーザー名とパスワードに加え、OAuthアプリケーションのクライアントIDとクライアントシークレット。
  • リフレッシュトークン付与: 会社リクエストトークンから生成されたリフレッシュトークンに加え、OAuthアプリケーションのクライアントIDとクライアントシークレット。

サポートされるコネクションタイプ ​

SAP Concurデータパイプラインでは、次の付与タイプによるOAuth 2.0認証がサポートされます。

• 認可コード付与: SAP Concurのブラウザーサインインフローを通じてコネクションを認可します。 Workatoにユーザー名とパスワードを保存せずに、サインインユーザーとして認証するには、この方法を選択します。
• パスワード付与: SAP Concurのユーザー名とパスワードに加え、OAuthアプリケーションのクライアントIDとクライアントシークレットを使用して認証します。 パスワード付与コネクションはユーザー型です。 payment_typeオブジェクトを同期するには、この方法を使用します。
• リフレッシュトークン付与: 会社リクエストトークンから生成されたリフレッシュトークンに加え、OAuthアプリケーションのクライアントIDとクライアントシークレットを使用して認証します。 リフレッシュトークン付与コネクションは会社型です。 userオブジェクトを同期するには、この方法を使用します。

コネクションのトークンタイプによって、同期できるオブジェクトが決まります。 userとpayment_typeの両方を同期できる単一のコネクションはありません。 詳細については、コネクションタイプによってオブジェクトの可用性が決まりますを参照してください。

SAP Concurに接続する ​

SAP Concurに接続するには、次の手順を実行します。

ATTEND
CONFIG
expense.report.read
expense.report.readwrite
EXPRPT
identity.user.core.read
identity.user.coreenterprise.writeonly
identity.user.coresensitive.read
identity.user.enterprise.read
identity.user.externalID.writeonly
identity.user.ids.read
identity.user.sap.read
IMAGE
INVPMT
INVVEN
LIST
openid
spend.list.read
spend.list.write
spend.listitem.delete
spend.listitem.read
spend.listitem.write
spend.user.general.read
spend.user.general.writeonly
travel.user.general.read
travel.user.private.read
user.provision.read
user.provision.write
user.read
user.write

パイプラインの設定 ​

SAP Concurをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

SAP Concurデータパイプラインは、SAP Concur Expense、Invoice、Request、Identity、Lists、Common Locations APIからデータを同期します。 各オブジェクトは、宛先内の個別のテーブルとして同期されます。 子オブジェクトは、個別の正規化テーブルとして同期されます。 各子テーブルは単一列のid主キーを使用し、payment_request_lineのpayment_request_idやlist_itemのlist_idなどの親参照列を保持します。 子テーブルを親に関連付けるには、親参照列で結合します。

次の表は、サポートされるオブジェクトをカテゴリ別に示しています。

経費レポートと経費 ​

次のオブジェクトは、経費レポートと、それに添付された経費エントリ、配賦、明細化、出席者を表します。 expense_entry、allocation、itemization、entry_attendee_associationオブジェクトは経費レポート構造の子レコードであり、テナントスコープで抽出され、個別のテーブルとして同期されます。 これらのオブジェクトにはExpenseモジュールが必要です。

経費設定 ​

次のオブジェクトは、SAP Concurテナントの経費設定参照データを表します。

請求書とベンダー ​

次のオブジェクトは、支払リクエスト（請求書）とベンダーマスターデータを表します。 これらのオブジェクトにはInvoiceモジュールが必要です。 ベンダーの銀行、グループ、ステータスのオブジェクトは、ベンダーレスポンスを通じて抽出されます。 payment_requestオブジェクトは増分同期されますが、payment_request_lineは実行ごとに完全に再読み込みされます。

出張リクエスト ​

次のオブジェクトは出張リクエストを表します。 これにはRequestモジュールが必要です。

リスト ​

次のオブジェクトは、カスタムリストとその項目を表します。

ユーザー ​

usersオブジェクトは、SAP Concur Identity（SCIM）APIからのユーザーIDレコードを表します。

ロケーション ​

locationsオブジェクトはロケーション参照データを表します。

同期モード ​

SAP Concurデータパイプラインでは、完全同期と増分同期がサポートされます。 同期モードは、そのオブジェクトについてSAP Concur APIが使用可能な変更時刻フィルターを公開しているかどうかに基づいて、オブジェクトごとに固定されます。

フル同期 ​

完全同期は、実行ごとにオブジェクトの完全なレコードセットを再抽出し、送信先テーブルを上書きします。 ほとんどのSAP Concurオブジェクトは完全同期を使用します。これは、それらのオブジェクト用のSAP Concur APIが変更時刻フィルターを公開していないためです。 これにはuserオブジェクトが含まれます。SAP Concur Identity APIは最終変更日でフィルタリングできないためです。

増分同期 ​

増分同期は、各オブジェクトの最終変更タイムスタンプをカーソルとして使用し、前回の実行以降に作成または更新されたレコードのみを抽出します。 3つのオブジェクトが増分同期されます。

その他すべてのオブジェクトは完全同期を使用します。これは、それらのオブジェクト用のSAP Concur APIが使用可能な変更時刻フィルターを公開していないためです。 各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

削除追跡 ​

SAP Concurデータパイプラインは、ソース内で削除シグナルを公開するオブジェクトの論理削除を追跡します。 レコードが削除状態になると、次回の同期時にパイプラインは送信先の_workato_is_deleted列をtrueに設定します。 これらのオブジェクトは、サポートされるオブジェクト表ではい（論理）とマークされています。

これらのオブジェクトには、直接クエリできるSAP Concur削除フィールドも含まれます。attendee_type、payment_type、list、list_itemのis_deleted、およびpayment_requestのis_payment_request_deleted、deleted_date、payment_request_deleted_byです。

SAP Concurは、残りのオブジェクトに対して削除シグナルを公開していません。 これらのオブジェクトは完全同期を使用するため、送信先は各実行を前回の実行と比較して削除を検出し、ソースに表示されなくなったレコードについて_workato_is_deletedをtrueに設定します。

reportオブジェクトとtravel_requestオブジェクトは、この処理の例外です。 reportオブジェクトとtravel_requestオブジェクトはいずれも、SAP Concurが削除シグナルを公開しないまま増分同期されます。つまり、_workato_is_deleted列は含まれず、パイプラインはこれらのオブジェクトの削除を検出できません。

payment_request_lineオブジェクトには、独自のソース側削除シグナルがありません。 完全同期でも、実行間で消えた明細行を検出します。 SAP Concurが削除済みとしてマークした支払リクエストに属する明細行が残っている場合、payment_request_lineをpayment_request_idでpayment_requestに結合し、親の削除状態でフィルタリングすることで、その明細行を特定できます。

スキーマとデータ型の処理 ​

SAP Concurコネクターは、データを送信先にレプリケートする際に、特定のSAP Concurフィールドタイプに固有の処理を適用します。

カスタムフィールド ​

SAP Concurオブジェクトには、カスタムフィールドスロットが含まれます。 スロット数と各スロットの形状はオブジェクトによって異なります。

• report、expense_entry、itemization、allocation、travel_requestでは、カスタムフィールドは構造化オブジェクトです。 コネクターは各スロットをJSON文字列列として保存します。
• attendee、entry_attendee_association、payment_request、payment_request_line、vendorでは、カスタムフィールドはフラットな文字列です。

オブジェクトごとのスロット数は次のとおりです。

カスタムフィールドラベルは、SAP Concurでテナントごとに定義されます。 コネクターは、テナント固有のラベルではなく、正規のcustom1からcustomNまでの列名を出力します。

ネストされたオブジェクトと子オブジェクト ​

SAP Concurコネクターは、子レコードを親レコードにインライン化するのではなく、個別のテーブルとして出力します。 各子テーブルは単一列のid主キーを使用し、親参照列を含みます。 レコード内に残る深くネストされた配列は、JSON文字列列としてシリアル化されます。

テナントごとのスキーマ可変性 ​

SAP ConcurではExpense、Invoice、Requestモジュールが個別にライセンス付与され、各テナントが独自のカスタムフィールドを定義するため、オブジェクトの可用性とカスタムフィールドラベルはテナントごとに異なります。 コアオブジェクトスキーマはテナント間で一貫しています。

合成列 ​

Workatoは、宛先テーブルに次の合成列を追加します:

送信先での列名の大文字小文字 ​

宛先は、テーブルを作成するときに列名の大文字と小文字を調整します。 Snowflakeは列名を大文字で保存し、ほとんどの宛先は小文字で保存します。BigQueryとSQL Serverは、コネクターが出力したとおりに保持します。

機密データの処理 ​

SAP Concurオブジェクトには、個人を特定できる情報（PII）と機密性の高い財務データが含まれる場合があります。 次のオブジェクトには、一般的に機密フィールドが含まれます:

SAP Concurは、userオブジェクトのメールアドレスと電話番号を配列として返します。コネクターはこれらを、たとえばemailsやphone_numbersなどのJSON文字列列として保存します。 単一のプライマリメール列はありません。

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。 詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

SAP Concurをデータパイプラインソースとして使用する場合、次の制限事項が適用されます。

モジュールライセンス ​

SAP Concurでは、Expense、Invoice、Travel、Requestが個別のモジュールとしてライセンス付与されます。 アカウントは、ライセンス付与されているモジュールのオブジェクトのみを同期できます。 アカウントにライセンス付与されていないモジュールのオブジェクトを選択すると、パイプラインは権限エラーを返します。 Invoice、Travel、Requestカテゴリのオブジェクトを追加する前に、モジュールライセンスを確認してください。

コネクションタイプによってオブジェクトの可用性が決まります ​

SAP Concurコネクションは単一のトークンタイプを使用します。これにより、コネクションがデータの同期に使用できるオブジェクトが決まります。

• ユーザー型コネクションはpayment_typeオブジェクトを同期できますが、userオブジェクトは同期できません。 パスワード付与はユーザー型コネクションを生成します。
• 会社型コネクションはuserオブジェクトを同期できますが、payment_typeオブジェクトは同期できません。 リフレッシュトークン付与は会社型コネクションを生成します。

単一のコネクションでuserとpayment_typeの両方を同期することはできません。 userとpayment_type用に個別のコネクションを作成し、両方のオブジェクトを同期するには、これらのコネクションを個別のパイプラインで使用する必要があります。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。 これより高い頻度で同期をトリガーすることはできません。