Explanation of the error
You may come across this Salesforce validation error when deploying WaveRecipe metadata to your target org - "A Recipe must specify a Dataflow".
An example of the error message below:
This error is likely to be because you've not included in your deployment package a WaveDataflow component that is referenced within the WaveRecipe metadata.
Resolution
This is a known issue to Salesforce, and they have documentation available with explanation of the error and steps to resolve it.
To make sure your validation doesn't fail, on below example we're seeing both WaveRecipe metadata component (highlighted in blue) that requires its corresponding WaveDataflow component (highlighted in red) for a successful deployment.
This means that both of these components need to be added to the deployment package.
This guidance is in line with Salesforce's explanation confirming that:
"since every recipe has its own dataflow, including the dataflow alongside the recipe is needed to properly deploy recipes via change sets or packages.".
What to do if you're seeing this error when running your comparison in the upgraded version of Compare and deploy?
In the unlikely event that it happens, however this specific issue was already addressed by Gearset and fix was released in our app on 16th May 2024.
If it happens that Gearset doesn't retrieve the WaveDataflow component for your WaveRecipe metadata when using our upgraded version of the comparison, please try to run the comparison in Compare now (legacy) version to confirm if the behaviour is the same.
If the behaviour you observe is the Compare now (legacy) happens to be different, we'd like you to get in touch with our via the in-app chat and let us know about it.
Disclaimer: This error is returned directly by Salesforce, rather than Gearset. Even so, we offer guidance based on our combined experience with the Metadata API. Where possible, we try to help guide you to fix or avoid this error. In the case that this isn't possible, we may need to direct you to Salesforce support for further clarification.