Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


REST API Seeds configuration guidelines can be found here.

ServiceNow Amazon S3 Connector Seeds "type" must always be specified as "servicenows3".

ServiceNow Amazon S3 Connector Seeds "seed" can be any stringwill be the path to be crawled. It can be a bucket, folder or file.

Properties specific to the ServiceNow Amazon S3 Connector Seeds are described below.


Easy Heading Free
navigationTitleOn this Page
navigationExpandOptionexpand-all-by-default

ServiceNow

Amazon S3 Seed Properties


"includedCatalogItemsAttachmentsFileName": { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" }
FieldRequiredDefaultMultipleNotesExample
propertiesNo-NoConfiguration object
includeArticlesNofalseNoIf set to true, knowledge articles will be crawled and, optionally, attachments for those articles can be crawled too.true / false
articlesDisplayUrlBaseNo"/kb_view.do?sysparm_article="NoThe base display URL for articles."/kb_view.do?sysparm_article="
useKBSecurityNofalseNoIf set to true, ACLs for articles and attachment are retrieved (requires server configuration).true / false

seedpatternFieldYes-NoThe field to be used when including/excluding articles: 0 = Article Number, 1 = Title.
0 / 1
includesANo-YesThe patterns to be used to include articles for the crawl."includesA": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
excludesANo-Yesthe patterns to be used to exclude articles for the crawl."excludesA": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
includeKAItemsAttachmentsNofalseNoIf set to true, knowledge articles' attachments will be crawled.true / false
includeArticlesAttachmentsRegexNofalseNoIf set to true, include/exclude patterns filtering will be allowed for articles' attachments.true / false
useMimeTypeNofalseNoIf set to true, the connector will match the patterns using the mime type  of the attachment instead of the file name.true / false
includedArticlesAttachmentsFileNameNo-YesThe patterns to be used to include article attachments for the crawl."includedArticlesAttachmentsFileName": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
excludedArticlesAttachmentsFileNameNo-YesThe patterns to be used to exclude article attachments for the crawl."excludedArticlesAttachmentsFileName": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
includeCatalogItemsNofalseNoIf set to true, catalog items will be crawled.true / false
includeCatalogModelFieldsNofalseNoIf set to true, includes the key fields of the model associated to the catalog item.true / false
patternFieldCatalogYes-NoThe field to be used when including/excluding catalog items: 2 = Catalog Title, 3 = Short Description.
2 / 3
includesCNo-YesThe patterns to be used to include catalog items for the crawl."includesC": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
excludesCNo-YesThe patterns to be used to exclude catalog items for the crawl."excludesC": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
path to be crawled. It can be a bucket, folder or file."/myBucket/myFolder"
processSplitFilesincludeCatalogItemsAttachmentsNofalseNouseMimeTypeForCatalogNofalseNoIf set to true, catalog items' attachments will be crawled.true / false
includeCatalogItemsAttachmentsRegexNofalseNoIf set to true, include/exclude patterns filtering will be allowed for catalog items' attachments.true / false
If set to true, the connector will match the patterns using the mime type  of the attachment instead of the file namefiles that are split are treated as a single document instead of multiple documents.
true / false
includedCatalogItemsAttachmentsFileNamesplitPatternsNo-YesThe patterns to be used to include catalog attachments for the crawl.[]excludedCatalogItemsAttachmentsFileNameNo-YesThe patterns to be used to exclude catalog attachments for the crawl.List of regular expressions to match folders that contain split files.[".*splitted.*",".*split.*""excludedCatalogItemsAttachmentsFileName": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]

Usage example


Code Block
themeRDark
titlePOST /aspire/_api/seeds
{
	"seed": "servicenow_seed/myBucket/myFolder",
	"type": "ServiceNows3",
	"description": "ServiceNowAmazon TestS3 Seed Test",
	"connector": "02ab6c29187ae173-61e332c2-42ff48fe-9c4fb4fe-52811d0c2c381b6eea02f166",
	"connection": "e3f76fd98f3233a9-95174c8d-430a4520-9064b335-9cf447473dddea1d9433720e",
	"workflows": [],
	"tags": [],
	"properties": {
		"seed": "servicenow_seed",
		"includeArticles": true,
		"articlesDisplayUrlBase": "/kb_view.do?sysparm_article=/myBucket/myFolder",
		"useKBSecurity": false,
		"patternField": "1",
		"includesA": [
			{
				"pattern": ".*Sales.*"
			}
		],
		"excludesA": [
			{
				"pattern": ".*Technology.*"
			}
		],
		"includeKAItemsAttachments": processSplitFiles": true,
		"includeArticlesAttachmentsRegex": true,
		"useMimeType": false,
		"includedArticlesAttachmentsFileName": [],
		"excludedArticlesAttachmentsFileName": [
			{
				"pattern": ".*2021.*"
			},
			{
				"pattern": ".*2022.*"
			}
		],
		"includeCatalogItems": true,
		"includeCatalogModelFields": false,
		"patternFieldCatalog": "2",
		"includesC": [
			{
				"pattern": ".*Sales.*"
			}
		],
		"excludesC": [
			{
				"pattern": ".*Technology.*"
			}
		],
		"includeCatalogItemsAttachments": true,
		"includeCatalogItemsAttachmentsRegex": true,
		"useMimeTypeForCatalog": false,
		"includedCatalogItemsAttachmentsFileName": [],
		"excludedCatalogItemsAttachmentsFileName": [
			{
				"pattern": "*.2021.*"
			},
			{
				"pattern": ".*2022.*"
			}
		splitPatterns": []
	}
}