Configurer les incidents Genetec Mission Control™ pour CCURE 9000 Access Control - Ce guide décrit les meilleures pratiques pour tirer parti des incidents Genetec Mission Control™ avec le module externe CCURE 9000 Access Control.

Configurer les événements de l'application Administration Station de CCURE 9000 Access Control

Comme toutes les activités des événements sont enregistrées dans Genetec Mission Control™, vous devez configurer les événements dans l'application Administration Station de CCURE 9000 Access Control pour éviter la duplication des données.

Avant de commencer

Vérifiez que vous avez accès à l'application Administration Station dans CCURE 9000 Access Control.

Procédure

Ouvrez l'application Administration Station dans CCURE 9000 Access Control.
Ouvrez un événement existant qui doit être configuré.
Cliquez sur le bouton Acquittement onglet.
Sélectionnez le Envoyer les changements d'état au Journal case à cocher.
(Facultatif) Sélectionnez Envoyer les changements d'état à l'application Monitoring Station si vous souhaitez enregistrer des événements dans le client CCURE 9000 Monitoring.

BONNE PRATIQUE : Dans la vue Général de la configuration de l'événement, définissez Délai d'activation min. sur la durée souhaitée, l'événement doit rester actif sur l'écran de l'application Administration Station.
Cliquez sur Enregistrer et fermer.

Lorsque vous avez terminé

Configurez les incidents en utilisant des événements Security Center natifs ou des événements personnalisés.

Options de configuration pour les incidents Mission Control

Option de configuration des incidents
(Recommandé) Utiliser les événements Security Center	Utiliser les événements en tant que déclencheurs d'incidents Ajouter des entités aux cartes Configurer et utiliser les champs personnalisés dans Mission Control Ajouter des documents de référence avec des informations personnalisées Synchroniser les entités CCURE 9000 Access Control manuellement
Utiliser les événements personnalisés et les XFEvents CCURE	Créer un événement personnalisé Configurer le module externe CCURE 9000 Access Control
Utiliser les événements personnalisés et les XFEvents CCURE	Macro de configuration CCURE pour l'événement personnalisé

Option de configuration des incidents : utiliser les événements Security Center

Exploitez les fonctionnalités de Genetec Mission Control™ pour que les opérateurs puissent surveiller les incidents uniquement dans Mission Control, y compris les incidents provenant du module externe CCURE 9000 Access Control.

Vous pouvez exploiter les fonctionnalités de Mission Control pour surveiller les incidents provenant du module externe CCURE en utilisant les événements Security Center en tant que déclencheurs d'incidents. Les événements Security Center natifs constituent l'option optimale pour les déclencheurs d'incidents Mission Control, car ils permettent de récupérer les événements de porte natifs des portes CCURE qui ont été synchronisées avec le module externe. Autres avantages notables :

Configuration simplifiée.
Utilisation de l’arborescence des entités dans Security Center.
Affichage des incidents déclenchés et des entités associées sur les cartes.
Réduction du nombre d’entités à surveiller par les opérateurs en éliminant les événements personnalisés XFEvents de CCURE.
Les incidents Mission Control fonctionnent plus efficacement lorsqu’ils sont intégrés à des événements plutôt qu’à des alarmes.

Utiliser les événements en tant que déclencheurs d'incidents

Vous pouvez utiliser un événement Security Center unique au lieu de plusieurs alarmes en tant que déclencheur d'incident.

Procédure

Dans la tâche Configuration d'incidents, sélectionnez votre incident, puis ouvrez l’onglet Déclencheurs.
Cliquez sur Ajouter un événement ().
La boîte de dialogue Règles qualifiant un événement apparaît.
Sélectionnez le type d’événement qui doit déclencher l’incident.
Cliquez sur Enregistrer.

Exemple

Déclencheur d'incident pour un événement Porte forcée :

Ajouter des entités aux cartes

Vous pouvez ajouter des entités associées aux déclencheurs d'incidents à une carte pour pouvoir visualiser les déclencheurs dans la tâche Surveillance d'incidents.

À savoir

Lorsqu'un déclencheur d'incident est basé sur un événement natif Security Center plutôt qu’un événement personnalisé XFEvent CCURE, il est synchronisé automatiquement entre le Répertoire et le serveur CCURE. Ces entités peuvent être associées à des secteurs ou des cartes selon vos besoins. Genetec Mission Control™ peut afficher les incidents sur une carte lorsque l’entité source ou l’emplacement de l’incident est configuré sur la carte à l’aide de la tâche Map designer.

Procédure

