Issue tool

Last updated July 7, 2020 by Steel Extensions

Software version: 
Not version-specific
Not environment-specific

Issue tool

Issue tool 2.0

Purpose and description

Use Issue tool applicationpart of Tekla Structures functionality that is developed in order to extend the capability of Tekla Structures but that is not included in the Tekla Structures installation

to track and display the changes between a model snapshot and the current state of the model. The application displays the reason for each change in a gridmodeling aid that represents a three-dimensional complex of intersecting grid planes or intersecting grid planes and curved grid surfaces

The grid is defined by coordinates in 3D space. It is shown two-dimensionally on the view plane by dash-and-dot lines. A grid can be rectangular or radial.

It is possible to have more than one grid in a model. For example, a large-scale grid for the entire structure, and smaller grids for some detailed sections.

It is also possible to show grids and grid line labels in drawings, and to modify how they are shown in the drawings.

, it adds drawing revision for drawings of parts or assemblies that have changed. Issue tool allows you to filter the data grid and export it to a .csv file.

Installing Issue tool

  1. Download the Issue tool installer package from Tekla Warehouse. For more information see Downloading an application from Tekla Warehouse.
  2. Install the file package.

Using Issue tool

  1. Open a Tekla model.
  2. Number the model and create single-part and assembly drawings.
  3. Open Issue tool by clicking button in the side pane , or you can search for Issue tool in the Application & components cataloguser interface for displaying or modifying information in categorized lists

    For example, profile catalog and shape catalog are catalogs.

    and then double click on it.
  4. Select the Snapshot name box and input the name of the snapshot.
  5. To create the snapshot of this state of the model click Take snapshot button.
  6. Modify any part, assembly, bolt or weld in the model.
  7. Number the model.
  8. In The snapshot to compare list box select the snapshot you want to compare with.
  9. Click button to compare the selected snapshot with the current state of the model.
  10. After the comparison process ends Issue tool displays changes between the selected snapshot and the current modelmodel that is active in Tekla Structures

    The current model can be a single-user model, a shared model or a working model.

  11. To apply filters to the data grid click button on the columns header and select desired check boxes.
  12. To add a drawing revision input the revision name in the Add revision name box and click button.
  13. To export table results in .csv format click button.

Application properties

Field Description Default
1 Settings - defines the volume tolerance for parts changes. Click to open the dialog window and set the volume tolerance. 1000
2 Snapshot name - defines the snapshot name. For empty Snapshot name box the snapshot name will have the following format name: [Snap_DD.MM.YYYY_HH:MM:SS] Snap_DD.MM.YYYY_HH:MM:SS
3 Take snapshot - creates the snapshot of the current status model. -
4 Next issue number - displays the next issue number. 1
5 The snapshot to compare - option list of the model snapshots.  
6 Compare - compares the current model with the snapshot selected in The snapshot to compare list.  
7 Add revision name - defines the name of the drawing revision. -
8 Add drawing revision - creates revision name for the drawings from the Issue tool changes list -
9 Remove unreferenced drawings - deletes the unreferenced drawings
Note: It will delete the drawing only for "All parts are deleted" message on the Changes column from the Drawing List.
10 Update UDA changes - adds changes to the UDA of the objects. Use the Inquire object's command to see the changes. -
11 Expand all - expands all the data grid. Use this button to display the detailed reasons for the change. -
12 Collapse all - collapses all the data grid. Use this button to display the detailed reasons for the change. -
13 Sort - sorts the data in the grid column. To enable this option click on the header of the Object, Mark, Name or Status column. Click on the button to change the sorting order.
Options are:
- sort the column data from A to Z
- sort the column data from Z to A
14 Filter - filters the data grids. Click on the button and select the check boxes you want to filter. If you don't select any check boxes the filter becomes off.
Options are:
- Filter ON - at least one check box is selected
- Filter OFF - no check box is selected
Each column has its own filter check boxes to select:
Object column:
Mark column:
Name column:
Status column:
Why column:
15 Expand/ Collapse - expands or collapses for each row. Click on the button to expand or button to collapse.
Options are:
- collapsed row
- expanded row
16 Select objects in the model - select this check box to highlight in the model the selected objects in the table Selected
17 Zoom to selected - model will zoom into location of selected objects in the data grid Selected
18 Filter selected in model - applies a filter in the table using the objects selection in the model.
To apply this option select objects in the model and then click on the button.
To deactivate the filter click on the button.
19 Progress bar - display the comparison status -
20 Export data from grid - exports all the data grid to a .csv file. To export click on the button, select the file location and type the file name in the dialog window and then click Save. -


  • Only comparison between model snapshots and the current model
  • Issue Tool will not track Save as models
  • Issue Tool will not report bolt holes position changes for geometry changed parts
  • Weld preparationcut that is made on the part edge in order to enable a more complete weld penetration which provides a stronger joint

    is supported on parts but only weld weight for whole model is supported
  • Studbolt element that represents a metal rod or pin that is used to transfer loads

    Studs and other bolt elements are listed in the bolt catalog.

    A stud can be secured with two or more nuts and have threading at both ends, or it can be welded to steel parts, for example.

    A stud is part of the bolt assembly.

    bolts are not supported

