IFC CSV icon

IFC CSV

Convert IFC to CSV and import CSV data into IF, for documentation see Ifcopenshell.C

Actions2

Overview

This node provides functionality to work with IFC (Industry Foundation Classes) files and CSV data, specifically allowing users to import CSV data into an IFC file or export IFC data to CSV format. The "Import From CSV" operation enables updating or enriching an IFC file by importing structured data from a CSV file, which is useful in scenarios such as integrating external data sources, batch updates of IFC properties, or synchronizing IFC models with tabular data.

Practical examples include:

  • Importing updated property values or metadata from a CSV spreadsheet into an existing IFC model.
  • Automating the enrichment of IFC files with additional information maintained in CSV format.
  • Overwriting or creating new IFC files based on CSV input for downstream BIM workflows.

Properties

Name Meaning
IFC Filename The name of the IFC file into which the CSV data will be imported. Required.
CSV Filename The name of the CSV file containing data to import into the IFC file. Required.
Output Filename The name of the output IFC file after import. If left empty, the original IFC file is overwritten.

Output

The node outputs JSON data representing the result of the import operation. This typically includes confirmation details or status messages returned from the underlying API that performs the import. The exact structure depends on the API response but generally confirms success or failure of the import process.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for accessing the IFC pipeline API service.
  • Relies on an external API endpoint /ifccsv/import to perform the CSV import into IFC files.
  • The node expects the IFC and CSV files to be accessible by the API service, typically by filename references.

Troubleshooting

  • Common issues:

    • Incorrect or inaccessible filenames for IFC or CSV files may cause the import to fail.
    • Missing or invalid API credentials will prevent communication with the IFC pipeline API.
    • Malformed CSV data or incompatible CSV structure relative to the IFC schema can cause errors during import.

  • Error messages:

    • Errors returned from the API are captured and can be output as JSON error messages if "Continue On Fail" is enabled.
    • Typical error messages might indicate file not found, permission denied, or data validation failures.

  • Resolution tips:

    • Verify that the specified IFC and CSV filenames are correct and accessible by the API.
    • Ensure the API key credential is properly configured in n8n.
    • Validate the CSV file format and content against expected schema requirements before import.

Links and References

Discussion