This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::QBusiness::DataSource DocumentAttributeCondition
<a name="aws-properties-qbusiness-datasource-documentattributecondition"></a>

The condition used for the target document attribute or metadata field when ingesting documents into Amazon Q Business. You use this with [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DocumentAttributeTarget.html) to apply the condition.

For example, you can create the 'Department' target field and have it prefill department names associated with the documents based on information in the 'Source\$1URI' field. Set the condition that if the 'Source\$1URI' field contains 'financial' in its URI value, then prefill the target field 'Department' with the target value 'Finance' for the document.

Amazon Q Business can't create a target field if it has not already been created as an index field. After you create your index field, you can create a document metadata field using `DocumentAttributeTarget`. Amazon Q Business then will map your newly created metadata field to your index field.

## Syntax
<a name="aws-properties-qbusiness-datasource-documentattributecondition-syntax"></a>

To declare this entity in your CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-qbusiness-datasource-documentattributecondition-syntax.json"></a>

```
{
  "[Key](#cfn-qbusiness-datasource-documentattributecondition-key)" : String,
  "[Operator](#cfn-qbusiness-datasource-documentattributecondition-operator)" : String,
  "[Value](#cfn-qbusiness-datasource-documentattributecondition-value)" : DocumentAttributeValue
}
```

### YAML
<a name="aws-properties-qbusiness-datasource-documentattributecondition-syntax.yaml"></a>

```
  [Key](#cfn-qbusiness-datasource-documentattributecondition-key): String
  [Operator](#cfn-qbusiness-datasource-documentattributecondition-operator): String
  [Value](#cfn-qbusiness-datasource-documentattributecondition-value): 
    DocumentAttributeValue
```

## Properties
<a name="aws-properties-qbusiness-datasource-documentattributecondition-properties"></a>

`Key`  <a name="cfn-qbusiness-datasource-documentattributecondition-key"></a>
The identifier of the document attribute used for the condition.  
For example, 'Source\$1URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents.  
Amazon Q Business currently doesn't support `_document_body` as an attribute key used for the condition.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[a-zA-Z0-9_][a-zA-Z0-9_-]*$`  
*Minimum*: `1`  
*Maximum*: `200`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Operator`  <a name="cfn-qbusiness-datasource-documentattributecondition-operator"></a>
The identifier of the document attribute used for the condition.  
For example, 'Source\$1URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents.  
Amazon Q Business currently does not support `_document_body` as an attribute key used for the condition.  
*Required*: Yes  
*Type*: String  
*Allowed values*: `GREATER_THAN | GREATER_THAN_OR_EQUALS | LESS_THAN | LESS_THAN_OR_EQUALS | EQUALS | NOT_EQUALS | CONTAINS | NOT_CONTAINS | EXISTS | NOT_EXISTS | BEGINS_WITH`  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Value`  <a name="cfn-qbusiness-datasource-documentattributecondition-value"></a>
The value of a document attribute. You can only provide one value for a document attribute.  
*Required*: No  
*Type*: [DocumentAttributeValue](aws-properties-qbusiness-datasource-documentattributevalue.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)