Issue tool 1.2


Purpose and description
System requirements
Installing Issue tool
Using Issue tool
Tracking and collecting data
Reports and user defined attributes
See also

Purpose and description

Use Issue tool for creating formal issues in a model and automating typical issue and revision tasks. It will also provide details of what has changed for a revision to help the user quickly understand the root causes for revisions in a model.

System requirements

Tekla Structures version: 2017, 2017i
Environments: All

Installing Issue tool

To install the extension:

  1. Download the Issue tool installer package from Tekla Warehouse. For more information see Downloading an application from Tekla Warehouse.
  2. Install the file package.

Using Issue tool

To use the application:

  1. Open a Tekla model.
  2. Click the Applications & components button in the side pane to open the Applications & components catalog.
  3. Search for Issue tool and then double-click to open it.
  4. The Issue tool workflow:
  1. Model issue wizard
- in this form are displayed information about the old issues and a comment can be added to the newly created issue.

Field Description
(1) Information about the issue - number of new issue
(2) Comment of the last created issue (if any)
(3) The user can add comment for the new issue
(4) Back button (disabled)
(5) Next button - wizard goes to the next page
(6) Cancel button - exits the application
- push Next button (5 ) to continue with the wizard
  1. Specify selection criteria wizard
- specifies the selection criteria for parts, assemblies and rebar's from the model

Field Description Default
(7) Select objects using phase Phase selected
(8) Option for selecting All phases or only some phases from the list All
(9) Select objects using user defined attribute (UDA) -
(10) Combobox with all the user defined attributes All
(11) UDA matching value -
(12) Back button - wizard goes back to the previous page -
(13) Next button - wizard goes to the next page -
(14) Cancel button - exits the application -

- please Perform 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.

before continuing


- if numbering is not up to date the following warning message appers:
- push Back button (12) and Perform numbering
- push Next button (13) to continue with the wizard
  1. Results
- the result of the issues are shown in a grid (15)

Field Description
(15) Status New - newly created marks in model
Revised - revised marks from model
Canceled - deleted marks from model
Restored - restored marks to model
Quantity Number of affected objects
(16) Results details button
(17) Back button - wizard goes back to the previous page
(18) Next button - wizard goes to the next page
(19) Cancel button - exits the application
- for more details push the Results details (16) button, the Results details dialog opens:

Field Description Default
(20) If checked, zooms and selects the objects in the model when user selects them in the data grid Checked
(21) Type filter - the user can choose the objects types from the model to display


  • All - shows all tracked objects
  • Part - shows tracked parts
  • Assembly - shows tracked assemblies
  • Reinforcement - shows tracked reinforcements
  • NC files - shows tracked NC files
(22) Category type filter - the user can select what changes will be tracked


  • All - shows all tracked changes
  • Geometry - shows geometry tracked changes
  • General data - shows general data tracked changes
(23) Export button - Exports the results to Excel or to CSV -
(24) Right clicking a column header will show a option from where the user can set the data grid column as visible or not. Position Checked
Position type Checked
Status Checked
GUIDs Unchecked
Changes Checked
(25) Results details data grid view - displays the results. Position - shows the objects mark -
Position type - shows the objects type
Status - shows the status
Changes - shows the changes
(26) Message about the data loading -

