Обновление столбцов с раскрывающимся списком с помощью рабочих процессов Bridge

Что нужно для начала работы

• В Smartsheet
  • Идентификатор листа
  • исходный столбец, содержащий значения раскрывающегося списка (в нашем примере столбец называется Source Values (Исходные значения));
  • целевой столбец, который Bridge может обновлять (в нашем примере столбец называется Dropdown (Раскрывающийся список)).
• В мосту
  • интеграция со Smartsheet;
  • Триггер рабочего процесса Bridge: Smartsheet > При изменении значений столбцов
  • модули рабочих процессов Bridge:
    • Интеграции > Smartsheet > Получить таблицу
    • Интеграции > Smartsheet > Обновить столбец
    • Утилиты > Управление массивами > Извлечение поля из массива
• Необязательно: другая платформа-источник по вашему выбору.

Начало работы

Чтобы создать этот рабочий процесс в Bridge, аутентифицируйте интеграцию Smartsheet для своего рабочего пространства Bridge. 

При построении рабочего процесса держите таблицу и рабочий процесс Bridge открытыми в двух отдельных вкладках. Это облегчит работу.

Построение базовой модели рабочего процесса

1. Создайте новый рабочий процесс в Bridge. 
2. Используйте панель в построителе рабочих процессов, чтобы добавить три модуля в следующем порядке.
   1. Интеграции > Smartsheet > Получить таблицу
   2. Утилиты > Управление массивами > Извлечение поля из массива
   3. Интеграции > Smartsheet > Обновить столбец
3. Сохраните рабочий процесс.

Вот что вы должны увидеть в рабочем процессе, когда закончите:

Brandfolder Image

Настройка триггера рабочего процесса

1. Выберите модуль Trigger.
2. Выберите страницу интеграции.

3. Найдите Smartsheet в списке интеграций.

   Вы можете использовать опцию «Подключено» под логотипом Bridge, чтобы получить список только интеграций, аутентифицированных для этого рабочего пространства.

4. Разверните строку «Триггеры».
5. Выберите Добавить в триггеры.
6. Заполните следующие поля.
   • Имя триггера: создайте собственную метку для триггера.
   • Идентификатор листа: вставьте идентификатор исходного листа (откуда мы копируем значения).
   • Тип события: выберите при изменении значений столбцов. 
   • Имя или идентификатор столбца: введите имя столбца Smartsheet, который является источником значений в раскрывающемся списке.
   • Выберите рабочий процесс: выберите новый рабочий процесс, который вы только что создали, из выпадающего списка.
7. Выберите «Сохранить».

8. Вернитесь к рабочему процессу.

   Если вы хотите вернуться на исходную вкладку, обновите страницу, чтобы увидеть триггер.

Настройка модулей рабочего процесса

Этот рабочий процесс запускают действия в таблице. Как только этот рабочий процесс обнаруживает триггер, он выполняет действия на том же листе. Используйте ссылки на данные среды выполнения (журнал запуска) из триггера для заполнения модулей Smartsheet.

Шаг 1. Настройка модуля Get Sheet

Модуль Get Sheet извлекает данные из таблицы, которая запустила рабочий процесс. 

При запуске модуля Get Sheet Bridge извлекает данные листа и помещает их в журнал выполнения рабочего процесса в виде объектов. Объекты — это элементы, возвращаемые API, которые содержат значения полей, относящихся к данному объекту. 

Массив — это набор объектов и соответствующие им поля. Вот пример того, как массив из 13 строк из модуля Get Sheet может выглядеть в журнале запуска. Развёрнута информация о первой строке.

Brandfolder Image

1. В поле Идентификатор листа введите значение {{runtime.sheetID}}. 
2. Сохраните рабочий процесс.
3. В таблице добавьте новое значение в столбец, содержащий исходные значения (в любую строку).
4. Сохраните таблицу.

Шаг 2. Обнаружение данных, внесённых в рабочий процесс

Вернитесь в Bridge, чтобы скопировать данные, необходимые для модуля Extract Field from Array.

