À propos du modèle XML Hit export dans Genetec Patroller™ - Genetec Patroller™ 6.6

Guide de l’administrateur Genetec Patroller™ 6.6

Product
Genetec Patroller™
Content type
Guides
Guides > Guides d'administration
Version
6.6
Language
Français (France)
Last updated
2022-04-22

Le module externe Hit export peut être configuré pour créer un fichier XML lorsque l'utilisateur accepte ou applique une alerte dans Genetec Patroller™. Cette section permet de voir un exemple du modèle XML par défaut, d'apprendre la signification des champs du modèle et de voir un exemple du ficher de sortie final.

Ce que vous devez savoir

  • Quand certianes données d'une alerte ne sont pas disponibles, le champ information est remplacé par une chaîne de caractères vide dans le fichier de sortie. Par exemple, sur une alerte régulière (pas de dépassement de plage horaire), tous les champs de dépassement de plage horaire sont enlevés et aucune valeur n'est générée pour ces champs.
  • Les formats de dates et de temps peuvent être ajoutés entre des accolades ({}) dans les champs de temps suivants:
    • TimeStamp
    • TimeStampUTC
    • OvertimeTimeStamp
    • OvertimeTimeStampUTC

    Par exemple, si vous voulez que le champ TimeStamp génère la date sous le format (mois, jour, année) et sous un format de temps de 24 heure, vous devez entrer la chaîne suivante: %TimeStamp%{MM/dd/yyyy HH:mm:ss}. Pour en savoir plus sur les formats de temps pris en charges, cliquez ici.

Exemple de modèle XML pour le module Hit export

Voici un exemple du fichier HitExportTemplate.XML par défaut situé dans :

C:\Program Files (x86)\Genetec AutoVu 6.6\MobileClient\TemplateFiles.

IMPORTANT : Le modèle par défaut fournit un exemple des balises disponibles et peut changer sans préavis. Ne l’utilisez pas en l’état. Créez plutôt votre propre modèle en renommant ou copiant le fichier par défaut.
<?xml version="1.0" encoding="utf-8" ?>
<!-- 
      !!!!!!!!!!!!!!!!!!!!!!!!!!!! IMPORTANT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
      This file is a sample of the available tags that you can use when creating a 
      template. Do not create a dependency on this file for it is subject to change.
      
      Instead, you must create a copy of this sample and use it for your own purposes.
      !!!!!!!!!!!!!!!!!!!!!!!!!!!! IMPORTANT !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  -->  
 
