Using Legato

The Legato Scripting Language and the IDE are included in all installations of GoFiler Complete. You may also download the Legato Interpreter for free as a standalone package below.

Legato Basic

https://www.novaworkssoftware.com/legato/current/legatobasic.zip

This package will allow you to run Legato scripts from a command line. Legato is free for development for personal or non-commercial use. By downloading Legato Basic, you agree to the Terms and Conditions of its use.

Revised: December 18, 2023

Legato Integrated Development Environment (IDE)

https://www.novaworkssoftware.com/legato/current/legatoide.zip

This package will allow you to write, debug and run Legato scripts from an IDE. Legato is free for development for personal or non-commercial use. By downloading Legato IDE, you agree to the Terms and Conditions of its use.

Revised: December 18, 2023

Legato Release Notes
Version 1.4g (12/18/2023)
GoFiler 5.21a

1.0 Legato Script Language Notes   

1.1  Script Engine Improvements and Changes

–  Added “Page revised yyyy-mm-dd” to SDK API reference pages. This note will be added as pages are changed or added. It does not indicate if the function was revised on that date but is fair indication that a change was made since the documentation was changed.

1.2  Function Improvements and Changes

Data Control

–  Improved the general internal interface such that internal error messages will not appear with bad parameters on calls. On error conditions, they will return codes that will in turn return error codes and conditions to API functions.

–  Improved error reporting on the DataControlGetRowData function. The function will now detect and set last error on an event.

Data Sheet Object

–  Added “Cell” key name to the DataSheetEnumerateNamedCells function returned table. The call references the cell address through Excel letter-number designations (i.e., “B7”).

–  Added options to address cells as int row column, string row column or string address for the following functions:

DataSheetGetCell

DataSheetGetCellAttributes

DataSheetGetCellAttributeString

DataSheetGetCellName

DataSheetGetCellText

DataSheetGetCellType

DataSheetGetColumnSpan

DataSheetIsCellDisabled

DataSheetIsCellHidden

DataSheetIsCellMerged

DataSheetIsCellNull

DataSheetIsCellProtected

DataSheetIsCellReadOnly

DataSheetMergeCells

DataSheetSetCellAttributes

DataSheetSetCellAttributeString

DataSheetSetCellDisabled

DataSheetSetCellHidden

DataSheetSetCellProtected

DataSheetSetCellReadOnly

DataSheetSetCellStyle

DataSheetSetCellText

DataSheetSetCellType

EDGAR

–  Add further validation types to the EDGARValidateValue function.

Forms View

–  Added a feature to the FormsViewOpenFile function to to allow for an empty source string with a template. This forces the function to create an untitled Form View using the specified template. This effectively mimics the equivalent of a ‘new’ form function.

Other

–  Added logic to test the number of dimensions for the array parameter on the ArrayToParameters, CSVArrayToString, DataSheetSetCellAttributes and ImplodeArray functions. Failure to use a single dimension array will now result in a run time error.

–  The EncryptAsAES and DecryptAsAES functions will now compare the output buffer size against the user supplied input size if given instead of the size of the input data.

1.3  New API Functions

Array Functions

–  ParametersToTable — Converts a parameter list into a table with optional delimiter string.

–  TableToParameters — Translates a table into a parameter style string.

Data Sheet Object

–  DataSheetGetCellStyle — Gets the CSS style for a specified cell.

Dialog Controls

–  ProgressControlSetRange — Sets the range of a progress control.

–  ProgressControlUpdate — Updates the position of the progress bar.

EDGAR Next

–  EDGARNextIsBetaEnabled — Tests whether the EDGAR Next feature is enabled.

–  EDGARNextIsAPISetup — Tests whether the EDGAR Next API credentials are available.

–  EDGARNextAPISubmit — Submits a file using the EDGAR Next API.

–  EDGARNextMakeAPICall — Makes a custom EDGAR Next API call.

–  EDGARSetUserCredentials — Sets EDGAR Next user credentials.