4 テストおよびトラブルシューティング

コネクタのデプロイ後には、コネクタが正常に機能することを確認するためにテストを行う必要があります。この章では、コネクタのテストに関連する次のトピックについて説明します。

• テスト・ケースの実行

• トラブルシューティング

4.1 テスト・ケースの実行

テスト・ユーティリティを使用すると、ターゲット・システムへの接続およびターゲット・システムでの基本操作の実行に関する問題の原因を特定できます。

テスト・ユーティリティを使用するには、次のようにします。

1. global.propertiesファイル内に必要な値を指定します。

   このファイルはOIM_HOME/Xellerate/SAP_EP/test/Troubleshootディレクトリにあります。次の表に、テストを実行するための情報を指定するこのファイルのセクションを示します。

   セクション	情報
   SAP Enterprise Portal connection Parameters	ターゲット・システムへの接続に必要な接続パラメータ。 指定する必要のある値の詳細は、「ITリソースの定義」を参照してください。
   Create User Parameters	ユーザー・プロファイルの作成に必要なフィールド情報。
   Modify User Parameters	ユーザー・プロファイル情報の変更に使用されるパラメータの複数のセクションが含まれます。
   Delete User Parameters	ユーザー・プロファイルの削除に必要なフィールド情報。
   Reconciliation information	開始日のタイムスタンプ。 終了日は現在の日時にデフォルトで設定されます。

   
   

2. 「手順2: コネクタ・ファイルおよび外部コード・ファイルのコピー」に示されているJARファイルをすべてCLASSPATH環境変数に追加します。また、次のディレクトリにあるJARファイルもCLASSPATH環境変数に追加する必要があります。

   CLASSPATH環境変数を設定するためのサンプル・コマンドは、global.propertiesファイルに指定されています。

   OIM_HOME/xellerate/lib
   OIM_HOME/xellerate/ext
   

3. 次のようにして、global.propertiesファイルのASCII形式のコピーを作成します。

   
   

   注意: global.propertiesファイルの内容を変更するたびに、この手順を実行してください。

   
   

   1. コマンド・ウィンドウで、次のディレクトリに移動します。

      OIM_HOME/Xellerate/sapep/test/Troubleshoot
      

   2. 次のコマンドを入力します。

      native2ascii global.properties troubleshoot.properties
      

      native2asciiコマンドを実行すると、troubleshoot.propertiesが作成されます。このファイルの内容は、global.propertiesファイルの内容のASCII形式のコピーです。

4. 次のテストを実行します。

   • ユーザーを作成するには、次のコマンドを入力します。

     java
     -DTproperties=OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/troubleShoot.properties
     -Dlog4j.configuration=file:/OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/log
     .properties troubleshoot.TroubleShootUtility C
     

   • ユーザーを変更するには、次のコマンドを入力します。

     java
     -DTproperties=OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/troubleShoot.properties
     -Dlog4j.configuration=file:/OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/log
     .properties troubleshoot.TroubleShootUtility M
     

   • ユーザーを削除するには、次のコマンドを入力します。

     java
     -DTproperties=OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/troubleShoot.properties
     -Dlog4j.configuration=file:/OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/log
     .properties troubleshoot.TroubleShootUtility D
     

   • リコンシリエーションをテストするには、次のコマンドを入力します。

     java
     -DTproperties=OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/troubleShoot.properties
     -Dlog4j.configuration=file:/OIM_HOME/Xellerate/SAP_EP/test/Troubleshoot/log
     .properties troubleshoot.TroubleShootUtility R
     

4.1.1 部分リコンシリエーションのテスト

問合せベースのリコンシリエーションをテストするために、CustomizedReconQueryパラメータの値として次のタイプの問合せ条件を指定できます。

• ユーザー属性を含む単純な問合せ

  CustomizedReconQueryパラメータに割り当てられる値: firstname=John

  名がJohnのユーザーがリコンサイルされます。

• &または|論理演算子で構成される問合せ

  
  

  注意: 問合せ条件には、&および|演算子の両方を含められません。問合せで使用できるのは、これらの演算子のいずれか1つです。 |演算子およびTimeStamp属性の両方を含む問合せ条件は、サポートされていません。

  
  

  CustomizedReconQueryパラメータに割り当てられる値: firstname=John&lastname=Doe|email=[e-mail]

  名がJohnで姓がDoeのユーザーと、電子メール・アドレスが[e-mail]のユーザーがリコンサイルされます。

• 論理演算子と参照コードで構成される問合せ

  CustomizedReconQueryパラメータに割り当てられる値: firstname=John&lastname=Doe&email=[e-mail]&country=US

  名がJohnで姓がDoeのユーザーと、アメリカ在住で電子メール・アドレスが[e-mail]のユーザーがリコンサイルされます。

• ロールのみで構成される問合せ

  CustomizedReconQueryパラメータに割り当てられる値: Role= pcd:portal_content/mycompany/RL_DEMO

  
  

  注意: 問合せ条件には、複数のロール名を指定できません。

  
  

  pcd:portal_content/mycompany/RL_DEMOロールに属するユーザーがリコンサイルされます。

• グループのみで構成される問合せ

  CustomizedReconQueryパラメータに割り当てられる値: Groups=group01

  
  

  注意: 問合せ条件には、複数のグループ名を指定できません。

  
  

  group01グループに属するユーザーがリコンサイルされます。

