マイクロアプリ

SAP Aribaの統合

SAP Aribaと統合して、追加のログインを必要とせずに再質問の要求を確認し、承認します。

注:

2つのSAP Ariba統合テンプレートが提供されています。ほとんどのユースケースでは、新しいHTTP統合を使用することをお勧めします。このHTTP統合は、キャッシュされたデータ構造を構成するためのより強力な機能です。

追加設定不要のSAP Aribaマイクロアプリの一覧については、「Aribaマイクロアプリの使用」を参照してください。

必須条件の確認

Citrix WorkspaceマイクロアプリにHTTP統合を追加するには、次の値が必要です:

  • ベースURLhttps://openapi.ariba.com/api/approval/v1/prod
  • トークンURLhttps://api.ariba.com/v2/oauth/token
  • クライアントID:クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。SAPではOAuthクライアントIDと呼ばれています。「OAuthクライアントIDとアプリケーションキーの収集」を参照してください。
  • クライアントシークレット:クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時にSAPによって発行される一意の文字列です。
  • Ariba APIkey:これはアプリケーションキーと呼ばれ、スクリプトプロセスで変数を置き換えます。「OAuthクライアントIDとアプリケーションキーの収集」を参照してください。
  • Ariba Realm:スクリプトプロセスで変数を置き換えます。これを見つけるには、SAP管理者に連絡してRealm IDを確認してください。
  • Ariba lastChangeId:前の応答で受信した最後の変更を特定します。応答には、これ以降のすべての変更が含まれます。たとえば、すべての変更を最初から読み込む場合は 、1を使用します。

注:

利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

  • 組織が米国またはヨーロッパにある必要があります。
  • SAP AribaソリューションまたはAriba Networkソリューションのコンポーネントで、現在のライセンスが必要です。
  • SAP Ariba Open API管理者アカウントが必要です。組織のSAP Ariba管理者は、次のリンクのいずれかからSAP Ariba Open API開発者ポータルへのアクセスを要求できます:

  • Citrix GatewayがSAP Aribaへのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。Aribaシングルサインオン構成の手順に従ってください。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

SAP Ariba統合のセットアップ

  1. 管理者アカウントでhttps://developer.ariba.com/api/にログインします。
  2. [ようこそ]ページで、[アプリケーションの作成] を選択します。
  3. 新しいアプリケーションを作成するには、[アプリケーション名][説明] を入力し、[送信] を選択します。

    アプリケーションは、承認を受けるためにSAP Ariba Open APIチームに送信されます。

OAuthクライアントIDとアプリケーションキーの収集

アプリケーションが承認されると(上記セクションで説明)、OAuthシークレットトークンが記載されたメールが届きます。SAP Ariba Open APIチームは、Ariba Realm IDを使用してバックエンドをセットアップし、有効にします。

注:

承認メールを受信するまでは先に進めません。

  1. ログインして [アプリケーション管理] ページに移動します。
  2. 作成したアプリケーションを選択します。
  3. [OAuthクライアントID][アプリケーションキー] をコピーします。
  4. これらを安全な場所に保存して、後で統合をCitrix Workspaceマイクロアプリに追加するときに使用できるようにしておきます。

Citrixマイクロアプリへの統合の追加

次の手順に従って、SAP Ariba HTTP統合をセットアップします。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。ほとんどのユースケースでは、この新しいHTTP統合を使用することをお勧めします。このHTTP統合は、キャッシュされたデータ構造を構成するためのより強力な機能です。

