How can I use a BOT to perform tasks in Athento?

To get a BOT program to perform activities/tasks from Athento's UI, you can use tags to identify UI elements that can be interacted with.

When binding BOT actions on DOM elements Athento recommends using HTML tags and attributes. Find an HTML tag that contains the interface element you want to interact with and use the data-athento-id attribute so that the BOT can locate it.

For example, if you want to interact with the Send Approval Mail button...

from the browser console we can locate the data-athento-id tag of an element containing the link.

I can not find the attribute data-athento-id, What can I do?

Not all interface elements have this attribute. You can do two things:

A) request the attribute via support or

B) use the id="" identifiers of the tags. In some cases, you can also use the name="" identifier.

NEVER use the class="" attribute to identify screen elements.

Note that there are dynamic elements (list, table, and other elements) that cannot carry a specific identifier. 

Frequently used identifiers

Lifecycle window/modal

• Button for opening the life cycle
  

  id="file-span-file-lifecycle-2"

• Transitions selector
  

  id="new-life-cycle-state-select"

• Input of comments:
  

  id="new-life-cycle-state-comment"

• Move button:
  

  data-athento-id="new-life-cycle-state-move-button"

Sending approval email

• Button to open the approval submission window:
  

  data-athento-id="delivery-modal-document-delivery-button"

Approval submission window options:

• Comment: name="comment"
• Recipient's name: receiverList\\.n\\.username
• Company: receiverList\\.n\\.company
• Email: receiverList\\.n\\.email
• Add recipient button:

  data-athento-id="delivery-document-modal-add-receiver-button"

• Send button:

  data-athento-id="delivery-document-modal-send-button"

The letter n in the elements associated with the addressees must be replaced by a number indicating the addressee to which it refers. The first addressee is always n=0. 

Related documents

• Before button, from the listing pagination: id="documents_related_next"
• Next button, from the list pagination: id="documents_related_previous"

Buttons on the trays (tails):

• Copy button: data-athento-id="copy-button"
• Excel button: data-athento-id="excel-button"
• CSV button: data-athento-id="csv-button"