1. Откройте журнал запуска. 
2. Обновите панель журнала запуска.
3. Чтобы просмотреть подробные сведения о триггере и модулях рабочего процесса, разверните верхнюю запись.
4. Чтобы увидеть возвращенные данные, разверните строку Smartsheet: Get Sheet. 
5. Разверните строку листа.
6. Найдите запись строк. Выглядит так: rows: Array [#].
7. В правой части строки выберите .
8. Выберите Скопировать ссылку на данные.

Шаг 3. Настройка модуля Extract Field from Array

Модуль Извлечь поле из массива позволяет извлекать значения из объектов массива. В этом модуле вы можете перечислить только значения из этого поля. 

В этом примере Bridge извлекает значение поля Source Values. Bridge извлекает все значения из столбца «Исходные значения» на листе и превращает их в список.

1. Выберите модуль «Извлечь из массива». 
2. В поле Array вставьте ссылку на данные.  
3. В поле «Ключ» укажите столбец, который вы хотите включить в список. 
4. Когда вы указываете столбец, который хотите превратить в список, используйте следующий формат: ячейки. [Имя столбца] .value. Например: cells.Source Values.value.
5. В поле Вывод еще раз проверьте, выбран ли массив. 
6. Сохраните рабочий процесс.
7. В таблице добавьте новое значение в столбец, содержащий исходные значения (в любую строку).
8. Сохраните таблицу.

Шаг 4. Обновление столбца

Модуль «Обновить столбец» использует созданный вами список для заполнения этих значений в раскрывающемся списке столбца в настройках столбца. При каждом запуске рабочего процесса Bridge создает последний список и обновляет его для этого столбца таблицы.

1. В поле Идентификатор листа введите значение {{runtime.sheetID}}.
2. Получите идентификатор столбца. 
3. Вернитесь на панель редактирования модуля «Обновить столбец».
4. В поле «Идентификатор столбца» вставьте ссылку на данные.
5. В поле «Имя столбца» введите имя столбца, содержащее значения из выпадающего списка.
6. В поле «Тип» выберите «Выпадающий список» (одиночный выбор) или «Выпадающий список» (множественный выбор).
7. В поле Values вставьте массив, созданный модулем Extract Field from Array во время последнего запуска. 
8. Сохраните рабочий процесс. 

Чтобы получить ссылку на данные для модуля Extract Field from Array, выполните следующие действия.

1. Откройте панель Run Log. 
2. Чтобы вернуться к списку запусков, выберите «Все запуски».
3. Обновите журнал запуска.
4. Разверните запись о последнем запуске.
5. Разверните окно Управление массивами: извлеките поле из строки массива.
6. В правой части записи результатов выберите .
7. Выберите Скопировать ссылку на данные. 
8. Сохраните рабочий процесс.

Альтернативные варианты

Для создания списка значений необязательно использовать одну и ту же таблицу или даже Smartsheet. Если вы хотите извлечь значения из выпадающего списка из другого источника, триггер и первый модуль рабочего процесса должны отличаться в зависимости от вашего варианта использования. 

Вот как можно настроить рабочий процесс в этом случае.

• Используйте список из столбца другой таблицы. Для этого необходимо изменить триггер, чтобы он реагировал на другую таблицу. Необходимо также обновить поля «Идентификатор листа» и «Идентификатор столбца» в модуле «Обновить столбец». 
• Используйте список из раздела Управление ресурсами или Brandfolder. Вместо этого вы можете отреагировать на определенные изменения в управлении ресурсами или папке Brandfolder, чтобы создать список значений из этой системы. Замените триггер, приведённый в примере, соответствующим триггером для одной из этих интеграций. Затем замените модуль Get Sheet модулем, который загружает данные в рабочий процесс. 
• Используйте триггер «Расписание». При использовании этого триггера вам вообще не нужно реагировать на изменения, поскольку он выполняет за вас следующее:
  • Извлекайте данные и внедряйте их в рабочий процесс, а также 
  • будет обновлять раскрывающийся список раз в день, неделю или месяц.