CatalogManager.<Catalog name>.FindByDescription

Syntax:

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

Parameters:

<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.

Description:

Searches for an item by its description.

Availability:

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

Note:

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

Example:

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

    

1C:Enterprise Developer's Community