AutoGRAPH.NET Service (EN)

AutoGRAPH.NET Service provide different protocols for integration with external systems. Currently we have two protocols for this: WCF (Windows communication foundation) and JSON for accessing to AutoGRAPH.NET core. Schemas configuration can be changed by AutoGRAPH.NET software. AutoGRAPH.NET Service can be run in two modes: as console application and as system service.

Minimal requirements for hardware and software environment

• RAM – from 1 GB
• Windows 2003 or latest
• .NET Framework 4.0 or latest
• Installed (AutoGRAPH DataLoader) or AutoGRAPH Server 3.x or 4.x or 5.x

Download links

Last version: 2015.7.18.1, Download

Console mode

This mode designed for debugging and testing. Simply run AutoGRAPHNETService.exe in console.

Service mode

Installed as system Windows service and working autonomous. Command line for installing:

sc create AutoGRAPHNETService binPath= "C:\TK\WebMapK\Build-Svc\AutoGRAPHNETService.exe"

 Don't forget space between binPath= and full path  

Configuring

1. Extracting archive with AutoGRAPH.NET Service in some directory 2. Open AutoGRAPHNETService.exe.config in Notepad. You can see next keys in .config file:

<add key="key-file" value="N:\AGServer\AutoGRAPHServer_3.0\30008_4x4_magnitka.agkey"/>
<add key="address" value="http://localhost:800/"/>
<add key="address-json" value="http://localhost:810/"/>
<add key="common-directory" value="C:\ProgramData\AutoGRAPH Shell"/>
<add key="data-directory" value="C:\Users\denisio\AppData\Roaming\AutoGRAPH Shell\Data"/>

