Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Modify a Basic Auto Submit Filter

 

Use this API to modify a basic auto submit filter in Junos Space Service Now.

URI

https://[host]/api/juniper/servicenow/autosubmit-filter-management/autosubmitFilters /{filterId}/modify (HTTP method = POST)

URI Parameters

Element

Type

Required

Description

filterd

Integer

Yes

ID of the filter to be modified

Consumes

  • application/vnd.juniper.servicenow.autosubmit-filter-management.filter+xml; version=1;charset=UTF-8

  • application/vnd.juniper.servicenow.autosubmit-filter-management.filter+json; version=1;charset=UTF-8

Request Elements

Element

Type

Description

name

String

Name of the filter

type

String

Type of the filter

Possible value—Basic

action

String

Action to be taken on incidents that match the filter condition and term criteria

Possible values:

  • SubmitCase

  • DoNotSubmitCase

  • AssociateToAnExistingCase

caseId

String

D of case with which the incident must be associated.

Note: This element is required only when the filter action is set to AssociateToAnExistingCase

termCriteria

String

Criterion for implementing the action defined in the filter

Possible values:

  • AND—The action defined in the filter is applied to an incident only when the incident matches all the terms defined in the filter

  • OR—Action defined in the filter is applied to an incident when the incident matches any term defined in the filter

filterAttributes

filterAttribute

Attributes of the filter

name

String

Attribute based on which to filter incidents

Possible values—EventType, EventSynopsis, Description, DeviceName, Platform, Entity, EventOccuredDate, and DeviceIP

condition

String

Condition of the filter term

A filter attribute condition defines the conditions such as words that can be present or not present in an event synopsis, the date before or after which the event should occur, or specific platforms.

Possible values—Include, DoesNotInclude, Is, IsNot, Before, After, On, StartsWith, EndsWith, LessThan, and GreaterThan

Note:

  • When the name element is set to EventOccuredDate, the possible values for the condition element are Before, After, and On.

  • When the name element is set to DeviceIP, the possible values for the condition element are Is, IsNot, LessThan, and GreaterThan

value

String

Value assigned to the attribute

Produces

  • application/vnd.juniper.servicenow.autosubmit-filter-management.filter +xml;version=1

  • application/vnd.juniper.servicenow.autosubmit-filter-management.filter +json;version=1

Response Elements

Element

Type

Description

uri

String

URI of the filter

id

Integer

ID of the filter

domainId

Integer

ID of the domain to which the filter is assigned

name

String

Name of the filter

type

String

Type of filter

Possible value—Basic

action

String

Action to be taken on incidents that match the filter conditions and term criteria

Possible values:

  • SubmitCase

  • DoNotSubmitCase

  • AssociateToAnExistingCase

createdBy

String

User who created the filter

priority

Integer

Order in which the filter is applied to incidents

status

String

Status of the filter

Possible values:

  • Enabled—Filter can be applied to incidents

  • Disabled—Filter cannot be applied to incidents

termCriteria

String

Criterion for implementing the action defined in the filter

Possible values:

  • AND—The action defined in the filter is applied to an incident only when the incident matches all the terms defined in the filter

  • OR—Action defined in the filter is applied to an incident when the incident matches any term defined in the filter

filterAttribute

String

Terms defined in the filter

name

String

Attribute based on which to filter a JMB

Possible values—EventType, EventSynopsis, Description, DeviceName, Platform, Entity, EventOccuredDate, and DeviceIP

condition

String

Condition of the filter term

A filter attribute condition defines the conditions such as words that can be present or not present in an event synopsis, the date before or after which the event should occur, or specific platforms.

Possible values—Include, DoesNotInclude, Is, IsNot, Before, After, On, StartsWith, EndsWith, LessThan, and GreaterThan

Note:

  • When the name element is set to EventOccuredDate, the possible values for the condition element are Before, After, and On.

  • When the name element is set to DeviceIP, the possible values for the condition element are Is, IsNot, LessThan, and GreaterThan

value

String

Value assigned to the attribute

method

String

Methods applicable to the filter

Sample Input

Sample XML Input

Sample JSON Input

Sample Output

Sample XML Output

Sample JSON Output