Les exports automatisés vous permettent de garder certains jeux de données Hyperline disponibles dans votre propre base de données pour l’analyse, le reporting et les opérations financières.
Au lieu de télécharger manuellement des fichiers CSV, vous pouvez créer une Synchronisation de données qui écrit les données Hyperline vers une base de données de destination selon un calendrier récurrent. Chaque jeu de données sélectionné est écrit dans sa propre table.
La configuration dans l’application prend actuellement en charge les destinations PostgreSQL. Utilisez une base de données, un schéma ou un utilisateur d’écriture dédié pour les exports Hyperline dans la mesure du possible.
Avant de commencer
Pour créer une synchronisation de données, assurez-vous que :
- Vous avez accès aux Paramètres dans Hyperline
- Votre base de données PostgreSQL de destination peut recevoir des connexions depuis Hyperline
- L’utilisateur de la base de données peut créer des tables et écrire des lignes
- L’URL de connexion est disponible
Si votre base de données nécessite une liste blanche d’IP, autorisez le trafic provenant de :
15.188.105.16315.188.215.10535.181.129.14
Vous pouvez également vous connecter via un tunnel SSH lors de la création de la connexion PostgreSQL.
Créer une synchronisation de données
- Allez dans Paramètres > Synchronisations de données
- Cliquez sur Nouvelle synchronisation
- Sélectionnez une connexion PostgreSQL existante, ou choisissez Créer une nouvelle connexion
- Saisissez le nom de la connexion et les détails de connexion à la base de données
- Sélectionnez le statut de la synchronisation :
- Active : s’exécute automatiquement selon le calendrier configuré
- En pause : conserve la configuration sans exécutions programmées
- Sélectionnez la fréquence de synchronisation :
- Toutes les 12 heures
- Toutes les 24 heures
- Sélectionnez les données à synchroniser
- Cliquez sur Enregistrer les modifications
Hyperline valide la connexion à la base de données avant de l’enregistrer. Après la création de la synchronisation, elle apparaît dans la liste Synchronisations de données avec son statut, le nombre de tables sélectionnées, la fréquence et la date de la dernière synchronisation.
Données disponibles
Vous pouvez synchroniser les exports de factures et les rapports Hyperline.
| Données | Table de destination |
|---|
| Factures | hyperline_invoices |
| Lignes d’articles de factures | hyperline_invoice_line_items |
| Soldes par ancienneté | hyperline_report_aged_balances |
| Tous les clients | hyperline_report_all_customers |
| Tous les abonnements | hyperline_report_all_subscriptions |
| Revenus détaillés | hyperline_report_detailed_revenue |
| Brouillons de factures | hyperline_report_draft_invoices |
| Revenus ligne par ligne | hyperline_report_line_by_line_revenue |
| Abonnements actifs | hyperline_report_live_subscriptions |
| Factures ouvertes | hyperline_report_open_invoices |
| Factures en cours | hyperline_report_outstanding_invoices |
| Renouvellements | hyperline_report_renewals |
| Revenus par pays | hyperline_report_revenue_per_country |
| Revenus par nom de ligne d’article | hyperline_report_revenue_per_line_item_name |
| Revenus par forfait | hyperline_report_revenue_per_plan |
| Revenus par produit | hyperline_report_revenue_per_product |
| Colonne | Description |
|---|
_hyperline_source_id | Identifiant de ligne stable utilisé par la synchronisation |
_hyperline_synced_at | Heure à laquelle la ligne a été écrite dans la destination |
_hyperline_sync_run_id | Identifiant de l’exécution de synchronisation qui a écrit la ligne |
_hyperline_report_generated_at | Heure à laquelle le snapshot du rapport a été généré |
_hyperline_report_template | Modèle de rapport source |
_hyperline_row_index | Position de la ligne dans le rapport généré |
_hyperline_row_hash | Hash du contenu de la ligne source |
Gardez les tables gérées par Hyperline séparées de vos propres tables transformées.
Construisez des modèles en aval ou des vues BI à partir des tables hyperline_* au lieu de
modifier directement les tables synchronisées.
Exécuter et surveiller les synchronisations
Les synchronisations programmées ne s’exécutent que lorsque la synchronisation est Active. Vous pouvez également cliquer sur Exécuter maintenant depuis la liste des synchronisations ou la page de détail de la synchronisation pour démarrer une exécution manuelle.
Ouvrez une synchronisation pour examiner l’Historique des exécutions. Chaque exécution affiche :
- Si elle était manuelle ou programmée
- Statut :
pending, processing, done, partial ou error
- Heure de début
- Nombre de tables sélectionnées
- Lignes écrites
- Message d’erreur, le cas échéant
Si une exécution échoue, vérifiez que la base de données de destination est accessible et que l’utilisateur a toujours la permission de créer des tables et d’écrire des lignes.
Supprimer une synchronisation de données
La suppression d’une synchronisation de données arrête les exécutions futures. L’historique des exécutions est conservé pour des raisons d’auditabilité, mais Hyperline ne met plus à jour les tables de destination pour cette synchronisation.
Pages associées
