valid-enum-field-name-conventions
Overview
This rule belongs to the apimatic-codegen-validation ruleset and states that:
Names assigned to fields of an enumeration model must not contain special characters.
| Property | Value |
|---|---|
| Enabled | Yes |
| Maximum Severity | Error |
| Message | Name of enumeration field contains special characters which are not allowed. |
| Code | APIMATICCODEGEN_V132 |
| Type | Validation |
| Rule System | Semantic |
| Broad Category | Global Types/Models |
| Products Impacted | Code Generation, Developer Experience Portal |
| Tags | apimatic code generation codegen sdks portal docs validation apimatic name enumeration type model custom type complex model |
Suggested Fixes
- Enumeration field names are used in creating language specific models in the CodeGen engine and usage of special characters can cause issues in this code generation process.
- Treat enumeration field names different from the default values. Use only default values for placing the actual enumeration value and use the name property to provide a user-friendly and code-friendly name for the enumeration field.
- Remove all special characters from the enumeration field name to avoid this issue.