Aller au contenu

Importer et exporter des données

Chaque page de liste porte « Exporter » et « Importer » dans sa barre d’outils.

  • Exporter écrit les documents de la liste dans un fichier CSV (valeurs séparées par des virgules) ou JSON (JavaScript Object Notation).
  • Importer lit un tel fichier et crée ou met à jour des documents.

Les deux tournent en arrière-plan. Facet rapporte le résultat quand le travail se termine.

  • Exporter demande l’accès en lecture à la liste.
  • Importer demande les accès de création et de mise à jour ensemble. Facet refuse tout le fichier quand l’un manque.
  • Le fichier le plus sûr est un fichier que vous avez exporté de la même liste.
  1. Ouvrez la page de liste.
  2. Sélectionnez « Exporter » dans la barre d’outils.
  3. Sélectionnez « Exporter en CSV » pour un tableur, ou « Exporter en JSON » pour une copie structurée complète.
  4. Facet démarre un travail en arrière-plan et confirmeà : « Export lancé — le lien vers le fichier arrivera ici dès qu’il sera prêt. »
  5. Quand le fichier est prêt, sélectionnez « Télécharger » dans le message. Le même lien arrive dans vos notifications.

Le fichier porteà :

  • chaque document de la liste que votre compte peut voir
  • une colonne id en premier, avec l’identifiant de chaque document
  • aucun champ que votre rôle cache
  • les données telles qu’à un instant donné. Facet lit la liste en un seul instantané.

L’entrée de menu « CSV — vue actuelle » exporte ce que le tableau montre maintenantà :

  • les colonnes que le tableau montre, dans leur ordre
  • les filtres et le tri que vous avez appliqués
  • les cellules de date et d’heure dans votre fuseau horaire d’affichage
  1. Réglez les colonnes, les filtres et le tri sur la liste.
  2. Sélectionnez « Exporter », puis « CSV — vue actuelle ».
  3. Téléchargez le fichier comme à l’étape 1.
  1. Ouvrez la page de liste.
  2. Sélectionnez « Importer » dans la barre d’outils.
  3. Sélectionnez « Choisir un fichier .csv ou .json », et prenez votre fichier.
  4. Facet montre le nombre de lignes et les premiers noms de colonnes. Vérifiez-les.
  5. Sélectionnez « Importer ». La boîte de dialogue confirmeà : « Import de 12 lignes en cours — le résultat arrivera dans vos notifications. »
  6. Vous pouvez fermer la boîte de dialogue et continuer à travailler. Le résultat arrive aussi dans vos notifications.

Un import réussi rapporte, par exempleà : **3 créée(s) · 2 mise(s) à

jour · 1 ignorée(s)**.

Facet apparie chaque ligne par son id :

  • Une ligne avec un id met à jour le document correspondant.
  • Une ligne sans id crée un nouveau document. Facet génère l’identifiant.
  • Une ligne dont le id correspond à un document supprimé est ignorée. L’import ne restaure pas les documents supprimés.

Les auteurs peuvent déplacer une définition de domaine entière entre instances. Dans l’espace Configurer, ouvrez la liste des domaines. Le menu de ligne d’un domaine publié porte « Exporter le bundle ». Le bouton « Importer un bundle » dans l’en-tête de la page applique un bundle téléchargé. Vous pouvez l’importer sous un nouveau nom, ou le fusionner dans un domaine existant. Un bundle porte seulement des définitions. Les documents ne voyagent pas avec lui. Voir Construire des domaines.

Vous pouvez aussi exporter par l’API (interface de programmation). Créez d’abord une clé d’API dans « Paramètres → Clés API ». Votre rôle doit permettre l’accès d’API. La commande ci-dessous lit la clé depuis la variable d’environnement FACET_API_KEY.

Fenêtre de terminal
curl -k -X POST "https://facet.localhost:3443/Api/crm/Company/export?format=csv&wait=true" \
-H "Authorization: Bearer $FACET_API_KEY" \
-o companies.csv

wait=true fait que Facet envoie le fichier terminé comme réponse. La commande l’écrit dans companies.csv. -k saute la vérification du certificat de l’adresse de développement locale. Sans wait=true, Facet démarre le travail et répond avec l’identifiant du travail. Le lien de téléchargement arrive alors dans vos notifications.

Un export de la liste CRM d’exemple démarre comme cecià :

id,logo,name,phone,status,address,website,industry,owner_id,domain_name,search_text,company_size,annual_revenue
crm.Company.1,,Acme Corp,'+1-555-0100,lead,"{""zip"":""94105"",""city"":""San Francisco"",""street"":""100 Innovation Drive"",""country"":""USA""}",https://acme.com,technology,iam.Account.account_recruiter_kim,acme.com,,201-1000,USD 50000000

Deux règles de cellule se voient ici. Le ' devant le numéro de téléphone est le garde-fou de formule. Facet l’écrit devant un texte qui commence par =, +, - ou @, pour qu’un tableur affiche le texte au lieu de l’évaluer. Une cellule de montant porte sa deviseà : USD 50000000.

Limite Règle
Taille de fichier Un fichier de plus de 50 Mo est refusé. 50 Mo est la valeur par défautà ; votre instance peut différer.
Fenêtre de téléchargement Facet garde les fichiers d’export 30 jours par défaut. Après, le lien cesse de fonctionner.
Clé d’appariement La colonne id est la seule clé d’appariement. Facet ne peut pas apparier par nom ni par un autre champ.
Champs de fichier Un champ de fichier s’exporte comme son identifiant seul. Le contenu du fichier ne voyage pas.
Sidecars et enfants Commentaires, pièces jointes, documents enfants et autres données sidecar ne voyagent pas ainsi.

Règles de cellule pour le fichierà :

  • Une cellule de montant demande la deviseà : USD 10.
  • Une cellule vide efface le champ à la mise à jour. Une colonne que vous omettez laisse le champ inchangé.
  • Facet écrit un ' devant un texte qui commence par =, +, - ou @. L’import retire un ' de tête.
  • Un document écrit avant le dernier changement de la définition de la liste s’exporte dans sa forme stockée plus ancienne.

Rien n’a été importé, et un message de ligne nomme un champ

Section intitulée « Rien n’a été importé, et un message de ligne nomme un champ »

Par exempleà : « Rien n’a été importé. » avec « Ligne 3, champ amountà : … ».

Une ligne a échoué à la validation. Rien n’a été écrit. Corrigez cette ligne et soumettez le fichier à nouveau.

La forme du fichier ne correspond pas à l’en-tête

Section intitulée « La forme du fichier ne correspond pas à l’en-tête »

Par exempleà : « Ligne 2 : row has 3 cells but the header declares 2 columns ».

Facet vérifie la forme du fichier avant que le travail ne démarre. Le message nomme la ligne en faute. Corrigez la ligne, puis importez à nouveau.

Par exempleà : « Échec de l’export — consultez les notifications pour connaître l’erreur. »

Le travail a échoué après son démarrage.

  1. Ouvrez « Notifications » et lisez l’erreur là.
  2. Corrigez la cause et exportez à nouveau.

Le fichier a expiré. Facet garde les fichiers d’export pendant une fenêtre limitée. Exportez à nouveau.

Ces valeurs de id correspondent à des documents supprimés. L’import ne restaure pas les documents supprimés.

  1. Restaurez-les d’abord depuis la corbeille.
  2. Importez à nouveau.