# Features

{% hint style="success" %}

## Demos and Training Always Available

If you are a current or prospective customer of GRAX and interested in the Managed Package, our team is always happy to provide demonstrations, training, and/or installation assistance. Just [reach out to our Support team](/support/get-support.md) and they'll put you in touch with the right people.
{% endhint %}

{% hint style="danger" %}
These components are only available for the Lightning Experience on the Desktop. Salesforce Classic and mobile are not supported.
{% endhint %}

## Related Records Component

The Related Records component is designed to make viewing records that are related to a live Salesforce record as easy as possible, regardless of whether they are also live in Salesforce, were deleted by a user, or archived by GRAX. 

<figure><img src="/files/ZDJ8dLEPAdMI6hiCItBz" alt=""><figcaption><p>Related Records Component</p></figcaption></figure>

This component is most valuable in Salesforce orgs that take advantage of GRAX's Archive features to keep the size and growth of their org under control. As you move more of your historical data out of Salesforce, it becomes increasingly important to be able to access that data in a user friendly way. With this component, users don't even need to leave the record page to:

* See all cases ever opened for a customer, deleted or not
* Review email threads related to deleted cases
* Reread the notes on recurring tasks that were cleaned up years ago
* ...and much more.

This component can be placed on record detail pages. It automatically searches for records matching the configured filters that are related to the record being viewed. For example, if the component is placed on an Account record page, the component will display records related to that account or its children. The set of fields returned can be configured in the component settings once added to a page.

Users can jump out into the standalone GRAX web application at will if their exploration becomes deep or complicated enough by clicking on the record hyperlinks.

<details>

<summary>Configuration</summary>

The following settings can be configured via the component properties within the Lightning App Builder:

<table><thead><tr><th width="183">Setting</th><th>Effect</th></tr></thead><tbody><tr><td>Related Object</td><td>Controls the type of records that will be displayed.</td></tr><tr><td>Dataset Selection</td><td><p>Filters out records based on their deletion status.</p><p></p><p>Possible values are:</p><ul><li>All (Live, Deleted, and Archived records)</li><li>Archived (Deleted by GRAX Archive)</li><li>Deleted (Deleted by any other means)</li><li>Archived or Deleted (Anything not Live)</li></ul></td></tr><tr><td>Child Level</td><td><p>The level in the hierarchy under the root record that records should be retrieved from.</p><p></p><p>For example:</p><ul><li>1 means immediate children of the root record</li><li>2 means grandchildren of the root record</li><li>3 means children of grandchildren of the root record</li></ul></td></tr><tr><td>Fields</td><td>A comma-separated list of Field API names to include in the output table. If no field exists for a provided name, that column will be blank in the resulting table.</td></tr><tr><td>Records Per Page</td><td>The number of records that will be displayed at once on the table. If more records than this exist, users can page through the results.</td></tr><tr><td>Override Title</td><td>Allows customization of the default page title which is usually based on the root object type.</td></tr><tr><td>Height</td><td>Sets the height of the component in the page.</td></tr><tr><td>Additional Configuration</td><td>A place to set optional, advanced configuration values that get passed to the GRAX application.</td></tr></tbody></table>

</details>

## Record Versions Component

The Record Versions component is designed to make exploration of single-record history as easy as possible. This component can be placed on record detail pages. All backed up versions of the target record will be shown in the table, alongside a measure of how different each version is from the current state of the record.

<figure><img src="/files/oa0AiV1aDzHlINPE8iNI" alt=""><figcaption><p>Record Versions Component</p></figcaption></figure>

Through use of the "Compare" functionality, users can see at a granular level what was changed in each version, what the old and new values were at each change, and even who made the change. Users can restore either an entire version of a record or cherry-pick specific fields from specific versions to restore.

<figure><img src="/files/8zqo9XKyqLjfqKrLvtG6" alt=""><figcaption><p>Record Versions Comparison</p></figcaption></figure>

Users can jump out into the standalone GRAX web application at will if their exploration becomes deep or complicated enough by clicking on the record name hyperlink.

<details>

<summary>Configuration</summary>

The following settings can be configured via the component properties within the Lightning App Builder:

| Setting          | Effect                                                                                                                                  |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| Records Per Page | The number of records that will be displayed at once on the table. If more records than this exist, users can page through the results. |
| Override Title   | Allows customization of the default page title which is usually based on the root object type.                                          |
| Height           | Sets the height of the component in the page.                                                                                           |

</details>

### Previewing the LWC in your GRAX App

The Related Record Builder within your GRAX app provides an interactive tool to build and preview the LWC configuration. Simply navigate to your GRAX App Settings, click on Diagnostics and Tools and choose the Related Record Builder at the bottom of the page.&#x20;

<figure><img src="/files/8tU235Qs2k4c3sxY40LG" alt=""><figcaption><p>Related Record Builder Sample Data</p></figcaption></figure>

#### Configuring the Related Record Builder&#x20;

