AutoGRAPH.NET Service Config — различия между версиями
Admin (обсуждение | вклад) (→Конфигурация) |
Admin (обсуждение | вклад) |
||
(не показана 1 промежуточная версия этого же участника) | |||
Строка 1: | Строка 1: | ||
== Конфигурация == |
== Конфигурация == |
||
− | После распаковки AutoGRAPH.NET Service в какой-нибудь каталог необходимо отредактировать файл ''' |
+ | После распаковки AutoGRAPH.NET Service в какой-нибудь каталог необходимо отредактировать файл '''user.config'''. Далее приведены описания ключей файла конфигурации: |
+ | <pre><add key="address" value="http://localhost:8100/"/> |
||
− | <pre> |
||
− | <add key="address" value="http://localhost: |
+ | <add key="address-v2" value="http://localhost:8102/"/> |
− | <add key="address-json" value="http://localhost: |
+ | <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=" |
+ | | 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  http://*:8000] </code></tt>'''- <span style="line-height: 20.7999992370605px;">принимать подключения </span>на всех доступных локальных IP-адресах и TCP-порту 8000 |
*'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>''' или '''<tt><code>[http://*:8000  http://*:8000] </code></tt>'''- <span style="line-height: 20.7999992370605px;">принимать подключения </span>на всех доступных локальных IP-адресах и TCP-порту 8000 |
||
Строка 25: | Строка 34: | ||
|- |
|- |
||
| style="width: 137px;" | address-json |
| style="width: 137px;" | address-json |
||
− | | style="width: 1084px;" colspan=" |
+ | | 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>''' - принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)</li> |
<li>'''<tt>[http://192.168.1.3:8000 http://192.168.1.3:8000]</tt>''' - принимать подключения на локальном IP-адресе 192.168.1.3 и TCP-порт 8000 (обычно данный вариант используется, если в сервере установлено несколько сетевых карт или задано несколько IP-адресов)</li> |
||
<li>'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>''' или '''<tt>[http://*:8000  http://*:8000] </tt>'''- <span style="line-height: 20.7999992370605px;">принимать подключения </span>на всех доступных локальных IP-адресах и TCP-порту 8000</li> |
<li>'''<tt>[http://0.0.0.0:8000 http://0.0.0.0:8000]</tt>''' или '''<tt>[http://*:8000  http://*:8000] </tt>'''- <span style="line-height: 20.7999992370605px;">принимать подключения </span>на всех доступных локальных IP-адресах и TCP-порту 8000</li> |
||
Строка 33: | Строка 42: | ||
|- |
|- |
||
| style="width: 137px;" | common-directory<br/> |
| style="width: 137px;" | common-directory<br/> |
||
− | | style="width: 1084px;" colspan=" |
+ | | 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=" |
+ | | style="width: 1084px;" colspan="1" | каталог данных (=data-каталог) [[AGDataLoader|AutoGRAPH DataLoader]] или [[AutoGRAPH_Server_5|AutoGRAPH Server 3.x или 4.x или 5.x]] |
|- |
|- |
||
− | | style="width: 137px;" | |
+ | | style="width: 137px;" | reports-directory |
− | | style="width: 1084px;" colspan=" |
+ | | style="width: 1084px;" colspan="1" | каталог с шаблонами отчётов |
|- |
|- |
||
− | | style="width: 137px;" | |
+ | | style="width: 137px;" | agserver-host<br/> |
− | | style="width: 671px;" | |
+ | | 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;" | |
+ | | style="width: 137px;" | agserver-port<br/> |
− | | style="width: 671px;" | |
+ | | style="width: 671px;" | диспетчерский порт сервера [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]] (обычно 2230 для V4 или 2231 для V5) |
|- |
|- |
||
− | | style="width: 137px;" | agserver- |
+ | | style="width: 137px;" | agserver-protocol |
− | | style="width: 671px;" | |
+ | | style="width: 671px;" | протокол взаимодействия с [[AutoGRAPH_Server_5|AutoGRAPH Server 4.x или 5.x]] - может иметь значения 4 или 5 |
− | | style="width: 453px;" rowspan="2" colspan="1" | '''Эти параметры необходимы для работы методов [[AutoGRAPH.NET_Service_SetDeviceStatus|GetDeviceStatus]] и [[AutoGRAPH.NET_Service_SetDeviceStatus|SetDeviceStatus]]. |
||
|- |
|- |
||
− | | style="width: 137px;" | |
+ | | style="width: 137px;" | timespan-to-string |
− | | style="width: 671px;" | |
+ | | 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: |
+ | После редактирования конфиг-файла можно запустить сервис (или консольно) и сделать запрос:<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 и неквантованными схемами с 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 Варианты использования:
|
address-json | локальный адрес, на котором обрабатываются запросы по протоколу JSON. Формат - url:port Варианты использования:
|
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.