Документация
Полное руководство по установке и настройке расширений 1C.Tools
Системные требования
Серверная часть (1С)
- 1С:Предприятие версии 8.3.18 или выше
- Конфигурации: Управление Торговлей 11, ERP 2, Комплексная Автоматизация 2
- Веб-сервер Apache 2.4+ или IIS 8+
- Публикация информационной базы с HTTP-сервисами
Клиентская часть
- Современный браузер: Chrome 80+, Firefox 75+, Safari 13+, Edge 80+
- Сетевой доступ к серверу 1С
Установка расширения
1Загрузка расширения в 1С
Откройте конфигуратор 1С и загрузите файл расширения:
Конфигурация → Расширения конфигурации → Добавить → Загрузить из файла Выберите файл: FinanceDashboard.cfe
После загрузки расширения необходимо перезапустить информационную базу в режиме предприятия.
2Публикация HTTP-сервиса
Настройте публикацию базы на веб-сервере:
Администрирование → Публикация на веб-сервере // Параметры публикации: Имя: erp // или ваше имя базы Веб-сервер: Apache 2.4 Каталог: /var/www/1c/erp // Обязательно включите: ☑ HTTP-сервисы ☑ Публиковать расширения по умолчанию
3Размещение HTML-файлов
Скопируйте файлы дашборда на веб-сервер:
# Создайте директорию mkdir -p /var/www/dashboard # Скопируйте файлы cp dashboard.html /var/www/dashboard/ cp finance.html /var/www/dashboard/ # Установите права chown -R www-data:www-data /var/www/dashboard
Настройка дашборда
Подключение к API
При первом открытии дашборда укажите параметры подключения:
| Параметр | Описание | Пример |
|---|---|---|
| URL API | Адрес HTTP-сервиса 1С | https://1c.company.com/erp/hs/finance/summary |
| Пользователь | Логин 1С с правами на HTTP-сервис | api_user |
| Пароль | Пароль пользователя 1С | •••••••• |
Создайте в 1С отдельного пользователя с минимальными правами только для доступа к HTTP-сервисам дашборда.
API Endpoints
GET /hs/finance/summary
Сводные данные для основного дашборда:
| Параметр | Тип | Описание |
|---|---|---|
| currency | string | Валюта отчёта: USD, EUR, RUB, TJS |
| dateFrom | string | Начало периода: 20241201 |
| dateTo | string | Конец периода: 20241231 |
GET /hs/finance/report
Детальные данные для финансового отчёта с графиками и воронкой.
Кастомизация
Вы можете модифицировать дашборд под свои нужды:
- Цветовая схема — измените CSS-переменные в секции :root
- Логотип — замените эмодзи на изображение
- Дополнительные показатели — добавьте новые карточки и запросы в 1С
Решение проблем
Ошибка CORS
Если видите ошибку "Access-Control-Allow-Origin", проверьте заголовки в модуле HTTP-сервиса 1С:
Ответ.Заголовки.Вставить("Access-Control-Allow-Origin", "*");
Ошибка авторизации (401)
Проверьте:
- Правильность логина и пароля
- У пользователя есть права на HTTP-сервис
- Пользователь не заблокирован в 1С
Контакты поддержки
Если у вас возникли вопросы или проблемы:
- Telegram: @yourusername
- Email: support@your-domain.com
Мы отвечаем на вопросы в течение рабочего дня (пн-пт, 9:00-18:00 по московскому времени).