<Enforce>

  <!--
    *************************************************************************
    NEWER
    The following section describe how to exploit the XML export to access
    the read Analytics fields using the generic #Analytics()# token.
    It can be used to access any Analytics field given its name.
    *************************************************************************
  -->
  <GeometricDop>#Analytics(GeometricDop)#</GeometricDop>
  <PositionDop>#Analytics(PositionDop)#</PositionDop>
  <TimeDop>#Analytics(TimeDop)#</TimeDop>
  <HorizontalDop>#Analytics(HorizontalDop)#</HorizontalDop>
  <VerticalDop>#Analytics(VerticalDop)#</VerticalDop>
  <EastingDop>#Analytics(EastingDop)#</EastingDop>
  <NorthingDop>#Analytics(NorthingDop)#</NorthingDop>
  <Speed>#Analytics(Speed)#</Speed>
  <ConfidenceScore>#Analytics(Confidence Score)#</ConfidenceScore>
  <ReadWithDash>#Analytics(ReadWithSeparators)#</ReadWithDash>
  
  <ActualPlate>#ActualPlate#</ActualPlate>
  
  <!--   
    *************************************************************************
    NEW
    
    The following section describes the supported tags using the new format.
    
    *************************************************************************
  -->
  <IsPlateExpired>#ISPLATEEXPIRED#</IsPlateExpired>
  <IsPayZone>#ISPAYZONE#</IsPayZone>
  <PlateStatus>#PLATESTATUS#</PlateStatus>

  <HitId>#HIT_ID#</HitId>
  <HitType>#HIT_TYPE#</HitType>

  <ReadId>#READ_ID#</ReadId>
  <PlateRead>#PLATE_READ#</PlateRead>
  <PlateState>#PLATE_STATE#</PlateState>
  <ReadType>#READTYPE#</ReadType>
  <PermitName>#PERMIT_NAME#</PermitName>
  <RuleId>#RULE_ID#</RuleId>
  <RuleName>#RULE_NAME#</RuleName>
  <UnitName>#UNIT_NAME#</UnitName>
  <UnitId>#UNIT_ID#</UnitId>
  <UserName>#USER_NAME#</UserName>
  <UserLogin>#USER_LOGIN#</UserLogin>
  <UserId>#USERId#</UserId>
  <PermitId>#PERMIT_ID#</PermitId>
  <ParkingPermitId>#PARKING_PERMIT_ID#</ParkingPermitId>
  <Longitude>#LONGITUDE#</Longitude>
  <Latitude>#LATITUDE#</Latitude>
  <LprImagePath>#PLATE_IMAGE#</LprImagePath>
  <ContextImagePath>#CONTEXT_IMAGE#</ContextImagePath>
  <TireImagePath>#TIRE_IMAGE#</TireImagePath>
  <TimeStamp>#DATE_LOCAL#{yyyy-MM-dd} #TIME_LOCAL#{HH:mm:ss}</TimeStamp>
  <TimeStampUTC>#DATE_UTC#{yyyy-MM-dd} #TIME_UTC#{HH:mm:ss}</TimeStampUTC>

  <OvertimeVehicleId>#OVERTIME_READ_ID#</OvertimeVehicleId>
  <OvertimePlateRead>#OVERTIME_PLATE_READ#</OvertimePlateRead>
  <OvertimePlateState>#OVERTIME_PLATE_State#</OvertimePlateState>
  <OvertimeReadType>#OVERTIME_READTYPE#</OvertimeReadType>
  <OvertimePermitName>#OVERTIME_PERMIT_NAME#</OvertimePermitName>
  <OvertimeRuleId>#OVERTIME_RULE_ID#</OvertimeRuleId>
  <OvertimeRuleName>#OVERTIME_RULE_NAME#</OvertimeRuleName>
  <OvertimeUnitName>#OVERTIME_UNIT_NAME#</OvertimeUnitName>
  <OvertimeUnitId>#OVERTIME_UNIT_ID#</OvertimeUnitId>
  <OvertimeUserName>#OVERTIME_USER_NAME#</OvertimeUserName>
  <OvertimeUserLogin>#OVERTIME_USER_LOGIN#</OvertimeUserLogin>
  <OvertimeUserId>#OVERTIME_USER_ID#</OvertimeUserId>
  <OvertimePermitId>#OVERTIME_PERMIT_ID#</OvertimePermitId>
  <OvertimeLongitude>#OVERTIME_LONGITUDE#</OvertimeLongitude>
  <OvertimeLatitude>#OVERTIME_LATITUDE#</OvertimeLatitude>
  <OvertimeLprImagePath>#OVERTIME_PLATE_IMAGE#</OvertimeLprImagePath>
  <OvertimeContextImagePath>#OVERTIME_CONTEXT_IMAGE#</OvertimeContextImagePath>
  <OvertimeTireImagePath>#OVERTIME_TIRE_IMAGE#</OvertimeTireImagePath>
  <OvertimeTimeStamp>#OVERTIME_DATE_LOCAL#{yyyy-MM-dd} #OVERTIME_TIME_LOCAL#{HH:mm:ss}</OvertimeTimeStamp>
  <OvertimeTimeStampUTC>#OVERTIME_DATE_UTC#{yyyy-MM-dd} #OVERTIME_TIME_UTC#{HH:mm:ss}</OvertimeTimeStampUTC>

  <OvertimeElapseMinutes>#OVERTIME_ELAPSEMINUTES#</OvertimeElapseMinutes>
  <OvertimeElapseSeconds>#OVERTIME_ELAPSESECONDS#</OvertimeElapseSeconds>
  <OvertimeElapseHours>#OVERTIME_ELAPSEHOURS#</OvertimeElapseHours>
  
  <!-- 
    *************************************************************************
    LEGACY
    
    The following section describes the supported tags using the legacy format. 
    It can still be used but they have been deprecated since Patroller 6.2.
    
    *************************************************************************
  -->
  <IsPlateExpired>%IsPlateExpired%</IsPlateExpired>
  <IsPayZone>%IsPayZone%</IsPayZone>
  <PlateStatus>%PlateStatus%</PlateStatus>

  <HitId>%HitId%</HitId>
  <HitType>%HitType%</HitType>
  <UserAction>%UserAction%</UserAction>

  <VehicleId>%VehicleId%</VehicleId>
  <Plate>%Plate%</Plate>
  <State>%State%</State>
  <ReadType>%ReadType%</ReadType>
  <PermitName>%PermitName%</PermitName>
  <ZoneName>%ZoneName%</ZoneName>
  <UnitName>%UnitName%</UnitName>
  <UnitId>%UnitId%</UnitId>
  <UserName>%UserName%</UserName>
  <UserLogin>%UserLogin%</UserLogin>
  <UserId>%UserId%</UserId>
  <PermitId>%PermitId%</PermitId>
  <ParkingPermitId>%ParkingPermitId%</ParkingPermitId>
  <ZoneId>%ZoneId%</ZoneId>
  <GpsX>%GpsX%</GpsX>
  <GpsY>%GpsY%</GpsY>
  <LprImagePath>%LprImagePath%</LprImagePath>
  <ContextImagePath>%ContextImagePath%</ContextImagePath>
  <TireImagePath>%TireImagePath%</TireImagePath>
  <TimeStamp>%TimeStamp%</TimeStamp>
  <TimeStampUTC>%TimeStampUTC%</TimeStampUTC>

  <OvertimeVehicleId>%OvertimeVehicleId%</OvertimeVehicleId>
  <OvertimePlate>%OvertimePlate%</OvertimePlate>
  <OvertimeState>%OvertimeState%</OvertimeState>
  <OvertimeReadType>%OvertimeReadType%</OvertimeReadType>
  <OvertimePermitName>%OvertimePermitName%</OvertimePermitName>
  <OvertimeZoneName>%OvertimeZoneName%</OvertimeZoneName>
  <OvertimeUnitName>%OvertimeUnitName%</OvertimeUnitName>
  <OvertimeUnitId>%OvertimeUnitId%</OvertimeUnitId>
  <OvertimeUserName>%OvertimeUserName%</OvertimeUserName>
  <OvertimeUserLogin>%OvertimeUserLogin%</OvertimeUserLogin>
  <OvertimeUserId>%OvertimeUserId%</OvertimeUserId>
  <OvertimePermitId>%OvertimePermitId%</OvertimePermitId>
  <OvertimeZoneId>%OvertimeZoneId%</OvertimeZoneId>
  <OvertimeGpsX>%OvertimeGpsX%</OvertimeGpsX>
  <OvertimeGpsY>%OvertimeGpsY%</OvertimeGpsY>
  <OvertimeLprImagePath>%OvertimeLprImagePath%</OvertimeLprImagePath>
  <OvertimeContextImagePath>%OvertimeContextImagePath%</OvertimeContextImagePath>
  <OvertimeTireImagePath>%OvertimeTireImagePath%</OvertimeTireImagePath>
  <OvertimeTimeStamp>%OvertimeTimeStamp%</OvertimeTimeStamp>
  <OvertimeTimeStampUTC>%OvertimeTimeStampUTC%</OvertimeTimeStampUTC>

  <OvertimeElapseMinutes>%OvertimeElapseMinutes%</OvertimeElapseMinutes>
  <OvertimeElapseSeconds>%OvertimeElapseSeconds%</OvertimeElapseSeconds>
  <OvertimeElapseHours>%OvertimeElapseHours%</OvertimeElapseHours>

