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. La source de transaction est une manière d'identifier le périphérique et n'a pas d'incidence sur le fonctionnement réel.
- 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, cliquez sur Démarrer la collecte des données brutes 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 les caractères, remplacer les caractères comme saut de ligne ou comme 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.
- 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.
- Permet de configurer des événements définis par l'utilisateur sur la page Avancé. Vous pouvez l'utiliser dans Règle d'action, Alertes de l'affichage en direct et Notification.
- 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 API Web dans un format conforme aux spécifications et d'enregistrer vos données de transaction.
Format standard pour envoyer des demandes API Web :
- API : SYNO.SurveillanceStation.Transactions offre les quatre méthodes suivantes (Commencer, Terminer, Annuler et Ajouter les données) pour enregistrer les informations de transaction :
Commencer :
Indique à Surveillance Station de commencer l'enregistrement d'une transaction. Comprend les paramètres suivants :
- device_name : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- session_id : 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.
Terminer :
Indique à Surveillance Station de terminer la transaction et que celle-ci est complète. Comprend les paramètres suivants :
- device_name : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- session_id : Type chaîne ; l'ID de la session de transaction.
Annuler :
Indique à Surveillance Station de terminer une transaction et que celle-ci est complète annulée. Comprend les paramètres suivants :
- device_name : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- session_id : Type chaîne ; l'ID de la session de transaction.
Ajouter les données :
Indique à Surveillance Station d'enregistrer le contenu d'une transaction. Comprend les paramètres suivants :
- device_name : Type chaîne ; le nom du périphérique de transaction sur Surveillance Station.
- session_id : 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.
- Format de demande de base :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="{method}"&version=1&device_name="{device name}"&session_id="{session id}"
Exemples de demandes d'API Web :
- Démarrage de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Begin"&version=1&device_name="POS01"&session_id="1"&timeout=300
- Enregistrement de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Start\n2017/01/01"
- Enregistrement de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Pen $40\nBook $300"
- Enregistrement de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Total $340\nEnd"
- Fin de la transaction :
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Complete"&version=1&device_name="POS01"&session_id="1"
Remarque :
- Vous devez vous connecter à une session avant d'envoyer des demandes Surveillance Station WebAPI. Pour des méthodes de connexion détaillée, reportez-vous au Document API Web.
- Session_id est utilisé pour faire la distinction entre les différents événements de transaction. Les mêmes device_name et session_id sont traités comme un même enregistrement. Le même paramètre est envoyé à nouveau, la méthode Commencer est ignoré jusqu'à ce que la transaction soit terminée, annulée ou qu'elle ait dépassé la limite temporelle de transaction. Ensuite, il est possible de réutiliser session_id.
- Après le début de la transaction, si la limite temporelle est dépassée avant la réception des méthodes Terminer ou Annuler, l'enregistrement de la transaction est sauvegardé et marqué comme Incomplet.