Security Center 5.13 SDK updates

Development Acceleration Program

ft:locale
en-US

As promised during the webinar, we are sharing the session recording link and answers to unanswered questions.

This webinar covered the following topics:

  • New customization options

  • Enhanced entity management

Security Center 5.13 SDK updates

Main Q&A from the 3 webinars

Q1: Have there been any updates to get a status of when a cardholder's property changes? For instance, email was updated, get notified?

A1: You can use the EntitiesInvalidated method to receive a notification when an update has been made to a cardholder's property. It is not possible to get in the event notification which property was updated.

Q2: Can User Names contain spaces?

A2: Yes, usernames can contain spaces.

Q3: Is there documentation on required SDK upgrade in conjunction with upgrade to Security Center?

A3: It is encouraged to always upgrade the SDK in conjunction with your instance of Security Center. The SDK is backwards compatible up to 3 versions of SC as well. You can also refer to the release notes associated to a new version of Security Center found on Genetec Tech Docs. These will provide you with insight as to what features have been added to SC. A link can be found here: Security Center Release Notes 5.13.0.0

Q4: Regarding the WEBSDK documentation is there anything regarding the creation of bookmarks?

A4: Yes, adding bookmarks is shown here in the documentation: Add a Camera Bookmark

Q5: Is a new production certificate required for any additional code changes? (checksum attached, for instance), or once we receive a production cert, are we able to update code as needed?

A5: You are able to use the same production certificate with any code changes that you make to your integration. However, if the changes that you are making are significantly different from your initial scope of work, we will ask you to reach out to DAP@genetec.com to notify of the changes that you plan to make. If your initial scope of the integration was regarding cameras, you can make the required code changes without notifying us. You do not need to have any changes made to the production certificate.

Q6: Is the user creation api transactional? I mean, is the action taken after "validating" the user or at each call to the builder it has "intermediary states"? I ask, because I need a csv dump of camera configs with GUIDs. Additional fields in the objects may be needed as more information is requested, just inquiring about the process.

A6: The validate method is used to check the requirements have been met before committing a change to the Security Center database. There are no intermediary states.

Q7: Is there a default in the case one of the params are not sent over? Or is there a way one can set a default?

A7: In regards to user entity creation, there will not be any default values set. You will be required to set the name/username and the password of the user entity. All other fields, if you do not set them, will remain blank

Q8: Have there been any updates to get a status of when a cardholder's properties change? For instance, email was updated, get notified?

A8: With the .NET SDK, you can subscribe to the EntitiesInvalidated event that will notify you when an entity has been changed/edited. This feature unfortunately is not available in the WebSDK as it requires a local cache to be created and compared to what is in the Security Center database.

Q9: A more general question about the sdk documentation - not specific to 5.13. There are several calls that have getters but no corresponding setters. For example, the door class has a call that gets the unlock schedules but no corresponding setter. The implication is that to set an unlock schedule, you add the new schedule to the set returned by the getter. It isn't clear however if adding a schedule to the collection does anything beyond adding to the collection, that is, it's not clear if adding a schedule to the collection propagates the schedule out to the door controller. Is that in fact what happens or does something else need to happen, and how does one read the documentation to figure that out?

A9: It can be assumed that in the event a property does not have a direct setter, that you will be unable to edit the property through the SDK. In some cases, there are dedicated methods available for changing a property. The ActionManager class provides a method to override unlock schedules. In terms of documentation, Genetec Developer will always be the best place to see what methods are available on a specific class.If you want to discuss this further, please reach out to DAP@genetec.com.

Q10: When in the roadmap can we expect the WebSDK q=ReturnFields to be available? (testing on a 5.13 system and isn't working)

A10: The tentative release is expected for SDK 5.13.3. We do not have a solidified date at the moment.

Q11: Is there a way one could default the parameters without macros, or would there be any plans to do so?

A11: At the moment, there are no plans to set default values for the entities. It will be best to define your own default values if needed within your implementation.

Need further technical assistance with our API & SDK packages?