Support Center

Rule Engine

Last Updated: Oct 26, 2016 08:01AM PDT

Build

Rule Engine


The Rule Engine allows you to specify when WalkMe takes certain actions making WalkMe much more powerful, contextual and effective. The Rule Engine is built into many WalkMe features, allowing you to create logic statements that initiate actions or enable features only when a Rule is evaluated as true.
 
 

Article Contents

  • Use cases
  • Learn how the Rule Engine works
  • Statement Structure
  • Selecting Rule Types
  • Selecting Rule Operators
  • Creating Rule Input
  • Using Multiple Statements
  • How Rules are Checked
  • Grouping Statements
  • Optimizing Rule Performance
  • Try It Out
 

Let's Talk A Bit More

The Rule Engine is an integral part of WalkMe and using it unlocks its true power by providing contextual training and support. Using the Rule Engine, you can create complex statements that must be true in order for WalkMe to activate specific features.

Use the Rule Engine to determine if features, such as Super Steps, Segments, Goals and Step Play Rules are activated within the WalkMe Player. Each statement created with the Rule Engine has many Types of criteria to check, such as elements on screen, the URL, the date and time or even variables from your software.

For example, you may want to only show WalkMe to the Sales department at your company. Using the Segmentation Center, you can target that user group using the Rule Engine. A rule can check if a user is part of the Sales team by looking at a variable that your software allows WalkMe to see. Defining a Segment with a Rule allows WalkMe to determine if a Salesperson is using your software so they see only the WalkMe Items you add to their Segment.

Use the Rule Engine to:
  • Create a Walk-Thru step that only appears if the user gets an error message on a form using a Step Play Rule
  • Specify when WalkMe will jump ahead in a Walk-Thru by adding a Rule to a Jump to Step
  • Create a ShoutOut that only will AutoPlay during a certain time frame Create a custom rule to determine if input is valid for a Validation SmartTip

Deep Dive

How It Works
The Rule Engine is central to many features in the WalkMe Editor and using it allows you to specify that IF something is true THEN an action takes place or a feature is activated.

We learn to use Rules at a young age. When playing a boardgame we might learn that IF you land on a certain spot on the board THEN you get to jump ahead a few spaces. This basic form of logic can be applied to understand how the Rule Engine works. For example, IF a user starts on a specific URL, THEN you might want to jump ahead 3 steps in your Walk-Thru. This action is taken only IF the criteria we specify is true though, meaning they are on the specified URL.

When using the Rule Engine, you create individual statements (similar to sentences) that WalkMe checks to decide if a feature should be activated. Each statement is evaluated by the Rule Engine as either being True or False, just like a logic statement. WalkMe checks these statements starting with the top statement and moves down the list to each subsequent one. Together these statements determine if the rule itself is true. If a rule is true, the selected feature is activated. If a rule is false then the feature is not activated.

The Rule Engine checks the browser window you have open to evaluate each statement, so you must be on the correct page or be logged in as a certain type of user to check if a rule is actually evaluating as true or false. A statement created to check if a user clicks or hovers over an element cannot be evaluated while you have the rule engine open because it’s not possible to click or hover over those elements while the rule engine is open.

Creating A Rule
Statement Structure
Each statement is created by first selecting a Type of criteria to check, such as URL or On Screen Element. Once a Type is selected, define it further using operators and other text input.


Selecting Rule Types
Rule Types are all the different criteria you can check with a statement. Selecting a Rule Type will then allow you specify it using additional menus, operators, and input.
NOTE: Some Rule Types are only available for specific features.


 
Rule Types Descriptions
On Screen Element Checks an element you select on screen for visibility, content, length, or type
URL Check either the current URL or referrer URL (the URL from which the user navigated prior to this step)
User Data Checks cookies in the user’s browser, JavaScript variables, or WalkMe Data
Browser Type Checks the current browser type or window size
Date Checks date such as day of the week, month, or specific date
Time Checks specific time of day on the end user's browser
jQuery Element Checks an element as identified by a jQuery selector. jQuery elements are used when the element is difficult to identify or to optimize performance.
User Activity Checks whether Goals for Onboarding Tasks have been achieved.
WalkMe Language Checks the selected language of WalkMe, such as English, French, Spanish etc. (Note: only when Multi-Language is enabled)
Current Flow Checks if an iframe, frameset or popup window appears

On Screen Element Options
When On Screen Element is selected as a Rule Type, three menu options appear allowing you to refine, change, or view the element you have selected.
  • Re-select Element - Change the element for your Rule
  • Gear - Modify the precision settings for the element. Read more about Precision
  • View Element - See a screenshot of the selected element

Selecting Operators
Operators set specific criteria for your selected Rule Type. Following is a complete list of all Operators.

Note: Only specific operators appear for each Rule Type:
 
Category Operator Description
Visibility Is/Is Not Visible: Checks if the element is visible on screen
Exists/Does Not Exist Checks if the element is or isn't in the html code (regardless of its visibility)
True/False Tests if jQuery element is found in the page code
Element Count Checks the number of times a jQuery element is identified in the page code
Content Text is/Is Not Checks the text for a selected element
Text Is Like/Is Not like Checks if a selected element contains specific text with the option to use wildcards. Like/Not Like allows the use of *, also known as a wildcard. Wildcard characters are used to substitute for any other character or characters in a string.

