> For the complete documentation index, see [llms.txt](https://truebim.gitbook.io/truebim-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://truebim.gitbook.io/truebim-guide/theory/families/lookup-tables.md).

# Таблицы выбора

//theory/families/lookup-tables

## Введение

Таблицами выбора называются таблицы подбора данных по ключевым параметрам. Таблицы выбора доступны для загрузки в файл семейства в формате **.csv (Comma-Separated Values)**. Для создания таблиц выбора подходит любой редактор таблиц в том числе и Microsoft Excel. Параметры в таблицах выбора разделим на два типа: ключевые и искомые. Ключевые параметры - параметры по которым осуществляется поиск в таблице выбора. Искомые параметры - параметры, поиск которых осуществляется в таблице выбора.

{% hint style="info" %}
До версии Revit 2018.2 искомые и ключевые параметры не могли иметь тип данных - текст, с версии Revit 2018.2 в таблицах выбора можно использовать текстовые параметры для поиска значений.
{% endhint %}

## Структура

Таблица выбора представляет собой набор данных, разделенных специальными символами - разделителями. Первая строка зарезервирована для указания наименований параметров и типов данных. Первый столбец зарезервирован, для наименования типоразмера. В ячейках на пересечении указываются значения параметров для соответствующих типоразмеров.

![](https://3381579655-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4O_oE10hmC5cVkn2MS%2F-MSVUlHDIMBwEdsJoizb%2F-MSVa_l7Kqj3jmTvw3Jf%2Fimage.png?alt=media\&token=bb6627e0-2378-41aa-83f8-6786d0523cd1)

{% hint style="warning" %}
Обратите внимание, что столбцы ключевых параметров должны стоять раньше столбцов искомых параметров, в ином случае корректный поиск по таблице выбора будет не возможен.
{% endhint %}

## Составление

### Параметры

Для задания параметра нужно указать три его характеристики: наименование, [тип данных](/truebim-guide/theory/parameters/data-types.md) и единицы измерения. Три эти характеристики разделяются двумя знаками #.

### Типы

Для задания типов достаточно просто указать новое имя типа в новой строке и заполнить значения всех параметров для этого типа.

## Загрузка

Для импорта таблицы выбора в семейство необходимо вызвать окно "Управление таблицами выбора" в окне "Типоразмеры в семействе". В открывшемся окне воспользоваться функцией "Импорт" и указать путь до требуемой таблицы выбора.

![](https://3381579655-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4O_oE10hmC5cVkn2MS%2F-MSSHJIEfq-AUzxx_alZ%2F-MSSJ_ipgfnvuloqgdJO%2Fimage.png?alt=media\&token=fd767fff-09f0-475f-9aac-76f0f2f52729)

После этого таблица выбора будет загружена в семейство. Далее для обращения к таблице выбора в Revit предусмотрено два варианта. Первый - объявить таблицу выбора с помощью текстового параметра, в качестве значения которого указывается полное имя загруженной таблицы выбора. В дальнейшем ссылаться на таблицу выбора можно будет указывая имя этого параметра. Второй - объявлять таблицу её полным именем при каждом обращении к таблице выбора.

{% hint style="info" %}
Рекомендуется использовать вспомогательный параметр, так как это позволит сократить наименование таблицы выбора в формулах и позволяет заменить таблицу выбора на другую изменив её только в специальном параметре, а не в каждом обращении.
{% endhint %}

## Обращение

Для обращения к таблице выбора в семействах Revit предусмотрена функция "**size\_lookup**". Данная функция имеет следующий синтаксис: **size\_lookup(**X,"Y",Z,A,B....,J**).**

| №   | Составляющая | Смысл                                                                     |
| --- | :----------: | ------------------------------------------------------------------------- |
| 1   |       X      | Имя параметра ссылающийся на таблицу выбора или имя таблицы выбора.       |
| 2   |       Y      | Имя искомого параметра так, как оно определено в таблице выбора.          |
| 3   |       Z      | Значение параметра, если не будет найдено искомое по ключевым параметрам. |
| 4   |       A      | Первый ключевой параметр.                                                 |
| 5   |       B      | Второй ключевой параметр.                                                 |
| ... |      ...     | ... ключевой параметр.                                                    |
| n   |       J      | Последний ключевой параметр.                                              |

![](https://3381579655-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M4O_oE10hmC5cVkn2MS%2F-MSSDC8R4LsKpem95tbS%2F-MSSH2hgtqw0t4f0Pyab%2Fimage.png?alt=media\&token=8956c73d-b8b7-436b-8b4c-44386e829bb8)

{% hint style="warning" %}
При обращении к функции таблицы выбора ключевые параметры должны указываться в той же последовательности, что и в таблице выбора.
{% endhint %}

{% hint style="danger" %}
Имена ключевых параметров в семействе не обязаны совпадать по наименованию, но обязаны совпадать по типу данных с ключевыми параметрами в таблице выбора.
{% endhint %}