- スタート アップ ガイド
- プロジェクト管理
- ドキュメント
- 変更影響分析を使用する
- Test Cloud のアクセシビリティ テスト
- プロジェクトの運用とユーティリティ
- Test Manager の設定
- ALM ツールとの連携
- API 連携
- テスト用のエージェントのコーディング
- トラブルシューティング
通信ユーザーを作成し、UiPath サービスをアクティブ化し、必要に応じて OAuth 2.0 を設定して、SAP システムを Test Manager 用に設定します。
UiPath Test Manager と SAP システム間の通信を確立するには、通信ユーザーを作成して必要なサービスをアクティブ化し、SAP システムを構成します。
Web サービスの基本認証と RFC の場合
SAP システムに通信ユーザーを作成して必要な UiPath サービスをアクティブ化し、Test Manager が Web サービスの基本認証または RFC 接続上でヒートマップと変更影響分析のデータを取得できるようにします。
- UiPath Test Manager と連携するために、SAP システム内に通信ユーザーを作成します。組織の内部ポリシーに基づいて、必要なロールと認可を割り当てます。
- この連携には、RFC または Web サービス (HTTPS) を介した標準のインターフェイスを使用します。
- UiPath では、RFC 接続の場合を除き、特定の認可を必要としません。
注:RFC 接続を使用する場合は、
S_RFCACL権限オブジェクトを通信ユーザに割り当てます。 - 連携に Web サービス (HTTPS) 接続を使用する予定の場合は、UiPath との接続を確立するために必要な SAP サービスをアクティブ化します。
注:
これらのサービスは読み取り専用操作に使用されます。UiPath が SAP システムから情報を取得するときに使用するのは、
HTTP GETメソッドのみです。
次のリストに、ヒートマップと変更影響分析を使用するためにアクティブ化する必要がある SAP サービスを示します。
- ヒートマップ サービス:
/sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet/sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet/sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet
- 変更影響分析サービス:
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet
上記のサービスをアクティブ化するには、以下の手順を実行します。
- SAP システムのユーザー インターフェイスに移動します。
SICFトランザクションを実行します。- [ICF 階層呼出のフィルタ(Filter for Calling ICF Hierarchy)] セクションで、[階層タイプ(Hierarchy Type)] フィールドに
SERVICEが入力されていることを確認します。
図 1.SAP の [ICF 階層呼出のフィルタ] 画面
- [ 実行 ] を選択して、
SICFトランザクションの実行を終了します。選択画面が表示され、SAP システムで利用可能なさまざまなサービスが表示されます。
図 2. SAP で利用可能なすべてのサービスが表示された選択画面
- [ Virtual Hosts/Services] で、メニュー パスとして [
default_host>sap>opu>odata>uipath] を展開します。初めてアクティブ化する場合、UiPath サービスは灰色表示されている可能性があります。これは、インストール済みであるもののアクティブになっていないことを示します。アクティブ化すると、太字で表示されます。 uipathの下にある UiPath サービスの各エントリのコンテキスト メニューを開いて、[サービスをアクティブ化] を選択します。
図 3. UiPath サービスのアクティブ化
- [ICF サービスのアクティブ化] ポップアップ ウィンドウで [はい] を選択し、サービスのアクティブ化を確定します。 サービスがアクティブ化されると、太字で表示されます。
SAP サービスについて詳しくは、こちらをご覧ください
次の表で、ヒートマップ サービスとその目的について説明します。
| サービス | 説明 |
|---|---|
/sap/opu/odata/UIPATH/HEATMAP_AGGREGATES_SRV/AllAggregatesSet | 集計されたすべてのレコード (データを、より少ない要約されたエントリにロールアップしたデータ) を取得します。このサービスは最初に呼び出され、利用可能なデータ期間の開始日と終了日が判別され、それが FinalHeatmapSetに渡されます。 |
/sap/opu/odata/UIPATH/TRANSPORT_INFO_SRV/TransportsStatusSet | 指定した日付範囲内のすべての移送を、その詳細と併せて取得します。 |
/sap/opu/odata/UIPATH/TRANSPORT_LOOKBACK_SRV/TransportLookbackSet | 指定した 2 つの日付の間の期間での月ごとの移送回数を返します。 |
/sap/opu/odata/UIPATH/S4_CHECK_SRV/S4Info | 接続されている SAP システムが SAP S/4HANA かどうかを確認します。 |
/sap/opu/odata/UIPATH/HEATMAP_OVERVIEW_SRV/FinalHeatmapSet | ヒートマップの設定に使用する AllAggregatesSetによって返された日付期間の実際のトランザクション数を取得します。 |
次の表で、変更影響分析サービスとその目的について説明します。これらのサービスは、変更の影響を受ける SAP 移送の分析と検索をサポートします。
| サービス | 説明 |
|---|---|
/sap/opu/odata/UIPATH/GET_TRANSPORT_EXES_SRV/TransportExesSet | UiPath のカスタム テーブルから分析データを取得します。このサービスは、バックエンドの変更影響分析ロジックの一部です。 |
/sap/opu/odata/UIPATH/TRANSPORT_STATUS_SRV/TransportStatusSet | 指定した日付範囲内の移送の分析ステータス (分析済みまたは未分析) を返します。 |
/sap/opu/odata/UIPATH/EXE_ANALYSIS_SRV/GetTransportAnalysis | 指定した日付範囲内の移送を分析し、その結果を UiPath のカスタム テーブルに保存します。 |
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/TransportAnalysisSet | 影響を受けるユーザーのリストを含む、指定した移送の完全な分析を返します。移送がまだ分析されていない場合は、最初に分析され、結果が保存されます。 |
/sap/opu/odata/UIPATH/GET_TRANSPORT_ALLITEMS_SRV/DetailsSet | 指定した移送の完全な分析を返します。移送がまだ分析されていない場合は、最初に分析され、結果が保存されます。 |
Web サービスの OAuth 認証の場合
理論的根拠
提供される移送には、UiPath サービスに必要なすべての移送可能なオブジェクト (OAuth プロファイル、カスタマイジング エントリ) が含まれます。ただし、SAP では、セキュリティ上およびシステム固有の理由から、OAuth の完全な構成の移送は許可されていません。このため、提供されているトランスポートをインポートした後は、お使いの環境で OAuth の構成を手動で完了する必要があります。
Context
機密データを保護し、システムの整合性を維持するために、完全な OAuth 構成を転送することはできません。
- クライアント シークレットはシステム固有である - セキュリティ コンプライアンスのため、シークレットをエクスポートまたはインポートすることはできません。
- 認可サーバーの URL は環境によって異なる - 各ランドスケープ (開発、品質、本番) で一意のエンドポイントが使用されます。
- 証明書と STRUST エントリはローカルです - SSL/TLS 信頼は、各システムで手動で構成する必要があります。
- ユーザの割り当てとロールはクライアント依存 - 技術ユーザと権限はシステムによって異なります。
- 機密データの保護 - 露出を防ぐために OAuth の資格情報とトークンを移送することはできません。
前提条件
各環境 (DEV、QA、PROD) では、個別の手動設定が必要です。次の前提条件を必ず実行してください。
- エンドポイントと資格情報のドキュメントを安全な場所に保管します。 手順 5 で認可エンドポイントとトークン エンドポイントを指定する必要があります。
- 認可エンドポイントのチェックが実行されていることを確認します。トランザクション
SICFに移動して実行します。:/sap/bc/sec/oauth2 に移動します。ノード「authorize(承認エンドポイント)」がアクティブであることを確認します。非アクティブな場合は、ノードのコンテキスト メニューを開き、[ サービスをアクティブ化] を選択します。
図 4. 認可エンドポイントのチェック
-
トークン エンドポイントのチェックが実行されていることを確認します。トランザクション
SICFに移動します。:/sap/bc/sec/oauth2 に移動します。ノード「token(トークン エンドポイント)」がアクティブであることを確認します。非アクティブな場合は、ノードのコンテキスト メニューを開き、[ サービスをアクティブ化] を選択します。 -
認可エンドポイントの命名規則に従います。 認可エンドポイントの例を次に示します。https://vhclashci.dummy.nodomain:44301/sap/bc/sec/oauth2/authorization?sap-client=100
- パート 1 はドメイン名 -
https://vhclashci.dummy.nodomain- トランザクションRZ11を実行し、エントリ「icm/host_name_full」を検索します。この値は、エンドポイント内のエントリのドメイン名になります。 - パート 2 はポート番号 -
44301- トランザクションSMICMを実行し、メニュー パス「Goto->Services」を選択し、HTTPS プロトコルを検索して HTTPS に関連付けられた番号を使用します。 - パート 3: 静的文字列 -
/sap/bc/sec/oauth2/authorization- 値「/sap/bc/sec/oauth2/authorization」をハードコーディングします。 - パート 4: SAP クライアント -
100- 現在使用している SAP クライアントを入力します。
- パート 1 はドメイン名 -
手順
-
移送のインポートの詳細と利用可否を確認します。
-
OAuth プロファイルが利用可能であることを確認します。トランザクション
SE80を使用して、OAuth 2.0 クライアント プロファイルが利用可能であることを確認します。 -
ドロップダウン メニューから [パッケージ] を選択します。
-
テキスト ボックスに「/UIPATH/HEATMAP」と入力します。ドロップダウン メニューに [OAuth 2.0 クライアント プロファイル] が表示されます。プロファイルが利用できない場合は、UiPath サポートにお問い合わせください。
-
図 5. 移送のインポートを確認する
-
クライアント ID/ユーザー ID/システム ユーザーとクライアント シークレットを設定します。
-
トランザクション
SUO1については、セキュリティ チームに連絡してユーザーを作成します。 -
会社の命名基準に従って、
/UIPATH/サービスへのアクセス権を持つシステム ユーザーを作成します。 -
会社の命名基準に従ってパスワードを生成します。パスワードは、後で OAuth2 構成時の「シークレット」になります。
-
-
SSL/TLS の信頼を構成します。トランザクション
STRUSTについては、Basis チームに連絡して証明書を確認します。 -
OAuth 2.0 の設定を作成します。
-
[トランザクション
OA2C_CONFIG] で [作成] を選択し、使用する移送されたプロファイルをポップアップで選択します。(最終的には、リストに表示されているすべてのプロファイルを使用します。) -
プロファイル名を入力します。
-
[クライアント名] に [ユーザー名] を入力します。
-
[OK] を選択します。
-
フィールドを設定し、構成を保存します。
- クライアント シークレット: 各クライアントに対応するスコープ (サーバー) を選択します。
- 認可エンドポイント URL (このトピックの「前提条件」のセクションを確認してください。)
- トークン エンドポイント URL (このトピックの「前提条件」のセクションを確認してください。)
- クライアントの認可: [基本] のラジオ ボタンを選択します。
- 選択した付与タイプ: [クライアント資格情報] のラジオ ボタンを選択します。
- 更新トークンの有効性: テキストボックスに
-1を入力します。 - クロックスキュー許容範囲:テキストボックスに
5を入力します。
-
[ 概要 ] 画面を確認します。この画面は以下のスクリーンショットのようになります。
-
図 6. OAuth の概要ページ 1
図 7. OAuth の概要ページ 2
-
トランザクション SOAUTH2 で OAuth2 クライアントを構成します。
-
トランザクション
SOAUTH2の場合は [作成] を選択し、最初の画面で次の情報を入力します。- クライアントの種類: 機密
- クライアント ID: 上記 (手順 3) と同じユーザー名を入力します
- 説明: サービス名またはプロファイル名を入力します。
- トークンの有効時間: 3600 秒
-
[次へ] を選択し、2 番目の画面で次の情報を入力します。
- クライアント ユーザー ID とパスワード - オン
- SSL 証明書 - オン
- チェック パラメーター:「クライアント ID」– オン
-
[次へ] を選択し、3 番目の画面で次の情報を入力します。
- 付与タイプ クライアント資格情報アクティブ – オン
-
[次へ] を選択し、4 番目の画面で次の情報を入力します。
- [OAuth2 スコープ ID] で最初の空の行を見つけ、空白行の末尾にあるドロップダウン リストを選択します。
- UiPath に関連付けられているスコープを 1 つずつ選択して、すべて選択します。
/UIPATH/ANALYZED_YES_OR_NO_SRV_0001/UIPATH/EXE_ANALYSIS_SRV_0001/UIPATH/GET_TRANSPORT_ALLITEMS_SRV_0001/UIPATH/GET_TRANSPORT_DETAILS_SRV_0001/UIPATH/GET_TRANSPORT_EXES_SRV_0001/UIPATH/HEATMAP_AGGREGATES_SRV_0001/UIPATH/HEATMAP_OVERVIEW_SRV_0001/UIPATH/TRANSPORT_INFO_SRV_0001/UIPATH/TRANSPORT_LOOKBACK_SRV_0001/UIPATH/TRANSPORT_STATUS_SRV_0001/UIPATH/ZS4_CHECK_SRV_0001
-
[ 概要] を選択します。画面は次の例のようになります。
-
図 8. OAuth2 クライアントの概要ページ
- 接続をテストします。
- トランザクション
SE38を実行し、プログラム名「/UIPATH/TEST_OAUTH2_SERVICE」を入力します。 - [Execute] を選択します。選択/パラメーター画面が表示されます。
- システム/ユーザー/パスワードと一致するように次のパラメーターを更新します。
- ポート – HTTPS ポート
- クライアント – 現在のクライアントが既定で変数に設定されます。
- シークレット – Client_ID/ユーザーのパスワードを入力します。
- システム名 – 現在のシステム名が既定で変数に設定されます。
- クライアント ID – UiPath サービスのユーザー ID を入力します。
- [Execute] を選択します。結果が次の画面に表示されます。「200」に等しいサービス ステータスを探します。その他のリターン コードはエラーを示します。
- トランザクション
図 9. 接続のテスト
結果
SAP システムが、必要な通信ユーザー、アクティブ化されたサービス、および OAuth 2.0 の設定で構成されます。Test Manager との接続を確立してヒートマップと変更影響分析を実行する準備が整います。