Contents

Metadata search in Visual Studio

Metadata search in Visual Studio

This article describes how to use metadata search to search your code and metadata for arbitrary patterns and content.

Given the large volume of the code base and metadata, it is often necessary to find things in the code that meet a certain criteria. For example, you might not know the name of the metadata element that contains the pattern or meets the criteria. Metadata search is exposed in Visual Studio through two user interfaces: the Metadata Search tool window and the Navigate To window.

Metadata search tool window

You can access the Metadata search tool window from the Dynamics 365 > Metadata Search menu command. Enter your search query to start the search. Results will start populating in the window asynchronously as you type. You can double-click any result line to navigate to the corresponding X++ code or metadata that matches your search query.

/2023-01-01-metadata-search-in-visual-studio/posted_metasearch.png
Metadata search tool window

You can also select one or more results, right-click, and then add these elements to a project. You don’t need to wait for the search to complete before you start interacting with the search results.

/2023-01-01-metadata-search-in-visual-studio/addnewproject_metasearch.png
Add to new project from metadata search

The Navigate To window is invoked using the Ctrl+‘,’ (the comma character) shortcut keys. Pressing Ctrl+‘,’ displays the query entry box in top-right corner of the Visual Studio main document window. You can also access the Navigate To window from the Visual Studio Edit menu. Enter you search query and see the results appear as you type. A progress indicator will stop when the search is complete. You don’t need to wait for the search to complete to start interacting with the results.

/2023-01-01-metadata-search-in-visual-studio/typeform_metasearch.png
Navigate To window

Search query syntax

This section describes the search query syntax and provides example queries.

Syntax

The search query is a search string that consists of a set of filters in this general form:

1
<filter_1>:<filter_1_value> [<filter_2>:<filter_2_value> … [ <filter_N>:<filter_N_value>]]

/2023-01-01-metadata-search-in-visual-studio/syntax.png
The syntax for searching in the Metadata searc

Where <filter_i> is one of the acceptable filter names, and <filter_i_value> are comma separated (and possibly quoted) filtering values.

Filter names

  • Name: Filter by element name. This is the default filter, meaning if you just type a filter value, it is assumed to be an element name. Each comma-separated value is an acceptable element name.

  • Type: Filter by element type. Each comma-separated value should be the name of an element or subelement type (root type or subtype) (that is, table, class, field). Logic of filtering is:

    (roottype_1 OR roottype_2 OR … OR roottype_N) AND (subtype_1 OR subtype_2 OR … OR subtype_N)

  • Model: Filter by model name. Each comma-separated value should be the name of a model in your application.

  • Property: Apply property filters. Each comma-separated value should be in the form property_name=property_value.

  • Code: Filter using code snippets, use quotes around code snippets. The matching source code is the elements that contain the specified code snippet.

You can get help about using filter and filter syntax by opening the drop-down menu available in the search box.

/2023-01-01-metadata-search-in-visual-studio/metadatasearchfilter.jpg
Metadata search filter button

Examples

Query stringWhat it does
TrvExpTableIf the token is by itself, it is assumed to be the name. So this will find everything in the application that has “TrvExpTable” in the name.
type:form ccountFinds all forms that have “ccount” in their names.
type:form property:formtemplate=listpageFinds all forms that contain the property “FormTemplate” equal to ‘ListPage’.
type:table,formDesign property:"WorkflowDataSource=TrvExpTable"Finds formDesign nodes under tables, nothing would be found.
type:form,formmenufunctionbuttoncontrol property:Text=@SYS311998Finds all menu function button controls with the Text property equal to (a label) ‘@SYS311998’.
type:table,method name:insertFinds tables with a method containing “insert” in the method name.
type:table,tableindex name:ExportFinds tables with an index name containing the word “Export”.
type:table,tableindexfield name:xpNumFinds table indexes with “xpNum” in the index field name.
type:table,tablefieldgroup name:EPNewFinds FieldGroups (in tables) containing ‘EPNew’ in their names.
type:form,formgridcontrol property:allowedit=no,heightmode=columnFinds form grid controls, with properties allowedit equal to “no” and heightmode equal to “column”.
type:form,formtabcontrol property:arrangeMethod=Vertical,ViewEditMode=view,WidthMode=AutoFinds form tab controls, with properties arrangeMethod equal to “Vertical” and ViewEditMode equal to “view” and WidthMode equal to “Auto”.
type:form,formDesign property:"WorkflowDataSource=TrvExpTable"Finds all forms with the “WorkflowDataSource” property in the FormDesign node set to the value “TrvExpTable”.
model:”Application Suite” type:formdesign property:style=simplelistdetailFind all forms in Application Suite model that has the style property set to simpleListDetail in the FormDesign node.
code:"return null"Finds all places in the source code that contains “return null”.
code:"element.lock()" type:formFinds all places in the forms source code that contain the snippet “element.lock()”.
code:"insert" type:table,formFinds all places in the source code of either forms or tables that contain “insert”.
code:"public display" type:form,methodFinds all form methods that contain the code “public display”.
type:formbuttoncontrol property:text=Finds all form Button Controls that have empty text properties.