aws-cdk-lib.aws_kendra.CfnDataSource.WorkDocsConfigurationProperty

interface WorkDocsConfigurationProperty

LanguageType name
.NETAmazon.CDK.AWS.Kendra.CfnDataSource.WorkDocsConfigurationProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awskendra#CfnDataSource_WorkDocsConfigurationProperty
Javasoftware.amazon.awscdk.services.kendra.CfnDataSource.WorkDocsConfigurationProperty
Pythonaws_cdk.aws_kendra.CfnDataSource.WorkDocsConfigurationProperty
TypeScript aws-cdk-lib » aws_kendra » CfnDataSource » WorkDocsConfigurationProperty

Provides the configuration information to connect to Amazon WorkDocs as your data source.

Amazon WorkDocs connector is available in Oregon, North Virginia, Sydney, Singapore and Ireland regions.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_kendra as kendra } from 'aws-cdk-lib';
const workDocsConfigurationProperty: kendra.CfnDataSource.WorkDocsConfigurationProperty = {
  organizationId: 'organizationId',

  // the properties below are optional
  crawlComments: false,
  exclusionPatterns: ['exclusionPatterns'],
  fieldMappings: [{
    dataSourceFieldName: 'dataSourceFieldName',
    indexFieldName: 'indexFieldName',

    // the properties below are optional
    dateFieldFormat: 'dateFieldFormat',
  }],
  inclusionPatterns: ['inclusionPatterns'],
  useChangeLog: false,
};

Properties

NameTypeDescription
organizationIdstringThe identifier of the directory corresponding to your Amazon WorkDocs site repository.
crawlComments?boolean | IResolvableTRUE to include comments on documents in your index.
exclusionPatterns?string[]A list of regular expression patterns to exclude certain files in your Amazon WorkDocs site repository.
fieldMappings?IResolvable | IResolvable | DataSourceToIndexFieldMappingProperty[]A list of DataSourceToIndexFieldMapping objects that map Amazon WorkDocs data source attributes or field names to Amazon Kendra index field names.
inclusionPatterns?string[]A list of regular expression patterns to include certain files in your Amazon WorkDocs site repository.
useChangeLog?boolean | IResolvableTRUE to use the Amazon WorkDocs change log to determine which documents require updating in the index.

organizationId

Type: string

The identifier of the directory corresponding to your Amazon WorkDocs site repository.

You can find the organization ID in the AWS Directory Service by going to Active Directory , then Directories . Your Amazon WorkDocs site directory has an ID, which is the organization ID. You can also set up a new Amazon WorkDocs directory in the AWS Directory Service console and enable a Amazon WorkDocs site for the directory in the Amazon WorkDocs console.


crawlComments?

Type: boolean | IResolvable (optional)

TRUE to include comments on documents in your index.

Including comments in your index means each comment is a document that can be searched on.

The default is set to FALSE .


exclusionPatterns?

Type: string[] (optional)

A list of regular expression patterns to exclude certain files in your Amazon WorkDocs site repository.

Files that match the patterns are excluded from the index. Files that don’t match the patterns are included in the index. If a file matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file isn't included in the index.


fieldMappings?

Type: IResolvable | IResolvable | DataSourceToIndexFieldMappingProperty[] (optional)

A list of DataSourceToIndexFieldMapping objects that map Amazon WorkDocs data source attributes or field names to Amazon Kendra index field names.

To create custom fields, use the UpdateIndex API before you map to Amazon WorkDocs fields. For more information, see Mapping data source fields . The Amazon WorkDocs data source field names must exist in your Amazon WorkDocs custom metadata.


inclusionPatterns?

Type: string[] (optional)

A list of regular expression patterns to include certain files in your Amazon WorkDocs site repository.

Files that match the patterns are included in the index. Files that don't match the patterns are excluded from the index. If a file matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file isn't included in the index.


useChangeLog?

Type: boolean | IResolvable (optional)

TRUE to use the Amazon WorkDocs change log to determine which documents require updating in the index.

Depending on the change log's size, it may take longer for Amazon Kendra to use the change log than to scan all of your documents in Amazon WorkDocs.