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

Предварительные условия

Для использования DataTable необходимо следующее:

• иметь разрешения на работу с таблицами, которые вы собираетесь подключить к объекту DataTable, не ниже уровня владельца или администратора;
• DataTable must be a premium application available for you.
• Ваш системный администратор Smartsheet должен предоставить вам разрешения на работу с премиум-приложением DataTable в разделе Управление пользователями.

Чтобы проверить свой уровень доступа, войдите в DataTable здесь. Зайдите на страницу DataTable Marketplace, чтобы узнать, как связаться с торговым представителем для получения информации о расценках.

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

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

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

В режиме поиска изменения, внесённые в таблицу, будут заменены данными из DataTable. При этом сопоставленные столбцы будут заблокированы, чтобы другие пользователи не могли изменять данные.
К одному объекту DataTable можно подключить до 1000 таблиц.

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

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

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

1. Перейдите к таблице, которую хотите подключить к DataTable, и откройте меню Подключения, а затем выберите Подключить к DataTable.
2. Подключить к DataTable
3. 2. Выберите Add & update mode (Режим обновления и добавления).
4. Выберите объект 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. Toggle any combination of behaviors: 
   • Добавляйте строки по мере их добавления в DataTable
   • Обновляйте строки по мере их изменения в DataTable
   • Удалять строки таблицы, не соответствующие условиям фильтрации
2. Затем нажмите Next (Далее).

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

A summary of the connection you've built displays.

1. Нажмите Back (Назад), чтобы изменить параметры подключения.
2. Нажмите кнопку Create (Создать), когда подключение будет настроено должным образом.

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

Режим поиска

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

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

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

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

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

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

   Необходимо выбрать хотя бы одно поле. Имена полей в DataTable и имена столбцов в таблице могут не совпадать.

2. Нажмите Next (Далее).

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

A summary of the connection you've built displays.

• Нажмите Back (Назад), чтобы изменить параметры подключения.
• Выберите Create (Создать), чтобы завершить настройку подключения.

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