> For the complete documentation index, see [llms.txt](https://docs.dynalogic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dynalogic.com/birds-document-warehouse-product-overview/user-guide/search-for-a-file.md).

# Search for a file

File search is case-insensitive.

To narrow your results by business context, use [tag filters](#filter-files-using-tag-filters).

<div align="left"><figure><img src="https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-600b31da2e46bb735b0ff469310e6dbbb02a6d17%2Fimage%20(471).png?alt=media" alt=""><figcaption></figcaption></figure></div>

1. In the **Search...** field (1), enter all or part of the file name.
2. Press Enter. The document list shows accessible files whose names contain the entered text.

## Advanced search

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-afea7d572c8d6418876e3666b786d9675de6fed7%2Fta_search_for_a_file.png?alt=media)

Select the magnifying-glass icon to open advanced search and build a more specific query.

Choose a condition based on **Document**, **Text**, **Number**, **Date**, or **Tags**.

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-e6a1297582ddfc65b756e5fd9ef4aebdeb265178%2Fta_search_for_a_file_5.png?alt=media)

Select the field and comparison required by the condition. For example, set the validation status to equal or not equal **Complete** to filter documents by that status.

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-40356a818df0bfb6a37b960735c76724d4095168%2Fta_search_for_a_file_7.png?alt=media)

Add further conditions as needed and combine them with **AND** or **OR**. Review the grouping so that the query matches the intended criteria.

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-7186d7de70b48b3e997aa859eb49cd93fbdf5ee5%2Fta_search_for_a_file_102.png?alt=media)

Use the copy action to copy the query for reuse, including in the SharePoint integration.

You can also save a query and run it again later. The example below saves a query named **Test**.

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-1566cb57d977f97cc771e34e4822303dd993a2a9%2Fta_search_for_a_file_01.png?alt=media)

![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-efe62e0d06aa93a60032acf58d82fb16522c87d1%2Fta_search_for_a_file_02.png?alt=media)

## Filter files using tag filters

File search is case-insensitive.

You can refine your results by adding new tag filters.

You can re-extend your results, clearing a tag filter or all tag filters.

1. In the **Search**... field, start typing the tag filter.

   When the entered letter/number combination matches tags, the search function is of the type-ahead or instant search type and shows all remaining tags matching your letter/number combination.
2. Select a tag corresponding to the file you are looking for.

   Only the files in the list ![](https://1567270722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbMdBZV3cNP56k0aYYCI6%2Fuploads%2Fgit-blob-92bd454ffe37ce62700395f191ab4158445c5252%2Fimage%20\(597\).png?alt=media) Filtered tags: are shown.

### Filter files using date fields

When you go to the advanced search, there is the possibility to select any of the date fields in your system. By default you can use the calendar icon to open a date picker to select a specific date; and you have the option to choose "equals", "less then" or "greater then".

It is also possible to select a "dynamic" date; this can be useful when used in saved queries.

For example, instead of searching for document with "Due by" is less then 2024-01-31, you could now create a "Due By" equals "This month".

To switch to a dynamic date you can hover over the date field date picker, and a switch type button will appear. Click on it, and the date will be switched to "today". Now you can click again on the calendar icon and a small configuration screen will appear.

Here you have 3 options

* One of "**today**", "**tomorrow**", or "**yesterday**".\
  Simple & probably the most common use cases.
* An **offset**; meaning that it will add or removes a certain amount of days, weeks, months or years to the "current date". The result will be a single day (/date).
* To pick a **range**; for example "this week", "next month", "last year", ...

How does the Range option work?

* Date **Equals** matches all documents that have the date field in the range.
* Date **Less then** matches all documents that have the date field with a value lower then the start of the range.
* Date **Greater then** matches all documents that have the date field with a value greater then the end of the range.

### About Extended ranges

It is possible to extend a range with a certain amount; for example by selecting "next 3 weeks", you will get a range of 3 weeks starting next week and then extending 3 weeks in the future.

When you pick "last 2 weeks", you get a 2 week range that equals last week and the week before that.

If you pick "Last -2 weeks", you get a range of 2 weeks again; which starts last week, and includes "this week".

So basically: if the range starts with "this" or "next", a positive numeric value will extend the end of the range. And a negative value will extend the start of the range (back in time)

But if you have a range starting with "last", then a positive number will extend the start of the range to start earlier, and will leave the end of the range as is. And a negative number will extend the end of the range while keeping the start of the range.

Note that this configurator does not allow to create advanced ranges like a range of 17 days starting 2 weeks from now. But most common situations should be achievable; if needed by combining multiple ranges in 'AND' / 'OR' combinations.

### About the time zone

The current date depends on where you are due to time zones. For example, if it's January 23rd in Brussels, it might still be January 22nd in Washington, D.C. To make sure the dynamic date function works well it is important to pick the correct time zone. By default our user interface will assume "Europe/Brussels" since this should fit most of our user base. But it is possible to pick any time zone you want.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dynalogic.com/birds-document-warehouse-product-overview/user-guide/search-for-a-file.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
