Difference between revisions of "Modeler:Tutorial/Integrity Checks"
m (→Extended Rules) |
m (→SQL Based) |
||
Line 72: | Line 72: | ||
---- | ---- | ||
= | ---- | ||
== Elements must comply with mandatory custom metadata == | |||
Since the introduction of custom attributes in CaseTalk some of these attributes may be set to being mandatory. This rule check for elements in the information model which lack the presence of certain custom attributes while the active definitions require them. Note rule checks only the selected custom attribute definition set. | |||
== Totality constraint must cover all subtypes == | |||
If a supertype exists, and a TC is placed on one or more subtypes, this rule checks to see if all subtypes are under this TC or not. If any of them is marked, than they should all be marked. | |||
== Derivable subtypes must have a type declaration == | |||
Subtypes can be flagged as derivable. In order to properly derive them, the supertype usually has a binary fact type which specifies of which subtype it actually is. The rule checks for a binary fact type attached to the supertype which also is populated with the subtype names. | |||
==The population should match the totality constraints== | ==The population should match the totality constraints== | ||
If a totality constraint states the population must exist in a different fact type, the example population in the model should comply. | If a totality constraint states the population must exist in a different fact type, the example population in the model should comply. | ||
== Populations must comply with totality constraints == | |||
If a tc mandates tuple existence, the population should comply to that. More tuples are required to satisfy this rule. | |||
==Populations must comply with uniqueness constraints== | ==Populations must comply with uniqueness constraints== | ||
The example population should adhere to the uniqueness constraints applied to the corresponding roles. | The example population should adhere to the uniqueness constraints applied to the corresponding roles. | ||
== Population must comply with subset constraints == | == Population must comply with subset constraints == |
Revision as of 06:13, 9 March 2021
To make sure the model is well formed, CaseTalk can validate the model for you. It ranges from structural checks, to soft semantics and examples, to multi-model management aspects. The violations may range from error, warning to hint.
Standard FCO-IM rules
The following rules are present since the very first version of CaseTalk and are a hardcoded set of rules.
Every fact type must have an intra UC
For each fact type, there must be at least one uniqueness constraint that concerns one or more roles of this fact type only.
The N rule must be valid for every nominalized fact type
Every nominalized fact type with n roles only has exactly one uniqueness constraint over all n roles. Generalizations are an exception, therefor this is considered a warning, not an error.
The N-1 rule must be valid for every fact type
Facts are required to have one or more uniqueness constraint over N-1 roles. The uniqueness constraint should cover all roles, or all roles minus one. If a fact type with n roles has at least one uniqueness constraint on less than n-1 roles, then the fact type is splittable. The n-1 rule-test simply consists of the check that there are no UCs that are too small.
In a fact type that is a subtype, all roles have a single role uniqueness constraint. For nominalized subtypes, all object type expressions concern exactly one role.
The subtype rule must be valid for every subtype
to be done..
The alias of an object/fact type must be unique
Even though a Object/Fact Type name must be unique, and can have an alias, this rules warns users for potentially introducing alias names which correspond to other Object/Fact Type names.
All object type expressions must be used
Object types expressions generally are created during qualification of fact expressions. This rule states that the object type expressions should be verbalized as part of another object types or fact type expression.
Non-lexical object types without totality constraints must have a fact type expression
If no totality constraint at all applies to any of the roles played by a certain nominalized fact type, then that fact type must have an existence postulating fact type expression.
The actual population of every fact type must be verbalizable
Object type expressions verbalizing a population is not always sufficient to be verbalizable. Sometimes an additional fact type expression or totality constraint is required to guarantee the population really exists.
A strict equality constraint must apply on each subtype tupel
The population under a subtype must correspond to the population of the supertype. Strictly speaking this is not saying anything about a strict equality constraint, since that is not yet fully supported in CaseTalk.
Extended Rules
The following rules were added after CaseTalk was used for a while, and kept evolving to catch mistakes made by beginners and experienced modelers.
Fact types may not contain redundant role combinations
Different fact types may contain sets of roles which have a similar construction. The set of roles and their played by object types may be modeled redundant. If so, it can be resolved by combining these role sets into an object type.
The population should match the value constraint
This rule checks the population values to be within the specified value constraints of label types.
Facts must have at least one sample population
Fact types only exist by expressions and samples. Having no tuples makes validating the expression impossible. Therefor at least one sample must exist.
Roles must have distinct semantic meanings
More than one role can exist in a fact type. Of more than one role in a fact type are played by the same object type, the modeler should either place a role-fix or insert an extra object type. Transformations will fail if this is not handled. (Consider a table after transformation with two columns having the same name.)
Label types must contain a datatype definition
Label types require some data type definition. CaseTalk is able to derive that from the population using a wizard. If not set yet, these label types trigger this warning rule.
Fact types may not contain object types
Fact types with n roles, and n > 2, with a single UC covering N-1 roles, these roles under the UC may be candidate for nominalization.
Binary fact types must have grouping preference
Binary fact types where both roles are under a single uc, or both roles under their own uc, this fact type cannot be automatically grouped during transformation. Therefor to be optimized, at least one role needs a grouping preference.
All generated expressions require validated semantics
In later version of CaseTalk more model (re)factoring functions exist. This may lead to default generated expressions, which are not manually entered by an analyst. To guarantee model quality, these need to be manually verified.
Label types must be used
Label types can only exist if played by at least one role. Label types found in the model without any role played by this label type, the label type should be removed.
Elements must comply with mandatory custom metadata
Since the introduction of custom attributes in CaseTalk some of these attributes may be set to being mandatory. This rule check for elements in the information model which lack the presence of certain custom attributes while the active definitions require them. Note rule checks only the selected custom attribute definition set.
Totality constraint must cover all subtypes
If a supertype exists, and a TC is placed on one or more subtypes, this rule checks to see if all subtypes are under this TC or not. If any of them is marked, than they should all be marked.
Derivable subtypes must have a type declaration
Subtypes can be flagged as derivable. In order to properly derive them, the supertype usually has a binary fact type which specifies of which subtype it actually is. The rule checks for a binary fact type attached to the supertype which also is populated with the subtype names.
The population should match the totality constraints
If a totality constraint states the population must exist in a different fact type, the example population in the model should comply.
Populations must comply with totality constraints
If a tc mandates tuple existence, the population should comply to that. More tuples are required to satisfy this rule.
Populations must comply with uniqueness constraints
The example population should adhere to the uniqueness constraints applied to the corresponding roles.
Population must comply with subset constraints
Subset constraints mandate existence of a population in another fact type. Therefor this rule checks if that is the case within the model and the example population.
Population must comply with datatype
Population values are set to be of a specific data type as specified in the corresponding label type. The values are parsed by CaseTalk to validate they meet the datatype requirements.
External expressions must be supported
It is possible to merge fact expressions from another model file (aka namespace) into another. The expressions are flagged as originating from a different namespace. CaseTalk allows architects to specify which namespaces can be used and which not. This rule simple checks for expressions which were not yet marked as valid merged namespace.
External namespace must cover one version
In elaborate editions of CaseTalk various namespaces and versions of them are allowed to be merged into other models. It should however never occur to merge expressions from two distinct versions of the same namespace.
Value constraints must comply with datatype
The population contains values and value constraints limits the range of these values. Therefor the limits specified must comply to these datatype themselves.
Expression requires soft semantics
Expressions consist of roles and expression parts. If all expression parts in an expression are empty, this warning states the lack of so called soft semantics.
Data Type cannot be default
In the new Data Type administration dialog, all data types must be registered as either a native type, or one of the implementation types. Otherwise CaseTalk will not know how to handle it when generating artifacts.
Facts require proper verbalizations
Fact types can be created using the new refactoring methods in CaseTalk. This will generate expressions which are not confirmed yet. Verbalizations also require example population. If both rules are violated, and error on the fact type is raised.
Custom SQL
Users are now able to build their own additional set of rules using SQL.
There may be more validation rules active within to your environment. These may have been added by customizations. See also: Customization through own rules in SQL