Annexe : Documentation de l'API - Exportation et importation de données

Marché

Récupération de données FTP conventionnelle

Méthode	Ftp
Minute/Horaire	Données brutes/données par minute
Nombre de fichiers envoyés	Basé sur le nombre de compteurs installés, un fichier par compteur sur une base quotidienne Ex. 300 compteurs = 300 fichiers
Temps de récupération des données	2.30hXNUMX selon le fuseau horaire des Clients

Inconvénients de l'utilisation de la méthode conventionnelle :

• Relativement difficile à entretenir

• Aucune visibilité sur le taux de réussite FTP vers le serveur client

• Les données brutes ne sont pas agrégées. L'auto-agrégation et la comparaison sont nécessaires. Les fichiers bruts ne sont pas combinés aux niveaux des succursales si l'un des compteurs est hors ligne, cela entraînerait un trafic au niveau des succursales inférieur

• Aucune visibilité quant à savoir si les données tardives seront réincluses le jour suivant

• Intégrité des données : Données inexactes, en particulier lorsqu'un compteur hors ligne affecte la précision globale du comptage, en termes de conversion des ventes, de nombre de visiteurs, etc. Aucune visibilité si les données récupérées sont partiellement ou entièrement complétées, s'il s'agit de données propres sans compteurs hors ligne et sans données non vérifiées

Solution proposée: 

Avantages :

• Assurez-vous que les données collectées sont entièrement vérifiées

• Assurez-vous que les données collectées au niveau de la succursale ne manquent pas de données en raison de l'un des compteurs hors ligne

• Assurez-vous que les données sont entièrement téléchargées sur le serveur et obtenez l'ensemble complet à comparer avec la conversion des ventes

Intégration avec l'opérateur historique Compteur de Personnes

L'utilisateur peut choisir de migrer les données historiques de son appareil actuel vers FootfallCam Responsable analytique : Le processus peut prendre jusqu'à une semaine pour générer des rapports basés sur les données historiques.

Cependant, cette fonction n'est actuellement pas disponible pour une diffusion publique. Si vous souhaitez migrer vos données à partir de votre compteur de personnes existant, veuillez envoyer un e-mail à FootfallCam Équipe des ventes.

Récupération de données 

FootfallCam Il s'agit d'un module logiciel entièrement embarqué, conçu pour tout environnement nécessitant le comptage des flux de visiteurs en magasin. Le système de veille stratégique (BI) extrait et analyse les données de fréquentation (issues de FootfallCam Le serveur central utilise les données de caisse enregistreuse électronique (ePOS) ou les heures travaillées du personnel (issues du système ePOS ou du système de gestion du personnel du détaillant) pour générer un rapport de gestion destiné à la planification stratégique de l'entreprise. Par défaut, l'utilisateur peut obtenir les données de fréquentation directement depuis le comptoir ou le serveur via plusieurs méthodes, décrites ci-dessous :

Récupérer les données via l'API de l'appareil

ÉTAPE 1 - Générer une URL : http://[insérer l'adresse IP interne]/cgi-bin/access_token.cgi?username=[insérer le nom d'utilisateur] & mot de passe =[insérer le mot de passe]

Lien vidéo sur la façon de générer un jeton d'accès : https://youtu.be/emDf1yAZhPk

Produit	Description
IP interne	Récupérez l'adresse IP interne.     (Info: Pour plus d'informations sur l'IP interne, veuillez consulter Section 6.2.)
Nom d'utilisateur ( Ou : Nom d'épouse )	admin     (Info: Sensible aux majuscules et minuscules.)
Mot de passe	(Info: Même mot de passe utilisé pour se connecter Assistant de configuration du compteur, il est donc contre-dépendant. pas le mot de passe utilisé pour se connecter pour contrer le Wi-Fi)

ÉTAPE 2 - Exécutez l'URL et le jeton d'accès reçu sera affiché comme ci-dessous.

URL	Sortie
http://192.168.2.123/cgi-bin/access_token.cgi?username=admin&password=[password]

ÉTAPE 3 - Récupérer les données à l'aide du jeton d'accès reçu. Générez une URL avec le paramètre sélectionné répertorié ci-dessous: http://[insérer l'adresse IP interne]/cgi-bin/apiCount.cgi?data_type=[insérer le type de données]& data_format =[insérer le format de données]& resolution_min =[insérer les minutes de résolution]& date_start =[insérer la date de début]& date_end =[insérer la date de fin]& time_start =[insérer l'heure de début]& time_end = [insérer la fin de l'heure]& access_token =[insérer un jeton]

