Solibri API - Solibri Autorun Tasks

Solibri Autorun has a list of specific tasks which you can perform. These correspond to tasks you can do manually with Solibri Office. Most tasks have parameters you need to specify (for example, use the parameter file to specify the file path). Some parameters are optional, so you can leave them out if you don't need them.

The tasks you can perform with Solibri Autorun are:

• Model
  • openmodel
  • savemodel
  • closemodel
  • updatemodel
  • autoupdatemodels
• Classification
  • openclassification
  • closeclassification
• Checking
  • openruleset
  • openidsruleset
  • closeruleset
  • check
  • autocomment
  • resultsummaryreport
• Presentation
  • createpresentation
  • updatepresentation
  • bcfreport
  • generalreport
  • coordinationreport
• Information Takeoff
  • openito
  • closeito
  • takeoff
  • itoreport
• Other
  • exit

Here are the detailed descriptions of the tasks:

openmodel

• Opens the specified model(s). You can open the following file types:
• SMC: .smc
• IFC: .ifc, .ifczip, .zip
• PDF: .pdf
• DWG: .dwg

If you open an existing SMC model with Solibri Autorun, it may also include rules and rulesets, which are used in checking.

If you have selected a role to be used in Solibri, the role and the resources related to it, such as classifications and rulesets, are automatically loaded when you start Solibri. Thus, if you check a model using Solibri Autorun, these rulesets are also used in checking, in addition to the ones you may have opened with Solibri Autorun.

• Parameters:

• file: Specify the path to the model file(s). You need to list each individual model file.

  Example:

  <openmodel file="C:\Users\Models\ifc\MyModel.ifc"/>

• Optional parameters:

• discipline: Specify the model discipline.

  Example: <openmodel file="C:\Users\Models\ifc\MyElModel.ifc" discipline="Electrical"/>

  Possible disciplines in different languages are:

  EN	DE	FI	JP
  Air Conditioning	Klimaanlage	Ilmastointi	空調
  Architectural	Architektur	Arkkitehti	意匠
  Building Services	Gebäudetechnik	Talotekniikka	設備
  Cooling	Kühlung	Jäähdytys	冷却
  Electrical	Elektrik	Sähkö	電気
  Facility Management	Gebäudemanagement	Toimitilajohtaminen	施設管理
  HVAC	HKLSE	LVI	HVAC
  Heat	Heizung	Lämpö	暖房
  Inventory	Inventar	Lähtötieto	インベントリ
  Landscape	Landschaft	Maasto	造園
  Plumbing	Rohrleitungen	Vesi	配管
  Prefab Concrete	Betonfertigteile	Betonielementit	プレハブコンクリート
  Process	Prozess	Prosessi	プロセス
  Site Operations	Baustellenbetrieb	Rakennusaikaiset	現場作業
  Special Piping	Sonderrohrnetz	Erikoisputkisto	特殊配管
  Sprinkler	Sprinkler	Sprinkleri	スプリンクラー
  Steel Structure	Stahlkonstruktion	Teräsrakenne	鉄骨構造
  Structural	Statik	Rakenne	構造
  Ventilation	Lüftung	Ilmanvaihto	換気

• shortname: Specify the model short name.

  Example: <openmodel file="C:\Users\Models\ifc\MyElModel.ifc" shortname ="ELE"/>

• category: Specify the model categories. Models can be set to multiple categories. (Since: 9.12.8)

Example:

```
<openmodel
 file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Solibri building.ifc"> 
    <category>CATEGORY_NAME1</category>
    <category>CATEGORY_NAME2</category> 
</openmodel>
     
```

updatemodel

• Updates a specific IFC, PDF or DWG file included in the SMC model with a new file.
• PDF and DWG files Since: 24.0.1
• Parameters:
• file: Specify the file and the path to the file to be updated. The file must be included in the SMC model opened by the openmodel task.

• Optional parameters:

• with: Specify the path to the new version of the file.

• autoupdate: When true, model is updated only when the IFC, DWG or PDF file is newer than the previously imported version. When false, the model is updated unconditionally. (Since: 9.12.8)

• Examples:
• <updatemodel file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\SMC Building.ifc" with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\SMC Building - modified.ifc"/>
• <updatemodel file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\SMC Building.ifc" autoupdate="true"/>
• <updatemodel file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\SMC Building.ifc" with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\SMC Building.ifc" autoupdate="true"/>
• <updatemodel file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\SMC Building.ifc" />

autoupdatemodels

• Since: 9.12.8

<autoupdatemodels/>

• Updates all imported models that have a newer version on the disk.

