hsbExporter (Video)

JS: 2017 and MM 2017-09-01
07-09-2017 JS: Imported Mellisa her text about Import Settings
How to create an Export/Group (Video)

cnc Exporter

(Back to top) 

*

This command allows you to export to the cnc exporter.

For export settings please read the ‘’Export to …..’’ document that is relevant to your exports.

  • Before you start exporting don’t forget to number all your entities --> hsbInOutput\Apply Numbering
  • Select the option hsbCAM\Element export\Cnc Exporter.


OR in the Ribbon


  • This will open the CNC Exporter dialog box.
  • Select all Entities in drawing option to export.
  • The destination location (default it will be stored in the folder where the drawing is situated)

Select all entities in drawing - This will generate your entire drawing.
Select floors levels in floor level list - This will generate the floor levels that you have picked in the floor level list.
Select floors levels by elements in drawing - This will generate the floor levels when you pick one of the elements in a certain floor level.
Select current floor level - This will generate the floor levels that you are in.
Select elements in drawing - This will generate all elements that you select.
Select entities in drawing - This will generate the selected entities.
Select entities inside xrefs -
  • Select a Cnc Group.
    Note: if this is the first time you are using the cnc Exporter you need to create a group first. (if you haven’t made a group yet see ‘’How to create an Export\Group in this document’’).
  • Deselect the Start generator in config mode (config mode means that the Export manager will open, in the Export Manager you can set all your settings and create a group, you don’t need to select the config mode (Export manager) all the time, once you have saved your settings Deselect this option.
  • Select the Destination location (default it will be stored in the folder where the drawing is located)
  • Select OK.
  • Your export file has been created in the folder of your destination.

How to create an Export/Group

(Back to top)
  • Select the option hsbCAM\Element export\Cnc Exporter OR in your Ribbon the CNC Export option. 
  • This will open the CNC Exporter dialog box. 
  •  Select any options that you want to export.
  • Select the ‘’Start generator in config mode’’ (this will open the Export Manager, see Export Manager)


Select all entities in drawing - This will generate your entire drawing.
Select floors levels in floor level list - This will generate the floor levels that you have picked in the floor level list.
Select floors levels by elements in drawing - This will generate the floor levels when you pick one of the elements in a certain floor level.
Select current floor level - This will generate the floor levels that you are in.
Select elements in drawing - This will generate all elements that you select.
Select entities in drawing - This will generate the selected entities.
Select entities inside xrefs - 

  • Select OK.
  • The ExportManager dialog box has opened.
  • Now we need to create an export, select the Create Export button.


  • The Export dialog box will appear. 
  • Fill in all the necessary information and select OK.

(Example)

Name
– Enter a name for the project.
Description – Enter a description for the project.
Export (pull down menu) – Select a machine to export to.
Last Used (pull down menu) – Catalog Entry (More explanation in Export_Settings">Export Settings)
Output location – Select the destination folder by selecting the triple dots (default it will be stored in the folder where the drawing is located)
Clear output location - This clears the whole folder.

  • Once you have created an export we now need to Create a group.


  • Right click the word Groups on the left hand side of this screen and select Create Group.


  • Give this Group a name, we have called it WUP (example)


  • Now we need to add the WUP (example) settings to this group.
  • Add your WUP Settings to this Group by right clicking the Name (WUP) and select Add to/BTL (this is the group name you have just created).


In the export manager you can Edit/Delete/Export and import settings, more on this in the Export Manager Chapter.

How to Export a file

(Back to top)
  • Now run the command again (hsbCAM\Element export\Cnc Exporter) and select the Cnc group you’ve just made.


  • Select OK.
  • The ExportManager will open, select the Group name you want to export (in this case it is called WUP)
  • Select the Run button.


  • The Export Status dialog box will open and show you a report.

Settings Tab

(Back to top)

For each export the Settings tab will be different. 

See the approperiate document for more explanation.  "Export to …..’’ documents.


Custom Tab

(Back to top)

 In the Custom tab you can add extra settings, like Beam Filter.


Once you have set everything in the Setting/Custom tab you can save these settings and recall them later on in the Export Settings dialog box. (See ‘’Save your Settings’’)


Save your Settings

(Back to top)

Once you have set everything in the Setting/Custom tab you can save these settings and recall them later on in the Export dialog box.

  • Select the New button and the Catalogue Entry dialog box will open, enter a specific name to your settings.
  • Select OK and the Entry will appear in the Export Settings dialog box.
  • You can create several exports if you want.

Export manager

(Back to top)

Create Export
Edit
Copy
Delete
Run
Tools


Create Export
– Select if you want to make a New Export.
Edit – Select if you want to Edit your Export.
Copy - Select if you want to copy an export.
Delete – Select if you want to delete an Export.
Run – Select to export your project. (default it will be stored in the folder where the drawing is located)
Tools – If you want to export or import your settings. You could export your Settings and then send them to somebody who only has the Standalone cnc Exporter and import these Settings.

Export Settings

(Back to Top)
(Export manager)

When you want to export ALL you export Settings, this can be done by selecting the Tools pulldown. You could export your Settings and then send them to somebody who only has the Standalone cnc Exporter and import these Settings.



*

These settings are saved in C:\Program Files\hsbCAD\hsbcad20...\Content\Dutch\hsbCompany\Export\Content settings

How to import the hsb Content Export Settings
Type of Extensions

 

How to import the hsb Content Export Settings (Video)

(Import Settings)

With the commando Exporter, you will launch the CncExporter it will open the dialogbox hsbExportManager, here you can create, edit, copy, run or delete your Export.
To launch the Exporter run the command ‘hsb-CNCExporter' or select Exporter in the hsbOutput Ribbon.  



To use the exporter, all beams and sheets should be numbered.  
  • Select the Exporter button in the hsbOutput Ribbon   
  • Select Tools.
  • Select Import Settings.
  • Select the Content Settings in the Program Files
  • ...\Program Files\hsbcad\hsbcad2017\Content\Dutch\hsbCompany\Export\Content settings
e.g.Excel.settings
e.g.ifc.basisafspraken.settings
e.g.pdf.settings

 

How to Use Extension Prompt
(Import Settings)

With the commando Exporter, you will launch the CncExporter it will open the dialogbox hsbExportManager, here you can create, edit, copy, run or delete your Export.
To launch the Exporter run the command ‘hsb-CNCExporter' or select Exporter in the hsbOutput Ribbon.



To use the exporter, all beams and sheets should be numbered.  

Select the Exporter button in the hsbOutput Ribbon
  • Select the selectionmode for your data.
  • Change the destination folder to the desired place.
  • Click Ok.

  • A list with all the exports will pop-up.
  • Select the export you need to change and click on Edit.

  • Click on the 3dots to edit the export.  
  
  • Choose for Custom and click on Add.

  • A list with all the Extension Prompts is visible.
  • Choose the Extension you need
  • Click on Select.

  • A diaolog box will open in the export Settings. Adjust the information as needed.
  • e.g. Convert Sheets into Beams.
  • Name = 'hsbcad material name'
  • Zone Index = The zone the sheeting belongs to.



Type of Extensions

(Back to Top)
(Import Settings)




Alias Manager

(Back to top)
(Export manager)



Data formatting in the exporter

(Back to top)

In the exporter you can use variables, these can be properties of Objects, Elements or Project settings.

The format string is made up of constant text and variables. The variables take the form: @(<VariableName>)

The variable names directly relate to the property names so any string, number, enumeration or Boolean property can be specified. If the variable name cannot be found it will not be resolved and will stay inside the format string unchanged.

E.g. for a Beam using a format string of "@(Length) x @(Width) x (@(Height)" would use the Length, Width and Height properties of the beam.

There are also a set of variable names that provide special functionality.

Example Variables


Variable Description
ElementNumber The number of the element.
ElementType The type or code of the element.
ElementLength The length of the element calculated using the bounds of the GenBeams in the element rounded to zero decimal places.
ElementHeight The height (dimension in the elements Y direction) of the element calculated using the bounds of the GenBeams in the element rounded to zero decimal places.
ProjectNumber The number of the project as defined in the project setttings and ProjectInfo class.
ProjectName The name of the project as defined in the project setttings and ProjectInfo class.
ProjectDir The project directory.
ProjectComment The comment as defined in the project settings.
ProjectCity The city as defined in the project settings.
ProjectDwgName The name of thw dwg file.
ProjectRevision The revision as defined in the project settings.
ProjectStreet The street as defined in the project settings.
ProjectUser The user as defined in the project settings.
ProjectCompany The company path in the project settings.
ProjectWallDetailPath The wall detail path in the project settings.
ProjectFloorDetailPath The floor detail path in the project settings.
ProjectDirName The name of the folder where the source drawing file is located.
GroupName The name of group. When used on child Entity it will be the name of the first deliverable group the Entity belongs to.
GroupFileName This is the same as GroupName except the name of the groups is changed so that the '\' delimiters are replaced with '_' characters so the output can be used as part of a file name.
GroupLevel1 The first part of the hsbCAD group path.
GroupLevel2 The second part of the hsbCAD group path.
GroupLevel3 The third part of the hsbCAD group path.
GroupEquivalentStory GroupStory Group Equivalent Story.
GroupFloorHeight GroupHeight Group Floor Height.

Formatting Functions

There are a number of functions that can be used to format string values.

E.g. to take the last two characters from the element number: @(ElementNumber:R2)

Possible functions are:

(Back to top)
A Aliases: Aliases allow values to be replaced with another value, an alias.
R Right: Takes the specified number of characters from the right of the string.
L Left: Takes the specified number of characters from the left of the string.
PL Pad left: Pads the string to the left the specified number of characters with an optional parameter to specify the character to pad with.
PR Pad Right: Pads the string to the right the specified number of characters with an optional parameter to specify the character to pad with.
RL Round Local Settings: .... 
RR Regex Replace: .... 
RX Regex: .... 
S SubString: Given one number will take all characters starting at the position (zero based).Given two numbers will start at the first number and take the second number of characters.
T Tokeniser: Returns the member of a delimited list using the specified index (zero based). A delimiter can be specified as an optional parameter with the default delimiter being the semicolon character.
U Upper: Converts the string to upper case.
# Rounds a number. Specify the number of decimals to round to. Trailing zero's are removed.

A - Aliases

(Back to Possible functions are:)

 

Aliases allow values to be replaced with another value, an alias.
The aliases are stored in files inside the company folder.
There is a global file called Aliases.dat and custom files can be added with the convention of <Name>Aliases.dat.
e.g. Mat2packAliases.dat.

An alias is made up of:

  • Expression – what is being mapped to. This can contain the wild card character '*' to represent zero or more characters.
  • Text – the value being returned if the expression is matched.

e.g.
Expression = "*ground*"
Text = "GF"

This would match the following  "01-Wall Frame\00-Ground Floor"  and "GF" would be the result.


This is implemented inside the formatting as an Alias string function.
e.g. Assuming the global aliases are being used:

@(GroupName:A) would look for an alias of the group name.

To use a custom alias file a parameter is specified.
e.g. using the custom "Test" alias (file name is TestAliases.dat)

@(GroupName:A;Test)


R-L-S-T-U-PR-PL

(Back to Possible functions are:)

Given a group name of "Wall Frame\Floor\Walls"

@(GroupName:L5) = "Wall Frame"

@(GroupName:R5) = "Walls"

@(GroupName:S7) = "Floor\Walls"

@(GroupName:S7;5) = "Floor"

It is also possible to chain them together.

@(GroupName:S7:R5:U) = "WALLS"

@(GroupLevel3:PL7) = "  Walls"

@(GroupLevel3:PR7;x) = "Wallsxxx"

@(GroupName:T1;\) = "Floor"

e.g. Given a beam with a solid width of 29.499765 mm

@(SolidWidth:0) = “29”

@(SolidWidth:1) = “29.5”

@(SolidWidth:2) = “29.5"


RX - Regex

(Back to Possible functions are:)

If Information property is set to: Lion,Tiger,Frog
The following regex will return the following result:

@(Information:RX0;"([^,]+),") => Lion
@(Information:RX0;"([^,]+)(,)";"$1") => Lion // group index 1
@(Information:RX0;"([^,]+)(,)";"$2") => , // second index group
@(Information:RX0;"([^,]+)(,)";"$3") => $3 // $3 not found, so not substituted
@(Information:RX0;"(?<key>[^,]+)(,)";"${key}") => Lion
@(Information:RX1;"(?<key>[^,]+)(,)";"${key}$1") => Tiger, // because first group is named, group index 1 is,



PropertySets and MapX

(Back to top)

Propertysets are groups of Properties that are added to objects.

MapX is a map (like a set of properties) that is available in the exporter.
MapX and PropretySet data can be accessed by simply specifying the path to data in the underlying map starting with the MapX key or PropertySet name.

The MapX data will take precendence over the PropertySet data.

     e.g. An entitty has MapX data with a key of "Hsb_ElementInfo" which contains a value "Weight".
This could be accessed using the format:

@(Hsb_ElementInfo.Weight)


The path for MapX data can go as deep as necessary.

    e.g. @(Key.SubMap1.SubMap2.SubMap3.ValueKey).

Drawing Pr​​​operties

The Drawing Properties are specified as:

@(DrawingProperties.Title)
@(DrawingProperties.Author)
@(DrawingProperties.Subject)
@(DrawingProperties.KeyWords)
@(DrawingProperties.Comments)
@(DrawingProperties.LastSavedBy)
@(DrawingProperties.RevisionNumber)
@(DrawingProperties.HyperLink)

 Custom properties are access the same way:

@(DrawingProperties.<CustomPropertyName>)

e.g. @(DrawingProperties.HOI)

Standard names will always take precedence over customer ones, and the names are not case sensitive


Feedback and Knowledge Base