Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

IRefinementTypeProto

pentaho.type.spec.IRefinementTypeProto

The spec.IRefinementTypeProto interface represents the specification of a refinement type.

Source: doc-js/pentaho/type/spec/IRefinementTypeProto.jsdoc, line 17

Extends

Members

Name Description
alias : nonEmptyString

The alias for the identifier of this type.

application : object

The application property of the type.

base : pentaho.type.spec.UTypeReference

A reference to the type's base type, if any.

category : nonEmptyString | any

The category associated with the type.

defaultView : string | function

The default view for instances of the type.

description : nonEmptyString | any

The description of the type.

facets : Array.<string, >

The refinement facet identifiers or classes.

helpUrl : nonEmptyString | any

An URL pointing to documentation associated with the type.

id : string

The identifier of the type's AMD module, a temporary identifier, or null.

instance : pentaho.type.spec.IValueProto

The extensible/configurable members of the prototype of value instance classes.

isAbstract : boolean | any

Indicates if the type is abstract.

isAdvanced : boolean | any

Indicates if the type should be exposed only to advanced users in a user interface.

isBrowsable : boolean | any

Indicates if the type should be exposed to users in a user interface.

label : nonEmptyString | any

The label of the type.

of : pentaho.type.Element.Type | pentaho.type.List.Type

The representation type refined by this refinement type.

ordinal : number | any

The ordinal associated with the type.

sourceId : string

The identifier of the value type's source AMD module, or null.

styleClass : nonEmptyString | any

The CSS class associated with the type.

Methods

Name Description
validateInstance(value) : Array.<!pentaho.type.ValidationError>

Determines if a value of the type is valid.

Members Details

alias: nonEmptyString

The alias for the identifier of this type.

The alias of a type can only be specified when extending the ancestor type.

This attribute is not inherited.

When unspecified, defaults to null.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 84

Inherited From: pentaho.type.spec.ITypeProto#alias

See also:  pentaho.type.spec.ITypeProto#id

application: object

The application property of the type.

The application property serves as a bag of properties specific to the container application, that can be modified via the Configuration Service.

Nully values will be ignored by the application property.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 131

Inherited From: pentaho.type.spec.ITypeProto#application

See also:  pentaho.type.Type#application

base: pentaho.type.spec.UTypeReference

A reference to the type's base type, if any.

When the specification is used in the context of property, it defaults to "property". Otherwise, when absent or undefined, it defaults to "complex".

See a subtype's documentation for more information on default values.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 24

Inherited From: pentaho.type.spec.ITypeProto#base

category: nonEmptyString | any

The category associated with the type.

The category is used primarily to group similar types (or instances of) in a user interface.

When non-Nully and not a string, it is taken instead to be the result of calling its toString method.

When undefined, the category is inherited from the base type.

When an empty string or null, the category is forced to be null, ignoring any inherited value.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 163

Inherited From: pentaho.type.spec.ITypeProto#category

See also:  pentaho.type.spec.ITypeProto#isBrowsable , pentaho.type.spec.ITypeProto#ordinal

defaultView: string | function

The default view for instances of the type.

When a string, it is the identifier of the view's AMD module. If the identifier is relative, it is relative to sourceId.

When undefined, the view is inherited from the base type, if any. The root view is null.

When falsy (like if null or an empty string), the value is forced to be null, ignoring any inherited value.

When a function, it is the class or factory of the view.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 267

Inherited From: pentaho.type.spec.ITypeProto#defaultView

description: nonEmptyString | any

The description of the type.

When non-Nully and not a string, it is taken instead to be the result of calling its toString method.

When undefined, the description is inherited from the base type.

When an empty string or null, the description is forced to be null, ignoring any inherited value.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 145

Inherited From: pentaho.type.spec.ITypeProto#description

facets: Array.<string, >

The refinement facet identifiers or classes.

The specified facet identifiers are added to the refinement type, adding to any already present.

The attributes defined by the added refinement facets become available for extension/configuration on the refinement type.

Source: doc-js/pentaho/type/spec/IRefinementTypeProto.jsdoc, line 25

See also:  pentaho.type.Refinement.Type#facets

helpUrl: nonEmptyString | any

An URL pointing to documentation associated with the type.

When non-Nully and not a string, it is taken instead to be the result of calling its toString method.

When undefined, the help url is inherited from the base type.

When an empty string or null, the help url is forced to be null, ignoring any inherited value.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 185

