Apply a substitution to an element

Substitutions can be applied to the following elements to replace them when the program is instantiated:
  • Directives
  • Function block diagram elements
  • Structured text chart lines
  • Sequential function chart elements
  • Rungs
    TIP:
    Rung numbers are applied sequentially and cannot be changed. If inherited substitutions have been excluded, substitutions applied to the rung will extend to directives contained by the rung.
    Ladder diagram elements include a resizing slider in the decorator pane to help view more of the large diagrams.
To apply a substitution to an element
  1. In the
    Library Objects
     pane, select the library object, then right-click the element in the parameter section of the decorator pane and select
    Substitutions
    .
    TIP:
    The
    Substitutions
     command does not respond if more than one item is selected.
  2. In the
    Substitution Builder
     window, review the substitutions listed in the
    Element Substitutions
     box to trace the origin of the current substitution, if one exists.
    TIP:
    Check
    Show existing substitutions which do NOT affect this element
     to see all current substitutions. This shows potential conflicts and unexpected replacements for new substitutions.
  3. Select a scope in the
    Scope
     field.
  4. In the
    Search for
     field, enter an initial text string to be replaced.
  5. In the
    Replace with
     field, enter a replacement string.
  6. Select a scope for the text search.
    Operand replacement
     limits the search to the tokens for operands, so it should only be selected if this is where the substitution should take place.
    Text replacement
     limits the search to text strings not in tokens.
  7. Click
    Apply
     to test the substitution. The new substitution appears in the
    Element Substitutions
     box.
  8. Click
    OK
     to exit the Substitution Builder.
  9. (optional) If supported by the element, check the
    Exclude Base Library Substitutions
     or
    Exclude Library Substitutions
     checkbox so the new substitution takes precedence.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal