View for Reference Datasets
A reference dataset is a reference to a recipe's output, which can been added to a flow other than the one where the recipe is located.
Click the plus icon next to the recipe and select Create Reference Dataset.
Note
A reference dataset is a read-only object in the flow where it is referenced. A reference dataset must be created in the source flow from the recipe to use. For more information, see View for Recipes.
![FlowView-Reference-icon.png](../../../../../image/uuid-5f461e16-a5d7-5019-522e-a7ff19d39297.png)
Figure: Reference Dataset icon in source flow
The following options are available when you right-click the reference dataset:
View details: Explore details of the reference dataset. See Dataset Details Page.
Add to Flow: Click to add the reference dataset to a new or existing flow.
Edit name and description: Change the name and description for the object.
Delete Reference Dataset: Remove the reference dataset from the flow.
Warning
Deleting a reference dataset in the source flow causes all references to it to be broken in the flows where it is referenced. These broken references should be fixed by swapping in new sources.
The following options are available in the details context menu when you select a reference dataset.
Add to Flow: Click to add the reference dataset to a new or existing flow.
Edit name and description: (Available to flow owner only) Change the name and description for the object.
Delete Reference Dataset: Remove the reference dataset from the flow.
![FlowView-Reference.png](../../../../../image/uuid-eb374241-4778-5f08-9104-0668c45a54a2.png)
Figure: Reference Dataset view
The following fields appear in the right panel.
Key Fields:
Used In: Indicates the number of flows where the reference appears. If this number is greater than one, click More details to review the flows. See Dataset Details Page.
More details: Review details on the flows where the dataset is used.
After you have created a reference dataset, you can use it other flows.
Options:
In the source flow, select the reference dataset, and click Add to Flow in the Details options.
See above procedures on creating a reference dataset.
From the Add -
X
to dialog, whereX
is the name of the reference object, select the required flow or click Create new flow to add the reference dataset to the flow.For more information on creating new flows, see Create Flow Page.
In a target flow, you add a reference dataset like other datasets. In Flow View, when you add a dataset, reference datasets are listed under the Reference tab. For more information, see Flow View Page.
![]() |
Figure: Reference Dataset icon in another flow
The following menu options are available when you select the plus icon next to the dataset:
Add new recipe: Add a new recipe extending from the reference dataset.
Add Join: Add a join step as the new last step to the recipe. For more information, see Join Window.
Add Union: Add a union step as the new last step to the recipe. For more information, see Union Page.
The following options are available in the details context menu when you select the reference dataset.
Add:
Recipe: Add a recipe for this dataset.
Join: Join this dataset with another recipe or dataset. If this dataset does not have a recipe for it, a new recipe object is created to store this step.
Union: Union this dataset with one or more recipes or datasets. If this dataset does not have a recipe for it, a new recipe object is created to store this step.
View in library: Review details on the flows where the dataset is used.
Go to original reference: Open the flow containing the original reference for this dataset.
Remove from Flow: Remove the reference dataset from the flow.
All dependent flows, outputs, and references are not removed from the flow. You can replace the source for these objects as needed.
Note
References to the deleted dataset in other flows remain broken until the dataset is replaced.
Tip
You can also right-click the reference dataset to view all the menu options.
![FlowView-ReferencedDataset.png](../../../../../image/uuid-726fd386-9f0a-8ecf-bb3d-ceae65000d92.png)
Figure: View for referenced dataset in a new flow
Note
Reference datasets marked with a red dot no longer have a source dataset for them in the other flow. These upstream dependencies should be fixed. See Fix Dependency Issues.
The following fields appear in the right panel.
Key Fields:
Source Flow: Flow that contains the dataset. Click the link to open the Flow View page for that dataset.