Руководство пользователя

Руководство пользователя

Импорт/Экспорт

Компоненты, которые позволяют импортировать или экспортировать данные в/из Epsilon и подключенного облачного хранилища данных.

Отправить на почту

Описание

Этот компонент сохраняет таблицу как файл в объектном хранилище и отправляет уведомление по почте со ссылкой на данный файл.

Входы

  • Исходная таблица [Table]
  • Адрес электронной почты [String]
  • Заголовок [String]
  • Содержимое письма [String]
  • Формат файла [String]

Выходы

  • Отправлено электронное письмо

Получить таблицу по имени

Описание

Загрузите таблицу в качестве источника в рабочий процесс, используя ее FQN, например: mydata.tables.table

Входы

  • Ссылка на исходную таблицу [Table]

Выходы

  • Результирующая таблица [Table]

HTTP-запрос

Описание

Этот компонент выполняет запросы к внешним конечным точкам.

Входы

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

Настройки

  • URL: URL, который будет использоваться для выполнения HTTP-запроса.

  • Параметры (необязательно): объект JSON с параметрами для HTTP-запроса. Вы можете использовать его для установки метода, отличного от GET, указания заголовков или тела для вашего запроса. Соответствует fetch() спецификации параметров API .

    • Пример:
{ 
    "method":"POST", 
    "headers":{ "Content-Type":"application/json" }, 
    "mode":"cors", 
    "cache":"default", 
    "body": "{ ...}"
}

Настройки URL и параметров позволяют использовать выражения и переменные:

  • Это пример использования значений из столбца ввода в URL-адресе, объединения строк со значениями из столбцов, все это в выражении, заключенном в двойные фигурные скобки:
    {{ 'https://your-api-domain.com/coordinates_endpoint?lat=' || latitude || '&lon=' || longitude || '&otherparams=...' }}

  • Использование выражений в настройке «Параметры» немного отличается, поскольку их содержимое преобразуется в строку в хранилище данных, и мы можем использовать имена столбцов в фигурных скобках напрямую, а не объединять строки, например:

{ 
"method":"POST", 
"headers":{ "Content-Type":"application/json" }, 
"mode":"cors", 
"cache":"default", 
"body": "{\"lng\":, \"lat\":{{latitude_column}} }"
}

{{longitude_column}}

В приведенных выше примерах значения из столбцов latitude и longitude использовались с выражениями для генерации различных URL-адресов /параметров для каждой строки во входной таблице.

  • Разрешенные хосты (необязательно): когда в URL используются выражения или переменные, вам необходимо задать разделенный запятыми список разрешенных хостов для ваших запросов. Если выражения/переменные не используются в URL, эта настройка игнорируется.

Выходы

  • Выходная таблица: этот компонент создает таблицу, содержащую все столбцы из входной таблицы (если таковые были подключены), а также столбец, response_data содержащий строку с данными ответа.

Сохранить как таблицу

Описание

Этот компонент создает постоянную таблицу в указанном месте назначения.

Если в этом месте существует таблица, она будет перезаписана.

Входы

  • Исходная таблица [Table]
  • Полное имя таблицы для создания/перезаписи [String]
  • Добавлять [true/false]: Определяет, будет ли результат добавлен к существующей таблице.

Выходы

  • Результирующая таблица [Table]

Выход

Описание

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

Входы

  • Исходная таблица [Table]

Этот компонент может быть использован только один раз в рабочем процессе. Содержимое узла, подключенного к нему, будет храниться во временной таблице, указанной в ответе API при вызове выполнения рабочего процесса как:
"workflowOutputTableName": "workflows-api-demo.workflows_temp.wfproc_f2f8df5df4ddf279_out_33afd785675f081d"

Отправить эл. письмо

Описание

Отправляет электронные письма с использованием почтового сервера SMTP.

Входы

  • Учетные данные для подключения: Выберите или создайте учетные данные SMTP-аккаунта для использования узлом.
  • Отправитель: Введите адрес электронной почты, с которого вы хотите отправить письмо. Вы также можете включить имя, используя этот формат: Name Name <email@sample.com>
  • Получатель: Введите адрес электронной почты, на который вы хотите отправить письмо. Вы также можете включить имя, используя этот формат: Name Name <email@sample.com>
  • Тема: Введите тему письма.
  • Формат письма: Выберите формат отправки электронного письма. Выберите из:
    • Текст: отправьте электронное письмо в формате обычного текста.
    • HTML: отправьте электронное письмо в формате HTML.
    • Оба: отправить письмо в обоих форматах. Если вы выберете этот вариант, клиент получателя письма установит, какой формат отображать.

Дополнительные параметры

  • Добавьте атрибуцию epsilon: Укажите, следует ли включать фразу Это электронное письмо было отправлено автоматически с помощью Epsilon в конец письма (включено) или нет (выключено).
  • Вложения: Введите имя бинарных свойств, содержащих данные для добавления в качестве вложения.
  • Копия: Введите адрес электронной почты в поле «Копия:».
  • Скрытая копия: Введите адрес электронной почты в поле «скрытая копия».
  • Игнорировать проблемы с SSL (небезопасно): Установите, должен ли n8n игнорировать сбои проверки сертификата TLS/SSL (включено) или применять их (выключено).
  • Ответить на: Введите адрес электронной почты в поле «Ответить».