Sur la page d'accueil de Config Tool, ouvrez la tâche Map designer.
Ouvrez une carte existante ou créez-en une. Pour en savoir plus, voir Créer une carte.
Dans la section Entités, cliquez sur Vue secteur () pour ajouter des objets cartographiques.
Ajoutez les entités souhaitées sur votre carte, puis cliquez sur Enregistrer.

Résultats

Lorsque des incidents sont déclenchés sur les entités configurées, ils sont affichés sur la carte dans la tâche Surveillance d'incidents.

REMARQUE : Une fois que vous avez configuré le déclencheur d'incident avec des événements Security Center et que vous avez ajouté les entités voulues sur votre carte, les opérateurs ne verront pas l’entité XFEvent dans leurs tâches de surveillance,

Configurer et utiliser les champs personnalisés dans Mission Control

Vous pouvez utiliser les champs personnalisés pour configurer les incidents afin de fournir des informations complémentaires aux opérateurs lorsqu'ils répondent aux incidents.

Procédure

Créez un champ personnalisé ou configurez un champ personnalisé existant. Pour en savoir plus, voir Créer un champ personnalisé.
Allez dans la tâche Vue secteur, sélectionnez une entité, et ouvrez l’onglet Champs personnalisés.
Entrez la valeur souhaitée dans le champ personnalisé et cliquez sur Appliquer.
Allez dans la tâche Configuration d'incidents pour créer un incident et configurer son déclencheur. Pour en savoir plus, voir Configurer les déclencheurs d'incidents dans Mission Control.
Dans l’onglet Automatisation, configurez une activité conditionnelle pour l’incident à l’aide du champ personnalisé.

Exemple

Dans cet exemple, nous configurons un champ personnalisé applicable à toutes les entités porte, puis nous l'utilisons dans une activité conditionnelle pour déclencher un incident.

Créez un champ personnalisé intitulé Niveau de zone qui est affecté à tous les types d’entités porte.
Dans la tâche Vue secteur, sélectionnez l’entité porte et entrez 3 dans Niveau de zone dans l’onglet Champs personnalisés, puis cliquez sur Appliquer.

REMARQUE : Niveau de zone peut être affecté à la porte sélectionnée ou a toute autre entité de l’arborescence du secteur.
Dans la tâche Configuration d'incidents, créez un incident, allez dans son onglet Déclencheurs, puis créez un événement Porte forcée.
Allez dans l’onglet Automatisation pour ajouter l’activité conditionnelle, en utilisant le champ personnalisé pour changer le type d'incident lorsque Niveau de zone est égal à 3 pour l’entité déclenchée. Vous devez créer deux incidents supplémentaires pour cette configuration.

L'activité conditionnelle identifie ensuite le champ personnalisé et déclenche l'incident en conséquence.

Ajouter des documents de référence avec des informations personnalisées

En plus des champs personnalisés, vous pouvez fournir des informations complémentaires sur l'incident ou ses entités associées en ajoutant un document de référence à l’incident.

Procédure

Sur la page d'accueil de Config Tool, ouvrez la tâche Configuration d'incidents.
Dans la vue Gestion des documents, ajoutez votre document de référence. Pour en savoir plus, voir Ajouter des documents de référence à Mission Control.
Pour qu'un document apparaisse avec les incidents à l’emplacement sélectionné, configurez le champ Emplacement en conséquence.

Synchroniser les entités CCURE 9000 Access Control manuellement

Vous pouvez importer toutes les entités compatibles depuis le serveur CCURE 9000 Access Control dans Security Center via la synchronisation.

Avant de commencer

Si vous utilisez la synchronisation pour importer les entités pour la première fois, spécifiez les destinataires des alarmes, et sélectionnez une partition pour les alarmes et les événements. Pour en savoir plus, voir Configurer le comportement des alarmes.
Vérifiez que le module externe est connecté au serveur. Pour en savoir plus, voir Se connecter au système CCURE 9000.

À savoir

Une synchronisation manuelle est nécessaire lors de la première connexion au CCURE 9000 Access Control. Pour une description de la synchronisation manuelle, voir Fonctionnement de la synchronisation avec CCURE 9000 sur TechDoc Hub.

Procédure

Sur la page d'accueil de Config Tool, ouvrez la tâche Modules externes.
Sélectionnez le module externe CCURE 9000 Access Control dans le navigateur d’entités, puis cliquez sur l'onglet Synchronisation.
Développez la section Options de synchronisation et cliquez sur Ajouter les entités synchronisées aux partitions () sous la liste Partitions des entités.

Une liste des partitions Security Center disponibles apparaît dans une nouvelle fenêtre.
Sélectionnez une partition Security Center et cliquez sur OK.

