Display API err messages on Jira issues list

Prioritize error messages provided by the API
response, and fall back to a generic message.

Changelog: changed

ee/app/assets/javascripts/integrations/jira/issues_list/components/jira_issues_list_empty_state.vue

@@ -62,9 +62,10 @@ export default {
       <gl-sprintf :message="emptyStateDescription" />
     </template>
     <template v-if="!hasIssues" #actions>
-      <gl-button :href="issueCreateUrl" target="_blank" category="primary" variant="success"
-        >{{ s__('Integrations|Create new issue in Jira') }}<gl-icon name="external-link"
-      /></gl-button>
+      <gl-button :href="issueCreateUrl" target="_blank" category="primary" variant="success">
+        {{ s__('Integrations|Create new issue in Jira') }}
+        <gl-icon name="external-link" />
+      </gl-button>
     </template>
   </gl-empty-state>
 </template>

ee/app/assets/javascripts/integrations/jira/issues_list/components/jira_issues_list_root.vue

@@ -128,8 +128,12 @@ export default {
         })
         .catch((error) => {
           this.issuesListLoadFailed = true;
+          const errorMessage =
+            (error?.response?.data?.errors || [])[0] ||
+            __('An error occurred while loading issues');
+
           createFlash({
-            message: __('An error occurred while loading issues'),
+            message: errorMessage,
             captureError: true,
             error,
           });
@@ -200,9 +204,10 @@ export default {
     @filter="handleFilterIssues"
   >
     <template #nav-actions>
-      <gl-button :href="issueCreateUrl" target="_blank" class="gl-my-5"
-        >{{ s__('Integrations|Create new issue in Jira') }}<gl-icon name="external-link"
-      /></gl-button>
+      <gl-button :href="issueCreateUrl" target="_blank" class="gl-my-5">
+        {{ s__('Integrations|Create new issue in Jira') }}
+        <gl-icon name="external-link" />
+      </gl-button>
     </template>
     <template #reference="{ issuable }">
       <span v-safe-html="jiraLogo" class="svg-container jira-logo-container"></span>

ee/app/controllers/projects/integrations/jira/issues_controller.rb

@@ -106,7 +106,7 @@ module Projects
         def render_request_error(exception)
           log_exception(exception)
 
-          render json: { errors: [_('An error occurred while requesting data from the Jira service')] }, status: :bad_request
+          render json: { errors: [_('An error occurred while requesting data from the Jira service.')] }, status: :bad_request
         end
       end
     end

ee/app/finders/projects/integrations/jira/issues_finder.rb

@@ -30,7 +30,7 @@ module Projects
           raise IntegrationError, _('Jira service not configured.') unless jira_service&.active?
 
           project_key = jira_service.project_key
-          raise IntegrationError, _('Jira project key is not configured') if project_key.blank?
+          raise IntegrationError, _('Jira project key is not configured.') if project_key.blank?
 
           fetch_issues(project_key)
         end

ee/changelogs/unreleased/323304-jira-issues-list-improve-user-facing-error-messages-when-fetch-.yml

+---
+title: Display wider variety of error messages when Jira Issues List fails
+merge_request: 60455
+author:
+type: changed

ee/spec/controllers/projects/integrations/jira/issues_controller_spec.rb

@@ -97,7 +97,7 @@ RSpec.describe Projects::Integrations::Jira::IssuesController do
         get :index, params: { namespace_id: project.namespace, project_id: project }, format: :json
 
         expect(response).to have_gitlab_http_status(:bad_request)
-        expect(json_response['errors']).to eq ['An error occurred while requesting data from the Jira service']
+        expect(json_response['errors']).to eq ['An error occurred while requesting data from the Jira service.']
       end
 
       it 'sets pagination headers' do

ee/spec/finders/projects/integrations/jira/issues_finder_spec.rb

@@ -18,7 +18,7 @@ RSpec.describe Projects::Integrations::Jira::IssuesFinder do
 
     context 'when jira service integration does not have project_key' do
       it 'raises error' do
-        expect { subject }.to raise_error(Projects::Integrations::Jira::IssuesFinder::IntegrationError, 'Jira project key is not configured')
+        expect { subject }.to raise_error(Projects::Integrations::Jira::IssuesFinder::IntegrationError, 'Jira project key is not configured.')
       end
     end
 

ee/spec/frontend/integrations/jira/issues_list/components/jira_issues_list_root_spec.js

@@ -124,7 +124,7 @@ describe('JiraIssuesListRoot', () => {
     describe('when request fails', () => {
       it.each`
         APIErrorMessage | expectedRenderedErrorMessage
-        ${'API error'}  | ${'An error occurred while loading issues'}
+        ${'API error'}  | ${'API error'}
         ${undefined}    | ${'An error occurred while loading issues'}
       `(
         'calls `createFlash` with "$expectedRenderedErrorMessage" when API responds with "$APIErrorMessage"',

locale/gitlab.pot

@@ -3655,7 +3655,7 @@ msgstr ""
 msgid "An error occurred while reordering issues."
 msgstr ""
 
-msgid "An error occurred while requesting data from the Jira service"
+msgid "An error occurred while requesting data from the Jira service."
 msgstr ""
 
 msgid "An error occurred while retrieving calendar activity"
@@ -18321,7 +18321,7 @@ msgstr ""
 msgid "Jira integration not configured."
 msgstr ""
 
-msgid "Jira project key is not configured"
+msgid "Jira project key is not configured."
 msgstr ""
 
 msgid "Jira project: %{importProject}"