Интеграция АСУ ВРК с другими учетными системами (Универсальная)

АСУ ВРК предоставляет возможность взаимодействия с Вашим приложением посредством REST-сервиса. Поскольку сервис использует для получения/отправки данных протокол HTTPS, то интеграция возможна независимо от Вашей операционной системы, что не только делает АСУ ВРК максимально доступной системой для разработчиков других приложений, но и становится актуальным при современном развитии альтернативных сред. Данная возможность предоставляется бесплатно.

Подключение к REST API АСУ ВРК происходит по адресу

https://asuvrk.com:5849/

Подробная документация по архитектуре API-интерфейса

AsuVrkApi.yaml

(файл создан на основе спецификации OpenAPI для описания и документирования API, рекомендуем открывать с помощью Swagger)

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

+Пример использования на языке 1С

Функция ПолучитьСоединение(Сервер, Пользователь, Пароль, ПолучитьТокен = Ложь) Экспорт
  Если Нрег(Сервер) = "asuvrk.com" Тогда
    Соединение = Новый HTTPСоединение(Сервер,5849,,,,,Новый ЗащищенноеСоединениеOpenSSL);
  Иначе
    Соединение = Новый HTTPСоединение(Сервер,5849);
  КонецЕсли;
  
  стрВых = Новый Структура;
  стрВых.Вставить("Соединение", Соединение);
  
  Если ПолучитьТокен = Истина Тогда
    Заголовки = Новый Соответствие;
    Заголовки.Вставить("Content-Type", ОбщегоНазначенияТСД.ТипКонтекстаJSON());
    
    ТекстЗапроса = 
    "{
    |""login"": """ + СокрЛП(Пользователь) + """,
    |""pass"": """ + СокрЛП(Пароль) + """
    |}";
    Запрос = Новый HTTPЗапрос("/Auth", Заголовки);
    Запрос.УстановитьТелоИзСтроки(ТекстЗапроса);
    
    Ответ = Соединение.ОтправитьДляОбработки(Запрос);
    
    ЧтениеJSON = Новый ЧтениеJSON;
    стрОтвет = Ответ.ПолучитьТелоКакСтроку();
    //стрОтвет = СтрЗаменить(стрОтвет, ";", ",");
    ЧтениеJSON.УстановитьСтроку(стрОтвет);
    
    
    Данные = ПрочитатьJSON(ЧтениеJSON, Ложь);
    Если Данные.Свойство("result")
      и Данные.result = 3
      Тогда
      Сообщить("Ошибка авторизации АСУ ВРК: " + Данные.message);
      Возврат стрВых;
    Иначе
      Токен = Данные.token;
      стрВых.Вставить("Токен", Токен);
    КонецЕсли;
  КонецЕсли;
  
  Возврат стрВых;
КонецФункции // ПолучитьСоединение()

Интеграция АСУ ВРК с 1С и другими учетными системами (Windows)

Для интеграции АСУ ВРК с другими системами существует COM-объект который может быть использован практически в любом языке программирования. Для использования COM-объекта АСУ ВРК (asu_vrk_com.dll или asu_vrk_com64.dll) необходимо зарегистрировать его по помощи regsvr32 (от имени администратора). Данная возможность предоставляется бесплатно.

Вы можете скачать для изучения пример внешней обработки для платформы 1С:Предприятие 8.3 (ЗагрузкаАСУВРК.epf), использующей данный COM-объект. Обработка предоставляется "как есть".

Текущая версия COM-объекта - 25.3.26

Внимание - в силу особенностей работы 1С не рекомендуем в одной сессии работы 1С создавать два и более объекта iASUVRK, при этом первый изначально созданный объект ведет себя не стабильно

Также рекомендуем избегать длинных конструкций. Например,
АСУВРК.GetVagonComplekt(Код).OUT.BR_count
лучше сделать так:
k=АСУВРК.GetVagonComplekt(Код).OUT;
k.BR_count

Изменения в версии 26.1.14:

В функцию GetContract добавился параметр DT, в который надо передать дату документа для которого выбирается договор или текущую дату

Изменения в версии 24.10.29:

В объект iRepDetail добавлены свойства:
Data_ECP_D1 - дата подписи ЭСФ со стороны ВЧДр/ВРП;
Data_ECP_S1 - дата подписи ЭСФ со стороны собственника;

Описание в справке ниже.