- geometrical properties will be built from the following properties: points positions, length, deformingpart property that changes the geometry of the part

(start and end angles, camberingdeforming that curves a part to compensate for deflection which arises due to loads on the structure

Cambering is typically an upward curvature defined for a beam.

, shorteningdeforming that decreases the modeled length of a part in a drawing by a value the user has entered

Shortening is used when the parts are manufactured shorter than modeled.

), levels ( top, bottom), curved beambeam that follows the form of an arc

Steel curved beams can be created by picking three points, where a point between the start point and the end point defines the arc. Both steel and concrete curved beams can be created by adjusting radius in beam properties or by using polybeams.

( radius plane, radius value, number of segments), position (vertical / on plane, vertical / on plane offset, rotation, rotation offset, horizontal / at depth, horizontal / at depth offset), end offsetpart property that is used to move the ends of a part, relative to the part’s reference line

( start / end Dx, Dy, Dz offsets)

- all other properties are consider to be grouped as general data. Main type filter options are used together with category filter options having combinations like (“part and reinforcement” and “general data” filter checked together) in order to show data in the results details data grid viewview that is created along a specified grid line of a selected grid and whose view plane is the same as the specified grid plane

- push Next button (18) to continue with the wizard

  1. New issue generated

Field Description Defaults
(27) Updates the drawing revisions - If tracked model object has drawings the revision will be incremented with data from the extension following the next mapping:
Issue Tool Results Drawing revision
Position (shown in Results details) Mark
Username Created by
Position type (shown in Results details) Info 1
Status (shown in Results details) Info 2
Comment (from first page) Description

Note:The drawing revision will be created only if the drawing is updated.

(28) Deletes unreferenced drawings

Note: The drawing will be deleted only if in the Drawing Listlist of drawings that provides information about the drawings in a particular model and that is used for searching, managing, and printing the drawings

In the drawing list, the user can, for example, search, open, update, freeze, lock, and delete drawings. The drawing list can also be used to display the associations between the drawings and the parts in the model.

Drawing list is used in Tekla Structures until version 2018. See document manager.

's Changes column "All parts are deleted" message appears.

(29) Revision markuser-created symbol that indicates a change in the model or in the drawing, and in which information about the change is enclosed

Information enclosed in a revision mark is shown in a revision table.

- will be mapped to the drawing's mark revision

Note: The previous mapped mark value is now moved to the Info1 field, separated by a " - " from the content of the Info1 field

(30) Back button - wizard goes back to the previous page -
(31) Create issue button - creates the issue -
(32) Cancel button - exits the application  

- make the desired changes and push Create issue button. Issue is created and the application is closed.

- to clear out the entire issue history and start again a new fresh tracking just delete the "Issue" folder that the tool creates in the 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.

Tracking and collecting data

  • Part tracking

- the application will track the quantity of a part markmark that includes a set of selected property elements related to a part

Part marks are used for identifying constructions, for giving information about welding, for giving information about assemblies to a workshop, for giving information about how parts should be connected to each other, and for creating bills of quantities, for example.

In the US, the term piece mark is used to refer to position number.

- if the part mark has only one element or if the comparing algorithm picks the same object as the previously selected one all the common part properties (material, profile / thickness, finish , classpart property that groups parts according to identifiers given by the user

The identifiers of classes are usually numbers. Classes can be used for defining the color of parts in the model, for example. Class does not influence the numbering of model objects.

, deforming start angle, deforming end angle, cambering, shortening, position vertical / position plane, position plane offset/position vertical offset, position rotation, position rotation offset, position horizontal / position depth, position depth offset/ position horizontal offset, cast unit typeproperty of a concrete part in a cast unit that defines if the structure type of the part is precast or cast in place

, pour phasepart property that defines which cast-in-place concrete parts form a pour object

Pour phase can be used to prevent cast-in-place concrete parts from merging into one pour object.

, part assembly start numberfirst number of a numbering series

, part assembly prefix, name, length) and also specific part properties like:

