software.amazon.awssdk.services.kendra.model

Class BoxConfiguration

java.lang.Object

software.amazon.awssdk.services.kendra.model.BoxConfiguration

All Implemented Interfaces:

Serializable, SdkPojo, ToCopyableBuilder<BoxConfiguration.Builder,BoxConfiguration>

@Generated(value="software.amazon.awssdk:codegen")
public final class BoxConfiguration
extends Object
implements SdkPojo, Serializable, ToCopyableBuilder<BoxConfiguration.Builder,BoxConfiguration>

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

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BoxConfiguration.Builder

Method Summary

Modifier and Type	Method and Description
static BoxConfiguration.Builder	builder()
List<DataSourceToIndexFieldMapping>	commentFieldMappings() A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box comments to Amazon Kendra index field names.
Boolean	crawlComments() TRUE to index comments.
Boolean	crawlTasks() TRUE to index the contents of tasks.
Boolean	crawlWebLinks() TRUE to index web links.
String	enterpriseId() The identifier of the Box Enterprise platform.
boolean	equals(Object obj)
boolean	equalsBySdkFields(Object obj)
List<String>	exclusionPatterns() A list of regular expression patterns to exclude certain files and folders from your Box platform.
List<DataSourceToIndexFieldMapping>	fileFieldMappings() A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box files to Amazon Kendra index field names.
<T> Optional<T>	getValueForField(String fieldName, Class<T> clazz)
boolean	hasCommentFieldMappings() For responses, this returns true if the service returned a value for the CommentFieldMappings property.
boolean	hasExclusionPatterns() For responses, this returns true if the service returned a value for the ExclusionPatterns property.
boolean	hasFileFieldMappings() For responses, this returns true if the service returned a value for the FileFieldMappings property.
int	hashCode()
boolean	hasInclusionPatterns() For responses, this returns true if the service returned a value for the InclusionPatterns property.
boolean	hasTaskFieldMappings() For responses, this returns true if the service returned a value for the TaskFieldMappings property.
boolean	hasWebLinkFieldMappings() For responses, this returns true if the service returned a value for the WebLinkFieldMappings property.
List<String>	inclusionPatterns() A list of regular expression patterns to include certain files and folders in your Box platform.
List<SdkField<?>>	sdkFields()
String	secretArn() The Amazon Resource Name (ARN) of an Secrets Manager secret that contains the key-value pairs required to connect to your Box platform.
static Class<? extends BoxConfiguration.Builder>	serializableBuilderClass()
List<DataSourceToIndexFieldMapping>	taskFieldMappings() A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box tasks to Amazon Kendra index field names.
BoxConfiguration.Builder	toBuilder()
String	toString() Returns a string representation of this object.
Boolean	useChangeLog() TRUE to use the Slack change log to determine which documents require updating in the index.
DataSourceVpcConfiguration	vpcConfiguration() Configuration information for an Amazon VPC to connect to your Box.
List<DataSourceToIndexFieldMapping>	webLinkFieldMappings() A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box web links to Amazon Kendra index field names.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder

copy

Method Detail

enterpriseId

public final String enterpriseId()

The identifier of the Box Enterprise platform. You can find the enterprise ID in the Box Developer Console settings or when you create an app in Box and download your authentication credentials. For example, 801234567.

Returns:

The identifier of the Box Enterprise platform. You can find the enterprise ID in the Box Developer Console settings or when you create an app in Box and download your authentication credentials. For example, 801234567.

secretArn

public final String secretArn()

The Amazon Resource Name (ARN) of an Secrets Manager secret that contains the key-value pairs required to connect to your Box platform. The secret must contain a JSON structure with the following keys:

• clientID—The identifier of the client OAuth 2.0 authentication application created in Box.

• clientSecret—A set of characters known only to the OAuth 2.0 authentication application created in Box.

• publicKeyId—The identifier of the public key contained within an identity certificate.

• privateKey—A set of characters that make up an encryption key.

• passphrase—A set of characters that act like a password.

You create an application in Box to generate the keys or credentials required for the secret. For more information, see Using a Box data source.

Returns:

The Amazon Resource Name (ARN) of an Secrets Manager secret that contains the key-value pairs required to connect to your Box platform. The secret must contain a JSON structure with the following keys:

• clientID—The identifier of the client OAuth 2.0 authentication application created in Box.

• clientSecret—A set of characters known only to the OAuth 2.0 authentication application created in Box.

• publicKeyId—The identifier of the public key contained within an identity certificate.

• privateKey—A set of characters that make up an encryption key.

• passphrase—A set of characters that act like a password.

You create an application in Box to generate the keys or credentials required for the secret. For more information, see Using a Box data source.

useChangeLog

public final Boolean useChangeLog()

