Create LiveReport

  • Updated on Jun 2, 2025
  • Published on Feb 10, 2025
  • 4 minute(s) read
  • CW
 Prev Next

In this tutorial you will learn how to create a new LiveReport with the Connector with data coming from several data sources. It is divided into two steps for simplification.

Topics covered:

  • Create LiveReport component
  • Basic reporting and error management using HTML Report Writer and Display Error components
  • Registration of protocol in LiveDesign
  • Change of parameters for a registered protocol in LiveDesign

Single data source

Create protocol in Pipeline Pilot

  • Create the new protocol

    • Open the Pipeline Pilot client.
    • Create a new protocol.
    • Save it somewhere in Protocols as "Create a LiveReport". Your personal space is not accessible from the gadget.

  • Get data from an example data source

    • Add the MAO Reader component from the BIOVIA Chemistry collection to your protocol.
    • As this is a tutorial, it is recommended to set the Maximum parameter to a small value like 100 to avoid to create too many compounds in LiveDesign and wait to much.

  • Add extra calculation on your inputs records

    • Add the Identify Salts component from the BIOVIA Chemistry collection to your protocol.

  • Push the records into a new LiveReport

    • Add the Create LiveReport component to your protocol.
    • Promote the LiveReport Name parameter to the protocol level and uncheck "Promote entire group".
    • On the promoted LiveReport Name parameter, simplify the help text to "Name of the new LiveReport.".
    • Promote the Project ID parameter to the protocol level.
    • Promote the Folder ID parameter to the protocol level.
    • Set the LiveReport Name Is Unique parameter to True.

  • Add reporting information

    • Add a Range Filter component from the BIOVIA Generic collection to your protocol and set the List parameter to 1 to keep only one record.
    • Add a Text component from the BIOVIA Reporting collection to your protocol and set the Text parameter to 'The LiveReport "$(LiveReport Name)" has been created with ID '.%'LiveReport ID'.' in project $(Project ID).'.
    • Add a HTML Report Writer component from the BIOVIA Reporting collection to your protocol and set the Destination parameter to $(JobDir)/output.html.
    • Pipe a Display Error component to the fail port of the Create LiveReport component.

Create LiveReport protocol

Register protocol in LiveDesign

  • Open the registration menu

    • Open LiveDesign and the gadget.
    • Click on the icon in the gadget menu. You can see it only if you are gadget administrator.

  • Select the protocol

    • Browse the tree of Pipeline Pilot protocols.
    • Select the previously created "Create a LiveReport" protocol.

  • Define the inputs

    • Change the type of the LiveReport Name parameter from LiveReport to Text.
      • By default the gadget applies the type LiveReport to a parameter of Pipeline Pilot type StringType containing "LiveReport" in its name. This type allows the user to select an existing LiveReport and to send its identifier to the protocol. Here it is not the appropriate type as the LiveReport does not exist. We want its future name and not its current identifier.
    • Change the type of the Folder ID parameter from Number to Hidden (this will be used later in the Use REST API Resource tutorial).
    • Click on "Next".

  • Create the menu item

    • Select the location of the protocol in the menu. If needed you can create another folder or subfolder.
    • If needed set the draft mode to hide the protocol from non-administrator users.
    • Click on "Add".

Register create LiveReport protocol

Test protocol in LiveDesign

  • Select the newly registered protocol
    • Select the "Create a LiveReport" protocol in the gadget menu. If it has been saved in draft mode, the name of the protocol will be in italic and an icon will be in front of it.
  • Fill the form
    • Set the name of the LiveReport that you want to create in the field LiveReport Name.
    • Set the identifier of the project in which you want to create your LiveReport in the Project ID field.
    • Click on "Submit".
  • Check the results
    • In the gadget, a sentence should remind the project in which the LiveReport has been created, its name and its identifier.
    • A new LiveReport containing MAO data should be available in LiveDesign.

Several data sources

Edit protocol in Pipeline Pilot

  • Get data from another example data source

    • Pipe the LogPData Reader component from the BIOVIA Chemistry collection to the input port of the Identify Salts component.
    • As this is a tutorial, it is recommended to set the Maximum parameter to a small value like 100 to avoid to create too many compounds in LiveDesign and wait to much.

  • Add filters on the data sources using protocol parameters

    • Create two parameters Load MAO Data and Load LogP Data of type BoolType at the protocol level.
    • Add input ports to MAO Reader and LogPData Reader components and pipe Custom Filter components with respectives expressions @'Load MAO Data' and @'Load LogP Data'.

  • Add protocol help text

    • Set the protocol help text to something relevant like "Optionally loads MAO and/or LogP data in a new LiveReport of a given project."

Create LiveReport protocol

Re-register protocol in LiveDesign

Once a protocol is registered in the gadget, if you want to change the input parameters, the protocol must be deleted from the gadget and registered again.

  • Delete previously registered protocol

    • Open LiveDesign and the gadget.
    • Click on the icon in the gadget menu to manage the registered protocols.
    • Look for the previously registered "Create a LiveReport" protocol and click on the icon to delete it.
    • Click on "Save Menu".

  • Register again the protocol as described in the Register protocol in LiveDesign section.

    • Check that the type of Load MAO Data and Load LogP Data input parameters is Yes/No Toggle.

Register create LiveReport protocol