</Enforce>

Champs d'analyse

Les tableaux suivants présentent les champs d'analyse de lecture disponibles via le fichier HitExportTemplate.xml. Les analyses de lecture sont accessibles via le jeton générique #Analytics()#. Par exemple, pour accéder à l’analyse GeometricDop, utilisez <GeometricDop>#Analytics(GeometricDop)#</GeometricDop>
REMARQUE :
  • L'analyse n’est pas disponible pour les lectures de plaques saisies manuellement. L'analyse existante d'une lecture de plaque n’est pas modifiée en cas de modification de la lecture.
  • Dilution of precision (DOP) fait référence à la réduction temporaire de la capacité du système à vous géolocaliser précisément en raison de la position actuelle des satellites. L'analyse DOP n’est disponible qu’avec les unités de base AutoVu™ qui intègrent l'option Navigation.
Field (Patroller 6.5 SR3 et ultérieur) Description
GeometricDop Geometric dilution of precision (GDOP) indique une dégradation de la précision de l’horloge et de la position 3D.
REMARQUE : GDOP est le type d'analyse DOP le plus utile à connaître. La valeur intègre tous les facteurs disponibles.
PositionDop Position dilution of precision (PDOP) indique une dégradation de la précision de la position 3D.
TimeDop Time dilution of precision (TDOP) indique le décalage de l’horloge.
HorizontalDop Horizontal dilution of precision (GDOP) indique une dégradation de la précision de la direction horizontale.
VerticalDop Vertical dilution of precision (GDOP) indique une dégradation de la précision de la direction verticale.
EastingDop Easting dilution of precision (GDOP) indique une dégradation de la précision dans le composant Est de l’interprétation de la direction horizontale.
NorthingDop Northing dilution of precision (GDOP) indique une dégradation de la précision dans le composant Nord de l’interprétation de la direction horizontale.
Vitesse Sharp Les caméras peuvent estimer la vitesse d'un véhicule.
REMARQUE : Dans le cadre d'une installation AutoVu™ mobile, le véhicule Genetec Patroller™ doit être à l'arrêt pour utiliser cette fonctionnalité.
ConfidenceScore Valeur numérique (de 0 à 100).

