Документация на dde сервер

вариант lite

Luxidsoft 2010

Ограничения по сравнению с полной версией dde.exe: 2

Состав ПО   2

Возможности и схема работы   2

 


Исполняемый модуль dde_lite.exe предназначен для вывода поступающих по dde данных в стандартный поток вывода.

Ограничения по сравнению с полной версией dde.exe:

  1. В системе можно стартовать только один экземпляр dde_lite.exe.
  2. В dde_lite.exe отключена возможность анализа поступающих данных в параллельно работающем потоке.

Состав ПО

  1. dde_lite.exe – приложение принимающее данные по  dde
  2. dde.wsc – скриптовый COM объект
  3. exit.exe – приложение завершающее работу dde_lite.exe

Возможности и схема работы

1.   При запуске исполняемого модуля dde_lite.exe в качестве параметра командной строки можно указать выражение

/?

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

2.   Если в системе уже имеется запущенный dde_lite.exe, то последующие попытке стартовать копию приложения будут проигнорированы.

3.   Обязательным условием работы приложения является наличие в каталоге запуска dde_lite.exe файла dde.wsc. Данный файл представляет собой скриптовый COM объект со следующими методами:

a.     StartEXE(path, cmdline,params)

Этот метод выполняется при старте приложения. Параметрами ему служат:

path – каталог запуска приложения dde_lite.exe

cmdline – командная строка запуска приложения dde_lite.exe

params – скриптовый объект, служащий для инициализации работы приложения

данный метод возвращает целое значение, в случае если оно меньше нуля, то приложение завершает работу.

b.     ErrorEXE(errordescription)

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

errordescriptionтекстовое описание ошибки

c.     StopEXE()

Метод выполняется при нормальном завершении работы приложения.

4.   Через параметр params метода StartEXE можно указать начальные параметры работы dde_lite.exe. По смыслу это схоже с работой ini фалов.

Существует возможность указать следующие параметры:

Наименование

Тип

Обязательность

Описание

Пример

servername

Не пустая строка

Да

Задает имя dde сервера, куда надо отправлять данные для обработки приложением.

excel

pipe_app

Не пустая строка

Да

Может быть заполнено значением selfв этом случае данные будут передаваться в стандартный поток вывода, иначе необходимо указать путь к приложению, которое будет запущено и в стандартный потока ввода которого будет направлены данные.

self

out.exe

pipe_size

Не отрицательное целое

Нет, только если в качестве параметра pipe_app указано стороннее приложение

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

1000

rows_num

Не отрицательное целое

Да

Задает число первых строк таблицы, которые будут выводиться в поток вывода. Если задать этому параметру значение 0, то выводиться будут все строки таблицы

12

EOL

Не пустая строка

Нет

Разделяет строки, выводимые в поток. Если параметр не задан, то по умолчанию в качестве разделителя используется два символа с ASCII кодами 13 и 10

Chr(21)

 

5.   В случае если параметр pipe_app не равен self, то при старте dde_lite.exe стартует дочерний процесс, указанный в этом параметре, который связан с родительским процессом через поток.

6.   Формат вывода данных в поток вывода следующий:

[<topic>]<item><знак равно><value(1,1)>chr(1)<value(1,2)>chr(1) …<value(n,m)><EOL>

Где

<topic>, <item> - значения настроек для DDE

<value(i,j)>  - значение таблицы в i-м ряду и j-м столбце

chr(1) – символ с ASCII кодом 1

<EOL>  - значение настроек из StartEXE

 

Пример строки:

[TVS]1=1.02 chr(1) Сбербанк chr(1) 2 chr(13) chr(10)

7.   В случае возникновения ошибки в процессе работы будет вызван метод ErrorEXE скриптового объекта dde.wsc, после чего приложение завершит свою работу. Причину ошибки можно узнать через параметр errordescription метода ErrorEXE  .

8.   Для завершения работы приложения необходимо запустить исполняемый модуль exit.exe, а в качестве параметра командной строки указать имя dde сервера, который необходимо остановить.

Пример:

dde.exe excel

9.   При корректном завершении приложения вызывается метод StopEXE скриптового объекта dde.wsc.

 

Пример запуска

dde.exe > TEST.TXT