required-global-representation-id-attribute

Overview

This rule belongs to the wadl-validation ruleset and states that:

When a <representation> element is defined directly as a child of the root <application> element, it must also specify a non-empty id for it using the id attribute. This id will help uniquely identify the representation in the document and help other components refer it using a URI reference.

Property	Value
Enabled	Yes
Maximum Severity	Error
Message	Globally defined <representation> element has a missing id.
Code	WADL_V500
Type	Validation
Rule System	Semantic
Broad Category	Representations
Products Impacted	API Transformer, Code Generation, Developer Experience Portal
Tags	wadl api semantic validation id representation global

Suggested Fixes

• Ensure that the <representation> element (which is nested directly under the root <application> element) contains the id attribute.
• Ensure that the value of the id attribute is not empty.

For More Information

• https://www.w3.org/Submission/wadl/#x3-230002.11.2
• https://www.w3.org/Submission/wadl/#x3-210002.11
• https://www.w3.org/Submission/wadl/#x3-70002.2
• https://www.w3.org/Submission/wadl/
• https://docs.apimatic.io/rulesets/overview/