Toutes les entités CCURE 9000 Access Control synchronisées, à l’exception des XFEvent, seront ajoutées aux partitions Security Center affichées dans la section Partition de l’entité. Vous pouvez affecter les XFEvent aux partitions sur la page Alarmes et événements. Pour en savoir plus, voir À propos des partitions.
Développez la section Détails de la synchronisation, puis cliquez sur le bouton Synchronisation manuelle.
Dans la boîte de dialogue Synchronisation manuelle, sélectionnez les entités que vous souhaitez synchroniser.
IMPORTANT : Lors de la synchronisation initiale, il est recommandé de synchroniser un seul type d’entité à la fois.
Partitions
- Désactivez le filtre Partitions pour synchroniser toutes les partitions CCURE 9000 Access Control. Ce sont les paramètres par défaut.
- Activez le filtre Partitions, et sélectionnez les partitions CCURE 9000 Access Control spécifiques à synchroniser. Avertissement : Si vous activez le filtre sans sélectionner une partition CCURE 9000 Access Control, rien n’est importé.
manquants

Activez l'option Événements pour récupérer tous les XFEvent existants. Tous les XFEvent sont affichés sur la page Alarmes et événements du rôle module externe CCURE 9000 Access Control. Remarque : Les événements XFEvent ne sont pas ajoutés à la partition Security Center sélectionnée dans les options de synchronisation ci-dessus.

Matériel, secteurs et zones
- Activez l’option Matériel, secteurs et zones pour récupérer tous les tableaux, lecteurs, portes, secteurs et zones depuis le logiciel CCURE 9000 Access Control.
- Activez l’option Entrées pour récupérer toutes les entrées disponibles sur les tableaux CCURE 9000 Access Control.
- Activez l’option Sorties pour récupérer toutes les sorties disponibles sur les tableaux CCURE 9000 Access Control.
Personnel
- Activez Personnel pour synchroniser le personnel CCURE 9000 Access Control en tant que titulaires de cartes Security Center. Les données de base du personnel, comme le nom et le prénom, sont importées. Pour la liste complète des données importées, voir Propriétés de titulaires de cartes synchronisées avec CCURE 9000.
- Activez l'option Désactivé pour récupérer les membres du personnel qui sont désactivés au sein du système.
- Activez l’option Photos pour obtenir les dernières photos des membres du personnel. Choisissez l'image entière ou les vignettes.
- Activez l’option Étiquettes client pour récupérer les champs personnalisés des membres du personnel.
- Activez l’option Champs définis par l'utilisateur pour récupérer les champs créés pour les membres du personnel.
Journal

Pour récupérer les journaux des événements CCURE 9000 Access Control lorsque le module externe se reconnecte au système , activez l'option Synchroniser automatiquement à la connexion, puis spécifiez le nombre de jours de données à récupérer. Ces événements sont stockés dans la base de données du module externe et peuvent être consultés à l'aide des tâches de rapport dans Security Desk. Ils comprennent les XFEvents configurés pour les événements personnalisés dans Security Center. Les événements qui surviennent pendant le délai de grâce hors ligne sont déclenchés et stockés dans la base de données du module externe. Pour en savoir plus, voir Configurer le délai de grâce hors ligne pour les alarmes et les événements.
Cliquez sur OK, puis sur Appliquer.
Pour voir la progression de la synchronisation, cliquez sur en regard de l’État de la synchronisation.
Si la table est vide après la synchronisation, cliquez sur le bouton Actualiser () pour la mettre à jour.

Résultats

Lorsque la synchronisation est terminée :

S’il s'agit de la première synchronisation, le rôle de module externe CCURE 9000 Access Control passe du jaune au gris lorsqu'il se connecte au serveur CCURE 9000.
Tous les XFEvent sont affichés sur la page Alarmes et événements du rôle module externe CCURE 9000 Access Control. Les XFEvent qui nécessitent un acquittement sont affichés en tant qu’alarmes, tandis que les autres sont affichés en tant qu’événements personnalisés.
Les entrées et sorties de tableaux sont affichées sous le rôle de module externe CCURE 9000 Access Control dans l’arborescence des entités et dans la tâche Vue secteur.

Option de configuration des incidents : utiliser les événements personnalisés et les XFEvents CCURE

Vous pouvez utiliser Genetec Mission Control™ pour gérer les incidents tout en gérant des processus sur le serveur CCURE et le poste d’observation.

À savoir

Cette méthode utilise des événements personnalisés et des XFEvents pour simplifier la configuration du déclencheur d'incident. Les événements personnalisés configurés avec un incident peuvent être déclenchés par des alarmes et des événements.