Выходы

  • Отправлено электронное письмо

Вебхук

Описание

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

Входы

  • Режим работы: Узел Webhook поддерживает стандартные методы HTTP-запросов:

    • DELETE
    • GET
    • HEAD
    • PATCH
    • POST
    • PUT

  • Путь: По умолчанию это поле содержит случайно сгенерированный URL-путь веб-перехватчика, чтобы избежать конфликтов с другими узлами веб-перехватчика.
    Вы можете вручную указать путь URL, включая добавление параметров маршрута. Например, вам может потребоваться сделать это, если вы используете n8n для прототипирования API и хотите получить согласованные URL-адреса конечных точек.
    Поле «Путь» может иметь следующие форматы:

    • /:variable
    • /path/:variable
    • /:variable/path
    • /:variable1/path/:variable2
    • /:variable1/:variable2

  • Аутентификация: Выберите один из этих методов аутентификации:

    • Базовая аутентификация
    • Аутентификация заголовка
    • JWT-аутентификация
    • Без аутентификации

  • Ответить:

    • Немедленно: узел Webhook возвращает код ответа и сообщение «Рабочий процесс запущен».
    • Когда последний узел завершит работу: узел Webhook возвращает код ответа и выходные данные из последнего узла, выполненного в рабочем процессе.
    • Использование узла “Ответить на Вебхук”: Узел Webhook отвечает так, как определено в узле «Ответить на Webhook».

  • Данные ответа:Выберите, какие данные включить в текст ответа:

    • Все записи: Webhook возвращает все записи последнего узла в массиве.
    • Первая запись JSON: Webhook возвращает данные JSON первой записи последнего узла в объекте JSON.
    • Первая запись двоичного файла: Webhook возвращает двоичные данные первой записи последнего узла в двоичном файле.
    • Нет тела ответа: Webhook возвращается без тела.

    Применимо только к Ответить > Когда последний узел завершит работу .

Дополнительные параметры

  • Разрешенное происхождение (CORS): Установите разрешенные домены с перекрестными источниками. Введите разделенный запятыми список URL-адресов, разрешенных для перекрестных непредварительных запросов. Используйте *(по умолчанию), чтобы разрешить все источники.
  • Имя поля для двоичных данных: включение этого параметра позволяет узлу Webhook получать двоичные данные, такие как изображение или аудиофайл. Введите имя двоичного свойства, в которое нужно записать данные полученного файла.
  • Игнорировать ботов: игнорировать запросы от ботов, таких как программы предварительного просмотра ссылок и веб-сканеры.
  • IP(ы) Белый список: включите этот параметр, чтобы ограничить, кто (или что) может вызывать URL-адрес триггера Webhook. Введите разделенный запятыми список разрешенных IP-адресов. Доступ с IP-адресов вне белого списка приводит к ошибке 403. Если оставить поле пустым, все IP-адреса могут вызывать URL-адрес триггера Webhook.
  • Body без ответа: включите этот параметр, чтобы запретить n8n отправлять тело ответа.
  • Необработанный Body: укажите, что узел Webhook будет получать данные в необработанном формате, например JSON или XML.
  • Код ответа: Настройте код ответа HTTP , который узел Webhook возвращает при успешном выполнении. Выберите из общих кодов ответа или создайте собственный код.
  • Ответные данные: отправка пользовательских данных вместе с ответом.
  • Ответ Content-Type: выберите формат для тела веб-перехватчика.
  • Заголовки ответа: отправка дополнительных заголовков в ответе Webhook. Обратитесь к MDN Web Docs | Заголовок ответа, чтобы узнать больше о заголовках ответа.
  • Название свойства: по умолчанию n8n возвращает все доступные данные. Вы можете выбрать возврат определенного ключа JSON, чтобы n8n вернул значение.

Ответ на вебхук

Описание

Используйте узел Ответ на вебхук для управления ответом на входящие вебхуки. Этот узел работает с узлом Вебхук.

Чтобы использовать узел “Ответ на вебхук”:

  • Добавьте узел “Вебхук” в качестве триггерного узла для рабочего процесса.
  • В узле Вебхук" установите “Отвечать на использование узла” “Ответ на вебхук”.
  • Добавьте узел “Ответ на вебхук” в любом месте рабочего процесса. Если вы хотите, чтобы он возвращал данные с других узлов, поместите его после этих узлов.

Входы

  • Ответить с помощью: Выберите, какие данные отправлять в ответе веб-хука.
    • Все входящие элементы: ответ со всеми элементами JSON из входных данных.
    • Двоичный: ответ с двоичным файлом, определенным в источнике данных ответа.
    • Первый входящий элемент: ответьте JSON первого входящего элемента.
    • JSON: ответ с объектом JSON, определенным в теле ответа.
    • Нет данных: нет ответной полезной нагрузки.
    • Перенаправление: перенаправление на URL-адрес, указанный в поле URL-адрес перенаправления.
    • Текст: Ответить текстом, заданным в тексте ответа.

Дополнительные параметры

  • Код ответа: установите код ответа для использования.
  • Заголовки ответа: определите заголовки ответа для отправки.
  • Поместить ответ в поле: доступно, если вы отвечаете Все входящие элементы или Первый входящий элемент. Установите имя поля для поля, содержащего данные ответа.