Операции над таблицами

Описание

Таблицы используются для получения более сложно организованных данных, чем списки, (например, список товаров для интернет-магазина, где построчно представлены разные данные: название, цена, описание и тд.).

Как добавить список в проект?

Как добавить экшен в проект?

Через контекстное меню Добавить действие → Таблицы → Операции над таблицей

Либо воспользуйтесь умным поиском.

Для чего это используется?

• Работа с комплексом данных

• Добавление и получение элементов таблицы

• Удаление строк, столбцов и дублей

• Привязка к файлу

• Получение количества строк и столбцов

Как работать с экшеном?

Взять столбец

Положить значения заданного столбца в список

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Задаём столбец или переменную.

4. Список в который положим все значения столбца.

 Пример

Положить все значения столбца B из Таблицы 1 в Список 1

Таблица 1

До обработки

После обработки

Значения заданного столбца не удаляются после обработки

Список 1

Взять строки

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

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Критерии строк (можно указать переменную) :
   a) Все
   b) Не содержит текст
   c) Неудовлетворяющие регулярному выражению
   d) Первую
   e) Под номерами
   f) Случайную
   g) Содержит текст
   h) Удовлетворяющие регулярному выражению

4. Удалять строки после обработки.

5. Положить результат в список или переменные.

 Пример

Взять случайные строки из Таблицы 1 и положить в переменные с удалением.

Таблица 1

До обработки

После обработки

Переменные

Переменная пустая так как таблица содержит только столбцы A и B

Добавить список

Положить значения из списка в заданный столбец.

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Задаём столбец или переменную.

4. Список со значениями.

 Пример

Взять значения и списка 1 и положить в столбец D таблицы 1

Список 1

Таблица 1

До обработки

После обработки

Значения из списка не удаляются

Добавить строку

Добавляем строку в таблицу.

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Вставляем статический текст или переменную.

4. Важное примечание

 Пример

Добавить строку своего текста в разные столбцы.

Таблица 1

До обработки

После обработки

Строки всегда добавляются в конец таблицы

Записать ячейку

Добавить текст в конкретную ячейку.

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Задаём статические координаты ячейки или через переменные.

4. Вставляем статический текст или переменную.

 Пример

Добавить текст и заданную ячейку

Таблица 1

До обработки

После обработки

Строки всегда добавляются в конец таблицы

Получить количество столбцов

Сколько столбцов содержит таблица

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Переменная для получения результата.

 Пример

Получить количество столбцов Таблицы 1 в переменную

Содержание Таблицы 1

Получаем результат в переменную kolichestvo_strok

Получить количество строк

Сколько строк содержит таблица

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Переменная для получения результата.

 Пример

Получить количество строк Таблицы 1 в переменную

Содержание Таблицы 1

Получаем результат в переменную kolichestvo_strok

Привязать к файлу

Привязка таблицы к файлу в ходе выполнения проекта.

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Выбираем файл или указываем переменную, содержащую путь к файлу.

4. Если файл отсутствует по указанному пути, Zennoposter автоматически создаст его.

 Пример

Привязать таблицу 1 к заданному файлу

Таблица 1 будет привязана к соответствующему файлу

Прочитать ячейку

Получить значения из заданной ячейки

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Задаём статические координаты ячейки или через переменные.

4. Переменная для результата.

 Пример

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

Содержание таблицы 1

После выполнения экшена получаем результат в переменную yacheika

Сортировать таблицу

Сортировка элементов таблицы по убыванию или возрастанию.

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Zennoposter автоматически определит столбцы, содержащие значения и предложит выбор.

4. Использовать принцип как у чисел.

5. Задаём тип сортировки по убыванию или возрастанию.

 Пример

Отсортировать по убыванию значения всех столбцов таблицы 1

Таблица 1

До обработки

После обработки

Сохранить в файл

Сохранение таблицы в файл в ходе выполнения проекта

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Выбираем файл или указываем переменную, содержащую путь к файлу.

 Пример

Сохранить значения таблицы 1 в файл

Содержание таблицы 1

После выполнения в файл будут записаны все значения

Удалить дубли

Удаляем повторяющиеся значения в таблицы

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Zennoposter автоматически определит столбцы, содержащие значения и предложит выбор.

 Пример

Удалить все дубли в таблице 1

Таблица 1

До обработки

После обработки

Удалить столбец

Целиком удаляет заданный столбец таблицы

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Задаём столбец или переменную.

 Пример

Удалить столбец B из таблицы 1

Таблица 1

До обработки

После обработки

Удалить строки

Удаляет заданные строки во всех столбцах

1. Выбираем таблицу с которой будем работать.

2. Указываем функцию.