REMARQUE : N’utilisez cette option que si les événements qui déclenchent un incident ne sont pas des événements Security Center natifs. Par exemple, des événements provenant des portes munies de barres de sécurité.

Créer un événement personnalisé

Vous pouvez créer vos propres événements Security Center personnalisés pour les associations événement-action.

À savoir

Les événements personnalisés permettent de donner un nom descriptif aux événements standard déclenchés par les signaux en entrée des zones, tableaux d'intrusion, etc. Ils servent à configurer des associations événement-action personnalisées.

Par exemple, vous pouvez associer un état d'entrée (normal, actif, problème) d'une entité zone à un événement personnalisé qui décrit ce qui se passe, comme Passage non autorisé ou Porte entrebâillée trop longtemps pour cette zone. Lorsque cet événement personnalisé est reçu dans Security Desk, il peut déclencher une action en exploitant le mécanisme événement-action.

Procédure

Ouvrez la tâche Système, sélectionnez la vue Paramètres généraux, puis accédez à la page Événements.
Cliquez sur Ajouter un élément ().
Dans la boîte de dialogue Créer un événement personnalisé, donnez un Nom au nouvel événement.
Dans la liste Type d'entité, sélectionnez le type d'entité qui déclenche cet événement.
Dans le champ Valeur, tapez un numéro unique pour distinguer l'événement personnalisé des autres événements personnalisés.
Ces valeurs n'ont pas de rapport avec l'ID logique des entités.
Cliquez sur Enregistrer > Appliquer.

Configurer le module externe CCURE 9000 Access Control

Vous pouvez utiliser les macros pour réaffecter les alarmes et événements Security Center au module externe CCURE.

Procédure

Sur la page d'accueil de Config Tool, ouvrez la tâche Système, puis cliquez sur la vue Macros.
Cliquez sur Macro (), et entrez le nom de la macro.
Cliquez sur l’onglet Propriétés, remplacez le code par défaut avec le Macro de configuration CCURE pour les événements personnalisés et cliquez sur Appliquer.
Allez dans l’onglet Contexte d'exécution par défaut, et entrez les valeurs souhaitées dans les champs suivants :

CCURERole

Entité du rôle module externe CCURE Access Control.

LogRecipient

Utilisateurs qui reçoivent les messages de la macro.

AreaPrefix

Noms des secteurs aux événements réaffectés, séparés par un point-virgule.

EventSuffix

Nom du dernier événement du XFEvent. Exemple : _FORCED ALARM.

CustomEventNo

Le numéro de l’événement personnalisé auquel le XFEvent est affecté.

ShouldEventsTriggerAlarms

Activez cette option si vous souhaitez que les événements réaffectés déclenchent une alarme. Vous pouvez modifier cette option manuellement pour chaque événement.

Résultats

Après l’application de la macro, les déclencheurs d'incidents peuvent être configurés à l’aide de l’événement personnalisé qui réaffecte au module externe CCURE dans Security Center.

Exemple : configurer un incident avec un événement personnalisé

Vous pouvez réaffecter tous les événements associés à une entité en configurant des événements personnalisés et des macros dans le module externe CCURE 9000 Access Control.

Procédure

Créez un événement personnalisé pour le type d'entité porte sélectionné.
Réaffectez tous les événements Porte forcée en configurant la macro.
Dans l’onglet Contexte d'exécution par défaut de la page Macros, configurez les informations suivantes :

CCURERole

CCCURE 9000 Access Control.

LogRecipient

Administrateurs.

AreaPrefix

First;Second.

EventSuffix

_FORCED ALARM.

CustomEventNo

Le numéro de l’événement personnalisé auxquels les XFEvent sont affectés.

ShouldEventsTriggerAlarms

Activez cette option si vous souhaitez que les événements réaffectés déclenchent une alarme. Vous pouvez modifier cette option manuellement pour chaque événement.

Lorsque vous exécutez la macro, tous les événements Porte forcée dans les secteurs configurés sont réaffectés à l'événement MC_CCURE_DOOR_FORCED_OPEN_EVENT. Vous pouvez afficher les événements réaffectés sur la page Alarmes et événements du rôle CCURE 9000 Access Control.
Dans la tâche Configuration d'incidents, configurez un incident avec l’événement personnalisé Porte forcée.

Résultats

Votre déclencheur d'incident est à présent configuré avec l’événement personnalisé, et l'incident peut désormais être surveillé dans Genetec Mission Control™ et dans le poste d’observation CCURE.

Macro de configuration CCURE pour les événements personnalisés

