diff --git a/docs/started-hello.md b/docs/started-hello.md index 53e2ce4d..5c5e3a6a 100644 --- a/docs/started-hello.md +++ b/docs/started-hello.md @@ -201,6 +201,33 @@ Then run `cicero trigger --template helloworld@0.14.0.cta --sample sample.md --r ``` 13:47:35 - ERROR: Instance org.accordproject.helloworld.MyRequest#null missing required field input ``` +## Common Errors + +### Invalid or Missing Identifier + +This occurs when your model defines an identifier field but it is not included in `data.json`. +Ensure all required fields defined in `model.cto` are provided in your JSON data file. + +### Missing `data.json` + +The `cicero draft` command requires a JSON data file. +If your data file has a different name, specify it using: + +```bash +cicero draft --data your-file.json +``` + +### Namespace Mismatch + +Ensure the `$class` value in your JSON matches the namespace and asset defined in `model.cto`. + +Example: + +```json +{ + "$class": "org.accordproject.template.MyClause" +} +``` ## What Next?