TRUE to use the Slack change log to determine which documents require updating in the index. Depending on the data source change log's size, it may take longer for Amazon Kendra to use the change log than to scan all of your documents.

Returns:

TRUE to use the Slack change log to determine which documents require updating in the index. Depending on the data source change log's size, it may take longer for Amazon Kendra to use the change log than to scan all of your documents.

crawlComments

public final Boolean crawlComments()

TRUE to index comments.

Returns:

TRUE to index comments.

crawlTasks

public final Boolean crawlTasks()

TRUE to index the contents of tasks.

Returns:

TRUE to index the contents of tasks.

crawlWebLinks

public final Boolean crawlWebLinks()

TRUE to index web links.

Returns:

TRUE to index web links.

hasFileFieldMappings

public final boolean hasFileFieldMappings()

For responses, this returns true if the service returned a value for the FileFieldMappings property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

fileFieldMappings

public final List<DataSourceToIndexFieldMapping> fileFieldMappings()

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box files to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasFileFieldMappings() method.

Returns:

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box files to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

hasTaskFieldMappings

public final boolean hasTaskFieldMappings()

For responses, this returns true if the service returned a value for the TaskFieldMappings property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

taskFieldMappings

public final List<DataSourceToIndexFieldMapping> taskFieldMappings()

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box tasks to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasTaskFieldMappings() method.

Returns:

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box tasks to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

hasCommentFieldMappings

public final boolean hasCommentFieldMappings()

For responses, this returns true if the service returned a value for the CommentFieldMappings property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

commentFieldMappings

public final List<DataSourceToIndexFieldMapping> commentFieldMappings()

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box comments to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasCommentFieldMappings() method.

Returns:

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box comments to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

hasWebLinkFieldMappings

public final boolean hasWebLinkFieldMappings()

For responses, this returns true if the service returned a value for the WebLinkFieldMappings property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

webLinkFieldMappings

public final List<DataSourceToIndexFieldMapping> webLinkFieldMappings()

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box web links to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasWebLinkFieldMappings() method.

Returns:

A list of DataSourceToIndexFieldMapping objects that map attributes or field names of Box web links to Amazon Kendra index field names. To create custom fields, use the UpdateIndex API before you map to Box fields. For more information, see Mapping data source fields. The Box field names must exist in your Box custom metadata.

hasInclusionPatterns

public final boolean hasInclusionPatterns()

For responses, this returns true if the service returned a value for the InclusionPatterns property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

inclusionPatterns

public final List<String> inclusionPatterns()

A list of regular expression patterns to include certain files and folders in your Box platform. Files and folders that match the patterns are included in the index. Files and folders that don't match the patterns are excluded from the index. If a file or folder matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file or folder isn't included in the index.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasInclusionPatterns() method.

Returns:

A list of regular expression patterns to include certain files and folders in your Box platform. Files and folders that match the patterns are included in the index. Files and folders that don't match the patterns are excluded from the index. If a file or folder matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file or folder isn't included in the index.

hasExclusionPatterns

public final boolean hasExclusionPatterns()

For responses, this returns true if the service returned a value for the ExclusionPatterns property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.

exclusionPatterns

public final List<String> exclusionPatterns()

A list of regular expression patterns to exclude certain files and folders from your Box platform. Files and folders that match the patterns are excluded from the index.Files and folders that don't match the patterns are included in the index. If a file or folder matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file or folder isn't included in the index.

Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasExclusionPatterns() method.

Returns:

A list of regular expression patterns to exclude certain files and folders from your Box platform. Files and folders that match the patterns are excluded from the index.Files and folders that don't match the patterns are included in the index. If a file or folder matches both an inclusion and exclusion pattern, the exclusion pattern takes precedence and the file or folder isn't included in the index.

vpcConfiguration

public final DataSourceVpcConfiguration vpcConfiguration()

Configuration information for an Amazon VPC to connect to your Box. For more information, see Configuring a VPC.

Returns:

Configuration information for an Amazon VPC to connect to your Box. For more information, see Configuring a VPC.

toBuilder

public BoxConfiguration.Builder toBuilder()

Specified by:

toBuilder in interface ToCopyableBuilder<BoxConfiguration.Builder,BoxConfiguration>

builder

public static BoxConfiguration.Builder builder()

serializableBuilderClass

public static Class<? extends BoxConfiguration.Builder> serializableBuilderClass()

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object obj)

Overrides:

equals in class Object

equalsBySdkFields

public final boolean equalsBySdkFields(Object obj)

Specified by:

equalsBySdkFields in interface SdkPojo

toString

public final String toString()

Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.

Overrides:

toString in class Object

getValueForField

public final <T> Optional<T> getValueForField(String fieldName,
                                              Class<T> clazz)

sdkFields

public final List<SdkField<?>> sdkFields()

Specified by:

sdkFields in interface SdkPojo