Skip to content

Commit c585a06

Browse files
committed
save drafts
1 parent 7ba048e commit c585a06

11 files changed

+567
-162
lines changed

.openpublishing.redirection.json

+10
Original file line numberDiff line numberDiff line change
@@ -17653,6 +17653,16 @@
1765317653
"source_path": "docs/pipelines/archive/news/rm-archived.md",
1765417654
"redirect_url": "/azure/devops/release-notes/index",
1765517655
"redirect_document_id": false
17656+
},
17657+
{
17658+
"source_path": "docs/project/search/index.md",
17659+
"redirect_url": "/azure/devops/project/search/get-started-search",
17660+
"redirect_document_id": false
17661+
},
17662+
{
17663+
"source_path": "docs/project/search/overview.md",
17664+
"redirect_url": "/azure/devops/project/search/get-started-search",
17665+
"redirect_document_id": false
1765617666
}
1765717667
]
1765817668
}

docs/get-started/toc.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@
2424
href: ../project/navigation/preview-features.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json
2525
- name: Search
2626
items:
27-
- name: Search across your projects
28-
href: ../project/search/overview.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json
27+
- name: Get started with search
28+
href: ../project/search/get-started-search.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json
2929
- name: Search code
3030
href: ../project/search/code-search.md?toc=/azure/devops/get-started/toc.json&bc=/azure/devops/get-started/breadcrumb/toc.json
3131
- name: Search work items

docs/index.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -202,7 +202,7 @@ additionalContent:
202202
text: Features & services
203203
- url: ./project/navigation/index.md
204204
text: Web portal navigation
205-
- url: ./project/search/index.md
205+
- url: ./project/search/get-started-search.md
206206
text: Search
207207
- url: ./notifications/manage-your-personal-notifications.md
208208
text: Manage personal notifications
@@ -233,7 +233,7 @@ additionalContent:
233233
- title: Cross-service, Wikis, Public Projects
234234
links:
235235
- text: Search
236-
url: ./project/search/overview.md
236+
url: ./project/search/get-started-search.md
237237
- text: Work across projects
238238
url: ./project/navigation/work-across-projects.md
239239
- text: Work across projects FAQs

docs/organizations/projects/project-team-quick-reference.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -159,7 +159,7 @@ Several of the following tasks require permissions granted to a member of the Pr
159159
:::column span="":::
160160
- [Restore project](restore-project.md)
161161
- [Change user access levels](../accounts/add-organization-users.md)
162-
- [Search across project(s)](../../project/search/overview.md)
162+
- [Search across project(s)](../../project/search/get-started-search.md)
163163
- [Set area paths](../settings/set-area-paths.md)
164164
- [Set favorites](../../project/navigation/set-favorites.md)
165165
- [Set iteration paths](../settings/set-iteration-paths-sprints.md)
@@ -201,7 +201,7 @@ Several of the following tasks require permissions granted to a member of the Pr
201201
- [Rename project](create-project.md)
202202
- [Rename team](../settings/rename-remove-team.md)
203203
- [Restore project](restore-project.md)
204-
- [Search across project(s)](../../project/search/overview.md)
204+
- [Search across project(s)](../../project/search/get-started-search.md)
205205
- [Set area paths](../settings/set-area-paths.md)
206206
- [Set favorites](../../project/navigation/set-favorites.md)
207207
- [Set iteration paths](../settings/set-iteration-paths-sprints.md)
@@ -239,7 +239,7 @@ Several of the following tasks require permissions granted to a member of the Pr
239239
- [Rename project](create-project.md)
240240
- [Rename team](../settings/rename-remove-team.md)
241241
- [Restore project](restore-project.md)
242-
- [Search across project(s)](../../project/search/overview.md)
242+
- [Search across project(s)](../../project/search/get-started-search.md)
243243
- [Set area paths](../settings/set-area-paths.md)
244244
- [Set favorites](../../project/navigation/set-favorites.md)
245245
- [Set iteration paths](../settings/set-iteration-paths-sprints.md)

docs/organizations/toc.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@
104104
- name: Process
105105
href: ./settings/work/inheritance-process-model.md
106106
- name: Search
107-
href: ../project/search/overview.md
107+
href: ../project/search/get-started-search.md
108108
- name: Get started
109109
href: ../get-started/index.yml
110110
- name: Marketplace & extensibility

docs/project/search/faq-search.md

+52-23
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,22 @@
11
---
22
title: FAQs and problem solutions for Search
3-
description: Learn the answers to frequently asked questions (FAQs) and troubleshooting info about Search in Azure DevOps Server and TFS.
3+
description: Learn the answers to frequently asked questions (FAQs) and troubleshooting information about Search in Azure DevOps.
44
ms.assetid: A78DC9CF-4ADD-46D7-9E25-D1A0764FCB06
55
ms.technology: devops-collab
66
ms.topic: conceptual
77
ms.author: sunar
88
author: chcomley
9-
ms.date: 07/23/2020
10-
monikerRange: '>= tfs-2017 < azure-devops'
9+
ms.date: 02/11/2021
10+
monikerRange: '>= tfs-2017'
1111
---
1212

