# Searching in Flosum Backup & Archive

{% hint style="success" %}
**Required User Credentials**

\[**Flosum User**] - **Backup & Archive** license with **Backup & Archive** permissions
{% endhint %}

## ![](/files/CBvqj0H8446fKLeXtHLv)Overview

This article guides you through creating a Search in the Flosum Backup & Archive app. Use this feature to find specific records across Salesforce objects by applying filters. Once the search is complete, you can view the search results.

The search results can be purged, which removes the records from your backups and archives. The purpose of purging data is to help you comply with GDPR requirements. See the following articles for instructions on completing a purge.

* [Purging Data from Flosum Backup & Archive](/backup-and-archive/search/purging-data-from-flosum-backup-and-archive.md)

{% hint style="info" %}
To purge data, you must have **App Settings** permissions. Therefore, to execute both a Search and a Purge, permissions for **Backup & Archive** and **App Settings** are required.
{% endhint %}

{% hint style="info" %}
The Flosum Backup & Archive app in Salesforce allows you to search your backups and archives directly from Salesforce. See the following article to learn how to do this.

* [Searching Backup & Archive in Salesforce](/backup-and-archive/backup-and-archive-in-salesforce/searching-with-flosum-backup-and-archive-in-salesforce.md)
  {% endhint %}

## Create a Search Job

{% stepper %}
{% step %}

### Create a Search

1. Click **Search** from the sidebar menu.
2. Click the **Organization Switcher** from the breadcrumb path.&#x20;

   <div align="left"><figure><img src="/files/ccRF5KhAgpFMvsYV0eVw" alt="" width="563"><figcaption></figcaption></figure></div>
3. Select the organization you wish to use.&#x20;

   <div align="left"><figure><img src="/files/1i4aszDRbCTdjwDfNCqi" alt="" width="563"><figcaption></figcaption></figure></div>
4. Click **Create Search**.&#x20;

   <div align="left"><figure><img src="/files/5GD6eDeofWtVZ0IG7Sb4" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Add Objects

1. Click the **Add object** menu button to select the Salesforce Objects to include in the search.&#x20;

   <div align="left"><figure><img src="/files/6XvAu67SVoYwBE0n6OgE" alt="" width="563"><figcaption></figcaption></figure></div>
2. Search or browse for objects from the menu.

{% hint style="info" %}
When searching for an object, enter the **Salesforce Object Label**, not the Salesforce API Name. For example, enter **Content Version**, not ContentVersion.
{% endhint %}

3. Check the objects you want to add.
4. Click **Add** to add all of the selected objects.&#x20;

   <div align="left"><figure><img src="/files/XcuAd6y7BDuC7eUTgU9G" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Add Child Objects (Optional)

1. Click an object to open the **Add child objects** dialog.
2. Click the **+ Add** button next to each of the child objects to add.
3. Once you have added all the objects, click **Apply** to save the changes.&#x20;

   <div align="left"><figure><img src="/files/hO0jGIJdIhFpEs47jbdR" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Apply Filters

{% hint style="info" %}
Filters are required for all objects in a search operation.
{% endhint %}

1. Click **Filter** to add a filter to the object.&#x20;

   <div align="left"><figure><img src="/files/mnBmZZq9YyqXH7DmVW9y" alt="" width="563"><figcaption></figcaption></figure></div>
2. Click **Add Filter** in the filter dialog to add a filter criteria.
3. The screenshot below shows an example filter.
4. Click **Apply** to save the filter.&#x20;

   <div align="left"><figure><img src="/files/juCzq5Q6BjzrJOfPV5D0" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Finish Search Job

1. Click **Next**.&#x20;

   <div align="left"><figure><img src="/files/JFX6ew35uX8rrn1zsdJl" alt="" width="563"><figcaption></figcaption></figure></div>
2. Review the selected objects and filters.
3. Click **Search** to start the search.&#x20;

   <div align="left"><figure><img src="/files/waimfa9V2pM05mbX2ul4" alt="" width="563"><figcaption></figcaption></figure></div>
4. You can view the status of the search job in the **History** table on the **Search** page.&#x20;

   <div align="left"><figure><img src="/files/MdaC13JYrn45XKHpKdZw" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}
{% endstepper %}

## Reviewing Search Results

Once your Search Request has completed, you can review its details and results. The data in a search request is organized as follows:

**`Search Request > Data > Object > Version > Record > Fields/Data`**

1. The **History** table on the **Search** page shows all of the completed search jobs.
2. Click a **Search Request** job to view the records that were found during the search.&#x20;

   <div align="left"><figure><img src="/files/uSdIwWEhvDMNZlrHd72b" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
The **Records** column indicates the number of records found in response to your search request. The **Ready for Purge** tag will only appear if the search job completes with one or more matching records. If the search job does not find any records that match the search criteria, no data will be available for viewing or purging.
{% endhint %}

3. The **Overview** tab displays details about the search job.&#x20;

   <div align="left"><figure><img src="/files/KjpwFn1Z70ybX4eKiRm5" alt="" width="563"><figcaption></figcaption></figure></div>
4. Click the **Data** tab to view the data found by the search.
5. Click an object to view the records for that object.&#x20;

   <div align="left"><figure><img src="/files/RMyIKa7k8eaNUChrZxo8" alt="" width="563"><figcaption></figcaption></figure></div>
6. Click a record to view the versions of that record.&#x20;

   <div align="left"><figure><img src="/files/Z4pCol5FOhXFbnHU5NM0" alt="" width="563"><figcaption></figcaption></figure></div>
7. Click a version to view the fields and data for that version of the record.&#x20;

   <div align="left"><figure><img src="/files/iBCAZXJW5EaDb3YlqoYY" alt="" width="563"><figcaption></figcaption></figure></div>
8. You can search or browse to view all of the data in the fields of this record.&#x20;

   <div align="left"><figure><img src="/files/wBXDnW20bCSwDZ1IClbH" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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.flosum.com/backup-and-archive/search/searching-in-flosum-backup-and-archive.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.
