CatalogManager.<Catalog name>.FindByDescription


FindByDescription(<Description>, <ExactMap>, <Parent>, <Owner>)


<Description> (required)

Type: String.
String containing the search description.

<ExactMap> (optional)

Type: Boolean.
Determines search by exact mapping mode.
The search will be successful if the search string: matches the left part of the description when the parameter value is False; or matches the full description (excluding trailing spaces) when the parameter value is True.
Default value: False.

<Parent> (optional)

Type: CatalogRef.
Parent to be searched. If it isn't specified the search is performed in the whole catalog.

<Owner> (optional)

Type: CatalogRef.
Owner, within which you should perform searching. If it isn't specified the search is performed in the whole catalog.

Returned value:

Type: CatalogRef.; Undefined.
Reference to a found catalog item.
If no element with the required description exists, an empty reference will be returned.
If description is not set (length = 0) and search is carried out by full match, Undefined will be returned.


Searches for an item by its description.


Server, thick client, external connection, Mobile application (server).


If there are several items with the specified description, only one of them is found.


StringOfDescription = "USD";
Currencies = Catalogs.Currencies;
FoundReference = Currencies.FindByDescription(StringOfDescription);
FoundReference = Currencies.EmptyRef() Then
    Message("There is no """ + StringOfDescription + """ currency.");


1C:Enterprise Developer's Community