> For the complete documentation index, see [llms.txt](https://docs.avoautomation.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avoautomation.com/avo-assure/actions/web/custom/set-secure-text.md).

# Set Secure Text

This pre-built Action is located under the **@Custom Element.** The functionality of this action in Avo Assure to set the encrypted text to the specified Object in Input Value, and save the result in dynamic variable.

### Syntax

**Input Value:** `<Object Type_Input>;<Visible text>;<index>;<Encrypted Text>;<abs(optional)>`

| Argument                                   | Description                                                                                                                                                       |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>\<Object Type\_Input><br>(Required)</p> | Specific type of object to be selected.                                                                                                                           |
| <p>\<Visible text><br>(Optional)</p>       | The visible text associated with the object.                                                                                                                      |
| <p>\<index><br>(Required)</p>              | <p>Provide the position of the element, which helps to identify the value based on the sequence in list.<br><strong>Note</strong>: Index value start from 0.​</p> |
| <p>\<Encrypted Text><br>(Required)</p>     | Encrypted text to be set on the object (use AES Encryption from tool utilities to encrypt the value).                                                             |
| <p>\<abs></p><p>(Optional)</p>             | If the **abs** is provided, the action is performed with absolute identification using the **absolute X path**                                                    |

{% hint style="info" %}
**Note:** If last argument abs is defined then the Action must be executed with absolute preformation with the specified visible text in the input.

To skip an optional input value, use an extra semicolon (;).
{% endhint %}

**Output Value**: `<Dynamic Variable>(Optional);<Dynamic Variable> (Optional)`

| Argument                                                     | Description                                                            |
| ------------------------------------------------------------ | ---------------------------------------------------------------------- |
| \<Dynamic Variable>(Optional);\<Dynamic Variable> (Optional) | This variable holds the status of the action as **True** or **False**. |

### **Example 1: Entering Encrypted Text into a Specified Input Field**

In this example, we explain how to decrypt and enter encrypted text into a specified input field using the **Set Secure Text** action.

* **Action**: Set Secure Text
* **Input Value**: input;Password;2;{"iv":"zkXzWGtWkz9KUb4/","encrypted":"RAhnH2tudbS7XF90Oc3ROg==","authTag":"k9bonGzztdolrEny5Lwrog=="}
  * The first argument (**input**) specifies the object type.
  * The second argument (**Password**) specifies the visible text associated with the object.
  * The third argument (**2**) specifies the index of the object (starting from 0).
  * The fourth argument specifies the encrypted text (**{"iv":"zkXzWGtWkz9KUb4/","encrypted":"RAhnH2tudbS7XF90Oc3ROg==","authTag":"k9bonGzztdolrEny5Lwrog=="}**) to be decrypted and entered into the input field.
* **Output Value**: {Secure Pass}
  * Stores the execution status in the dynamic variable:
    * **True**: If the encrypted text is decrypted and entered successfully.
    * **False**: If decryption or text entry fails.
* **Logical Explanation**: The **Set Secure Text** action fetches the value from the **Input Value** column (**input;Password;2;encrypted text**). It identifies the input field using the specified object type, visible text, and index, decrypts the encrypted text, and enters the decrypted value into the input field. The execution status is then stored in the **{Secure Pass}** dynamic variable.

{% hint style="info" %}
**Note**: Encrypt the required text using [**AES Encryption**](https://docs.avoautomation.com/avo-assure/utilities/encryption.md) from Avo Assure's encryption utilities before providing it as input to the action.
{% endhint %}

<figure><img src="https://2174257472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk8QZzXZMIJSStKAzDSTu%2Fuploads%2FzVrB47mcqlE4dM7bHoKy%2Fimage.png?alt=media&amp;token=c5b214e0-956c-4f9a-8fda-b39f726607e3" alt=""><figcaption></figcaption></figure>

### **Example 2: Entering Encrypted Text Using Absolute XPath**

In this example, we explain how to decrypt and enter encrypted text into a specified input field using its absolute XPath.

* **Action**: Set Secure Text
* **Input Value**: input;Password;2;{"iv":"zkXzWGtWkz9KUb4/","encrypted":"RAhnH2tudbS7XF90Oc3ROg==","authTag":"k9bonGzztdolrEny5Lwrog=="};//\*\[@id="email"]
  * The first argument (**input**) specifies the object type.
  * The second argument (**Password**) specifies the visible text associated with the object.
  * The third argument (**2**) specifies the index of the object (starting from 0).
  * The fourth argument (**{"iv":"zkXzWGtWkz9KUb4/","encrypted":"RAhnH2tudbS7XF90Oc3ROg==","authTag":"k9bonGzztdolrEny5Lwrog=="}**) specifies the encrypted text to be decrypted and entered into the input field.
  * The fifth argument (**//\*\[@id="email"]**) specifies the absolute XPath used to identify the input field.
* **Output Value**: {Secure Pass}
  * Stores the execution status in the dynamic variable:
    * **True**: If the encrypted text is decrypted and entered successfully.
    * **False**: If decryption or text entry fails.
* **Logical Explanation**: The **Set Secure Text** action fetches the value from the **Input Value** column (**input;Password;2;encrypted text;//\*\[@id="email"]**). It identifies the input field using the specified absolute XPath, decrypts the encrypted text, and enters the decrypted value into the input field. The execution status is then stored in the **{Secure Pass}** dynamic variable.

{% hint style="info" %}
**Note**:

* When you provide the **abs** option, the action uses absolute XPath to identify the object.&#x20;
* Ensure that the optional input is skipped using an additional semicolon (;) when required.
  {% endhint %}

<figure><img src="https://2174257472-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fk8QZzXZMIJSStKAzDSTu%2Fuploads%2FAdLCquboh2lMJSOxQAhx%2Fimage.png?alt=media&amp;token=4b5a779e-7f1b-41be-ad1c-bc3df85ee322" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avoautomation.com/avo-assure/actions/web/custom/set-secure-text.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
