What's new in the Security Center 5.10.0.0 SDK

Create dynamic custom privileges

You can now add and edit custom privileges dynamically through workspace SDK.

Note: Dynamic privileges are added through a new module component and are only accessible from Config Tool and Security Desk where the module is registered.

To work with custom privileges, the following atrributes have been added:

RegisterPrivileges (new List<PrivilegeRegistration>()) to add a dynamic custom privilege
UnRegisterPrivileges(new List<Guid>()) to remove a custom privilage

Known Issue:

Dynamic privileges can only be used from a workspace where it is registered. It cannot be used from an external SDK application or associated with custom entity descriptors.

Add custom actions

You can now add custom actions to the list of event-to-actions or hot actions through workspace SDK. Custom actions can also be added to manual actions, scheduled tasks, threat levels, and correlation rules.

To work with custom actions, the following notable classes have been added:

CustomActionTypeDescriptor to add to the System Configuration describing the new action.
CustomAction to add the custom action received by the action recipient.
CustomActionBuilder to add workspace component to the Config Tool and Security Desk module.

Limitations:

Custom actions cannot be used across federations.

Additional connection for doors

You can now add, update, or remove additional connections for doors through the SDK.

To work with additional connections, door entities have the following new attributes:

Guid AddConnection(Guid device, AccessPointType type)

void UpdateConnection(Guid accessPoint, Guid device)

void RemoveConnection(Guid accessPointGuid)

void RemoveConnectionByDevice(Guid deviceGuid)

List<Guid> GetConnections(AccessPointType type)

Connect tile layouts to areas

You can now add a tile layout to, or remove a tile layout from, an area through the SDK.

To connect tile layouts to areas, the following new attributes have been added:

void AddTileLayout(Guid tileLayoutGuid)

void RemoveTileLayout(Guid tileLayoutGuid)

Hardware inventory report query

You can now execute a Hardware inventory report query through the SDK.

To execute a Hardware inventory report, the following SDK features have been added:

New report type:
```
ReportQueryType.HardwareInventory
```
New HardwareInventoryQuery class with the following properties:
- Entities: a list of source entity Guids.
- SourceTypes: a list of HardwareUnitType entity types.
- QueryControllers: boolean representing whether or not to query controllers.
- QueryExpanders: boolean representing whether or not to query expanders.
- QueryLocksets: boolean representing whether to query locksets.
- QueryReaders: boolean representing whether to query readers.
New HardwareUnitType listing access control, ALPR, video, and intrusion detection entity types.

Create macros

You can now create and delete macros, set their source code, and set their default execution values through the SDK.

To work with macros, the following SDK features have been added:

New DLLs:

Genetec.Sdk.Scripting.Compiler.dll

Genetec.Sdk.Scripting.Interfaces.dll

Notable classes:
- IMacroCompiler to compile source code
- CodeBuilderFactory to create source code based on criteria.
- MacroParametersAttribute to enable parameters in macro source code
- ICompilationDetails as a result from the compiler

Notable properties:

Genetec.Sdk.Entities.Macro.SetSourceCode(string)

Genetec.Sdk.Entities.Macro.SetDefaultParameters(ReadOnlyMacroParameterCollection)

Limitations:

You are unable to add or remove custom SDK assemblies references through the SDK.

Retrieve archived visitor information

You can now retrieve archived visitor information in full detail through the SDK.

To work with archived visitor information, the following SDK features have been added:

New manager available in the SDK engine used to retrieve archived visitors
```
Engine.VisitorManager
```
New VisitorManager methods:
- GetArchivedVisitor to retrieve archived visitor using its original guid
- GetArchivedVisitorByCardholderId to retrieve archived visitor by its cardholder guid
- CreateVisitor to creates a visitor with the same details as an archived visitor
New columns added in the VisitorQuery to ensure the results of a visitor query contain all details of an archived visitor, including its state, and the results of an active visitor contain the visitor guid and state.