ИНСТРУКЦИЯ

ПО ФУНКЦИОНАЛЬНОМУ ВЗАИМОДЕЙСТВИЮ АВТОМАТИЗИРОВАННОЙ СИСТЕМЫ ЭТРАН

С АСУ ЭКСПЕДИТОРА

“УТВЕРЖДАЮ”

Главный инженер проекта

_________________

“____“ _______________ 2007 г.

АННОТАЦИЯ

Настоящий документ содержит инструкцию разработчикам программного обеспечения экспедиторских компаний по реализации функционального взаимодействия АСУ экспедиторских компаний с системой ЭТРАН в части заявок на перевозку грузов и транспортных накладных.

СОДЕРЖАНИЕ

Перечень условных обозначений и сокращений.. 4

1. Общие положения.. 4

1.1. Программное обеспечение обмена данными посредством СОМ-объекта 5

1.1.1 Пример работы через СОМ-объект. 5

1.2. Программное обеспечение обмена данными с использовнием SOAP протокола.. 6

1.2.1 WSDL описание метода GETBLOCK. 7

1.3. Адрес обработчика запросов на стороне ЭТРАН.. 8

2. Состав и содержание информации обмена.. 9

2.1. Заявка на перевозку груза.. 9

2.1.1 Запрос данных заявки на перевозку.. 10

2.1.2 Запрос изменений заявок по плательщику.. 16

2.1.3 Запрос подтверждения визирования заявки экспедитором.. 17

2.1.4 Запрос отказа визирования заявки экспедитором.. 18

2.2. Электронная накладная.. 18

2.2.1 Запрос данных накладной.. 19

2.2.2 Запрос статуса накладных по плательщику.. 31

2.3. Подача обращения по провозной плате. 32

2.3.1 Получение данных обращения по провозной плате. 33

2.3.2 Подача обращения по провозной плате к накладной.. 34

2.4. Запрос операций над документом.. 46

2.5. Запрос связанных документов.. 48

НЕ нашли? Не то? Что вы ищете?

Перечень условных обозначений и сокращений

ЭТРАН

Электронная ТРАнспортная Накладная. Автоматизированная система централизованной подготовки и оформления перевозочных документов

АСУ

Автоматизированная система управления

АБДПВ

Автоматизированная база данных парка вагонов

БД

База Данных

АРМ ППД

Автоматизированное Рабочее Место Подготовки Перевозочных Документов

НСИ

Нормативно-справочная информация

ПТК

Программно технический комплекс

СУБД

Система Управления Базами Данных

XML

Extended Markup Language

WSDL

Web Services Description Language

2.  Общие положения

В настоящее время реализованы две возможности организации информационного взаимодействия между системой ЭТРАН и АСУ Экспедитора: COM-сервер и обмен данными с использованием SOAP протокола.

В первом случае программное обеспечение взаимодействия представляет собой COM-сервер для Win32-платформ и работает под управлением операционной системы Windows 2000 в составе ПТК АСУ Экспедитора. Программное обеспечение АСУ Экспедитора взаимодействует с «Сервером приложений системы ЭТРАН».