* Under General Settings, enter in the Parent Record ID of the object you'd like to view.&#x20;
* Enter an Override Title (e.g., 'Archived Case Records')*.*
* Choose the Related Object you want to display (e.g., 'Case').&#x20;
  * When the Related Object is chosen the Child Level will automatically populate with the correct level of the Related Object.&#x20;
* Select the Data Set Selection: All Data, Archived Data, Deleted Data, or Archived + Deleted Data.&#x20;
* Add the Fields you want to display on the LWC (e.g., Case Number, Subject, Status).

By default, the Sample Data will show the record ID, mod stamp and the "Name" field. However, once you specify the fields you'd like to display those are dropped for your selection.

<figure><img src="/files/otbXV6KVeu9DP1NsGG9e" alt=""><figcaption><p>Related Record Builder General Settings</p></figcaption></figure>

Once the LWC preview is configured to your liking, use the LWC Settings Reference to auto-populate your settings within the Salesforce LWC directly. Click the Copy to LWC button (box with arrow icon) to transfer your settings.

<figure><img src="/files/bxo5PR4Vg7IVNVcFbXdl" alt=""><figcaption><p>LWC Settings Reference</p></figcaption></figure>

## Global Search Component&#x20;

The Global Search component is designed to let users search for data within GRAX using powerful filters and conditions without needing to leave the Salesforce platform. It offers parity with the normal Global Search experience in a form that will sit right alongside your other application tabs in Salesforce.

<figure><img src="/files/3D9EBYiKB4lU4pI2Fn3D" alt=""><figcaption><p>Global Search Custom Tab</p></figcaption></figure>

As an Administrator, you can let your users interact with the full Global Search feature set, shown above, or give users a constrained template-based experience, shown below. Templates allow Administrators to define performant, index-optimized searches for use by end-users. This can help reduce the wait-time for results, strain on infrastructure, and the amount of training required for new users.

<figure><img src="/files/6AJVbIhYdJ99pnVd51pE" alt=""><figcaption><p>Template Search in Search Tab Component</p></figcaption></figure>

<figure><img src="/files/VmiyHN1A2pBtocIqMLb1" alt=""><figcaption><p>Template Search Results</p></figcaption></figure>

<figure><img src="/files/WbcLrlBDSmRyCFuwpbVx" alt=""><figcaption><p>Template Search Record View </p></figcaption></figure>

<details>

<summary>Configuration (App or Home Page)</summary>

This configuration information is only relevant if using the Search component on an "AppPage" or "HomePage" within Salesforce. If using the component as a standalone Custom Tab, see the section below.

| Setting          | Effect                                                                                                                                                                                                                                                                           |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mode             | <p>If "Full Search" is selected, users will see the full Global Search experience.<br><br>If "Template Search" is selected, users will see the template-based Search experience.  </p>                                                                                           |
| Show Template ID | <p><em>This setting only has an effect if the "Mode" setting is set to "Template Search".</em><br><br>If enabled, users will be shown the input form for a specific template with the given ID.<br><br>If disabled, users will be shown the list of all available templates.</p> |

</details>

<details>

<summary>Configuration (Custom Tab)</summary>

This configuration information is only relevant if using the Search component on a standalone Custom Tab within Salesforce. If using the component on an App or Home page within Salesforce, see the section above.

Custom Tabs within Salesforce do not have the same configuration options as native Lightning Web Components. To change the behavior of your Custom Tab, you can change settings within the GRAX package's Custom Settings:

| Setting                      | Effect                                                                                                                                                                                                                                                                                 |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search Tab: Template Search  | <p>If enabled, users will see the template-based Search experience within the Custom Tab.</p><p></p><p>If disabled, users will see the full Global Search experience within the Custom Tab.</p>                                                                                        |
| Search Tab: Show Template ID | <p><em>This setting only has an effect if the "Search Tab: Template Search" setting is enabled.</em><br><br>If enabled, users will be shown the input form for a specific template with the given ID.<br><br>If disabled, users will be shown the list of all available templates.</p> |

*These settings do not have any impact on the Search component when used as a native Lightning Web Component on an App or Home page.*

</details>

{% hint style="success" %}

## Do you need something slightly different?

We're always looking for feedback on the user experience and feature set of our Lightning Web Components. If you have a specific use case that isn't covered by the components above, please [open a support ticket](/support/get-support.md) to discuss your needs.
{% endhint %}

## Permissions Model

The components included in the Managed Package are secured by the same permissions model that the normal GRAX application interface uses. To use the components, users must have one of the following permission sets:

* GRAX Console Standard Permission
* GRAX Console Seeding Permission
* GRAX Console Purge Permission
* GRAX Console Power Permission
* GRAX Console Admin Permission

&#x20;These permission sets are created by Auto Config when you connect your GRAX app for the first time.

Users will also need to self-authorize the GRAX connected app by opening the GRAX application in a separate tab the first time they log in. This can be avoided by an admin pre-authorizing the users via the Connected App settings.


---

# Agent Instructions: 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:

```
GET https://documentation.grax.com/reuse-data/managed-package/second-generation/features.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.