...
Panel | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
Requirement
|
...
This requirement imposes the need to describe provide a brief narrative summary of the scope of the information covered by the information definition. It requires a brief narrative summary. It is clear that the requirement is not looking for “War and Peace”. This is generally implemented as free text in any implementationThis may include an explicit statement about what is not in the scope of the information definition.
The specification caters for the fact that information definitions are often contained in service descriptions. The scope information can, in effect, be inherited from the document containing the information definition. This will avoid unnecessary duplication.
Verification Support
Completeness
...
Check that:
- The information definition (or its containing service description) has a textual description of the scope of the information covered by the information definition.
- The scope clearly delineates what is covered and what is not.
...
- by the information definition.
Examples
The example below shows how the scope information can be embedded into an XML schema. It makes use the annotation element within the XML schema definition language.
A complete example is available at: complete example.
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<xs:annotation> <xs:appinfo>Information Definition</xs:appinfo> <xs:documentation> <generalInformation> <scope>a really quite intriguing and self-referential schema</scope> </generalInformation> </xs:documentation> </xs:annotation> |
...