Hello!

Did you know that logged in users can see a lot more content?

Adding a help page for a custom component


Software version: Not version-specific

Last updated March 14, 2019 by Tekla User Assistance tekla.documentation@trimble.com

Environment: 
Not environment-specific

Adding a help page for a custom component

You can add your own custom help page for your custom components. The help pages are locally stored HTML files and displayed using the standard Tekla Structures help viewer using the built-in offline help featurepart of Tekla Structures functionality that is maintained and owned by Trimble Solutions and that is included in the Tekla Structures installation

when the F1 key is pressed in the dialog.

  1. Add a help url for your custom componentcomponent that the user creates and uses for creating model objects whose composition the user can modify as a group

    .
    1. Open the .inp file of your custom component in a text editor.
    2. Add the helpurl("unique_id") line to the file and replace unique_id with your own unique identifier. The identifier must not contain spaces and must be valid as a Windows file name. For example:
      page("TeklaStructures", "")
      {
          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.

      (1, "Balcony") { helpurl("mycchelp_balcony") tab_page("", "Picture", 1) {
  2. Create a HTML file with your help content.
    • You can write the content and code freely as required. The content may be rendered in Internet Explorer's compatibility mode when viewed through the Help Viewer. To prevent this, add the following as the first item in the <head> section of the HTML file:
    • <meta http-equiv="X-UA-Compatible" content="IE=Edge"/>
  3. Save the HTML file with your identifier as the file name and check the file extension:
    • For Tekla Structures versions 19.0 to 2016i, remove the file extension (.html, .htm, etc.) from the file name (the file name should contain only the helpurl value, for example, mycchelp_balcony).
    • Starting from Tekla Structures 2017, make sure the file extension is .html (e.g., mycchelp_balcony.html).
  4. Place the file in the correct folder:
    • In Tekla Structures 20.0 and later, the help viewer looks for these files in ProgramData\Tekla Structures\<version>\Help. In Tekla Structures 19.0 and 19.1, the Help folder is in the Tekla Structures installation folder.
    • Save the file in the language-specific folders in this location (for example, in folder enu for English). Add the file (or a translated copy) in the folder of all languages that will be in use.
    • For example, save the file as: ProgramData\Tekla Structures\2016i\Help\enu\mycchelp_balcony or ProgramData\Tekla Structures\2017\Help\enu\mycchelp_balcony.html

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: 
Average page rating: 5 (1 vote)
Refresh page after voting to show updated result.