- for beam: position start offset dx, position start offset dy, position start offset dz, position end offset dx, position end offset dy, position end offset dz, number of curved beam segments, curved beam radius value, curved beam radius plane
- for column and pad footingfooting that supports a single point of contact

Pad footing usually supports one column.

: position top level, position bottom level
- for panel and strip footingfooting that supports several points of contact or a region of points of contact

Strip footing supports a length of wall or a line of closely spaced columns, for example.

In Tekla Structures, strip footing has a polygon shape that the user defines by picking points.

: position start offset dx, position start offset dy, position start offset dz, position end offset dx, position end offset dy, position end offset dz, number of curved bending segments, bending curved radius value, bending curved radius plane
- for poly beams: curved beam number of segments, curved beam radius value, curved beam radius plane
- for poly beam panel and poly beam strip footing: bending curved beam number of segments, bending curved beam radius value, bending curved beam radius plane
- the points of a part are being tracked

- the application will display the type of a part (beam, column, panel, strip footing, pad footing, poly beam, poly beam panel, poly beam strip footing, poly beam column, slabplate that represents a concrete structure

In Tekla Structures, a slab is created by picking three or more points.

Slab may be part of a floor, for example.

or plate(1) part that represents a flat structure

(1) In some contexts, for example in analysis, the term plate object may be used to refer to plates.

(2) plate that represents a steel structure

(2) Plate is mainly used as a connection piece or as a floor plate.


  • Assembly tracking

- the application will track the quantity of an assembly mark
- the application will display the type of the assembly (steel assembly, cast in place assembly, precast assembly, timber assembly)

  • Reinforcement tracking

- the application will track the quantity of a reinforcement markmark that includes a set of selected property elements related to a reinforcement

- if the reinforcement mark has only one element or if the comparing algorithm picks the same object as the previously selected one all the common reinforcement properties (class, end point offset type, end point offset value, father, from plane offset, grade, name , start point offset type, start point offset value, on plane offsets (keeping the Tekla Structures format), bending radius (keeping the Tekla Structures format), length) are being tracked by the application.
- the application will display the type of a reinforcement (rebar meshreinforcement that represents a mesh of steel bars in two perpendicular directions

In Tekla Structures, the reinforcement mesh bars in one direction are called main bars and reinforcement mesh bars perpendicular to them are called crossing bars.

, single rebar, rebar groupgroup of reinforcing bars that are side by side and have identical properties, except the possible variation in bar lengths

, rebar strandreinforcement that represents a group of wires spun together


- the extension is displaying the mark transition of a tracked model objectobject that is represented in a model

A model object is either created in a model or imported into it.

by showing how mark changes from the current one to a new one
- also the mark inheritance is shown for a tracked model object by showing the previously mark that the model object had

  • NC files tracking

- the application will read the files depending on the “XS_MIS_FILE_DIRECTORY” advanced option. So if this option is set the files will be loaded from the custom path, otherwise the files will be loaded from the model folder. The NC files will display their path in the position column and as a position type will use the “NC file” notation. They will use the same statuses as the model objects and their meaning will be the same, only that for a revised file a corresponding message will be shown in the changes column and not what actually was changed in the previous version of the file

Reports and user defined attributes

  1. Reports

The following 7 reports are installed with this extension:

  1. IssueToolAssemblyDrawingsReport - report for assembly drawings with changes (the assembly drawings must be created first)
  2. IssueToolAssemblyReport - report for assemblies with changes
  3. IssueToolCastUnitDrawingsReport - report for cast unit drawings with changes (the cast unit drawings must be created first)
  4. IssueToolCastUnitReport - report for cast units with changes
  5. IssueToolPartDrawingsReport - report for part drawings with changes (the part drawings must be created first)
  6. IssueToolPartReport - report for part with changes
  7. IssueToolRebarReport - report for rebar with changes
  1. User defined attributes
The changes are added in UDAobject property created by the user in order to widen the range of predefined object properties

User-defined attributes are used when the predefined object properties are not sufficient but more properties are needed. For example, comment, locked, and erection status are user-defined attributes.

's for every part, reinforcement and assembly.
Changes can be seen with Inquire Object

See also

Phase manager

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