Сервисное взаимодействие - История изменений

Oktell Support в 08:27, 26 марта 2015

2015-03-26T08:27:07Z

Peter в 11:37, 30 июня 2014

2014-06-30T11:37:30Z

Peter в 11:36, 30 июня 2014

2014-06-30T11:36:23Z

Peter в 09:34, 30 июня 2014

2014-06-30T09:34:54Z

Oktell Support в 09:20, 8 апреля 2014

2014-04-08T09:20:24Z

Oktell Support в 10:58, 1 апреля 2014

2014-04-01T10:58:18Z

Oktell Support в 13:12, 31 марта 2014

2014-03-31T13:12:50Z

Oktell Support в 13:11, 31 марта 2014

2014-03-31T13:11:17Z

Oktell Support в 13:02, 31 марта 2014

2014-03-31T13:02:31Z

Oktell Support в 13:01, 31 марта 2014

2014-03-31T13:01:53Z

@@ Строка 27: / Строка 27: @@
 <u>Структура параметра-запроса:</u>
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellxmlmapper version="80710">
-  <data name="query" count="...">
+  <data name="query" count="..."></nowiki>
     <property_set name="..." id="...">
       ...
@@ Строка 51: / Строка 51: @@
 <u>Структура ответа:</u>
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellxmlmapper version="80710">
-  <data name="queryresult" count="...">
+  <data name="queryresult" count="..."></nowiki>
     <property_set name="..." id="...">
       <property_simple key="resultcode" value="..." name="..." />
@@ Строка 77: / Строка 77: @@
 Существует единственный случай, когда ответ не имеет сопоставления с запросом - если строка XML имеет некорректный вид или нестандартный для интерфейса формат. В этом случае ответ будет возвращен в виде:
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellxmlmapper version="80710">
   <data name="queryresult" count="1">
@@ Строка 85: / Строка 85: @@
     </property_set>
   </data>
-  </oktellxmlmapper>
+  </oktellxmlmapper></nowiki>
@@ Строка 148: / Строка 148: @@
 <u>Структура запроса:</u>
-  <property_set name="db" id="...">
+  <nowiki><property_set name="db" id="...">
    <property_cdata key="sqltext"><![CDATA[...]]></property_cdata>
-  </property_set>
+  </property_set></nowiki>
@@ Строка 229: / Строка 229: @@
 <u>Структура запроса:</u>
-  <property_set name="dbdataset" id="...">
+  <nowiki><property_set name="dbdataset" id="...">
   <property_cdata key="sqltext"><![CDATA[...]]></property_cdata>
-  </property_set>
+  </property_set></nowiki>
@@ Строка 1238: / Строка 1238: @@
 <u>Структура параметра-запроса:</u>
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellxmlmapper version="80710">
   <data name="action" count="1">
@@ Строка 1245: / Строка 1245: @@
     </property_set>
   </data>
-  </oktellxmlmapper>
+  </oktellxmlmapper></nowiki>
@@ Строка 1254: / Строка 1254: @@
 При появлении в дальнейшем обязательных команд-действий структура ответа должна соответствовать приведенному виду, где в теле элемента property_set содержится контекстно-зависимое содержимое.
-  <?xml version="1.0" encoding="utf-16"?>
+  <nowiki><?xml version="1.0" encoding="utf-16"?>
   <oktellxmlmapper version="80710">
   <data name="actionresult" count="1">
@@ Строка 1261: / Строка 1261: @@
     </property_set>
   </data>
-  </oktellxmlmapper>
+  </oktellxmlmapper></nowiki>

← Предыдущая		Версия 11:37, 30 июня 2014
Строка 1175:		Строка 1175:

	*<h4>getpath</h4>		*<h4>getpath</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Возвращает пути на сервере: рабочий каталог, временный каталог, каталог с веб-документами, и т.д.

	*<h4>getconfigvalue</h4>		*<h4>getconfigvalue</h4>

← Предыдущая		Версия 11:36, 30 июня 2014
Строка 1172:		Строка 1172:
	<property_cdata key="resultdata"><![CDATA[...текстовые данные - результат выполнения...]]></property_cdata>		<property_cdata key="resultdata"><![CDATA[...текстовые данные - результат выполнения...]]></property_cdata>
	</property_set>		</property_set>
		+
		+
		+	*<h4>getpath</h4>
		+
		+	*<h4>getconfigvalue</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Возвращает значение параметра из конфигурационного файла сервера.
		+
		+	*<h4>getversion</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Возвращает информацию о версии сервера.
		+
		+	*<h4>reloadpbxss</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Инициирует перезапуск сервера состояний.
		+
		+	*<h4>updatehttpsession</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Обновляет/создает http-сессию на веб-сервере Oktell.
		+
		+	*<h4>removehttpsession</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Удаляет http-сессию на веб-сервере Oktell.
		+
		+	*<h4>updateplugin</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Инициирует обновление плагина
		+
		+	*<h4>getcurrentlanguage</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Возвращает используемый сервером язык.
		+
		+	*<h4>getlicense</h4>
		+
		+	Доступно только для серверных плагинов.
		+	Возвращает информацию о регистрации и список лицензий сервера. В зависимости от параметров может возвращать только сущностную информацию, исключая описания и дополнительные сведения, также может возвращать информацию только по запрошенным кодам продуктов, и с фильтрацией удаленных, заблокированных и просроченных временных лицензий.
		+