Cette valeur indique la confiance accordée par la Sharp à la fiabilité de la lecture. La valeur 100 indique une confiance maximale.

ReadWithSeparators Exporte les tirets présents dans les lectures de plaques.
REMARQUE : L'analyse n’est pas disponible pour les lectures de plaques saisies manuellement. L'analyse existante d'une lecture de plaque n’est pas modifiée en cas de modification de la lecture. C’est pourquoi nous recommandons l’utilisation du hashtag ActualPlate plutôt que l’analyse ReadWithSeparators.

Champs généralistes

Les tableaux suivants présentent les champs généralistes et types de sorties de données du fichier HitExportTemplate.xml pour les systèmes qui exécutent Genetec Patroller™ 6.5 SR3 ou ultérieur.
Field Patroller 6.5 SR3 et ultérieur Description
ActualPlate Pour exporter les tirets dans les lectures de plaques (par exemple ABC-123), changez <PlateRead>#PLATE_READ#</PlateRead >  vers <PlateRead>#ActualPlate#</PlateRead >.

Champs généralistes

Les tableaux suivants présentent les champs généralistes et types de sorties de données du fichier HitExportTemplate.xml pour les systèmes qui exécutent des versions plus anciennes de Genetec Patroller™.
Field (Patroller 6.1 et antérieur) Field (Patroller 6.2 et ultérieur) Description
IsPlateExpired IsPlateExpired "True" or "False" (vrai ou faux). Valeur booléenne qui indique si la plaque est expirée ou non.
IsPayZone IsPayZone "True" or "False" (vrai ou faux). Valeur booléenne qui indique si la zone choisie est une aire de stationnement "payez par zone".
PlateStatus PlateStatus Spécifie le statut de la plaque. Les valeurs possibles sont: Expired, Valid et NotChecked.
HitId Hit_Id L'identifiant de l'alerte, généré en tant que GUID.

Par exemple : 000000000-0000-0000-000000000000.

HitType Hit_Type Le type d'alerte. Les valeurs autorisées sont : Hotlist, Overtime, Permit et SharedPermit.
VehicleId Read_Id L'identifiant du véhicule généré en tant que GUID.

Par exemple : 000000000-0000-0000-000000000000.

Plaque Plate_Read Le numéro de plaque d'immatriculation.

Par exemple, ABC123.

État Plate_State L'état ou la province qui délivre la plaque d'immatriculation.

Par exemple : QC.

ReadType ReadType Le type de lecture.

Les valeurs possibles sont: Standard (standard), Permit (permis), Overtime (dépassement de plage horaire), SharedPermit (permis partagé).

PermitName Permit_Name Le nom d'entité du permis.
ZoneName Rule_Name Nom de la zone du permis (aire de stationnement, permis restreint, ainsi de suite). Utilisé pour l'application de stationnement universitaire seulement.
UnitName Unit_Name Nom donné à l'unité Patroller dans le Patroller Config Tool.
UnitId Unit_Id L'identifiant de l'unité Patroller généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

UserName User_Name Le nom d'utilisateur de Security Center qu'utilise l'utilisateur de Patroller.
UserLogin User_Login Le nom d'ouverture de session de l'utilisateur de Patroller.
UserId UserId L'identifiant de l'utilisateur de Patroller généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

PermitId Permit_Id L'identifiant du permis sélectionné généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

ParkingPermitId Parking_Permit_Id L'identifiant du permis partagé sélectionné généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

ZoneId Rule_Id L'identifiant de la zone sélectionnée, généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

GpsX Longitude La valeur en degrés décimaux de la longitude du Patroller lors de l'alerte.

Par exemple : -73.5878100.

GpsY Latitude La valeur en degrés décimaux de la latitude du Patroller lors de l'alerte.

Par exemple : 45.5088400.

