Integrating with OPS-COM

Integrating with OPS-COM

Considerations for Scoping an Integration 

Regardless of the integration we are scoping we need the following questions answered.

  1. What are the endpoints; where will we connect and send data? 
    1. What system or URL are we querying?
    2. Test system logins and a test endpoint address to which we can send queries to.
      1. we will need the same for production systems  
  2. Are there additional (special) API endpoints and/or API tokens to access the system? 
  3. What API/SDK is recommended?
    1. at the core the OPS-COM platform is built on PHP; we also work with Java and many other languages
  4. Supporting documentation for the API/SDKs that we are integrating with
    1. technical contact(s); either on location and/or for the vendor.
  5. How will the data (or user) flow through the system?  ie. business logic/flow

For Network Administrators

Our development servers are behind:  

Our production servers are behind:  

Information Flow through OPS-COM

This example shows the flow of information through the integrated system of record and OPS-COM.

image.png

Sample: SSO Integration

This example shows the flow of a user through the system, and at what points the client wanted us to apply business logic.  

Notice that in their implementation they also described the flag that would be used to designate special users in the system.

image.png

Sample: LDAP/Active Directory Integration

This represents a standard flow of information to support LDAP/AD user validation.

image.png

Current APIs Available

OperationsCommander (OPS-COM) has made APIs (Application Programming Interface) available that allow for third-parties with proper authentication to interact and manipulate data in OPS-COM as needed to accomplish specific functions, for example adding valid permits from pay and display machines.

Other Integrations Available

OPS-COM has integrations with third-parties. Your Sales Rep can discuss how you can make use of these integrations. 

MacKay Meters - Permit Push/Export Integration

OPS-COM supports exporting temp, standard, and validation permits purchased in OPS-COM to MacKay Meters.

There are a few system and lot configurations to setup before this works with you Mackay Meters system. The article assumes you already have a MacKay Meters environment and logins details (username & password), if you don't please contact your MacKay Meters representative to obtain them and let us (OPS-COM) know if you have any questions or concerns  about this integration.

Tools → View System Task Logs:

image.png

image.png

You may not see this system task and currently only OPS-COM staff can enable it. Please contact us if you require this setup. This system task is used to check OPS-COM permits for any that need to be pushed/exported to MacKay Meters.

System Configuration/Settings:

System Configuration → System Settings → Third Party:

As mentioned above you should have some sort of MacKay meters login details. This is where you set them:

*Note: There are test and none-test (production/live) fields. Depending on the domain you're using to run your tests OPS-COM will either use the username and password fields for production, and test username and test password for preview/testing.

Preview/test domains look like this:
something.preview.ops-com.com
something-test.preview.ops-com.com

Production domains look like this:
something.ops-com.com


image.png

System Configuration → Parking → Mange Lot Zones:

Zone names needs to be exactly what is set in MacKay Meters, if you don't know what the zone name should be please ask MacKay Meters or OPS-COM.

image.png

Parking Management → Lot Administration → Pricing & Lot Admin:

Click into the lot you wish to add to the MacKay Meters zone (s), which in this example is "MacKay-Meters" in this example, then go under the "Zone & Location" tab and set the zone:

image.png

Parking Logix - Parking Sensor Integration

Enable Parking Logix Integration

Before you can use the Parking Logix integration on your system you will need to navigate to your Third Party settings under System Settings.

From there you should see the option to enable Parking Logix Integration

image.png

Adding the Lot Group

Next, add a new lot group to your system making sure you include the API code. It is possible but unlikely that there will be multiple API keys if lot access is split over several keys. 

Create a specific group for each lot you will be collecting data from.

It's important to note that you will also need to enter the Parking Logix specific name for the lot and it must match exactly.

For example, in the image below, the Parking Logix name is Mountaineer Garage


image.png

Once the Lot Group has been configured you would need to assign it to the lot on the LPR Settings Tab of the Lot Administration tool.

image.png

Enable the System Task

A system task must be enabled for the Parking Logix sensors to communicate with our system.

This must be enabled by OPS-COM integration staff and you can contact us through support to set this up. Please email support@ops-com.com for assistance.

Once the system task has been run you should see updated on the lot counts under Manage Parking Lot Groups

image.png


Displaying the Map on the User Side

Finally, enter the short code on the user side to any of your pages using System Messaging.

For more information on how system messaging works please see: https://wiki.ops-com.com/x/M4QCAw followed by Editing Pages

The short code is [parking_logix] and you can pass addition parameters such as: only, show, filter, or name.  This will restrict the list to show only specific lots.

image.png

By design, it will only show lots that have a group assigned to it that have an API key stored in it.