Изменения в версии 24.1.12:

В объект iSkladEx добавлен метод AddPK - добавление кассетного подшипника в документ склада.

Описание в справке ниже.

Изменения в версии 23.12.7:
Изменение представления данных.
В объекте iDetalRp изменено свойство VIEW_NAME. Теперь эта строка полностью соответствует наименованию детали (на вкладке Детали) в табличной части АРМ Ремонта деталей АСУ ВРК.

Изменения в версии 23.12.6:
Оптимизация Базы Данных.
Из объекта iVKMdata удалено свойство: SMAZKA2, так как марка смазки для обоих подшипников на колесной паре всегда одинаковая, достаточно свойства SMAZKA1.

Изменения в версии 23.11.23:
В объекты iSkladEx, iKeepCost и iRepDetail добавлено свойство: Document_checked - документ проверен собственником.

Описание в справке ниже.

Изменения в версии 23.11.17:
В объекты iSkladEx и iRepDetail добавлено свойство: KodDocReinstall - код связанного документа перевыставления.
В объект iVagon добавлено свойство: CHECKDATE - дата первой полной проверки собственником.

Описание в справке ниже.

Изменения в версии 23.10.25:
В объект iSkladEx добавлено свойство: SNAME - Наименование собственника.

Описание в справке ниже.

Изменения в версии 23.8.16:
В объекты iVagon,iRepDetail,iGroupInfo,iKeepCost добавлено свойство: NomerChet - Номер счета на оплату.

Описание в справке ниже.

Изменения в версии 23.7.5:
В объект iVKMdata добавлено свойство: DISK_TO_PODR - флаг принадлежности снятых дисков

Описание в справке ниже.

Изменения в версии 23.6.15:
В объекты iSkladEx и iRepDetail добавлено свойство: ReinstallFrom - признак перевыставления документа

Описание в справке ниже.

Изменения в версии 23.4.17:
В объект iSkladEx добавлено свойство: DEL - признак удаления документа

Описание в справке ниже.

Изменения в версии 23.2.27:
В объект iVagon добавлено свойство: ReinstallFrom - Возвращает код депо - источника перевыставления

Описание в справке ниже.

Изменения в версии 23.2.10:
В объект iDetalRp добавлен метод: GETKP - Возвращает объект iKPDetal с данными по колесной паре

Описание в справке ниже.

Изменения в версии 23.1.30:
В объект iKeepCost добавлено свойство: DEL - признак удаления документа

Описание в справке ниже.

Изменения в версии 23.1.26:
Изменен метод SaveVKMdata объекта iKPDetal;
добавлен объект iNewHIDVKM

Описание в справке ниже.

Изменения в версии 23.1.25:
В объект iVagon добавлены свойства:
Nomer_KPR номер платежно-расчетного документа;
Data_KPR дата платежно-расчетного документа;

Описание в справке ниже.

Изменения в версии 23.1.23:
В объект iDTHistoryInfo добавлено свойство: SKLAD_DOC_ID - код документа АРМ Склад

Описание в справке ниже.

Описание доступных интерфейсов и методов, экспортируемых COM-объектом.

+iASU_VRK - основной интерфейс для доступа к данным

Ни один из ниже описанных объектов не может быть создан на стороне клиента.

+iVagons - возвращает список вагонов, полученных ранее из объекта iASU_VRK функция GetVagons

+iVagonsScrap - возвращает список вагонов, полученных ранее из объекта iASU_VRK функция GetVagonsScrap

+iJobs - возвращает список работ, производившихся на вагоне

+iAktDopS - возвращает список Актов допуска к текущему вагону

+iAktDop - возвращает параметры Акта допуска

+iAvrs - возвращает список строк АВР

+iVagonMessages - возвращает список замечаний и коментариев относительно вагона

+iVagonMXList - возвращает список лома и деталей, взятых на хранение с вагона

+iVagonReplaceDetList - возвращает список замененных деталей на вагоне

+iJob - возвращает параметры выполненной работы

+iAvr - возвращает параметры строки акта выполненных работ

+iDetal - возвращает параметры детали, стоимость которой устанавливается отдельно от работы

+iVagonMX - возвращает параметры детали, взятой на хранение или в лом с вагона

+iVagonReplaceDet - возвращает параметры замененной детали

+iModel - возвращает информацию о модели вагона

+iVagon - возвращает параметры вагона

