SAP Concur - API移行ガイド ​

SAP Concurでは、List v3 API、List item v3 API、およびExpense report v2 APIが非推奨となり、List v4、List item v4、およびExpense report v4 APIに置き換えられました。 List v3やList item v3などの一部のAPIはConcurによって非推奨とされていますが、廃止日は設定されていません。 できるだけ早くそれぞれのv4 APIに移行することをお勧めします。

Expense report v2 APIについては、Concurによって非推奨日または廃止日は設定されていません。 ただし、Concurの最新APIを利用するために、新しいアクションへ移行することをお勧めします。

これに伴い、Workatoではこれらのエンドポイントを利用する古いアクションを非推奨とし、新しいV4 APIを利用する新しいエンドポイントを公開しました。 Concurのこの特定のバージョンアップグレードでは、ユーザーの介入なしにアクションを自動的にアップグレードできない変更が導入されました。 以下では、アクションの移行方法について説明します。

影響を受ける可能性のあるアクションの詳細については、サポートチームにお問い合わせください。

非推奨のアクションから新しいトリガー/アクションへの移行 ​

これらのアクションを利用するConcurレシピでは、レシピエディター内のアクションの横に目立つDeprecatedタグが表示されます。 非推奨のアクションは合計5つあります:

1. すべてのリストを取得
2. リスト項目を取得
3. リスト項目を作成
4. リスト項目を削除
5. 経費レポートの詳細を取得
6. 新しい経費レポート
7. 新しい経費レポートの送信
8. 新規または更新された経費レポートの送信

レガシーAPIを使用するアクションでは、レシピエディター内のアクションの横に非推奨タグが表示されます

これらのアクションを置き換えるには、非推奨のアクションと入力設定内のActionセクションをクリックし、アクションを切り替えます。 次に、現在の名前でアクションを検索します。 唯一の例外は、Get list itemsがGet All List itemsに置き換えられていることです

同じ名前のアクションが2つ表示されます。1つは現在選択されている非推奨タグ付きのアクションで、もう1つは新しいアクションです

移行するアクションについては、以下のガイドをお読みください。

すべてのリストを取得 ​

非推奨のGet all listsアクションには入力がありませんでした。

新しいGet all listsアクションに切り替えると、page numberとsort byの2つの新しいフィールドが追加されます。 この新しいアクションで同じ数のレコードが生成されることを確認し、必要に応じて、目的の数のリストを取得するためのページネーションを構築します。

Get All listアクションの出力データピルがダウンストリームアクションに正しく再マッピングされていることを確認してください。

リスト項目を取得 ​

非推奨のGet list itemsアクションには、list IDの入力と、さまざまなレベルコードの入力が含まれていました。 アクションを変更する前に、既存のマッピングを記録してください。

新しいGet All List itemsアクションに切り替えるときは、以前のlist ID入力を、対応する新しいList ID入力フィールドにマッピングする必要があります。 レベルコードはShort code or value入力フィールドにマッピングする必要があります。 APIのV4では、リスト項目の値で直接フィルタリングすることもできます。

Get All listアクションの出力データピルがダウンストリームアクションに正しくマッピングされていることを確認してください。

リスト項目を作成 ​

非推奨のCreate list itemアクションには、List、Item name、およびレベルコードの入力が含まれていました。 アクションを変更する前に、既存のマッピングを記録してください。

新しいリスト項目作成アクションに切り替えると、リスト入力をドロップダウンから選択するか、リストIDを指定できるようになります。 リストIDを取得するには、Get all listsアクションを使用できます。 Item nameをValueに、Level 1 codeをShort codeにマッピングします。

新しいCreate list itemには、必要に応じてダウンストリームアクションにマッピングできる入力があります。

リスト項目を削除 ​

非推奨のDelete list itemアクションには、List name/IDとItem name/IDの入力が含まれています。 アクションを変更する前に、既存のマッピングを記録してください。

新しいリスト項目削除アクションに切り替えると、リストと項目をドロップダウンから選択するか、IDを指定できるようになります。 リスト名または項目名をデータピルとして使用していた場合、アクションの前に別のステップを追加し、Get all listsアクションでリストIDを取得するか、Get list itemsを使用して値で検索し、リスト項目IDを取得する必要があります。

どちらの削除アクションにも出力はありません。

経費レポートの詳細を取得 ​

非推奨のGet expense report detailsアクションには、Report IDの入力が含まれています。 アクションを変更する前に、既存のマッピングを記録してください。 ユーザーIDの値は、レポートの所有者であるConcurユーザーの一意のIDである必要があり、Get All usersアクションから取得できます。

新しい経費レポート/新しい経費レポートの送信/新規または更新された経費レポートの送信 ​

非推奨のトリガーはすべてExpense report v4 APIに関連しています。 トリガーを切り替えると、出力データピルが異なる場合があります。出力データピルの再マッピングが必要なアクションについては、レシピエディター上の警告で通知されます。