Kingspan File Transfer (18)

Software version: 2017

Last updated September 17, 2018 by Trimble Solutions UK

Software version: 
Not environment-specific

Kingspan File Transfer (18)

The Kingspan File Transfer macrosaved series of actions that includes instructions for a program

Macros are located in the applications and components catalog. They are recorded or created manually and stored as .cs file in a folder defined with the advanced option XS_MACRO_DIRECTORY.

Macros can, for example, be used for creating drawings or reports.

Macros are sometimes used to run an application.

will create a transfer file compatible with the Kingspan detailing program. A report file (KingspanReport.log) and a list of required drawings (RequiredDrawings.dat) will be created for all Kingspan components selected within the model. The transfer file can be used in addition to or instead of the standard order forms.

Any problems during the creation of the file will be written to a log filefile that contains information related to changes, actions, and errors in the model or drawing

Tekla Structures writes information in log files when the model is saved, numbered or checked for clashes, for example.

KingspanError.log and saved to the current Tekla Structures model folderfolder that is used for storing files associated with a model

Tekla Structures stores all files associated with a model in a folder it creates with the same name as the model database (.db1).

In multi-user mode all users access the same model folder.

. Problems will either be errors or warnings. Errors will prevent the creation of a transfer file, whereas warnings (where non-standard parts have been found) will not prevent the creation of the file, and will populate the RequiredDrawings.dat file if a drawing is required. The macro will use a tolerance of 1mm when checking a part against the Kingspan standards. 


  • The file transfer cannot check the validity of the purlin and rails used in the roof and wallplate that represents a structure such as a wall or roof panel

    In Tekla Structures, a panel is created by picking two or more points.

    In cast-in-place concrete the term wall refers to a concept similar to panel.

    systems, or the completeness of the model. For example, the file transfer will not flag the inappropriate use of the Anti-Sag system, or missing pairs of end holes in purlins or rails. It will not recognise where joints have accidentally been omitted. Such checks are your responsibility.
  • Both the transfer file and the report file, will be written to the current Tekla Structures model folder. These files will overwrite existing files with the same name without any prompt or warning to the user. 
  • If you want to split an order into phases, filter the model by phase and include some reference to the phase in the File Name. For example, 514_A for phase A in job 514.
  • Numberingprocess of assigning position numbers to parts, cast units, assemblies, or reinforcement

    In Tekla Structures, the position numbers assigned in the numbering are shown in marks and templates, for example.

    must be up to date before using the File Transfer.


  1. Ensure that Select object in components is selected. Tekla Structures Select object in component icon on toolbar
  2. This macro automatically excludes non-Kingspan parts from the order, but check the currently active Selection Filter to ensure that it is not excluding any parts which are actually required.
  3. Select the area / whole model that you wish to order.
  4. From the Applications and components panel search Kingspan File Transfer, double click the file transfer icon.
  5. Enter the required details into the Parameters tab.
  6. Click Create button.
  7. If there are any errors or warnings while creating the file, see KingspanError.log in the model folder. View an explanation of error and warning messages.
  8. If the transfer file is successfully created, but the log file contains warnings that drawings are required for some parts, then a simple list of those drawings will be in the file RequiredDrawings.dat. Create the relevant Tekla Structures drawing or check that they are up-to-date and ensure that they contain sufficient information for fabrication.
  9. Please contact Tekla Structures support if you require further clarification.

Required files

We recommend that you compress these files into a single “zip” file before emailing them to Kingspan. Please contact Kingspan Structural Steel Products if you require further details.

  • Transfer file e.g. <file name>.WDX
  • KingspanReport.log
  • KingspanError.log
  • RequiredDrawings.dat
  • PDF files for each required drawing

See also

Kingspan cold rolled - Important information
Kingspan File Transfer (18) - Parameters tab
Kingspan File Transfer (18) - Error / warning messages

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
No votes yet