You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »


The REST API Seeds configuration guidelines can be found here.

The Salesforce connector Seeds “type” must always be specified as “Salesforce”.

The Salesforce connector Seeds “seed” can be any string.

The Properties specific to the Salesforce connector Seeds are described below.


ServiceNow Seed Properties


FieldRequiredDefaultMultipleNotesExample
propertiesNo-NoConfiguration object
useQueriesFile (true)NoTrue
Use file for queries
useLocalQueryFileNoTrue
Check to specify a local file or disable to specify an uploaded resource file.
queriesFileNofalseNoUse this field to specify where the Queries File will be placed. If not, a default Queries File will be used.${appbundle.home}/config/sQueries.txt 
includeResourceNo"/kb_view.do?sysparm_article="NoThe include resource file to use."/kb_view.do?sysparm_article="

queries


True
True

type: Name of the Object

query: The query to use for the specified Object


crawlStandardTypes NotrueNoSelect to crawl Standard Objects from Salesforce  Fetch only Standard Objects configured in the Queries section
useKAFieldListNofalseNoIf true, include metadata fields for the Knowledge Article table.short_description,sys_updated_on,number,sys_id,sys_updated_by,sys_created_by,text
useUserCriteriaForArticlesNotrueNoIf true, the crawl will query the User Criteria table. If the security option is Use User Criteria, this option is overridden to true.true / false
useParallelProcessingNotrueNoIf true, the scan will query the minimum number of fields to start processing in parallel, then the populate will complete the item's metadata.
patternFieldYes-NoThe field to be used when including/excluding articles: 0 = Article Number, 1 = Short Description, 4 = Knowledge Base Name.
0 / 1 / 4
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
useEmptyRolesNotrueNoIf true, the crawl will use Roles=Null as filter for the documents. true / false
useUserCriteriaForCatalogNotrueNo If true, the crawl will use the User Criteria table to validate Available and NotAvailable fields. If the security option is Use User Criteria, this option is overridden to true.true / false
useParallelProcessingNotrueNoIf true, the scan will query the minimum number of fields to start processing in parallel, then the populate will complete the item's metadata.true / false
useCatFieldListNofalseNoIf true, include metadata fields for Catalog Item table.sys_id,sys_updated_on,sys_name,short_description,sys_updated_by,sys_created_by,description
includeCatalogModelFieldsNofalseNoIf set to true, includes the key fields of the model associated to the catalog item.true / false
catalogItemsSecurityNoPublicNo

Public: Only public catalog items will be crawled. If Available For field is set, terms with empty Role should only be public User Criteria values. If No Available For is set, the item will not be crawled.

User Criteria: ACLs for catalog items and attachments will be the sys_id of the Available For and No Available For  (requires server configuration).



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.*" } ]
includeCatalogItemsAttachmentsNofalseNoIf 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
useMimeTypeForCatalogNofalseNoIf set to true, the connector will match the patterns using the mime type  of the attachment instead of the file name.true / false
includedCatalogItemsAttachmentsFileNameNo-YesThe patterns to be used to include catalog attachments for the crawl."includedCatalogItemsAttachmentsFileName": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]
excludedCatalogItemsAttachmentsFileNameNo-YesThe patterns to be used to exclude catalog attachments for the crawl."excludedCatalogItemsAttachmentsFileName": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]

Usage example


POST /aspire/_api/seeds
{
	"seed": "servicenow_seed",
	"type": "ServiceNow",
	"description": "ServiceNow Test Seed",
	"connector": "02ab6c29-61e3-42ff-9c4f-52811d0c2c38",
	"connection": "e3f76fd9-9517-430a-9064-9cf447473ddd",
	"workflows": [],
	"tags": [],
	"properties": {
		"seed": "servicenow_seed",
		"includeArticles": true,
		"articlesDisplayUrlBase": "/kb_view.do?sysparm_article=",
		"useKBSecurity": false,
		"patternField": "1",
		"includesA": [
			{
				"pattern": ".*Sales.*"
			}
		],
		"excludesA": [
			{
				"pattern": ".*Technology.*"
			}
		],
		"includeKAItemsAttachments": 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.*"
			}
		]
	}
}



  • No labels