Обмен данными с использованием SOAP протокола предназначен для ситуаций, когда обмен данными посредством COM–объекта затруднен, например, при использовании АСУ Экспедитора операционной системы, отличной от Windows. В таких случаях имеется возможность обмениваться информационными пакетами по протоколу SOAP 1.1 – Simple Object Access Protocol (описание протокола доступно по адресу http://www. w3.org/TR/SOAP/).

АСУ Экспедитора, на базе которой функционирует программное обеспечение (ПО) взаимодействия, должна быть оборудована сертифицированными средствами защиты информации.

При передаче информации из АСУ Экспедитора в систему ЭТРАН, ПО организации взаимодействия производит форматный контроль передаваемой информации по следующим принципам:

·  Значения реквизитов указываются в поле value в виде строки символов в кодировке 1251, обрамленной двойными кавычками;

·  Спецсимволы внутри строки заменяются по правилам формирования XML ('&' заменяется на '&amp;', '<' – на '&lt;', '>' – на '&gt;', '"' – на '&quot;', ''' – на '&apos;');

·  Пустое значение параметра либо обозначается двумя двойными кавычками, либо параметр не указывается вообще;

·  При передаче дробных числовых значений в качестве десятичного разделителя используется точка;

·  При передаче даты и времени используется формат ‘dd. mm. yyyy hh:nn:ss’;

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

Кроме форматного контроля производится контроль в соответствии с технологией ЭТРАН для обработки соответствующего типа информации.

2.1.  Программное обеспечение обмена данными посредством СОМ-объекта

Для установки программного обеспечения необходимо запустить программу установки EtranASUGO. exe в комплекте дистрибутива. При установке необходимо указать директорию для размещения файлов ПО.

Таблица 1

procedure Connect(const URL: WideString; const User: WideString;
const Password: WideString)

Установка соединения с сервером приложений Etran.

URL - адрес

User - имя пользователя

Password - пароль

procedure Disconnect

Завершает соединение соединение с сервером приложений Etran.

function Call(XML: OleVariant): OleVariant

Осуществляет передачу запроса на сервер и возвращает ответ.

XML – содержание запроса

Результат функции – возращенный ответ

property Connected: Boolean

* Установка и опрос состояния соединения.

При установке соединения (аналог функции Connect) должны быть заданы свойства URL, EtranUserName, EtranPassword.

property URL: WideString

* Адрес сервера приложений Etran.

property EtranUserName: WideString

* Имя пользователя

property EtranPassword: WideString

* Пароль

property ConnectTimeOut: Integer

* TimeOut (в секундах) на соединение.

Значение по умолчанию 120 сек., минимальное значение 20 сек. (генерируется 100 ошибка - “TimeOut”)

property CallTimeOut: Integer

* TimeOut (в секундах) на выполнение запроса.

Значение по умолчанию 1200 сек., минимальное значение 120 сек. (генерируется 100 ошибка - “TimeOut”)

Табл. 1. Методы и свойства COM-объекта

Указанные выше свойства доступны в COM-объекте начиная с версии 6.9.1.1

2.1.1  Пример работы через СОМ-объект

Пример на Visual Basic

‘Создание объекта СОМ-объекта

Set Etran=CreateObject(‘EtranASUGO. EtranASUGO’)

‘Установка соединения

Etran. Connect(“http://etran/EtranServer/EtranHttpSrvr. dll","User","Password")

‘Обмен данными

RetStr=Etran. Call(“<getClaim>….")

…

‘Обработка результата в RetStr

При использовании COM-объектов следует особое внимание обратить на ошибки с типом 100 - это внутренние ошибки COM-объекта, т. е. ошибки, произошедшие на стороне COM-объекта.

В большинстве случаев появление такой ошибки означает, что не был получен ответ от БД ЭТРАНа на каком-либо этапе работы:

·  база данных ЭТРАН на данный момент недоступна. Например, ошибка типа "В связи с установкой версии 6.8.2.3 система остановлена до 10:38";

·  недоступен сервер приложений (СП) ЭТРАН: "A connection with the server could not be established";

·  СП не может подключиться к БД ЭТРАНа: "ORA-03114: not connected to ORACLE".

Общие рекомендации обработки ошибки типа 100 состоят в выполнении следующих шагов последовательно до получения положительного ответа на запрос:

·  вызвать метод disconnect и connect и вызвать заново метод Call;

·  уничтожить и создать COM-объект заново, вызвать метод connect и метод Call;

·  попытаться изменить сервер приложений Этран, вызвать метод connect и метод Call;

·  уничтожить и создать COM-объект заново, изменить сервер приложений Этран, вызвать метод connect и метод Call.

Количество возможных вызовов каждого варианта зависит от стабильности канала связи, используемого СП и ряда других факторов. Четких рекомендаций быть не может, т. е. желательно сделать этот параметр настраиваемым. Ориентировочно это 1-2 попытки на каждый шаг.

2.2.  Программное обеспечение обмена данными с использованием SOAP протокола

С целью обмена данными с использованием SOAP протокола необходимо реализовать в АСУ Экспедитора программу-клиент, которая будет посылать в ЭТРАН команду GetBlock c необходимым запросом, а в ответ будет принимать результат обработки переданной информации.

Описание функции:

boolean GetBlock(string Login, string Password, string Text),

Результат функции – логический, при успешной обработке возвращает значение True, при ошибке обработки запроса – False.

В параметрах Login и Password – передаются идентификатор пользователя и его пароль.

В параметре Text – непосредственно команда запроса, в этом же параметре возвращается результат обработки информации.

WSDL описание приведено ниже.

2.2.1  WSDL описание метода GETBLOCK.

<?xml version="1.0"?>

Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21