Export Data Table (beta)

Cet outil peut être utilisé pour exporter une table de données à partir de n’importe quelle donnée de votre modèle. Dans la table de données exportée, les objets sont des lignes et les propriétés sont des colonnes. Simplebim a également d’autres moyens d’exporter des données sous forme de table, tels que Bimsheet et la palette Table, mais cet outil est conçu pour être plus robuste. Lorsque vous utilisez des données pour l’analyse de données, et en particulier lorsque vous automatisez la mise à jour des données ou collectez des données d’historique, il est de la plus haute importance que le format des données reste cohérent. Afin d’assurer la cohérence, cet outil utilise un fichier de configuration distinct qui n’est jamais modifié par cet outil. Cela signifie que tant que votre fichier de configuration reste le même, le format de la table de données exportée reste le même. Toujours.

La méthode recommandée pour utiliser cet outil est la normalisation du modèle. Lorsque vous normalisez un modèle, vous ajoutez votre propre jeu de propriétés au modèle - le même jeu de propriétés pour tous les objets. Ensuite, vous remplissez les propriétés de votre jeu de propriétés en copiant et en dérivant des informations du modèle et en les enrichissant à partir de sources de données externes. Dans ce scénario, votre table de données est une grande table qui contient tous vos objets et toutes les propriétés de votre propre ensemble de propriétés. C’est l’entrée la plus pratique pour l’analyse des données, car elle garantit que tous vos modèles ont les mêmes propriétés et vous libère de la classe d’objet, qui n’est le plus souvent pas pertinente pour l’analyse des données. La classe d’objet peut être l’une des propriétés de votre jeu de propriétés, vous pouvez donc toujours l’utiliser dans les cas particuliers où elle peut être utile.

Cet outil peut ajouter un GUID (ID global unique) et une colonne d’horodatage à la table de données. Le GUID est utilisé pour identifier l’objet dans le modèle. Vous l’utiliseriez par exemple lorsque vous souhaitez lier votre analyse au modèle à des fins de visualisation. L’horodatage est l’horodatage du modèle. Ensemble, le GUID et l’horodatage permettent de gérer les versions du même objet dans votre référentiel de données et votre analyse.

Le fichier de configuration de la table de données est un fichier ASCII simple que vous pouvez créer et modifier avec le Bloc-notes. Il comporte deux sections: une pour les unités et une autre pour les colonnes.

#Units
m
m2
m3
kg

Les unités sont définies simplement en donnant le symbole de l’unité. Par exemple, 'm' ne peut être qu’une unité de longueur, il n’est donc pas nécessaire de le spécifier séparément. La définition des unités est importante car si vous avez des modèles avec des unités différentes, votre analyse serait incorrecte si les unités ne sont pas normalisées sur tous les modèles de la table de données.

#Columns
IFC:F:IF:MYPSET:MY FIRST PROPERTY:STRING  My First Property
IFC:F:IF:MYPSET:MY SECOND PROPERTY:STRING  My Second Property

Les colonnes sont définies dans l’ordre dans lequel elles apparaissent dans la table de données. Les propriétés GUID, Timestamp et GUID+Timestamp apparaissent, si nécessaire, avant les autres colonnes. Pour chaque colonne, vous définissez la clé de la propriété et le nom de la propriété. Leur clé et leur nom sont séparés par un caractère de tabulation. La clé est utilisée pour rechercher la propriété à partir du modèle et le nom est écrit dans la table de données. Si aucune propriété avec une clé donnée n’est trouvée dans le modèle, une colonne vide avec le nom donné est toujours ajoutée à la table de données.

Bien que cet outil soit déjà entièrement fonctionnel, il s’agit toujours d’une version bêta, car le format du fichier de configuration peut encore changer.

Interface utilisateur

Exécutez l’outil 'Exporter la table de données' à partir du menu 'Exécuter l’outil' dans l’onglet 'Accueil' du ruban. Lorsque vous passez le pointeur de la souris sur les différentes options, une info-bulle contenant des explications utiles s’affiche.

Template et script

Lorsque vous exécutez l’outil à partir d’un modèle ou d’un script, utilisez les options de configuration ci-dessous pour obtenir le résultat souhaité.

Lignes

Clé	Taper	Valeur	Description
OBJETS	Texte	Par défaut = ALL	Les données à exporter. La valeur peut être un nom de groupe d'objets, un nom de classe d'objets ou l'une des valeurs prédéfinies ci-dessous.
		<Object Class Name>	par exemple : Wall
		<Object Group Name>	par exemple : le nom de votre groupe
		ALL	Tous les objets autonomes, tous les assemblages et toutes les pièces
		ASSEMBLIES	Tous les objets autonomes et tous les assemblages de niveau supérieur, aucune pièce.
		PARTS	Tous les objets autonomes et toutes les pièces, pas d'assemblages.

Colonnes

Key	Type	Value	Description
CONFIGURATION_FILE	Open File	Le chemin d'accès complet, y compris l'extension de fichier pour le fichier de configuration.	REMARQUE : L'exportation échouera si cette configuration n'est pas donnée. Dans ce cas, un message sera écrit dans le journal si la journalisation est activée.
REPLACE	Text	Rechercher et remplacer dans le fichier de configuration	For example: [PSET]=Acme
ADD_GUID	On/Off	Default = ON	Ajouter une colonne GUID (Global ID) comme première colonne
ADD_TIMESTAMP	On/Off	Default = OFF	Ajoutez une colonne Timestamp (date et heure) comme première colonne. L'horodatage est l'horodatage du modèle.
ADD_GUID_AND_TIMESTAMP	On/Off	Default = OFF	Ajoutez une première colonne qui combine le GUID et l'horodatage.

Format

Key	Type	Value	Description
WRITE_HEADERS	On/Off	Default = ON	Écrivez les en-têtes (noms de propriété) comme première ligne de la table de données.
DOUBLE_QUOTE_FIELDS	On/Off	Default = OFF	Enveloppez toutes les valeurs entre guillemets doubles.
DELIMETER	Choice	Default = COMMA	Le délimiteur utilisé pour séparer les champs.
		TAB	Utilisez la tabulation comme délimiteur
		SEMICOLON	Utilisez le point-virgule comme délimiteur
		COMMA	Utilisez la virgule comme délimiteur
		SPACE	Utilisez l'espace comme délimiteur

Output

Key	Type	Value	Description
RESULT_FILE	New File	Default = .csv	Le fichier dans lequel la table de données est écrite.
ENCODING	Choice	Default = UNICODE	L'encodage du fichier résultat.
		ASCII	Utilisez le codage ASCII.
		UNICODE	Utilisez l'encodage unicode.
APPEND_TIMESTAMP	Choice	Default = NO	Ajoutez un horodatage au nom du fichier. Il s'agit de l'horodatage du modèle, et non de la date de création du fichier de table de données. Si vous avez un modèle fusionné, un fichier de table de données distinct sera créé pour chaque modèle s'ils ont des horodatages différents.
		NO	N'ajoutez pas d'horodatage au nom du fichier.
		DATE	Ajoutez la partie date de l'horodatage au nom du fichier.
		DATE_AND_TIME	Ajoutez l'horodatage complet au nom du fichier.