Package software.amazon.awscdk.cfnpropertymixins.services.kendra

Interface CfnDataSourcePropsMixin.ServiceNowConfigurationProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnDataSourcePropsMixin.ServiceNowConfigurationProperty.Jsii$Proxy

Enclosing class:

CfnDataSourcePropsMixin

@Stability(Stable)
public static interface CfnDataSourcePropsMixin.ServiceNowConfigurationProperty
extends software.amazon.jsii.JsiiSerializable

Provides the configuration information to connect to ServiceNow as your data source.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cfnpropertymixins.services.kendra.*;
 ServiceNowConfigurationProperty serviceNowConfigurationProperty = ServiceNowConfigurationProperty.builder()
         .authenticationType("authenticationType")
         .hostUrl("hostUrl")
         .knowledgeArticleConfiguration(ServiceNowKnowledgeArticleConfigurationProperty.builder()
                 .crawlAttachments(false)
                 .documentDataFieldName("documentDataFieldName")
                 .documentTitleFieldName("documentTitleFieldName")
                 .excludeAttachmentFilePatterns(List.of("excludeAttachmentFilePatterns"))
                 .fieldMappings(List.of(DataSourceToIndexFieldMappingProperty.builder()
                         .dataSourceFieldName("dataSourceFieldName")
                         .dateFieldFormat("dateFieldFormat")
                         .indexFieldName("indexFieldName")
                         .build()))
                 .filterQuery("filterQuery")
                 .includeAttachmentFilePatterns(List.of("includeAttachmentFilePatterns"))
                 .build())
         .secretArn("secretArn")
         .serviceCatalogConfiguration(ServiceNowServiceCatalogConfigurationProperty.builder()
                 .crawlAttachments(false)
                 .documentDataFieldName("documentDataFieldName")
                 .documentTitleFieldName("documentTitleFieldName")
                 .excludeAttachmentFilePatterns(List.of("excludeAttachmentFilePatterns"))
                 .fieldMappings(List.of(DataSourceToIndexFieldMappingProperty.builder()
                         .dataSourceFieldName("dataSourceFieldName")
                         .dateFieldFormat("dateFieldFormat")
                         .indexFieldName("indexFieldName")
                         .build()))
                 .includeAttachmentFilePatterns(List.of("includeAttachmentFilePatterns"))
                 .build())
         .serviceNowBuildVersion("serviceNowBuildVersion")
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnDataSourcePropsMixin.ServiceNowConfigurationProperty.Builder	A builder for CfnDataSourcePropsMixin.ServiceNowConfigurationProperty
static final class	CfnDataSourcePropsMixin.ServiceNowConfigurationProperty.Jsii$Proxy	An implementation for CfnDataSourcePropsMixin.ServiceNowConfigurationProperty

Method Summary

Modifier and Type	Method	Description
static CfnDataSourcePropsMixin.ServiceNowConfigurationProperty.Builder	builder()
default String	getAuthenticationType()	The type of authentication used to connect to the ServiceNow instance.
default String	getHostUrl()	The ServiceNow instance that the data source connects to.
default Object	getKnowledgeArticleConfiguration()	Configuration information for crawling knowledge articles in the ServiceNow site.
default String	getSecretArn()	The Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the user name and password required to connect to the ServiceNow instance.
default Object	getServiceCatalogConfiguration()	Configuration information for crawling service catalogs in the ServiceNow site.
default String	getServiceNowBuildVersion()	The identifier of the release that the ServiceNow host is running.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getAuthenticationType

@Stability(Stable)
@Nullable
default String getAuthenticationType()

The type of authentication used to connect to the ServiceNow instance.

If you choose HTTP_BASIC , Amazon Kendra is authenticated using the user name and password provided in the AWS Secrets Manager secret in the SecretArn field. If you choose OAUTH2 , Amazon Kendra is authenticated using the credentials of client ID, client secret, user name and password.

When you use OAUTH2 authentication, you must generate a token and a client secret using the ServiceNow console. For more information, see Using a ServiceNow data source .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html#cfn-kendra-datasource-servicenowconfiguration-authenticationtype

getHostUrl

@Stability(Stable)
@Nullable
default String getHostUrl()

The ServiceNow instance that the data source connects to.

The host endpoint should look like the following: {instance}.service-now.com.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html#cfn-kendra-datasource-servicenowconfiguration-hosturl

getKnowledgeArticleConfiguration

@Stability(Stable)
@Nullable
default Object getKnowledgeArticleConfiguration()

Configuration information for crawling knowledge articles in the ServiceNow site.

Returns union: either IResolvable or CfnDataSourcePropsMixin.ServiceNowKnowledgeArticleConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html#cfn-kendra-datasource-servicenowconfiguration-knowledgearticleconfiguration

getSecretArn

@Stability(Stable)
@Nullable
default String getSecretArn()

The Amazon Resource Name (ARN) of the AWS Secrets Manager secret that contains the user name and password required to connect to the ServiceNow instance.

You can also provide OAuth authentication credentials of user name, password, client ID, and client secret. For more information, see Using a ServiceNow data source .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html#cfn-kendra-datasource-servicenowconfiguration-secretarn

getServiceCatalogConfiguration

@Stability(Stable)
@Nullable
default Object getServiceCatalogConfiguration()

Configuration information for crawling service catalogs in the ServiceNow site.

Returns union: either IResolvable or CfnDataSourcePropsMixin.ServiceNowServiceCatalogConfigurationProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html#cfn-kendra-datasource-servicenowconfiguration-servicecatalogconfiguration

getServiceNowBuildVersion

@Stability(Stable)
@Nullable
default String getServiceNowBuildVersion()

The identifier of the release that the ServiceNow host is running.

If the host is not running the LONDON release, use OTHERS .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-kendra-datasource-servicenowconfiguration.html#cfn-kendra-datasource-servicenowconfiguration-servicenowbuildversion

builder

@Stability(Stable)
static CfnDataSourcePropsMixin.ServiceNowConfigurationProperty.Builder builder()

Returns:

a CfnDataSourcePropsMixin.ServiceNowConfigurationProperty.Builder of CfnDataSourcePropsMixin.ServiceNowConfigurationProperty