📦 Utilisation des Services d'Export et d'Import

L'intégration Beem Energy expose plusieurs services puissants pour vous permettre d'exporter vos données historiques depuis le cloud Beem et de les importer dans les statistiques à long terme de Home Assistant.

Ceci est particulièrement utile pour remplir l'historique du tableau de bord Énergie si vous venez d'installer l'intégration.

🔧 Accès : Tous les services sont disponibles dans Outils de développement → Services.

---

⚙️ Workflow recommandé pour remplir l'historique

Pour la plupart des utilisateurs, le processus se résume à deux étapes simples :

1. Exporter les données pour une période donnée avec
   beem_energy.export_for_ha_import
2. Importer automatiquement tous les fichiers générés avec
   beem_energy.import_ha_statistics_files

⚠️ Important : Les opérations d’import modifient directement la base de données interne de Home Assistant. Il est fortement recommandé d’effectuer une sauvegarde complète de votre Home Assistant avant toute manipulation.

---

📤 Description détaillée des services d’exportation

Tous les services d'exportation génèrent des fichiers CSV dans le dossier : /config/www/beem_exports/

⚠️ **Attention **: L’exportation peut prendre plusieurs minutes en fonction de la durée d’historique sélectionnée, car l'intégration ajoute des pauses pour respecter les limites de l'API Beem.

---

🟢 beem_energy.export_for_ha_import — (Recommandé)

Ce service exporte les données dans un format spécialement conçu pour être réimporté dans Home Assistant, en utilisant automatiquement les identifiants des capteurs existants.

Quand l’utiliser ?

C’est le service à utiliser dans 99 % des cas pour sauvegarder et restaurer l’historique du tableau de bord Énergie.

Paramètres :

Nom du paramètre	Description
Appareil Beem	L’appareil Beem Energy à exporter
Date de début	Première journée incluse
Date de fin	Dernière journée incluse

Résultat :
Crée un fichier CSV par type d’énergie (production, injection, etc.) prêt à être importé.

Exemple de l'interface du service export_for_ha_import :

---

⚪ beem_energy.export_to_csv

Ce service effectue un export brut des données horaires telles que fournies par l’API Beem.

Quand l’utiliser ?

Idéal si vous souhaitez analyser vos données dans Excel, Google Sheets, ou archiver vos mesures.
Ce format n’est pas importable directement dans Home Assistant.

Paramètres :

Nom du paramètre	Description
Appareil Beem	L’appareil Beem Energy à exporter
Date de début	Première journée incluse
Date de fin	Dernière journée incluse

Résultat :
Fichiers CSV détaillés avec les colonnes : startDate_utc, datetime_paris, device_id, value_Wh.

---

🟣 beem_energy.export_for_import

Variante avancée d’exportation : génère un fichier au format importable, mais avec un identifiant de statistique générique
(ex : beem_energy:production_...).

Quand l’utiliser ?

Principalement pour des scénarios avancés, comme l’importation de données dans une autre instance Home Assistant où les entités n’existent pas encore.
Pour un usage standard, préférez export_for_ha_import.

Paramètres :

Nom du paramètre	Description
Appareil Beem	L’appareil Beem Energy à exporter
Date de début	Première journée incluse
Date de fin	Dernière journée incluse

---

📥 Description des services d’importation

🟢 beem_energy.import_ha_statistics_files — (Recommandé)

⚠️ Avertissement Important Avant d'Importer. Les opérations d’import modifient directement la base de données interne de Home Assistant. Il est fortement recommandé d’effectuer une sauvegarde complète de votre instance avant de lancer un service d'importation.

Ce service est le compagnon direct de export_for_ha_import.

Il scanne automatiquement le dossier : /config/www/beem_exports/ et importe chaque fichier généré par le service d'exportation HA dans la base de données de Home Assistant.

Quand l’utiliser ?

Juste après export_for_ha_import, pour remplir ou restaurer l’historique.

Paramètres :
Aucun — tout est automatique ✅

Résultat :
Les données des fichiers sont importées dans les statistiques de vos capteurs. Une notification vous confirmera le succès de l’opération.

ℹ️ Note : L’apparition des données dans le tableau de bord Énergie peut prendre quelques minutes à quelques heures selon la taille de la base et la période importée.

---

⚪ beem_energy.import_statistic

Ce service permet d’importer un fichier CSV unique de statistiques manuellement.

Quand l’utiliser ?

Pour importer un fichier spécifique, ou des données provenant d’une autre source.

Pré-requis :
Le fichier CSV doit être placé à la racine de votre dossier de configuration (ex: /config/mon_import.csv).

Paramètres :

Nom du paramètre	Description
Nom du fichier	Nom du fichier CSV à importer (ex: mon_import.csv)

Résultat :
Les données du fichier spécifié sont ajoutées aux statistiques Home Assistant.