Class: SCIMMY.Types.Attribute

Class: SCIMMY .Types.Attribute

SCIM Attribute Type

Summary:

Defines a SCIM schema attribute, and is used to ensure a given resource's value conforms to the attribute definition.

Usage

Constructs an instance of a full SCIM attribute definition

                    
                        new SCIMMY.Types.Attribute(type, name, configopt, subAttributesopt)

Source:: src/lib/types/attribute.js, line 311

Parameters:

Name	Type	Description
`type`	`~ValidAttributeTypes`	the data type of the attribute
`name`	`String`	the actual name of the attribute
`configopt`	`~AttributeConfig`	additional config defining the attribute's characteristics
`subAttributesopt`	`SCIMMY.Types.Attribute[]`	if the attribute is complex, the sub-attributes of the attribute

Properties:

Name	Type	Description
`type`	`~ValidAttributeTypes`	the data type of the attribute
`name`	`String`	the actual name of the attribute
`config`	`~AttributeConfig`	additional config defining the attribute's characteristics
`subAttributesopt`	`SCIMMY.Types.Attribute[]`	if the attribute is complex, the sub-attributes of the attribute

Methods

truncate(subAttributes) → {SCIMMY.Types.Attribute}

Remove a subAttribute from a complex attribute definition

Source:: src/lib/types/attribute.js, line 374

Parameters:

Name	Type	Description
`subAttributes`	`StringSCIMMY.Types.Attribute`	the child attributes to remove from the complex attribute definition

Returns:

this attribute instance for chaining

Type:

{SCIMMY.Types.Attribute}

toJSON() → {~AttributeDefinition}

Parse this Attribute instance into a valid SCIM attribute definition object

Source:: src/lib/types/attribute.js, line 395

Returns:

an object representing a valid SCIM attribute definition

Type:

{~AttributeDefinition}

coerce(source, directionopt, isComplexMultiValueopt) → {String|String[]|Number|Boolean|Object|Object[]}

Coerce a given value by making sure it conforms to attribute's characteristics

Source:: src/lib/types/attribute.js, line 437

Parameters:

Name	Type	Default	Description
`source`	`anyany[]`		value to coerce and confirm conformity with attribute's characteristics
`directionopt`	`String`	`"both"`	whether to check for inbound, outbound, or bidirectional attributes
`isComplexMultiValueopt`	`Boolean`	`false`	indicates whether a coercion is for a single complex value in a collection of complex values

Returns:

the coerced value, conforming to attribute's characteristics

Type:

{String|String[]|Number|Boolean|Object|Object[]}

Type Definitions

AttributeConfig

SCIMMY Attribute Instance Configuration properties

Type:: {Object}
Source:: src/lib/types/attribute.js, line 7

Properties:

Name	Type	Default	Description
`multiValuedopt`	`Boolean`	`false`	does the attribute expect a collection of values
`descriptionopt`	`String`	`""`	a human-readable description of the attribute
`requiredopt`	`Boolean`	`false`	whether the attribute is required for the type instance to be valid
`canonicalValuesopt`	`BooleanString[]`	`false`	values the attribute's contents must be set to
`caseExactopt`	`Boolean`	`false`	whether the attribute's contents is case-sensitive
`mutableopt`	`BooleanString`	`true`	whether the attribute's contents is modifiable
`returnedopt`	`BooleanString`	`true`	whether the attribute is returned in a response
`referenceTypesopt`	`BooleanString[]`	`false`	list of referenced types if attribute type is reference
`uniquenessopt`	`StringBoolean`	`"none"`	the attribute's uniqueness characteristic
`directionopt`	`String`	`"both"`	whether the attribute should be present for inbound, outbound, or bidirectional requests
`shadowopt`	`Boolean`	`false`	whether the attribute should be hidden from schemas presented by the resource type endpoint

AttributeDefinition

SCIM Attribute Definition properties

Type:: {Object}
Source:: src/lib/types/attribute.js, line 396

Properties:

Name	Type	Description
`name`	`String`	the attribute's name
`type`	`~ValidAttributeTypes`	the attribute's data type
`referenceTypesopt`	`String[]`	specifies a SCIM resourceType that a reference attribute may refer to
`multiValued`	`Boolean`	boolean value indicating an attribute's plurality
`description`	`String`	a human-readable description of the attribute
`required`	`Boolean`	boolean value indicating whether the attribute is required
`subAttributesopt`	`~AttributeDefinition[]`	defines the sub-attributes of a complex attribute
`caseExactopt`	`Boolean`	boolean value indicating whether a string attribute is case-sensitive
`canonicalValuesopt`	`String[]`	collection of canonical values
`mutability`	`String`	indicates whether an attribute is modifiable
`returned`	`String`	indicates when an attribute is returned in a response
`uniquenessopt`	`String`	indicates how unique a value must be

Constants

(inner) ValidAttributeTypes

Collection of valid attribute type characteristic's values

Values:: ["string","complex","boolean","binary","decimal","integer","dateTime","reference"]
Source:: src/lib/types/attribute.js, line 98

(inner) ValidMutabilityValues

Collection of valid attribute mutability characteristic's values

Values:: ["readOnly","readWrite","immutable","writeOnly"]
Source:: src/lib/types/attribute.js, line 105

(inner) ValidReturnedValues

Collection of valid attribute returned characteristic's values

Values:: ["always","never","default","request"]
Source:: src/lib/types/attribute.js, line 112

(inner) ValidUniquenessValues

Collection of valid attribute uniqueness characteristic's values

Values:: ["none","server","global"]
Source:: src/lib/types/attribute.js, line 119