AutoGRAPH.NET Service Config — различия между версиями

Материал из TK
Перейти к: навигация, поиск
(Конфигурация)
 
(не показана 1 промежуточная версия этого же участника)
Строка 1: Строка 1:
 
== Конфигурация ==
 
== Конфигурация ==
   
После распаковки AutoGRAPH.NET Service в какой-нибудь каталог необходимо отредактировать файл '''AutoGRAPHNETService.exe.config'''. Далее приведены описания ключей файла конфигурации:
+
После распаковки AutoGRAPH.NET Service в какой-нибудь каталог необходимо отредактировать файл '''user.config'''. Далее приведены описания ключей файла конфигурации:
  +
<pre><add key="address" value="http://localhost:8100/"/>
<pre>
 
<add key="address" value="http://localhost:800/"/>
+
<add key="address-v2" value="http://localhost:8102/"/>
<add key="address-json" value="http://localhost:810/"/>
+
<add key="address-json" value="http://localhost:8300/"/>
  +
 
<add key="common-directory" value="C:\ProgramData\AutoGRAPH Shell"/>
 
<add key="common-directory" value="C:\ProgramData\AutoGRAPH Shell"/>
  +
<add key="reports-directory" value="C:\ProgramData\AutoGRAPH Shell\Reports"/>
 
<add key="data-directory" value="C:\Users\denisio\AppData\Roaming\AutoGRAPH Shell\Data"/>
 
<add key="data-directory" value="C:\Users\denisio\AppData\Roaming\AutoGRAPH Shell\Data"/>
<add key="users-directory" value="C:\TK\DataLoader\_testusers"/>
 
<add key="devices-directory" value="C:\TK\DataLoader\_testdevices"/>
 
   
 
<add key="agserver-host" value="m.tk-chel.ru"/>
 
<add key="agserver-host" value="m.tk-chel.ru"/>
 
<add key="agserver-port" value="2230"/>
 
<add key="agserver-port" value="2230"/>
  +
<add key="agserver-protocol" value="4"/>
  +
  +
<add key="schema-load-timeout" value="180"/>
  +
<add key="schema-check-period" value="180"/>
  +
  +
<add key="timespan-to-string" value="0"/>
  +
<add key="datetime-to-string" value="0"/>
  +
<add key="driver-to-string" value="1"/>
  +
<add key="max-cpu" value="4"/>
  +
 
</pre>
 
