[DOCS] Add custom fields to Jira connectors (elastic#180007)

docs/management/connectors/action-types/jira.asciidoc

@@ -59,6 +59,9 @@ Title:: A title for the issue, used for searching the contents of the knowledge
 Description:: The details about the incident.
 Parent:: The ID or key of the parent issue. Only for `Subtask` issue types.
 Additional comments:: Additional information for the client, such as how to troubleshoot the issue.
+Additional fields::
+An object that contains custom field identifiers and their values. These custom fields must comply with your Jira policies; they are not validated by the connector. For example, if a rule action does not include custom fields that are mandatory, the action might fail.
+
 
 [float]
 [[jira-connector-networking-configuration]]

x-pack/plugins/actions/docs/openapi/bundled.json

@@ -6139,6 +6139,12 @@
                       }
                     ]
                   },
+                  "otherFields": {
+                    "type": "object",
+                    "additionalProperties": true,
+                    "maxProperties": 20,
+                    "description": "Custom field identifiers and their values for Jira connectors.\n"
+                  },
                   "parent": {
                     "type": "string",
                     "description": "The ID or key of the parent issue for Jira connectors. Applies only to `Sub-task` types of issues."
@@ -7207,4 +7213,4 @@
       }
     }
   }
-}
+}

x-pack/plugins/actions/docs/openapi/bundled.yaml

@@ -1724,15 +1724,15 @@ components:
           type: boolean
         host:
           description: |
-            The host name of the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined.
+            The host name of the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined. 
           type: string
         oauthTokenUrl:
           type:
             - string
             - 'null'
         port:
           description: |
-            The port to connect to on the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined.
+            The port to connect to on the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined. 
           type: integer
         secure:
           description: |
@@ -3270,7 +3270,7 @@ components:
     is_preconfigured:
       type: boolean
       description: |
-        Indicates whether it is a preconfigured connector. If true, the `config` and `is_missing_secrets` properties are omitted from the response.
+        Indicates whether it is a preconfigured connector. If true, the `config` and `is_missing_secrets` properties are omitted from the response. 
       examples:
         - false
     is_system_action:
@@ -3724,7 +3724,7 @@ components:
           items:
             type: string
           description: |
-            A list of "carbon copy" email addresses. Addresses can be specified in `user@host-name` format or in name `<user@host-name>` format
+            A list of "carbon copy" email addresses. Addresses can be specified in `user@host-name` format or in name `<user@host-name>` format 
         message:
           type: string
           description: The email message text. Markdown format is supported.
@@ -4301,6 +4301,12 @@ components:
                     - type: array
                       items:
                         type: string
+                otherFields:
+                  type: object
+                  additionalProperties: true
+                  maxProperties: 20
+                  description: |
+                    Custom field identifiers and their values for Jira connectors.
                 parent:
                   type: string
                   description: The ID or key of the parent issue for Jira connectors. Applies only to `Sub-task` types of issues.

x-pack/plugins/actions/docs/openapi/bundled_serverless.json

@@ -4562,4 +4562,4 @@
       }
     }
   }
-}
+}

x-pack/plugins/actions/docs/openapi/bundled_serverless.yaml

@@ -1071,15 +1071,15 @@ components:
           type: boolean
         host:
           description: |
-            The host name of the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined.
+            The host name of the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined. 
           type: string
         oauthTokenUrl:
           type:
             - string
             - 'null'
         port:
           description: |
-            The port to connect to on the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined.
+            The port to connect to on the service provider. If the `service` is `elastic_cloud` (for Elastic Cloud notifications) or one of Nodemailer's well-known email service providers, this property is ignored. If `service` is `other`, this property must be defined. 
           type: integer
         secure:
           description: |
@@ -2617,7 +2617,7 @@ components:
     is_preconfigured:
       type: boolean
       description: |
-        Indicates whether it is a preconfigured connector. If true, the `config` and `is_missing_secrets` properties are omitted from the response.
+        Indicates whether it is a preconfigured connector. If true, the `config` and `is_missing_secrets` properties are omitted from the response. 
       examples:
         - false
     is_system_action:

x-pack/plugins/actions/docs/openapi/components/schemas/run_connector_subaction_pushtoservice.yaml

@@ -97,6 +97,12 @@ properties:
               - type: array
                 items:
                   type: string
+          otherFields:
+            type: object
+            additionalProperties: true
+            maxProperties: 20
+            description: >
+              Custom field identifiers and their values for Jira connectors.
           parent:
             type: string
             description: The ID or key of the parent issue for Jira connectors. Applies only to `Sub-task` types of issues.

x-pack/plugins/stack_connectors/public/connector_types/jira/jira_params.tsx

@@ -417,7 +417,7 @@ const JiraParamsFields: React.FunctionComponent<ActionParamsProps<JiraActionPara
                     'xpack.stackConnectors.components.jira.otherFieldsHelpText',
                     {
                       defaultMessage:
-                        'When adding custom fields, please note that the system does not validate inputs or enforce required fields. To avoid failed actions, ensure compliance with Jira policies.',
+                        'Custom fields are not validated by the connector. To avoid failed actions, ensure compliance with your Jira policies.',
                     }
                   )}
                 />

x-pack/test/screenshot_creation/apps/response_ops_docs/stack_connectors/jira_connector.ts

@@ -13,7 +13,7 @@ export default function ({ getService, getPageObjects }: FtrProviderContext) {
   const pageObjects = getPageObjects(['common', 'header']);
   const actions = getService('actions');
   const testSubjects = getService('testSubjects');
-
+  const additionalFields = `{\n` + `"my_custom_field_id": "custom_field_value"`;
   describe('jira connector', function () {
     beforeEach(async () => {
       await pageObjects.common.navigateToApp('connectors');
@@ -32,6 +32,11 @@ export default function ({ getService, getPageObjects }: FtrProviderContext) {
       await commonScreenshots.takeScreenshot('jira-connector', screenshotDirectories);
       await testSubjects.click('create-connector-flyout-save-test-btn');
       await testSubjects.click('toastCloseButton');
+      const editor = await testSubjects.find('kibanaCodeEditor');
+      await editor.clearValue();
+      await testSubjects.setValue('kibanaCodeEditor', additionalFields, {
+        clearWithKeyboard: true,
+      });
       await commonScreenshots.takeScreenshot('jira-params-test', screenshotDirectories);
       await testSubjects.click('euiFlyoutCloseButton');
     });