3. Критерии строк (можно указать переменную) :
   a) Все
   b) Не содержит текст
   c) Неудовлетворяющие регулярному выражению
   d) Первую
   e) Под номерами
   f) Случайную
   g) Содержит текст
   h) Содержащие только пробельные символы
   i) Удовлетворяющие регулярному выражению

 Пример

Удалить третью строчку из таблицы 1

Таблица 1

До обработки

После обработки

Третья строка была удалена целиком

Рекомендации при работе с таблицами

• Не привязывайте к таблице очень большие файлы в сотни мегабайт без опции «Сохранять изменения», особенно если у Вас мало оперативной памяти.

• При использовании таблицы, привязанной к одному файлу в нескольких шаблонах, используйте один разделитель. Если в одном шаблоне столбцы разделены через ;, а в другом через - то произойдет ошибка.

• Если шаблон работает в многопоточном режиме и Вам нужно, чтобы каждый поток работал со своей строкой, включите опцию «Сохранять изменения» и берите данные из таблицы с включенной функцией “Удалить после взятия“.

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

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

Пример использования

Собрать со страниц название нужных товаров в список и добавить их из списка в таблицу для дальнейшего использования.

1. Загружаем страницы.

2. Собираем необходимые значения в список.

3. Создаём таблицу.

4. Добавляем экшен и указываем функцию добавить список.

5. Указываем список и столбец в который сохраним значения.

Полезные ссылки

1. Таблица

2. Google таблицы

3. Список

4. Операции над списком

5. Переменные проекта

6. Тестер регулярных выражений

Использование

Таблицы используются для получения более сложно организованных данных, чем списки, (например, список товаров для интернет-магазина, где построчно представлены разные данные: название, цена, описание и пр.).

Например, у Вас есть файл, в котором лежат данные готовых аккаунтов в таком формате:

login1;pass1;email1
login2;pass2;email2
login3;pass3;email3
....

Вам нужно при каждом выполнении проекта взять строку из этого файла (данные одного аккаунта) и получить отдельно login, pass и e-mail.

Создание и заполнение таблиц

Чтобы добавить таблицу в проект выберите группу действий Таблицы и создайте таблицу.

На панели статических блоков появится пиктограмма созданной таблицы.

Разметка в таблице простая, как в обычном Excel документе, столбцы именуются латинскими буквами, строки - цифрами (начиная с нуля). Таблицу можно заполнить вручную или загрузить данные из файла. Для того, чтобы загружать данные в таблицу из файла, поставьте галку «Загружать из файла», и, если нужно полностью синхронизировать таблицу с файлом, поставьте галку «Сохранять изменения таблицы в файл». Также понадобится указать путь к файлу, и разделитель. Если у вас обычный .xls, .xlsx, .odt или .csv файл, то просто выберите вариант с этими расширениями, и указывать разделитель не нужно. Если файл, например, .txt, то выберите «свой формат», и укажите символы разделителя.

Операции с таблицей

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

• Добавить строку - добавление строки в таблицу;

• Удалить строку - удаление строки из таблицы;

• Взять строку - запись строки из таблицы в список или переменную;

• Получить количество строк - получение количества строк в таблице и запись в переменную;

• Получить количество столбцов - получение количества столбцов в таблице и запись в переменную;

• Прочитать ячейку - чтение содержимого ячейки и запись значения в переменную;

• Записать ячейку - запись значения в ячейку;

• Сохранить в файл - сохранение таблицы в файл в ходе проекта с возможностью дозаписи строк в конец таблицы;

• Привязать к файлу - привязка таблицы к файлу в ходе проекта;

• Удалить дубли - удаление повторяющихся строк из таблицы;

• Сортировать - сортировка строк таблицы по убыванию или возрастанию.

Обратите внимание: положить все ячейки таблицы из одной строки в переменные можно в одно действие. Это делается через операцию «взять строку». Не нужно для этого создавать много действий, которые будут читать каждую ячейку таблицы отдельно.

При указании номеров строк можно использовать диапазоны.

Примечания

• Не создавайте очень большие файлы в сотни мегабайт, особенно если у Вас мало оперативной памяти.

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

• Ограничения при многопоточности: если Вы выполняете свой проект многопоточно (при полной синхронизации файла с таблицей) то никаких проблем не будет при соблюдении простого правила: работайте с таблицей в одно действие. Например, Вам нужно взять строку с удалением. Будет не правильно, если Вы сначала в одном действии возьмете строку, а в другом её удалите. Это можно сделать в одно действие - при взятии строки установить галку «С удалением». В одно действие можно сделать практически всё, что Вам может понадобиться при работе с таблицей.

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

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

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