Добавить запись  / INSERT

Группа действий: Базы данных

Добавляет запись (строку) в указанную таблицу БД. 

Параметры

Входные параметры:

  1. Контекст БД – Контекст подключения к выбранной базе данных;

  2. Имя таблицы – Имя таблицы в БД;

  3. Данные для вставки – Словарь данных для вставки в таблицу;

  4. Список имен полей первичного ключа – Список имен полей первичного ключа, который будет получен в результате.

Выходные параметры: 

В результате получаем Список значений первичного ключа, сгенерированных в результате вставки данных для полей.


Настройки

Свойство

Описание

Тип

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

Обязательность заполнения поля

Параметры

Контекст БД

Контекст подключения к выбранной базе данных

Robin.DbContext

Контекст баз данных

Да

Имя таблицы

Имя таблицы

Robin.String


Да

Данные для вставки

Данные в виде словаря для вставки в таблицу

Robin.Dictionary


Да

Список имен полей первичного ключа

Список имен полей первичного ключа, который нужно получить в результате

Robin.Collection


Нет

Результаты

Список значений первичного ключа

Список значений первичного ключа, сгенерированных в результате вставки данных для полей, указанных в параметре «Список имен полей первичного ключа»

Robin.Dictionary





Особые условия использования

Отсутствуют.


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

Задача:  подключиться к базе данных и добавить данные в таблицу (столбцы  company_name и inn) . Данные: ООО "Ромашка", 5047053423


Решение: воспользоваться действиями "Стандартное подключение", "Добавить запись". 

Реализация:

  1. Собрать робота, состоящего из действий:
  2. Настроить параметры для действия "Стандартное подключение". 
    В поле "Тип СУБД" выбрать соответствующий той базе данных, к которой необходимо подключиться. 
    Указать логин и пароль от базы данных. 
    Хост сервера можно указать, как по IP машины, где установлена база или по имени хоста. 
    Указать порт сервера, а также имя БД. 
    В поле "Таймаут" значение исчисляется в секундах. 
    В поле "Параметры" указываются дополнительные параметры для подключения, как правило, это параметры, которые относятся к безопасности. Параметры указываются в виде словаря. 

    Подробнее о параметре "Уровень изоляции транзакций". Последовательные операции по работе с БД можно разделить на транзакции. Транзакция  - это группа операций, которые представляют некую логическую единицу работы с базой. Например, необходимо выполнить несколько операций с таблицей для того, чтобы обновить в ней данные. При возникновении ошибки можно откатить транзакцию, т.е сделанную группу операций, чтобы не разбираться на каком шаге возникла данная ошибка. 

    При активации чекбокса ""Уровень изоляции транзакций" часть выполняемых запросов к базе будет идти в виде транзакций. 


  3. Настроить параметры для действия "Добавить запись". 
    В поле "Данные для вставки" указать данные в виде словаря. 
    В поле "Список имен полей первичного ключа" заполнить следующим образом: 

4. Нажать на кнопку "Старт" в верхней панели. 


Результат:

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