次の手順を実行します:

  1. [マイクロアプリ統合] ページで [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  2. [統合] の下にあるSAP Aribaタイルを選択します。
  3. 統合の [統合名] を入力します。
  4. コネクタのパラメーターを入力します。
    • インスタンスの [ベースURL] を入力します:https://openapi.ariba.com/api/approval/v1/prod
    • アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。
  5. Ariba APIkeyを入力します。このアプリケーションキーは、スクリプトプロセスで変数を置き換えます。「OAuthクライアントIDとアプリケーションキーの収集」を参照してください。
  6. Ariba Realmを入力します。Ariba Realm IDは、スクリプトプロセスで変数を置き換えます。これを見つけるには、SAP管理者に連絡してRealm IDを確認してください。
  7. Ariba lastChangeIdを入力します。前の応答で受信した最後の変更を特定します。応答には、これ以降のすべての変更が含まれます。たとえば、すべての変更を最初から読み込む場合は 、1を使用します。
  8. [サービス認証][認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

    1. [許可の種類のフロー] メニューから [クライアント資格情報] を選択します。
    2. [許可の種類の値] に「client_credentials」を入力します。
    3. [トークン認証] メニューから [認証ヘッダー] を選択します。
    4. [トークンコンテンツの種類] メニューから [URLエンコード形式] を選択します。
    5. [トークンURL] に次のURLを入力します:https://api.ariba.com/v2/oauth/token
    6. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。OAuthサーバーを構成したときに、クライアントIDとシークレットを収集します。「OAuthクライアントIDとアプリケーションキーの収集」を参照してください。
    7. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。「OAuthクライアントIDとアプリケーションキーの収集」を参照してください。
  9. [要求レート制限] トグルを有効にします。[要求数] に「3」と入力し、[時間間隔][1秒] にします。
  10. [要求タイムアウト] フィールドに「120」と入力します。
  11. (オプション)サポートのために24時間のログを保持するには、[ログ] を有効にします。
  12. [保存] を選択して続行します。

これで、最初のデータ同期を設定して実行する準備ができました。同期ルール、スケジュールを満たさない同期、および拒否ルールの詳細については、「データの同期」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Aribaコネクタの仕様」を参照してください。

Aribaマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

SAP Ariba統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

購入申請の承認: 承認保留中の購入申請とその詳細、承認するアクションを表示します。

通知またはページ ユースケースワークフロー
保留中の承認通知 新しい購入申請が承認待ちの場合、承認者は通知を受け取ります。
保留中の次の承認通知 新しい購入申請が次のレベルの承認を待っている状態のとき、次の承認者は通知を受け取ります。
購入申請作成通知 新しい購入申請が作成されると、申請の送信者は詳細が記載された通知を受け取ります。
購入申請変更済み通知 新しい購入申請の状態が変更されると、申請の送信者は通知を受け取ります。
承認依頼ページ 承認待機中の購入申請の検索可能なリストと詳細へのリンクが表示されます。
購入申請の詳細の承認者ページ 購入申請の詳細ビューと購入申請の [承認] および [拒否] のアクションが表示されます。
購入申請の詳細の申請者ページ 購入申請の詳細ビューを申請者に提供します。

従来のSAP Ariba統合の追加

SAP Ariba統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。SAP Aribaでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • API URL
  • OAuthトークンURL
  • OAuthクライアントID
  • OAuthクライアントシークレット
  • アプリケーションキー
  • 領域ID

次の手順を実行します:

  1. マイクロアプリの概要ページから、[開始] を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. Aribaタイルを選択します。
  4. 統合の名前を入力します。

    Aribaコネクタのパラメーター、API URL、OAuthトークンURL、OAuthクライアントID、OAuthクライアントシークレット、アプリケーションキー、領域ID

  5. 前の手順で収集したコネクタのパラメーターを入力します。
    • ターゲットシステムのサービス認証の [API URL][OAuthトークンURL] の資格情報を入力します。
    • [OAuthクライアントID][クライアントシークレット] を入力します。
    • [アプリケーションキー][領域ID] を入力します。
    • サンドボックス環境にデータを読み込む必要がある場合は、[サンドボックス] を切り替えます。
    • [Aribaサービスの要求レート制限、秒ごとの最大要求数] に値を入力します。このフィールドは必須で、秒ごとの呼び出し数を決定します。値を適切に設定するためのインスタンスの制限については、Aribaの担当者に相談してください。レートの制限がわからない場合は、安全なレートとして1秒に呼び出し10回以下が推奨値です。すべての制限を完全に無効にするには、0を指定できます。ただし、要求レートが高すぎると、アクセス拒否が発生することがあります。
    • [完全同期の開始時の変更ID] に値を選択します。完全同期によりデータロードの量が制限され始めると、完全同期中に古い変更がスキップされます。すべてをロードする場合は、この値を空にします。
    • (オプション)[同期中に400 Bad Request応答を無視] トグルを有効にすると、400 Bad Requestの応答エラーから回復できます。同期中にAribaのレコードが削除された場合、要求されたデータが存在しないため、Ariba APIはエラーを返します。ログに警告が生成されます。
  6. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用のマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。詳しくは、「必要なエンティティの確認」を参照してください。同期ルール、スケジュールを満たさない同期、および拒否ルールの詳細については、「データの同期」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Aribaコネクタの仕様」を参照してください。

従来のSAP Aribaマイクロアプリ

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

従来のSAP Ariba統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

購入申請の承認: 承認保留中の購入申請とその詳細、承認するアクションを表示します。

通知またはページ ユースケースワークフロー
保留中の承認(変更)通知 承認待ちの購入申請の詳細が変更されると、承認者は通知を受け取ります。
保留中の承認(新規)通知 新しい購入申請が承認待ちの場合、承認者は通知を受け取ります。
購入申請変更通知 新しい購入申請の状況が変更されると、ユーザーは通知を受け取ります。
購入申請作成通知 新しい購入申請が作成されると(送信済みまたは作成中)、ユーザーは通知を受け取ります。
承認依頼ページ パーソナライズされた承認依頼と詳細へのリンクの一覧を提供します。
購入申請の詳細ページ 購入申請の詳細ビューとアクション可能な承認ボタンを提供します。
SAP Aribaの統合