diff --git a/docs/management/connectors/action-types/servicenow-sir.asciidoc b/docs/management/connectors/action-types/servicenow-sir.asciidoc index 164fe70a6d55b..4c3b6d15bf59e 100644 --- a/docs/management/connectors/action-types/servicenow-sir.asciidoc +++ b/docs/management/connectors/action-types/servicenow-sir.asciidoc @@ -64,12 +64,28 @@ The username for HTTP basic authentication. You can test connectors as you're creating or editing the connector in {kib}. For example: [role="screenshot"] -image::management/connectors/images/servicenow-sir-params-test.png[{sn-sir} params test] +image::management/connectors/images/servicenow-sir-params-test.png[{sn-sir} params test, width=75%] {sn-sir} actions have the following configuration properties. 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 fields must exist in the Elastic ServiceNow application and must be specified in JSON format. ++ +-- +For example: +[source,sh] +---- +{ + "u_cmdb_ci": "host-a", + "u_company": "My company", + "u_assignment_group": "Testing" +} +---- +Note that the default source field names in the Elastic ServiceNow application are prefixed with "u_". +-- Category:: The category of the incident. Correlation display:: diff --git a/docs/management/connectors/action-types/servicenow.asciidoc b/docs/management/connectors/action-types/servicenow.asciidoc index 11fe55ade7f95..83f8bd050d044 100644 --- a/docs/management/connectors/action-types/servicenow.asciidoc +++ b/docs/management/connectors/action-types/servicenow.asciidoc @@ -64,12 +64,28 @@ The username for HTTP basic authentication. When you create or edit a connector, use the *Test* tab to test its actions: [role="screenshot"] -image::management/connectors/images/servicenow-params-test.png[ServiceNow params test] +image::management/connectors/images/servicenow-params-test.png[ServiceNow params test, width=75%] {sn-itsm} actions have the following configuration properties. 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 fields must exist in the Elastic ServiceNow application and must be specified in JSON format. +For example: +[source,sh] +---- +{ + "u_cmdb_ci": "host-a", + "u_company": "My company", + "u_assignment_group": "Testing" +} +---- +Note that the default source field names in the Elastic ServiceNow application are prefixed with "u_". +-- Category:: The category of the incident. Correlation display:: @@ -86,6 +102,9 @@ NOTE: Using the default configuration of `{{ruleID}}:{{alert ID}}` ensures that Description:: The details about the incident. +Event action:: +The type of action to test: resolve or trigger. +When you test a resolve action, you must provide a correlation identifier. Impact:: The effect an incident has on business. It can be measured by the number of affected users or by how critical it is to the business in question. @@ -94,7 +113,7 @@ The severity of the incident. Short description:: A short description for the incident, used for searching the contents of the knowledge base. Subcategory:: -The category of the incident. +The subcategory of the incident. Urgency:: The extent to which the incident resolution can delay. diff --git a/docs/management/connectors/images/servicenow-connector-basic.png b/docs/management/connectors/images/servicenow-connector-basic.png index 4cf1f19fe8173..2897b7e80cae5 100644 Binary files a/docs/management/connectors/images/servicenow-connector-basic.png and b/docs/management/connectors/images/servicenow-connector-basic.png differ diff --git a/docs/management/connectors/images/servicenow-connector-oauth.png b/docs/management/connectors/images/servicenow-connector-oauth.png index 8f818185f686b..9b553ae97fc84 100644 Binary files a/docs/management/connectors/images/servicenow-connector-oauth.png and b/docs/management/connectors/images/servicenow-connector-oauth.png differ diff --git a/docs/management/connectors/images/servicenow-params-test.png b/docs/management/connectors/images/servicenow-params-test.png index 5615744973c35..84de4a20b5af5 100644 Binary files a/docs/management/connectors/images/servicenow-params-test.png and b/docs/management/connectors/images/servicenow-params-test.png differ diff --git a/docs/management/connectors/images/servicenow-sir-connector-basic.png b/docs/management/connectors/images/servicenow-sir-connector-basic.png index 1404526f6418d..7a49daaeb6289 100644 Binary files a/docs/management/connectors/images/servicenow-sir-connector-basic.png and b/docs/management/connectors/images/servicenow-sir-connector-basic.png differ diff --git a/docs/management/connectors/images/servicenow-sir-connector-oauth.png b/docs/management/connectors/images/servicenow-sir-connector-oauth.png index 8cac0f7361890..cf94022287157 100644 Binary files a/docs/management/connectors/images/servicenow-sir-connector-oauth.png and b/docs/management/connectors/images/servicenow-sir-connector-oauth.png differ diff --git a/docs/management/connectors/images/servicenow-sir-params-test.png b/docs/management/connectors/images/servicenow-sir-params-test.png index a2bf8761a8824..c56b8a9dafe23 100644 Binary files a/docs/management/connectors/images/servicenow-sir-params-test.png and b/docs/management/connectors/images/servicenow-sir-params-test.png differ