Versions Compared

Key

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


The REST API Seeds configuration guidelines can be found here.

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

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

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


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

ServiceNow

Salesforce Seed Properties


"/kb_view.do?sysparm_article=""/kb_viewdo?sysparm_article="

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).

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
NoThe include resource file to use..

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
useKAFieldListcrawlArticlesNofalseNoSelect this option to crawl Knowledge Articles from Salesforce
articleTypesIf true, include metadata fields for the Knowledge Article table.short_description,sys_updated_on,number,sys_id,sys_updated_by,sys_created_by,textuseUserCriteriaForArticlesNotrueNoIf true, the crawl will query the User Criteria table. If the security option is Use User Criteria, this option is overridden to true.true / falseuseParallelProcessingNotrueNoIf 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
Salesforce Knowledge Article Types
articleStatesListNoDraft, Online, ArchiveNo

The article states to be crawled.


genericKAYes-NoChoose Generic for fetching Only standard data or Custom KA

Generic: Fetch Only standard data from the Knowledge Articles

Specific: Specify the custom types to be crawled.

typeArtTypeincludedArticlesAttachmentsFileNameNo-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
name of the custom article typeex. Custom_kav
enableTlsNotrueYesMark the checkbox if you need the TLS 1.1 and 1.2 for new versions of Salesforce
addAclsNotrueNoMark the checkbox if you need to add ACLs to documents
fetchAttachmentNofalseNoIf true, include
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
useMimeTypeForCatalogincludeAttachmentNofalseNoIf set to true, the connector will match the patterns using the mime type  of the attachment instead of the file name.true / falseyesSpecify regex URL patterns to exclude"includeAttachmentincludedCatalogItemsAttachmentsFileNameNo-YesThe patterns to be used to include catalog attachments for the crawl."includedCatalogItemsAttachmentsFileName": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } ]png[^/]$" } ]
excludeAttachmentexcludedCatalogItemsAttachmentsFileNameNo-YesThe patterns to be used Specify regex URL patterns to exclude catalog attachments for the crawl."excludedCatalogItemsAttachmentsFileNameexcludeAttachment": [ { "pattern": ".*filter1.*" }, { "pattern": ".*filter2.*" } txt[^/]$" } ]

Usage example


Code Block
themeRDark
titlePOST /aspire/_api/seeds
{
	"seed": "servicenowsalesforce_seed",
	"type": "ServiceNowsalesforce",
	"description": "ServiceNowSalesforce 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.*"
			}
		]
	}    "useQueriesFile":false,
    "queries":[
         {
            "type":"KnowledgeArticle__kav",
            "query":"SELECT Id, SystemModstamp, Title, PublishStatus, (SELECT DataCategoryName, DataCategoryGroupName  FROM DataCategorySelections) FROM KnowledgeArticle__kav WHERE IsLatestVersion = true "
         }
      ],
---
If useQueriesFiles is true
"useLocalQueryFile":true,
"queriesFile":"c:\\dev\\sQueries.xml",
---
    "crawlStandardTypes":true,
    "crawlArticles":true,
    "articleTypes":true,
    "articleStatesList":[
         "Draft",
         "Online",
         "Archived"
      ],
    "genericKA":"Specific",
    "specificTypes":[
         {
            "typeArtType":"KnowledgeArticle__kav"
         }
      ],
   "enableTls":true,
   "addAcls":true,
   "fetchAttachment":true,
   "includeAttachment":[
     {
       "pattern":".*png.*"
     }     
   ],
   "excludeAttachment":[
    ] 
}