> For the complete documentation index, see [llms.txt](https://docs.tpi.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tpi.dev/guide/ac-user-management/role-and-txid.md).

# Role & txID

<mark style="color:green;">**Path: AC User Management > Role & txID**</mark>

Roles & txID (Transaction ID) enables/disables the role’s CRUD function on the platform.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/wYn4t87ppxYVh1VCPHaH/image.png" alt=""><figcaption></figcaption></figure>

### Create Role & txIDs <a href="#toc169185978" id="toc169185978"></a>

In this section, you can find instructions on how to create a role & txID.

1. Click **Create** to access the role & txID creation page.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/VIwa1fVe6A7XMCYRUrvt/image.png" alt=""><figcaption></figcaption></figure>

2. Fill in the data or make selections as instructed below. The fields marked with “<mark style="color:red;">\*</mark>” are required.

* **Role**<mark style="color:red;">\*</mark>**:** The role code that needs to be set, with only one role selectable from the list.
* **Transaction ID**<mark style="color:red;">\*</mark>**:** txId that can or cannot be executed.
* **Type**<mark style="color:red;">\*</mark>**:** Set as whitelist or blacklist.

3. Click on the <img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/FM0eDPjgi6dfGAnjscPo/2.png" alt="" data-size="line"> icon in the **Role**<mark style="color:red;">\*</mark> filed to search for the role to access the role list menu, and click **Confirm** to save and exit.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/8Dbk4lVqpW9W71tJscK3/image.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/vhZ7sB0RqjADv6x4GJv3/image.png" alt=""><figcaption></figcaption></figure>

4. Set the type as the whitelist or blacklist.

<table><thead><tr><th width="151"></th><th>Whitelist</th><th>Blacklist</th></tr></thead><tbody><tr><td>Description</td><td><p>Only allow executing the selected txId (Transaction ID) triggered role.</p><p>If the correct txId (Transaction ID) was not filled in, users will not be able to use the system.</p></td><td><p>Do not allow executing the selected txId (Transaction ID) triggered role.</p><p>Entering the wrong txId (Transaction ID) will not cause users unable to operate the system normally.</p><p>However, if a specific txId (Transaction ID) was entered, users cannot use the function that corresponds to this txId (Transaction ID).</p></td></tr><tr><td>Example</td><td>If AAA was entered in the <strong>Transaction ID</strong><mark style="color:red;">*</mark> field, AA0020</td><td>If AAA was entered in the <strong>Transaction ID</strong><mark style="color:red;">*</mark> field, AA0020</td></tr><tr><td><p>Example</p><p>Description</p></td><td><p>AAA is the wrong txId, therefore system operation will not be affected.</p><p>However, the function that corresponds to AA0020 is Search of role maintenance, therefore, users <strong>can only use the search function of role maintenance</strong>.</p></td><td><p>AAA is the wrong txId, therefore system operation will not be affected.</p><p>However, the function that corresponds to AA0020 is Search of role maintenance, therefore, users <strong>cannot use the search function of role maintenance</strong>.</p></td></tr></tbody></table>

{% hint style="warning" %}
If the list type is set to whitelist, only the Transaction IDs (txIDs) listed in the whitelist are allowed; all other functions will be considered unauthorized. The system will not prompt any warning if an incorrect txID is entered. Therefore, when setting up the whitelist, verify that the txIDs are correct before saving.

&#x20;

Conversely, if the list type is set to *blacklist*, when a user attempts to operate a txID listed in the blacklist, the system will prompt the warning message: “**1357 - The roles assigned to you are not authorized to call API txID \[AA0510]**”.  A warning prompt displaying the message “**Confirm Delete?**” will pop up.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/gOKrodftOjFMlFBasqla/image.png" alt=""><figcaption></figcaption></figure>

For more information, refer to [Search txID (Transaction ID)](#hlk167464136).

{% hint style="warning" %}
If the Transaction ID was already set in the blacklist first, if this Transaction ID is added to the whitelist, the prompt “**1353 - \[Role + Transaction ID] already exists: (2000000016 + AA0006)**” will appear, meaning that this Transaction ID was already created in the blacklist.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/9cz6G0CMShwB8uwrPyiJ/image.png" alt=""><figcaption></figcaption></figure>

### Search Role & txIDs <a href="#id-2.6.2._search_role" id="id-2.6.2._search_role"></a>

Enter keywords in the **Keyword Search** field and **Type** field to search for role & txID.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/3P5TzHgqlfixHwDNBEV8/7.png" alt=""><figcaption></figcaption></figure>

### Update Role & txIDs <a href="#toc169185980" id="toc169185980"></a>

In this section, you can find instructions on how to update a role & txID.

1. Search for the role list to modify, and click the![](https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/IoQQ0BVQIEiRlSiB5gW6/8.png)icon to proceed.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/tS6CyHiE5L4csnpNNrCQ/image.png" alt=""><figcaption></figcaption></figure>

2. Modify the desired fields, and click **Update** to save and exit.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/CZawkRWA4JIupudTaMIK/image.png" alt=""><figcaption></figcaption></figure>

### Delete Role & txIDs

In this section, you can find instructions on how to delete role & txID.

1. Search for the role & txID to delete, and click on the![](https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/mlCG3dGUWTZldZeQh3EY/11.png)icon to proceed.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/6BO7fPtlhFVpzO8y145D/image.png" alt=""><figcaption></figcaption></figure>

2. A warning prompt displaying the message “**Confirm Delete?**” will pop up. Click **Confirm** to delete the role & txID and exit.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/w0kxYC2Xoqn7KveyVV7u/image.png" alt=""><figcaption></figcaption></figure>

### Search txIDs <a href="#hlk167464136" id="hlk167464136"></a>

1. First, press F12 developer tools, then select the tab **Network** > **Name** area at the bottom-right is where the txID is placed.
2. Click any function on the system, such as: **Search** in User, its corresponding txID is AA0019.

<figure><img src="https://content.gitbook.com/content/0choIC1BbdPOkKWOYGgk/blobs/yc889j6NiQGhAaHsjn4B/image.png" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tpi.dev/guide/ac-user-management/role-and-txid.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.