Merge pull request #284463 from PatAltimore/patricka-dss-reference

Add DSS reference to dataflows

Author: prmerger-automator[bot]

articles/iot-operations/connect-to-cloud/concept-dataflow-enrich.md

@@ -5,7 +5,7 @@ author: PatAltimore
 ms.author: patricka
 ms.subservice: azure-data-flows
 ms.topic: concept-article
-ms.date: 08/03/2024
+ms.date: 08/13/2024
 
 #CustomerIntent: As an operator, I want to understand how to create a dataflow to enrich data sent to endpoints.
 ---
@@ -31,7 +31,9 @@ For example, consider the following dataset with a few records, represented as J
 }
 ```
 
-The mapper accesses this dataset through the *distributed state store* (DSS) using a key value based on a *condition* specified in the mapping configuration.
+
+
+The mapper accesses the reference dataset stored in Azure IoT Operations's [distributed state store (DSS)](../create-edge-apps/concept-about-state-store-protocol.md) using a key value based on a *condition* specified in the mapping configuration. Key names in the distributed state store correspond to a dataset in the dataflow configuration.
 
 ```yaml
 datasets:

articles/iot-operations/connect-to-cloud/howto-create-dataflow.md

@@ -5,7 +5,7 @@ author: PatAltimore
 ms.author: patricka
 ms.subservice: azure-data-flows
 ms.topic: how-to
-ms.date: 08/03/2024
+ms.date: 08/13/2024
 
 #CustomerIntent: As an operator, I want to understand how to create a dataflow to connect data sources.
 ---
@@ -16,7 +16,7 @@ ms.date: 08/03/2024
 
 A dataflow is the path that data takes from the source to the destination with optional transformations. You can configure the dataflow using the Azure IoT Operations portal or by creating a *Dataflow* custom resource. Before creating a dataflow, you must [configure dataflow endpoints for the data sources and destinations](howto-configure-dataflow-endpoint.md).
 
-The following is an example of a dataflow configuration with an MQTT source endpoint, transformations, and a Kafka destination endpoint:
+The following example is a dataflow configuration with an MQTT source endpoint, transformations, and a Kafka destination endpoint:
 
 ```yaml
 apiVersion: connectivity.iotoperations.azure.com/v1beta1
@@ -128,13 +128,15 @@ spec:
 
 ### Enrich: Add reference data
 
-To enrich the data, you can use a reference dataset in Azure IoT Operations's distributed state store (DSS). The dataset is used to add extra data to the source data based on a condition. The condition is specified as a field in the source data that matches a field in the dataset.
+To enrich the data, you can use the reference dataset stored in Azure IoT Operations's [distributed state store (DSS)](../create-edge-apps/concept-about-state-store-protocol.md). The dataset is used to add extra data to the source data based on a condition. The condition is specified as a field in the source data that matches a field in the dataset.
 
 | Name                                           | Description                               |
 |------------------------------------------------|-------------------------------------------|
 | builtInTransformationSettings.datasets.key   | Dataset used for enrichment (key in DSS)              |
 | builtInTransformationSettings.datasets.expression | Condition for the enrichment operation    |
 
+Key names in the distributed state store correspond to a dataset in the dataflow configuration.
+
 For example, you could use the `deviceId` field in the source data to match the `asset` field in the dataset:
 
 ```yaml