# Configuring OneSearch for Service Operations Workspace

{% hint style="info" %}
Before OneSearch will appear on a workspace, you must configure a **Form/Portal/Workspace** record for the table being shown in the workspace. More information on this can be found in the [Tips & Tricks](/onesearch/technical-docs/tips-and-tricks.md) section.
{% endhint %}

1. Open UI Builder to the “Record” page of a desired workspace experience. Make sure you are on the desired page variant as well.

<figure><img src="/files/ZT6jcOtscl6snewR7J8R" alt=""><figcaption></figcaption></figure>

2. Click on the “Contextual Side Panel” component and then add a new tab using the “+Add” button.&#x20;

{% hint style="info" %}
If adding to a page collection, navigate to the page collection, click "Edit Content", and then click the "+" button next to pages & variants. Update the name as-needed (Ex: OneSearch)
{% endhint %}

\
\&#xNAN;*NOTE: If you don’t have the “+Add” button, skip Steps 2 and 3 and go to the* [*Alternate Steps*](/onesearch/onesearch-for-workspaces/configuring-onesearch-for-service-operations-workspace/alternate-steps.md) *section, then return to Step 4)*&#x20;

<figure><img src="/files/KDqyCeKl9EUrxaVhSj8q" alt=""><figcaption></figcaption></figure>

3. Fill in the tab information and click “Create”.

{% hint style="info" %}
If adding to a page collection, and you'd like to add an icon to the sidebar button. Once the page is created, navigate to the page collection settings, click on the link to "Open page collection". There you will see a related list title "UX App Routes" - here you can set the icon for the OneSearch page you added.
{% endhint %}

<figure><img src="/files/j3AlE2qgVA2X3NUcDAjG" alt=""><figcaption></figcaption></figure>

4. UI Builder should redirect to a new page where you can design the tab layout. Select the “Body” component from the component tree. Click “Edit” in the Config tab.

<figure><img src="/files/apxrCho9PJdu0hQ5nD9v" alt=""><figcaption></figcaption></figure>

5. In the modal, click the “+ Add” button to add a new page property. Name it “sysId” and then click “Add”. Click “+ Add” again to add another page property named “table” and then click “Add”. Repeat the steps one more time for a page property called “fields”. Save.

<figure><img src="/files/wWoZmWvtimY5SPafooqc" alt=""><figcaption></figcaption></figure>

6. Edit the config properties on the “Body” component so that table points to “@data.gform.nowRecordFormBlob.table”, sysId points to “@data.gform.nowRecordFormBlob.sysId”, and fields points to “@data.gform.nowRecordFormBlob.fields” (use dynamic data binding).

{% hint style="info" %}
Depending on your version of UI Builder, the properties may need to be pulled from SOW Record Control.
{% endhint %}

<figure><img src="/files/ZVWXsh5EC6ANimkXW7uU" alt=""><figcaption></figcaption></figure>

7. Add the “YDS OneSearch - General Search Widget” component to the page.&#x20;

<figure><img src="/files/mWPScMbm8FK2Cehe7dCX" alt=""><figcaption></figcaption></figure>

8. Edit the config properties on the “YDS OneSearch - General Search Widget” component so that Table points to “@context.props.table”, Record points to “@context.props.sysId”, and Form fields points to “@context.props.fields” (use dynamic data binding).
   1. Note: You do *not* need to set the “Searcher override” unless you are using the OneSearch component on a page that is not a record/form and do not have a “Table” and “Record” to pass in.

<figure><img src="/files/VN3HUgXkN5MbXF23cLa6" alt=""><figcaption></figcaption></figure>

9. Save the changes and then go to a record on your workspace to verify the OneSearch component is visible.

<figure><img src="/files/NbkwxTHzdkzUnYFEiu3z" alt=""><figcaption></figcaption></figure>

See ServiceNow’s [documentation](https://docs.servicenow.com/csh?topicname=customize-options-side-panel\&version=latest) for reference.


---

# 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://docs.yansalabs.com/onesearch/onesearch-for-workspaces/configuring-onesearch-for-service-operations-workspace.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.