image.png


Mistall - Setup & Functionality

Overview

Mistall is a service that is used to count cars in a physical lot, using cameras to track vehicles as they enter and exit the lot.

Within the OPS-COM system, each Mistall lot is associated to a Lot Group.

Mistall Credentials

Mistall credentials need to be entered in system settings under third-party settings to be able to use the API.

Credentials are provided to the the client by Mistall itself.

1_a2b75cde-54a7-40cb-bb96-6017e67b8f27.png

Lot Groups

The Lot Groups page was updated to accommodate the use of Mistall.

In addition, Lot Groups have replaced the use of Lots on the Real-Time map on both the admin and user sides.

To have data populate the Mistall Lot ID dropdown, the Update Mistall System Job Task must be run at least once to import the data into the system.

Columns have been added for setup with the Real-Time Map and Mistall data.



2_b9bfb86f-8e4e-4e2b-b22c-4af7f95ddb47.png 3_e390bd38-8778-40de-83da-82d93e374d99.png
Lot Group page updates. The updated lot group edit pop-up.

Lot Edit

On the lot edit page, the selection to set the lot group of the lot has been moved from the LPR section to the general section.

This is to allow clients who are not using the LPR system to still use the real-time map features.

4_321d60f9-4185-41c2-bdc7-210377903852.png
Lot edit page.

Dashboard Widget

The imported Mistall data can be displayed on the dashboard in a widget.

The widget is named mistall-lot-stats.

If the system setting for Enable Mistall Usage is not enabled, this widget will not appear in the edit dashboard page.

The widget shows the raw Mistall data. The names of the lot groups associated to the data will be shown beside the bar chart.

If the Mistall data is not yet associated to a lot group, it will show the Mistall lot name instead. This is the name given to the lot by Mistall.


5_8c58357e-0936-4dcf-aa81-d5f454957d0d.png
Mistall dashboard widget.

Real-Time Maps

The admin and user-side real-time maps have been updated to use lot groups in additional to the individual lots as pins on the map.

The functionality of the maps is not dependant on the use of Mistall in a system.

If your system doesn’t have the Mistall integration enabled, the lot groups will use the data of the associated lots in place of Mistall data for the real-time maps.

Admin-Side Map

The admin map has been updated to use lot groups.

When a lot group is clicked on, it will show the new popup.

The donut menu at the top shows the Mistall lot data, and the lot info shows the individual lot data. The bar charts below show the same lot info as above.

If the lot group has no Mistall data associated to it, it will use the collated counts of the lot info below instead.

If Mistall data is being used for the lot, it is likely it will not match the counts shown in the lot info window below. It is intentional that the information will not match.

The intention is that the client will be able to see the difference between what is physically present in the physical lot (lot group Mistall stats) and what the permits purchased within the system look like in comparison.

For example, if the lot is physically empty but is maxed out on purchased permits, the number of available permits can be increased for that lot.


6_3df4add1-3520-4dd6-89b2-5e4b200b2121.png
Admin-Side map.

User-Side Map

The user-side map has also been updated to use lot groups.

As before, the user map is made to appear by placing the shortcode on a client-created page.

The shortcode for the map is: [real-time-map]

The user-side map will now appear like this:

7_237b667b-3f62-4b59-a5c5-b71611899abd.png
User-side real time map.

The donut at the top shows the Mistall data if it is present. If the lot group does not have an associated Mistall lot, it will show the collated counts of the lot info below.

The lot info shown below the donut graph is from the permit counts in the system.

Unlike the admin-side map, the information here is presented as a percentage instead of the actual numbers. This is to allow for some leeway for any inaccuracy.

The icons to the right display if the lot allows standard or temporary permits.

The map should be accessible for users who are not logged in. If the user is logged in, they will be able to see standard permits and temp permits, but if they are not logged in, they will only be able to see temp permits.

The book permit button now takes the user to a new page used for selecting a permit from within the selected lot group.

User-Side Lot Group Page

The lot group page shows much the same data as the regular permit page, just with the data specific to the selected lot group.


8_9a0ff1dd-6a83-4887-ab97-fa26c005c6e8.png
Lot group page.

At the top of the page, the same donut menu from the pop-up window on the map is shown, displaying a percentage of availability. It is calculated from the Mistall data or the lots below if there is no Mistall data for the lot group.

The lots are shown below. If the user is a guest (not logged in), they will only be able to see temporary permits on the page.

The standard permit booking button will take the user to the regular standard permit booking page, but the temporary permit booking button will take the user to the quick checkout.

This is the checkout used for QR codes and the old version of the map. It allows the user to purchase the permit and checkout immediately without adding it to their cart.