Understanding errors displayed to the users
Component <component id> is not a part of the global configuration: <global configuration URI>
The user has selected or previously selected a Global Configuration that does not contain the Codebeamer tracker in its composition.
Resolution:
understand if the tracker must be part of the selected Global Configuration
ask your Global Configuration (IBM’s Jazz GC, MID’s CDCM) administrator to contribute your tracker as a local configuration
Unsupported OSLC query
Can occur when the user of a third party tool takes an action that sends a malformed or unexpected OSLC query against the OSLC Connector of Codebeamer.
Resolution: Analyze the message message in the logs and inform the administrator of the third party tool about the invalid query.
OSLC domain <oslc domain URI>, not supported by Service Provider <service provider id>
The OSLC Connector for Codebeamer is unable to retrieve the Codebeamer project that serves artifacts of types specified by the OSLC domain URI.
Resolution: Contact MID support.
TRS is not enabled for this tool
Endpoints to retrieve scheduler info, reseting the TRS base or consolidating the TRS changes into base are called erroneously while the TRS configuration is not enabled.
Resolution: ask the OSLC Connector for Codebeamer administrator to enable TRS. This is achieved by setting trsEnabled to true.
Unexpected ToolAdapter response: expected: {}, received: {}
Returned when retrieving the artifact by revision id returns an artifact with unexpected data for:
component id - doesn’t match the requested tracker ID
resource shape concept id - doesn’t match the requested tracker resource shape
resource shape revision id - doesn’t match the requested tracker resource shape revision
Resolution:
Set the log level to
DEBUG
and replicate the issueExtract the logs and send it to MID
Unable to access global configuration: <global configuration URI>, because: <reason>
Returned when the accessing the Global Configuration provider was possible (not a network or permission issue), but the response from it came in an unexpected format or malformed.
Resolution: The OSLC Connector for Codebeamer administrator must verify the correctness of the globalConfigurationProvider
set in the application configuration.
No Technical User defined
Returned when an oauth2 technical user is not configured in the application configuration, but it is required.
Resolution: The OSLC Connector for Codebeamer must configure the oauth2 information for the technical user in the application configuration.
User does not have permission <for action>.
Possible actions for which the user might not have permissions
MODIFY_LINKS (create or remove a link)
Occurs when the user does not have permissions in the Codebeamer tracker to modify the value of the
OSLC Links
fieldOccurs if the
OSLC Links
field has not been configured for the Codebeamer trackerOccurs when user tries to create/remove links from a third party tool (Smartfacts, DNG, EWM etc. ) without having the correct permissions in Codebeamer
MODIFY_SERVICE_PROVIDER_ASSOCIATIONS
Occurs when the user attempting to add or remove a project association does not have the rights to make that change or the settings window has been opened by the user outside of a project context (by accessing the settings page directly from the browser and not from the UI)
Resolution: ensure with your project administrator that the tracker has the OSLC Links
field correctly created and your user has the necessary permissions to modify the tracker item in the existing state.
Artifact native display not found: component id: <tracker ID>, local configuration id: <'head' or baseline ID>, concept id: <artifact ID>
Occurs when the user attempts to follow an OSLC Connector for Codebeamer URL from a third party tool (Smartfacts, DNG, EWM etc.), but the URL points to an artifact that is not accessible anymore.
Causes:
Tracker does not exist anymore
User does not have permissions to see the tracker
The version of the tracker does not exist anymore
User does not have permissions to see the version of the tracker
Tracker item does not exist anymore
User does not have permissions to see the tracker item
Resolution:
verify that the tracker item exists and you can access it
the global configuration used is correct
Artifact selection dialog not found
Occurs if the OSLC Connector for Codebeamer is not able to identify the selection dialog of a the project selected by the user when attempting to create a new link.
Potential causes:
Selection dialog is not available for the third party tool
Resolution: the OSLC Connector for Codebeamer administrator has to retrieve the logs and contact MID.
Service provider not found: service provider id: '{}'
The project represented by the service provider ID cannot be accessed either because the user doesn’t have permissions to see it, or it cannot be retrieved from the API.
Resolution: confirm the user has the right permissions, API access and that the project exists.
Service provider association id <service provider association id> not found
Can only occur when a user attempts to remove a project association that has already been removed.
Component found: component id: <component id>
Can occur in the following scenarios:
The user attempts to open the delegated UI (preview) of an artifact by hovering on a link in a third party tool
The user attempts to do an action that requires information about the tracker
The user attempts to follow a tracker link from a third party tool into Codebeamer
In all cases the problem could be generated by one of the following:
Tracker does not exist
User does not have permissions to read tracker information in Codebeamer
Resolution: verify that the user can access the tracker identified by the component id
Component native not found: component id: <tracker ID>, local configuration id: <'head' or baseline ID>
The tracker or its version are not accessible for the user, either because the tracker or version does not exist anymore or because the user does not have correct permissions to read the data.
Resolution: Resolution: verify that the user can access the tracker identified by the component id and version identified by local configuration ID
Local configuration not found: component id: <tracker ID>, local configuration id: <'head' or baseline ID>
The tracker or its version are not accessible for the user, either because the tracker or version does not exist anymore or because the user does not have correct permissions to read the data.
Resolution: Resolution: verify that the user can access the tracker identified by the component id and version identified by local configuration ID
TRS page <page number> not found
A TRS page that does not exist has been called by a third party tool or by a manual access done via the browser.
Artifact not found: component id: <tracker ID>, local configuration id: <'head' or baseline ID>, concept id: <tracker item ID>
The tracker item is not accessible for the user, either because the tracker item or the tracker item version does not exist anymore or because the user does not have correct permissions to read the data.
Resolution:
verify that the user can access the tracker item identified by the artifact ID in Codebeamer
verify that the user has REST/API permissions
Artifact revision not found: component id: <tracker ID>, concept id: <tracker item ID>, revision id: <'head' or baseline ID>
The tracker item in its specific version is not accessible for the user, either because the tracker item or the tracker item version does not exist anymore or because the user does not have correct permissions to read the data.
Resolution:
verify that the user can access the tracker item identified by the artifact ID in Codebeamer
verify that the user has REST/API permissions
Resource shape not found: component id: <tracker ID>, local configuration id: <'head' or baseline ID>, concept id: <tracker item ID>
The tracker in its specific version is not accessible for the user or technical user, either because the tracker or the tracker version does not exist anymore or because the user does not have correct permissions to read the data.
Resolution:
verify that the user or technical user can access the tracker item identified by the artifact ID in Codebeamer
verify that the user has REST/API permissions
Resource shape not found: concept id: <tracker ID>
The tracker in its specific version is not accessible for the user or technical user, either because the tracker or the tracker version does not exist anymore or because the user does not have correct permissions to read the data.
Resolution:
verify that the user or technical user can access the tracker item identified by the artifact ID in Codebeamer
verify that the user has REST/API permissions
• Etag incorrect for : <etag value>
Update of remote artifact fails because the artifact has been modified by a different entity.
Resolution: the user has to attempt the action again after refreshing the application.
Failed to load link types
Occurs in the following situations:
User is not authenticated against the OSLC Connector for Codebeamer
User doesn’t have access to the REST/API of Codebeamer