updatepresentation

<updatepresentation/>

• Updates all presentations.
• Typically used after a model has been updated and rechecked.
• If there are new issues, they are added to the existing presentations.
• If an issue has been removed from the checking results, it's also removed from the presentation.

If you need to retain issues that are resolved from the checking results in your presentations then please do not use the updatepresentation command in your XML files, instead update these presentations manually.

openclassification

• Opens the specified classification(s).

• Parameters:

• file: Specify the path to the classification file(s). The file type must be .classification.

• Example: <openclassification file="C:\Users\Public\Solibri\SOLIBRI\Classifications\Space Usage.classification"/>

• To open a classification from an extension, use the following parameters:

• provider: Specify the folder name.
• resource: Specify the classification name.
• Example: <openclassification provider="COBie-UK" resource="/Classification/COBie Facility - Name.classification"/>

closeclassification

Since 9.13.5

• Closes the specified classification(s).

• Parameters:

  • name: Specify name to match the classification(s) to be closed.

• Examples:

• <closeclassification name="My Classification"/>
• <closeclassification name="* Classification"/>
• <closeclassification name="Classification ??"/>

openruleset

• Opens the specified ruleset(s).

• Parameters:

• file: Specify the path to the ruleset file(s). The file type must be .cset.

• Example: <openruleset file="C:\Users\Public\Solibri\SOLIBRI\Rulesets\Architectural Rules\BIM Validation 2004.cset"/>

• To open a ruleset from an extension, use the following parameters:

• provider: Specify the folder name.
• resource: Specify the ruleset name.
• Example: <openruleset provider="ADA and ABA" resource="/Ruleset/ADA and ABA Accessibility July 23 2004.cset"/>

openidsruleset

Since 9.13.8

• Opens an IDS file as a ruleset.

• Parameters:

• file: Specify the path to the IDS file. The file type must be .ids.

• Example: <openidsruleset file="C:\Users\Public\Solibri\SOLIBRI\Rulesets\Architectural Rules\Example.ids"/>

closeruleset

Since 9.13.5

• Closes the ruleset(s) that match specified name.

• Parameters:

  • name: Specify name to match the ruleset(s) to be closed.

• Examples:

• <closeruleset name="My Ruleset"/>
• <closeruleset name="* Ruleset"/>
• <closeruleset name="Ruleset ??"/>

check

<check/>

• Checks the model(s) specified in openmodel using the ruleset(s) specified in openruleset or openidsruleset.

autocomment

<autocomment/>

• Creates an issue slide and adds the default description to the Description field of each issue.

An issue is created for every checking result marked with the symbols:

, , or

The issue status is automatically marked as 'Undefined'.

• Optional parameters:

• zoom: The snapshots are zoomed in towards the components, when you insert the value TRUE.

  Example: <autocomment zoom="TRUE"/>

• maxsnapshotsincategory: Adds snapshots to the category level if the category has more issues than the limit specified in the value. Insert a numerical value.

  Example: <autocomment zoom="TRUE" maxsnapshotsincategory="5"/>

createpresentation

<createpresentation/>

• Creates a presentation from the issue slides added in autocomment.

bcfreport

• Creates a BCF report from the Presentation view.

• Parameters:

• file: Specify the path and the name for the report. The file type must be .bcfzip for versions 1 & 2 and it must be .bcf for versions 2.1 and 3.0.

• version: Specify the version of the BCF report. The version can be either 1 or 2, 2.1, 3.0.

• Examples:

• <bcfreport file="C:\SolibriAutorun\reports\SolibriBuilding_BCFReport.bcfzip" version="2"/>
• <bcfreport file="C:\SolibriAutorun\reports\SolibriBuilding_BCFReport.bcf" version="2.1"/>
• <bcfreport file="C:\SolibriAutorun\reports\SolibriBuilding_BCFReport.bcf" version="3.0"/>

resultsummaryreport

Since 9.13.5

• Creates a result summary report from the Result Summary view in Excel format.

• The file type can be .xls or .xlsx.

• Parameters:

• file: Specify the path and the file name for the report created by Solibri Autorun.

• templatefile: Specify the path and the file name for the template to be used when creating the report.
• title: Spefify the title of the report (If not given the template filename is used.)

• Example: <resultsummaryreport file="C:\SolibriAutorun\reports\Solibri Building_result_summary_report.xlsx" templatefile="C:\Users\Public\Solibri\SOLIBRI\Report Templates\Summary Report\CheckingSummaryTemplate.xlsx" title="Checking Summary"/>

generalreport

• Creates a report from the Presentation view in a PDF and/or RTF format.

