Télécharger / exporter les sections analytiques

Avant de commencer

Cette fiche explique comment récupérer la liste des sections analytiques d'une instance Lucca. Elle s'adresse aux administrateurs avancés. 

La récupération des données passe par trois étapes : 

  1. Construction de la requête API
  2. Génération de la requête 
  3. Exploitation de la réponse

Construire la requête API et récupérer les données

L'interface actuelle de gestion des axes analytiques ne vous permet pas de récupérer la liste des sections analytiques. Vous devez pour cela faire une requête API. 

Pour construire cette requête, vous pouvez vous appuyer sur la documentation concernée.

Base de la requête

La requête commence systématiquement par l'URL de votre base, il faudra donc le nom de votre instance, par exemple {NomInstance}, suivi de /api/v3/axisSections qui mentionne que vous souhaitez récupérer les sections d'axes analytiques.
Cela donne donc https://{NomInstance}.ilucca.net/api/v3/axisSections

Choix des champs à afficher

Choisissez ensuite les champs que vous souhaitez afficher et ajouter les après ...axisSections?fields= en les séparant tous d'une virgule.
Par exemple, si vous souhaitez l'identifiant, le nom, le code et s'il est actif ou non, cela donne : https://{NomInstance}.ilucca.net/api/v3/axisSections?fields=id,name,code,active

Quels champs sont récupérables ? 

Cela dépend de votre besoin, mais voici les champs les plus utilisés : 

Nom du champ Description
ID Corresponds à l'identifiant unique de la section. Est nécessaire si vous souhaitez modifier le code d'une section via un import.
Name Nom de la section
Code Code de la section. Indispensable en cas d'import
AxisId Identifiant de l'axe auquel appartient la section. Indispensable en cas d'import
Active Indique si la section est archivée (active = false) ou non
Owner Responsable de la section analytique
ParentAxisSections Sections de l'axe parent auxquelles est rattachée la section
Departments Si restriction d'accès : départements ayant accès à la section
LegalEntities Si restriction d'accès : établissements ayant accès à la section
Users Si restriction d'accès : utilisateurs ayant accès à la section

Vous pouvez aussi chercher sur cette image :

(Facultatif) Filtrage sur l'axe

Vous pouvez ensuite filtrer sur l'axe souhaité par exemple.
Pour ce faire, vous devez récupérer l'identifiant de l'axe. Si l'on décide d'afficher les sections de l'axe analytique "Test" ici, il faudra utiliser l'identifiant 8 :


Il faut alors l'ajouter à l'URL après ...?fields=...&axisId=
Pour le cas de cet axe analytique d'identifiant 8, cela donne : https://{NomInstance}.ilucca.net/api/v3/axisSections?fields=id,name,code,active&axisId=8

Générer la requête

Une fois que la requête est finalisée, le plus simple est que vous alliez sur votre navigateur et que vous alliez sur l'URL ainsi créé.

Utiliser bien un navigateur sur lequel vous vous êtes connecté à Lucca récemment.

Exploiter le résultat de la requête

La réponse à cette requête sera au format JSON. Vous pouvez sans difficulté utiliser un outil qui convertira ce format au format Excel (ex: http://www.convertcsv.com/json-to-csv.htm). 

Il suffira généralement de copier la réponse au format JSON dans l'outil sélectionné pour obtenir un fichier au format Excel.

La partie de la réponse à copier est en surbrillance sur cette image :

Il suffit alors, pour l'exemple du site https://www.convertcsv.com/json-to-csv.htm, de le copier ici :

Dans la partie Result, vous aurez la version Excel ou CSV.

Vous pourrez également exploiter ce fichier pour le réimporter si vous avez besoin de faire des modifications. Dans ce cas, mettez bien l'ID dans les champs et préférez le mettre en première colonne, ou à défaut le code de la section, puis mettez le fichier au format CSV avec un séparateur par ";". Dans l'exemple de ce site, c'est dans l'onglet "options".

Contenu de la page

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 5 sur 5