Splan integration requires following components to be enabled on Customer’s environment
1.URL related HR REST API should be accessible by Splan
2.The URL is SSL enabled. Import the certificate into Splan server.
3.Create Workgroup, Access groups and Access levels applicable to visitors for provisioning.
|Field Name||Field Description|
|Provider Name||User should select the provider name to which the badge number sequence should be added|
|Location Name||User should select the location name from the drop down list available to which location the badge number sequence should be enabled and If user want it for all the location, user should select as "Global Settings", If it required for only one Location, then user can select one location from location drop down ex: "San Francisco"|
|Sequence Length Value||User should enter the value of the badge number length with how many digits the badge number is going to generate. Ex: 5 (If badge number is going to generate with 5 digits)|
|Sequence Start Value||This field is for entering the badge number starting value which will use as badge number generation EX: 50000 (If user enter as 50000, it will start generating badge numbers from range 50000 to Max value which user is setting in sequence max value field)|
|Sequence Next Value||This field is for enter the next badge number value which should start with from the sequence start value field Ex: 50001 (If user enter the start value as 50001 or 50010, the badge number generated from the next value entered with 50001, 50002, 50003 etc.)|
|Sequence Max Value||This field is for setting the maximum number value to stop where the badge number generation should stop from the sequence start value field. Ex: 65000 (If, user set the value as 65000, the badge numbers which are generating from 50000 will stop at 65000 and reset back to 50000 after reaching the limit of Maximum value which is set.)|
|Prefix Value||This field is used for adding some unique indication before the badge number generation and it will append the prefix value to the badge number and generate. Ex: VIS (If the value added as VIS or ABC or EMP, it will add the value set on this field before badge number like "VIS50001" and generate the badge numbers)|
|Postfix Value||This field is used for adding some unique indication After the badge number generation and it will append the postfix value to the badge number and generate. Ex: VIS (If the value added as VIS or ABC or EMP, it will add the value set on this field After badge number like "50001VIS" and generate the badge numbers)|
|Connection Name *||This field is used for giving the name for the connector to save||ABC-Si-Pass|
|Server URL *||Provider the Si-Pass server URL to which the Splan system should communicate||https://<URL>:8080/api/access/onguard/openaccess|
|User Name *||User should enter the user name created forSi-Pass server URL to authenticating||Splanuser|
|Password *||User should enter the password created for Si-Pass server URL to authenticating||******|
|Connector Date Format *||Date format for sending to Si-Pass server when visitor data is pushed with start time and end time|
|Version *||User should enter the Si-Pass server version on which it is running||1.0|
|Time Zone||This will help in configuring the time zone format in which the data should be sent toSi-Pass server from Splan||UTC|
|Client Certificate path *||User should be entering the certificate path were the Si-Pass certificate is installed|
Note: If the user is using Splan Cloud, Splan team will enter the path of the certificate.
|Segment URL||This field is for configuring the Segmentation URL to use for Si-Pass integration from Splan. Only the segments which are received from the URL will be available in Splan to configure for communicating|
|Access Level URL||This field is for configuring the access levels URL from which the access level can be fetched into Splan for configuring to provide an access to the visitors by security|
|Test Connection URL||This field is used for entering the Si-Pass server URL to make the test connection to make sure the connection is secure and successful||https://<URL>:8080/api/access/Si-Pass|
|Enable Agent||This field is for enabling the Agent to communicate with Splan Agent service which is installed on client Si-Pass server when client did not enabled the IP's||TRUE|
|Connector Agent||This connector agent value will be pre populated automatically one the request queue name is selected which is created by Splan|
|Agent Key||This connector agent value will be pre populated automatically one the request queue name is selected which is created by Splan|
|Request Queue Name||Request queue name can be selected from the drop down list which is select for this customer provider instance to use for Agent.|
|Provisioning Enabled||This field is the key field which will make sure to enable the integration to send request to Si-Pass server from Splan only if this value is True and the preference (External Access Control= Enabled)||TRUE|
|Segmentation Enabled||This field is to enable the segmentation to be configured in the Splan system to have using the badge numbers only with segmentation configured||TRUE|
|Generate System User ID All the time||This field is use to generate the new id all the time when ever there is an request sent o the access control system of the visitor record even though he is an returning visitor with same member id account||TRUE|
|Access Level Enabled||This if is use to get the access level from access control system to Splan system when user is trying to add the access level in Splan system to assign to the visitors while issueing the badge||TRUE|
|Apply To||This field is used for configuring the connector to which visitor action the integration should be made like for an example added to the example tab||Visitor, Temp Badge, Employee Visitor, Contractor etc.|
Splan connector provides dynamic configuration where Administrator can configure different API for each Visitor lifecycle operation. Splan Si-Pass connector provides default configuration, but admin can change based on organization requirements.
Visitor Action is a activity event like Registration, Check-In and Check-Out.
Connector Action is operation on OnGuard when visitor action happens, like when visitor check-in then system has to create User, create badge and assign access levels.
Connector Attribute is Splan module which will have API attribute mapping.
Sequence of operations for same visitor action.
|Visitor Action||Connector Action||Connector Attribute||Sequence||Status||Description|
|Check-In||Create User||Si-PassCreateUser||1||Active||Check-In action will create an user in the Si-Pass onguard with visitor information with the attributes configured under Si-Pass CreateUser attributes section: Ex: First Name, Last Name, Email|
|Check-In||Create Badge||Si-Pass CreateBadge||2||Active||Check-In action will create an Badge in the Si-Pass onguard after user is created as part of the sequence 1 with activation, deactivation date and time along with badge number provided to the visitor.|
|Check-In||Assign Roles||Si-Pass AssignRoles||3||Active||Check-in action will assign the access level which are assign to the visitor at the time of check by security guard and the same will be provisioned to Si-Pass onguard to the badge and the user which are created in sequence 1 and 2|
|Check-Out||Delete Badge||Si-Pass DeleteBadge||1||Active||Check-out action will remove the badge from Si-Pass onguard once visitor check-out from the Splan Visitor Management system by security guard or using self service kiosk|
|Check-Out||Delete User||Si-PassDeleteUser||2||Active||Check-Out action will remove the user completely from Si-Pass onguard system as soon as visitor checked-out of the visitor system.|
Connector attributes are used for attribute mapping between Splan and Si-Pass .
Splan visitor allows customer to leverage Si-Pass segmentation to provision visitors and employee badges into the correct segmentation. To complete the segmentation mapping, login to S as admin and setup and complete the following configuration.
Contact Splan Support:
If you run into any issues, please contact Splan Support at firstname.lastname@example.org.