Best Practices for Oracle Cloud

This article provides instructions and best practices on how to select the following elements and attach Apty balloons to them. Refer to the respective section to learn how to select:

Home Page Icon selection (First Step of a Workflow)

Element Selection TypeElement Identifier
Automatic Selection (Select Element, ReSelect Element)
cid:image001.jpg@01D5AA2D.5CDB8C00
NA

Selecting the element via this function does not require additional identifiers, since the process is fully automated by Apty. Click Select / Reselect Elementin Apty App. 

The control is now passed to the application page in the browser. Hover over the field or another element to which the balloon should be attached and once it is highlighted, click it. The Apty ballon is going to be attached to it.

Entry Points help trigger Workflows from an intermediate step based on the application page where the Workflow is triggered from. 

Mark this page as Entry Point? (Yes/No)Entry Point TypePage Identifier
YesCustom Script

if( document.querySelectorAll('[id="app-navigation"]').length == 1 )

return true;

else

return false;


Search Page (or page where list of <items> can be found) (My Projects Search Page, Invoice Search page, etc.)


Element Selection TypeElement Identifier
CSS Selector:
cid:image004.jpg@01D5AA2D.5CDB8C00
div[title*="Search"]


Mark this page as Entry Point? (Yes/No)Entry Point TypePage Identifier
Yes

Custom Script: 

cid:image005.jpg@01D5AA2D.5CDB8C00

Note: Look for page headings as you see on the screen above "Invoices". Other Pages might have, My Projects etc... 


if(document.querySelectorAll('[title="<Title at top left>"]').length == 1)

return true;

else

return false;

 

Example: 

if(document.querySelectorAll('[title="My Projects"]').length == 1)

return true;

else

return false;



Tasks Icon


Element Selection TypeElement Identifier
CSS Selector[title*="Tasks"]


Mark this page as Entry Point? (Yes/No)Entry Point TypePage Identifier
Yes (When this step is the first balloon on the page)

Custom Script: 

cid:image005.jpg@01D5AA2D.5CDB8C00

Note: Look for page headings as you see on the screen above "Invoices". Other Pages might have, My Projects etc... 


if(document.querySelectorAll('[title="<Title at top left>"]').length == 1)

return true;

else

return false;

 

Example: 

if(document.querySelectorAll('[title="My Projects"]').length == 1)

return true;

else

return false;



Element Selection TypeElement Identifier
CSS Selector[title*="Search"]


Mark this page as Entry Point? (Yes/No)Entry Point TypePage Identifier
Yes (When this step is the first balloon on the page)

Custom Script: 

cid:image005.jpg@01D5AA2D.5CDB8C00

Note: Look for page headings as you see on the screen above "Invoices". Other Pages might have, My Projects etc... 


if(document.querySelectorAll('[title="<Title at top left>"]').length == 1)

return true;

else

return false;

 

Example: 

if(document.querySelectorAll('[title="My Projects"]').length == 1)

return true;

else

return false;


Point balloon to Task Link from Menu Section

Element Selection TypeElement Identifier
Custom Script

var x=document.querySelectorAll('div ul li a').length;

for(var i=0;i<x;i++) {

if(document.querySelectorAll('div ul li a')[i] && document.querySelectorAll('div ul li a')[i].innerText=='Manage Financial Project Settings') break; }

return document.querySelectorAll('div ul li a')[i];

 

Note: Replace text highlighted in yellow with your link name.



Mark this page as Entry Point? (Yes/No)Entry Point TypePage Identifier
No

Other Buttons

Buttons such as Edit, Submit, Submit (with Hyperlink on a letter) etc..

Element Selection TypeElement Identifier
CSS Selector

button[title="Edit"]
 (or)

button[id*="search"]

(or)

div[id*="submitButton"]


Note: Inspect (CNTL +SHIFT + I) the button and look for button tag -> Title attribute.

Symbols like +, X, etc.

cid:image012.jpg@01D5AA2D.5CDB8C00


Element Selection TypeElement Identifier
CSS Selector

For +: img[title="Add"]

For X: img[title="Remove"]


Note: Inspect (CNTL +SHIFT + I) the button and look for button tag -> Title attribute as different sybmols might have a different title.

All the Input fields on the form pages (Input, Pull-down, browse, checkbox, etc.)


cid:image013.jpg@01D5AA2D.5CDB8C00


Element Selection TypeElement Identifier
Automatic Selection (Select Element, Reselect Element)

NA


Selecting the element via this function does not require additional identifiers, since the process is fully automated by Apty. Click Select / Reselect Elementin Apty App. 

The control is now passed to the application page in the browser. Hover over the field or another element to which the balloon should be attached and once it is highlighted, click it. The Apty ballon is going to be attached to it.

Tabs on the form pages

Element Selection TypeElement Identifier
Custom Script

var x=document.querySelectorAll('a[id*="order_management_order_management"]').length;

for(var i=0;i<x;i++) {

if(document.querySelectorAll('a[id*="order_management_order_management"]')[i] && document.querySelectorAll('a[id*="order_management_order_management"]')[i].innerText=='General') break; }

return document.querySelectorAll('a[id*="order_management_order_management"]')[i];

Note: Replace "General" with your tab name


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.