key-file	.agkey licensing file (from AutoGRAPH.Server), this file contain allowed devices. Required parameter!
address	local address end point for working with WCF (protocol (httpBinding mode). Uri can be set in url:port format Also, you can use next variations: http://192.168.1.3:8000 - accept connections on local IP-address 192.168.1.3 and TCP-port 8000 (usually this mode used with several network cards) http://0.0.0.0:8000 or http://*:8000 - accept connections  on all enabled network interfaces and IP-addressed and TCP-port 8000 http://127.0.0.1:8000 - accept connections only locally (usually used with local installed software)
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	directory with common data files (directory structure same with directory of AutoGRAPH.NET software – with Schemes, GeoFences, Devices subdirectories with files)
data-directory	devices data directory AutoGRAPH DataLoader or AutoGRAPH Server 3.x or 4.x or 5.x

Save .config file after editing and run service or run in command line. Run next command line for generate .cs file with proxy-class:

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

AutoGRAPHSvc.cs and output.config file will created in current directory. This file configured for use WCF-endpoint of AutGRAPH.NET Service.

Service methods

• EnumSchemas – enumerate allowed schemas
• EnumDevices – enumerate devices in schema
• EnumDrivers – enumerate drivers in schema
• EnumGeoFences – enumerate geofences in schema
• GetGeoFences – get information about geofences (points, polygons, etc)
• GetDevicesInfo – get information about devices in schema
• EnumParameters – get schema parameters
• GetOnlineInfo – get device(s) last position and last date/time information
• GetOnlineInfoAll - get device(s) last position and last date/time information (for ALL devices in schema)
• GetDataRanges – get allowed data files from devices
• GetTrips – get trips information for specified device(s)
• GetTripsCustom – get trips information with custom geofences
• GetStage – get single stage information of specified device(s)
• GetTrack – get track information (date/time/coordinates/speed/...) of specified device(s)
• GetProperties – get property and values list of specified device(s)
• GetProperty – get single property value of specified device(s)
• GetRoute – calculate route between specified points
• WaitData - wait for new device data
• EnumReports - get allowed reports
• GetReports - run reports and download in XML/PDF/DOCX/XLS/.../ZIP-file
• ExecuteReports - run report asynchronously
• GetReportsStatus - get report executing status (for asynchronous executing)
• CancelReports - cancel report creating

Examples

using System;
using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using AutoGRAPHService;

namespace AutoGRAPHSvcTest
{
    class Program
    {
        static void Main(string[] args)
        {
            var svc = new AutoGRAPHSvcClient();            // make proxy class with default end points

            RSchema[] schemas;
            using (var f = new TimeCalc("EnumSchemas"))    // get schemas list
               schemas = svc.EnumSchemas();

            REnumDevices devices;
            using (var f = new TimeCalc("EnumDevices"))
               devices = svc.EnumDevices(schemas[0].Name); // get device list for first allowed schema
            foreach (var item in devices.Items)
               Console.WriteLine("\t" + item.Name);

            using (var f = new TimeCalc("EnumGeoFences"))  // get geofences list
               svc.EnumGeoFences(schemas[0].Name);
            using (var f = new TimeCalc("GetDevicesInfo"))
               svc.GetDevicesInfo(schemas[0].Name);
            
            using (var f = new TimeCalc("EnumParameters")) // get parameter list for all devices in schema
               svc.EnumParameters(schemas[0].Name, devices.Items.Select(p => p.ID).ToArray());
            
            using (var f = new TimeCalc("GetOnlineInfo"))  // get online status of devices
               svc.GetOnlineInfo(schemas[0].Name, devices.Items.Select(p => p.ID).ToArray());
            
            using (var f = new TimeCalc("GetTrips"))       // get trips list for last 5 days of all devices with numbers more than 9999998
                svc.GetTrips(schemas[0].Name,
                    devices.Items.Where(p => p.Serial >= 9999998).Select(p => p.ID).ToArray(),
                    DateTime.Now.AddDays(-5), DateTime.Now);
            
            using (var f = new TimeCalc("GetTrack"))       // get tracks for last 5 days of all devices with numbers more than 9999998
            {
                var t1 = svc.GetTrack(schemas[0].Name,
                    devices.Items.Where(p => p.Serial >= 9999998).Select(p => p.ID).ToArray(),
                    DateTime.Now.AddDays(-5), DateTime.Now);                
            }

            Console.ReadLine();
        }
    }

    // simple class for calculating running time
    class TimeCalc:IDisposable
    {
        readonly DateTime DT;
        readonly string name;
        internal TimeCalc(string name) { DT = DateTime.Now; this.name = name; }
        void IDisposable.Dispose() { Console.WriteLine(name+": "+DateTime.Now.Subtract(DT).TotalSeconds.ToString("F3", CultureInfo.InvariantCulture)); }
    }
}

.exe.config of this example

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
 <system.serviceModel>
 <bindings>
 <basicHttpBinding>
 <binding name="BasicHttpBinding_IAutoGRAPHSvc"
 closeTimeout="00:01:00" openTimeout="00:01:00" receiveTimeout="00:10:00" sendTimeout="00:01:00"
 allowCookies="false" bypassProxyOnLocal="false" hostNameComparisonMode="StrongWildcard"
 maxBufferPoolSize="524288" maxBufferSize="2147483647" maxReceivedMessageSize="2147483647"
 messageEncoding="Text" textEncoding="utf-8" transferMode="Buffered" useDefaultWebProxy="true">
 <readerQuotas maxDepth="32" maxStringContentLength="2147483647" maxArrayLength="16348"
 maxBytesPerRead="4096" maxNameTableCharCount="16384" />
 <security mode="None">
 <transport clientCredentialType="None" proxyCredentialType="None" realm="" />
 <message clientCredentialType="UserName" algorithmSuite="Default" />
 </security>
 </binding>
 </basicHttpBinding>
 </bindings>
 <client>
 <endpoint address="http://localhost:800/" binding="basicHttpBinding"
 bindingConfiguration="BasicHttpBinding_IAutoGRAPHSvc" contract="IAutoGRAPHSvc"
 name="BasicHttpBinding_IAutoGRAPHSvc" />
 </client>
 </system.serviceModel>
</configuration>

Troubleshooting

здесь.