Добавить элемент / Add element (Add Object)
Группа действий: Коллекции
Действие добавляет указанные объекты в коллекцию по индексу. По умолчанию, в конец списка.
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
Параметры | ||||
Коллекция | Коллекция, в которую будет добавлен объект. | Robin.Collection | Да | |
Индекс | Порядковый номер позиции, в которую необходимо вставить значение. Нумерация начинается с 0. | Robin.Numeric | Нет | |
Объект | Объект, который будет добавлен в коллекцию. | Robin.Object | Да |
Особые условия использования
При необходимости добавить несколько объектов следует нажать на знак плюса.
По умолчанию в действии 3 параметра:
- Коллекция
- Индекс, нумерация начинается с 0
- Объект
Каждый новый параметр Объект - новый элемент коллекции, добавляется после предыдущего.
Если заполнен параметр Индекс, то все новые объекты вставляются начиная с этой позиции.
Кейс:
Была коллекция:
- 1
- 2
- 3
Добавляем действие, у которого входные данные следующие:
- Коллекция
- Индекс - 1
- Объект - текст 1
- Объект - текст 2
Ожидаемый результат: коллекция
- 1
- текст 1
- текст 2
- 2
- 3
Пример использования
Задача: существует переменная "Коллекция 1" со значениями = Маша, Юля, Петя. Требуется добавить в коллекцию значение = Саша с порядковым номером позиции = 2. Далее провести проверку добавленного значения при помощи действия "Проверить на содержание значения".
Решение: настроить действие "Добавить элемент" и "Проверить на содержание значения".
Реализация:
- Собрать схему робота, состоящую из действий:
- Создать переменную "Переменная 1" со значением Саша.
- Перенести на рабочую область действие "Добавить элемент" и настроить его параметры:
В поле "Коллекция" указать требуемую со значениями = Маша, Юля, Петя.
Значения переменной "Коллекция 1":
В поле "Индекс" указать значение: 2.
В поле "Объект" указать переменную, содержащим значение, которое необходимо добавить в коллекцию - "Переменная 1". - Перенести на рабочую область действие "Проверить на содержание значения" и настроить его параметры:
В параметр "Коллекция" указать значение "Коллекция 1".
В параметр "Объект" требуемое значение для проверки. - Запустить робота по кнопке "Старт" в верхней панели.
Результат: коллекция содержит 4 записи, добавлена новая запись со значением = Саша