# ServiceNowKnowledgeArticleConfiguration
<a name="API_ServiceNowKnowledgeArticleConfiguration"></a>

Provides the configuration information for crawling knowledge articles in the ServiceNow site.

## Contents
<a name="API_ServiceNowKnowledgeArticleConfiguration_Contents"></a>

 ** DocumentDataFieldName **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-DocumentDataFieldName"></a>
The name of the ServiceNow field that is mapped to the index document contents field in the Amazon Kendra index.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[a-zA-Z][a-zA-Z0-9_.]*$`   
Required: Yes

 ** CrawlAttachments **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-CrawlAttachments"></a>
 `TRUE` to index attachments to knowledge articles.  
Type: Boolean  
Required: No

 ** DocumentTitleFieldName **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-DocumentTitleFieldName"></a>
The name of the ServiceNow field that is mapped to the index document title field.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[a-zA-Z][a-zA-Z0-9_.]*$`   
Required: No

 ** ExcludeAttachmentFilePatterns **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-ExcludeAttachmentFilePatterns"></a>
A list of regular expression patterns applied to exclude certain knowledge article attachments. Attachments that match the patterns are excluded from the index. Items that don't match the patterns are included in the index. If an item matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the item isn't included in the index.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 250 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

 ** FieldMappings **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-FieldMappings"></a>
Maps attributes or field names of knoweldge articles to Amazon Kendra index field names. To create custom fields, use the `UpdateIndex` API before you map to ServiceNow fields. For more information, see [Mapping data source fields](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html). The ServiceNow data source field names must exist in your ServiceNow custom metadata.  
Type: Array of [DataSourceToIndexFieldMapping](API_DataSourceToIndexFieldMapping.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 100 items.  
Required: No

 ** FilterQuery **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-FilterQuery"></a>
A query that selects the knowledge articles to index. The query can return articles from multiple knowledge bases, and the knowledge bases can be public or private.  
The query string must be one generated by the ServiceNow console. For more information, see [Specifying documents to index with a query](https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html).   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Pattern: `^\P{C}*$`   
Required: No

 ** IncludeAttachmentFilePatterns **   <a name="kendra-Type-ServiceNowKnowledgeArticleConfiguration-IncludeAttachmentFilePatterns"></a>
A list of regular expression patterns applied to include knowledge article attachments. Attachments that match the patterns are included in the index. Items that don't match the patterns are excluded from the index. If an item matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the item isn't included in the index.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 250 items.  
Length Constraints: Minimum length of 1. Maximum length of 300.  
Required: No

## See Also
<a name="API_ServiceNowKnowledgeArticleConfiguration_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kendra-2019-02-03/ServiceNowKnowledgeArticleConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kendra-2019-02-03/ServiceNowKnowledgeArticleConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kendra-2019-02-03/ServiceNowKnowledgeArticleConfiguration)