Not using a Wildcard before or after your specified input, designates that there is not text either before or after it.
Contains/Does Not Contain Checks if selected element contains specific text or numbers. Ignores any text before or after the input specified. Types include UR, User Data, On Screen Element
Is/Is Not Checks for an exact match for numbers and text elements.
Text is Empty/Not Empty Checks if a field is empty or has input in it.
Was Reached/Was Not Reached Checks whether Onboarding Tasks and Goals have been reached
Value is Greater Than/Less Than Checks if number is greater or lesser than the input value. Applicable for Types that may include numbers
Length
Length is Equal To/Less Than/Greater Than Checks the number of characters in a field and compares it to your number value
Word count is Equal To/Less Than/Greater Than Checks the number of words used in a field and compares it to your number value
Type Valid/Invalid Number Checks if a number has been inputted
Valid/Invalid Date Checks if a date has been inputted
Valid/Invalid Time Checks if time has been inputted
Valid/Invalid US Phone Number Checks if a US phone number is inputted
Valid/Invalid Email Address Checks if an email address is inputted
Is Selected/Is Not Selected Checks if the element is or is not selected. Is Selected/Is Not Selected is used for radio buttons or checkboxes

Creating Rule Input
Some Rule Types require that you add text to complete a statement. For example using the URL Type requires you to add part of the URL. Some input must be case-sensitive, such as jQuery Element, while other input like URL is not. WalkMe can autofill input for certain Rule Types using the magnifying glass, AKA Current Value Filler. For example, when using the URL rule type use the Current Value Filler to autofill the field with you current URL.

Sometimes the text input may be quite long and you can’t see all of the entry in the Rule. Simply click into the text field to expand and see full text.

Using Multiple Statements:
When creating a Rule you may add multiple statements by clicking the Add button. Using multiple statements allows you to be more specific with your rule.

Use the AND or OR toggle specify if both statements must be true for a Rule to be true or if only 1 of them must be true.


When Using AND between statements, both statements are checked and must be true. When using OR between statements, either of the rules must be true.


For example, when checking for a Goal we often use multiple statements for a Rule. The first statement checks if the user is on the correct URL AND the second statement checks if the user clicks the submit button. Both statements must be true for the Rule to be true and the Goal to be tallied so we connect this with AND. This allows us to be more specific by verifying that the user didn’t click the submit button on another page.

You can also drag and drop Rules into different order (you will have to first unlink Rules if grouped). Simply hover over the left hand side of the rule, click and move into the desired order. Make sure to re-check your Rules for accuracy.

Enabled Feature: Add Regular Expression as Condition
Regular Expressions can be enabled by your CSM to use with Rule Types jQuery and On Screen Element. Regular Expressions (RegEx) allow you to create and use advanced patterns and have full validation flexibility for an input field’s value. Check out the RegEx tester to see what you can do. If you are interested in this feature, contact your CSM or support@walkme.com

Importing Rules
Importing Rules allows you to easily search between different Apps and choose a Rule you’ve created for Segmentation, Goals and for Step Play Rules. WalkMe lists rules created for Super Steps as Step Play Rules.

To import rules, click Import Rules, select an App, Then select the item from which you would like to copy the rule.


Optimizing Rule Performance
Certain Rule Types are faster for WalkMe to check than others and we generally recommend that you use these Types whenever possible. We also recommend that you use Types that are easy to check for your first statement in a Rule. For example, using URL is faster for WalkMe to check than On Screen Element because WalkMe must quickly scan the page to try and identify your selected element, so we first use a statement that checks the URL and then add a second statement that checks for an on screen element.

The performance difference between Types is generally very small (microseconds), but these can add up when combined with your own sites performance.

The following Rule Types are listed in descending order, from the fastest that WalkMe can check to the slowest.
  1. URL /User Data
  2. jQuery Element
  3. On screen element [clicked or hovered]
  4. On screen element [visible/exists/Text is, etc]

How Rules Are Checked
WalkMe checks each of statement in order from top to bottom to determine if the specified action or feature should be enabled. If WalkMe can determine if a rule is true or false by only checking the first statement, it will stop checking the rest of the rule.


To the right of each statement, WalkMe shows if the statement is True (✔), False (!) or if it is unable to check it currently (?). At the bottom, you’ll also see if the entire Rule is True, False or if WalkMe Cannot Assert if it is either.

Grouping Statements
Grouping Statements allows you to create complicated rules that check multiple statements at the same time. Similar to how you combine sentences into a paragraph, creating a group of statements means that the Rule Engine will check all of these statements to evaluate if the group is either True or False.


In the simple example above, the first Statement (URL), is evaluated independently and here is marked as true.

The next 2 Statements are evaluated together: These statements are grouped and connected by an AND relationship. Since one of the statements is false they both evaluate as false.

Since OR is used between the first statement and grouped statement the Rule itself is marked as true because only one of the statements needs to be true for the whole rule to be true.

To Group statements, check the boxes of the Statement you'd like to group and click Group:

 

Try it Out

Try out Rules in the following ways throughout the Editor:
  • Segment your user groups using custom variables from your website
  • Create a Goal that checks if the user is on the correct page and clicks a button to finish a process
  • Create an Autoplay rule for a ShoutOut that only displays it for the next two weeks
  • Configure your SmartTip set to only appear on the page that has the correct form

 
Related Resources

Contact Us

  • Email Us
  • FAQ
  • Call Us

    Toll Free (US Number) 1-855-4-WalkMe (1-855-492-5563)
http://assets1.desk.com/
false
desk
Loading
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
about
false
Invalid characters found
/customer/en/portal/articles/autocomplete