+iVU23 - возвращает параметры ВУ-23 вагона.

+iVU4M - возвращает параметры паспорта ВУ-4М.

+iVagonScrap - возвращает параметры вагона с разделки

+iScrapDetal - содержит параметры лома снятого в вагона после разделки

+iBankDetails - содержит банковские реквизиты

+iContract - возвращает параметры договора

+iGroupList - возвращает список групп вагонов в АРМ ремонта вагонов

+iTelRamaGapList - возвращает список зазоров тележек с вагона (в АРМ ремонта вагонов)

+iTelRamaGap - содержит информацию о зазорах тележек на вагоне

+iDTHistoryList - возвращает список деталей при запросе истории детали, так как деталей с одинаковыми номерами может быть две и более

+iScraps - возвращает список доступных детлей для добавления под вагон (АРМ разделки)

+iContracts - возвращает список доступных договоров

+iDetalComplekt - содержит информацию по входной и выходной комплектации

+iVagonDetails - содержит информацию о кол-ве деталей на вагоне на входе или на выходе из ремонта

+iVagonDetal - содержит информацию о детали, полученную ранее при помощи объекта iVagonDetails

+iVagonModels - возвращает список доступных моделей вагонов

+iSkladExDocs - содержит список документов, заведенных в АРМ склад

+iRemains - содержит информацию о детали из остатков (это может быть колесная пара, боковая рама, автосцепка и т.д.)

+iSkladEx - содержит документ, заведенный в АРМ склад

+iSkladExMat - содержит информацию о материале, добавленном в АРМ склад

+iKPDetal - содержит информацию о колесной паре.

+iGroupInfo - содержит информацию о группировке вагонов в один акт выполненных работ

+iDTHistoryRows - возвращает список строк из истории конкретной детали, нумерация начинается с 0 и продолжается до Count-1.

+iDTHistoryInfo - содержит подробную информацию о записи в истории детали или ее актуальном состоянии

+iVagonMessage - содержит подробную информацию о коментарии собственника к вагону

+iVagonTypes - возвращает справочник типов вагонов

+iVKMdata - возвращает данные о КП из ВКМ

+iNewHIDVKM - возвращает код Оси(или код КП), полученной в АРМ ВКМ при расформировании(формировании)
(результат метода SaveVKMData объекта iKPDetal)

АРМ Ремонта деталей:

+iRepDetails - возвращает список документов, полученных ранее из объекта iASU_VRK функция GetRepDetails

+iRepDetail - возвращает параметры документа АРМ Ремонта деталей

+iRemDetMXList - возвращает список лома образованного при ремонте детали

+iRemDetMX - возвращает параметры детали или в лома

+iDetalRp - содержит информацию о детали, полученную ранее при помощи метода GetDetalRp

АРМ Расчёта стоимости и хранения:

+iKeepCosts - возвращает список документов, полученных ранее из объекта iASU_VRK функция GetKeepCosts

+iKeepCost - возвращает параметры документа АРМ Расчёта стоимости и хранения

+Пример использования на языке 1С

+Пример использования на языке Delphi

+Пример использования на языке C#

using System;
using asu_vrk_com;
 
namespace AsuVrkService
{
    internal class Program
    {
        public static void Main(string[] args)
        {
            // Подключение может быть сделано один раз на протяжении жизни переменной
            var asuVrk = (IASUVRK)Activator.CreateInstance(Type.GetTypeFromProgID("asu_vrk_com.ASUVRK"));
            // в качестве параметров указывает IP адрес или имя сервера где установлена база АСУ ВРК и логин пароль для доступа к данным
            var connectResult = asuVrk.ConnectToBase("*.*.*.*","UserName","Pass");
            if (connectResult != 0)
            {
                Console.WriteLine($"Не удалось подключится к базе АСУ ВРК {asuVrk.GetLastError}");
                return;
            }
            var fromDate = new DateTime(2013,07,24);
            var toDate = new DateTime(2015,07,24);
 
            var vagons = (IVagons) asuVrk.GetVagons(54186275, fromDate, toDate, 0, 0);
 
            for (var i=0; i<vagons.Count;i++)
            {
                // получаем данные по вагону, среди данных могут быть доступны почти все параметры вагона, данный функционал постоянно развивается
                var vagon = (IVagon) vagons.GetVagon(i);
                Console.WriteLine(vagon.DepoId);
            }
        }
    }
}