← Предыдущая		Версия 09:34, 30 июня 2014
Строка 910:		Строка 910:


−	<h4>Коды команд:</h4>	+	<u>Коды команд:</u>

	hookup = 1 <span style="color:darkviolet">//снята ли трубка </span>		hookup = 1 <span style="color:darkviolet">//снята ли трубка </span>

← Предыдущая		Версия 09:20, 8 апреля 2014
Строка 829:		Строка 829:
	Ответ содержит стандартные поля '''resultcode''' и '''resultdescription'''.		Ответ содержит стандартные поля '''resultcode''' и '''resultdescription'''.

−	События, генерируемые приложением, будут поступать после подписки на соответствующее направление в plugin-программу путем вызова метода [[~~Метод DoQuery~~\|DoQuery]]. В параметре будет указан тип и код направления, тип и код события, а также дополнительные параметры конкретного события. При этом событийные направления определяют [[Допустимые типы запросов DoQuery\|допустимые типы запросов]] с кодами 203**.	+	События, генерируемые приложением, будут поступать после подписки на соответствующее направление в plugin-программу путем вызова метода [[Сервисное_взаимодействие#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4_DoQuery\|Метод DoQuery]]. В параметре будет указан тип и код направления, тип и код события, а также дополнительные параметры конкретного события. При этом событийные направления определяют [[Допустимые типы запросов DoQuery\|допустимые типы запросов]] с кодами 203**.

@@ Строка 1: / Строка 1: @@
-[[Встраиваемые_plugin-модули|Наверх]]
+{|cellpadding="10" cellspacing="0" border="0"
 __TOC__
@@ Строка 1369: / Строка 1375: @@
 Список возможных сервисных команд будет пополняться. В случае, если вам необходимо получить дополнительный функционал, обращайтесь с предложениями на [http://oktell.ru/ сайт компании Телефонные системы]

@@ Строка 984: / Строка 984: @@
 <u>Структура запроса:</u>
-<property_set name="getspecifieduserfullinfo" id="...">
+ <property_set name="getspecifieduserfullinfo" id="...">
-<property_set name="user">
+ <property_set name="user">
-<property_cdata key="id"><![CDATA[xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx]]></property_cdata>
+ <property_cdata key="id"><![CDATA[xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx]]></property_cdata>
-<property_simple key="login" value="..." />
+ <property_simple key="login" value="..." />
-<property_simple key="name" value="..." />
+ <property_simple key="name" value="..." />
-</property_set>
+ </property_set>
-</property_set>
+ </property_set>

@@ Строка 323: / Строка 323: @@
 Если требуется подключение к собственной БД Oktell, поле direction можно не указывать. Для подключения к сторонним БД необходимо указание строки подключения к БД (поле <span style="color:green">connectionstring</span>). Если осуществляется подключение к собственной БД Oktell, строка подключения игнорируется. Необходимо также определить поле checkcode, являющееся произвольным числовым значением, которое будет гарантировать доступ к транзакции только исполнителю. На каждом последующем режиме работы с транзакцией требуется указание того <span style="color:green">checkcode</span>, который был определен при создании подключения. В противном случае метод не будет выполнен и будет возвращен код соответствующей ошибки (50045). Для создания новой транзакции необходимо сначала дождаться окончания выполнения предыдущей, или закрыть ее принудительно (методами '''Commit''' или '''Rollback''' с совпадающим кодом checkcode). Если в момент создания уже существует активная транзакция, будет возвращен код ошибки 50047.
-Режим <span style="color:darkorange">Query<span> осуществляет запрос через ранее созданное подключение и активную транзакцию. Cтруктуру, получаемую на сервере, загружает в DataSet и формирует на ее базе XML строку, преобразованную в Base64. Для обратного преобразования необходимо полученную из поля CDATA строку подвергнуть обработке следующим кодом (C#):
+Режим <span style="color:darkorange">Query</span> осуществляет запрос через ранее созданное подключение и активную транзакцию. Cтруктуру, получаемую на сервере, загружает в DataSet и формирует на ее базе XML строку, преобразованную в Base64. Для обратного преобразования необходимо полученную из поля CDATA строку подвергнуть обработке следующим кодом (C#):
   DataSet ds = <span style="color:blue">new</span> DataSet();
@@ Строка 492: / Строка 492: @@
 <u>Структура запроса:</u>
-<property_set name="notify" id="...">
+ <property_set name="notify" id="...">
-<property_simple key="type" value="..." /> ("info", "warn", "err", "color")
+ <property_simple key="type" value="..." /> ("info", "warn", "err", "color")
-<property_simple key="autohide" value="..." /> ("1", "0")
+ <property_simple key="autohide" value="..." /> ("1", "0")
-<property_simple key="savedb" value="..." /> ("1", "0")
+ <property_simple key="savedb" value="..." /> ("1", "0")
-<property_simple key="color" value="..." /> ("White", "LightRed", "Green", "Azure", "DarkKhaki", ...)
+ <property_simple key="color" value="..." /> ("White", "LightRed", "Green", "Azure", "DarkKhaki", ...)
-<property_cdata key="sender"><![CDATA[...]]></property_cdata>
+ <property_cdata key="sender"><![CDATA[...]]></property_cdata>
-<property_cdata key="text"><![CDATA[...]]></property_cdata>
+ <property_cdata key="text"><![CDATA[...]]></property_cdata>
-</property_set>
+ </property_set>
@@ Строка 515: / Строка 515: @@
-[[Файл:Сервисное взаимодействие 001.png]]
+[[Файл:Сервисное взаимодействие 001.png|center]]
@@ Строка 620: / Строка 620: @@
-<>Структура запроса:
+<u>Структура запроса:</u>
   <property_set name="faxsend" id="...">
@@ Строка 627: / Строка 627: @@
-Ответ содержит стандартные поля resultcode и resultdescription, а также поле faxsendresult с результатом выполнения команды на отправку. В нем "0" указывает на обрыв выполнения команды из-за несоответствия условий, например, если на оппозитном канале отсутствует функция факса.
+Ответ содержит стандартные поля '''resultcode''' и '''resultdescription''', а также поле '''faxsendresult''' с результатом выполнения команды на отправку. В нем "0" указывает на обрыв выполнения команды из-за несоответствия условий, например, если на оппозитном канале отсутствует функция факса.
@@ Строка 674: / Строка 674: @@
 <u>Структура запроса:</u>
-<property_set name="downloadrecordsbychain" id="...">
+ <property_set name="downloadrecordsbychain" id="...">
-<property_cdata key="idchain"><![CDATA[...]]></property_cdata>
+ <property_cdata key="idchain"><![CDATA[...]]></property_cdata>
-<property_cdata key="folderpath"><![CDATA[...]]></property_cdata>
+ <property_cdata key="folderpath"><![CDATA[...]]></property_cdata>
-</property_set>
+ </property_set>
@@ Строка 735: / Строка 735: @@
 <u>Структура запроса:</u>
-<property_set name="downloadfilefromserver" id="...">
+ <property_set name="downloadfilefromserver" id="...">
-<property_cdata key="localpath"><![CDATA[...]]></property_cdata>
+ <property_cdata key="localpath"><![CDATA[...]]></property_cdata>
-<property_cdata key="serverpath"><![CDATA[...]]></property_cdata>
+ <property_cdata key="serverpath"><![CDATA[...]]></property_cdata>
-<property_simple key="isrelative" value="0" />
+ <property_simple key="isrelative" value="0" />
-</property_set>
+ </property_set>
@@ Строка 1113: / Строка 1113: @@
 Структура взаимодействия представляет собой цепочку:
-Client1.Plugin -> Server -> Client2.Plugin -> Server -> Client1.Plugin
+'''Client1.Plugin''' -> '''Server''' -> '''Client2.Plugin''' -> '''Server''' -> '''Client1.Plugin'''

@@ Строка 41: / Строка 41: @@
 ===Возвращаемое значение (ответ приложения Oktell на запрос plugin-программы)===
 <u>Структура ответа:</u>
@@ Строка 92: / Строка 93: @@
   ErrorInputXml        = 105, <span style="color:darkviolet">//Ошибка при разборе XML-содержимого запроса </span>
+  }
-−
 ===Допустимые типы запросов===

@@ Строка 1229: / Строка 1229: @@
 <u>Структура передаваемого запроса:</u>
-<property_set name="tabchange" id="20101">
+ <property_set name="tabchange" id="20101">
-<property_simple key="idplugin" value="b3daa197-f539-22f1-bc5a-8442fa9334ec" />
+ <property_simple key="idplugin" value="b3daa197-f539-22f1-bc5a-8442fa9334ec" />
-<property_simple key="idform" value="817d77a7-5d0e-4783-9304-e310c2ac3443" />
+ <property_simple key="idform" value="817d77a7-5d0e-4783-9304-e310c2ac3443" />
-<property_simple key="idshow" value="2e2d8ff0-de47-415f-ab68-9bddcd09952b" />
+ <property_simple key="idshow" value="2e2d8ff0-de47-415f-ab68-9bddcd09952b" />
-<property_simple key="actiontype" value="20101" name="TabChange" />
+ <property_simple key="actiontype" value="20101" name="TabChange" />
-<property_simple key="activeindex" value="3" />
+ <property_simple key="activeindex" value="3" />
-</property_set>
+ </property_set>