LprImagePath Plate_Image L'emplacement de l'image de RAPI sur l'ordinateur embarqué dans le véhicule Patroller.
ContextImagePath Context_Image L'emplacement de l'image de contexte dans l'ordinateur du véhicule du Patroller.
TireImagePath Tire_Image L'emplacement de l'image de roues dans l'ordinateur du véhicule du Patroller
TimeStamp Date_Local Time_Local Horodatage de la lecture. Par exemple : 8/15/2014 12:04:07.
TimeStampUTC Date_UTC Time_UTC Horodatage de la lecture en format de temps universel coordonné (TUC).

Par exemple : 8/15/2014 04:04:07.

Champs de dépassement de plage horaire

Les champs qui restent pour le fichier HitExportTemplate.xml sont reliés à la première lecture de plaque capturée pendant la première ronde de l'application de dépassement de plage horaire.

Field Patroller 6.1 et antérieur Field Patroller 6.2 et ultérieur Description
OvertimeVehicleId Overtime_Read_Id L'identifiant du véhicule généré en tant que GUID.

Par exemple : 000000000-0000-0000-000000000000.

OvertimePlate Overtime_Plate_Read Le numéro de plaque d'immatriculation. Par exemple, ABC123.
OvertimeState Overtime_Plate_State L'état ou la province qui délivre la plaque d'immatriculation. Par exemple : QC.
OvertimeReadType Overtime_ReadType Le type de lecture. Les valeurs possibles sont: Standard (standard), Permit (permis), Overtime (dépassement de plage horaire), SharedPermit (permis partagé).
OvertimePermitName Overtime_Permit_Name Le nom d'entité du permis.
OvertimeZoneName Overtime_Rule_Name Nom de la zone du permis. Par exemple, le nom de restriction de permis ou d'aire de stationnement. Utilisé pour l'application de stationnement universitaire seulement.
OvertimeUnitName Overtime_Unit_Name Nom donné à l'unité Patroller dans le Patroller Config Tool.
OvertimeUnitId Overtime_Unit_Id L'identifiant de l'unité Patroller généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

OvertimeUserName Overtime_User_Name Le nom d'utilisateur de Security Center qu'utilise l'utilisateur de Patroller.
OvertimeUserLogin Overtime_User_Login Le nom d'ouverture de session de l'utilisateur de Patroller.
OvertimeUserID Overtime_User_ID L'identifiant de l'utilisateur de Patroller généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

OvertimePermitId Overtime_Permit_Id L'identifiant du permis sélectionné généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

OvertimeZoneId Overtime_Rule_Id L'identifiant de la zone sélectionnée, généré en tant que GUID ID.

Par exemple : 000000000-0000-0000-000000000000.

OvertimeGpsX Overtime_Longitude La valeur en degrés décimaux de la longitude du Patroller lors de l'alerte.

Par exemple : -73.5878100.

OvertimeGpsY Overtime_Latitude La valeur en degrés décimaux de la latitude du Patroller lors de l'alerte.

Par exemple : 45.5088400.

OvertimeLprImagePath Overtime_Plate_Image L'emplacement de l'image de RAPI sur l'ordinateur embarqué dans le véhicule Patroller.
OvertimeContextImagePath Overtime_Context_Image L'emplacement de l'image de contexte dans l'ordinateur du véhicule du Patroller.
OvertimeTireImagePath Overtime_Tire_Image L'emplacement de l'image de roues dans l'ordinateur du véhicule du Patroller
OvertimeTimeStamp Overtime_Date_Local Overtime Time Local Horodatage de la lecture. Par exemple : 8/15/2014 12:04:07.
OvertimeTimeStampUTC Overtime_Date_UTC Overtime_Time_UTC Horodatage de la lecture en format de temps universel coordonné (TUC). Par exemple : 8/15/2014 04:04:07.
OvertimeElapseMinutes Overtime_ElapseMinutes Le temps écoulé (en minutes) entre la lecture de plaque de la première ronde et la lecture de plaque de la deuxième ronde.
OvertimeElapseSeconds Overtime_ElapseSeconds Le temps écoulé (en secondes) entre la lecture de plaque de la première ronde et la lecture de plaque de la deuxième ronde.
OvertimeElapseHours Overtime_ElapseHours Le temps écoulé (en heures) entre la lecture de plaque de la première ronde et la lecture de plaque de la deuxième ronde.

Exemple de résultat d’XML Hit export (ancien système)

Dans l'exemple qui suit, puisqu'il n'y avait pas de zone de permis spécifiée, les champs ZoneName et OvertimeZoneName sont remplacés par des champs vides.