Frames Identification Conditions

Anchors

Anchors are like bookmarks for application pages. For Apty to identify your application page, you can create unique page Frames by anchoring your page elements to the Frame. Each element on the application page can be used as an Anchor Point to accurately identify your page.

Example: If you want to show a Tooltip to a user only when they navigate to the Leads page in Salesforce, you can select upto 5 elements on the Leads page to add as Anchor Points in the condition as shown in the following GIF.

To create an Anchor Point:

1.  On the Create New Frame page in the Apty Studio, enter your Frame Name.

2.  Click the anchor icon to add a new Anchor Point.

3.  Hover your cursor over the page elements and then click the element(such as the text field, button, page title, etc.) you want to add as the Anchor Point.

4.  Click Save.

You can now use the Frame to create Apty Content like Validations, Launchers, Tooltips, and Announcements on your application.

Custom Script

In complex scenarios for highly dynamic applications like Salesforce, using Anchor Points to create Frames may not be enough. To ensure that users are on the correct page and can seamlessly create content like Validations, Launchers, Tooltips, and Announcements on your application, you can use custom JavaScript to create and connect unique Frames to their relevant pages. For instance, using a JavaScript with Boolean expression, which when executed, connects your webpage to a Frame only if the Boolean value is true and disconnects when it is false.

Example: If you want to show a Tooltip to a user only when they navigate to the Leads page in Salesforce, you can add a condition as shown in the following screenshot.

To add Custom Script to your Frame:

1.  On the Create New Frame page in the Apty Studio, enter your Frame Name.

2.  Click the ellipsis and then select Custom Script from the list of options.

3.  Enter your JavaScript function in the input field.

4.  Click Save.

URI Hash

If you want to identify a page using the hash value of your URL, you can use this condition. Hashes are usually present in Single page applications developed using AngularJS or ReactJS.

Example: If you want to show a Tooltip to a user only when they navigate to the Leads page in Salesforce, you can add a "/" followed by the value that comes after "#" in the condition as shown in the following screenshot.

To add a URI Hash to your Frame:

1.  On the Create New Frame page in the Apty Studio, enter your Frame Name.

2.  Click the ellipsis and then select URI Hash from the list of options.

3.  Enter your application page's URI Hash value in the input field.

4. Click Save.

Label Comparison

When you choose a label on your application page, Apty's Label Comparison condition will check whether the value it contains is true or false using a variety of relational operators.

Example: If you want to show a Tooltip to a user only when they navigate to the Leads page in Salesforce, you can add a condition as shown in the following GIF.

To use the Label Comparison condition in your Frame:

1.  On the Create New Frame page in the Apty Studio, enter your Frame Name.

2.  Click the ellipsis and then select Label Comparison from the list of options.

3.  Click + Add Condition.

4.  Click the Select Label button and then select a label on the application page.

5.  Select a relational operator from the dropdown.

The operators will define the relationship between the label and the value, depending on which the Frame will be connected to the relevant page for content creation and display.

6.  Enter a value in the input field to match the selected value of the label.

7.  Click Save.