3VR Events

{"type":"doc","content":[{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":717,"id":"6be02590-af9b-4f4c-b8f7-3eca44d28e42","collection":"contentId-83787904","type":"file","height":368}}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc-zone","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"f4db761f-721c-4f4d-8039-68f9cf58cc4b"},"schemaVersion":{"value":"1"},"title":"Table of Content Zone"}}},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"496ebd50-8d44-44cc-a11a-ef575e45911b"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"3VR Appliances and Enterprise Appliances support several APIs which can be accessed using web services. This has two key advantages for those writing client applications:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"These APIs can be used by client applications remotely across a network.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Client applications can be written in almost any programming language.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"3VR's Web Services APIs are based on standard protocols and formats such as HTTP, XML, REST, and SOAP which are supported in all major programming environments. In addition, the 3VR Web Services SDK contains sample code and support libraries for several popular programming languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"In total, the 3VR Web Services API is comprised of 4 APIs:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"3VR REST API","type":"text","marks":[{"type":"strong"}]},{"text":" gives client programs access to camera information, system settings, health monitoring data, video, images, and more with RESTful HTTP requests","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"3VR External System Activity API ","type":"text","marks":[{"type":"strong"}]},{"text":"(SOAP) is used by client programs to add events to the 3VR system's database. These include bridges to Point of Sale (POS) systems, access control systems and transaction recording systems. The External System Activity API uses a Simple Object Access Protocol (SOAP) binding that lets client applications define event types and metadata types and inject individual events.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"3VR External Query API","type":"text","marks":[{"type":"strong"}]},{"text":" lets client programs query for specific events in the set of events recorded by the 3VR system. 3VR provides RESTful access to some of the most common queries, but client programs can also send custom XML-based queries to return only events of interest. Regardless of which method is chosen, events are returned in XML format and use URLs to reference associated images and videos.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"3VR Live Query API","type":"text","marks":[{"type":"strong"}]},{"text":" allows client programs to receive a continuous stream of new events matching an XML query. Clients can choose feeds based on the type of event or whether the event has a particular alert associated with it. The Live Query API uses the same XML predicate request as the External Query API, except the appliance will returns a continuous stream of events instead of a fixed set.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Application developers may use one API or a combination of APIs depending on their needs.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"What does an Event mean?","type":"text"}]},{"type":"paragraph","content":[{"text":"3VR's \"Searchable Surveillance\" model is built around the creation of events. An event represents an action detected by the 3VR system, such as motion observed by a camera or the detection of a specific face. An event consists of two main components:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Event data","type":"text","marks":[{"type":"strong"}]},{"text":": pieces of information such as the date, camera number, transaction ID, etc.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Event video","type":"text","marks":[{"type":"strong"}]},{"text":": a video clip from the time when the event occurred.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Each event captured by the 3VR system is represented in OpCenter by an event card. Event cards are labeled with the type of event, the date and time the event card was created, and other information about the event.","type":"text"}]},{"type":"paragraph","content":[{"text":"The simplest event type is a Motion event. Motion events are created when the system detects movement in a camera's field of view. All motion event cards contain the following elements in storyboard view:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Images: each motion event card displays up to three still frames from the event:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Camera number and name: the number and name of the camera that captured the motion event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Event start time: the time that motion was first detected by the camera.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Event duration: the length of time continuous motion was detected.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"In addition to basic video recording, events can be generated by integration with external systems (e.g. transaction, access control, POS, etc.) and analytics plug-ins.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Choosing the Right API","type":"text"}]},{"type":"paragraph","content":[{"text":"Before embarking on a project using a 3VR API, application developers should carefully review each API's description and sample code to ensure they have selected the correct API(s) for their purposes. The following guidelines apply:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To create events on the 3VR appliance, use the 3VR External System Activity API","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To request and obtain events from the 3VR Appliance that match certain criteria (date, camera, event type, etc.) use the 3VR External Query API.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To request and obtain a continuous stream of events matching a query, use the 3VR Live Query API.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To request information about a 3VR Enterprise Appliance, a single appliance, a camera, or to obtain video or images from a particular camera, use the 3VR REST API.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"There are two approaches to developing with the 3VR API: you can either work with the API directly using libraries provided in your programming language of choice, or use 3VR's helper code provided for the language in which you are programming. Both approaches are supported, and the approach you choose will depend on your particular circumstances.","type":"text"}]},{"type":"paragraph","content":[{"text":"Even if you are writing directly to your language's interfaces, you may find it useful to review the helper code. The source code to the helper code is included in the SDK.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"What’s in the SDK?","type":"text"}]},{"type":"paragraph","content":[{"text":"This manual is associated with a Software Development Kit that has useful tools for programming with 3VR Web services. These include specification files, such as XML schemas, WSDL files, library bindings, source code, and samples of real applications built using these APIs. Also included is a copy of the API documentation in PDF form.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Structure of the API Documentation","type":"text"}]},{"type":"paragraph","content":[{"text":"3VR's API documentation contains sections for each of the individual APIs. All users should read this Overview and the \"Getting Started\" section, and then proceed to the documentation for their API of choice.","type":"text"}]},{"type":"paragraph","content":[{"text":"All of the API-specific sections contain information on the format of the request to the appliance and what to expect in return.","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR External System Activity API and the 3VR External Query API also include sample code to demonstrate the format of the XML request predicate. The 3VR External System Activity API currently includes examples in C# and Java. The 3VR External Query API has examples in Java and Python. Contact your 3VR representative if you are interested in writing client code in other languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"The final section contains reference material on the structure of XML-formatting for use in specifying queries and processing the events returned from queries.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Getting Started","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Enabling Web Services","type":"text"}]},{"type":"paragraph","content":[{"text":"A 3VR VIP Appliance or Enterprise Appliance must have web services enabled in order to accept incoming messages. Enable web services with the following steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Launch 3VR System Manager.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Configure panel of System Manager, right-click the name of the ","type":"text"},{"text":"appliance","type":"text","marks":[{"type":"strong"}]},{"text":" and select ","type":"text"},{"text":"Start Web Services","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":55.0},"content":[{"type":"media","attrs":{"width":663,"id":"f350a72e-f41e-41b1-8c47-e6de6b0db0b0","collection":"contentId-83787904","type":"file","height":403}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A pop up will appear indicating that web services is now running.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Enabling Demand Video Recording","type":"text"}]},{"type":"paragraph","content":[{"text":"If you plan to create events, set the Enable Demand Video Recording setting to Yes for each camera that will have generic events. This setting will buffer video so it is available for events even if there is not any current motion.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3VR REST API","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR REST API gives client programs access to camera information, system settings, health monitoring data, video, images, and more with HTTP GET requests.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Authentication","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR REST API uses HTTP Basic Authentication and validates against an appliance’s users. This requires an ’Authorization: Basic’ header in the request followed by a base64 encoded user name and password. This request header is case sensitive and must be passed with every request. The format for the user name and password is username:password. As an example, encoding ‘username:password’ to base64 results in ‘dXNlcm5hbWU6cGFzc3dvcmQ=’, and the request header would be the following:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=","type":"text"}]},{"type":"paragraph","content":[{"text":"The server will also provide the challenge required for browser authentication. To test in a browser, navigate to a route and enter a valid user name and password in the dialog that’s displayed. The browser will then handle the authentication call.","type":"text"}]},{"type":"paragraph","content":[{"text":"All permissions, password constraints, authentication attempt limits, and inactivity limits for users are respected. If a user does not have access to an appliance, channel, view, etc. that information will not be returned in the response. When authentication fails the server will respond with a 401 HTTP status code and a JSON object in the body that includes the ‘AuthenticateResponse’ and a ‘Message’ describing the error. For example:","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"{ \"AuthenticateResponse\": \"PasswordIncorrect\", \"Message\": \"Invalid user name or password\" }","type":"text"}]},{"type":"paragraph","content":[{"text":"The following lists the possible responses:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"AuthenticateResponse","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"Error","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"An unknown error has encountered during authentication","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"PasswordExpired","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"The password for account ‘[User name]’ has expired. Please create a new password.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"OperationTimeout","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"Authentication timed out","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"PasswordIncorrect","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"Invalid user name or password","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"MaxInactivityTimeExceeded","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"User ‘[User name]’ suspended:exceeded [number] days of inactivity.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"MaxSignInAttemtpsExceeded","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"User ‘[User name]’ suspended:exceeded[number] authentication attempts","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"NoSignInPermission","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"User ‘[User name]’ has no permission to sign in.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[270.0]},"content":[{"type":"paragraph","content":[{"text":"NeedsPasswordChange","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[410.0]},"content":[{"type":"paragraph","content":[{"text":"The password for ‘{User name}’ needs to be changes before it can be properly authenticated ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Port","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR REST API runs on port 8080 and uses SSL, so the server can be accessed via: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://hostaddress:8080","type":"text"}]},{"type":"paragraph","content":[{"text":"All exchanges are secured using HTTP BASIC authentication. The user names and passwords must match users that have been added to the 3VR system in System Manager.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sample Request API","type":"text"}]},{"type":"paragraph","content":[{"text":"This sample displays the structure of a GET request to an appliance using the 3VR REST API.","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, we are requesting a list of system settings, but requests for different information may be made by modifying the path of the request URL (shown in bold text in the following example).","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"import urllib2, sys\ndef auth(hostname,username,password):\nurl = “https://%s:8080/” % (hostname)\npassword _ mgr = urllib2.HTTPPasswordMgrWithDefaultRealm()\nhandler = urllib2.HTTPBasicAuthHandler(password _ mgr)\nopener = urllib2.build _ opener(handler)\nurllib2.install _ opener(opener)\npassword _ mgr.add _ password(None, url, username, password)\ndef get _ settings(hostname):\nurl = \"https://%s:8080/settings\" % (hostname) #url path to request settings\ntry:\nreq = urllib2.urlopen(url)\nreturn req.read()\nexcept urllib2.HTTPError, e:\nprint \"HTTP error: %s\" % e.code\nexcept Exception, e:\nprint e\nreturn \"\"\nif _ _ name _ _ == \"_ _ main _ _\":\ntry:\nhostname = sys.argv[1]\nexcept:\nprint \"usage: settingsAPI.py [IP address or hostname]\"\nsys.exit(1)\nauth(hostname,\"techrep\",\"3MeDeee\")\nsettingsxml = get _ settings(hostname)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Headers and Responses","type":"text"}]},{"type":"paragraph","content":[{"text":"The information below will apply to most 3VR REST API routes. 3VR is in the process of unifying and normalizing its API, so the 3VR REST API routes marked with an asterisk (*) are those still in need of updating. For now, their response will be in XML and they will not take the 'Accept' request header, but will do so in the future.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default response of all routes will be formatted as JSON objects except for the channel image and video routes.; images routes will return an image, see the routes below for more details. The ‘Accept’ request header allows specifying the desired content type to be returned. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"Accept: application/xml\nAccept: application/json","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note most browsers will include application/xml in the request header by default, so for debugging purposes an accept argument in the query string may be required to request a JSON formatted response. For example, when retrieving the list of appliances in JSON format using a browser, access the following URL:","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://hostaddress:8080/appliances?accept=application/json","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3VR REST API Routes","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/appliances","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/appliances","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":77.0},"content":[{"type":"media","attrs":{"width":785,"id":"b1403937-3803-4eab-b85a-e47007484cbd","collection":"contentId-83787904","type":"file","height":136}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Options","type":"text"}]},{"type":"codeBlock","content":[{"text":"?regions=true if included, the returned list of appliances will be arranged in regions","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"python"},"content":[{"text":"\n\n1\n3VR Enterprise Appliance\n

10.100.2.22

\nEnterpriseServer\nPacific Standard Time\n480\n0001-01-01T00:00:00\n2012-07-26T00:42:04\n0001-01-01T00:00:00\n2012-07-02T11:00:14\nappliance\n\n\n2\nLake Merritt Branch\n

10.100.2.202

\nIntegrated\nPacific Standard Time\n480\n2011-04-26T18:37:30\n2012-07-27T08:56:51\n2011-04-26T18:46:35\n2012-07-27T08:56:51\nappliance\n\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample JSON Response","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"[\n{\nId: 1,\nName: \"3VR Enterprise Appliance\",\nAddress: \"10.100.2.22\",\nMachineType: \"EnterpriseServer\",\nTimeZoneKey: \"Pacific Standard Time\",\nTimeZoneOffset: 480,\nCreated: \"/Date(-62135568000000)/\",\nUpdated: \"/Date(1343549702000)/\",\nVideoStart: \"/Date(-62135568000000)/\",\nSyncDate: \"/Date(1341252014000)/\",\nObjectType: \"appliance\"\n},\n{\nId: 2,\nName: \"Lake Merritt Branch\",\nAddress: \"10.100.2.202\",\nMachineType: \"Integrated\",\nTimeZoneKey: \"Pacific Standard Time\",\nTimeZoneOffset: 480,\nCreated: \"/Date(1303868250000)/\",\nUpdated: \"/Date(1343673311000)/\",\nVideoStart: \"/Date(1303868795000)/\",\nSyncDate: \"/Date(1343673311000)/\",\nObjectType: \"appliance\"\n}\n]","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/health","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/health","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":794,"id":"c43ee369-03ef-436a-b28d-9ec5d0bef118","collection":"contentId-83787904","type":"file","height":63}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\nCamera or Camera Connection Failure\n3\n2012-06-20T11:24:10\n2012-07-27T04:03:55\nCamera '1. Shipping Room' is not sending video.\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/enterprisehealth","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/enterprisehealth","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":82.0},"content":[{"type":"media","attrs":{"width":796,"id":"8bd1b5c2-3026-4133-8f1e-795e822a0559","collection":"contentId-83787904","type":"file","height":63}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n2\nLake Merritt Branch\n10.100.2.202\nCamera or Camera Connection Failure\n6\n2012-06-11T22:32:45\n2012-07-27T15:03:55\n2012-06-11T23:32:45\nCamera '7. Mercado' is not sending video.\n\n\n2\nLake Merritt Branch\n10.100.2.202\nCamera or Camera Connection Failure\n7\n2012-06-11T22:32:45\n2012-07-27T15:03:55\n2012-06-11T23:32:45\nCamera '6. Caja' is not sending video.\n\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"/appliancemetadata*","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/appliancemetadata","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":82.0},"content":[{"type":"media","attrs":{"width":794,"id":"2661a63a-515a-4745-80fe-edf19d600810","collection":"contentId-83787904","type":"file","height":146}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"Sample Response XML\n\n\n\nd4fd02e5-d035-4d7e-9aa4-2535a561a748\nCustom Text Field\nTest Value\n\n\nd4fd02e5-d035-4d7e-9aa4-2535a561a748\nCustom Number Field\n12\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/settings*","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/settings","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":82.0},"content":[{"type":"media","attrs":{"width":794,"id":"11e657ad-adf0-4563-9dd5-fb52d02dcfed","collection":"contentId-83787904","type":"file","height":80}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n1\nAdminEMail\nEmail\n0\n\n\n2\nAllowLocalCaseManagement\nGeneral\n0\n\n\n3\nBackupMedia\nGeneral\n0\n\n\n...\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/settingvalue*","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/settingvalue","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":794,"id":"67ffd28d-b307-438b-aabd-e2fc4ab914fa","collection":"contentId-83787904","type":"file","height":96}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n20\nfalse\n5\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/channelinfo*","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/channelinfo","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":794,"id":"2ce532d6-9c5c-4649-8d2b-2cd9e2244783","collection":"contentId-83787904","type":"file","height":98}}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\nStreet View\n4\n19\nGenericIPCameraDriver\n2\nfalse\n3\n\n\nClassroom\n5\n20\nGenericIPCameraDriver\n2\nfalse\n3\n\n...\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/hosts","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/hosts","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":96.0},"content":[{"type":"media","attrs":{"width":1058,"id":"ba1e3d47-f6c7-48cf-9716-adda9a866265","collection":"contentId-83787904","type":"file","height":91}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nLake Merritt Branch\n2\n\n\nMission District Branch\n3\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/person/*","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/person/","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":794,"id":"5459942b-5657-458c-bf97-1491b4a9c636","collection":"contentId-83787904","type":"file","height":253}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n[IMAGE DATA]\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n[IMAGE DATA]\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/livevideo","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/livevideo","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":794,"id":"adc4bfda-ca8e-449c-9b6b-86d98da2da7f","collection":"contentId-83787904","type":"file","height":54}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"width":172,"id":"dc93e089-9219-4516-9720-66cc0d45418b","collection":"contentId-83787904","type":"file","height":162}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/video","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/video/","type":"text"}]},{"type":"paragraph","content":[{"text":"WILL BE DEPRECATED IN NEXT RELEASE, USE /channels","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}},{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Returns stored video from the camera with the given camera number and options (start time, end time, length, framerate, and/or resolution). Note: Datetime values are formatted according to the ","type":"text"},{"text":"ISO 8601","type":"text","marks":[{"type":"strong"}]},{"text":" specification: ","type":"text"},{"text":"YYYY-MM-DDTHH:MM:SS","type":"text","marks":[{"type":"strong"}]},{"text":" For example, ","type":"text"},{"text":"2012-12-05T13:40:27","type":"text","marks":[{"type":"strong"}]},{"text":". For more information, see this article from the W3C ","type":"text"},{"text":"W3.org: Date and Time Formats","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3.org/TR/NOTE-datetime"}}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":789,"id":"7764dd5f-9c3b-4a65-8486-61216ba20e75","collection":"contentId-83787904","type":"file","height":336}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/event*","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/event/","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":791,"id":"277debcc-b8ee-4f73-9c4c-1ec55760c908","collection":"contentId-83787904","type":"file","height":113}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":708,"id":"12cd3a40-a8f4-498b-9214-1aab691124f5","collection":"contentId-83787904","type":"file","height":300}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/liveimage","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/liveimage/","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":794,"id":"18e7a3c6-1c2b-430d-8f97-7b06bf4906d1","collection":"contentId-83787904","type":"file","height":114}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":343,"id":"3a6b664a-aaf1-432f-bc59-806f82938d6d","collection":"contentId-83787904","type":"file","height":163}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/channels","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/channel","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":579,"id":"4ba0fbbc-2cb6-4114-a1a0-e9c0ac377894","collection":"contentId-83787904","type":"file","height":430}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/time","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/time","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":581,"id":"5edaf75b-ec75-46ab-9443-6184ab4c1339","collection":"contentId-83787904","type":"file","height":35}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/version","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/version","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":792,"id":"31907a2a-3f8e-431b-89bc-cc5058423f19","collection":"contentId-83787904","type":"file","height":44}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/views","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/views","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":792,"id":"0d07f0d8-8cc1-4b96-8168-6213a273f1ad","collection":"contentId-83787904","type":"file","height":253}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Input for POST/views","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n\"Id\":null,\n\"Name\":\"1 Channel\",\n\"Shared\":false,\n\"UserName\":\"user\",\n\"UserId\":null,\n\"Channels\":[\n{\n\"Id\":9,\n\"Name\":\"Camera 9\",\n\"ChannelDrive\":null,\n\"IsActive\":true,\n\"ChannelType\":\"IPNetworkCamera\",\n\"ThumbnailUrl\":null,\n\"LocalId\":0,\n\"Appliance\":{\n\"Id\":1,\n\"Name\":\"Developer Workstation\",\n\"Address\":null,\n\"MachineType\":\"Integrated\",\n\"TimeZoneKey\":\"Pacific Standard Time\",\n\"TimeZoneOffset\":480,\n\"Created\":\"/Date(1351818098000)/\",\n\"Updated\":\"/Date(1353442448000)/\",\n\"VideoStart\":\"/Date(1352497452000)/\",\n\"SyncDate\":\"/Date(1351818098000)/\"\n},\n\"selected\":false,\n\"isEnterprised\":false,\n\"Number\":9,\n\"ChannelDriver\":\"GenericIPCameraDriver\",\n\"ImageUrl\":\"https:///channels/9/image\",\n\"hostname\":\"\"\n}\n],\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Input for PUT/views","type":"text"}]},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n\"Id\":15,\n\"Name\":\"Single Channel View\",\n\"Shared\":false,\n\"UserName\":\"techrep\",\n\"UserId\":2,\n\"Channels\":[\n{\n\"Id\":9,\n\"Name\":\"Camera 9\",\n\"ChannelDrive\":null,\n\"IsActive\":true,\n\"ChannelType\":\"IPNetworkCamera\",\n\"ThumbnailUrl\":null,\n\"LocalId\":0,\n\"Appliance\":{\n\"Id\":1,\n\"Name\":\"Developer Workstation\",\n\"Address\":null,\n\"MachineType\":\"Integrated\",\n\"TimeZoneKey\":\"Pacific Standard Time\",\n\"TimeZoneOffset\":480,\n\"Created\":\"/Date(1351818098000)/\",\n\"Updated\":\"/Date(1353442448000)/\",\n\"VideoStart\":\"/Date(1352497452000)/\",\n\"SyncDate\":\"/Date(1351818098000)/\"\n},\n\"selected\":false,\n\"isEnterprised\":false,\n\"Number\":9,\n\"ChannelDriver\":\"GenericIPCameraDriver\",\n\"ImageUrl\":\"https:///channels/9/image\",\n\"hostname\":\"\"\n}\n],\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"/rtsp","type":"text"}]},{"type":"codeBlock","content":[{"text":"https://[IP address or hostname]:[port]/rtsp","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":90.0},"content":[{"type":"media","attrs":{"width":797,"id":"6f0a82ed-292d-4c54-b916-bd8966baac1e","collection":"contentId-83787904","type":"file","height":140}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample XML Response","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nOK\nrtsp://10.10.10.10:554/Stream3\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample JSON Response","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":"{\n\"Message\": \"OK\",\n\"Uri\": \"rtsp:\\/\\/10.10.10.10:554\\/Stream3\"\n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The RTSP URI will always contain the local network IP address. If there are plans to expose the 3VR system to an external network via NAT, then its possible to specify a special file to replace the RTSP IP with the external address. Please contact 3VR Technical Support for assistance with setting up the file to replace the RTSP IP Address.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"If an RTSP client issues a TEARDOWN command, the API user must request the RTSP URL again to begin video streaming.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"3VR Technical Support Contact Information","type":"text"},{"type":"hardBreak"},{"text":"Additionally, If you are having trouble with a 3VR system or application, contact 3VR Technical Support by phone at 415-513-4572 or email ","type":"text"},{"text":"support@3VR.com","type":"text","marks":[{"type":"link","attrs":{"href":"mailto:support@3VR.com"}}]},{"text":" Monday through Friday, 5 a.m. to 6 p.m. Pacific Time (8 a.m. to 9 p.m. Eastern Time) for assistance.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3VR External System Activity API - SOAP","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overivew","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR External System Activity API allows third parties to define their own event types for the 3VR system and add instances of these events to the 3VR system. These events can then be displayed and searched for using 3VR's OpCenter application. In OpCenter, these events can be correlated with other event types using the \"Search for related events\" option in the Search panel.","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR External System Activity API is built on the Simple Object Access Protocol (SOAP) using HTTP, a standard web services protocol accessible from a wide variety of platforms and languages. Since SOAP is based on XML, it is easy to build requests and process replies.","type":"text"}]},{"type":"paragraph","content":[{"text":"To support custom events, 3VR has a framework called generic events. These events are similar to internally defined events, but their structure can be defined by external agents. A given 3VR system can have an arbitrary number of defined generic event types. However, for usability reasons, we recommend that a given vendor use a single event type and differentiate using metadata. However, this is not a hard rule. Generic events will be displayed alongside the other event types, such as Motion and Face, in the Monitor, Search, and Cases panels of OpCenter. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Generic events appear in the software using individually defined names, displayed on each generic event card. When the user chooses to view smaller event cards, the short name is displayed. For example, in the event card below, the generic event name is \"Bank Teller\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Generic events can integrate custom field data. The API name for a custom field is a metadata field. The generic event definition specifies the event type name, short name, help text, metadata fields, and a globally unique identifier (GUID). The generic event definition GUID identifies the generic event type and metadata fields across different 3VR servers.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each metadata field has name, description, type, display position, display format and GUID.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name appears in the event details and may appear on the event card depending on the display format.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type specifies the kind of data stored in the field. The type can be String, Number, DateTime, or EnumeratedType.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description is a text string that describes the field.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Display position controls the order in which the metadata fields are displayed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Display format controls the way the data is displayed on the large event cards.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When you define a new generic event type, you will have to create GUIDs for the event type itself and each of the metadata fields that you are defining. It is important to use the same GUIDs for every server on which you use your application. GUIDs can be generated in a number of ways.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At the time of this writing, GUIDs could be generated on the following sites:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GUID Generator","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.guidgenerator.com/"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GUID Gen","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.guidgen.com/"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Visual Studio","type":"text","marks":[{"type":"strong"}]},{"text":" includes a GUID generating tool called ","type":"text"},{"text":"GUIDGen.exe","type":"text","marks":[{"type":"strong"}]},{"text":". This program is located in","type":"text"},{"text":" \\Program Files (x86)\\Microsoft SDKs\\Windows\\v7.0A\\Binin Visual Studio 2010","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When the generic event definition is created, if a GUID has not been specified, a GUID will be generated automatically and returned in the response. Incorporate the response GUID into your code whenever you create the definition.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"3VR is not affiliated with these sites in any way; an Internet search for \"GUID generator\" can provide additional resources.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"A typical application of the External System Activity API will:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Authenticate the user of the application. The user needs to be defined in 3VR System Manager. The authenticate call returns an authentication token that is used in SOAP Header for all subsequent requests.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the generic event definition if it does not already exist.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Based on some external stimulus, create a generic event associated with a camera.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Authentication is accomplished using the ","type":"text"},{"text":"IAuthenticateService","type":"text","marks":[{"type":"strong"}]},{"text":". The ","type":"text"},{"text":"IGenericEventService","type":"text","marks":[{"type":"strong"}]},{"text":" provides the rest of the API.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Browsing 3VR External System Activity API Services","type":"text"}]},{"type":"paragraph","content":[{"text":"Verify that the Web Services is running by pointing a browser at any of the following 3VR External System Activity API services","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://hostaddress:8080/3vr/IAuthenticateService.asmx","type":"text","marks":[{"type":"link","attrs":{"href":"https://hostaddress:8080/3vr/IAuthenticateService.asmx"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://hostaddress:8080/3vr/IGenericEventService.asmx","type":"text","marks":[{"type":"link","attrs":{"href":"https://hostaddress:8080/3vr/IGenericEventService.asmx"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Click on any of the asmx links to see the available services. The SOAP WSDL is available at the Service Description link. The service call XML specification is available on the operation link.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Authentication","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"https://hostaddress:8080/3vr/IAuthenticateService.asmx?op=Authenticate","type":"text","marks":[{"type":"link","attrs":{"href":"https://hostaddress:8080/3vr/IAuthenticateService.asmx?op=Authenticate"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Authenticate against the 3VR users. The Soap Header can be blank. It will return the Token for use in the SOAP header for subsequent operations.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create Events","type":"text"}]},{"type":"paragraph","content":[{"text":"Once authenticated you are ready to create events with the IGenericEventService. The WSDL is available by clicking the Service Description link.","type":"text"}]},{"type":"paragraph","content":[{"text":"https://hostaddress:8080/3vr/IGenericEventService.asmx:","type":"text","marks":[{"type":"link","attrs":{"href":"https://hostaddress:8080/3vr/IGenericEventService.asmx:"}}]}]},{"type":"paragraph","content":[{"text":"The primary operations are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CreateGenericEventDefinition","type":"text","marks":[{"type":"strong"}]},{"text":": Create a Generic Event Definition for new generic events. Values for Type = String, Number, DateTime, or EnumeratedType","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CreateGenericEvent","type":"text","marks":[{"type":"strong"}]},{"text":": Create a Generic Event from the server.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The other operations are used in support of generic event creation.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Channels: Get a list of channels.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CustomFieldNames: Get a list of Custom Field Names associated with a person profile in the 3VR system. Used for FaceComparison events.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DeleteGenericEvent: Delete a Generic Event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DeleteGenericEventDefinition: Delete a Generic Event Definition.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GenericEvent: Get a Generic Event from the server.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GenericEventDefinitionByGUID: Find an the Generic Event Definitions with the specified GUID.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GenericEventDefinitionsAll: Get all Generic Event Definitions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"GenericEventDefinitionsByName: Find all the Generic Event Definitions with the provided name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UpdateGenericEvent: Update a Generic Event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"UpdateGenericEventDefinition: Update an existing Generic Event Definition GUIDs must match for existing elements","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Developing Client Programs","type":"text"}]},{"type":"paragraph","content":[{"text":"3VR Web Services are design to work in various environments (.NET, Java, Python, etc.).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":".NET","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are working in .NET, the program ","type":"text"},{"text":"wsdl.exe","type":"text","marks":[{"type":"strong"}]},{"text":" (in ","type":"text"},{"text":"\\Program Files (x86)\\Microsoft SDKs\\Windows\\v7.0A\\Bin","type":"text","marks":[{"type":"strong"}]},{"text":") will automatically generate client code. For example, to generate C#, run the following at the command line:","type":"text"}]},{"type":"codeBlock","content":[{"text":"> wsdl /language:CS https://[IP or host name of 3VR appliance]:8080/3vr/IGenericEventService.asmx?WSDL","type":"text"}]},{"type":"paragraph","content":[{"text":"and WSDL.exe will generate client code to access Generic Event operations.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Java XML","type":"text"}]},{"type":"paragraph","content":[{"text":"For Java systems, 3VR provides an example using ","type":"text"},{"text":"Apache.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://Apache.org"}}]},{"text":"'s Axis package and WSDL2Java to generate the client code using JAX-RPC and JAWS API's. This sample uses Axis 1.4 from ","type":"text"},{"text":"Apache.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://ws.apache.org/axis"}}]},{"text":" and JAF activation.jar and mail.jar from ","type":"text"},{"text":"java.sun.com","type":"text","marks":[{"type":"link","attrs":{"href":"http://java.sun.com/xml/downloads/."}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set AXIS _ HOME to where you installed Axis, e.g. C:\\java\\axis-1 _ 4\\lib.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set up or copy the log4j properties from AXIS _ HOME, and set up AXIS _ HOME in the environment.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The CLASSPATH will look something like:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"CLASSPATH = .;%AXIS _ HOME%\\axis.jar;%AXIS _ HOME%\\commons-discovery-0.2.jar;%AXIS _ HOME%\\commons-\nlogging-1.0.4.jar;%AXIS _ HOME%\\jaxrpc.jar;%AXIS _ HOME%\\log4j-1.2.8.jar;%AXIS _ HOME%\\saaj.\njar;%AXIS _ HOME%\\wsdl4j-1.5.1.jar;%AXIS _ HOME%\\mail.jar;%AXIS _ HOME%\\activation.jar","type":"text"}]},{"type":"paragraph"}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Run WSDL2Java at the command line to create the client library.","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"> java org.apache.axis.wsdl.WSDL2Java --output src --package com. _ 3vr.Services http://\nlocalhost/3vr/IAuthenticateService.asmx?WSDL>java org.apache.axis.wsdl.WSDL2Java --output\nsrc --package com. _ 3vr.Services http://localhost/3vr/IGenericEventService.asmx?WSDL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"With the generated code, use of the Authenticate operation in Java becomes:","type":"text"},{"type":"hardBreak"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"try{\nIAuthenticateServiceLocator locator = new IAuthenticateServiceLocator();\njava.net.URL url = new java.net.URL(serverUrl + \"IAuthenticateService.asmx\");\nIAuthenticateServiceSoap _ PortType port = locator.getIAuthenticateServiceSoap(url);\nAuthenticateToken token = port.authenticate(\"user\", \"password\");\nSystem.out.println(\"Status \" + token.getStatus() + \"Token \" + token.getToken());\nif(token.getStatus().equals(\"Success\"))\n{\nreturn token.getToken();\n}\n}\ncatch(Exception e)\n{ System.out.println(e.getMessage());\n\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To use the generic operations, the token needs to be set in the header. The SoapHeaderInfo class 3VR uses to put the Service Token in the SoapHeader is not created by WSDL2Java. We created one to match the other classes generated. Putting the Service token in the SoapHeader becomes:","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"import javax.xml.namespace.QName;\nimport org.apache.axis.message.SOAPHeaderElement;\ntry\n{\nIGenericEventServiceLocator locator = new IGenericEventServiceLocator();\njava.net.URL url = new java.net.URL(serverUrl + \"IGenericEventService.asmx\");\ngenericEventService = locator.getIGenericEventServiceSoap(url);\nQName qname = new QName(\"http://3vr.com\", \"SoapHeaderInfo\");\nSoapHeaderInfo SoapHeaderInfo = new SoapHeaderInfo(\"\", token);\nSOAPHeaderElement header = new SOAPHeaderElement(qname, SoapHeaderInfo);\norg.apache.axis.client.Stub stub = (org.apache.axis.client.Stub)genericEventService;\nstub.setHeader(header);\n}c\natch(Exception e)\n{\nSystem.out.println(e.getMessage());\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"For more details, see the source for the BankTeller Java sample.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sending Request XML","type":"text"}]},{"type":"paragraph","content":[{"text":"The SOAP Envelope wraps the request, and the ","type":"text"},{"text":"","type":"text","marks":[{"type":"em"}]},{"text":"contains the details of the request. Here are examples of the XML for Authenticate. In following example we will usually display the XML for the body and omit the header and wrapping XML.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"SOAP 1.1 Request Envelope","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /3vr/IAuthenticateService.asmx HTTP/1.1\nHost: 10.100.1.105\nPort: 8080\nContent-Type: text/xml; charset=utf-8\nContent-Length: length\nSOAPAction: \"http://3vr.com/Authenticate\"\n\n\n\n\n

string

\nstring\n\n\n\n\nstring\nstring\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"SOAP 1.1 Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"HTTP/1.1 200 OK\nContent-Type: text/xml; charset=utf-8\nContent-Length: length\n\n\n\n\n\nstring\nstring\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"SOAP 1.2 Request Envelope","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"POST /3vr/IAuthenticateService.asmx HTTP/1.1\nHost: 10.100.1.105\nPort: 8080\nContent-Type: application/soap+xml; charset=utf-8\nContent-Length: length\n\n\n\n\n

string

\nstring\n\n\n\n\nstring\nstring\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"SOAP 1.2 Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"HTTP/1.1 200 OK\nContent-Type: application/soap+xml; charset=utf-8\nContent-Length: length\n\n\n\n\n\nstring\nstring\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Authenticate","type":"text"}]},{"type":"paragraph","content":[{"text":"As shown in the examples above, the Authenticate operation sends the user name and password and receives a <","type":"text"},{"text":"Token","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"> and <","type":"text"},{"text":"Status","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"> in the response:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\nstring\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If all goes well the ","type":"text"},{"text":"<","type":"text","marks":[{"type":"em"}]},{"text":"Status","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":">","type":"text","marks":[{"type":"em"}]},{"text":" will contain","type":"text"},{"text":" \"","type":"text","marks":[{"type":"em"}]},{"text":"Success","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"\"","type":"text","marks":[{"type":"em"}]},{"text":". The ","type":"text"},{"text":"<","type":"text","marks":[{"type":"em"}]},{"text":"Token","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":">","type":"text","marks":[{"type":"em"}]},{"text":" is used on the following request in the ","type":"text"},{"text":"soap:Header","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CreateGenericEventDefinition","type":"text"}]},{"type":"paragraph","content":[{"text":"Generic event definitions control how events are displayed in OpCenter. The name and metadata fields are displayed on the event card, and metadata is displayed in event details. Users can search for events using metadata fields in the ","type":"text"},{"text":"Search panel","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The metadata fields define custom data fields for the generic event. The GUID identifies the generic event and metadata fields across different 3VR servers. The GUID is instrumental when identifying the generic event and editing the generic event definition.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each metadata field has a ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Description","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Type","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Display Position","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Display Format","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"GUID","type":"text","marks":[{"type":"strong"}]},{"text":" elements:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Generic Event Definition Metadata Fields","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Appears in the event details and may appear on the event card, depending on the Display Format.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Defines the data type. Values include \"String\", \"Number\", \"DateTime\", or \"EnumeratedType\".","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Describes the field.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Sets the order the Metadata Fields are displayed. Valid display values are 0-100. Values over 100 are not displayed.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Controls the way the data is displayed on large event cards. Allows simple formatting (bolding, joining lines and inserting new lines). See the following code sample for more information.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"Lists the valid data values for an EnumeratedType.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"\n\nstring\nstring\nstring\nstring\n\n\nstring\nstring\nstring\nString or Number or DateTime or EnumeratedType\nint\nstring\n\n\n\n...\n\n\n\n","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Note: The ellipsis (…) means tags repeated from the previous block have been omitted.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Here is an example of a simple CreateGenericEventDefinition named \"","type":"text"},{"text":"Example Event","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":"\":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"\n\nExample Event\nExample\n66B886FA-F097-4290-89DD-E308E5E05A5\nSome help text that describes an Example Event.\n\n\n1FE84583-F770-4b89-AE2B-FD247C90785\nData\nData for the example\nString\n1\n{name} {value}\n\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"If we were to generate a generic event with this definition on a 3VR Appliance, \"Example Event\" would appear as an option in the event selector in OpCenter's Monitor and Search panels.","type":"text"}]},{"type":"paragraph","content":[{"text":"Furthermore, since Example Event has a metadata item with the \"Data\" that is of \"string\", users could create a search that would return only Example Events with a \"Data\" value matching their search string.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Generic Event Definition DisplayFormat","type":"text"}]},{"type":"paragraph","content":[{"text":"There are seven tags that can be used to format the text displayed for a generic event data field: {name}, {value}, {bold}, {newline}, {oneline}, {joinline}, and {wrap}. All other text inserted into the display format will be displayed as plain text.","type":"text"}]},{"type":"paragraph","content":[{"text":"To display a field with the name “Amount” and the value “$100” as “Amount: $100”, then, would require the following display format: Format: {name}: {value}","type":"text"}]},{"type":"paragraph","content":[{"text":"Result","type":"text","marks":[{"type":"strong"}]},{"text":": Amount: $100","type":"text"}]},{"type":"paragraph","content":[{"text":"Making a portion of the text field bold requires putting a {","type":"text"},{"text":"bold","type":"text","marks":[{"type":"em"}]},{"text":"} tag at the beginning and end of that section of text. There can only be two{bold} tags, and the first must be at the beginning of the display format. Displaying “Amount: $100” would require the following display format: {","type":"text"},{"text":"bold","type":"text","marks":[{"type":"em"}]},{"text":"}{","type":"text"},{"text":"name","type":"text","marks":[{"type":"em"}]},{"text":"}:{","type":"text"},{"text":"bold","type":"text","marks":[{"type":"em"}]},{"text":"} {","type":"text"},{"text":"value","type":"text","marks":[{"type":"em"}]},{"text":"}","type":"text"}]},{"type":"paragraph","content":[{"text":"The {","type":"text"},{"text":"newline","type":"text","marks":[{"type":"em"}]},{"text":"} tag inserts a newline character into the text. The display format {","type":"text"},{"text":"name","type":"text","marks":[{"type":"em"}]},{"text":"}:{","type":"text"},{"text":"newline","type":"text","marks":[{"type":"em"}]},{"text":"}{","type":"text"},{"text":"value","type":"text","marks":[{"type":"em"}]},{"text":"} will result in","type":"text"}]},{"type":"paragraph","content":[{"text":"Amount","type":"text","marks":[{"type":"strong"}]},{"text":": $100","type":"text"}]},{"type":"paragraph","content":[{"text":"Conversely, the {","type":"text"},{"text":"oneline","type":"text","marks":[{"type":"em"}]},{"text":"} tag removes all newline characters from the name and value strings not explicitly defined by a {newline} tag, replacing them with a single space.","type":"text"}]},{"type":"paragraph","content":[{"text":"The {","type":"text"},{"text":"joinline","type":"text","marks":[{"type":"em"}]},{"text":"} tag can be used to put two or more fields on a single line. Placing {","type":"text"},{"text":"joinline","type":"text","marks":[{"type":"em"}]},{"text":"} in a field’s display format will cause the next field to be displayed on the same line, to the right of the current field. For two fields, one describing gender and the other eye color, to be displayed as “","type":"text"},{"text":"Gender","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"},{"text":" Male Eye Color: Brown","type":"text","marks":[{"type":"em"}]},{"text":"”, both fields can be given the following display format: {","type":"text"},{"text":"name","type":"text","marks":[{"type":"em"}]},{"text":"}: {","type":"text"},{"text":"value","type":"text","marks":[{"type":"em"}]},{"text":"} {","type":"text"},{"text":"joinline","type":"text","marks":[{"type":"em"}]},{"text":"}. An arbitrary number of fields can be placed on the same line, limited only by screen space.","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, OpCenter will display as much of each line as possible, and truncate any text that does not fit in the available space. If you do not wish to truncate text, use the {wrap} tag to wrap over-sized strings in a given field onto multiple lines. This tag cannot be used in conjunction with the {","type":"text"},{"text":"joinline","type":"text","marks":[{"type":"em"}]},{"text":"} tag. Putting it all together, the Bank Teller event card shown here:","type":"text"}]},{"type":"paragraph","content":[{"text":"Putting it all together, the Bank Teller event card shown here:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":188,"id":"fe42e12a-7006-4800-a019-37fb159a2980","collection":"contentId-83787904","type":"file","height":96}}]},{"type":"paragraph","content":[{"text":"Was created with the following generic event definition:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nBank Teller\nBank\n1cdf7bb4-2955-4716-b971-58daf7e73365\nBank Teller Transactions\n\n\n6e4a0f9d-38e9-4350-ab20-fa2cfa0729b3\nAccount Type\nBank Account Type\nString\n1\n{bold}{value}{bold} {joinline}\n\n\n21b35e5b-6098-4c91-a3c6-d4666af6a2d0\nTransaction Type\nBank Transaction Type\nString\n2\n{value}\n\n\n5ef29aa5-3f87-461b-ba8a-dd1ed8f503f8\nAccount Number\nBank Account\nString\n3\n{bold}Acct #{bold} {value}\n\n\nef6c4d44-7692-4127-9883-3ec390df46de\nAmount\nBank Transaction Amount\nString\n4\n{bold}Amt{bold} {value}\n\n\n7da3178d-135f-4aad-91a4-eca544a781a2\nTeller Id #\nBank Teller Id\nString\n5\n{bold}Teller#{bold} {value}\n\n\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The Details tab of the event editor will show all of the metadata fields and their values, and the Search panel makes these fields available for searching:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":57.0},"content":[{"type":"media","attrs":{"width":344,"id":"d24c6fd5-eefa-4ad9-ae98-b46b110e387a","collection":"contentId-83787904","type":"file","height":219}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CreateGenericEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"Once an event definition has been created, use ","type":"text"},{"text":"CreateGenericEvent","type":"text","marks":[{"type":"em"}]},{"text":" to send all the data for a new event:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\ndateTime\nint\nint\nboolean\nlong\nstring\nboolean\n\n\nstring\nstring\n\n\n...\n\n\n\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Generic Event Metadata Fields","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"The GUID of the event; left empty for the Create operation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"EventTime","type":"text","marks":[{"type":"strong"}]},{"text":"> The DateTime of the event","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"StartTimeDelta","type":"text","marks":[{"type":"strong"}]},{"text":"> Millisecond time span added to Event Time for the start of the Event Video. To start recording the video 2 seconds before the event time, the value would be -2000","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"EndTimeDelta","type":"text","marks":[{"type":"strong"}]},{"text":"> Millisecond time span added to Event Time for the end of the Event Video. To stop recording the video 2 seconds after the event time, the value would be 2000.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"UseServerTime","type":"text","marks":[{"type":"strong"}]},{"text":"> Set to \"true,\" the event time provided will be replaced with the server time when the event is recorded on the server. (The Event Time must still be set on the request. DateTime values cannot be null.)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"ChannelId","type":"text","marks":[{"type":"strong"}]},{"text":"> The ID of the camera recording the event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"DefinitionGUID","type":"text","marks":[{"type":"strong"}]},{"text":"> The GUID of the Generic Event Definition.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"CloseEvent","type":"text","marks":[{"type":"strong"}]},{"text":"> If true the event is closed immediately, even if the event will update. It allows the details of the event to be available as soon as the event is created. There may be a delay while the video is buffered and saved.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"MetadataList","type":"text","marks":[{"type":"strong"}]},{"text":"> List of GUID, value pairs for the event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Images","type":"text","marks":[{"type":"strong"}]},{"text":"> Optional, supply images that can be inserted into the event. These images are used instead of images captured by the 3VR appliance. See \"The Images Element\" below for more information.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"SpecialSearchDataList","type":"text","marks":[{"type":"strong"}]},{"text":"> Internal use.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"FaceComparison","type":"text","marks":[{"type":"strong"}]},{"text":"> Optional, compares a reference person to a face event near the time the event is created.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CreateGenericEvent Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The response to a succesful ","type":"text"},{"text":"CreateGenericEvent","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" request will contain the GUID of the Generic Event:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The Images Element","type":"text"}]},{"type":"paragraph","content":[{"text":"If the images for the event are provided from outside the 3VR appliance, use the <","type":"text"},{"text":"Images","type":"text","marks":[{"type":"em"}]},{"text":"> tag. These images will be displayed in the event details.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nint\nint\nUnknown or Yuv444 or Yuv420 or Grayscale or GrayscaleRgb or Rgb or Jpeg or\nBitmap\nunsignedInt\ndouble\nbase64Binary\ndateTime\n\n\n...\n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Each image sent with a generic event should have the following properties:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Generic Event Image Element Content","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Width","type":"text","marks":[{"type":"strong"}]},{"text":"> The pixel width of the image.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Height","type":"text","marks":[{"type":"strong"}]},{"text":"> The pixel height of the image","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"Format","type":"text","marks":[{"type":"strong"}]},{"text":"> The format of the Image Buffer bytes.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"NominalAspectRatio","type":"text","marks":[{"type":"strong"}]},{"text":"> Set to 2 for an NTSC interlaced image field and set to 1 for a mega pixel or non-interlaced image.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"AspectRatioAdjustment","type":"text","marks":[{"type":"strong"}]},{"text":"> Accounts for non-square pixels. Value is 1.0 for square pixels.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"ImageBuffer","type":"text","marks":[{"type":"strong"}]},{"text":"> Contains the base 64 encoded bytes of the image in the format specified in the tag.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"ImageTime","type":"text","marks":[{"type":"strong"}]},{"text":"> The DateTime of the image.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The SpecialSearchDataList Element","type":"text"}]},{"type":"paragraph","content":[{"text":"Leave the following eleemnt empty; it is reserved for internal use.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\nbase64Binary\n\n\nstring\nbase64Binary\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The FaceComparison Element","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"width":190,"id":"b28b0803-498a-43ca-8150-1578dca743a6","collection":"contentId-83787904","type":"file","height":98}}]},{"type":"paragraph","content":[{"text":"Face Comparison events extend Generic Events by comparing the image of a known person with a face from a face event near the same time as the Generic Event. Face Comparison events are created when the <","type":"text"},{"text":"FaceComparison","type":"text","marks":[{"type":"em"}]},{"text":"> XML is provided to the ","type":"text"},{"text":"CreateGenericEvent","type":"text","marks":[{"type":"em"}]},{"text":" operation.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nint\nint\n\nstring\nstring\n","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":739,"id":"a69750a5-5330-4e37-a39e-4e89feaed564","collection":"contentId-83787904","type":"file","height":418}}]},{"type":"paragraph","content":[{"text":"The following list provides more detail on each child element of :","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Face Comparison Metadata","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"StartTimeReferenceDelta","type":"text","marks":[{"type":"strong"}]},{"text":"> Sets the time to start searching for a face event, relative to the event start time (in milliseconds). To search 5 seconds before the event time, the value is -5000. To search 3.5 seconds after the event time, the value is 3500.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"EndTimeReferenceDelta","type":"text","marks":[{"type":"strong"}]},{"text":"> Sets the time to stop searching for a face event, relative to the event start time (in milliseconds). To search 5 seconds after the event time, the values is 5000. To search 10.5 seconds after the event time, the value is 10500.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"ReferenceImage","type":"text","marks":[{"type":"strong"}]},{"text":"> Provides an alternate face reference image instead of using people in the 3VR system. If this tag is set, the Custom Field tags below are ignored.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"CustomFieldName","type":"text","marks":[{"type":"strong"}]},{"text":"> The Custom Field name used to identify people in the 3VR system. Custom Fields are listed on the Person card in OpCenter, or can be retrieved by the CustomFieldNames operation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"CustomFieldValue","type":"text","marks":[{"type":"strong"}]},{"text":"> The value of the Custom Field.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"If a is used, it should have the same children elements as the element defined previously (e.g. and so on.)","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Extended Generic Event Operations","type":"text"}]},{"type":"paragraph","content":[{"text":"The following operations are supplemental to the creation of Generic Events. In the XML, these examples would be wrapped in the ","type":"text"},{"text":"soap:body","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" part of the envelope. The SOAP header would contain the ServiceToken found in the response from Authenticate.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Channels","type":"text"}]},{"type":"paragraph","content":[{"text":"Get a list of cameras.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\nlong\nstring\nint\nstring\nstring\nstring\nboolean\n\n\n...\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"CustomFieldNames","type":"text"}]},{"type":"paragraph","content":[{"text":"Get a list of custom field names associated with a person profile in the 3VR system. These can be used when specifying Face Comparison events.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\nstring\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"DeleteGenericEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"Delete a generic event from the server with given GUID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","content":[{"text":"\nString\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GenericEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"Get a Generic Event from the server with given GUID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\ndateTime\nint\nint\nboolean\nlong\nstring\n\n\nstring\nstring\n\n\n...\n\n\n\n\n...\n\n\n...\n\n\n\n\nstring\nbase64Binary\n\n\n...\n\n\nboolean\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GenericEventDefinitionByGUID","type":"text"}]},{"type":"paragraph","content":[{"text":"Find the Generic Event Definition with the provided GUID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Sample response","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\nstring\nstring\nstring\nstring\n\n\nstring\nstring\nstring\nString or Number or DateTime or EnumeratedType\nint\nstring\n\n\n\n...\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":" GenericEventDefinitionsAll","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\nstring\nstring\nstring\nstring\n\n\n\n\n\n\n...\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"GenericEventDefinitionsByName","type":"text"}]},{"type":"paragraph","content":[{"text":"Find all the generic event definitions with the provided name.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\nstring\nstring\nstring\nstring\n\n\n\n\n\n\n...\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UpdateGenericEvent","type":"text"}]},{"type":"paragraph","content":[{"text":"Update a generic event with new data.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Request Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\ndateTime\nint\nint\nboolean\nlong\nstring\n\n\nstring\nstring\n\n\n...\n\n\n\n\n...\n\n\n\nboolean\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns the GUID of the event.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\nstring\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UpdateGenericEventDefinition","type":"text"}]},{"type":"paragraph","content":[{"text":"Update an existing Generic Event Definition. GUIDs must match for existing elements.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Request","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\nstring\nstring\nstring\n\n\nstring\nstring\nstring\nString or Number or DateTime or EnumeratedType\nint\nstring\n \n\n...\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sample Response","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\nstring\nstring\nstring\nstring\n\n\nstring\nstring\nstring\nString or Number or DateTime or EnumeratedType\nint\nstring\n\n\n\n...\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Interface and Data Classes","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are using a high level language like C#, you may have access to support classes that will serialize and deserialize the XML for you. Here are the data and interface classes for the Generic Event Service.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"C# Interface for the IGenericEventService operations","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"publicinterfaceIGenericEventService {\npublic interface IGenericEventService{EventDefinitionData CreateGenericEventDe finiti\non(EventDefinitionDataeventDefinition);\nEventDefinitionData UpdateGenericEventDefinition(EventDefinitionDataeventDefinition);\nEventDefinitionData[] GenericEventDefinitionsByName(string name);\nEventDefinitionData GenericEventDefinitionByGuid(string guid);\nEventDefinitionData[] GenericEventDefinitionsAll();\nstring DeleteGenericEventDefinition(string guid);\nChannelInfo[] Channels();\nGenericEventData GenericEvent(string guid);\nstring CreateGenericEvent(GenericEventData genericEvent);\nstring UpdateGenericEvent(GenericEventData genericEvent);\nstring DeleteGenericEvent(string guid);\nstring[] CustomFieldNames();\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"C# classes for IGenericEventService operations","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"[Serializable]\npublic class GenericEventData\n{\npublic string Guid;\npublic DateTime EventTime;\npublic int StartTimeDelta;\npublic int EndTimeDelta;\npublic bool UseServerTime;\npublic long ChannelId;\npublic string DefinitionGuid;\npublic GenericEventMetadata[] MetadataList;\npublic GenericEventImage[] Images;\npublic GenericEventSpecialSearchData[] SpecialSearchDataList;\npublicbool CloseEvent = true;\npublic ReferenceComparison FaceComparison;\n[Serializable]\npublic class ReferenceComparison\n{\npublic int StartTimeReferenceDelta;\npublic int EndTimeReferenceDelta;\npublic GenericEventImage ReferenceImage;\npublic string CustomFieldName;\npublic string CustomFieldValue;\n}\n[Serializable]\npublic class GenericEventMetadata\n{\npublic string Guid;\npublic string Value;\n}\n[Serializable]\npublic class EventDefinitionData\n{\npublic string Name;\npublic string ShortName;\npublic string Guid;\npublic string HelpText;\npublic MetadataField[] MetadataFields;\n}\n[Serializable]\npublic classMetadataField\n{\npublic string Guid;\npublic string Name;\npublic string Description;\npublic MetadataType Type;\npublic int DisplayPosition;\npublic string DisplayFormat;\npublic EnumeratedData EnumeratedData;\n}\n[Serializable]\npublic class EnumeratedData\n{\npublic string Name;\npublic string[] Values;\n}\n[Serializable]\npublic enum MetadataType\n{\nString = 1,\nNumber = 2,\nDateTime = 3,\nEnumeratedType = 4 }\n/// Sensor types\n/// Unknown = 0,\n/// AnalogCamera = 1, 'Live' input from Hikvision\n/// ImageFiles = 2, 'Imported from the UI\n/// IPNetworkCamera = 3, 'Live' input from IMF\n/// VideoFiles = 4, 'Live' input from FIM\n/// UsbCamera = 5, 'Live' input from FIM\n[Serializable]\npublic class ChannelInfo\n{\npublic long Id;\npublic string Name;\npublic int DisplayNumber;\npublic string Identifier;\npublic string Description;\npublic string HostName;\npublic Boolean IsActive;\n} [Serializable]\npublic class GenericEventImage\n{\npublic int Width;\npublic int Height;\npublic PictureFormat Format;\npublic int NominalAspectRatio;\npublic double AspectRatioAdjustment;\npublic byte[] ImageBuffer;\npublic DateTime ImageTime;\npublic enumPictureFormat\n{\nUnknown,\nYuv444,\nYuv420,\nGrayscale,\nGrayscaleRgb,\nRgb,\nJpeg,\nBitmap\n}\n}\n[Serializable]\npublic class GenericEventSpecialSearchData\n{\npublic string SearchEngineGuid;\npublic byte[] SearchData;\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3VR External Query API","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR External Query API is used to retrieve events from a standalone 3VR system. The 3VR External Query API cannot be used to retrieve information from an Enterprise appliance. These events correspond to the event cards displayed using 3VR's OpCenter UI.","type":"text"}]},{"type":"paragraph","content":[{"text":"Queries are formed as XML documents called \"predicates\". A predicate is sent to the 3VR system using an HTTP POST command. In response, the server will send a well-formed RSS 2.0 XML document listing the set of events that match the predicate. Included in the list is a URL for each event.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using an HTTP GET command, the client can then retrieve detailed information about the event (also in XML form) from that URL. Each event retrieved is a structured object with a set of attached data.","type":"text"}]},{"type":"paragraph","content":[{"text":"The exchange between client and server is shown here:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":57.0},"content":[{"type":"media","attrs":{"width":382,"id":"76399bab-f9c3-44d1-8be5-24b8e668e508","collection":"contentId-83787904","type":"file","height":350}}]},{"type":"paragraph","content":[{"text":"All exchanges are secure using HTTP BASIC authentication. The user names and passwords must match users that have been added to your 3VR system using System Manager.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Query Format","type":"text"}]},{"type":"paragraph","content":[{"text":"To perform the query, the client POSTs the predicate XML to the URL ","type":"text"},{"text":"https://[host name]:8080/rss/","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" where the XML is passed as the URL encoded argument \"queryxml\" in the request body. (Your programming environment probably has helper functions to perform this POST operation for you. See the sample and helper code for some examples.) The predicate XML will look something like this (the details of each element will be explained in later sections):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n \n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Query Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR appliance will return up to 50 matching events per query. The response will be an RSS 2.0 formatted XML document, like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n\n3VR Events\nhttps://<3vr-server>:8080/index.xml?allalerts=\nEvents matching the descriptions\n8/3/2007 4:50:43 PM\n8/3/2007 4:50:43PM\n\n8/3/2007 4:47:15 PM - 8/3/2007 4:47:49 PM: Motion Event on Camera Camera 1</\ntitle>\n<link>http://<3vr-server>:80/event/id</link>\n<description><img alt=http://<3vr-server>:80/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/\nimages1.24.MFA src=\"http://<3vr-server>:80/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/images1.24.\nMFA\" width=120 height=80><img alt=http://<3vr-server>:80/images/3 _ 8 _ 2007/23/eventtype\n_ 1/0/1/images1.25.MFA src=\"http://<3vr-server>:80/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/\nimages1.25.MFA\" width=120 height=80><img alt=http://<3vr-server>:80/images/3 _ 8 _ 2007/23/\neventtype _ 1/0/1/images1.26.MFA src=\"http://<3vr-server>:80/images/3 _ 8 _ 2007/23/eventtype\n_ 1/0/1/images1.26.MFA\" width=120 height=80></description>\n<pubDate>4:50 PM</pubDate>\n</item>\n</channel>\n</rss>","type":"text"}]},{"type":"paragraph","content":[{"text":"Most of this XML is intended to allow reasonable output when viewing this XML in a browser. As a programmer, the tag that you're most interested in is the <link> tag under <item>. Each of these contains the URL for the detailed information about that event.","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve the event information, use an HTTP GET command with that URL. The result will be an XML document that looks like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<?xml-stylesheet type=\"text/xsl\" href=\"/eventstylesheet.xsl\"?>\n<ThreeVRExport version=\"6.0\" date=\"8/6/2007 10:13:25 AM\" server=\"https://<3vr-server>:8080\"\nApplianceGuid=\"fc8ca7c5-83e7-4b8d-af70-b599b5635509\">\n<ThreeVREventExport>\n<EventCollectionExt>\n<Events>\n<Event XmlReferenceId=\"14\" StartTime=\"2007-08-03T16:47:15.7640000-07:00\" _ Short-\nStartTime=\"8/3/2007 4:47:15 PM\" EndTime=\"2007-08-03T16:47:49.3060000-07:00\" _ ShortEnd-\nTime=\"8/3/2007 4:47:49 PM\" Status=\"Closed\" Guid=\"08c12540-7e74-4d58-bf3f-580771130ddb\">\n<EventType XmlReferenceId=\"15\" Name=\"Motion\" /> <Appliance XmlReferenceId=\"16\"\nName=\"<3vr-server>\" HostAddress=\"<3vr-server>\" Guid=\"fc8ca7c5-83e7-4b8d-af70-b599b5635509\" />\n<Channel XmlReferenceId=\"17\" Name=\"Camera 1\" DisplayNumber=\"1\" ChannelType=\"AnalogCamera\"\nDescription=\"\" Identifier=\"analogcamera://1\" />\n<SpecializedEvent>\n<MotionEvent XmlReferenceId=\"18\">\n<EventDetails>\n<MotionEventDetails XmlReferenceId=\"19\" GridHeight=\"15\" GridWidth=\"22\"\nGridPixelAspectRatioAdjustment=\"1.10000002384186\" GridPixelAspectRatioNominal=\"1\">\n<OriginationByteArray />\n<PresenceByteArray>…</PresenceByteArray>\n<DirectionByteArray>…</DirectionByteArray>\n<TerminationByteArray />\n</MotionEventDetails>\n</EventDetails>\n<BaseEvent>\n<Event XmlReferenceId=\"14\" IsReference=\"True\" />\n</BaseEvent>\n<UserFrames />\n<MotionFrames>\n<MotionFrame XmlReferenceId=\"20\" IsUserCreated=\"False\" TimeStamp=\"8/3/2007\n4:47:16 PM\">\n<Picture XmlReferenceId=\"21\" TimeStamp=\"2007-08-\n03T16:47:16.1700000-07:00\" _ ShortTimeStamp=\"8/3/2007 4:47:16 PM\" AspectRatioAdjustment=\"1\"\nNominalAspectRatio=\"1\" Width=\"160\" Height=\"120\" ImageWidth=\"160\" ImageHeight=\"120\"\nIsAnnotated=\"False\" FilePath=\"https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/\nimages1.24.MFA\" />\n</MotionFrame>\n<MotionFrame XmlReferenceId=\"22\" IsUserCreated=\"False\" TimeStamp=\"8/3/2007\n4:47:33 PM\">\n<Picture XmlReferenceId=\"23\" TimeStamp=\"2007-08-\n03T16:47:33.7850000-07:00\" _ ShortTimeStamp=\"8/3/2007 4:47:33 PM\" AspectRatioAdjustment=\"1\"\nNominalAspectRatio=\"1\" Width=\"160\" Height=\"120\" ImageWidth=\"160\" ImageHeight=\"120\"\nIsAnnotated=\"False\" FilePath=\"https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/\nimages1.25.MFA\" />\n</MotionFrame> <MotionFrame XmlReferenceId=\"24\" IsUserCreated=\"False\"\nTimeStamp=\"8/3/2007 4:47:35 PM\"> <Picture XmlReferenceId=\"25\" TimeStamp=\"2007-08-\n03T16:47:35.3950000-07:00\" _ ShortTimeStamp=\"8/3/2007 4:47:35 PM\" AspectRatioAdjustment=\"1\"\nNominalAspectRatio=\"1\" Width=\"160\" Height=\"120\" ImageWidth=\"160\" ImageHeight=\"120\"\nIsAnnotated=\"False\" FilePath=\"https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/\nimages1.26.MFA\" />\n</MotionFrame>\n</MotionFrames>\n<Videos>\n<Video XmlReferenceId=\"26\" StartTime=\"2007-08-03T16:47:15.7480000-07:00\"\n_ ShortStartTime=\"8/3/2007 4:47:15 PM\" EndTime=\"2007-08-03T16:47:45.9150000-07:00\" _ Short-\nEndTime=\"8/3/2007 4:47:45 PM\" ChannelId=\"1\" PixelAspectRatioAdjustment=\"1.10000002384186\"\nPixelAspectRatioNominal=\"1\" Width=\"352\" Height=\"240\" VideoFormat=\"HikvisionH264\"\nFilePath=\"https://<3vr-server>:8080/videos/3 _ 8 _ 2007/23/videos/0/1/0.mpg\" />\n<Video XmlReferenceId=\"27\" StartTime=\"2007-08-03T16:47:45.9150000-07:00\"\n_ ShortStartTime=\"8/3/2007 4:47:45 PM\" EndTime=\"2007-08-03T16:47:56.3240000-07:00\" _ Short-\nEndTime=\"8/3/2007 4:47:56 PM\" ChannelId=\"1\" PixelAspectRatioAdjustment=\"1.10000002384186\"\nPixelAspectRatioNominal=\"1\" Width=\"352\" Height=\"240\" VideoFormat=\"HikvisionH264\"\nFilePath=\"https://<3vr-server>:8080/videos/3 _ 8 _ 2007/23/videos/0/1/1.mpg\" />\n</Videos>\n</MotionEvent>\n</SpecializedEvent>\n<TriggeredAlerts />\n<MetadataElements />\n</Event>\n</Events>\n</EventCollectionExt>\n</ThreeVREventExport>\n</ThreeVRExport>","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Images and videos associated with the event can also be retrieved by their URL as referenced by the <FilePath> elements.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Predicate Shortcuts with Query Feed","type":"text"}]},{"type":"paragraph","content":[{"text":"For convenience, the 3VR Query API includes a feature called \"Query Feed' that offers set of built-in predicates for certain common queries. This allows client programs to bypass the predicate definition step and obtain a list of matching events with a simple GET request.","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Developers familiar with the API for 3VR Software Version 6.0 will recognize the URL paths below, which formerly belonged to an API called the \"3VR Event Syndication API.\" Although these queries still exist in 7.X, in the new software version the 3VR Live Query API was developed to permit continous, real-time event streams. Refer to the \"3VR Live Query API\" section for more information.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The following built-in queries are available as Query Feeds:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"Query","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"URL","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"ALL EVENTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"https://[IP address or hostname]:8080/feed/events/all","type":"text","marks":[{"type":"link","attrs":{"href":"/events/all"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the most recent events of any type.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"MOTION EVENTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"https://[IP address or hostname]:8080/feed/events/motion","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the most recent motion events.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"FACE EVENTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"https://[IP address or hostname]:8080/feed/events/face","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"For VIP Appliances with the Facial Surveillance analytic enabled, returns the recent faces captured by the system.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"GENERIC EVENTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"https://[IP address or hostname]:8080/feed/events/generic","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Returns event types that are not system defaults. This includes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Events created by applications using the External System Activity API","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Events created by a transaction plug-in, such as the 3VR ATM Data Capture plug-in","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Events generated by an analytic plug-in, such as VIP License Plate Recognition","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"ALERTS","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"https://[IP address or hostname]:8080/feed/alerts","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the most recent events that have triggered an alert.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[269.0]},"content":[{"type":"paragraph","content":[{"text":"SPECIFIC ALERT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[390.0]},"content":[{"type":"paragraph","content":[{"text":"https://[IP address or hostname]:8080/feed/alert/[alertname]","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[566.0]},"content":[{"type":"paragraph","content":[{"text":"Returns the most recent events that triggered the alert named [alertname].","type":"text"}]},{"type":"paragraph","content":[{"text":"To return more than one alert name, separate the names with an ampersand (&).","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Defining Predicates","type":"text"}]},{"type":"paragraph","content":[{"text":"Predicates act as the filters that determine which events in the system are returned by a specific request. Predicates act on facets of the events. A facet is a single element, such as the start time of the event or the name of a specific alert that the event triggered. These can be combined to form more complex predicates, for example we may want to retrieve all events with a start time that was in the past hour and that triggered the alert called \"Motion in Storage Room.\"","type":"text"}]},{"type":"paragraph","content":[{"text":"The XML for a predicate has a simple structure. The XML frame for the predicate looks like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Predicate>Submitted predicate\n</Predicate>","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"For a complete XML schema of the predicate structure, see the query.xsd file in the SDK.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Each query is a request like this submitted with an HTTP POST command. The Predicate element always has exactly one child, which is the actual predicate. Predicates can be nested when appropriate. For example, an and predicate can contain other predicates but a predicate of type comparison cannot.","type":"text"}]},{"type":"paragraph","content":[{"text":"An individual predicate has the following form:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<PredType name=\"name\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\nSub-predicates or components\n</PredType>","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, the predicate described above (looking for events matching both a time and an alert trigger) will be formatted like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<ComparisonPredicate name=\">\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\n\">\nComparison operands\n</ComparisonPredicate>\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\nComparison Operands\n</ComparisonPredicate>\n</AndPredicate","type":"text"}]},{"type":"paragraph","content":[{"text":"The most important predicates are the Comparison predicate, which supports filtering by facets, and the and and or predicates which allow you to combine predicates in the obvious ways. In the above example we combine two comparison predicates with an and predicate which is quite common.","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note that although this section of the documentation explains how to manually format a query, 3VR also provides various libraries to construct XML queries with ease. The use of the libraries will be explained later.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Operands","type":"text"}]},{"type":"paragraph","content":[{"text":"The Comparison predicate compares two Operands using the supplied comparison. The full expression looks like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"TriggeredAlerts.Alert.Name\" />\n<Comparison operation=\"=\" />\n<ValueOperand type=\"System.String\" value=\"Motion in Storage Room\" />\n</ComparisonPredicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"Here, the comparison is an equals (=) operation, and the operands are a facet operand and a value operand. The facet operand determines which facet of the event to use in the comparison, in this case, ","type":"text"},{"text":"TriggeredAlerts.Alert.Name","type":"text","marks":[{"type":"em"}]},{"text":". Please refer to the section \"Predicate Facets Reference\" for a description of all available facets.","type":"text"}]},{"type":"paragraph","content":[{"text":"The value operand represents the value and type of operand with which that facet should be compared. The type defines how the value string will be interpreted; the most common types are System.String, System.Integer, System.Long, System.DateTime, and System.TimeSpan. Unless the value should be parsed as a date, the type selected does not usually matter.","type":"text"}]},{"type":"paragraph","content":[{"text":"The comparison predicate supports the following comparison operations: ","type":"text"},{"text":"=, !=, >, >=, <, <=","type":"text","marks":[{"type":"strong"}]},{"text":" and LIKE. These work as you would expect with LIKE being a standard SQL LIKE. For strings, using LIKE is the same as using = except '_' matches any character and '%' matches any string of characters. Using LIKE with a value operand of 'Smit%' will match any string that begins with 'Smit'","type":"text"},{"type":"hardBreak"},{"text":"including Smith and Smits.","type":"text"}]},{"type":"paragraph","content":[{"text":"In addition to the facet operand and the value operand, the system also supports array value operands and relative value operands. Array value operands allow a set of values to be supplied to the comparison. This is only valid when = is used as the comparison operator. The comparison will succeed if any of the values passed in for the array value operand equal the corresponding facet.","type":"text"}]},{"type":"paragraph","content":[{"text":"The format of the array value operand looks like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<ArrayValueOperand>\n<type1 type=\" type1\" value=\"value1\" />\n<type2 type=\"type2\" value=\"value2\" />\n… more sub-operands …\n</ArrayValueOperand>","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, if we wanted to extend the above comparison to include events that triggered either a \"Motion in Storage Room\" alert or a \"Motion in Lobby\" alert, we can create the following comparison:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"TriggeredAlerts.Alert.Name\" />\n<Comparison operation=\"=\" />\n<ArrayValueOperand>\n<System.String type=\"System.String\" value=\"Motion in Storage Room\" />\n<System.String type=\"System.String\" value=\"Motion in Lobby\" />\n</ArrayValueOperand>\n</ComparisonPredicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"Relative value operands allow you to specify operands that are relative to the present. They only work with times. The format for a relative value operand is:","type":"text"}]},{"type":"codeBlock","content":[{"text":"<RelativeValueOperand type=\"System.TimeSpan\" value=\"hh:mm:ss\" />","type":"text"}]},{"type":"paragraph","content":[{"text":"where hh, mm, and ss are hours, minutes and seconds, respectively. For example, to retrieve all events in the past half hour, use the following comparison:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"StartTime\" />\n<Comparison operation=\"=\" />\n<RelativeValueOperand type=\"System.TimeSpan\" value=\"0:30:00\" />\n</ComparisonPredicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"To find all events that occurred between 11PM and 1AM, use the following predicate:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<TimeRangePredicate name=\"TimeRange\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"Fals\ne\">\n<FacetOperand reference=\"starttime\" />\n<ValueOperand type=\"System.DateTime\" value=\"1/1/2000 11:00 PM\" />\n<ValueOperand type=\"System.DateTime\" value=\"1/1/2000 1:00 AM\" />\n</TimeRangePredicate>","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Additional Predicates","type":"text"}]},{"type":"paragraph","content":[{"text":"While most queries are written using the and, or, and comparison predicates, there are a number of other predicates that are useful for more complex querying.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Disjoint Predicates","type":"text"}]},{"type":"paragraph","content":[{"text":"Disjoint","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"and","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Disjoint","type":"text","marks":[{"type":"em"}]},{"text":" or are variants of the and and or predicates. The difference is in the way that they evaluate facets relative to each other. The regular and and or predicates treat multiple references to the same facet name as a reference to the same object in the database. This is very efficient, but sometimes can cause problems.","type":"text"}]},{"type":"paragraph","content":[{"text":"For example, when you want to query for a generic event which has two separate pieces of metadata (for example, teller ID and account number) set to specific number, the following and predicate will not work:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n\n<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"MetaDataElements.MetadataKey.Name\" />\n<Comparison operation=\"=\" />\n<ValueOperand type=\"System.String\" value=\"Teller ID\" />\n</ComparisonPredicate>\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"MetaDataElements.MetadataStringValue.StringValue\" />\n<Comparison operation=\"=\" />\n<ValueOperand type=\"System.String\" value=\"870-19766\" />\n</ComparisonPredicate>\n</AndPredicate>\n\n<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"MetaDataElements.MetadataKey.Name\" />\n<Comparison operation=\"=\" />\n<ValueOperand type=\"System.String\" value=\"Account Number\" />\n</ComparisonPredicate>\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"MetaDataElements.MetadataStringValue.StringValue\" />\n<Comparison operation=\"=\" />\n<ValueOperand type=\"System.String\" value=\"0076 5609 3817\" />\n</ComparisonPredicate>\n</AndPredicate>\n</AndPredicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"This does not work because ","type":"text"},{"text":"MetaDataElements.MetadataKey.Name","type":"text","marks":[{"type":"em"}]},{"text":" refers to the same database entry both times it's mentioned, and cannot equal both \"Teller ID\" and \"Account Number\" at the same time.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to make this work, we replace the top level with a ","type":"text"},{"text":"disjoint and","type":"text","marks":[{"type":"em"}]},{"text":" predicate:","type":"text"}]},{"type":"codeBlock","content":[{"text":"<DisjointAndPredicate name=\"disjointand\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"\nFalse\">\n\n<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n… Same comparisons as above …\n</AndPredicate>\n\n<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n… Same comparisons as above …\n</AndPredicate>\n</DisjointAndPredicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"disjoint or","type":"text","marks":[{"type":"em"}]},{"text":" predicate works in the same fashion.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"disjoint","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"and","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"disjoint","type":"text","marks":[{"type":"em"}]},{"text":" or predicates are much more expensive in terms of database load than the ","type":"text"},{"text":"and","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"or","type":"text","marks":[{"type":"em"}]},{"text":" predicates. For this reason, they should be avoided whenever possible. Often the use of an array value operand will have the same effect and be much more efficient.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Not Predicate","type":"text"}]},{"type":"paragraph","content":[{"text":"The not predicate inverts the sense of a predicate included under it. For example, to find all events except those for cameras 1 and 2, use the following:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<NotPredicate name=\"not\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"Channel.Id\" />\n<Comparison operation=\"=\" />\n<ArrayValueOperand>\n<System.Long type=\"System.Long\" value=\"1\" />\n<System.Long type=\"System.Long\" value=\"2\" />\n</ArrayValueOperand>\n</ComparisonPredicate>\n</NotPredicate>","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Exists Predicate","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"exists","type":"text","marks":[{"type":"em"}]},{"text":" predicate determines if some item is in the database at all. For example, to find all events with notes, use this predicate:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<ExistsPredicate name=\"exists\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<FacetOperand reference=\"Notes.Id\" />\n</ExistsPredicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"not exists","type":"text","marks":[{"type":"em"}]},{"text":" predicate reverses the sense of ","type":"text"},{"text":"exists","type":"text","marks":[{"type":"em"}]},{"text":" and is identically structured. Always use this instead of creating a combination of ","type":"text"},{"text":"not","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"exists","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"text":"Not","type":"text","marks":[{"type":"em"}]},{"text":" does not invert ","type":"text"},{"text":"exists","type":"text","marks":[{"type":"em"}]},{"text":" correctly because of the way that the SQL database works underneath.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Is Null Predicate","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Is Null","type":"text","marks":[{"type":"em"}]},{"text":" predicate matches facets that exist, but are null in the database. It is structurally identical to the ","type":"text"},{"text":"Exists","type":"text","marks":[{"type":"em"}]},{"text":" predicate.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Time Range Predicate","type":"text"}]},{"type":"paragraph","content":[{"text":"The Time Range predicate allows you to retrieve events that occurred during a specified period during the day. It includes three operands: the facet to check, the beginning of the time range, and the end of the time range. If the end is earlier than the beginning, the time range is assumed to cross midnight. The time is passed as full date/times, but the date component is ignored.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Processing Returned Events","type":"text"}]},{"type":"paragraph","content":[{"text":"Upon receiving the POST request, 3VR system interprets the predicate, executes the query and sends a response of the summary of matching events in RSS 2.0 format:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<rss version=\"2.0\" xmlns:media=\"http://search.yahoo.com/mrss/\" xmlns:dc=\"http://purl.org/dc/\nelements/1.1/\">\n<channel>\n<title>3VR Events\nhttps://<3vr-server>:8080/index.xml?allalerts=\nEvents matching the descriptions\n8/3/2007 4:50:43 PM\n8/3/2007 4:50:43PM\n\n8/3/2007 4:47:15 PM - 8/3/2007 4:47:49 PM: Motion Event on Camera Camera 1</\ntitle>\n<link>http://<3vr-server>:80/event?id=1</link>\n<description><img alt=https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype\n_ 1/0/1/images1.24.MFA src=\"https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype\n_ 1/0/1/images1.24.MFA\" width=120 height=80><img alt=https://<3vr-server>:8080/\nimages/3 _ 8 _ 2007/23/eventtype _ 1/0/1/images1.25.MFA src=\"https://<3vr-server>:8080/images/\n3 _ 8 _ 2007/23/eventtype _ 1/0/1/images1.25.MFA\" width=120 height=80><img\nalt=https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/images1.26.MFA\nsrc=\"https://<3vr-server>:8080/images/3 _ 8 _ 2007/23/eventtype _ 1/0/1/images1.26.MFA\" width=120\nheight=80></description>\n<pubDate>4:50 PM</pubDate>\n</item>\n</channel>\n</rss>","type":"text"}]},{"type":"paragraph","content":[{"text":"Each <","type":"text"},{"text":"item","type":"text","marks":[{"type":"em"}]},{"text":"> element represents a matching event.","type":"text"},{"type":"hardBreak"},{"text":"Most of this response XML is intended to allow a browser to display reasonable output. As a programmer, the tag that you are most interested in is the <","type":"text"},{"text":"link","type":"text","marks":[{"type":"em"}]},{"text":"> tag under <","type":"text"},{"text":"item","type":"text","marks":[{"type":"em"}]},{"text":">. Each <","type":"text"},{"text":"link","type":"text","marks":[{"type":"em"}]},{"text":"> tag contains the URL for the detailed information about that event.","type":"text"}]},{"type":"paragraph","content":[{"text":"Since RSS 2.0 format complies with standard XML format, all standard methods for parsing XML, e.g. SAX, DOM, or simply parsing text, can be used to retrieve information from the XML document. Examples can be found in the section \"Using Language-specific Libraries to Access the 3VR External Query API\".","type":"text"}]},{"type":"paragraph","content":[{"text":"To retrieve the event information, use an HTTP GET command with the URL in the <link> element. The response XML can be processed using any standard XML parser, and has the following format:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<ThreeVRExport version=version date=queryTime server=\"\" ApplianceGuid=sourceGuid>\n<ThreeVREventExport>\n<EventCollectionExt>\n<Events>\n<Event> Property elements </Event>\n</Events>\n</EventCollectionExt>\n</ThreeVREventExport>\n</ThreeVRExport>","type":"text"}]},{"type":"paragraph","content":[{"text":"There will always be only one <","type":"text"},{"text":"Event","type":"text","marks":[{"type":"em"}]},{"text":"> element under <","type":"text"},{"text":"Events","type":"text","marks":[{"type":"em"}]},{"text":">. It is a structured object containing all information the 3VR system captured for that event, and all facets of that event will be stored in the elements or attributes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Example","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"1","type":"text","marks":[{"type":"strong"}]},{"text":": Facet \"StartTime\" is stored as an attribute in the <Event> tag.","type":"text"},{"type":"hardBreak"},{"text":"Example","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"2","type":"text","marks":[{"type":"strong"}]},{"text":": Facet \"Channel\" is stored in a <Channel> element under <Event>.","type":"text"},{"type":"hardBreak"},{"text":"Example","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"3","type":"text","marks":[{"type":"strong"}]},{"text":": The location of the profile image is an attribute in the <","type":"text"},{"text":"Profile","type":"text","marks":[{"type":"em"}]},{"text":"> element under ","type":"text"}]},{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"SpecializedEvent","type":"text","marks":[{"type":"em"}]},{"text":">, or \"/ ","type":"text"},{"text":"ThreeVRExport/ThreeVREventExport/EventCollectionExt/Events/Event/SpecializedEvent/FaceEvent/ProfileGroup/CanonicalProfile/Profile/@ImageLocation\"","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"as expressed in XPath","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"A complete list of XPath for all facets can be found in the final section of this document.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"The full XML response for a face event looks like this:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<?xml-stylesheet type=\"text/xsl\" href=\"/eventstylesheet.xsl\"?>\n<ThreeVRExport version=\"6.0\" date=\"8/15/2007 10:52:32 AM\" server=\"https://<3vr-server>:8080\"\nApplianceGuid=\"30d53949-fe72-43b6-9429-8bb0e81ffde3\">\n<ThreeVREventExport>\n<EventCollectionExt>\n<Events>\n<Event XmlReferenceId=\"0\" StartTime=\"2007-07-18T16:50:53.6740000-07:00\" _ Short\nStartTime=\"7/18/2007 4:50:53 PM\" EndTime=\"2007-07-18T16:50:55.3770000-07:00\" _ ShortEnd-\nTime=\"7/18/2007 4:50:55 PM\" Status=\"Closed\" Guid=\"9db1d70c-d3a7-499a-97af-c8ca9524e1b4\">\n<EventType XmlReferenceId=\"1\" Name=\"Face\" />\n<Appliance XmlReferenceId=\"2\" Name=\"Developer Workstation\" HostAddress=\"<3vrserver>\"\nGuid=\"30d53949-fe72-43b6-9429-8bb0e81ffde3\" />\n<Channel XmlReferenceId=\"3\" Name=\"Camera 1\" DisplayNumber=\"1\"\nChannelType=\"AnalogCamera\" Description=\"\" Identifier=\"analogcamera://1\" />\n<SpecializedEvent>\n<FaceEvent XmlReferenceId=\"4\" FaceEventType=\"Camera\" MatchType=\"Indexed\">\n<ProfileGroup XmlReferenceId=\"5\" Guid=\"1b0c21e5-1657-4f1f-bf1bebbc23f19391\"\nCreationDate=\"7/18/2007 4:50:53 PM\" UseForAutoMatch=\"False\" Version=\"67240452\">\n<CanonicalProfile>\n<Profile XmlReferenceId=\"6\" Guid=\"946d2ead-5461-4a47-9bf1-\n634d3a139f29\" Quality=\"0\" AspectRatioAdjustment=\"1.10000002384186\" NominalAspectRatio=\"2\"\nWidth=\"704\" Height=\"240\" ImageWidth=\"704\" ImageHeight=\"240\" FaceLocationX=\"561.902709960938\"\nFaceLocationY=\"101.333190917969\" FaceWidth=\"40.2184638977051\" IsAnnotated=\"False\"\nImageTimestamp=\"2007-07-18T16:50:54.4710000-07:00\" _ ShortImageTimestamp=\"7/18/2007 4:50:54 PM\"\nImageLocation=\"https://<3vr-server>:8080/images/18 _ 7 _ 2007/23/eventtype _ 2/0/1/images1.24.\nMFA\">\n<Bits>…</Bits>\n</Profile>\n</CanonicalProfile>\n<Profiles>\n<Profile XmlReferenceId=\"6\" IsReference=\"True\" />\n<Profile XmlReferenceId=\"7\" Guid=\"511e23e4-d3d4-4f76-bc99-\n801733b102a3\" Quality=\"0\" AspectRatioAdjustment=\"1.10000002384186\" NominalAspectRatio=\"2\"\nWidth=\"704\" Height=\"240\" ImageWidth=\"704\" ImageHeight=\"240\" FaceLocationX=\"588.512878417969\"\nFaceLocationY=\"119.292823791504\" FaceWidth=\"37.9340286254883\" IsAnnotated=\"False\"\nImageTimestamp=\"2007-07-18T16:50:54.8770000-07:00\" _ ShortImageTimestamp=\"7/18/2007 4:50:54 PM\"\nImageLocation=\"https://<3vr-server>:8080/images/18 _ 7 _ 2007/23/eventtype _ 2/0/1/images1.25.\nMFA\">\n<Bits>…</Bits>\n</Profile>\n<Profile XmlReferenceId=\"8\" Guid=\"e763ef30-2315-4917-9d50-\n70447662a0a1\" Qual ity=\"0\" AspectRatioAdjustment=\"1.10000002384186\" NominalAspectRatio=\"2\"\nWidth=\"704\" Height=\"240\" ImageWidth=\"704\" ImageHeight=\"240\" FaceLocationX=\"573.310546875\"\nFaceLocationY=\"101.27188873291\" FaceWidth=\"40.6226844787598\" IsAnnotated=\"False\"\nImageTimestamp=\"2007-07-18T16:50:54.5800000-07:00\" _ ShortImageTimestamp=\"7/18/2007 4:50:54 PM\"\nImageLocation=\"https://<3vr-server>:8080/images/18 _ 7 _ 2007/23/eventtype _ 2/0/1/images1.26.\nMFA\">\n<Bits>…</Bits>\n</Profile>\n</Profiles>\n</ProfileGroup>\n<BaseEvent>\n<Event XmlReferenceId=\"0\" IsReference=\"True\" />\n</BaseEvent>\n<Frames>\n<FaceFrame XmlReferenceId=\"9\" IsSubGroupFrame=\"False\" FaceConfidence=\"3.91948986053467\" FaceLocationX=\"561.902709960938\" FaceLocationY=\"101.333190917969\"\nFaceQuality=\"0\" FaceWidth=\"40.2184638977051\" FirstEyeConfidence=\"3.95001864433289\" First-\nEyeLocationX=\"540.107666015625\" FirstEyeLocationY=\"100.637741088867\" SecondEyeConfidence=\"\n3.49672865867615\" SecondEyeLocationX=\"580.898864746094\" SecondEyeLocationY=\"\n100.739883422852\">\n<Picture XmlReferenceId=\"10\" TimeStamp=\"2007-07-\n18T16:50:54.4710000-07:00\" _ ShortTimeStamp=\"7/18/2007 4:50:54 PM\" AspectRatioAdjustment=\"\n1.10000002384186\" NominalAspectRatio=\"2\" Width=\"704\" Height=\"240\" ImageWidth=\"704\" ImageHeight=\"\n240\" IsAnnotated=\"False\" FilePath=\"https://<3vr-server>:8080/images/18 _ 7 _ 2007/23/\neventtype _ 2/0/1/images1.21.MFA\" />\n</FaceFrame>\n<FaceFrame XmlReferenceId=\"11\" IsSubGroupFrame=\"False\" FaceConfidence=\"\n3.1991331577301\" FaceLocationX=\"573.310546875\" FaceLocationY=\"101.27188873291\"\nFaceQuality=\"0\" FaceWidth=\"40.6226844787598\" FirstEyeConfidence=\"3.51949620246887\"\nFirstEyeLocationX=\"550.122863769531\" FirstEyeLocationY=\"99.4405822753906\" SecondEye-\nConfidence=\"2.99968218803406\" SecondEyeLocationX=\"592.0732421875\" SecondEyeLocationY=\"\n99.338264465332\">\n<Picture XmlReferenceId=\"12\" TimeStamp=\"2007-07-\n18T16:50:54.5800000-07:00\" _ ShortTimeStamp=\"7/18/2007 4:50:54 PM\" AspectRatioAdjustment=\"\n1.10000002384186\" NominalAspectRatio=\"2\" Width=\"704\" Height=\"240\" ImageWidth=\"704\" ImageHeight=\"\n240\" IsAnnotated=\"False\" FilePath=\"https://<3vr-server>:8080/images/18 _ 7 _ 2007/23/\neventtype _ 2/0/1/images1.23.MFA\" />\n</FaceFrame>\n<FaceFrame XmlReferenceId=\"13\" IsSubGroupFrame=\"False\" FaceConfidence=\"\n3.20546126365662\" FaceLocationX=\"588.512878417969\" FaceLocationY=\"119.292823791504\"\nFaceQuality=\"0\" FaceWidth=\"37.9340286254883\" FirstEyeConfidence=\"2.94460487365723\" First-\nEyeLocationX=\"563.047180175781\" FirstEyeLocationY=\"120.273956298828\" SecondEyeConfidence=\"\n3.68825888633728\" SecondEyeLocationX=\"607.244323730469\" SecondEyeLocationY=\"\n119.276374816895\">\n<Picture XmlReferenceId=\"14\" TimeStamp=\"2007-07-\n18T16:50:54.8770000-07:00\" _ ShortTimeStamp=\"7/18/2007 4:50:54 PM\" AspectRatioAdjustment=\"\n1.10000002384186\" NominalAspectRatio=\"2\" Width=\"704\" Height=\"240\" ImageWidth=\"704\" ImageHeight=\"\n240\" IsAnnotated=\"False\" FilePath=\"https://<3vr-server>:8080/images/18 _ 7 _ 2007/23/\neventtype _ 2/0/1/images1.22.MFA\" />\n</FaceFrame>\n</Frames>\n<Videos>\n<Video XmlReferenceId=\"15\" StartTime=\"2007-07-18T16:50:27.5800000-07:00\"\n_ ShortStartTime=\"7/18/2007 4:50:27 PM\" EndTime=\"2007-07-18T16:50:59.6110000-07:00\" _ Short-\nEndTime=\"7/18/2007 4:50:59 PM\" ChannelId=\"1\" PixelAspectRatioAdjustment=\"1.10000002384186\"\nPixelAspectRatioNominal=\"1\" Width=\"352\" Height=\"240\" VideoFormat=\"HikvisionH264\"\nFilePath=\"https://<3vr-server>:8080/videos/18 _ 7 _ 2007/23/videos/0/1/17.mpg\" />\n</Videos>\n</FaceEvent>\n</SpecializedEvent>\n<TriggeredAlerts />\n<MetadataElements />\n</Event>\n</Events>\n</EventCollectionExt>\n</ThreeVREventExport>\n</ThreeVRExport>","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Language Specific Libraries to Access the 3VR External Query API","type":"text"}]},{"type":"paragraph","content":[{"text":"3VR provides libraries and samples in various programming languages for easily using the 3VR Query API. You only need to supply a few essential elements to generate query XML. We also provide utility methods to execute the query using POST, return the XML including event details using GET, and parse the XML response.","type":"text"}]},{"type":"paragraph","content":[{"text":"Language-specific libraries are included (with source code) in the 3VR web services SDK. The 3VR External Query API currently has language support for client programs written in Java and Python. Support for additional languages will be added in the future. Of course, it is possible to directly access the query API from any programming language using XML/HTTP.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3VR External Query API Support for Java Programming","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":77.0},"content":[{"type":"media","attrs":{"width":688,"id":"04a91243-881c-4560-8d6c-4f16b3b8f30b","collection":"contentId-83787904","type":"file","height":381}}]},{"type":"paragraph","content":[{"text":"To use 3VR query Java API, add threeVRQuery.jar to your Java project library and import any necessary packages in your Java program.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"import com.threeVR.predicate.*","type":"text"}]},{"type":"paragraph","content":[{"text":"Now you will be able to use predicates to construct the query XML.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// Events that triggered Alert 'My Alert'\nPredicate pred = new LikeP(\"TriggeredAlerts.Alert.Name\", \"My Alert\");\nString queryxml = pred.ToXmlString();\n// Events that triggered alerts\nExistsPredicate existPred = new ExistsPredicate(\"TriggeredAlerts.Alert.Id\");\nqueryxml = existPred.ToXmlString();\n// Similarity Search\nAndP pred = new AndP(new Predicate[] {\nnew EqP(\"eventtype\", new Integer(2)), new GeP(\"starttime\", starttime),\nnew LeP(\"starttime\", endtime),\nnew SimilarityP(null, personids, 0.8f, starttime,endtime)\n});\nqueryXml = pred.ToXmlString();","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have generated the query xml, you can perform a POST operation to http://[IP or hostname]/rss to return an XML response which contains a summary of matching events. In the Java library we provide utility methods for performing the POST operation. Here's an example for using that method to easily obtain response XML:","type":"text"}]},{"type":"codeBlock","content":[{"text":"// POST queryXml to https://<3vr-server:port>\nString response = Utilities.query(queryXml, \"3vr-server\", port);","type":"text"}]},{"type":"paragraph","content":[{"text":"After obtaining response XML for the matching event summary, we can use any standard XML library to process it. Here is an example using JAXP. The Java API for XML Processing (JAXP) is a library that enables applications to parse and transform XML documents independent of a particular XML processing implementation. We can use JAXP6 to parse RSS formatted events summary response.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"//JAXP example\nDocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();\nDocumentBuilder parser = factory.newDocumentBuilder();\nDocument xmldoc = parser.parse(new InputSource(new StringReader(response)));\nNodeList items = xmldoc.getElementsByTagName(\"item\");\nfor (int i = 0; i < items.getLength(); i++) {\nNode item = items.item(i);\nNodeList children = item.getChildNodes();\nfor (int j = 0; j < children.getLength(); j++) {\nif (children.item(j).getNodeName().equals(\"link\")) {\nString link = children.item(j).getTextContent(); //proceed with link\n}\n}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"We also provide examples for processing the response XML by parsing text or using DOM. Examples can be found in Utilities.java.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// Parsing text\npublic static void processResultsSummary _ Text(String response){…}\n// DOM processing\npublic static void processResultsSummary _ DOM(String response){…}","type":"text"}]},{"type":"paragraph","content":[{"text":"After processing event summary XML, we can use the content of the <link> element to perform a GET operation and retrieve detail for events of interest. We provide a utility method in Utitlities.java for this purpose.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// use link to do GET and retrieve event detail XML\nString eventDetail = Utilities.getEvent(eventLink);","type":"text"}]},{"type":"paragraph","content":[{"text":"Similarly, after obtaining the event detail XML, it can be processed using any standard XML parser. Examples can be found in Utilities.java.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// using DOM\npublic static void processFirstEvent _ DOM(String response) {…}\n// using JAXP\npublic static void processFirstEvent _ JAXP(String response) {…}","type":"text"}]},{"type":"paragraph","content":[{"text":"Combine above examples to query for all motion events in a case named 'Fraud #1', print start time and end time, and image location of key frames:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"// Motion events in Case 'Fraud #1'\nAndP pred = new AndP(new Predicate[] {\nnew EqP(\"eventtype\", new Integer(1)),\nnew EqP(\"cases.name\", \"Fraud #1\")\n});\nString response = Utilities.query(pred.ToXmlString());\nArrayList links = Utilities.getAllEventLinks(response);\nfor (int i = 0; i < links.size(); i++) {\nString eventDetail = Utilities.getEvent(links.get(i).toString());\n//Parse event details string by DOM\nDocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();\nDocumentBuilder parser = factory.newDocumentBuilder();\nDocument xmldoc = parser.parse(new InputSource(new StringReader(eventDetail)));\nNodeList events = XPathAPI.selectNodeList(xmldoc, \"//Events/Event\");\nNode event = events.item(0);\nString starttime = event.getAttributes().getNamedItem(\"StartTime\").getTextContent();\nString endtime = event.getAttributes().getNamedItem(\"EndTime\").getTextContent();\nNodeList pictures = XPathAPI.selectNodeList(xmldoc, \"//Events/Event/SpecializedEvent/\nMotionEvent/MotionFrames/MotionFrame/Picture\");\nfor (int j=0; j<pictures.getLength(); j++) {\nNode picture = pictures.item(j);\nString filePath = picture.getAttributes().getNamedItem(\"FilePath\").getTextContent();\nSystem.out.println(\"Frame:\" + filePath);\n}\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The source code for this example is in the SDK in the file ","type":"text"},{"text":"Samples\\EventsInCase.java.","type":"text","marks":[{"type":"em"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"3VR External Query API Support for Python Programming","type":"text"}]},{"type":"paragraph","content":[{"text":"In the samples\\query\\python directory of your SDK, there is a Python module, ","type":"text"},{"text":"queryapi.py ","type":"text","marks":[{"type":"strong"}]},{"text":"which contains a variety of helper bindings for using the 3VR External Query API. The helpers are divided into two parts: helpers for building predicate XML and helpers for retrieving event XML from a 3VR server using a sequence of HTTP requests.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Building predicates with the Python helpers","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"queryapi.py","type":"text","marks":[{"type":"strong"}]},{"text":" module provides a set of classes that make it very easy and concise to define predicates. These classes can be used to generate the XML that will be sent to server in a POST request and execute the query. For example, the expression","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"p = andp(eqp('EventType', '1'), gep('StartTime', datetime.timedelta(minutes=20)))","type":"text"}]},{"type":"paragraph","content":[{"text":"creates a predicate which will find all motion events in the past 20 minutes. This example shows that predicate class names always end with the letter \"p\"; the three predicates used here are \"and,\" \"equals,\" and \"greater than or equals.\" Note that the last two are really specific types of comparison predicates.","type":"text"}]},{"type":"paragraph","content":[{"text":"Each predicate class supports the toXml() function which returns the XML to post for that predicate. In the above example, calling p.toXml() returns:","type":"text"}]},{"type":"codeBlock","content":[{"text":"<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<Predicate>\n<AndPredicate name=\"and\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"False\">\n<ComparisonPredicate name=\"=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"Fals\ne\">\n<FacetOperand reference=\"EventType\" />\n<Comparison operation=\"=\" />\n<ValueOperand type=\"System.Int\" value=\"1\" />\n</ComparisonPredicate>\n<ComparisonPredicate name=\">=\" isEnabled=\"True\" id=\"\" DistinctIndividualQueries=\"\nFalse\">\n<FacetOperand reference=\"StartTime\" />\n<Comparison operation=\">=\" />\n<RelativeValueOperand type=\"System.TimeSpan\" value=\"0:20:0\" />\n</ComparisonPredicate>\n</AndPredicate>\n</Predicate>","type":"text"}]},{"type":"paragraph","content":[{"text":"There are two types of predicate classes: those that contain other predicates (like and and or) and those that contain operands (like equals). In addition, there is a special predicate type which allows you to define searches to find face events with faces similar to given people, profiles or groups of people.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following table summarizes the available predicate classes and how they correspond to the XML predicate tags:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"width":355,"id":"fb0dbec6-76c4-4cf3-9bae-186df0c41277","collection":"contentId-83787904","type":"file","height":361}}]},{"type":"paragraph","content":[{"text":"Predicate classes that contain operands are smart when trying to interpret their operand arguments in ways that are reasonable, sparing the user the pain of defining the type of each operand. The interpretations are as follows:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"Argument Type","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[743.0]},"content":[{"type":"paragraph","content":[{"text":"Operand Type","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[743.0]},"content":[{"type":"paragraph","content":[{"text":"As the first argument, a FacetOperand with that name.","type":"text"}]},{"type":"paragraph","content":[{"text":"As the second argument, a ValueOperand of type “System.String” with that value.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"int","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[743.0]},"content":[{"type":"paragraph","content":[{"text":"A ValueOperand of type “System.Int32”","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"datetime, date, or time","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[743.0]},"content":[{"type":"paragraph","content":[{"text":"A valueOperand of type “System.DateTime”","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"timedelta","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[743.0]},"content":[{"type":"paragraph","content":[{"text":"A RelativeValueOperand that contains the delta specified with the type “System.TimeSpan”","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[482.0]},"content":[{"type":"paragraph","content":[{"text":"Any type with an iterator (such a list or tuple)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[743.0]},"content":[{"type":"paragraph","content":[{"text":"An ArrayValueOperand containing the elements.","type":"text"}]}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"datetime, date, time and timedelta are defined in the Python standard datetime module. See the Python Library Reference at ","type":"text"},{"text":"python.org","type":"text","marks":[{"type":"link","attrs":{"href":"http://docs.python.org/lib/lib.html"}}]},{"text":" for details.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Similarity searches can be created with the similarityp class. Similarity searches allow you to query for face events that include faces that are similar to other sets of faces. Usually, this predicate will be used by specifying either a person or group. Person ids can be viewed on the people panel in OpCenter. For example, the following query:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"p = similarityp(personids=[10], earliest=datetime.datetime(2007,6,15),\n\\ minSimilarity=0.7)","type":"text"}]},{"type":"paragraph","content":[{"text":"will retrieve all face events since June 15, 2007 that are 70% similar to person #10. It is possible to force an interpretation by wrapping the value in facet(), value(), arrayvalue(), or relativevalue() but this is not recommended. In general, all operand predicates should be specified as pred(facet, value).","type":"text"}]},{"type":"paragraph","content":[{"text":"Retrieving event XML using the Python helpers","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The process of executing a query has four parts:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Post the query using an HTTP POST command.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Parse the retrieved event list as RSS-formatted XML, and use HTTP GET commands to retrieve XML for each event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Process the retrieved events.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If appropriate, retrieve images and/or videos for the event by retrieving links included in the event XML from the server using","type":"text"},{"type":"hardBreak"},{"text":"HTTP GET requests.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"queryapi.py","type":"text","marks":[{"type":"strong"}]},{"text":" module supports this model using the Query class. The Query class performs all necessary HTTP processing and presents the user with a lazily-evaluated array of results. Each element of the results contains the XML for a single event. Because the array is lazily-evaluated, applications that may need to use only a subset of the results can use Query efficiently; only those results that are used are retrieved from the server.","type":"text"}]},{"type":"paragraph","content":[{"text":"The common idiom for using Query, like many other Python constructs, is to create an instance and then use iteration to process each of the elements as follows (where p is the predicate specified above):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"query = Query('<server-name>', p)\nfor eventString in query:","type":"text"}]},{"type":"paragraph","content":[{"text":"process event XML string","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The XML strings are usually processed with XML parsing tools from the Python library, although in simple cases regular expression matching could be used. The provided samples show parsing in the document-object model (DOM) using the xml.dom.minidom module and event-based (SAX) parsing using the xml.parsers.expat module. The appropriate mechanism depends on your application and preferred programming style. For small applications, minidom provides a convenient interface that does not require you to maintain any parsing state yourself. SAX-style parsing (expat-based parsers in particular) tends to be very high performance, and is, therefore, suitable for bulk processing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Query","type":"text","marks":[{"type":"em"}]},{"text":" class also supports the ","type":"text"},{"text":"len","type":"text","marks":[{"type":"em"}]},{"text":"() operation, array indexing and slicing so those methods are available if they are a preferable way to access the query results.","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Query","type":"text","marks":[{"type":"underline"},{"type":"em"}]},{"text":" class has a method called ","type":"text"},{"text":"getlink","type":"text","marks":[{"type":"em"}]},{"text":"() which takes a URL and returns that object retrieved from the server. This is used to retrieve images and videos from the server using the resource identification link embedded in the event XML.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Python sample applications","type":"text"}]},{"type":"paragraph","content":[{"text":"Included in the SDK are two sample applications which show how to use the ","type":"text"},{"text":"queryapi.py","type":"text","marks":[{"type":"strong"}]},{"text":" module to get real data. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The sample ","type":"text"},{"text":"alerts.py","type":"text","marks":[{"type":"strong"}]},{"text":" displays all events that generated alerts in the past day. For each event, the program prints the camera number, the event start time, and the name of the triggered alert to the standard output. This sample uses the mini DOM module to parse the events.","type":"text"}]},{"type":"paragraph","content":[{"text":"The sample ","type":"text"},{"text":"images","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"text":"py","type":"text","marks":[{"type":"strong"}]},{"text":" returns events that generated alerts in the last day and saves all the images from those events in the folder specified on the command line. This sample uses the expat SAX parser to process the events. It also demonstrates using the ","type":"text"},{"text":"getlink","type":"text","marks":[{"type":"em"}]},{"text":"() function to retrieve image data.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"3VR Live Query API","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The 3VR Live Query API allows users to receive a continuously updating stream of events matching a predicate. The 3VR Appliance will return events matching the predicate as long as a connection remains open between client and server.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Query Format","type":"text"}]},{"type":"paragraph","content":[{"text":"The format of the predicate for the 3VR Live Query API is identical to the 3VR External Query API. To perform the query, the client POSTs the predicate XML to the URL https://[IP address or host name]/live/ where the XML is passed as the URL encoded argument \"queryxml\".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Live Query Response","type":"text"}]},{"type":"paragraph","content":[{"text":"The response from the Live Query API will be a continuously updating series of events. Each event takes the form of <item> elements:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"<item>\n<title>8/7/2012 1:48:10 PM -07:00 - 8/7/2012 1:48:14 PM -07:00: Motion Event on Camera\nHallway East\nhttp://10.100.2.202:80/event/2413380\n\n $\"http:s//10.100.2.202:8080/image/s/2012$ ; $\"https://10.100.2.202:8080/image/s/2012$ ; $\"https://10.100.2.202:8080/image/s/2012$ ;\n1:49 PM\n\n\n8/7/2012 1:48:07 PM -07:00 - 8/7/2012 1:48:09 PM -07:00: Motion Event on Camera\nHallway East\nhttps://10.100.2.202:8080/event/2413379\n\n $\"http:s//10.100.2.202:8080/image/s/2012$ ; $\"https://10.100.2.202:8080/image/s/2012$ ; $\"https://10.100.2.202:8080/image/s/2012$ ;\n1:49 PM\n","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"The element here is identical to the child element in the Query API response.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Sample Python Code","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, we use the ","type":"text"},{"text":"queryapi.py","type":"text","marks":[{"type":"strong"}]},{"text":" module to obtain a live query feed of alerts with a given alert name.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"python"},"content":[{"text":"from queryapi import *\nimport urllib2\ndef yield _ url(url):\nfor line in urllib2.urlopen(url):\nif line is not \"\":\nyield line\ndef LiveQuery(hostname, query):\nRequest = urllib2.Request\npassword _ mgr = urllib2.HTTPPasswordMgrWithDefaultRealm()\nhandler = urllib2.HTTPBasicAuthHandler(password _ mgr)\nopener = urllib2.build _ opener(handler)\nurllib2.install _ opener(opener)\ntheurl = 'http://%s/live' % (hostname)\nm = re.match('(http://[^/]+)', theurl)\nrooturl = m.group(1)\npassword _ mgr.add _ password(None, rooturl, \"techrep\", \"3MeDeee\")\npostdata = query\nreq = Request(theurl, postdata, {})\nreturned _ xml = \"\"\nin _ event = False\nfor line in yield _ url(req):\nif line.startswith('

Browser not supported