7 причин, почему интеграция стала приятной. Не упускайте ряд потрясающих возможностей

Введение в Open Data Protocol

В 1С Предприятие 8.3.5.1068 появилась поддержка автоматического REST-сервиса. Теперь платформа может автоматически формировать REST интерфейс для всего прикладного решения. Вы привычным образом публикуете его на веб-сервере, и после этого сторонние системы могут обращаться к вашему приложению с помощью HTTP запросов. В качестве протокола доступа платформа использует протокол OData версии 3.0. Это открытый веб-протокол для запроса и обновления данных. Он позволяет оперировать данными, используя в качестве запросов HTTP-команды. Получать ответы можно в различных форматах, но пока присутствует поддержка формата Atom/XML. 

7 причин, почему интеграция стала приятной

1. Платформа автоматически генерирует REST интерфейс, не нужно никакого программирования;
2. Прозрачная интеграция прикладного решения с интернет-сайтами, мобильными приложениями и прочими системами;
3. Реализация сторонними средствами дополнительной функциональности без изменения конфигурации;
4. Загрузка данных в прикладное решение и выгрузка данных из него;
5. Управление составом объектов метаданных, доступных через стандартный сервис OData API на лету;
6. Ограничения прав доступа пользователей также действительны для запросов OData;
7. Универсальность и кроссплатформенность.

Подготовительный этап

1. Версия платформы «1С:Предприятие 8» — не ниже 8.3.5.1068;
2. Режим совместимости конфигурации — «Не использовать» или не ниже «Версия 8.3.5»;
3. Включен флаг «Публиковать стандартный интерфейс OData«;
4. Определить состав объектов метаданных, доступных через стандартный сервис OData;
5. Проверить работоспособность сервиса по ссылкам:
   http://{АдресВебСервера}/{ИмяПубликации}/odata/standard.odata;
   http://{АдресВебСервера}/{ИмяПубликации}/odata/standard.odata/$metadata;
6. Посмотреть, проходит ли валидацию описание сервиса по ссылке.

Возникают трудности? Посмотрите видео:

Если возникают проблемы с валидацией, нужно обратиться по адресу https://partners.v8.1c.ru/forum/. Использовать веб-сервис все равно можно, даже если валидация не удалась.

Обработка для определения состава метаданных, доступных через стандартный сервис OData, прикреплена в конце статьи.

Интеграция с Excel

Бывают случаи, когда нужно получить данные из информационной базы «1С:Предприятие 8» и быстро обработать их. Работая с бизнес-аналитиками, руководителями потребность в данных есть всегда. Чаще всего информацию получить сложно без привлечения программиста, да и процесс передачи понимания, что же нужно, не так прост. С помощью стандартного сервиса OData, можно получать данные прямо в Excel, использовать все возможности Excel для анализа данных, построения моделей, формирования сводных таблиц и т. п. Самое приятное, что все расчеты будут автоматически обновляться при изменении данных в «1С:Предприятие 8». Рассмотрим поэтапно:

1. Нужно настроить внешний источник данных в Excel

   

2. Настроить подключение к REST сервису «1С:Предприятие 8»
   
3. Отмечаем нужные таблицы, в примере «Справочник.Валюты» и «РегистрСведений.КурсыВалют»
    
4. Импортируем данные из «1С:Предприятие 8»
    

Для получения детальной информации посмотрите видео:

Интеграция с .NET системами

Ни для кого не секрет, что появляется множество новых систем, с которыми нужно интегрироваться. На живом примере видел, что связывание систем — очень долгий и сложный процесс. Почему бы его не упростить? Сделаем программу на c# (Windows Forms Application), которая будет выводить курсы валют. Рассмотрим поэтапно:

1. необходимый инструментарий: Microsoft Visual Studio (в примере используется Visual Studio Community 2024), DataSvcUtil.exe (обычно идет вместе с Visual Studio Community 2024);
2. сохраним описание REST сервиса в файл metadata.csdl;
3. с помощью утилиты DataSvcUtil.exe сформируем прокси класс, которые будет делать всю работу по взаимодействию с REST сервисом «1С:Предприятие 8». Вот так выглядит командная строка:
   C:UsersDesigner>»C:Program Files (x86)Microsoft WCF Data Services5.6.4in oolsDataSvcUtil.exe» /in:D:Public_ODatametadata.csdl /out:D:Public_Odatametadata.cs /version:3.0;
4. создаем проект Windows Forms Application
    
5. добавляем в проект прокси класс metadata.cs;
6. в файле App.config пропишем параметры доступа к REST сервису:

   <connectionStrings>
   <add name="ProductionOData" connectionString="http://wall-e.ktc.local/dt/odata/standard.odata" />
   <add name="UserOData" connectionString="username" />
   <add name="PasswordOData" connectionString="password" />
   </connectionStrings>
   

7. добавим необходимые References в проект
    
8. добавим на форму DataGridView и настроим
    
9. при загрузке формы добавим код для получения курсов валют из REST сервиса:
   

   // Получаем ссылку на REST сервис
   Uri serviceRoot = new Uri(ConfigurationManager.ConnectionStrings[«ProductionOData»].ConnectionString);

   // Инициализируем сервис
   EnterpriseV8 V8Base = new EnterpriseV8(serviceRoot);

   // Задаем пользователя и пароль в «1С:Предприятие 8»
   V8Base.Credentials = new NetworkCredential(ConfigurationManager.ConnectionStrings[«UserOData»].ConnectionString,
       ConfigurationManager.ConnectionStrings[«PasswordOData»].ConnectionString);

   // Получаем список значений справочника валюты
   List<Catalog_Валюты> currencyCatalog = new List<Catalog_Валюты>();
   IEnumerable<Catalog_Валюты> currencyResponse = V8Base.Catalog_Валюты.Execute();
   foreach (var item in currencyResponse)
   {
       currencyCatalog.Add(item);
   }

   // Выводим курсы валют в dataGridView, подставляя Description из списка значений справочника валют
   IEnumerable<InformationRegister_КурсыВалют> coursesResponse = V8Base.InformationRegister_КурсыВалют.Execute();
   foreach (var item in coursesResponse)
   {
       string[] record =
           {
               item.Period.ToString(),
               currencyCatalog.Find(x => x.Ref_Key == item.Валюта_Key).Description,
               item.Курс.ToString()
           };
       dataGridView2.Rows.Add(record);
   }
   

10. Запускаем на выполнение и любуемся
     

Интеграция с системами на базе Android

Сказать, что мобильные приложения это хорошо — ничего не сказать. Преимуществ, которые они дают, очень много:

1. решения для увеличения продаж;
2. вся информация о вашей компании в смартфоне клиентов;
3. важные показатели бизнеса всегда под рукой;
4. улучшение качества бизнес-процессов;
5. продвижение своего приложения позволяет компании повысить собственный имидж.

Возникают трудности? Видео 6-17 шагов:

Послесловие

Интегрироваться с «1С:Предприятие 8» стало на порядок проще, надеюсь информация будет полезна сообществу. 

Статья в личном блоге

Автоматически генерируемый REST интерфейс прикладных решений 1С:Предприятия

Средства работы с JSON

Расширение поддержки протокола OData