Class: IllustrationStepHandle
A StepHandle allows for managing the state of a specific step in a workflow. This class abstracts away the complexities of dealing with a step directly and allows for using high level concepts instead of dealing with the underlying data structures.
Extends
Constructors
Constructor
new IllustrationStepHandle(
manager,step,tags):IllustrationStepHandle
Parameters
manager
step
tags
string[]
Returns
IllustrationStepHandle
Overrides
Methods
executeAnimations()
executeAnimations(
immediate?):void
Fires any configured animations on the 3D preview for this step. This includes camera & model animations. If the preview is unavailable this function will do nothing.
Parameters
immediate?
boolean
Returns
void
Inherited from
getAllVariants()
getAllVariants():
Promise<Variant[]>
Returns
Promise<Variant[]>
A list of all variants for this step, including disabled ones.
Inherited from
getAvailableColors()
getAvailableColors():
Promise<object[] |undefined>
Returns
Promise<object[] | undefined>
getAvailableVariants()
getAvailableVariants():
Promise<Variant[]>
Returns
Promise<Variant[]>
A list of valid variants for this step. Does not include disabled variants.
Inherited from
StepHandle.getAvailableVariants
getColorOption()
getColorOption():
Promise<OptionResource|undefined>
Returns
Promise<OptionResource | undefined>
getColorPickerDisplayType()
getColorPickerDisplayType():
ColorPickerDisplayType|undefined
Returns
ColorPickerDisplayType | undefined
getColors()
getColors(): {[
key:string]:ColorDefinition; } |undefined
Get the colors that are in the illustration.
Returns
{[key: string]: ColorDefinition; } | undefined
A list of color definitions that are currently applied to the illustration.
getCurrentVariant()
getCurrentVariant():
Variant|undefined
Gets the currently selected variant, or undefined if no variant is selected.
Returns
Variant | undefined
Inherited from
getGlobalPropertyAspects()
getGlobalPropertyAspects(
configurationId):string[]
Retrieves the identifiers of all of the configured aspects for the specified Global Property Configuration.
Parameters
configurationId
string
The ID of the Global Property Configuration. You can usually find this with bundle.getGlobalPropertyConfiguration()?.id
Returns
string[]
An array of strings matching the keys of all the Global Property Aspects in the Configuration that this step is configured to use.
Inherited from
StepHandle.getGlobalPropertyAspects
getHelpText()
getHelpText():
string|undefined
Returns
string | undefined
A message that can accompany the step name in UI components. Used to describe the purpose of the step in more detail.
Inherited from
getId()
getId():
string
Returns
string
A unique identifier for this step within the workflow.
Inherited from
getMandatory()
getMandatory():
boolean
Returns
boolean
True if the step is required to be filled by the customer. False otherwise.
Inherited from
getName()
getName():
string
Returns
string
The name of the step
Inherited from
getOverrideGlobalPropertyConfiguration()
getOverrideGlobalPropertyConfiguration(
type):boolean
Parameters
type
The AspectType to fetch the value for.
Returns
boolean
A boolean indicating whether this step should override Global Properties. Only relevant when the Workflow Experience is associated with a Bundle that is using Global Properties, and when this step is associated with one or more Global Property Aspects.
Inherited from
StepHandle.getOverrideGlobalPropertyConfiguration
getRaw()
getRaw():
Step<IllustrationStepData>
Returns
The underlying data for this step. Favor using the step handle methods instead of this.
Inherited from
getTags()
getTags():
string[]
Returns
string[]
Returns all of the tags that are present on this step.
Inherited from
getType()
getType():
StepType
Returns
The type of the step handle.
Inherited from
hasTag()
hasTag(
tag):boolean
Parameters
tag
string
The tag to check for.
Returns
boolean
True if the step has the specified tag, false otherwise.
Inherited from
isColorPickerEnabled()
isColorPickerEnabled():
boolean
Returns
boolean
isPMSPickerEnabled()
isPMSPickerEnabled():
boolean
Returns
boolean
isVariantCategoriesEnabled()
isVariantCategoriesEnabled():
boolean
Returns
boolean
isVariantSearchEnabled()
isVariantSearchEnabled():
boolean
Returns
boolean
selectVariant()
selectVariant(
variant):Promise<void>
Allows for select a vector from the available vectors configured on this steps base option.
Parameters
variant
The new vector variant to use for this step.
Returns
Promise<void>
A promise that can be awaited to know when the new vector asset has been updated on the design.
Overrides
setColor()
setColor(
key,value,pmsValue?):Promise<void>
Set color for the illustration.
Parameters
key
string
value
string
pmsValue?
string
Returns
Promise<void>
setOverrideGlobalPropertyConfiguration()
setOverrideGlobalPropertyConfiguration(
type,value):void
Sets whether or not this step should override Global Properties. Only relevant when the Workflow Experience is associated with a Bundle that is using Global Properties, and when this step is associated with one or more Global Property Aspects.
Parameters
type
The AspectType to override.
value
boolean
Returns
void