• Parameters:

• pdffile: Specify the the file path and the name for the PDF report created by Solibri Autorun.

  Example: <generalreport pdffile="C:\SolibriAutorun\reports\SolibriBuilding_GeneralReport_PDF.pdf"/>

• rtffile: Specify the the file path and the name for the RTF report created by Solibri Autorun.

  Example: <generalreport rtffile="C:\SolibriAutorun\reports\SolibriBuilding_GeneralReport_RTF.rtf"/>

coordinationreport

• Creates a coordination report from the Presentation view in Excel format.

• The file type can be .xls or .xlsx.

• Parameters:

• file: Specify the path and the file name for the report created by Solibri Autorun.

• templatefile: Specify the path and the file name for the template to be used when creating the report.

• Example: <coordinationreport file="C:\SolibriAutorun\reports\Solibri Building_CoordinationReport.xlsx" templatefile="C:\Users\Public\Solibri\SOLIBRI\Report Templates\Coordination Report\CoordinationReportTemplateDetailedReport.xlsx"/>

openito

• Since: 9.12.8
• Opens the specified ITO file.

• Parameters:

• file: Specify the path to the ITO file. The file type must be .ito.

• Example: <openito file="C:\Users\Public\Solibri\SOLIBRI\Information Takeoff\Spaces.ito" />

closeito

Since 9.13.5

• Closes the Information Takeoff(s) that match specified name.

• Parameters:

  • name: Specify name to match the ito(s) to be closed.

• Examples:

• <closeito name="My ITO"/>
• <closeito name="* ITO"/>
• <closeito name="ITO ??"/>

takeoff

• Since: 9.12.8
• Calculates the ITOs with matching name if specified or calculates all ITOs if no name is specified.

• Example: <takeoff />

• Optional Parameter:

• name: Specify the ITO name.

• Example: <takeoff name="Spaces" />

itoreport

• Since: 9.12.8
• Creates a report of ITO results from Information takeoff view.

• Report can be created using an excel template or it can be a plain excel report.

Plain Excel Report

• If a specific ITO name is provided, then report is created for it. Else, it reports all ITOs.

• Parameters:

• file: Specify the path and the name for the report file. The file format must be .xls or .xlsx.

• Optional Parameters:

• name: Specify the ITO name.

• Examples:

• <itoreport name="Spaces" file="C:\Users\Public\Solibri\SOLIBRI\Samples\Spaces.xlsx" />
• <itoreport file="C:\Users\Public\Solibri\SOLIBRI\Samples\Spaces.xlsx" />

Excel Template Report

• The report is created using the excel template.

• The report file and template file must have same excel format, either .xls or .xlsx.

• If a specific ITO name is provided, then report is created for it. Else, it reports all ITOs.

• Parameters:

• file: Specify the path and the name for the report file.

• templatefile: Specify the path and the file name for the template to be used when creating the report.

• Optional Parameters:

• name: Specify the ITO name.

• reportTitle: Add a name for the report.

• Examples:

• <itoreport name="Spaces" file="C:\Users\Public\Solibri\SOLIBRI\Samples\Spaces.xlsx" reportTitle="Report" templatefile="C:\Users\Public\Solibri\SOLIBRI\Information Takeoff\Templates\Spaces.xlsx" />
• <itoreport file="C:\Users\Public\Solibri\SOLIBRI\Samples\Spaces.xlsx" reportTitle="Report" templatefile="C:\Users\Public\Solibri\SOLIBRI\Information Takeoff\Templates\Building Element Quantities.xlsx" />
• <itoreport file="C:\Users\Public\Solibri\SOLIBRI\Samples\Spaces.xlsx" templatefile="C:\Users\Public\Solibri\SOLIBRI\Information Takeoff\Templates\Building Element Quantities.xlsx" />

savemodel

• Saves the model as an SMC file.
• Parameters:
• file: Specify the the file path where you wish the file to be saved and the name of the file. The file type must be .smc.
• Example: <savemodel file="C:\SMCAutorun\models\SolibriBuilding_saved.smc"/>

closemodel

• Closes all models or a specified model which have been opened.

• Optional Parameters:

• Since: 9.13.8
• file: Specify the path and the name for single model to close.

• Examples:

• <closemodel/>
• <closemodel file="C:\Users\Models\ifc\MyModel.ifc"/>
• <closemodel file="*MyModel.ifc"/> * is a multiple character wildcard.
• <closemodel file="*MyModel-??.ifc"/> ? is a single character wildcard.

exit

<exit/>

• Closes Solibri and all models which have been opened.