Feenics Access Control

Connect your card readers to analyze "access granted" events from your Feenics Access Control cloud system.

Use Cases

Potential use cases include:

• Tracking building occupancy through badge swipes

Configuration

This connector requires the following credentials:

Credential	Description
Instance Name	Instance name assigned to your account from Feenics
Username	Your Feenics API username
Password	Your Feenics API password
Tenant	The Tenant name to utilize for Person's Company

Mapped Concepts

Connector Concept	Mapped Type
Place	Building, Floor, Space (Optional)
Thing	Access_Card_Reader
Point	Access_Activity_Status
People & Identities	Person, Company, Access_Credential, AccessCredentialIdentity

The Access_Activity_Status points utilize JSON for time series data formatting. Unlike many of the other connectors that return a float value, these you will need to query for json as the value. The Sample Code section shows how to make the query - the schema for the JSON object is as follows:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "$id": "https://schemas.mapped.com/mapped/1.0/core/Access_Activity_Status/complexValue.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Access_Activity_Status:ComplexValueSchema",
  "type": "object",
  "properties": {
    "result": {
      "type": "string",
      "enum": [
        "denied",
        "granted"
      ]
    },
    "requesterIdentity": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "AccessCardIdentifier",
            "EmailIdentity"
          ]
        },
        "value": {
          "type": "string"
        }
      }
    },
    "reason": {
      "type": "string"
    }
  }
}

Note: Any AccessCardIdentifier associated with a result has been anonymized.

Sample Code

The following example shows how to query for all Access_Activity_Status points in your org - note the value field, set to json. In the returned JSON object, you'll see "result granted" which indicates a successful badge swipe.

Request Response
Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
{
  points(filter: {exactType: {eq: "Access_Activity_Status"}}) {
    id
    name
    exactType
    series(latest: true) {
      timestamp
      value {
        json
      }
    }
  }
}