Подключение таблицы к DataTable

Способы подключения

Подключить таблицу к DataTable можно двумя способами: в режимах Add & update (Добавление и обновление) и Lookup (Поиск). Для создания подключения необходимо иметь права владельца, администратора или редактора таблицы.

• Режим Add & update mode (Добавление и обновление). При подключении такого типа в таблицу передаются подмножества данных из DataTable. Вы можете использовать фильтр, чтобы ограничить подмножество данных, сопоставить данные DataTable со столбцами таблицы и контролировать перенос изменений из DataTable в таблицу. Чтобы таблица соответствовала критерию фильтрации, заданному при подключении, используйте параметры Add (Добавлять), Update (Обновлять) и Remove (Удалять). Таблица всегда будет содержать актуальные данные, поступающие из DataTable.
   
• Режим Lookup (Поиск). При подключении такого типа данные из DataTable объединяются с данными в таблице на основе уникального идентификатора (аналогично функции VLOOKUP). Вам нужно будет выбрать уникальный идентификатор для поиска значений в объекте DataTable, а также указать, какие столбцы следует сопоставлять с DataTable. Так вы сможете использовать DataTable как источник для процессов, запускаемых в таблице.
  
  В режиме поиска изменения, внесённые в таблицу, будут заменены данными из DataTable. Таким образом, содержание таблицы всегда будет соответствовать объекту DataTable. При этом сопоставленные столбцы будут заблокированы, чтобы другие пользователи не могли изменять данные.
   

Изменения, внесённые в таблицу, не синхронизируются с объектом DataTable.

Режим обновления и добавления

Шаг 1. Выбор таблицы

1. Перейдите к таблице, которую хотите подключить к DataTable, и откройте меню Подключения, а затем выберите Подключить к DataTable.

2. Выберите Add & update mode (Режим обновления и добавления).

3. Выберите объект DataTable, который хотите использовать. В списке будут представлены созданные вами объекты DataTable, а также объекты, к которым вам был предоставлен доступ в качестве администратора или наблюдателя. 

Шаг 2. Фильтрация данных

Отфильтруйте данные, которые будут поступать из DataTable в таблицу. Таблица может содержать до 500 000 ячеек и 20 000 строк; при этом в объекте DataTable, скорее всего, будет намного больше данных.

Необходимо задать хотя бы одно условие фильтрации; всего в подключении их может быть до десяти. Вы можете фильтровать данные, используя различные условия в зависимости от типа поля.

1. Используйте опцию All (Все) в разделе Sync records that meet all the conditions (Синхронизировать записи, отвечающие всем условиям), чтобы требовать выполнения всех условий, или выберите опцию At least one condition (Хотя бы одно условие). Выберите +Add New Condition (Добавить новое условие), если хотите задать ещё одно условие. 
2. Настроив фильтры, нажмите кнопку Next (Далее). 

Шаг 3. Сопоставление данных из DataTable с таблицей

1. Щёлкните переключатель рядом с полем, которое хотите сопоставить, и выберите столбец таблицы, в который требуется передавать данные. Имена полей в DataTable и имена столбцов в таблице могут не совпадать. 
   При создании подключения в таблицу добавляется новый столбец с названием "Data Table Record ID" (Идентификатор записи DataTable). Этот идентификатор используется для отслеживания строк, добавленных из DataTable. По умолчанию этот столбец заблокирован и скрыт. При изменении значений в этом столбце соответствующая строка перестанет обновляться.
2. Нажмите Next (Далее).

Шаг 4. Выбор типа подключения

1. Выберите тип подключения: 
   Add rows as they are added to the DataTable (Добавлять строки в таблицу по мере их добавления в DataTable);
   Update rows as they change in the DataTable (Обновлять строки по мере их изменения в объекте DataTable);
   Remove rows that longer match the filter conditions (Удалять строки, которые больше не соответствуют условиям фильтра).
2. Затем нажмите Next (Далее).

Шаг 5. Проверка параметров подключения

Вы увидите информацию о новом подключении. Нажмите Back (Назад), чтобы изменить параметры подключения. 

Нажмите кнопку Create (Создать), когда подключение будет настроено должным образом. В таблицу будут автоматически добавлены данные, соответствующие условиям фильтра. Это может занять несколько минут; возможно, вам потребуется обновить таблицу. 

Режим поиска

Шаг 1. Настройка подключения

1. Перейдите к таблице, которую хотите подключить к DataTable, и откройте меню Подключения, а затем выберите Подключить к DataTable.
2. Выберите Lookup mode (Режим поиска).
3. Выберите объект DataTable, который хотите использовать. В списке будут представлены созданные вами объекты DataTable, а также объекты, к которым вам был предоставлен доступ в качестве администратора или наблюдателя.

Шаг 2. Выбор уникального идентификатора

1. Выберите уникальный идентификатор для сопоставления строк таблицы с записями в DataTable. Выбранное поле DataTable должно содержать уникальные значения. Как правило, это строка цифр и букв из набора данных, например код магазина, адрес электронной почты сотрудника или идентификатор записи в базе данных. Если в DataTable есть несколько записей с одинаковыми значениями уникального идентификатора, при синхронизации будут использоваться данные из первой найденной записи. В большинстве случаев это будет наименьший идентификатор записи DataTable.
2. Сопоставив уникальные идентификаторы, нажмите Next (Далее).

Шаг 3. Сопоставление полей

1. Щёлкните переключатель рядом с полями, которые хотите сопоставить, и выберите столбец таблицы, в который требуется передавать данные. Необходимо выбрать хотя бы одно поле. Имена полей в DataTable и имена столбцов в таблице могут не совпадать.
2. Нажмите Next (Далее).

Шаг 4. Проверка параметров подключения

Вы увидите информацию о новом подключении. Нажмите Back (Назад), чтобы изменить параметры подключения. 

Выберите Create (Создать), чтобы завершить настройку подключения. В DataTable запустится автоматический процесс поиска уникальных идентификаторов. Это может занять несколько минут; возможно, вам потребуется обновить таблицу.