JSL File manager Brady Brady and Don Mccormack, JMP

Motivation Why build this thing? Most file management relies on organizing work in operating system directories. This approach is suboptimal because: Over time, directory organization may grow unpredictably making it difficult to change, rename, move, merge, or split directories. Deeply nested directories make it difficult to know what’s in them. All you may know is the file name and type unless you open the file (e.g., very little metadata is available). Cross-referencing is typically achieved by keeping multiple copies or by using alias. Neither of these methods works well What’s the most recent copy? Where are they all? Aliases break when the original file is moved (PC) or can be as much as 100X larger than the original file (Mac).

Create a JSL Add-In that: Motivation The Solution Create a JSL Add-In that: Works for multiple file types. Is easy to maintain. Displays important metadata for any file through an interactive searchable interface. Lets the user add/change metadata and add files. Requires a minimal amount of user set-up.

File Metadata “View” tab selected File parameters, scanned in from files: Number of rows, columns, scripts, etc. Scripts Scripted platforms Path Controlled, “fixed-vocabulary” fields: Changed via cascading drop-downs Free text fields: Changed via text edit boxes

File Metadata “EDIT” tab selected File parameters, scanned in from files: Number of rows, columns, scripts, etc. Scripts Scripted platforms Path Free text fields: Changed via text edit boxes Controlled, “fixed-vocabulary” fields: Changed via cascading drop-downs

AutoRun Avoidance Disabling “On Open” Scripts in Datatables Get current preference, then set to suppress “On Open” scripts in datatables: Use << On Close () to restore original preference when main window closes:

Displaying scripts: use Load Text File ( ) + put into Script Box: Autorun Avoidance Circumventing “//!” In .jsl files Displaying scripts: use Load Text File ( ) + put into Script Box:

Updating Metadata: if present, leave !// at top: Autorun Avoidance Circumventing “//!” In .jsl files Updating Metadata: if present, leave !// at top:

File Metadata Loading / Saving Changes are written directly to the File Properties data table and the file itself; no need for a subsequent re-scans unless data is changed. Source file (.jmp, .jrn or .jsl) is opened as hidden, then modified with new metadata entries and saved off. Data tables use a table variable Journal uses a textbox within a hidden outline box Scripts use a commented section

For each metadata property (i.e., Industry, Topics, etc.): File Metadata Loading / Saving For each metadata property (i.e., Industry, Topics, etc.): Property name is between <<NameBeg>> and <<NameEnd>> delimiters Property value is between <<TextBeg>> and <<TextEnd>> delimiters

File Metadata Loading / saving

Finding Scripts Within Files Text tools used Character functions Contains ( ) Char ( ) Insert Into ( ) Length ( ) Substitute ( ) / Substitute Into ( ) Substr ( ) Uppercase ( ) Journal Messages jrn << Get Journal Data Table Messages dt << get Table Script Name ( ) dt << get Table Property ( )

Finding Scripts Within Files Within a datatable, scripts are stored as table properties. Within a journal, scripts reside in Button Boxes.

Finding Platforms Within Scripts Fit Model and DOE require special processing

Platforms / Personalities Fit model personalities and Doe Platforms

Summarizing Multiple Responses Goal: extend Summary platform functionality to work with Multiple Responses.

Summarizing Multiple Responses (Before)

Summarizing Multiple Responses (After)

cOmplex Row Selection You can use a Local Data Filter, with or without an associated platform, to avoid querying with complicated WHERE clauses:

Using Hidden Output

Using Hidden Output

Modifying The Current row selection When you construct a WHERE clause interactively, the Select Rows dialog gives 3 options for dealing with currently selected rows: Clear them (Start over) Extend from them (logical OR) Select from them (logical AND) JSL will not support these options until V12.

Modifying The Current row selection You can achieve the same results by combining row selection messages in various ways: << Select Where ( logical expression ) Clears present selection, then selects rows meeting the condition. << Get Rows Where ( logical expression ) Returns a vector of the row numbers of the rows meeting the condition. << Clear Select Deselects all rows. << Select Rows ( vector of row numbers ) Selects rows whose row numbers the vector contains, without clearing the present selection.

Modifying The Current row selection JSL equivalents for the ‘Select’ Dialog’s options

Manipulating journals Use display tree messages to: Close and de-select all outline boxes Highlight desired button boxes and open ancestors Messages used: << select << deselect << top parent << close << get button name << parent << class name

Manipulating Journals “zipping up” a journal

Manipulating Journals Finding and Surfacing buried scripts First, select all buttons containing the desired scripts:

Manipulating Journals Finding and Surfacing buried scripts Next, move up parent by parent, opening each, until you reach the top:

Cascading menus Data table houses the hierarchy Built using a series of associative arrays: Read 2 columns from a table The first holds choices for one drop-down menu The second holds choices for its “child” menu When a selection is made, update any descendant drop-downs

Cascading menus Tools used Associative Arrays Associative Array ( ) << get values << get keys Data table messages dt << select where dt << get rows where column << set selected Display box messages ComboBox << get ComboBox << set items TextBox << set text