Veeva から SAP Concur へのインテグレーションは、一般的に使用されるフィールドマッピングで事前設定されています。ただし、Veeva から SAP Concur への追加データ送信を希望するお客様もおられます。カスタムフィールドをマップするか、またはデフォルトマッピング (経費レポート名など) を変更することにより、経費レポートヘッダーレベルで Veeva から SAP Concur へのコネクタをカスタマイズできます。
レポートヘッダーには経費レポートの分類情報が含まれており、経費項目の格納場所として機能します。
このトピックは、SAP Concur とコールレポートまたはメディカルイベントとのインテグレーションに関するものです。Events Management マッピング情報については、SAP Concur インテグレーションの Events Management 設定をご覧ください。
Veeva からマッピングする際、SAP Concur API で以下のフィールドを使用できます。
要素 | 必須 (値の入力必須)？ | 説明 |
|---|---|---|
インデックス | Y | バッチ内のヘッダーの位置。1 から始まり、順次増加します。エラー時にレコードを特定するためにこの値が使用されます。 |
LoginId | Y | レポート所有者の SAP Concur ログイン ID |
名前 | Y | 経費レポート名。 |
Purpose | 設定に応じて異なります。 | レポートの業務目的。 |
コメント | 設定に応じて異なります。 | レポートヘッダーのコメント最大長さ: 2000。 |
OrgUnit1～OrgUnit6 | 設定に応じて異なります。 | カスタム組織ユニットフィールド設定によって必要になる場合があります。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
Custom1～Custom20 | 設定に応じて異なります。 | 経費レポートヘッダーフォームのカスタムフィールド。設定によって必要になる場合があります。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 リスト値を含むようにカスタムフィールドが設定されている場合、リスト項目値を適切に送信する方法について、SAP Concur ドキュメントの接続リスト項目のポストを参照してください。 |
UserDefinedDate | 設定に応じて異なります。 | レポートに関してユーザが選択した日付。形式は、YYYY-MM-DD hh:mm:ss.0 (年-月-日 時間:分:秒.0) です。 |
デフォルトマッピングが表示された [SAP Concur 管理] タブに、新しいマッピングセクションが表示されます。お客様は、レポートヘッダーのカスタムマッピングを追加できます。お客様は、レポートヘッダーのカスタムマッピングを追加できます。
SAP Concur フィールドは、SAP Concur API で使用可能なレポートヘッダーバッチフィールドに基づいています。
インデックスフィールドはカスタマイズできないため使用できません (インデックスフィールドはバッチ内のヘッダーの位置であり、エラー時にレコードを特定するために使用されます。1 から始まり、順次増加します)。
使用可能な Veeva フィールドは、ユーザオブジェクトのフィールドによって異なります。
デフォルトマッピングには、日付フィールドのパターンが表示されます。パターン定義は、Java の SimpleDateFormat によるものです。お客様は、各自のカスタムフィールドでパターンを活用できます。
SAP Concur インテグレーションのカスタムフィールドのマッピングの設定
SAP Concur インテグレーションのカスタムフィールドのマッピング要件
- SAP Concur インテグレーションを組織内で設定する必要があります。
- 有効なログイン情報により、Veeva と SAP Concur との接続性を確立する必要があります。
レポートヘッダーレベルでカスタムフィールドをマッピングするには
- ユーザオブジェクトで新規 Veeva フィールドを作成します。
- 「ユーザカスタムフィールド」セクションにスクロールし、新規 ボタンをクリックします。
- 適切なデータタイプを選択します (例: テキスト)
- フィールドラベルを入力します (例: SAP Concur レポートヘッダー名)
- フィールド長を入力します (例: 255 字のフィールド名が自動的に入力されます)。
- 新規フィールドへの適切なアクセス権がユーザに与えられるよう、フィールドレベルのセキュリティを設定します。
- このフィールドを含めるページレイアウトを選択します。
- 保存を選択します。
- 新規作成されたフィールドの値を指定します: 設定 > 管理設定: ユーザ管理 > ユーザ > 追加、またはユーザを編集してユーザ割当を設定します >
- 更新したいユーザの隣にある [編集] を選択します。
- スクロールして新規作成されたフィールドを探し、カスタム値を指定します (例: HCP Meals yyy-MM-dd)。
- 保存を選択します。
- [編集] ボタンをクリックし、SAP Concur 管理ページの SAP Concur 名フィールドに、新規作成した Veeva フィールドをマッピングします。
上記の手順で、デフォルトのマッピングが上書きされます。SAP Concur 同期プロセスにより SAP Concur で新規経費レポートが作成されると、名前フィールドに新しい値を使用し、日付の代わりに日付パターンを使用することになります。
デフォルトフィールドマッピングの上書き
SAP Concur 管理タブで使用できないデフォルトのフィールドマッピングを上書きすることで、Veeva-SAP Concur コネクタをカスタマイズすることができます。例えば、SAP Concur の ExternalId フィールドのデフォルトマッピングを独自のマッピングで上書きすることができます。ExternalId マッピングは、デフォルトに対して 1 回 (削除できません)、そしてカスタムマッピングに対して 1 回の合計 2 回表示されます。
経費項目レベルのマッピング
経費キー、その他の参加者タイプ、および支払いタイプに加えて、コネクタは以下のフィールドを経費項目レベルでマッピングします。以下は、コールおよびメディカルイベントのデフォルトのフィールドマッピングです。
SAP Concur フィールド | Veeva フィールド |
|---|---|
CrnCode | Organization.DefaultCurrencyIsoCode またはユーザ。DefaultCurrencyIsoCode (多通貨が有効にされている場合) |
ExpKey | Concur_Settings_vod__c.Expense_Key_vod__c |
TransactionAmount | Expense_Amount_vod__c |
PaymentTypeId | Concur_Settings_vod__c.Payment_Type_vod__c |
説明 | ID, Name, Start_Date_vod__c, End_Date_vod__c |
TransactionDate | Start_Date_vod_c |
カスタムフィールドをマッピングするには、SAP Concur API で利用可能な経費項目レベルフィールドについて以下の表を参照してください。追加情報は、developer.concur.com の SAP Concur API ドキュメントにあります (経費項目をポストへ移動してください)。
フィールド名 | 必須 | 説明 |
|---|---|---|
<CrnCode> | 新規入力は Y | 経費トランザクション金額の 3 文字の ISO 4217 通貨コード。例: USD |
ExpKey | Y | 経費の経費タイプキー。新規入力または更新入力に必須です。経費タイプキーは常に CASH を使用します (SAP Concur 手順による)。 |
<説明> | 設定に応じて異なる | 経費の説明、または業務用途。この情報は、レポートディテールの取得エンドポイントにより <BusinessPurpose> 要素に戻されます。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
<TransactionDate> | 新規入力は Y | 経費が発生した日です。新規入力に必須です。 |
<TransactionAmount> | Y | 経費の合計額 (元通貨) です。新規入力または更新入力に必須です。 |
<LocationID> | 設定に応じて異なる | ロケーションコードです。市区郡フィールドが必須の場合に必要になる場合があります。ロケーション取得エンドポイントを使用して、このフィールドの有効値を取得します。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
<OrgUnit1>～<OrgUnit6> | 設定に応じて異なる | 経費項目フォーム組織単位フィールド。設定によって必要になる場合があります。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
<Custom1>～<Custom40> | 設定に応じて異なる | 経費項目フォームカスタムフィールド。設定によって必要になる場合があります。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
<ExchangeRate> | N | トランザクション金額とポスト金額間の為替レートです。通常、この要素は提供されません。この要素が、ユーザの償還通貨と異なる通貨のトランザクションに対して空白である場合、そのトランザクションのポスト金額を決定するために企業の設定済み為替レートが [経費] に使用されます。システムによって為替レートが決定できない場合、リクエストは HTTP 500 エラーを戻します。 |
<Comment> | 設定に応じて異なる | 経費項目コメントです。最大長: 2000。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
<VendorDescription> | N、ただしサンドボックスの場合に推奨されます。 | この要素には、ベンダーが入力するための説明文が含まれます。このフィールドは、入力事項をポストするために必要ではありませんが、開発者サンドボックスの経費項目には必須のフィールドです。このサンドボックスに対してこのフィールドを提供しない場合、必須フィールドがありませんという例外メッセージが表示されます。 |
<IsPersonal> | N | 経費項目が個人的出費かどうかを示します。個人的出費は、SAP Concur 経費では払い戻しされません。形式: はい/いいえ |
<PaymentTypeID> | N | 経費項目の支払いタイプの固有識別子。経費グループ設定を取得エンドポイントの <PaymentTypeID> 値を使用します。この値を提供しない場合、支払いタイプはデフォルトで現金になります。サポートされている支払いタイプコードは次の通りです: 現金および会社払い。お客様が「カード決済請求中」システム支払いタイプを使用している場合には、これもサポートされています。 |
参加者レベルフィールドのマッピング
このセクションでは、参加者レベルで Veeva から SAP Concur へのカスタムフィールドマッピングが可能です。管理者は参加者固有フィールドのマッピングを設定して、コールレポートとメディカルイベント (該当する場合) を SAP Concur に送信する際に参加者の追加情報をポストすることができます。
SAP Concur フィールドへのマッピングを行うためには、SAP Concur でフィールドを定義する必要があります。さらに、あるフィールドに選択リストなど複数の値を指定するためには、これらの値を SAP Concur に設定する必要があります。SAP Concur 管理者タブの「コール/メディカルイベントフィールドマッピング」セクションのドロップダウンリストで、使用できるフィールドのリストを確認してください。
使用可能な SAP Concur フィールドは、SAP Concur API で使用可能なフィールドに基づきます。SAP Concur API について詳しくは、SAP Concur API ドキュメントを参照してください (「経費項目参加者をポスト」セクションへ移動してください)。カスタムフィールドを設定するには、SAP Concur によるサポートが必要な場合があります。詳細情報については、SAP Concur にお問い合わせください。
以下のコールレポートの参加者レベルフィールドはデフォルトで有効になっており、削除することはできません:
SAP Concur フィールド | 必須 | 説明 | 例 | Veeva フィールド |
|---|---|---|---|---|
<AttendeeType> | Y | SAP Concur が参加者を特定するために使用する、参加者タイプコードです。 | BUSGUEST | Expense_Attendee_type_vod__c |
<LastName> | Y | 参加者の姓です。 | Smith | Account_vod__r.LastName |
<FirstName> | Y | 参加者の名です。 | John | Account_vod__r.FirstName |
<タイトル> | N | 参加者の役職です。 |
| Account_vod__r.PersonTitle |
<ExternalId> | Y | 参加者の固有識別子で、通常はお客様の外部システムレコードによって提供されます。 | 001d000000CN3ITAA1 | Account_vod__r.Id |
<会社> | N | 参加者の親アカウントです (該当する場合)。 | Chilton Memorial Hospital | Entity_Display_Name_vod__c （関連付けられた施設の場合）または Account_vod_r.Primary_Parent_vod__r.Name |
<CrnCode> | Y | 経費トランザクション金額の 3 文字の ISO 4217 通貨コードです。 | USD | Organization.DefaultCurrencyIsoCode またはユーザ。DefaultCurrencyIsoCode (多通貨が有効にされている場合) |
<SystemOwner> | N | 新規の参加者: 「はい」に設定された場合、参加者所有者は「システム」に設定されます。この所有者は、共有参加者リストに必要です。「はい」に設定されない場合、参加者所有者はレポート所有者に設定されます。 既存の参加者: 「はい」に設定された場合、参加者所有者は「システム」に設定されます。「はい」に設定されない場合、参加者所有者はレポート所有者と比較されます。レポート所有者と参加者所有者が一致すると、参加者は更新されます。レポート所有者と参加者所有者が一致しなければ、参加者は更新されません。 |
|
|
メディカルイベントの参加者レベルマッピング
SAP Concur フィールド | Veeva フィールド |
|---|---|
CrnCode | Organization.DefaultCurrencyIsoCode またはユーザ。DefaultCurrencyIsoCode (多通貨が有効にされている場合) |
AttendeeType | Expense_Attendee_Type_vod__c |
ExternalId | Account_vod_r.Id OR Contact_vod__r.Id または User_vod__r.Id |
PaymentTypeId | Concur_Settings_vod__c.Payment_Type_vod__c |
FirstName | Account_vod__r.FirstName または Contact_vod__r.FirstName または User_vod__r.FirstName |
LastName | Account_vod__r.LastName または Contact_vod__r.LastName または User_vod__r.LastName |
タイトル | Account_vod__r.PersonTitle または Contact_vod__r.PersonTitle または User_vod__r.PersonTitle |
会社 | Account_vod__r.Primary_Parent_vod__r.Name |
コールとメディカルイベントに参加者レベルで追加のカスタムフィールドをマッピングすることができます。以下は、SAP Concur API で現在使用可能なすべての参加者レベルフィールドのリストです。
フィールド名 | 必須 | 説明 |
|---|---|---|
<AttendeeType> | Y | SAP Concur が参加者を特定するために使用する、参加者タイプコードです。8 文字の英字です。お客様は独自のカスタム参加者タイプコードを追加することができます。標準の参加者タイプコード: 取引客は BUSGUEST、従業員の配偶者は SPOUSE。使用可能なタイプの全リストを取得するには、参加者リストウェブサービスの「参加者タイプリストを取得」機能を使用します。 |
<LastName> | Y | 参加者の姓です。 |
<FirstName> | 設定に応じて異なる | 参加者の名です。 |
<タイトル> | 設定に応じて異なります。 | 参加者の役職です。 |
<ExternalId> | Y | 参加者の固有識別子で、通常はお客様の外部システムレコードによって提供されます。 |
<会社> | 設定に応じて異なります。 | 参加者の所属企業名です。 |
<Custom1>～<Custom20> | 設定に応じて異なります。 | 経費参加者フォームのカスタムフィールドです。設定によって必要になる場合があります。必須入力フィールドの情報を収集するための手順については、経費レポートの「プロセス」>「経費レポートデータをポストする」のセクションを参照してください。 |
<CrnCode> | Y | 経費トランザクション金額の 3 文字の ISO 4217 通貨コードです。例: USD |
<SystemOwner> | N | 新規の参加者: 「はい」に設定された場合、参加者所有者は「システム」に設定されます。この所有者は、共有参加者リストに必要です。「はい」に設定されない場合、参加者所有者はレポート所有者に設定されます。 既存の参加者: 「はい」に設定された場合、参加者所有者は「システム」に設定されます。「はい」に設定されない場合、参加者所有者はレポート所有者と比較されます。レポート所有者と参加者所有者が一致すると、参加者は更新されます。レポート所有者と参加者所有者が一致しなければ、参加者は更新されません。 |
UpdateExisting | N | リクエストが一致する外部 ID で参加者の更新をすべきかどうかを示します。無効にした場合、リクエストは一致する参加者の更新を行いません。提供されない場合、あるいは有効にされた場合、リクエストは一致する参加者の更新を行います。 |
その他の参加者フィールドのマッピング
[その他の参加者をコール] は、参加者とは別にマッピングされます。その他の参加者とは、Veeva アカウントに存在せず、ユーザが自由記述式のテキストで参加者キャプチャできるオプションのセクションです。以下は、その他の参加者に対するデフォルトのフィールドマッピングです。
SAP Concur フィールド | 必須 | 説明 | 例 | Veeva フィールド |
|---|---|---|---|---|
<AttendeeType> | Y | SAP Concur が参加者を特定するために使用する、参加者タイプコードです。 | BUSGUEST | Concur_Settings_vod__c.Other_Attendee_Type_vod__c |
<LastName> | Y | 参加者の姓です。 | Smith | 「その他の参加者」の姓 |
<FirstName> | Y | 参加者の名です。 | John | 「その他の参加者」の名 |
<タイトル> | N | 参加者の役職です。 | NP | 「その他の参加者」の指定 |
<ExternalId> | Y | 参加者の固有識別子で、通常はお客様の外部システムレコードによって提供されます。 | 001d000000CN3ITAA1-JohnSmith | Account_vod__r.Id-FirstNameLastName |
<会社> | N | 参加者の親アカウントです (該当する場合)。 | Chilton Memorial Hospital | Entity_Display_Name_vod__c （関連付けられた施設の場合）または Account_vod_r.Primary_Parent_vod__r.Name |
<CrnCode> | Y | 経費トランザクション金額の 3 文字の ISO 4217 通貨コードです。 | USD | Organization.DefaultCurrencyIsoCode またはユーザ。DefaultCurrencyIsoCode (多通貨が有効にされている場合) |
以下はシステムを設定するための複数の Veeva メッセージに対するデフォルト値です:
名前 | カテゴリ | テキスト | 説明 |
|---|---|---|---|
指名 | コールリポート | 指名 | 経費レポートのテキストベースの参加者の列ヘッダー |
OTHERATTENDEES_VIEW | コールリポート | 費用を負担したその他の参加者 | 表示モードにおける経費レポートのテキストベースの参加者のセクションヘッダー |
OTHERATTENDEES_EDIT | コールリポート | その他の参加者 | 編集モードにおける経費レポートのテキストベースの参加者のセクションヘッダー |
