CSV

Последняя версия: 1.3.0

Дистрибутив: образ плагина CSV

Описание

Плагин CSV предназначен для загрузки и визуализации данных из CSV-файлов в Графине. Он поддерживает несколько способов получения данных: загрузку файла с локального компьютера, чтение по URL, ввод CSV-текста вручную и чтение файла с файловой системы сервера, где работает плагин.

В интерфейсе создания источника данных плагин отображается как CSV.

Настройка

Ниже показаны реальные состояния формы создания источника данных CSV в тёмной теме интерфейса Графини.

Базовая форма

Поля источника данных

Название в UI	Код поля	Тип	Обязательность	Значение по умолчанию	Примечание
Источник данных	source	radio	обязательно	Загрузка файла	Главное триггерное поле. Определяет, откуда плагин получает CSV.
Выберите файл до 768 Кб	content	file	обязательно для режима Загрузка файла	пусто	Принимается CSV-файл размером до 768 Кб.
Метод	method	select	обязательно для режима URL	GET	Поддерживаются GET, POST, PUT.
URL	url	text	обязательно для режима URL	пусто	Должен быть корректным http:// или https:// URL-адресом CSV-файла.
Пропустить проверку TLS	skipTls	radio	обязательно для режима URL	Проверять	Вложенное триггерное поле URL-режима.
TLS-сертификат	tls	textarea	необязательно	пусто	Отображается при значении Пропустить проверку TLS = Проверять.
Добавить заголовки	hasHeaders	radio	необязательно	Нет	Дополнительный переключатель URL-режима для передачи HTTP-заголовков запроса.
Заголовок	header[]	список полей	необязательно	пусто	Отображается после включения Добавить заголовки = Да. По кнопке + добавляются строки заголовков запроса.
CSV-содержимое	data	textarea	обязательно для режима Ввод текста файла	пусто	Позволяет вставить содержимое CSV вручную.
Путь к файлу	path	text	обязательно для режима Файловая система	пусто	Путь к CSV-файлу на сервере, где работает плагин.
Кодировка	encoding	select	обязательно	UTF-8	Можно выбрать готовую кодировку или ввести собственную, поддерживаемую плагином.
Разделитель	delimiter	select	обязательно	Точка с запятой	Поддерживаются Запятая, Точка с запятой, Табуляция.
Формат времени	timeFormat	text	необязательно	пусто	Используется при интерпретации временных значений. Если не заполнен, по умолчанию используется шаблон dd-MM-yyyy HH:mm:ss.
Первая строка	header	radio	обязательно	Заголовок	Определяет, считать ли первую строку CSV заголовком колонок или данными.

Динамические поля и зависимости

Основное поведение формы определяется полем Источник данных.

1. Если выбрано Загрузка файла, отображается поле Выберите файл до 768 Кб.
2. Если выбрано URL, отображаются поля Метод, URL, Пропустить проверку TLS и Добавить заголовки.
3. Если в URL-режиме выбрано Пропустить проверку TLS = Проверять, дополнительно отображается поле TLS-сертификат.
4. Если в URL-режиме выбрано Добавить заголовки = Да, появляется блок Заголовок с кнопкой + для добавления HTTP-заголовков запроса.
5. Если выбрано Ввод текста файла, отображается поле CSV-содержимое.
6. Если выбрано Файловая система, отображается поле Путь к файлу.

URL-режим с проверкой TLS

URL-режим с дополнительными заголовками

Ввод CSV-текста

Чтение с файловой системы

Правила заполнения, важные для проверки подключения

• Для запуска проверки в форме должны быть выбраны тип источника данных и заполнено имя источника.
• Для успешной проверки нужно выбрать ровно один способ получения CSV через поле Источник данных.
• Для режима Загрузка файла требуется выбрать CSV-файл размером не более 768 Кб.
• Для режима URL обязательны Метод, URL и Пропустить проверку TLS.
• Для режима Ввод текста файла должно быть заполнено поле CSV-содержимое.
• Для режима Файловая система должен быть указан путь к доступному CSV-файлу на сервере плагина.
• URL должен быть валидным http:// или https:// адресом.
• При значении Пропустить проверку TLS = Проверять для URL-источников с собственным или самоподписанным сертификатом обычно требуется заполнить TLS-сертификат.
• При значении Пропустить проверку TLS = Игнорировать поле TLS-сертификат скрывается, а проверка сертификата отключается.
• Поля Кодировка, Разделитель и Первая строка напрямую влияют на то, как плагин прочитает CSV при проверке подключения.
• Если Первая строка = Заголовок, названия колонок берутся из первой строки файла.
• Если Первая строка = Данные, первая строка считается обычными данными, а колонки нумеруются автоматически.

Порядок создания источника данных

1. Откройте раздел Источники данных.
2. Нажмите Добавить источник данных.
3. В поле Источник данных укажите понятное имя подключения.
4. В поле Тип выберите CSV.
5. В поле Источник данных выберите нужный режим: Загрузка файла, URL, Ввод текста файла или Файловая система.
6. Заполните поля выбранного режима источника.
7. Настройте Кодировка, Разделитель, Формат времени и Первая строка.
8. Для URL-источника при необходимости настройте TLS-проверку и дополнительные заголовки.
9. Нажмите Проверить соединение.
10. После успешной проверки нажмите Сохранить.

Пример заполнения для загрузки файла

• Источник данных: Загрузка файла
• Выберите файл до 768 Кб: CSV-файл с локального компьютера
• Кодировка: UTF-8
• Разделитель: Точка с запятой
• Формат времени: yyyy-MM-dd HH:mm:ss, если CSV содержит временную колонку в этом формате
• Первая строка: Заголовок, если первая строка содержит имена колонок

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

• Источник данных: URL
• Метод: GET
• URL: https://example.org/data/metrics.csv
• Пропустить проверку TLS: Проверять или Игнорировать
• TLS-сертификат: PEM-сертификат, если требуется проверка собственного CA
• Добавить заголовки: Да, если сервер требует дополнительные HTTP-заголовки
• Кодировка: UTF-8
• Разделитель: Точка с запятой
• Первая строка: Заголовок

Пример заполнения для ввода текста

• Источник данных: Ввод текста файла
• CSV-содержимое:

time;value;host
2026-05-15 10:00:00;42;node-01
2026-05-15 10:05:00;43;node-02

• Кодировка: UTF-8
• Разделитель: Точка с запятой
• Формат времени: yyyy-MM-dd HH:mm:ss
• Первая строка: Заголовок

Пример заполнения для файловой системы

• Источник данных: Файловая система
• Путь к файлу: file:///var/lib/graphina/import/data.csv
• Кодировка: UTF-8
• Разделитель: Точка с запятой
• Первая строка: Заголовок