1313
# Troubleshoot search
1414

15-
[!INCLUDE [version-header-tfs-only](../../includes/version-header-tfs-only.md)]
15+
[!INCLUDE [temp](../../includes/version-tfs-2017-through-vsts.md)]
16+
17+
Find troubleshooting information and learn the answers to frequently asked questions (FAQs) about the Search function and extensions available for Azure DevOps.
18+
19+
::: moniker range=">= tfs-2017 < azure-devops"
1620

1721
<a name="no-search-box"></a>
1822

@@ -21,27 +25,31 @@ A:
2125
1. The search box is shown only in the context of a project page.
2226
Navigate to a project and check if the search box is displayed at the top right.
2327

24-
2. If the search box is not shown, verify that the extension is installed for the collection.
28+
2. If the search box isn't shown, verify that the extension is installed for the collection.
2529
If not, [install](administration.md#config-tfs) or [configure](administration.md#config-ts-azuredevops) the extension.
2630

2731
<a name="no-results-install"></a>
2832

2933
## Q: Why are no search results shown after installing or configuring Search?
3034
A:
31-
1. Wait until you're sure sufficient time has elapsed
32-
after installing or configuring Search. It typically takes
33-
less than one hour for Search to index a collection, but
34-
it may take up to 12 hours depending on the size and number of code files, work items, or wiki pages.
35+
1. Wait until you're sure sufficient time has elapsed after installing or configuring Search. It typically takes less than one hour for Search to index a collection. But, it may take up to 12 hours based on the size and number of code files, work items, or wiki pages.
3536

3637
2. If no results are shown after this period,
3738
[check indexing status](administration.md#check-index).
3839

3940
<a name="indexing-status-for-collections"></a>
4041

42+
## Q: Why is Code search what's provided when I'm in Work Item view?
43+
44+
A: You can toggle between Work Item and Code Search entities by using the picker next to the search box.
4145
## Q: How do I know if indexing was triggered for all the collections?
4246
A:
4347
* [Check indexing status](administration.md#check-index) separately for each collection.
4448

49+
## Q: When I search file:span, why does it return files with an extension?
50+
51+
A: File:span searches will fetch all files named span with the extension included. This behavior occurs because the most common scenario for users is to fetch the filename along with the extension. In case you don't want to see the extension, use the following search string: file:{filename} NOT file:{filename}.*
52+
4553
<a name="no-results-later"></a>
4654

4755
## Q: Why does Search stop working and no results are shown?
@@ -54,8 +62,8 @@ name of the server where Search is installed:
5462
- If the status returned is `200 - OK`, go to step 2.
5563
- If any other status is returned, [contact Support](https://developercommunity.visualstudio.com/spaces/21/index.html).
5664
- If you don't get a response, verify that the
57-
**elasticsearch-service-x64** service is running on
58-
the server where Search is configured. If the service
65+
**elasticsearch-service-x64** service runs on
66+
the same server as Search. If the service
5967
is stopped, start it and access the Search server again.
6068
If you still get no response, or a response other than
6169
`200 - OK`, [contact Support](https://developercommunity.visualstudio.com/spaces/21/index.html).<p />
@@ -71,15 +79,14 @@ name of the server where Search is installed:
7179

7280
3. Access the URL `http://SearchServer:9200/_cat/shards?v`
7381
from a web browser on a computer in the same domain as the server running Search.
74-
- Make a note of the values in the **Shard** column for the
82+
- Record the values in the **Shard** column for the
7583
rows with a **state** value of **unassigned** and [contact Support](https://developercommunity.visualstudio.com/spaces/21/index.html).<p />
7684

7785
<a name="unexpected-results"></a>
7886

7987
## Q: Why doesn't Search show the expected results?
8088
A:
81-
1. If the files were added in the last few minutes,
82-
wait for 10 minutes or so while they are indexed.
89+
1. If the files were added in the last few minutes, wait for about 10 minutes while they're indexed.
8390
2. [Check indexing status](administration.md#check-index) for the collection.
8491
3. If the files are still not shown in the results,
8592
[reindex the repository or collection](administration.md#re-index)
@@ -95,10 +102,10 @@ A:
95102

96103
<a name="no-search-post-upgrade"></a>
97104

98-
## Q: Why doesn't Search work post upgrade to Azure DevOps Server 2019 Update 1?
105+
## Q: Why doesn't Search work after upgrading to Azure DevOps Server 2019 Update 1?
99106

100-
A: If the search is set up on a separate (remote) server and source version is TFS 2018 Update 2 (or higher), verify that [these upgrade steps](administration.md#upgrading-search) were followed.
101-
If not, then run [this script](https://github.com/microsoft/Code-Search/blob/master/Azure_DevOps_Server_2019/Troubleshooting/Repair-Search.ps1) to fix the issue.
107+
A: If Search is on a separate remote server and the source version is TFS 2018 Update 2 or higher, verify that the user followed [these upgrade steps](administration.md#upgrading-search).
108+
Run [this script](https://github.com/microsoft/Code-Search/blob/master/Azure_DevOps_Server_2019/Troubleshooting/Repair-Search.ps1) to fix the issue, if the upgrade steps weren't followed.
102109

103110
## Partial results in code search
104111

@@ -110,17 +117,29 @@ I see a **Showing partial code results** banner in code search.
110117

111118
### Explanation
112119

113-
You're likely to encounter this scenario when your code base has one or more large repositories (larger the repository, more the number of documents to search). So, when you search such repositories, the request may take more time to process from all documents in the index and cause the search request to time out on the index. In such a case, you may see partial search results along with **Showing partial code results** banner as shown above before the request times out.
120+
Your code base might have one or more large repositories. The larger the repository, the higher number of documents that get searched. When you search large repositories, the request could take more time to process, which can cause the search request to fail. In this case, you may see partial search results along with the **Showing partial code results** banner, per the previous image.
114121

115122
### Recommendation
116123

117-
You could try the following alternatives as applicable for your scenarios
124+
You could try the following alternatives, as applicable to your scenario:
118125

119-
* Try to scope your query by using filters to narrow down to a "repo" or a "path".
120-
* See if you can narrow down your query to avoid scenarios that require matching too many terms while searching.
126+
* Scope your query by using filters to narrow down to a "repo" or a "path".
127+
* See if you can narrow your query to avoid scenarios that require matching too many terms.
121128

122129
For example, while looking for methods like App_App1, App_App2, and so on, instead of searching for ```a*``` try searching for ```app*``` instead. (```a*``` will match many more terms than ```app*```).
123130

131+
::: moniker-end
132+
133+
::: moniker range=" <= azure-devops"
134+
135+
## Q: How do I search company-wide for published internal NuGet packages?
136+
137+
A: Go to [Discover in Azure DevOps(https://aka.ms/discover), enter your query and search, and then choose the **Packages** pivot. You can also navigate from your organization's landing page. At the top left of your screen, there's a link to the Microsoft enterprise search page below the Azure DevOps logo.
138+
139+
## Q: Is Azure DevOps Search extensible?
140+
141+
A: Currently, no, but you can submit a new feature request in the [Developer Community](https://developercommunity.visualstudio.com/spaces/8/index.html).
142+
124143
## Wildcard search
125144

126145
### Problem
@@ -135,8 +154,18 @@ while ```get*``` shows **109,134** results.
135154

136155
### Explanation
137156

138-
Let's understand how wildcard search works in the given scenario. Let's say you search for ```app*```. In the backend, the wildcard `*` is expanded to match any character sequence after the term ```app```. For example, ```app*``` might expand to ```app, app0, app01, .., apple```. This expansion takes place for the first 100 expanded terms only. Post the expansion, all the files associated with the 100 expanded terms are displayed on the search results page. In this case, there is a possibility that ```application``` may not be within the first 100 expanded terms therefore, you may not find files with the search term ```application``` in the search results. This is one of the reasons why you may see fewer search results for the term ```ge*``` as compared to ```get*```.
157+
Let's say, you're searching for ```app*```. In the backend, the wildcard `*` expands to match any character sequence after the term ```app```. For example, ```app*``` might expand to ```app, app0, app01, .., apple```. The expansion takes place for the first 100 expanded terms only. Post expansion, all the files associated with the 100 expanded terms display on the search results page. There's a possibility that ```application``` may not be within the first 100 expanded terms so, you may not find files with the search term ```application``` in the search results. You may see fewer search results for the term ```ge*``` as compared to ```get*```.
139158

140159
### Recommendation
141160

142-
This is to ensure the search results remain performant and you can find the most meaningful results as fast as possible. The expectation is that in case of wildcard search you can type more in the search bar to scope the results to a meaningful and actionable chunk.
161+
Ensuring that you can find the most meaningful and actionable results as fast as possible, enter more criteria in the search bar.
162+
::: moniker-end
163+
164+
## Related articles
165+
::: moniker range=" azure-devops"
166+
- [Export access levels audit log](../../organizations/security/export-users-audit-log.md)
167+
::: moniker-end
168+
169+
::: moniker range=">= tfs-2017 < azure-devops"
170+
- [Get started with Search](get-started-search.md)
171+
::: moniker-end

0 commit comments

Comments
 (0)