Troubleshooting
If you encounter any of the following issues or errors, SailPoint recommends that you follow the guidance provided below to resolve the error before contacting SailPoint Support.
For issues or errors that are not addressed in this connector guide, refer to the following resources for troubleshooting information:
- SailPoint Identity Services Documentation
- SailPoint Support Knowledge Base
- SailPoint Developer Community
User or Role Filter Error
The following error message displays:
Exception during aggregation of Object Type account on Application OracleERP. Reason: Unable to create iterator sailpoint.connector.ConnectorException: { "Errors" : [ { "description" : "PER_IIP_209:Page Mode not supported when querying against database and OID attributes", "code" : "501" } ] }
Resolution: Update the filter query to use the Oracle-supported filter combinations with pagination support. For more information on pagination and filters, refer to the Oracle SaaS documentation. In the search box, type Financials REST API manage collection, this will provide documentation related to filters and pagination in the manage collection link.
Delete account fails with an error message
The following error message displays:
java.lang.UnsupportedOperationException: Delete operation is not supported. For details or troubleshooting, refer to the connector documentation.
Resolution: Set the enableDeleteUserAccount connector attribute to true on the source with the Update Source (Partial) API:
Error message appears for Test Connection, Aggregation or Provisioning operations
The following error message displays:
Exception: sailpoint.connector.ConnectorException: [ ConnectorException ] [ Error details ] javax.net.ssl.SSLPeerUnverifiedException: peer not authenticated
Resolution: Update the openJDK version to 11.0.3 or later.
An error message appears when assigning data access to user
The following error message displays:
openconnector.InvalidRequestException: Role <Role Name> is not assigned to a user, cannot process data access: <Role Name>$<Security Context>$<Security context value>
Resolution: To assign the Data Access, ensure that the corresponding role is assigned to a user.
For example, to assign the Accounts Payable ManagerBusiness unitAccount_BU user Data Access, you need to assign the Accounts Payable Manager role to it.
Create/Modify operation fails with an error message when passing the personNumber in the provisioning plan
The operation fails with the following error message:
OR
Resolution: Add the following attribute using REST API - Update Source (Partial) in SailPoint and then, try creating a user with personNumber.
- Key=
retryWaitTimeValue=60000in ms, default: 30000 ms - Key=
maxRetryCountValue=3, default: 3 - Key=
retryableErrorsValue=[error messages]
Note
The default error messages are, Applying List binding LOV_PersonNumber with given set of values and Another user has changed the row with primary key. If you do not specify any other error message, the connector will use the default error messages and retry.
Entitlement aggregation fails with error
The following error message displays:
Reason: java.lang.RuntimeException: An error occurred while aggregating[ InvalidConfigurationException ][ Error details ] err_msg_oracle_erp_invalid_creds
Resolution: Please review if the password of the service user contains any special characters. If yes, reset the password without any special characters and retry entitlement aggregation.
Create/Update operation fails with LOV_PersonNumber error
Issue: The create/update operation fails with the following error message when the PersonNumber being passed in the provisioning plan has multiple work relationships.
Applying List binding LOV_PersonNumber with given set of values leads to multiple matching rows for a row of type:UserAccount, key oracle.jbo.Key[ 300000020907599 null null null
Resolution: Add the following attribute using REST API - Update Source (Partial), then try creating a user with the personNumber.
Key = provisionPersonId Value = true
provisionPersonId is an boolean attribute.
Note
Ensure you pass the valid personNumber in the provisioning plan. You should not pass the existing assigned personNumber assigned to other accounts.
Provisioning fails with record combination of values error
Account aggregation ad group aggregation fetch different data access. Account aggregation fetches the description of the security context, and group aggregation fetches the value of the security context. For example, group aggregation data access is fetched as Citadel Asset Accountant$Asset book$IN CORP BOOK. However, during account aggregation, the same access is fetched as Citadel Asset Accountant$Asset book$CIT Corporate Asset Book IN, which results in a provisioning error.
Issue: Provisioning fails with error openconnector.ConnectorException: [ ConnectorException ] [ Error details ] A record with this combination of values already exists.
Resolution: Make the SecurityContext value and SecurityContext description the same. For example, change the description of the Asset Book IN CORP BOOK from CIT Corporate Asset Book IN to IN CORP BOOK. Once the value and description are the same, try aggregation/provisioning again.
Documentation Feedback
Feedback is provided as an informational resource only and does not form part of SailPoint’s official product documentation. SailPoint does not warrant or make any guarantees about the feedback (including without limitation as to its accuracy, relevance, or reliability). All feedback is subject to the terms set forth at https://developer.sailpoint.com/discuss/tos.