Skip to content

ServiceNowKnowledgeArticleConfiguration

Source code in docs_src/capo_kendra/types/service_now_knowledge_article_configuration.py
class ServiceNowKnowledgeArticleConfiguration(TypedDict, closed=True):
    crawl_attachments: "capo_kendra.types.boolean.Boolean"
    """<p> <code>TRUE</code> to index attachments to knowledge articles.</p>"""
    include_attachment_file_patterns: NotRequired[
        "capo_kendra.types.data_source_inclusions_exclusions_strings.DataSourceInclusionsExclusionsStrings"
    ]
    """<p>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.</p>"""
    exclude_attachment_file_patterns: NotRequired[
        "capo_kendra.types.data_source_inclusions_exclusions_strings.DataSourceInclusionsExclusionsStrings"
    ]
    """<p>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.</p>"""
    document_data_field_name: (
        "capo_kendra.types.data_source_field_name.DataSourceFieldName"
    )
    """<p>The name of the ServiceNow field that is mapped to the index document contents field in the Amazon Kendra index.</p>"""
    document_title_field_name: NotRequired[
        "capo_kendra.types.data_source_field_name.DataSourceFieldName"
    ]
    """<p>The name of the ServiceNow field that is mapped to the index document title field.</p>"""
    field_mappings: NotRequired[
        "capo_kendra.types.data_source_to_index_field_mapping_list.DataSourceToIndexFieldMappingList"
    ]
    """<p>Maps attributes or field names of knoweldge articles to Amazon Kendra index field names. To create custom fields, use the <code>UpdateIndex</code> API before you map to ServiceNow fields. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html">Mapping data source fields</a>. The ServiceNow data source field names must exist in your ServiceNow custom metadata.</p>"""
    filter_query: NotRequired[
        "capo_kendra.types.service_now_knowledge_article_filter_query.ServiceNowKnowledgeArticleFilterQuery"
    ]
    """<p>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.</p> <p>The query string must be one generated by the ServiceNow console. For more information, see <a href="https://docs.aws.amazon.com/kendra/latest/dg/servicenow-query.html">Specifying documents to index with a query</a>. </p>"""

crawl_attachments instance-attribute

crawl_attachments: Boolean

TRUE to index attachments to knowledge articles.

document_data_field_name instance-attribute

document_data_field_name: DataSourceFieldName

The name of the ServiceNow field that is mapped to the index document contents field in the Amazon Kendra index.

document_title_field_name instance-attribute

document_title_field_name: NotRequired[DataSourceFieldName]

The name of the ServiceNow field that is mapped to the index document title field.

exclude_attachment_file_patterns instance-attribute

exclude_attachment_file_patterns: NotRequired[DataSourceInclusionsExclusionsStrings]

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.

field_mappings instance-attribute

field_mappings: NotRequired[DataSourceToIndexFieldMappingList]

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. The ServiceNow data source field names must exist in your ServiceNow custom metadata.

filter_query instance-attribute

filter_query: NotRequired[ServiceNowKnowledgeArticleFilterQuery]

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.

include_attachment_file_patterns instance-attribute

include_attachment_file_patterns: NotRequired[DataSourceInclusionsExclusionsStrings]

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.