Inherited From: pentaho.type.spec.ITypeProto#helpUrl

id: string

The identifier of the type's AMD module, a temporary identifier, or null.

An empty string or undefined value is interpreted as null.

For serialization purposes, a temporary identifier can be assigned to an anonymous type. An identifier is temporary if it starts with idTemporaryPrefix.

Temporary identifiers are ignored upon type construction.

When unspecified or null, it defaults to sourceId.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 63

Inherited From: pentaho.type.spec.ITypeProto#id

See also:  pentaho.type.SpecificationContext.isIdTemporary

instance: pentaho.type.spec.IValueProto

The extensible/configurable members of the prototype of value instance classes.

Source: doc-js/pentaho/type/spec/IValueTypeProto.jsdoc, line 25

Inherited From: pentaho.type.spec.IValueTypeProto#instance

See also:  pentaho.type.spec.IValueProto#type

isAbstract: boolean | any

Indicates if the type is abstract.

An abstract type cannot be used directly to create an instance and, as such, it is not usually exposed to users in a user interface.

When not a boolean, it is taken instead to be the result of passing it to the Boolean function.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 37

Inherited From: pentaho.type.spec.ITypeProto#isAbstract

Default Value: false

See also:  pentaho.type.spec.ITypeProto#isBrowsable

isAdvanced: boolean | any

Indicates if the type should be exposed only to advanced users in a user interface.

When non-Nully and not a boolean, it is taken instead to be the result of passing it to the Boolean function.

When Nully, the attribute value is inherited from the base type, if any. The root value is false.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 218

Inherited From: pentaho.type.spec.ITypeProto#isAdvanced

isBrowsable: boolean | any

Indicates if the type should be exposed to users in a user interface.

When non-Nully and not a boolean, it is taken instead to be the result of passing it to the Boolean function.

When Nully, the attribute value is inherited from the base type, if any. The root value is true.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 203

Inherited From: pentaho.type.spec.ITypeProto#isBrowsable

label: nonEmptyString | any

The label of the type.

When non-Nully and not a string, it is taken instead to be the result of calling its toString method.

When an empty string or Nully, the label is inherited from the base type.

The initial value of this attribute, on the top-root type, is "instance".

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 115

Inherited From: pentaho.type.spec.ITypeProto#label

of: pentaho.type.Element.Type | pentaho.type.List.Type

The representation type refined by this refinement type.

Must and can only be specified at a top-refinement type, upon definition.

Source: doc-js/pentaho/type/spec/IRefinementTypeProto.jsdoc, line 41

See also:  pentaho.type.Refinement.Type#of

ordinal: number | any

The ordinal associated with the type.

The ordinal is used to disambiguate the order with which a type (or an instance of it) is shown in a user interface.

When Nully, the ordinal is inherited from the base type, if any. The root value is 0.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 250

Inherited From: pentaho.type.spec.ITypeProto#ordinal

See also:  pentaho.type.spec.ITypeProto#isBrowsable , pentaho.type.spec.ITypeProto#category

sourceId: string

The identifier of the value type's source AMD module, or null.

An empty string or undefined value is interpreted as null.

When unspecified or null, it defaults to id.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 101

Inherited From: pentaho.type.spec.ITypeProto#sourceId

See also:  pentaho.type.SpecificationContext.isIdTemporary

styleClass: nonEmptyString | any

The CSS class associated with the type.

This attribute is typically used to associate an icon with a type.

When null or an empty string, the attribute value is set to null.

When unspecified, or undefined, the attribute value defaults to the type's id, in snake-case, if it has one; or, null, if not.

Source: doc-js/pentaho/type/spec/ITypeProto.jsdoc, line 233

Inherited From: pentaho.type.spec.ITypeProto#styleClass

Methods Details

validateInstance(value) : Array.<!pentaho.type.ValidationError>

Determines if a value of the type is valid.

Although not limited to, this method is used mostly for refinement types, to perform additional validations on values, besides that which is performed by their type's instance-side validate method.

If you override this method, be sure to call the base implementation, and return any errors it reports.

Source: doc-js/pentaho/type/spec/IValueTypeProto.jsdoc, line 35

Inherited From: pentaho.type.spec.IValueTypeProto#validateInstance

Parameters:
Name Default Value Summary
value : pentaho.type.Value

The value to validate.

Returns:
Name Description
Array.<!pentaho.type.ValidationError> | null

A non-empty array of errors or null.

See also:  pentaho.type.Value.Type#validateInstance