Les macros sont des entités servant à ajouter des fonctionnalités personnalisées à Security Center, par exemple pour affecter des événements personnalisés CCURE 9000 Access Control à des associations événement-action Security Center.

Code

using Genetec.Sdk;
using Genetec.Sdk.Entities;
using Genetec.Sdk.Enumerations;
using Genetec.Sdk.Queries;
using Genetec.Sdk.Scripting;
using Genetec.Sdk.Scripting.Interfaces.Attributes;
using Genetec.Plugins.CCure.Requests;
using Genetec.Sdk.Entities.CustomEvents;
using System;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Runtime.Serialization;
using System.Xml;

[MacroParameters()]
public sealed class myMacro : UserMacro
{
	public Guid CCURERole { get; set; }
	public Guid LogRecipient { get; set; }
	public string AreaPrefix { get; set; }
	public string EventSuffix { get; set; }
	public int CustomEventNo { get; set; }
	public bool ShouldEventsTriggerAlarm { get; set; }
	/// <summary>
	/// Entry point of the macro. Provide an implementation of this method.
	/// </summary>
	public override void Execute()
	{

		var systemConfig = Sdk.GetEntity(SdkGuids.SystemConfiguration) as SystemConfiguration;
		var customEventService = systemConfig.CustomEventService;
		var customEvents = customEventService.CustomEvents;
		var filteredCustomEvents = new List<CustomEvent>();

		var areasPrefixes = AreaPrefix.Split(';');

		foreach (var customEvent in customEvents)
		{
			if (areasPrefixes.Any(a => customEvent.Name.Contains(a)) && customEvent.Name.Contains(EventSuffix))
				filteredCustomEvents.Add(customEvent);
		}

		//Sdk.ActionManager.SendMessage(LogRecipient, string.Join(",", filteredCustomEvents.Select(e => e.Name)), 60);

		// Replace with your CCure role Guid

		var getRequest = Sdk.RequestManager.SendRequest<EventConfigurationsRequest, EventConfigurationsResponse>(CCURERole, new EventConfigurationsRequest());
		var config = getRequest.EventConfigurations;

		foreach (var xfConfig in config)
		{
			if (filteredCustomEvents.Select(e => e.Id).Contains(xfConfig.CustomEventId))
			{
				xfConfig.CustomEventId = CustomEventNo;
				xfConfig.HiddenFromUI = false;
				xfConfig.RaiseEvent = true;
				xfConfig.TriggerAlarm = ShouldEventsTriggerAlarm;
			}
		}

		Sdk.RequestManager.SendRequest<SaveEventConfigRequest, VoidResponse>(CCURERole, new SaveEventConfigRequest(config));
	}

	/// <summary>
	/// Called when the macro needs to clean up. 
	/// </summary>
	protected override void CleanUp()
	{
		// Release objects created by the Execute method, unhook events, and so on.
	}
}

namespace Genetec.Plugins.CCure.Requests
{
	// Request to Get the configuration
	[DataContract(Namespace = "")]
	internal class EventConfigurationsRequest
	{ }

	// Response of the Get Request
	[DataContract(Namespace = "")]
	internal class EventConfigurationsResponse
	{
		[DataMember]
		public List<XfEventConfiguration> EventConfigurations { get; private set; }

		public EventConfigurationsResponse(List<XfEventConfiguration> eventConfigurations)
		{
			EventConfigurations = eventConfigurations;
		}
	}

	// Request to save configuration
	[DataContract(Namespace = "")]
	internal class SaveEventConfigRequest
	{
		[DataMember]
		public List<XfEventConfiguration> Configurations { get; private set; }

		public SaveEventConfigRequest(List<XfEventConfiguration> configurations)
		{
			Configurations = configurations;
		}
	}

	[DataContract(Namespace = "")]
	public class VoidResponse
	{
		public static readonly VoidResponse Instance = new VoidResponse();

		private VoidResponse()
		{ }
	}

	// Configuration, meaning mapping between XfEvents and CustomEvents
	[DataContract(Namespace = "")]
	public class XfEventConfiguration
	{
		[DataMember]
		public Guid AlarmId { get; set; }

		[DataMember]
		public int CustomEventId { get; set; }

		[DataMember]
		public bool HiddenFromUI { get; set; }

		[DataMember]
		public string Name { get; set; }

		[DataMember]
		public bool RaiseEvent { get; set; }

		[DataMember]
		public bool RequireAck { get; set; }

		[DataMember]
		public bool TriggerAlarm { get; set; }

		[DataMember]
		public Guid XfEventCustomEntityId { get; set; }

		[DataMember]
		public List<string> Tags { get; set; }

		public XfEventConfiguration() { }
	}
}