What's new in the Security Center 5.9.0.0 SDK - Security Center 5.9.2.0

Security Center SDK Release Notes 5.9.2.0

series
Security Center 5.9.2.0
revised_modified
2020-06-10
category_custom
Release notes
prodname_custom
Security Center unified platform > Security Center
vrm_version
5.9

The following capabilities are now available in the Security Center 5.9.0.0 SDK.

More access to attributes

Many attributes previously not accessible through the SDK are now accessible.
Network card information
You can now retrieve the IP address and MAC address of the network card selected on the server hosting a plugin role through the getter Role.CurrentNetworkBinding.
Threat level color
You can now get and set the color on the ThreatLevel entity through the SDK.
Manufacturer and model from LPR units
You can now retreive the properties Manufacturer and Model from the LprUnit entity through the SDK.

Copy configuration tool

You can now use the Copy configuration tool through the SDK.
What's added:
  • New enumeration type to hold all configurations that could possibly be copied.
    Enums.general.CopyConfigOption
  • New method to copy the configuration:
    EntityManager.CopyConfiguration
  • New events to subscribe to:
    EntityManager.CopyConfigProgress // to get the progress of the copy task
    EntityManager.CopyConfigFinished // to know when the copy config task is done
Limitations:
  • Federated entities cannot be the source entity or part of the destination entities.
  • The entity type of all the destination entities must be the same as the source entity.
  • Only ONE copy config task can be created at a time. If a second one is created while there is a pending one, an exception will be thrown.

Enrolling access control units

You can now enroll access control units through the SDK.
What's added:
  • New class to retrieve the Access Manager responsible for enrolling the units:
    Engine.AccessControlUnitManager
  • New method to enroll access control units:
    AccessControlUnitManager.EnrollAccessControlUnit(AddAccessControlUnitInfo accessControlUnitInfo, Guid accessManagerRole)
  • New class to create the object that represents the unit that needs to be enrolled:
    Genetec.Sdk.Entities.AccessControl.AddAccessControlUnitInfo

Custom entity filters for workspace SDK

As a user of the workspace SDK, you can now call the IDialogService to open an EntityBrowserDialog in Config Tool or Security Desk and filter on the descriptor of the custom entity.

What's added:
  • Getting the service from a workspace:
    var dialogService = Workspace.Services.Get<IDialogService>();
  • Specifying the entities you want to show in the browser:
    var entityTypeCollection = new EntityTypeCollection(new List<EntityType> 
    { 
        EntityType.Cardholder, 
        EntityType.Door 
    }); 
  • Adding custom entities. The guids you provide are in the CustomEntityTypeDescriptor.
    entityTypeCollection.CustomTypes.Add(m_customEntityDescriptorGuid);
  • Excluding entities:
    var excludedEntities = new List<Guid>();
  • Setting filter options:
    var allowSynchronizedEntities = true;
    var selectionMode = SelectionMode.Single;
  • Returning the selected entity:
    return dialogService.ShowEntityBrowserDialog(entityTypeCollection, excludedEntities, allowSynchronizedEntities, selectionMode).FirstOrDefault();

Custom entity creation using Web SDK

You can now create custom entities in Security Center using the Web SDK.

What's added:

  • Creating a new custom entity from CustomEntityType.Id:
    entity?q=entity=NewEntity(CustomEntity,{customEntityType.Id})
  • Getting a CustomEntityType by its ID:
    customEntityType/{customEntityType.Id}
  • Getting all the CustomEntityType:
    customEntityType/All

Limitations:

You cannot create CustomEntityType through the Web SDK. New custom entity types must be created from a macro or from an SDK application.

Receiving a given event type from all entities using Web SDK

You can now subscribe multiple entities for an EventType with a single call. Before, you had to call event(Guid, EventType) for every entity that required monitoring by the Web SDK. Now, you can call event(EntityType, EventType). The new call adds all entities of type EntityType to the receiving list of EventType. If an entity is added after this call, it is automatically added to the receiving list. Same for deletion. The deleted entity is automatically removed from the list.

New attributes:
Engine.RemoveFromEventFilter(EventType):void 
Engine.GetEventFilter():IList<EventType> 
Engine.AddToEventFilter(EventType):void
New Web SDK calls:
http://localhost:4590/WebSdk/events/subscribe?q=event(EntityType, EventType)  
http://localhost:4590/WebSdk/events/unsubscribe?q=event(EntityType, EventType)