</pre>
   
 
{| border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
 
{| border="1" cellspacing="0" cellpadding="5" style="width: 100%;"
 
 
|-
 
|-
| style="width: 137px;" | address
+
| style="width: 137px;" | address<br/>address-v2<br/>
| style="width: 1084px;" colspan="2" | локальный адрес, на котором обрабатываются запросы по протоколу [https://msdn.microsoft.com/en-us/library/dd699756(v=vs.110).aspx WCF] (<span style="line-height: 20.7999992370605px;">в настоящий момент протестирован только механизм httpBinding)</span>. Формат - url:port<br/>Варианты использования:
+
| style="width: 1084px;" colspan="1" | локальный адрес, на котором обрабатываются запросы по протоколу [https://msdn.microsoft.com/en-us/library/dd699756(v=vs.110).aspx WCF] (<span style="line-height: 20.7999992370605px;">httpBinding)</span>. Формат - url:port<br/>Варианты использования:
 
*'''<tt>[http://192.168.1.3:8000 http://192.168.1.3:8000]</tt>''' - принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)
 
*'''<tt>[http://192.168.1.3:8000 http://192.168.1.3:8000]</tt>''' - принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)
 
*'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>''' или '''<tt><code>[http://*:8000&nbsp http://*:8000]&nbsp;</code></tt>'''- <span style="line-height: 20.7999992370605px;">принимать подключения&nbsp;</span>на всех доступных локальных IP-адресах и TCP-порту 8000
 
*'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>''' или '''<tt><code>[http://*:8000&nbsp http://*:8000]&nbsp;</code></tt>'''- <span style="line-height: 20.7999992370605px;">принимать подключения&nbsp;</span>на всех доступных локальных IP-адресах и TCP-порту 8000
Строка 25: Строка 34:
 
|-
 
|-
 
| style="width: 137px;" | address-json
 
| style="width: 137px;" | address-json
| style="width: 1084px;" colspan="2" | <span style="line-height: 20.7999992370605px;">локальный адрес, на котором обрабатываются запросы по протоколу [https://en.wikipedia.org/wiki/JSON JSON]</span><span style="line-height: 20.7999992370605px;">. Формат - url:port</span><br/><span style="line-height: 20.7999992370605px;">Варианты использования:</span><ul style="line-height: 20.7999992370605px;">
+
| style="width: 1084px;" colspan="1" | <span style="line-height: 20.7999992370605px;">локальный адрес, на котором обрабатываются запросы по протоколу [https://en.wikipedia.org/wiki/JSON JSON]</span><span style="line-height: 20.7999992370605px;">. Формат - url:port</span><br/><span style="line-height: 20.7999992370605px;">Варианты использования:</span><ul style="line-height: 20.7999992370605px;">
 
<li>'''<tt>[http://192.168.1.3:8000 http://192.168.1.3:8000]</tt>'''&nbsp;- принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)</li>
 
<li>'''<tt>[http://192.168.1.3:8000 http://192.168.1.3:8000]</tt>'''&nbsp;- принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)</li>
 
<li>'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>'''&nbsp;или&nbsp;'''<tt>[http://*:8000&nbsp http://*:8000]&nbsp;</tt>'''-&nbsp;<span style="line-height: 20.7999992370605px;">принимать подключения&nbsp;</span>на всех доступных локальных IP-адресах и TCP-порту 8000</li>
 
<li>'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>'''&nbsp;или&nbsp;'''<tt>[http://*:8000&nbsp http://*:8000]&nbsp;</tt>'''-&nbsp;<span style="line-height: 20.7999992370605px;">принимать подключения&nbsp;</span>на всех доступных локальных IP-адресах и TCP-порту 8000</li>
Строка 33: Строка 42:
 
|-
 
|-
 
| style="width: 137px;" | common-directory<br/>
 
| style="width: 137px;" | common-directory<br/>
| style="width: 1084px;" colspan="2" | каталог с общими данными (структура каталога аналогична каталогу [[AutoGRAPH.NET|AutoGRAPH.NET]] – с подкаталогами Schemes, GeoFences, Devices в которых находятся соответствующие файлы схем, геозон, приборов)
+
| style="width: 1084px;" colspan="1" | каталог с общими данными (структура каталога аналогична каталогу [[AutoGRAPH.NET|AutoGRAPH.NET]] – с подкаталогами AddressBase и т.д.)
 
|-
 
|-
 
| style="width: 137px;" | data-directory<br/>
 
| style="width: 137px;" | data-directory<br/>
| style="width: 1084px;" colspan="2" | каталог данных (=data-каталог) [[AGDataLoader|AutoGRAPH DataLoader]] или [[AutoGRAPH_Server_5|AutoGRAPH Server 3.x или 4.x или 5.x]]
+
| style="width: 1084px;" colspan="1" | каталог данных (=data-каталог) [[AGDataLoader|AutoGRAPH DataLoader]] или [[AutoGRAPH_Server_5|AutoGRAPH Server 3.x или 4.x или 5.x]]
 
|-
 
|-
| style="width: 137px;" | ddd-directory
+
| style="width: 137px;" | reports-directory
| style="width: 1084px;" colspan="2" | каталог загруженных DDD-файлов (файлы карт тахографа)
+
| style="width: 1084px;" colspan="1" | каталог с шаблонами отчётов
 
|-
 
|-
| style="width: 137px;" | users-directory[[File:Tag-new.png|RTENOTITLE]]<br/>
+
| style="width: 137px;" | agserver-host<br/>
| style="width: 671px;" | Каталог с пользователями [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]], обычно он называется Users
+
| style="width: 671px;" | адрес или IP-адрес сервера [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]]
| style="width: 453px;" rowspan="2" colspan="1" | '''Если указаны эти параметры - в сервисе включается аутентификация и перед любым вызовом любого метода необходимо выполнить аутентификацию. Подробее о механизме аутентификации''' [[AutoGRAPH.NET_Service_Auth|здесь]].
 
 
|-
 