Paramètre	Description	Valeur	Échantillon
Type de données	Type de données.	json, xml	data_type = xml
Format de données	Format des données.	heure, minute, seconde	data_format = seconde
Minutes de résolution	La résolution des données des minutes.	1, 5, 10, 15, 30, 60	resolution_min = 15
Résolution Seconde	La deuxième résolution des données.	1, 5, 10, 15, 30, 60	resolution_sec = 1
date de depart	Date de début des données.	AAAAMMJJ	date_start = 20181231
Date de fin	Date de fin des données.	AAAAMMJJ	date_end = 20190131
Heure de début	Pour définir la plage d'heures de début de l'API	HHmmss	time_start = 103000
Heure de fin	Pour définir la plage d'heures de fin de l'API	HHmmss	time_end = 223300

Politique de conservation des données

• Compter les données avec MINUTE et DEUXIÈME la résolution est stockée jusqu'à sept (7) jours dans l'appareil.
• Compter les données avec HORAIRE la résolution est stockée jusqu'à un mois (30 jours) dans l'appareil.

 

Exemple 1 - Comptage des données en secondes
http://192.168.2.123/cgi-bin/apiCount.cgi?data_type=json&data_format=second&resolution_sec=30&date_start=20181231&date_end=20190131&time_start=083000&time_end=183000&access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IkFkbWluIiwic2VyaWFsIjoiTnpVd01EQXdNREl3WkRnM05qUmpadz09IiwicGFzc3dvcmQiOiIxMjM0NTYifQ.0fhypDovKDrEG3WIRNnXqlT9CArFPSsuZbi0R1RRvGw

Exemple 2 - Comptage des données en minute
http://192.168.2.123/cgi-bin/apiCount.cgi?data_type=json&data_format=minute&resolution_min=1&date_start=20181231&date_end=20190131&time_start=083000&time_end=183000&access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IkFkbWluIiwic2VyaWFsIjoiTnpVd01EQXdNREl3WkRnM05qUmpadz09IiwicGFzc3dvcmQiOiIxMjM0NTYifQ.0fhypDovKDrEG3WIRNnXqlT9CArFPSsuZbi0R1RRvGw

Exemple 3 - Comptage des données en heure
http://192.168.2.123/cgi-bin/apiCount.cgi?data_type=json&data_format=hour&date_start=20181231&date_end=20190131&time_start=083000&time_end=183000&access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IkFkbWluIiwic2VyaWFsIjoiTnpVd01EQXdNREl3WkRnM05qUmpadz09IiwicGFzc3dvcmQiOiIxMjM0NTYifQ.0fhypDovKDrEG3WIRNnXqlT9CArFPSsuZbi0R1RRvGw

Méthode de récupération des données de l'API Pro2 2025

ÉTAPE 1 - Générer un jeton d'accès : 

