1C# - это платформа для разработки серверных приложений, доступных через web.

1C# умеет работать с базами данных платформы 1С:Предприятие 7-ой и 8-ой версий напрямую. Возможно также создание своих или работа с уже существующими базами данных "не 1С".

1C# состоит из трёх основных подсистем:

1. Метаданные.

Метаданные используются для моделирования прикладных объектов и их структур хранения данных. Для работы с метаданными используется конфигуратор 1C# аналогичный конфигуратору 1С. Метаданные 1C# хранятся в базе данных SQL Server (см. инструкцию по установке).

2. Дизайнер запросов.

Визуальный конструктор запросов аналогичный Microsoft SQL Server Management Studio. Этот дизайнер обеспечивает визуальное редактирование запроса в терминах объектов метаданных 1С, а не названий таблиц СУБД. Результатом работы дизайнера является построение синтаксического дерева запроса, которое можно сохранить в дереве метаданных 1C#. Запрос, как объект метаданных, может быть вызван через web сервер 1C# для выполнения и получения результата.

1C# умеет обращаться к данным из разных источников в одном запросе. Например, можно создать запрос, который одновременно получает данные из 1С 7.7 + 1С 8.3 + база данных "не 1С". Такой запрос создаётся в терминах метаданных 1С 8-ой версии.

3. Web сервер.

Web сервер 1C# - это .NET Core middleware (внешняя компонента для web сервера). Непосредственно в качестве web сервера используется Kestrel. Web сервер 1C# обслуживает клиентские запросы к созданным в конфигураторе 1C# запросам данных. Полученный результат запроса сериализуется и отдайтся клиенту в формате JSON.

Требуется установка .NET Framework 4.7.2 + .NET Core 2.2

Актуальные билды находится в папке install данного репозитория:

• utilities.zip - скрипты SQL и обработки для выгрузки метаданных 1С в формате XML для загрузки в 1C#
  • SQL - каталог скриптов для создания базы данных 1C# на SQL Server
  • ConfigurationExporter82.epf - выгрузка метаданных 1С на обычных формах
  • ConfigurationExporter83.epf - выгрузка метаданных 1С на управляемых формах
• web-server.zip - сервер 1C#, доступный по протоколу http
  • web-server - каталог исполняемых файлов сервера 1C#
  • run-server.bat - запуск сервера 1C#
  • show-server-settings.bat - просмотр и редактирование настроек сервера 1C# в notepad
    • appSettings\ServerURL - адрес и порт web сервера 1C#
    • connectionStrings\Zhichkin.Metadata - строка подключения к базе данных 1C#
• wpf-ui.zip - конфигуратор 1C#
  • wpf-ui - каталог исполняемых файлов конфигуратора 1C#
  • run-wpf-ui.bat - запуск конфигуратора 1C#
  • show-wpf-ui-settings.bat - просмотр и редактирование настроек конфигуратора 1C# в notepad
    • connectionStrings\Zhichkin.Metadata - строка подключения к базе данных 1C#

1. Скопировать и распаковать соотвествующие архивы в каталоги установки.
2. Создать базу данных 1C# на SQL Server при помощи прилагаемых скриптов SQL.
3. Настроить подключение к базе данных 1C# для конфигуратора 1C#.
4. Настроить подключение к базе данных 1C# для web сервера 1C#.
5. Настроить адрес и порт web сервера 1C#.

Дополнительные подробности по установке 1C# можно найти в папке doc данного репозитория.

Передача параметров web функции 1C#, созданной при помощи конфигуратора платформы, выполняется в виде JSON объекта следующего вида:

{
   "Булево" : true,
   "Строка" : "Тест",
   "ЦелоеЧисло" : 123,
   "ДробноеЧисло" : 123.45,
   "Дата" : "2019-08-01T19:15:00",
   "Неопределено" : null
}

[email protected]