Курсы из файла
Last updated
Was this helpful?
Last updated
Was this helpful?
Для корректного и регулярного автоматического обновления курсов валют обязательно добавьте специальное задание в планировщик задач (CRON).
Для этого перейдите по ссылке ниже и внимательно следуйте инструкциям на странице настройки. После того, как вы настроите задание, курсы начнут обновляться автоматически в заданное время. Если вы хотите убедиться в том, что курсы обновляются, перейдите по соответствующей ссылке и добавьте виджет на рабочий стол вашей панели управления. Без добавления задания в планировщик курсы валют обновляться не будут!
Функция «Курсы из файла» позволяет автоматически загружать и обновлять курсы валют в вашей системе из подготовленного текстового файла. Вместо того чтобы вручную вносить каждое значение, вы просто создаёте специальный файл, размещаете его по ссылке, и система сама скачивает и обновляет все курсы за несколько секунд.
Это решение значительно экономит ваше время и исключает ошибки, возникающие при ручном вводе.
Работа функции состоит из нескольких шагов:
Подготовка файла: Вы создаёте текстовый файл и добавляете туда курсы валют в нужном формате.
Загрузка файла: Вы размещаете файл по прямой ссылке в интернете (например, на вашем сервере или облачном хранилище).
Автоматическая обработка: Система самостоятельно скачивает файл, проверяет и обрабатывает данные, выполняет вычисления и обновляет базу данных.
Готово: Курсы валют обновлены и готовы к использованию.
Файл должен быть простым текстовым файлом с расширением .txt.
Каждая строка файла описывает курс одной валютной пары.
Каждая строка это:
название пары валют (например, USD - RUB);
знак двоеточия «:»;
значение курса (можно писать числа или формулы).
Простое число
USD - RUB : 91.6
Просто устанавливает указанный курс валют
Математическое выражение
BTC - USDT : 61505 + 1 / 2
Система сама рассчитает указанную формулу
Обратный курс
RUB - USD : (USD - RUB)
Автоматически пересчитает как 1 / (USD - RUB)
Использование процентов
EUR - USD : (USD - EUR) + 5%
Рассчитает обратный курс и добавит сверху 5%
Эти данные не будут обработаны (система просто их проигнорирует):
Использовать неправильный код валюты
BTC123 - USD : 100
Валютные коды должны состоять ровно из 3 букв
Пропускать двоеточие ":"
USD - RUB 84.1
После валютной пары должно быть двоеточие ":"
Использовать посторонние символы
USD - RUB : семьдесят четыре
Значения должны быть числами или формулами
до 100
0.01 секунда
до 500
0.05 секунд
до 1000
0.1 секунда
до 10 000
около 0.5 секунд
Шаг 1: Создайте файл
Создайте простой текстовый файл (например: kurcy.txt) и вставьте туда курсы в правильном формате (см. выше).
Шаг 2: Загрузите файл
Загрузите этот файл в любое место, где можно получить прямую ссылку (ваш сайт, сервер, облако).
Пример ссылки: https://вашсайт.com/kurcy.txt
Шаг 3: Добавьте ссылку в систему
Перейдите в административную панель или личный кабинет вашей системы, вставьте ссылку в соответствующее поле для функции «Курсы из файла».
Шаг 4: Запустите обновление
Система автоматически скачает файл и обработает данные.
Сложение
+
BTC - USD : 25000 + 10
25000 + 10
25010
Вычитание
-
EUR - USD : 1.1 - 0.05
1.1 - 0.05
1.05
Умножение
*
ETH - USD : 1500 * 2
1500 × 2
3000
Деление
/
BTC - EUR : 25000 / 2
25000 ÷ 2
12500
Процент
%
USD - EUR : 1 + 5%
1 + 5% (от 1) → 1 + 0.05
1.05
Скобки
( )
RUB - USD : (USD - RUB)
1 ÷ (USD - RUB)
обратный курс
Используются для расчёта обратных курсов на основе уже указанного курса. Например: USD - RUB : 74.1 RUB - USD : (USD - RUB)
В панели управления откройте раздел «Парсер курсов — Курсы из файла». Здесь вы можете добавить валютные пары и указать ссылку на файл с курсами. Названия валютных пар должны полностью совпадать с названиями пар, указанными внутри вашего файла курсов.
Система автоматически загрузит курсы из указанного файла, обработает их и обновит все добавленные вами валютные пары.
Пример валютной пары:
BTC - USD
(название пары должно быть таким же, как в вашем файле)
Пример ссылки на файл:
https://вашсайт.com/kurcy.txt
Чтобы добавить новую пару, нажмите кнопку "Добавить пару" расположенную в правом вверхнем углу
На открывшейся окне, заполните представленную форму
Источник: Выберите источник, из которого будет происходить загрузка и парсинг курсов.
Название:
Введите название валютной пары точно так, как вы указали её в файле.
(Например: USD - RUB)
Знаки после, запятой:
Укажите точность отображения курса. Рекомендуемое значение — 10 знаков.
(Пример: курс 74.1234567890)
Статус:
Установите статус пары (Включен или Отключен). Неактивные пары не будут обновляться.
Добавление источника
Название: Укажите любое название источника
Ссылка на файл: Укажите ссылку, где у вас расположен файл курсов.
Откройте панель управления.
Перейдите в раздел:
«Основное — Направление обмена — Список направлений»
Найдите нужное вам направление обмена (например: «Сбербанк RUB → Банк. счёт THB»).
Чтобы изменить настройки этого направления, нажмите на значок ✏️ (карандаш).
Если не можете найти нужное направление, используйте поиск или фильтры по статусам (например, «Архивные», «Включенные»).
После нажатия на значок ✏️ откроются настройки направления обмена.
Слева найдите раздел «Обмен» и нажмите на него.
Выберите подраздел «Курс обмена».
Теперь откроется форма настройки курса конкретного направления.
На странице настройки курса обмена вы увидите разные варианты:
«Курс из источников»
«Ручной курс обмена»
«Курс по формуле»
«Курс обмена из файла» (вам нужен именно этот раздел)
Следуйте далее инструкции:
В блоке «Курс обмена из файла» найдите поле «Выберите курс из файла» и нажмите на него.
Откроется список загруженных ранее курсов:
Выберите нужный курс из списка, нажав на него (например, USD - RUB).
После выбора курса:
Убедитесь, что нужный курс корректно отображается в поле.
Нажмите на кнопку «Сохранить».
После сохранения обязательно проверьте, всё ли настроено правильно:
Вернитесь в общий список направлений обмена.
Проверьте, что направление отображает корректный курс из файла.
При необходимости сделайте тестовый обмен, чтобы убедиться в корректности расчётов.
