Class SetTitleTask

All Implemented Interfaces:
HasHandlers

public class SetTitleTask extends ComponentTask
Sets the title of a tab, section, window, label, button, form control or facet chart.

For a label, button, window, or chart the componentId specifies everything necessary to identify the target.

For a tab, section or form control more information is needed. The componentId identifies the container (i.e. TabSet, SectionStack or DynamicForm) and the individual component is specified as:

See Also:
  • Constructor Details

    • SetTitleTask

      public SetTitleTask()
    • SetTitleTask

      public SetTitleTask(JavaScriptObject jsObj)
  • Method Details

    • getOrCreateRef

      public static SetTitleTask getOrCreateRef(JavaScriptObject jsObj)
    • create

      public JavaScriptObject create()
      Overrides:
      create in class ComponentTask
    • setTargetFieldName

      public SetTitleTask setTargetFieldName(String targetFieldName) throws IllegalStateException
      If componentId targets a DynamicForm, this property specifies the name of the target field to assign new title.
      Parameters:
      targetFieldName - New targetFieldName value. Default value is null
      Returns:
      SetTitleTask instance, for chaining setter calls
      Throws:
      IllegalStateException - this property cannot be changed after the underlying component has been created
      See Also:
    • getTargetFieldName

      public String getTargetFieldName()
      If componentId targets a DynamicForm, this property specifies the name of the target field to assign new title.
      Returns:
      Current targetFieldName value. Default value is null
      See Also:
    • setTargetSectionName

      public SetTitleTask setTargetSectionName(String targetSectionName) throws IllegalStateException
      If componentId targets a SectionStack, this property specifies the name of the target section. Alternately, the target section can be specified by using targetSectionTitle.
      Parameters:
      targetSectionName - New targetSectionName value. Default value is null
      Returns:
      SetTitleTask instance, for chaining setter calls
      Throws:
      IllegalStateException - this property cannot be changed after the underlying component has been created
    • getTargetSectionName

      public String getTargetSectionName()
      If componentId targets a SectionStack, this property specifies the name of the target section. Alternately, the target section can be specified by using targetSectionTitle.
      Returns:
      Current targetSectionName value. Default value is null
    • setTargetSectionTitle

      public SetTitleTask setTargetSectionTitle(String targetSectionTitle) throws IllegalStateException
      If componentId targets a SectionStack, this property specifies the title of the target section. Alternately, the target section can be specified by using targetSectionName.
      Parameters:
      targetSectionTitle - New targetSectionTitle value. Default value is null
      Returns:
      SetTitleTask instance, for chaining setter calls
      Throws:
      IllegalStateException - this property cannot be changed after the underlying component has been created
    • getTargetSectionTitle

      public String getTargetSectionTitle()
      If componentId targets a SectionStack, this property specifies the title of the target section. Alternately, the target section can be specified by using targetSectionName.
      Returns:
      Current targetSectionTitle value. Default value is null
    • setTargetTabName

      public SetTitleTask setTargetTabName(String targetTabName) throws IllegalStateException
      If componentId targets a TabSet, this property specifies the name or ID of the target tab to assign new title.
      Parameters:
      targetTabName - New targetTabName value. Default value is null
      Returns:
      SetTitleTask instance, for chaining setter calls
      Throws:
      IllegalStateException - this property cannot be changed after the underlying component has been created
      See Also:
    • getTargetTabName

      public String getTargetTabName()
      If componentId targets a TabSet, this property specifies the name or ID of the target tab to assign new title.
      Returns:
      Current targetTabName value. Default value is null
      See Also:
    • setTextFormula

      public SetTitleTask setTextFormula(UserSummary textFormula) throws IllegalStateException
      Formula to be used to calculate the component title. Use title property to assign a static title instead.

      Available fields for use in the formula are the current rule context.

      Parameters:
      textFormula - New textFormula value. Default value is null
      Returns:
      SetTitleTask instance, for chaining setter calls
      Throws:
      IllegalStateException - this property cannot be changed after the underlying component has been created
    • getTextFormula

      public UserSummary getTextFormula()
      Formula to be used to calculate the component title. Use title property to assign a static title instead.

      Available fields for use in the formula are the current rule context.

      Returns:
      Current textFormula value. Default value is null
    • setTitle

      public SetTitleTask setTitle(String title) throws IllegalStateException
      Title to assign to component. To assign a dynamic value see textFormula.
      Parameters:
      title - New title value. Default value is null
      Returns:
      SetTitleTask instance, for chaining setter calls
      Throws:
      IllegalStateException - this property cannot be changed after the underlying component has been created
      See Also:
    • getTitle

      public String getTitle()
      Title to assign to component. To assign a dynamic value see textFormula.
      Returns:
      Current title value. Default value is null
      See Also: