Dynamic Application Builder Release Notes, version 1.3.0

Version 1.3.0 of the "Dynamic Application Builder" adds proxy support for HTTP credentials, multiple new configuration options to the Export to SL1 step, two new pages that are accessible from the left navigation menu, and multiple quality-of-life changes.

  • Minimum Required SL1 Version: 11.3.0

The Dynamic Application Builder is part of the SL1 Studio suite of tools. For more information, see https://support.sciencelogic.com/s/sl1-studio.

Before You Install or Upgrade

  • Ensure that you are running version 11.3.0 or later of SL1 before installing Dynamic Application Builder version 1.3.0. You must also install Docker Desktop before installing the Dynamic Application Builder.

  • Before upgrading, close the Dynamic Application Builder application and verify that the Docker container is stopped.

For details on upgrading SL1, see the relevant SL1 Platform Release Notes.

Installation or Upgrade Process

To install the Dynamic Application Builder:

  1. See the Before You Install or Upgrade section. If you have not done so already, upgrade your system to the 11.3.0 or later release.
  2. Download the "Dynamic Application Builder" version 1.3.0 .zip file from the Support Site to a local computer.

Installation or Upgrade Process for Windows

  1. Click to run the file marked "DynamicApplicationBuilder-1.3.0.exe".

  2. The installer will place a file named "Dynamic Application Builder" in the Applications menu (Start > Applications > Dynamic Application Builder).

  3. If you upgraded from an old version, uninstall the old version of the Dynamic Application Builder from Programs and Features (Control Panel > Programs > Programs and Features)

  4. Click the "Sciencelogic Dynamic Application Builder" file in the Applications menu (Start > Applications > Dynamic Application Builder) to run the application.

Installation or Upgrade Process for OSX

  1. Click to run the file marked "DynamicApplicationBuilder-1.3.dmg".

  2. In the window that appears, drag the file into the Applications folder.

  3. If you are upgrading from an older version, click Replace in the modal that appears.

  4. Open the Applications folder and locate the Dynamic Application Builder.

  5. Click to open the Dynamic Application Builder.

See the manual Building Dynamic Applications for instructions on using the Dynamic Application Builder.

Features

Version 1.3.0 of the "Dynamic Application Builder":

  • Allows you to interface with your SL1 system to create PowerPack-able objects programatically.
  • Supports creation of Snippet Configuration Dynamic Applications.
  • Works on MacOS and Windows systems with the Docker Desktop or Docker CE applications.

Enhancements and Issues Addressed

The following enhancements and addressed issues are included in version 1.3.0 of the "Dynamic Application Builder":

  • Added proxy support for HTTP credentials.

  • You can now view the Dynamic Application Builder in dark mode by clicking the moon icon in the top right corner of the user interface. Once in dark mode, you can return to light mode by clicking the sun icon in the top right corner of the user interface.

  • If you have completed all required fields on a step of the Dynamic Application Builder, the Continue button at the bottom of the screen will now bounce to let you know you can proceed.

  • An arrow icon now appears at the bottom of the Dynamic Application Builder when there is more of the user interface to see. The arrow disappears when you reach the end of the page.

  • You can no longer select Discovery from the Class Type field on the Select Collection Object step. ScienceLogic recommends using SL1 to create discovery collection objects if needed.

  • Updated all checkboxes in all data grids in the Dynamic Application Builder to radio buttons.

  • You can now choose which HTTP method (Post, Push, Get, Patch, or Delete) you want to use for your endpoint from the HTTP Method drop-down field on the Retrieve Payload step of the Dynamic Application Builder.

  • Added the new Connection Timeout (ms) field to the HTTP and SSH forms on the Collect Credential step of the Dynamic Application Builder. The default value for this field is 3000.

  • Added a progress spinner to the Export to SL1 step of the Dynamic Application Builder to provide a visual cue that something is happening when you click the Export to SL1 button.

  • The Dynamic Application Builder now supports exporting Snippet Framework Configuration Dynamic Application types to SL1 instances of version 12.2 or later. If targeting an older SL1 version, a warning will appear to switch the Dynamic Application type.

  • The Retrieve Payload step now allows DATA or JSON payloads to be added to the "POST", "PATCH", and "PUT" HTTP Method types.

    JSON payloads require valid JSON bodies to be passed in. The Dynamic Application Builder automatically adds content-type:application/json so that you are not asked for additional headers. DATA parameter requests can be in any format (including JSON), but are not validated, and may require additional headers, depending on the endpoint.

  • When you edit a field on the Select Collection Objects step, the field will now be outlined in yellow until the changes are saved or discarded.

  • When you edit a field on the Define Dynamic Application step, the field will now be outlined in yellow until the changes are saved or discarded.

  • When you edit a field on the HTTP or SSH credential forms, the field will now be outlined in yellow until the changes are saved or discarded.

  • You can now edit existing Dynamic Applications after selecting them on the Define Dynamic Application step.

  • Added the new Verify SL1 Instance SSL Certificate toggle to the Export to SL1 step of the Dynamic Application Builder. Toggling on (blue) this option allows the SSL certificate of the SL1 instance to be verified during the export. If the verification fails, you are prompted to either cancel the export or retry without certificate verification.

  • Added the new Enable Export API Logging toggle to the Export to SL1 step of the Dynamic Application Builder, which allows you to enable logging when exporting a Dynamic Application from the Dynamic Application Builder.

  • Added the new Logs and Log Settings page to the Dynamic Application Builder, which allows you to enable API logging, define the logging level, and view logs from the last 30 days. The new page can be accessed by clicking the Logs icon in the left navigation menu of the Dynamic Application Builder.

  • Added the new Low Code Tools page to the Dynamic Application Builder, which displays snippet framework steps with expandable Sphinx documentation for each step. The new page can be accessed by clicking the Low Code Tools icon in the left navigation menu of the Dynamic Application Builder.

  • When you click one of the options in the left navigation menu, such as Low Code Tools, the page opens in a new window, and your progress in the Dynamic Application Builder does not change.

Known Issues

The following known issues affect version 1.3.0 of the "Dynamic Application Builder" PowerPack:

  • If the payload you attempt to fetch is too large, you may have difficulty rendering the entire payload on the “Select Collection Objects” screen. This could cause the page to load slowly, or some rows farther down the page not to load at all. The exact size of payload that causes this problem is currently unknown, but a fix for this issue is planned for a future release of the Dynamic Application Builder.
  • You can create credentials and Dynamic Applications with the same name, but if the duplicate name is selected from the auto-complete box, an error will occur, preventing you from creating the object. If you need to create an object with the same name as another, do not use auto-complete to set the name. Type the name in to avoid this error.
  • If you are on SL1 version 12.1.0, you will see the following traceback, which is a known Snippet Framework issue:

PermissionError: [Errno 13] Permission denied: '/tmp/collection_metrics.log'

90. During handling of the above exception, another exception occurred:

91. Traceback (most recent call last):

92. File "/opt/em7/lib/python3/silo_logs/silo_logging.py", line 163, in configure

93. _configure(*vargs, **kwargs)

94. File "/opt/em7/lib/python3/silo_logs/silo_logging.py", line 255, in _configure

95. configure_logging(configs, **kwargs)

96. File "/opt/em7/lib/python3/silo_logs/silo_logging.py", line 267, in configure_logging

97. logging.config.dictConfig(config)

98. File "/usr/lib64/python3.6/logging/config.py", line 802, in dictConfig

99. dictConfigClass(config).configure()

100. File "/usr/lib64/python3.6/logging/config.py", line 573, in configure

101. '%r: %s' % (name, e))

102. ValueError: Unable to configure handler 'metrics_file_handler_tmp': [Errno 13] Permission denied: '/tmp/collection_metrics.log'