|-
| style="width: 137px;" | devices-directory[[File:Tag-new.png|RTENOTITLE]]<br/>
+
| style="width: 137px;" | agserver-port<br/>
| style="width: 671px;" | Каталог с пользователями [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]], обычно он называется DBF
+
| style="width: 671px;" | диспетчерский порт сервера [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]]&nbsp;(обычно 2230 для V4 или 2231 для V5)
 
|-
 
|-
| style="width: 137px;" | agserver-host [[File:Tag-new.png|RTENOTITLE]]<br/>
+
| style="width: 137px;" | agserver-protocol
| style="width: 671px;" | адрес или IP-адрес сервера [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]]
+
| style="width: 671px;" | протокол взаимодействия с [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]]&nbsp;- может иметь значения 4 или 5
| style="width: 453px;" rowspan="2" colspan="1" | '''Эти параметры необходимы для работы методов [[AutoGRAPH.NET_Service_SetDeviceStatus|GetDeviceStatus]] и [[AutoGRAPH.NET_Service_SetDeviceStatus|SetDeviceStatus]].
 
 
|-
 
|-
| style="width: 137px;" | agserver-port [[File:Tag-new.png|RTENOTITLE]]<br/>
+
| style="width: 137px;" | timespan-to-string
| style="width: 671px;" | диспетчерский порт сервера [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]], обычно 2230
+
| style="width: 671px;" | конвертировать значения типа TimeSpan в строку (в формат HH:MM:SS) или нет (0 или 1)
  +
|-
  +
| style="width: 137px;" | datetime-to-string
  +
| style="width: 671px;" | конвертировать значения типа DateTime в строку (в формат dd.MM.yyyy HH:MM:SS) или нет (0 или 1)
  +
|-
  +
| style="width: 137px;" | driver-to-string
  +
| style="width: 671px;" | конвертировать значения параметра Driver в строку (ФИО водителя) или оставлять значение идентификатора объекта (GUID)
 
|}
 
|}
После редактирования конфиг-файла можно запустить сервис (или консольно) и сделать запрос:<br/><pre>svcutil.exe http://localhost:800/?wsdl /async /tcv:Version35 /ser:DataContractSerializer
+
После редактирования конфиг-файла можно запустить сервис (или консольно) и сделать запрос:<br/><pre>svcutil.exe http://localhost:8100/?wsdl /async /tcv:Version35 /ser:DataContractSerializer
 
</pre>
 
</pre>
   
 
<br/>В данном случае будет создан файл AutoGRAPHSvc.cs с прокси-классом для доступа к WCF-точке сервиса AutGRAPH.NET Service и '''output.config''' файл с описанием параметров подключения WCF. Файл '''output.config''' в данном случае не используется.
 
<br/>В данном случае будет создан файл AutoGRAPHSvc.cs с прокси-классом для доступа к WCF-точке сервиса AutGRAPH.NET Service и '''output.config''' файл с описанием параметров подключения WCF. Файл '''output.config''' в данном случае не используется.
  +
  +
Сервис поддерживает работу с квантованными и неквантованными схемами с версией AutoGRAPH Server V5 и неквантованными схемами с&nbsp;AutoGRAPH Server V4. При аутентификации методом Login - фактически происходит аутентификация на AutoGRAPH Server.

Текущая версия на 19:30, 22 марта 2019

Конфигурация

После распаковки AutoGRAPH.NET Service в какой-нибудь каталог необходимо отредактировать файл user.config. Далее приведены описания ключей файла конфигурации:

<add key="address" value="http://localhost:8100/"/>
<add key="address-v2" value="http://localhost:8102/"/>
<add key="address-json" value="http://localhost:8300/"/>

<add key="common-directory" value="C:\ProgramData\AutoGRAPH Shell"/>
<add key="reports-directory" value="C:\ProgramData\AutoGRAPH Shell\Reports"/>
<add key="data-directory" value="C:\Users\denisio\AppData\Roaming\AutoGRAPH Shell\Data"/>

<add key="agserver-host" value="m.tk-chel.ru"/>
<add key="agserver-port" value="2230"/>
<add key="agserver-protocol" value="4"/>

<add key="schema-load-timeout" value="180"/>
<add key="schema-check-period" value="180"/>

<add key="timespan-to-string" value="0"/>
<add key="datetime-to-string" value="0"/>
<add key="driver-to-string" value="1"/>
<add key="max-cpu" value="4"/>

address
address-v2
локальный адрес, на котором обрабатываются запросы по протоколу WCF (httpBinding). Формат - url:port
Варианты использования:
  • http://192.168.1.3:8000 - принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)
  • http://0.0.0.0:8000 или http://*:8000 - принимать подключения на всех доступных локальных IP-адресах и TCP-порту 8000
  • http://127.0.0.1:8000 - принимать подключения только локально (обычно используется, когда приложение, которое работает со службой, установлено на том же компьютере, что и служба. При этом запросы, идущие через сетевые карты - будут игнорироваться в целях безопасности. Типичный пример - установка службы на сервере 1С:Предприятия.)
address-json локальный адрес, на котором обрабатываются запросы по протоколу JSON. Формат - url:port
Варианты использования:
  • http://192.168.1.3:8000 - принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)
  • http://0.0.0.0:8000 или http://*:8000 принимать подключения на всех доступных локальных IP-адресах и TCP-порту 8000
  • http://127.0.0.1:8000 - принимать подключения только локально (обычно используется, когда приложение, которое работает со службой, установлено на том же компьютере, что и служба. При этом запросы, идущие через сетевые карты - будут игнорироваться в целях безопасности. Типичный пример - установка службы на сервере 1С:Предприятия.)
common-directory
каталог с общими данными (структура каталога аналогична каталогу AutoGRAPH.NET – с подкаталогами AddressBase и т.д.)
data-directory
каталог данных (=data-каталог) AutoGRAPH DataLoader или AutoGRAPH Server 3.x или 4.x или 5.x
reports-directory каталог с шаблонами отчётов
agserver-host
адрес или IP-адрес сервера AutoGRAPH Server 4.x или 5.x
agserver-port
диспетчерский порт сервера AutoGRAPH Server 4.x или 5.x (обычно 2230 для V4 или 2231 для V5)
agserver-protocol протокол взаимодействия с AutoGRAPH Server 4.x или 5.x - может иметь значения 4 или 5
timespan-to-string конвертировать значения типа TimeSpan в строку (в формат HH:MM:SS) или нет (0 или 1)
datetime-to-string конвертировать значения типа DateTime в строку (в формат dd.MM.yyyy HH:MM:SS) или нет (0 или 1)
driver-to-string конвертировать значения параметра Driver в строку (ФИО водителя) или оставлять значение идентификатора объекта (GUID)

После редактирования конфиг-файла можно запустить сервис (или консольно) и сделать запрос:

svcutil.exe http://localhost:8100/?wsdl /async /tcv:Version35 /ser:DataContractSerializer


В данном случае будет создан файл AutoGRAPHSvc.cs с прокси-классом для доступа к WCF-точке сервиса AutGRAPH.NET Service и output.config файл с описанием параметров подключения WCF. Файл output.config в данном случае не используется.

Сервис поддерживает работу с квантованными и неквантованными схемами с версией AutoGRAPH Server V5 и неквантованными схемами с AutoGRAPH Server V4. При аутентификации методом Login - фактически происходит аутентификация на AutoGRAPH Server.