4 Testing and Troubleshooting

After you deploy the connector, you must test it to ensure that it functions as expected. This chapter discusses the following topics related to connector testing:

Testing Reconciliation
Testing Provisioning
Troubleshooting

Testing Reconciliation

Running test cases for reconciliation involves verifying that the PeopleSoft Listener Web application can reconcile employees into Oracle Identity Manager. The following sections provides instructions to perform this test.

Prerequisites for Testing the PeopleSoft Listener Web Application

The following are prerequisites for testing the PeopleSoft Listener Web application:

Ensure that the Microsoft Windows scripting engine is installed. This is required to run VBScript files.
Ensure that the PeopleSoft XML message schema is described in the USR_MGMT_MSG.xml file, which is in the OIM_home/xellerate/test directory.

Testing the PeopleSoft Listener Web Application

To test the PeopleSoft Listener Web application:

In the OIM_home/xellerate/test/cbrecon/psft-xel-test.vbs file:
- Modify the value of the ps_server_url variable so that it points to the URL for the PeopleSoft Listener Web application.
- Specify the required PeopleSoft attributes and employee data values in the ExecuteATM function.
Run psft-xel-test.vbs. Ensure that the script runs without any errors.

When the script is run, it creates a reconciliation event. Verify that the reconciliation event is created in Oracle Identity Manager and that the event contains the data that you specify in the VBScript file.

Performing Trial Reconciliation

Refer to the "Partial Reconciliation" section.

Testing Provisioning

You can use the testing utility to identify the cause of problems associated with connecting to the target system and performing basic operations on the target system.

Before you use the testing utility, you must set the required values in the config.properties file. This file is in the OIM_home/xellerate/XLIntegrations/PSFTBase/config directory.

Use the information in the following table to modify the default attributes of the config.properties file.

Name	Description	Sample Value
`serverName`	IP address or host name of the PeopleSoft User Management server	`172.21.109.95`
`serverPort`	Port at which the PeopleSoft User Management server is listening	`9000`
`admin`	User ID of the PeopleSoft User Management server administrator	`PS`
`ciName`	Component interface used to load user data in PeopleSoft User Management	`USER_PROFILE`
`NumberOfRetries`	Number of times the connection to the target system must be retried before the `InvocationTargetException` is thrown	`2`
`DelayBetweenRetries`	Time difference between subsequent retries (in milliseconds)	`10000`
`action`	Action to be performed	You can specify one of the following values: `CONNECT` `CREATE` `UPDATEUSERINFO` `UPDATEUSER_EMPID` `UPDATEPASSWORD`
`userId`	User login ID	`PSFTTEST`
`userDescription`	Description of the user	`PSFTTEST`
`primaryEmailAddress`	Primary e-mail address	`PSFTTEST@psft.com`
`primaryEmailType`	E-mail type of the primary e-mail account	`BUS`
`password`	Password of the user	`password`
`languageCode`	Language code for the user	`ENG`
`currencyCode`	Currency code for the user	`USD`
`recName`	Used to validate the employee ID during user provisioning in PeopleSoft User Management	PERSONAL_DATA
`empId`	Employee ID for the user	A10000
`primaryPermissionList`	Primary permission list for the user	`HCCPAM1`
`userIdAlias`	User ID alias	PSFTTEST1
`symbId`	Specifies the AccessId associated with the user profile The AccessId specifies whether or not the user has sufficient privileges on the PeopleSoft User Management database.	PS89
`attrName`	Name of the attribute to be updated	You can specify one of the following values: `USER_DESCRIPTION` `EMAIL_ADDRESS` `EMAILTYPE` `MULTI_LANGUAGE_CODE` `LANGUAGE_CODE` `CURRENCY_CODE`
`attrValue`	Value of the attribute to be updated	The value that you provide must correspond to the attribute name that you specify as the value of the `attrName` parameter.

After you specify values in the config.properties file, run one of the following files:

For UNIX:

OIM_home/xellerate/XLIntegrations/tests/scripts/PSFTBase.sh

For Microsoft Windows

OIM_home\xellerate\XLIntegrations\tests\scripts\PSFTBase.bat

Troubleshooting

The following table lists solutions to some commonly encountered issues associated with the PeopleSoft User Management connector.

Problem Description	Solution
Oracle Identity Manager cannot establish a connection with the PeopleSoft User Management server.	Ensure that the PeopleSoft User Management server is running. Ensure that Oracle Identity Manager is running. Ensure that all the adapters have been compiled. Use the IT Resources form to examine the Oracle Identity Manager record. Ensure that the IP address, admin ID, and admin password are correct.
The Operation Fail message is displayed on the Oracle Identity Manager Administrative and User Console.	Ensure that the values for the attributes do not contain delimiter characters, such as white space and commas. Ensure that the attribute values do not exceed allowable length.
The Create User adapter is triggered even when the pre-populate adapter is run successfully.	Set the property associated with the user ID attribute in the process form as required.