/
Understanding errors displayed to the users

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:

  1. understand if the tracker must be part of the selected Global Configuration

  2. 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:

  1. Set the log level to DEBUG and replicate the issue

  2. Extract 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 field

    • Occurs if the OSLC Links field has not been configured for the Codebeamer tracker

    • Occurs 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