URL: [Adresse IP de l'appareil]/v1/auth/login

• Préparation: POSTEZ
• Description : authentifie l'utilisateur et renvoie un jeton
• En-têtes: 
  • Type de contenu: application / json
• Body:

{

    "nom d'utilisateur": "admin",

    "mot de passe" : "mot de passe"

}

• Réponse:
  • Succès : 200 OK
  • Échec : 401 non autorisé

{

    "expire_in": 3600,

    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNzM4ODEyOTgwLjExMTMxMDJ9.y7KLignsX5biSdvEuSGcL_0jcD5OXYKMBUvTYVWOgUA"

}

Exemple (en utilisant Postman) :

ÉTAPE 2 - Récupérer les données à l'aide du jeton d'accès reçu. Générer une URL avec le paramètre sélectionné, comme indiqué ci-dessous : http://[Adresse IP de l'appareil]/v1/data/counting?data_type=[insérer le type de données]& data_format =[insérer le format de données]& resolution_min =[insérer les minutes de résolution]& date_start =[insérer la date de début]& date_end =[insérer la date de fin]& time_start =[insérer l'heure de début]& time_end = [insérer la fin de l'heure]& access_token =[insérer un jeton]

Paramètre	Description	Valeur	Exemple
Format de données	Format des données	heure, minute, seconde	data_format = seconde
Minutes de résolution	Résolution des données en minutes	1,5,10,15,30,60	resolution_min = 15
Résolution Seconde	Deuxième résolution des données	1,5,10,15,30,60	resolution_sec = 10
date de depart	Date de début des données	aaaammjj	date_start = 20250501
Date de fin	Date de fin des données	aaaammjj	date_end = 20250502
Heure de début	Heure de début des données	HHMMSS	time_start = 090000
Heure de fin	Heure de fin des données	HHMMSS	time_end = 180000
Exporter des données	Exporter les données au format csv	TRUE	export_data=Vrai
Legacy	Exporter les données au format hérité	VRAI FAUX	héritage=Vrai

 

Exemple 1 - Comptage des données en secondes

Example URL: http://192.168.2.123/v1/data/counting?data_type=json&data_format=second&resolution_sec=15 &date_start=20250829&date_end=20250829&time_start=080000&time_end=200000&legacy=True

• Préparation: ÉCONOMISEZ
• En-têtes: 
  • Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNzU3NTc1MTMwLjc1MDYzMX0.OSQAGrBb9NbBDGwk78Or5OyiHw7h30Dx0ISzP6AUGYk

Exemple (en utilisant Postman) :

 

Exemple 2 - Comptage des données en minute

Example URL: http://192.168.2.123/v1/data/counting?data_type=json&data_format=minute&resolution_min=1&date_start=20250828&date_end=20250828&time_start=090000&time_end=210000&legacy=True

• Préparation: ÉCONOMISEZ
• En-têtes: 
  • Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNzU3NTc1MTMwLjc1MDYzMX0.OSQAGrBb9NbBDGwk78Or5OyiHw7h30Dx0ISzP6AUGYk

Exemple (en utilisant Postman) :

 

Exemple 3 - Comptage des données en heure

Example URL: http://192.168.2.123/v1/data/counting?data_type=json&data_format=hour&date_start=20250905&date_end=20250905&time_start=120000&time_end=220000

• Préparation: ÉCONOMISEZ
• En-têtes: 
  • Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6ImFkbWluIiwiZXhwIjoxNzU3NTc1MTMwLjc1MDYzMX0.OSQAGrBb9NbBDGwk78Or5OyiHw7h30Dx0ISzP6AUGYk

Exemple (en utilisant Postman) :

 

Récupérer des données via l'API depuis Analytic Manager

ÉTAPE 1 - Connectez-vous au gestionnaire analytique et accédez à la page d'exportation à partir de la barre de navigation de gauche Paramètres > Télécharger 

ÉTAPE 2 - Sélectionnez API languette

ÉTAPE 3 - Sélectionnez les options d'exportation souhaitées pour chaque champ et cliquez sur Appliquer

Produit	Description
Agrégation des données	Sélectionnez les types de données (niveau du compteur ou niveau du site) à exporter. Il remplira ensuite la liste déroulante par compteurs ou par sites.
Agrégation temporelle	Sélectionnez les données agrégées horaires ou quotidiennes à exporter
Date de Gamme	Date de début et de fin des données à exporter. Peut ajuster manuellement «fromdate» et «todate» dans l'URL générée pour une intégration plus facile.
Format de la date	Format de date utilisé dans le fichier d'exportation CSV / Excel / TXT

ÉTAPE 4 - Cliquez sur Copier pour copier l'URL d'exportation des données en fonction des champs sélectionnés. Certains paramètres peuvent s'ajuster manuellement dans l'URL (par exemple: 'fromdate' et 'todate').

Récupérer des données en direct via WebSocket

Client WebSocket

Avec ce module, les données de comptage peuvent être envoyées à votre serveur websocket au fur et à mesure. Veuillez consulter votre technicien informatique s'il est possible de configurer un serveur Websocket pour recevoir nos données de comptage en direct. 

Pour que cela soit mis en place, il y a plusieurs exigences:

Configuration du module Websocket

Exigence
Adresse du serveur Websocket	Centres de données DOIVENT être reconnu avec OK à leur réception, sinon, FootfallCam Le compteur supposera que l'envoi a échoué et continuera à renvoyer les mêmes données.
Authentification de base (facultative)	Nom d'utilisateur et mot de passe

Dans le panneau de configuration de votre compteur, accédez à l'onglet Paramètres et faites défiler vers le bas pour trouver «Module Websocket».

Une fois activé, vous pouvez remplir votre Adresse Websocket dans le champ prévu. Si L'authentification de base est activé sur votre serveur, vous pouvez basculer l'option et remplir les détails. Sinon, cette option est facultative.

Chaque fois que le réglage est modifié, Vérifier la connexion doit être cliqué avant de l'enregistrer pour permettre au compteur de tester la connexion.

1. Le serveur Websocket doit recevoir des données de test JSON avec la rubrique «generic-test-topic».

2. Le serveur Websocket doit renvoyer "OK".

Module Websocket : explication des données

Paramètre	Description	Valeur
Sujet	Nom de la charge utile que les données IN / OUT enverront au serveur.	ffc-eventrawdata
CaméraSérie	Identifiant unique. (Info: Vous pouvez obtenir le CameraSerial en obtenant le code du chipset sur la page d'accueil.)	00000000xxxxxxxxx
EventStartUTCTime	Début de l'événement dans le fuseau horaire UTC.	AAAA-MM-JJ HH: MM: SS
EventEndUTCTime	Fin de l'événement dans le fuseau horaire UTC.	AAAA-MM-JJ HH: MM: SS
Heure de début de l'événement	Heure de début de l'événement dans l'horodatage Linux	AAAA-MM-JJ HH: MM: SS
Heure de fin de l'événement	Heure de fin de l'événement dans l'horodatage Linux	AAAA-MM-JJ HH: MM: SS
EventStartLocalTime	Début de l'événement à l'heure locale.	AAAA-MM-JJ HH: MM: SS
EventEndLocalTime	Fin de l'événement à l'heure locale.	AAAA-MM-JJ HH: MM: SS
TéléchargéUTCDateTime	UTC Heure à laquelle les données sont publiées pour être envoyées.	AAAA-MM-JJ HH: MM: SS
TéléchargéLocalDateTime	Heure locale à laquelle les données sont publiées pour être envoyées.	AAAA-MM-JJ HH: MM: SS
Id de métrique	To indique le type d'événement déclenché tel que Value IN ou Value Out.	1 = ValeurIN 2 = Valeur en sortie
ID de type de personne	Pour indiquer quel type de personne a été détecté.	1 = visiteur 2 = bâton
Rouler	Temporairement UNIQUEMENT pour un usage interne.	N / A
ID de personne	Pour indiquer que les personnes sont suivies. Par exemple, plusieurs personnes seront indiquées avec des identifiants différents.	numérique

Exemple 1 - Données de valeur IN

{'Topic': 'ffc-eventrawdata', 'Data': {'EventStartUTCTime': '2020-06-17 03:16:41', 'EventEndLocalTime': '2020-06-17 11:16:41', 'EventStartTime': 1592363801, 'MetricId': 1, 'RoiId': 1, 'CameraSerial': '000000006afce315', 'PeopleId': 1, 'EventEndUTCTime': '2020-06-17 03:16:41', ' UploadedLocalDateTime ':' 2020-06-17 11:16:45 ',' EventEndTime ': 1592363801,' EventStartLocalTime ':' 2020-06-17 11:16:41 ',' UploadedUTCDateTime ':' 2020-06-17 03 : 16: 45 ',' PeopleTypeId ': 1}}

Exemple 2 - Données de valeur OUT

{'Topic': 'ffc-eventrawdata', 'Data': {'EventStartUTCTime': '2020-06-17 03:20:18', 'EventEndLocalTime': '2020-06-17 11:20:18', 'EventStartTime': 1592364018, 'MetricId': 2, 'RoiId': 1, 'CameraSerial': '000000006afce315', 'PeopleId': 1, 'EventEndUTCTime': '2020-06-17 03:20:18', ' UploadedLocalDateTime ':' 2020-06-17 11:20:21 ',' EventEndTime ': 1592364018,' EventStartLocalTime ':' 2020-06-17 11:20:18 ',' UploadedUTCDateTime ':' 2020-06-17 03 : 20: 21 ',' PeopleTypeId ': 1}}

Récupérer des données via l'outil d'intégration de données

Lien de téléchargement (prend en charge les appareils Windows 64 bits uniquement)

Lien ici

Construire/Envoyer une requête

ÉTAPE 1 - Sélectionnez le Type d'API (Authentification / Données horaires / Données minutes / Données secondes / Données 60 secondes les plus récentes).

ÉTAPE 2 - Remplir conditions champs en conséquence.

ÉTAPE 3 - Clique le Copier icône à copier Questionou de la Envoyer la requête bouton pour envoyer Demander.

Copier des extraits de code

ÉTAPE 1 - Sélectionnez le Type d'API (Authentification / Données horaires / Données minutes / Données secondes / Données 60 secondes les plus récentes).

ÉTAPE 2 - Remplir conditions champs en conséquence.

ÉTAPE 3 - Sélectionner Langue.

ÉTAPE 4 - Cliquez sur le Copier icône à copier Extrait de code.

Compteur de liens vers le serveur WebSocket local

ÉTAPE 1 - Cliquez sur le Copier icône à copier Adresse WebSocket locale.

ÉTAPE 2 - Accédez à Assistant de configuration du compteur du compteur dont vous souhaitez tester la connexion WebSocket dans votre navigateur Web.

ÉTAPE 3 - Accédez à Paramètres informatiques page, puis à Module WebSocket sous Paramètres informatiques avancés .

ÉTAPE 4 - Basculer WebSocket à "SUR".

ÉTAPE 5 - Coller dans Adresse du serveur WebSocket saisie de texte.

ÉTAPE 6 - Cliquez sur Test de connexion .

ÉTAPE 7 - Cliquez sur Enregistrer .

ÉTAPE 8 - Tu devrais voir Données IN / OUT (Y compris la connexion de test) affichage dans Réponse in Outil d'intégration de données app.

Récupérer des données via FTP

FTP directement depuis le compteur

Heure de sortie	Une fois par jour
Résolution minimum	Une fois toutes les 1 minute
Présentation des données	Par niveau de comptoir

1. L'accès à la Portail -> Barre de navigation de gauche -> Paramètres -> Entreprise page dans la barre de menu à gauche

2. Faites défiler jusqu'à la section Exportation directe à partir du compteur dans la page nouvellement arrivée

3. Cliquez sur l'option de Permettre Ftp.

4. Remplissez les informations requises:

Produit	Description
1. Configurations FTP	Détails du compte FTP
2. Programme	À quelle fréquence les données doivent-elles être exportées
3. Format de la date	Le format de date qui apparaîtra sur les données
4. Nom du fichier	Nom du fichier exporté
5. Format de fichier	Format du fichier exporté

Flux de processus global de FTP directement à partir du compteur

Transfert FTP depuis le serveur

Heure de sortie	Tous les jours de la semaine
Résolution minimum	1 heure
Présentation des données	Par niveau de branche
Types de données	Valeurs IN et OUT, trafic extérieur, taux de rotation, état de vérification et d'agrégation
Format de sortie	Format .xlsx ou .csv

1. Choisir Centre d'exportation dans la barre de menu à gauche

2. Cliquez sur l'onglet Automatiser l'exportation

3. Cliquez sur Configurez pour créer une nouvelle planification FTP

4. Remplissez les détails selon vos besoins

Produit	Description
1. Agrégation des données	Niveau de données à exporter et quel site doit être exporté
2. Agrégation de temps	Période des données à exporter
3. Format de la date	Format des données qui seront affichées dans le fichier d'exportation
4. Fréquence d'exportation	Fréquence du programme d'exportation
5. Type d'exportation	Sélectionnez le format de fichier à exporter
6. Détails FTP	Entrez les détails de votre compte FTP

Récupération de données via MQTT - 3D Pro2

Configuration de MQTT via l'assistant de configuration du compteur

ÉTAPE 1 - Une fois connecté à l'appareil, sur la page d'accueil, cliquez sur les paramètres pour accéder à la page des paramètres.

ÉTAPE 2 - Sur la page Paramètres. Ouvrez la liste déroulante Paramètres informatiques avancés.

ÉTAPE 3 - Dirigez-vous vers le module MQTT et cliquez sur Activer MQTT.

ÉTAPE 4 - Remplissez le champ nécessaire et cliquez sur "Enregistrer" sur Enregistrer les modifications ci-dessous.

Exemple de configuration 

Adresse du courtier MQTT	mqtt://broker.hivemq.com:1883 ou mqtt://votre.broker.server.com:1883
ID client MQTT	client_123 #default est ChipSerial de l'appareil
Sujet MQTT	votre/topic #default paramètre est /status/{ChipSerial}
MQTT Dernière Volonté QoS	0 #envoyer et oublier (actuellement ne prend en charge que cette QoS)
Nom d'utilisateur MQTT	#nécessite une authentification de base pour établir la connexion
Mot de passe MQTT	#nécessite une authentification de base pour établir la connexion

ÉTAPE 1 - Cliquer sur Cadre> Entreprise pour accéder à la page de configuration du panneau de commande.

ÉTAPE 2 - Accédez à la section Récupérer les données de la table SQL.

ÉTAPE 3 - Terminez le processus en remplissant tous les champs obligatoires et cliquez sur Créer .

Produit	Description
1. Nom d'utilisateur	Nom d'utilisateur utilisé pour accéder FootfallCam Gestionnaire analytique V9™.
2. Mot de passe	Mot de passe utilisé pour accéder FootfallCam Serveur de base de données.

Exemple mis à jour le 2021-02-25:

Nom d'utilisateur d'Analytic Manager	Mot de passe Analytic Manager	Nom d'utilisateur SQL Server	Mot de passe SQL Server
abc	123	xyz	789
Ancienne approche: Sélectionnez * dans functionName ('abc', '123'); Exec functionName ('abc', '123');
Nouvelle approche : Sélectionnez * dans functionName ('abc', '789'); Exec functionName ('abc', '789');

Remarque: le mot de passe «789» n'est qu'un exemple de mot de passe. Pour des raisons de sécurité, cela encourage l'utilisateur à définir un ensemble de modèles compliqué.

Exemple 1 - Comment obtenir la liste des compteurs
Description	Pour récupérer la liste des compteurs et les informations sur le site, incluez ID, CameraName, IP, Port, Serial.
Nom de la fonction	ObtenirCompteurParBranche
Paramètres de données	Nom d'utilisateur [nvarchar]; Mot de passe [nvarchar]; Branchid [bigint]
Exemple de SQL	SELECT * FROM GetCounterByBranch ('nom d'utilisateur', 'mot de passe', 37);
Exemple de résultat

Exemple 2 - Comment obtenir la liste des sites
Description	Pour récupérer la liste de sites et les informations sur le site, incluez BranchCode, BranchName, Region, City, Country, StoreType, Latitude, Longitude et Floorsize.
Nom de la fonction	Obtenir la liste des branches
Paramètres de données	Nom d'utilisateur [nvarchar]; Mot de passe [nvarchar]
Exemple de SQL	SELECT * FROM GetBranchList ('nom d'utilisateur', 'mot de passe');
Exemple de résultat

Exemple 3 - Comment obtenir des données de comptage horaire par site
Description	Pour récupérer les données de comptage horaire du site, incluez Branchid, ValueIn, ValueOut, OutsideTraffic, TurnInRate.
Nom de la fonction	ObtenirBrancheHeure
Paramètres de données	Nom d'utilisateur [nvarchar]; Mot de passe [nvarchar]; BranchCode [bigint]; StartDate [datetime]; EndDate [datetime]
Exemple de SQL	SELECT * FROM GetBranchHourly ('nom d'utilisateur', 'mot de passe', -1, '20150320', '20150321');
Note	-1 se réfère à la société ce qui signifie tous les sites.
Exemple de résultat

Exemple 4 - Comment obtenir des données de comptage quotidien par site
Description	Pour récupérer les données de comptage quotidien du site, incluez Branchid, ValueIn, ValueOut, OutsideTraffic, TurnInRate.
Nom de la fonction	ObtenirBrancheHeure
Paramètres de données	Nom d'utilisateur [nvarchar]; Mot de passe [nvarchar]; BranchCode [bigint]; StartDate [datetime]; EndDate [datetime]
Exemple de SQL	SELECT * FROM GetBranchDailySummary ('nom d'utilisateur', 'mot de passe', 410, '20140120', '20140121');
Note	-1 se réfère à la société ce qui signifie tous les sites.
Exemple de résultat

Exemple 5 - Comment obtenir la liste des zones
Description	Pour récupérer la liste des zones et les informations sur les zones, incluez BranchId, BranchName, AreaId, AreaName, CameraId, CounterName, CompanySerial, CounterChipsetCode, LineName et Direction
Nom de la fonction	ObtenirAreaConfiguration
Paramètres de données	Nom d'utilisateur [nvarchar] ; Mot de passe[ nvarchar]; ID de branche [nvarchar]
Exemple de SQL	sélectionnez * à partir de GetAreaConfiguration('Nom d'utilisateur', 'Mot de passe', -1)
Note	-1 qui signifie tous les sites de l'entreprise.
Exemple de résultat

Exemple 6 - Comment obtenir des données de comptage horaire par zone
Description	Pour récupérer les données de comptage horaire de zone, incluez AreaId, AreaName, ValueDateTime, ValueIn, ValueOut
Nom de la fonction	GetAreaHorly
Paramètres de données	Nom d'utilisateur [nvarchar] ; Mot de passe [nvarchar] ; ID de zone [nvarchar] ; DateDébut [dateheure] ; Date de fin [dateheure]
Exemple de SQL	sélectionnez * à partir de GetAreaHourly('Nom d'utilisateur', 'Mot de passe', -1, '2021-01-13 00:00:00.000','2021-01-14 00:00:00.000')
Note	-1 qui signifie tous les domaines de l'entreprise.
Exemple de résultat

Programme

 

Exemple 1 : Comment obtenir les données quotidiennes d'un groupe de sites par groupe de sites
Description	À récupérer données quotidiennes du groupe de sites par groupe de sites.
Nom de la fonction	sitegroup_footfallcounting_day
Exemple de SQL	SELECT Time, FC01_1_SUM, FC02_1_SUM, SiteGroupName FROM sitegroup_footfallcounting_day OÙ SiteGroupId = 'xxx' ET Heure ENTRE '2023-09-21' et '2023-09-26' ;
Exemple de résultat

Exemple 2 - Comment obtenir des données horaires de groupe de sites par groupe de sites
Description	À récupérer données horaires du groupe de sites par groupe de sites.
Nom de la fonction	sitegroup_footfallcounting_hour
Exemple de SQL	SELECT Time, FC01_1_SUM, FC02_1_SUM, SiteGroupName FROM sitegroup_footfallcounting_hour OÙ SiteGroupId = 'xxx' ET Heure ENTRE '2023-09-21 00:00:00' et '2023-09-26 16:00:00' ;
Exemple de résultat

Exemple 3 – Comment obtenir les données quotidiennes du site par groupe de sites
Description	À récupérer données quotidiennes du site par groupe de sites.
Nom de la fonction	sitegroup_footfallcounting_day
Exemple de SQL	SELECT Time, FC01_1_SUM, FC02_1_SUM, BranchName FROM sitegroup_footfallcounting_day OÙ SiteGroupId = 'xxx' ET Heure ENTRE '2023-09-21' et '2023-09-26' ;
Exemple de résultat

Exemple 4 - Comment obtenir des données horaires de site par groupe de sites
Description	À récupérer données horaires du site par groupe de sites.
Nom de la fonction	sitegroup_footfallcounting_hour
Exemple de SQL	SELECT Time, FC01_1_SUM, FC02_1_SUM, BranchName FROM sitegroup_footfallcounting_hour OÙ SiteGroupId = 'xxx' ET Heure ENTRE '2023-09-21 00:00:00' et '2023-09-26 16:00:00' ;
Exemple de résultat

Récupérer les données par la fonction d'exportation manuelle

ÉTAPE 1 - Cliquer sur Paramètre> Exporter pour accéder à la page Exporter.

ÉTAPE 2 - Cliquer sur Exportation manuelle pour accéder à l'onglet Exportation manuelle.

ÉTAPE 3 - Terminez le processus en remplissant tous les champs obligatoires et cliquez sur CSV/Excel/TXT .

Produit	Description
1. Agrégation des données	Sélectionnez le site / compteur.
2. Agrégation temporelle	Sélectionnez la longueur des données.
3. Plage de dates	Sélectionnez la date de début et la date de fin.
4. Format de la date	Sélectionnez le format de la date.
5. Format de l'heure	Sélectionnez le format de l'heure.
6. Colonne de fichier	Disposition de la colonne dans le fichier de téléchargement. (Info: L'utilisateur peut réorganiser la colonne de données si l'utilisateur est sélectionné Customiser .)

Différentes métriques sont disponibles pour une combinaison différente d'agrégation de données et d'agrégation temporelle.

1. Agrégation de données : Site

   Agrégation de temps : horaire
   

2. Agrégation de données : Site

   Agrégation de temps : Quotidien

   

Récupérer les données par programmation automatique sur le portail Web 

Les données peuvent être programmées pour être automatiquement générées et exportées vers votre courrier électronique en fonction de la fréquence définie. Vous trouverez ci-dessous les étapes de configuration du paramètre d'exportation automatique.

ÉTAPE 1 - Cliquer sur Paramètre> Exporter pour accéder à la page Exporter.

ÉTAPE 2 - Cliquer sur Automatiser l'exportation pour accéder à l'onglet Exportation manuelle.

ÉTAPE 3 - Cliquer sur Configurez pour accéder à la page Configurer les paramètres d'exportation automatique.

ÉTAPE 4 - Terminez le processus en remplissant tous les champs obligatoires et cliquez sur Enregistrer .

Produit	Description
1. Agrégation des données	Sélectionnez le site / compteur.
2. Agrégation temporelle	Sélectionnez la longueur des données.
3. Format de la date	Sélectionnez le format de la date.
4. Format de l'heure	Sélectionnez le format de l'heure.
5. Fréquence d'exportation	Sélectionnez la fréquence d'exportation.
6. Type d'exportation	Sélectionnez le type de format d'exportation. (Info: Il existe 3 types d'export: Excel, CSV, TXT)
7. Email	Adresse courriel (Info: Une notification sera envoyée à cet e-mail si l'exportation automatique échoue.)
8. Export (planificateur d'e-mails)	Calendrier actif pour les e-mails d'exportation de données.
9. Vos détails FTP	Détails FTP pour recevoir le fichier exporté.
10. Réglage avancé	Paramètre avancé incluant le mode de cryptage et le mode de connexion [e.

Intégration Power BI

• Ouvrez Power BI et accédez à Obtenir des données => Base de données => Base de données PostgreSQL.

• Ensuite, vous serez redirigé vers la page de connexion PostgreSQL. Remplissez les détails ci-dessous:-

  • Serveur : cube.footfallcam.com : 6432

  • Base de données : postgres

  • Mode de connectivité des données : DirectQuery

  • Cliquez ensuite sur OK et vous serez dirigé vers la page de connexion de l'utilisateur

  • Veuillez contacter FootfallCam Assistance via le portail d'assistance pour demander les identifiants utilisateur.

Intégration des données de vente 

Préparer le fichier de vente d'importation

Les exigences DOIVENT adhérer au fichier importé sont énumérées ci-dessous:

Produit	Description
Format de fichier	Valeurs séparées par des virgules (.csv)
1. Code du magasin	Le code du magasin doit correspondre au code du site. FootfallCam Gestionnaire analytique V9™. (Info: Pour plus d'informations sur le code du site, veuillez consulter la section 4.5 Gérer les détails du site.)
2. DateHeure	Le format de DateTime doit être JJ-MM-AAAA hh: mm.
3. Quantité totale de transaction	TotalTransactionQty est le nombre de transactions effectuées par le client et le format doit être Nombre entier et sans aucun caractère spécial.
4. Valeur de transaction totale	TotalTransactionValue est le montant du paiement reçu et le format doit être Numérique jusqu'à 2 décimales et sans aucun caractère spécial.

Le TotalTransactionQty et TotalTransactionValue peuvent être agrégés en heure selon l'exemple comme ci-dessous:

Avant l'agrégation	Après agrégation [facultatif]

Option d'importation de fichier de vente

Option 1 - Importation manuelle

https://youtu.be/qcBXluW3_Bo

ÉTAPE 1 - Cliquer sur Paramètre> Importer pour accéder à la page Importer. ÉTAPE 2 - Cliquer sur Téléchargement manuel pour accéder à l'onglet Téléchargement manuel. ÉTAPE 3 - Terminez le processus en remplissant tous les champs obligatoires et cliquez sur Global . Produit Description 1. Importer le type de données Sélectionnez le Données de vente comme type de données d'importation. 2. Format de fichier de vente Sélectionnez le format de fichier d'importation. 3. Télécharger le fichier Parcourez et téléchargez le fichier au format de valeurs séparées par des virgules (.csv). 4. Champs disponibles dans le fichier CSV 11 Faites glisser et déposez le champ spécifié en fonction de l'en-tête dans champs requis.

Option 2 - Automatiser l'importation

ÉTAPE 1 - Cliquer sur Paramètre> Importer pour accéder à la page Importer. ÉTAPE 2 - Cliquer sur Automatiser le téléchargement pour accéder à l'onglet Automatiser le téléchargement. ÉTAPE 3 - Cliquer sur Configurez pour accéder à la page Configurer les paramètres d'importation automatique. ÉTAPE 4 - Terminez le processus en remplissant tous les champs obligatoires et cliquez sur Test pour garantir que le processus s'exécute correctement. ÉTAPE 5 - Cliquer sur Enregistrer bouton pour terminer le processus. Produit Description 1. Importer le type de données Sélectionnez le Données de vente comme type de données d'importation. 2. Format de fichier de vente Sélectionnez le format de fichier d'importation. 3. Télécharger un exemple de fichier Parcourez et téléchargez le fichier d'exemple au format de valeurs séparées par des virgules (.csv). 4. Champs disponibles dans le fichier CSV 11 Faites glisser et déposez le champ spécifié en fonction de l'en-tête dans champs requis. 5. Fréquence d'importation Sélectionnez la fréquence d'importation. 6. Email Saisissez une adresse e-mail pour recevoir une alerte de notification d'échec d'importation. 7. Détails FTP Entrez les informations requises pour FTP. (Info: Pour plus d'informations sur le compte FTP, veuillez consulter la section 4.5 Gérer les détails du site.) 8. Répertoire Emplacement du fichier de données de vente.

Importer l'historique des fichiers de vente

ÉTAPE 1 - Cliquer sur Paramètre> Importer pour accéder à la page Importer.

ÉTAPE 2 - Cliquer sur Automatiser le téléchargement pour accéder à l'onglet Automatiser le téléchargement.

ÉTAPE 3 - Sélectionnez le type de données d'importation à gérer et cliquez sur Modifier.

ÉTAPE 4 - Accédez à Importer le journal de l'historique au bas de la page.

ÉTAPE 5 - Cliquer sur Télécharger le journal pour afficher l'état de l'importation dans les détails.

Importation réussie	L'importation a échoué

Importation de données de ventes personnalisées

S'il vous plaît remplir ce formulaire et renvoyer pour utilisation avec les informations suffisantes. Notre technicien vous répondra sur la prochaine étape de l'intégration.

QFP

Question 1 : Comment vous assureriez-vous que l'API est sécurisée ?

- L'API SQL Server devra être accessible via le nom d'utilisateur et le mot de passe
- Le mot de passe est stocké sous forme de chaîne cryptée qui ne peut être décryptée qu'avec la clé qui se trouve à l'intérieur du serveur SQL et la clé est cachée à l'utilisateur
- L'appel API REST pour récupérer les données devra également être appelé avec un jeton d'accès crypté
- Le propriétaire du serveur peut opter pour le blocage du pare-feu et la liste blanche d'adresses IP pour SQL Server afin d'améliorer encore la sécurité du serveur
- Le port par défaut ne sera pas utilisé pour empêcher le détournement des pirates

 

Question 2 : Comment FootfallCam gérer l'énorme trafic de requêtes et de réponses API ?

La gestion du trafic est assurée par Microsoft SQL Server ; aucune autre intervention n'est requise. FootfallCamMais le script de base de données qui FootfallCam Le système d'extraction de données (API) est déjà optimisé pour éviter les goulots d'étranglement.