Export de données depuis Unifield

Export des données

Pour exporter les données depuis Unifield, il faut choisir le projet concerné puis se rendre sur la page “Paramètres de projet”. En sélectionnant l’onglet “Base de données” le menu d’export apparait.

A partir de là, il est possible de sélectionner une période qui correspond à la date de création des éléments en base de données. Il faut choisir le type de données parmi les collections et le format d’export (CSV ou JSON). Pour l’import dans un tableur comme Excel il faudra choisir le format CSV. Lorsque l’on clique sur le bouton “Export” le fichier est généré.

Plus d’info sur les collections ici: https://cad42.atlassian.net/wiki/x/GID7IQ

Attention, en fonction du nombre de données demandées, la génération peut-être assez longue mais prend en générale quelques secondes.

Utilisation des données dans Excel

Nous allons importer un fichier .csv contenant des “Métriques” dans la version de bureau de Excel.

Pour ce faire il faut se rendre dans l’onglet “Données” puis cliquer sur “A partir d’un fichier texte/CSV”.

Après avoir sélectionné le fichier précédemment exporté, une fenêtre d’importation devrait s’ouvrir.

Les paramètres devraient être identiques à ceux affichés ci-dessus. Il faut s’assurer que les valeurs s’affichent correctement, en vérifiant notamment les caractères accentués et les formats de dates. Il est éventuellement possible de transformer les données.

Par exemple si le format de date ne convient pas, on clique sur “Transformer les données” puis dans la nouvelle fenêtre on peut modifier le type de colonne:

Si tout parait ok, il suffit de cliquer sur “Charger”.

A présent la donnée devrait être chargée sur la feuille avec les options de tris comme suit:

Rappel concernant les données de Métriques

Le contenu des informations

Les données sont concaténées afin de simplifier l’export et il est normal que certaines colonnes soient vides. Les métriques comportent des données ouvertes dans le sens où il n’y a pas de modèle figé. Il y a donc différentes métriques en fonction des besoins métiers. Des informations qui se trouveront dans certaines lignes n’existeront pas dans d’autres. Les valeurs qui ne sont pas toujours partagées selon les métriques seront toujours précédées par “payload.”.

Prenons l’exemple ci-dessous qui nous montre deux métriques différentes “Coup de grue” et “Phase de grue”.

Ces deux métriques ne partagent pas les mêmes valeurs: on peut voir qu’il n’y a pas d’information de distance “payload.distance” dans une “Phase de grue” et à l’inverse il n’y a pas d’information de poids de départ “payload.startWeight” dans un “Coup de grue”. Par contre le nom de la ressource ou encore les date de début et de fin de la métrique sont présentes.
Certaines informations sont utilisées par l’interface web et peuvent être ignorées comme la valeur “payload.color”.

Les filtres

Pour afficher les métriques de façon séparées nous vous encourageons à utiliser les filtres par colonne.

Les informations types

Voici une liste non exhaustive qui décrit le contenu des valeurs. Ces informations se trouvent notamment dans le cas d’usage du suivi des coups de grue qui génère les métriques suivantes: “Phases de grue”, “Coup de grue”, “Coulage”, “Séquence”.

id: Numéro en base de données
name: Nom ou catégorie de la métrique
createdDate: Date de création de la métrique
trackerName ou payload.trackerName: Nom du dispositif concerné
unitName ou payload.unitName: Nom de la ressource concernée
payload.xxxxx: Valeur customisée définie dans les “Automatismes”
payload.title: Titre de la métrique
payload.startDate: Date de début de l'événement
payload.endDate: Date de fin de l'événement
payload.weight ou totalWeight: Pour un coup de grue il s’agit du poids maximum soulevé par la grue
payload.duration: Durée en seconde de l'événement
payload.zone1: Zone de départ
payload.zone2: Zone d’arrivée
payload.concreteWeight: Poids total moins poids de la benne
payload.volume: Pour les “Coulages” il s’agit du poids de béton “concreteWeight” divisé par la masse volumique du béton.
payload.lat, payload.lon, payload.z: Pour les “Coups de grue”, il s’agit des coordonnées à la fin de l'événement
payload.planning: Planning lier à la métrique
payload.task: Tâche du planning qui concernée par la métrique
payload.fragment: Objet 3D du modèle qui concernée par la métrique
payload.label: Information utilisée par l’interface web afin d’ajout du texte dans le cartouche de la timeline