Useful links
Grant Peeklogic Support login access to your organization
Salesforce Lightning
- Login to Salesforce.
- In the upper right, click your image (avatar) and then click Settings.
- In the ‘Quick Find’ search field, enter ‘Grant’ and click Grant Account Login Access.
- Set the Access Duration option to Peeklogic LLC Support.
- Click Save.
Errors in Peeklogic Jira Connector: How to Find and Fix
Peeklogic Jira Connector is an essential tool for integrating Salesforce and Jira. Despite its great functionalities, users sometimes encounter errors. Whether you’re experienced or new to the Peeklogic Jira Connector, this post will help you manage these challenges. Join us as we simplify these common errors. Let’s turn obstacles into opportunities for learning in your Salesforce and Jira integration journey
Why Learning about the Errors in Peeklogic Jira Connector
Encountering errors is part of working with complex software or integrations like Salesforce to Jira. Knowing how to fix these errors is crucial. Our goal is to focus on solutions, not just problems, so we’ve documented these errors with detailed screenshots. This guide will help you recognize and resolve these issues effectively.
Some Documented Peeklogic Jira Connector Errors
Named Credentials (Per User) Error
If the Authentication Settings for External Systems are not configured correctly, users may encounter errors when using Named Credentials on a Per User basis.
Text: You don’t have permission to view this data. Ask your administrator to set up authentication for the external data source.
How to Fix It
- Navigate to ‘Setup’, then ‘Profiles’, and ensure that ‘Named Credentials (Per Users)’ is shared with each profile that will use the Jira Connector.
- All users must open their Personal Settings in Salesforce by clicking on their avatar.
Text: You don’t have permission to view this data, enter credentials for the named credential in your personal settings. Or ask your Salesforce admin for help.
- Within Personal Settings, each user should individually create new ‘Authentication Settings for External Systems’. The username should be the Jira Username, and the password should be the Jira API token.
302 Found (Jira Server Error)
When using Jira Server, you may sometimes encounter the following error:
Text:
error
<html>
<head><title>302 Found</title></head>
<body>
<center><h1>302 Found</h1></center>
</body>
</html>
How to Fix It
- Open ‘Setup’.
- Use the ‘Quick Finder’ to locate ‘Custom Setting’.
- Access ‘Jira Admin Settings’.
- Enable the ‘Jira Server platform’ checkbox.
Field and Objects Deployment Errors
If you are deploying fields or objects, you might encounter an error related to Named Credentials in Salesforce.
Text: <div id=”error-state”> <span class=”error-type”> </span> <h1> Oops, you've found a dead link.</h1> <ul> <li>Go back to the <a href=”javascript:window.history.back()”>previous page</a> </li> <li>Go to the <a href=”/secure/MyJiraHome.jspa”>Home Page</a> </li> </ul> </div>
How to Fix It
- Go to ‘Setup’,
- Select ‘Named Credentials’
- Configure the Named Credentials according to the guidelines provided in
- ‘Create and configure Named Credentials to Salesforce’
Apex Class Error
Sometimes you can encounter the rare error depicted on the screen.
Text: Server Error
You don’t have access to the Apex class named ‘ReporterApiController’.
Text:
A Component Error has occurred!
Invalid definition for peeklogic_jc:BaseLightComponnt: Access to entity ‘peeklogic_jc__Jira_Admin_Settings__c’ denied: null
To prevent errors in Apex Classes, ensure that all necessary permissions are granted for objects, fields, and Apex classes associated with the Peeklogic Jira Connector, which uses the ‘peeklogic’ namespace.
List index Out of Bounds Error
If you did not create a Jira Issue view properly, you can encounter the following error:
Text: List index out of bounds: 0
How to Fix It
If you did not create a view for Jira Issue, please follow these steps:
- Open ‘Peeklogic Setup’.
- Select ‘Related Jira Issues View’.
- Click the ‘New’ button.
- Enter a name of your choice and select the required object.
- Choose the Jira fields you want to display.
- Click the ‘Save’ button.
If you created view of Jira Issue, please follow these additional steps:
- Open a record of the object where the Peeklogic Jira Connector is used.
- Click on the gear icon and select ‘Edit Page’.
- Choose ‘Peeklogic Jira Content’.
- In the ‘Related JIRA Issues View’, select the view that you have created.
Error with Jira field
Text: Field ‘customfield_11323’ cannot be set. It is not on the appropriate screen, or unknown.
How to Fix It
You need to add fields in Jira to the appropriate screen. You can follow this documentation
‘Add a custom field to a screen’
Internal Server Error (License-related)
If you encounter the error on the screenshot, please, assign license to users that use Peeklogic Jira Connector.
Text: Undefined You do not have permission to create issues in this project.
How to Fix It
You need to add permissions in Jira to your user following this guide:
Manage project permissions
Conclusion
In conclusion, it’s important to remember that encountering errors is a common aspect of any software product, including those designed for Salesforce to Jira integration. These challenges are a natural part of the evolving landscape of software development and integration, especially in complex environments like Salesforce to Jira.
At Peeklogic, we are committed to continuously improving the Jira Connector, ensuring it remains a robust and user-friendly tool for Salesforce to Jira integration. Our team is dedicated to identifying and addressing issues, enhancing the overall functionality and user experience in this specific integration domain.
We also promise to keep you updated with new documented errors and their solutions, particularly focusing on Salesforce to Jira integration. This ongoing documentation is part of our commitment to transparency and support for our users. By sharing these insights, we aim to empower you to use the Peeklogic Jira Connector more effectively and with greater confidence in your Salesforce to Jira integration tasks.
Frequently Asked Questions
1. What is the Peeklogic Jira Connector and How Does it Enhance Salesforce to Jira Integration?
The Peeklogic Jira Connector is a specialized tool designed to seamlessly integrate Salesforce with Jira. It enables users to synchronize data, track issues, and manage workflows between the two platforms. By using this connector, teams can improve collaboration, increase efficiency, and maintain better project visibility across both Salesforce and Jira environments.
2. How Do I Troubleshoot Common Errors in the Peeklogic Jira Connector?
Common errors in the Peeklogic Jira Connector can range from connectivity issues to data synchronization problems. To troubleshoot, first, check if there are any updates or patches available for the connector. Then, refer to the detailed documentation provided by Peeklogic, which includes screenshots and step-by-step guides for resolving specific errors. For more complex issues, contacting Peeklogic’s customer support can provide additional guidance.
3. Can the Peeklogic Jira Connector be Customized to Fit Specific Workflow Requirements?
Yes, the Peeklogic Jira Connector offers customization options to fit specific workflow requirements. Users can configure the connector to map fields, set synchronization rules, and create custom workflows that align with their organization’s processes. This flexibility ensures that the integration between Salesforce and Jira can be tailored to meet the unique needs of each business.
Useful Links in Salesforce Configurations
- Assign Licenses for Installed Packages
https://help.salesforce.com/s/articleView?id=sf.distribution_assigning_user_licenses.htm&type=5
Useful Links in Jira Configurations
- Add a Jira custom field to create issue screen
https://support.atlassian.com/jira-cloud-administration/docs/add-a-custom-field-to-a-screen/ - Manage Jira project permission
https://support.atlassian.com/jira-cloud-administration/docs/manage-project-permissions/
