Versions Compared

Version Old Version 2 New Version Current
Changes made by

Alex Goa

ZL Support

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#E3FCEF

Пожалуйста, ознакомьтесь с Правилами использования материалов на данном ресурсе

Оглавление

Expand
titleНажмите здесь, чтобы развернуть оглавление
Table of Contents
minLevel1
maxLevel7
exclude^Оглавление$

...

Описание

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

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

Code Block

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

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

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

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

...

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

...

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

...

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

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

...

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

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

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

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

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

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

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

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

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

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

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

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

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

...

Примечания

...

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

...

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

...

Экшен используется как при работе с Таблицами так и с Google Таблицами, но у Google Таблиц есть несколько уникальных действий, которые описаны в статье Операции над Google-таблицами

...

Как добавить Таблицу в проект?

Info

Перед началом работы необходимо создать Таблицу или Google таблицу.

...

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

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

...

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

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

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

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

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

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

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

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

В качестве номера столбца можно использовать либо числа (нумерация с нуля!), либо, как в Excel, буквы латинского алфавита в верхнем регистре!

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

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

...

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

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

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

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

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

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

Список 1

Image Added

...

Взять строки

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

...

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

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

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

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

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

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

Переменные

Image Added

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

...

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

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

...

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

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

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

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

Expand
titleПример

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

Image Added

Список 1

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

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

...

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

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

...

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

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

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

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

Строка будет добавлена в конец таблицы

Tip

Если нужно добавить сразу несколько строк в таблицу, то стоит воспользоваться экшеном Обработка текста-В таблицу.

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

...

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

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

...

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

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

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

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

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

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

...

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

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

...

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

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

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

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

Expand
titleПример

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

Image Added

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

Image Added

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

Image Added

...

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

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

...

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

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

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

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

Expand
titleПример

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

Image Added

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

Image Added

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

Image Added

...

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

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

Этот экшен стоит использовать когда путь файла не известен на момент старта шаблона и будет вычислен только во время выполнения проекта.

...

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

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

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

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

Expand
titleПример

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

Image Added

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

...

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

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

...

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

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

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

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

Expand
titleПример

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

Image Added

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

Image Added

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

Image Added

...

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

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

...

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

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

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

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

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

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

...

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

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

...

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

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

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

Note

Функция имеет опцию только перезаписи файла

Expand
titleПример

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

Image Added

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

Image Added

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

Image Added

...

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

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

...

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

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

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

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

...

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

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

...

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

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

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

Note

Столбец будет удалён со всеми значениями

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

...

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

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

...

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

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

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

Note

Заданная строка будет удалена во всех столбцах

Expand
titleПример

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

Image Added

Таблица 1

До обработки

Image Added

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

Image Added

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

...

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

Необходимо строго соблюдать для корректной работы проектов

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

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

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

  • Если все проекты только читают файл, то проблем

...

  • никаких не будет

...

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

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

...

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

...

  • Учитывайте, что таблицы в оперативной памяти занимают намного больше места чем исходный файл на жестком диске. Например, в оперативной памяти таблица на основе файла CSV в 10 MB в 100 потоков без синхронизации с файлом, может занять 5 GB. Старайтесь не использовать списки и таблицы в режиме «без синхронизации» с файлом без необходимости.

...

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

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

...

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

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

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

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

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

...

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

  1. Таблица

  2. Google таблицы

  3. Список

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

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

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

  7. Диапазоны значений