• LIKE（*）演算子で構成される問合せ

  CustomizedReconQueryパラメータに割り当てられる値:

  • firstname=*ohn

    名にohn文字列を持つユーザーがリコンサイルされます。

  • firstname=Joh*

    名にJoh文字列を持つユーザーがリコンサイルされます。

  
  

  注意: LIKE演算子（*）は、接頭辞または接尾辞です。属性値の中間では使用できません。

  
  

  問合せ条件で、localeまたはtimezone属性を使用する場合、Lookup.SAP.EP.LanguageまたはLookup.SAP.EP.TimeZone参照定義のコード・キー値をそれぞれ指定します。

  たとえば、CustomizedReconQueryパラメータに割り当てられる値:

  locale=ar_iq

  timezone=Africa/Abidjan

4.2 トラブルシューティング

次の各項では、このコネクタに関して発生する一般的な問題の解決方法を示します。

• 接続エラー

• ユーザー作成

• ユーザー削除

• ユーザー変更

• 子データ

4.2.1 接続エラー

次の表は、一般的な接続エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity ManagerはSAP Enterprise Portalとの接続を確立できません。 表示されるエラー・メッセージ: SAP接続例外 表示されるエラー・コード: INVALID_CONNECTION_ERROR	SAP Enterprise Portalが稼働していることおよびsapum.propertiesファイルが正しく構成されていることを確認します。 Oracle Identity Managerが稼働している（つまりデータベースが稼働している）ことを確認します。 すべてのアダプタがコンパイルされていることを確認します。 （「ITリソース」フォームから）Oracle Identity Managerレコードを調べます。IPアドレス、管理者IDおよび管理者パスワードが正しいことを確認します。
ターゲットがありません。 表示されるエラー・メッセージ: ターゲット・サーバーが使用できません 接続エラー - SAP Enterprise Portal接続を確立できません 表示されるエラー・コード: TARGET_UNAVAILABLE_ERROR	SAP Enterprise Portalが稼働していることを確認します。 指定したSAP Enterprise Portalの接続値が正しいことを確認します。
認証エラー。 表示されるエラー・メッセージ: 認証エラー。 表示されるエラー・コード: AUTHENTICATION_ERROR	指定したSAP Enterprise Portalの接続ユーザーIDおよびパスワードが正しいことを確認します。

4.2.2 ユーザー作成

次の表は、一般的なユーザー作成エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーを作成できません。 表示されるエラー・メッセージ: 必要な情報がありません 表示されるエラー・コード: SAPEP.INSUFFICIENT_INFORMATION	次の情報が指定されていることを確認します。 ユーザーID ユーザーの名 ユーザーの姓 ユーザー・パスワード ユーザーの電子メール・アドレス
Oracle Identity Managerはユーザーを作成できません。 表示されるエラー・メッセージ: ユーザーがSAP EPにすでに存在します 表示されるエラー・コード: USER_ALREADY_EXIST	割り当てられたIDのユーザーはすでにSAP Enterprise Portalに存在します。ユーザーに新しいIDを割り当て、再試行します。
Oracle Identity Managerはユーザーを作成できません。 表示されるエラー・メッセージ: ユーザーを作成できませんでした 表示されるエラー・コード: USER_CREATION_FAILED	次のいずれかの理由により、ユーザーは作成されませんでした。 Change Password機能が失敗しました。 必須フィールドの値が指定されていませんでした。

4.2.3 ユーザー削除

次の表は、一般的なユーザー削除エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーを削除できません。 表示されるエラー・メッセージ: 必要な情報がありません 表示されるエラー・コード: SAPEP.INSUFFICIENT_INFORMATION	必要な情報が指定されていることを確認します。この場合の必要な情報とは、ユーザーIDです。
Oracle Identity Managerはユーザーを削除できません。 表示されるエラー・メッセージ: ユーザーが存在しません 表示されるエラー・コード: USER_DOESNOT_EXIST	指定したユーザーがSAP Enterprise Portalに存在しません。

4.2.4 ユーザー変更

次の表は、一般的なユーザー変更エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーの新しい情報を更新できません。 表示されるエラー・メッセージ: ユーザーを変更できませんでした 表示されるエラー・コード: USER_MODIFICATION_FAILED	一般的なエラー。詳細はログを調べてください。
Oracle Identity Managerはユーザーを更新できません。 表示されるエラー・メッセージ: ユーザーが存在しません 表示されるエラー・コード: USER_DOESNOT_EXIST	指定したユーザーがSAP Enterprise Portalに存在しません。ユーザーIDを確認してください。

4.2.5 子データ

次の表は、一般的な子データ・エラーの解決方法を示します。

問題の詳細	解決方法
Oracle Identity Managerはユーザーをグループに追加できません。 表示されるエラー・メッセージ: グループが存在しません 表示されるエラー・コード: GROUP_DOESNOT_EXIST	指定したグループがSAP Enterprise Portalに存在しません。グループ名を確認してください。
Oracle Identity Managerはロールをユーザーに追加できません。 表示されるエラー・メッセージ: ロールが存在しません 表示されるエラー・コード: SAPEP.ROLE_DOESNOT_EXIST	Oracle Identity Managerでユーザーに指定したロールがSAP Enterprise Portalに存在しません。ロール名を確認してください。
重複する値をグループまたはロールに追加しようとしています。 表示されるエラー・メッセージ: ロールはユーザーに割当て済です 選択したグループはすでにユーザーに割り当てられています 表示されるエラー・コード: ROLE_ALREADY_EXISTS GROUP_ALREADY_EXISTS	ユーザーは特定のグループまたはロールにすでに追加されています。