Solibri API - Getting Started with Solibri Autorun

Solibri Autorun is an extension to Solibri Office for automating routine tasks. With the extension, tasks such as running checks, exporting the found issues as BCF files and creating presentations, are pre-defined in an XML file, which is given as a command line argument or scheduled task for Solibri to execute. As a result, you have your daily model checking done, for example, overnight, and you can focus on issue handling and quality coordination.

An XML file is an XML (Extensible Markup Language) data file. It is formatted much like an HTML document, but uses custom tags to define objects and the data within each object. XML files can be thought of as a text-based database. You can edit the XML files using any text editor, such as Notepad or Notepad++.

Solibri Autorun needs a local path to the files to open and where to create reports. If the cloud service has a shared folder, Solibri Autorun can be pointed to this folder and used with the cloud service.

Solibri Autorun Examples

Three different use cases are explained here and the same use cases guide and the example xml files can also be downloaded from here. You can use these for practising the use of Solibri Autorun, but please ensure that the file paths are correct.

Example 1

This XML file includes the tasks to:

  1. Open an SMC model.
  2. Update the IFC model files included in the SMC model.
  3. Save the updated SMC model with the same name.
  4. Exit Solibri.
<?xml version="1.0" encoding="ISO-8859-1"?>
<batch name="Simple Batch" default="root">
<!-- This is the starting task -->
<target name="root">

<openmodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\models\Solibri model.smc" />

<updatemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Solibri building.ifc"
    with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Solibri building.ifc"/>

<updatemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Solibri Building Structural.ifc"
    with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Solibri Building Structural.ifc"/>

<updatemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Ground_Floor_Vent.ifc"
    with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Ground_Floor_Vent.ifc"/>

<updatemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\First_Floor_Vent.ifc"
    with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\First_Floor_Vent.ifc"/>

<updatemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Second_Floor_Vent.ifc"
    with="C:\Users\Public\Solibri\SOLIBRI\Samples\ifc\Second_Floor_Vent.ifc"/>

<savemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\models\Solibri model.smc" />

<exit />
</target>
</batch>

Example 2

This XML file includes the tasks to:

  1. Open an IFC file.
  2. Open a classification.
  3. Open a ruleset.
  4. Check the model.
  5. Add issue slides with a description and a snapshot zoomed to the relevant component.
  6. Create a presentation from the slides created.
  7. Create a BCF report from the Presentation view.
  8. Save the model as an SMC file.
  9. Close Solibri.
<?xml version="1.0" encoding="ISO-8859-1"?>
<batch name="Simple Batch" default="root">
<!-- This is the starting task -->
<target name="root">

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

<openclassification
    file="C:\Users\Public\Solibri\SOLIBRI\Classifications\Building Elements - General.classification"/>

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

<check />

<autocomment zoom="TRUE" />

<createpresentation />

<bcfreport
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\reports\Found issues.bcfzip" version="2" />

<savemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\models\Solibri model.smc" />

<exit />

</target>
</batch>

Example 3

This XML file includes the tasks to:

  1. Open an SMC model.
  2. Update an IFC file included in the SMC model.
  3. Check the updated model.
  4. Add issue slides with a description and a snapshot zoomed to the relevant component.
  5. Update a previously created presentation with the new checking results.
  6. Create a BCF report from the Presentation view.
  7. Save the SMC model.
  8. Close Solibri.
Important 5. Update a previously created presentation with the new checking results.
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.
<?xml version="1.0" encoding="ISO-8859-1"?>
<batch name="Simple Batch" default="root">
<!-- This is the starting task -->
<target name="root">

<openmodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\models\Solibri model.smc" />

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

<check />

<autocomment zoom="TRUE" />

<updatepresentation />

<bcfreport
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\reports\Found issues.bcfzip    
    version="2" />

<savemodel
    file="C:\Users\Public\Solibri\SOLIBRI\Samples\models\Solibri model.smc" />

<exit />

</target>
</batch>

Using Solibri Autorun with a Borrowed License

You can use Solibri Autorun with a borrowed license. Note that you need to have at least five days left of the license borrowing. Otherwise, a dialog stating “Borrowed license is going to expire in X days.” opens, and this prevents Solibri Autorun from starting.