Périphérique
Ajouter, modifier, activer, désactiver et supprimer des périphériques de transaction dans l'onglet Périphérique. Configurez le type de connexion du périphérique de transaction, définissez les conditions de filtrage des informations de transaction, couplez la caméra et choisissez le style d'affichage à l'écran.
Ajouter un périphérique
Pour ajouter un périphérique de transaction :
- Cliquez sur ajouter. Une fenêtre Ajouter l'assistant de périphérique de transaction s'affiche.
- Saisissez un nom dans le champ Nom pour identifier ce périphérique.
- Sélectionnez une source de transaction à partir du menu déroulant Source de Transactions :
- POS : Cette option est uniquement utilisée pour l'identification du périphérique et n'a pas d'incidence sur le fonctionnement en soi.
- Logiciels tiers : Cette option est uniquement utilisée pour l'identification du périphérique et n'a pas d'incidence sur le fonctionnement en soi.
- Code-barres AXIS : Cette option force la sélection de Surveillance Station WebAPI comme Type de connexion. Pour plus d'informations, consultez la section ci-dessous sur Code-barres AXIS.
- Sélectionnez l'un des types de connexions suivants dans le menu déroulant Type de connexion :
- TCP : Saisissez les informations réseau de la source dans les champs Adresse IP et Port.
- Port série : Assurez-vous que tous les paramètres sont cohérents avec la source de connexion.
- Surveillance Station WebAPI : Saisissez l'adresse IP et le port pour vérifier l'état de la connexion. Bien qu'il ne s'agisse pas de champs obligatoires, des paramètres incorrects peuvent provoquer la déconnexion et d'autres problèmes. Pour plus d'informations, consultez la section sur Surveillance Station WebAPI ci-dessous.
- Cliquez sur Suivantpour continuer avec la configuration de la définition des données. Si vous sélectionnez Surveillance Station WebAPI comme type de connexion, vous serez redirigé vers les paramètres d'affichage.
- Sélectionnez la méthode d'encodage correcte, vérifiez que Démarrer la collecte des données brutes est activé et entrez les données du côté périphérique. Les données reçues sont affichées dans le champ Données brutes.
- Configurez les règles pour le démarrage et la fin de la transaction.
- Vous pouvez ajouter une règle de filtrage en cliquant sur le bouton dans le coin supérieur droit. Vous pouvez ignorer des caractères ou remplacer des caractères par un saut de ligne ou d'autres caractères.
- Les résultats des données filtrées s'affichent directement dans le champ données filtrées. Et les données correspondantes sont indiquées dans les données originales.
- Cliquez sur Suivant pour continuer avec les paramètres d'affichage.
- Indiquer si vous souhaitez ou non configurer une caméra couplée pour ce périphérique à partir de Caméra couplée.
- Dans Affichage à l'écran, il est possible de configurer les données de transaction à afficher dans l'affichage en direct et les clips vidéo.
- Cliquez sur Terminer pour terminer la configuration.
Limites :
- Le nom du périphérique est sensible à la casse. De 1 à 32 caractères Unicode sont permis, à l'exclusion des symboles suivants :
! " # $ % & ' ( ) * + , / : ; < = > ? @ [ ] \ ^ ` { } | ~
- Si vous n'avez pas l'encodage que vous utilisez dans la liste d'encodage, vous pouvez également le saisir manuellement.
- Pour les conditions de filtrage, si vous souhaitez filtrer des caractères de contrôle, utilisez « < » et « > » pour entourer les caractères.
- Si la méthode d'encodage ou la condition de filtrage n'est pas correctement configurée, la transaction n'est pas enregistrée. Sur la page Définition des données, les données qui peuvent être correctement filtrées s'affichent dans Données filtrées, et sont marquées en gras dans Données brutes.
- Lors de la configuration d'une caméra couplée, vous pouvez voir la caméra et les données de transaction dans l'affichage en direct et les clips d'enregistrement connexes.
Modifier le périphérique
Pour modifier un périphérique de transaction :
- Sélectionnez le périphérique que vous souhaitez modifier, puis cliquez sur Modifier. Vous pouvez également double-cliquer sur le périphérique pour modifier ses paramètres.
- Configurez des événements définis par l'utilisateur sur la page Événement. Vous pouvez l'utiliser dans Règle d'action, Alertes de l'affichage en direct et Notification.
- Les textes correspondant à Démarrage de la transaction, Fin de la transaction ou Transaction annulée peuvent être configurés pour être omis sur la page Avancé, le texte omis n'est pas stocké dans les enregistrements historiques et ne s'affiche pas à l'écran.
- Spécifiez une durée pour effacer l'incrustation de texte à l'écran sur la page Avancé. Configurez une durée (en secondes) pour que les textes demeurent affichés à l'écran lorsqu'il n'y a pas de nouveaux messages générés. Vous pouvez également choisir d'effacer les textes de l'écran lors de la réception de texte spécifique ou lors du démarrage d'une nouvelle transaction.
- Cliquez sur Terminer pour enregistrer les modifications.
Activer ou désactiver un périphérique
Le nouveau périphérique doit être activé avant de gérer toutes les actions prises en charge.
Pour activer ou désactiver un périphérique :
- Sélectionnez le périphérique que vous souhaitez activer ou désactiver et Activer ou Désactiver dans le menu déroulant Activer.
Remarque :
- La désactivation du périphérique ne supprime pas ses paramètres.
Supprimer un périphérique
- Sélectionnez le périphérique que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Vous pouvez voir une fenêtre de confirmation. Lorsque vous avez choisi de conserver les transactions du périphérique, cliquez sur Oui pour continuer.
Remarque :
- Lors de la suppression d'un périphérique, si vous choisissez de supprimer toutes les transactions, les transactions verrouillées sont également définitivement supprimées de Surveillance Station.
Surveillance Station Web API
Surveillance Station Web API vous offre une manière plus pratique de connecter votre périphérique, d'envoyer des demandes Web API dans un format conforme aux spécifications et d'enregistrer vos données de transaction.
Format standard pour envoyer des demandes Web API :
- API : SYNO.SurveillanceStation.Transactions fournit les cinq types de méthodes suivantes (Insert,Begin, Complete, Cancel et AppendData) pour enregistrer les informations de transaction :
Insert :
Indique à Surveillance Station de commencer l'enregistrement d'une transaction. Comprend les paramètres suivants :
- dsName : Type chaîne ; facultatif ; le nom du serveur d'enregistrement CMS sur lequel le périphérique de transaction se trouve.
- deviceName : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- content : Type chaîne ; le contenu de la totalité de la transaction.
- format : Type chaîne ; format du contenu, json indique que le contenu est au format JSON ; string indique que le contenu est du texte pur.
- timestamp: Type entier ; facultatif ; le nombre de secondes écoulées entre 00:00:00 Coordinated Universal Time (UTC), jeudi, 1er janvier 1970 et l'heure de la transaction.
- account : Type chaîne ; facultatif ; nom du compte.
- password : Type chaîne ; facultatif ; mot de passe du compte.
Begin :
Indique à Surveillance Station de commencer l'enregistrement d'une transaction. Comprend les paramètres suivants :
- dsName : Type chaîne ; facultatif ; le nom du serveur d'enregistrement CMS sur lequel le périphérique de transaction se trouve.
- deviceName : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- sessionId : Type chaîne ; l'ID de la session de transaction.
- timeout : Type entier ; limite temporelle de la transaction (en secondes). Le dépassement de la limite temporelle de transaction met automatiquement fin à celle-ci.
- timestamp: Type entier ; facultatif ; le nombre de secondes écoulées entre 00:00:00 Coordinated Universal Time (UTC), jeudi, 1er janvier 1970 et l'heure de début de la transaction.
- account : Type chaîne ; facultatif ; nom du compte.
- password : Type chaîne ; facultatif ; mot de passe du compte.
Complete :
Indique à Surveillance Station de terminer la transaction et que celle-ci est complète. Comprend les paramètres suivants :
- dsName : Type chaîne ; facultatif ; le nom du serveur d'enregistrement CMS sur lequel le périphérique de transaction se trouve.
- deviceName : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- sessionId : Type chaîne ; l'ID de la session de transaction.
- timestamp: Type entier ; facultatif ; le nombre de secondes écoulées entre 00:00:00 Coordinated Universal Time (UTC), jeudi, 1er janvier 1970 et l'heure de fin de la transaction.
- account : Type chaîne ; facultatif ; nom du compte.
- password : Type chaîne ; facultatif ; mot de passe du compte.
Cancel :
Indique à Surveillance Station de terminer une transaction et que celle-ci est complète annulée. Comprend les paramètres suivants :
- dsName : Type chaîne ; facultatif ; le nom du serveur d'enregistrement CMS sur lequel le périphérique de transaction se trouve.
- deviceName : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- sessionId : Type chaîne ; l'ID de la session de transaction.
- timestamp: Type entier ; facultatif ; le nombre de secondes écoulées entre 00:00:00 Coordinated Universal Time (UTC), jeudi, 1er janvier 1970 et l'heure d'annulation de la transaction.
- account : Type chaîne ; facultatif ; nom du compte.
- password : Type chaîne ; facultatif ; mot de passe du compte.
AppendData :
Indique à Surveillance Station d'enregistrer le contenu d'une transaction. Comprend les paramètres suivants :
- dsName : Type chaîne ; facultatif ; le nom du serveur d'enregistrement CMS sur lequel le périphérique de transaction se trouve.
- deviceName : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- sessionId : Type chaîne ; l'ID de la session de transaction.
- content : Type chaîne ; contenu d'une transaction. Chaque donnée entrante est une ligne distincte ; toutefois, il est possible d'utiliser \ n pour des sauts de ligne dans les données entrantes.
- timestamp: Type entier ; facultatif ; le nombre de secondes écoulées entre 00:00:00 Coordinated Universal Time (UTC), jeudi, 1er janvier 1970 et l'heure de génération de la transaction.
- account : Type chaîne ; facultatif ; nom du compte.
- password : Type chaîne ; facultatif ; mot de passe du compte.
- Format de demande de base :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="{method}"&version=2&deviceName="{device name}"&sessionId="{session id}"
Exemples de demandes d'Web API :
- Démarrage de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Begin"&version=2&deviceName="POS01"&sessionId="1"&timeout=300
- Enregistrement de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=2&deviceName="POS01"&sessionId="1"&content="Start\n2017/01/01"
- Enregistrement de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=2&deviceName="POS01"&sessionId="1"&content="Pen $40\nBook $300"
- Enregistrement de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=2&deviceName="POS01"&sessionId="1"&content="Total $340\nEnd"
- Fin de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Complete"&version=2&deviceName="POS01"&sessionId="1"
Remarque :
- Vous devez vous connecter à une session avant d'envoyer des demandes Surveillance Station WebAPI ou spécifiez account et password comme paramètres. Pour des méthodes de connexion détaillée, reportez-vous au Document Web API.
- Si votre Synology NAS est un serveur hôte CMS, vous pouvez spécifier dsName pour désigner un serveur d'enregistrement CMS auquel le périphérique de transaction est connecté. Si dsName n'est pas spécifiée, le serveur hôte CMS fait l'objet d'une recherche avant les serveurs d'enregistrement CMS des périphériques de transaction qui correspondent au nom donné. Si au moins deux serveurs d'enregistrement CMS se connectent à des périphériques de transaction qui correspondent au nom donné et que dsName n'est pas spécifié, la commande est ignorée.
- sessionId est utilisé pour faire la distinction entre les différents événements de transaction. Les mêmes deviceName et sessionId sont traités comme un même enregistrement. Le même paramètre est envoyé à nouveau, la méthode Begin est ignoré jusqu'à ce que la transaction soit terminée, annulée ou qu'elle ait dépassé la limite temporelle de transaction. Ensuite, sessionId peut être réutilisé.
- Après le début de la transaction, si la limite temporelle est dépassée avant la réception des méthodes Complete ou Cancel, l'enregistrement de la transaction est sauvegardé et marqué comme Incomplete.
Code-barres AXIS
Pour configurer un périphérique de transaction à code-barres AXIS comme source :
- Ajoutez un périphérique de transaction à code-barres AXIS comme sa source.
- Installez AXIS Barcode Reader et AXIS Barcode to Synology Surveillance Station sur une caméra compatible ACAP.
- Ouvrez les paramètres ACAP de la caméra. Ajustez les paramètres AXIS Barcode Reader pour configurer le type de code-barres que vous souhaitez lire.
- Recherchez la page des paramètres de AXIS Barcode to Synology Surveillance Station qui se trouve également sur la page des paramètres ACAP. Configurez l'adresse, le compte utilisateur, le mot de passe de votre Synology NAS ainsi que le nom du périphérique de transaction.