接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：SAP Concur］> 設定済みの接続を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいSAP Concur 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

SAP Concur への認証

SAP Concur はOAuth 認証のみサポートします。この認証を有効にするには、すべてのOAuth フローでAuthScheme をOAuth に設定し、カスタムOAuth アプリケーションを作成する必要があります。

デスクトップアプリケーション

カスタムOAuth アプリケーションの資格情報を使用して認証するには、OAuth アクセストークンを取得し、更新する必要があります。これらを設定すると、接続の準備が整います。

OAuth アクセストークンの取得およびリフレッシュ：

InitiateOAuth：GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId。
OAuthClientSecret：アプリケーションの登録時に割り当てられたクライアントシークレット。
CallbackURL：アプリケーションの登録時に定義されたリダイレクトURI。

接続すると、本製品はデフォルトブラウザでSAP Concur のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

アクセストークンの期限が切れたときは、本製品は自動でアクセストークンをリフレッシュします。

Note： OAuth フローと、デスクトップクライアントアプリケーションがOAuth 2.0 エンドポイントを呼び出してトークンを取得する方法については、この章で後述する「デスクトップ認証フロー」を参照してください。

デスクトップ認証フロー

トークンを取得するには、クライアントアプリケーションは、必要な認証シナリオに応じ、異なるフローを使用してOAuth 2.0 エンドポイントを呼び出す必要があります。サポートされているフローはCODE とPASSWORD です。

OAuth（CODE グラントフロー）

CODE グラントフローを使用して認証するには、次の接続プロパティを設定します。

AuthScheme：OAuth
UseSandbox：実装サーバーを経由して認証している場合は、これをTrue に設定します。
Region：他の資格情報とともに受信した地理位置情報のリージョン。利用可能な値は、EU（ヨーロッパ）、CN（中国）、およびUS（デフォルト）です。

OAuthPassword（PASSWORD グラントフロー）

PASSWORD グラントフローを使用して認証するには、次の接続プロパティを設定します。

AuthScheme：OAuthPassword。
Username：ユーザーネームまたはユーザーId。
Password：ユーザーのパスワード。
UseSandbox：実装サーバーを使用して認証している場合は、これをTrue に設定します。

Company-Level 認証

Company はSAP Concur プラットフォームの最上位プリンシパルです。アクセストークンとリフレッシュトークンは、ユーザーの場合と同じように、Company に代わって取得することができます。

会社を代表して認証を行うには、以下のプロパティを設定する必要があります。

AuthScheme：CompanyLevelAuth。
CompanyId：会社固有の識別子。
CompanyRequestToken：生成されたCompany Request Token。
OAuthClientId：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントId。
OAuthClientSecret：カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
UseSandbox：実装サーバーを使用して認証している場合は、これをTrue に設定します。

カスタムOAuth アプリケーションの作成の説明に従ってカスタムOAuth アプリケーションを作成したのち、Company Request Token を生成する必要があります。Company Request Token Tool が利用できる場合は、それを使うことができます。そうでない場合は、SAP Concur サポートチームに連絡して、Company Request Token を生成してもらう必要があります。

Company Request Token が正常に生成されると、リクエストトークンツールにCompany UUID とCompany Request Token が表示されます。これらの値は、後で使用するために保存しておきます。

SAP Concur ログインID 変数の使用

ログインID（ユーザーのログインID）は、OAuth 2.0 アクセストークンに関連付けられたユーザーアカウントが、以下のロールのいずれかを持つConcur アカウントを持っている場合に使用できます。

Web Services Administrator for Professional
Can Administer for Standard

ログインID をALL に設定すると、Login ID 引数をサポートするすべてのアカウントの情報が取得されます。

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

SAP Concur への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理を参照してください。

Excel Add-In for SAP Concur