Chapter 6 Working With Concepts : Concept Resource Reference

Concept Resource Reference
Concept resources are descriptive entities similar to the object-oriented concept of a class. They describe a set of properties. For example, one concept might be Department, and it could include department name, manager, and employee properties.
Configuration
The Configuration tab has the following fields.
The name to appear as the label for the resource. Names follow Java variable naming restrictions. Do not use any reserved words. Names must be unique within a folder. See Identifiers (Names) in TIBCO BusinessEvents Language Reference.
If you want this concept to inherit all the properties of another concept, browse to and select that concept.
Concepts that are related to each other directly or indirectly by inheritance cannot have distinct properties that share a common name. Therefore the following restrictions apply:
If two concepts are related by inheritance, you cannot create a new property in one with a name that is already used in the other.
If two unrelated concepts have properties that share a name, an inheritance relationship cannot exist between them.
Icon Reference
You can associate an image file with a concept type. Add the image as a shared resource. Then browse to and select it here.
Properties
The Properties tab has the following fields:
String, Integer, Long, Double, Boolean, DateTime, ContainedConcept, ConceptReference
When you create a property of type ContainedConcept, you are creating a containment relationship. The concept that you are currently configuring is the container; the concept you specify as a property is the contained concept.
When you create a property of type ConceptReference you are creating a property that references another concept.
Note: For properties of type Double, when a backing store is used, all NaN (Not a Number) values are converted to 0.00.
Consider, for example, an Order concept: In most cases, an Order concept would allow only one value for the customer property but multiple values for the line_item property. Selecting the Multiple checkbox creates a property array.
Changes Only BusinessEvents records the value of the property every time it changes to a new value.
All Values BusinessEvents records the value of the property every time an action sets the value even if the new value is the same as the old value.
Zero (0): BusinessEvents does not store historical values for the concept. It stores the value without a time and date stamp
One or more (>0): BusinessEvents stores the property value when the property changes, along with a date and time stamp, up to the number specified. When the maximum history size is reached, the oldest values are discarded as new values are recorded. See Understanding Concept Property History.
Note: Use of a temporal function with a concept that has a history size of 0 may cause a runtime exception.
Extended Properties
The extended properties tab is for use with database concepts. See Chapter 7, Working With Database Concepts for details. Except for that use, the Extended Properties tab is used internally in this release and is reserved for future use.