> For the complete documentation index, see [llms.txt](https://docs.inogic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inogic.com/user-adoption-monitor/how-to-guides/track-opening-of-records.md).

# Track Opening Of Records

{% hint style="info" %}
In version 9.0.0.28 and later, form scripts are added automatically when you save the record opened `ikl_open` configuration. No manual configuration or script addition is required.

For more information, [click here](https://docs.inogic.com/user-adoption-monitor/how-to-guides/track-opening-of-records#simplified-configuration)
{% endhint %}

You can also track record opens (when a record is viewed). This needs some customization. For example, to track when Account records are opened:

Create a record in the **User Adoption Entity Configuration** entity with these details:

* **Entity Label:** Account (the entity whose opens you want to track)
* **Entity Schema:** account (the schema name of that entity)
* **Message:** ikl\_open
* **Period:** Daily (how often you want to track)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRXFLo-miRll3fffnt%2FTrack_1.png?alt=media\&token=d7c5607d-dfae-44c9-94ab-23b6cbb64752)

* Add the following User Adoption Monitor 'JavaScript libraries' to the **Account** form, in the same order as listed below. These libraries come with the product.

**ikl\_/UserAdoption/scripts/jquery.js**

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRXMjgOprHFzHskCkp%2FTrack_2.png?alt=media\&token=f550d60e-b5a9-4342-a69b-0f04a5234635)

**ikl\_/UserAdoption/scripts/UserAdoption.CrmJS.js**

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FNXKdUL7sQVWp4CrudnTO%2FUAM%20Track%20records_2.png?alt=media\&token=55702fe9-146e-470c-827e-378d17312c1d)

**ikl\_/UserAdoption/scripts/UserAdoption.WebAPI.js**

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FMttONrrdBqxJdF6eRQJ5%2FUAM%20Track%20records_1.png?alt=media\&token=58ee5506-977c-4525-9155-364946783f6b)

**ikl\_/UserAdoption/scripts/UserAdoption.ExecuteReadAction.js**

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRX_Pj1guxrvAhswA8%2FTrack_4.png?alt=media\&token=3ed18d9b-553e-40c8-8110-cb9b2cd356f9)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRXfoq2QeI5-9_vwTD%2FTrack_5.png?alt=media\&token=18dfaff1-0678-4f98-a99c-798018607bed)

* Finally, call the **getRecordDetails** function on the form’s **OnLoad** event, as shown in the screenshot below. The function is in the JavaScript library **ikl\_/UserAdoption/scripts/UserAdoption.ExecuteReadAction.js**, which is already included in the form. Then save and publish your customizations.

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRXoAhx6-sjKNMK6qL%2FTrack_6.png?alt=media\&token=bee59e9d-8723-496f-920f-4c9404d31eef)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRXuSV4iGerNokiGS9%2FTrack_7.png?alt=media\&token=98a80a86-eb83-4ec4-a1c4-087383de6a03)

![](https://272130504-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0QoyqUVI8_HaZ9FOSL%2F-MQRWMU2SSAwQm5w7Huw%2F-MQRY2QmryEAHaZT0yE4%2FTrack_8.png?alt=media\&token=6aa34f04-d93c-4e6f-bd45-17cd288791a7)

{% hint style="info" %}
**Note:**&#x20;

* Make the changes above on every form you use, if you have multiple forms set up for role-based access.
* You need the **System Administrator** privilege to make these changes.
  {% endhint %}

### Simplified Configuration

With this method, when you save the configuration, the required User Adoption Monitor JavaScript libraries (shipped with the product) are automatically added to the selected entity’s form.

Just follow the steps below and click **Save**. It will then be ready to use.

* Select the entity (table) on which you want to track record opens. For example: **Account**

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2F6f2zXCFl6YWC8QXg7KTJ%2Fimage%20(30).png?alt=media&amp;token=3b059809-2ddd-4199-b0bb-edee6183f831" alt=""><figcaption></figcaption></figure>

* Go to Advanced Actions and click on it

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2F7O1ZwrJqOasEPhWSXh95%2Fimage%20(31).png?alt=media&amp;token=dde5e74f-4222-4900-8738-aac103dc0426" alt=""><figcaption></figcaption></figure>

This opens a pop-up with the following options:

* **Tracked users:** Choose which users you want to track by turning them on or off.
* **Frequency:** Choose how often to track: daily, weekly, or monthly.
* **What to track:** Choose time spent on a record, number of times a record is opened, or both.
* **Forms:** Select the forms on which you want to count record opens.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FJWUkaZcmmNzV1sc6oIvP%2Fimage%20(32).png?alt=media&amp;token=8fb6562c-957d-4093-ae7d-809af0b8b4a0" alt=""><figcaption></figcaption></figure>

* You will see a message that your changes are unsaved. Click **Save**. Once saved, the configuration is complete, and the feature is ready to use.

<figure><img src="https://272130504-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M0QoyqUVI8_HaZ9FOSL%2Fuploads%2FacQT1W3Tp2Rh64VKKafa%2Fimage%20(16).png?alt=media&amp;token=377f63ff-88f1-4938-9985-138677247e2d" alt=""><figcaption></figcaption></figure>
