Product
Support
Everything Else
AppleScript Changes in Helix 7.0
Introduction

This technote documents the changes made to the AppleScript Dictionary for Helix 7.0. Support for new features, bug fixes, terminology changes, and general improvements to the dictionary are divided by section.

The complete AppleScript dictionary for Helix 7.0.3 can be found here.

The complete AppleScript dictionary for Helix 7.0 can be found here.

The complete AppleScript dictionary for Helix 6.2 can be found here.

New Features

The following changes were made to support new features in Helix 7.0:

  • New properties for all Helix icons:
    • creation date: (read only) the date and time an icon was created. see technote
    • modification date: (read only) the date and time an icon was modified. see technote
    • user mode name: (read only) the name that appears in User mode. Essentially [Undefined ‘Custom Name’ becomes ‘Icon Name’]
  • New properties for collection and relation icons:
    • columns: which columns to display in list mode. See icon list columns enumeration for legal values. see technote
    • display order: three-level sort order in which icons are sorted in list mode. see technote
  • New properties for collection and user icons:
    • client idle timeout: minutes of idle before a client is automatically logged out. see technote
  • New properties for field icons:
    • index object: object ID for keyword field index.
  • New properties for data rectangles:
    • spell check: use macOS spell check to highlight misspelled words. see technote
  • New properties for data and label rectangles:
  • New properties for sequence icons:
    • on error behavior: how to handle an error in a sequence. see technote
  • New properties for view icons:
    • fit to page: scaled printing control. see technote
    • New options added to the quick query operators enumeration. see technote
Bug Fixes

The following changes were made to address existing bugs.

  • Correct an error message to properly refer to the modifying allowed parameter.
  • Improve the grammar of the error message when a dynamic popup is malformed.
Code Changes

The following Apple event codes were changed to address bugs or compatibility issues. Code changes require that compiled scripts that use them be recompiled.

  • The less than less than tile code is changed from lt<O to ltlO to avoid compilation errors.
  • The less than or equals less than or equals tile code is changed from le≤O to leeO to avoid compilation errors.
  • The less than or equals less than tile code is changed from le<O to lelO to avoid compilation errors.
  • The less than less than or equals tile code is changed from le O to lteO to avoid compilation errors.
  • The validation tile record (code Lnrs) is changed to tile validation (code nrsV) to resolve compile time conflict between it and the validation tile field property.
Terminology Changes

The following changes were made to terminology:

  • The validation tile record (code Lnrs) is changed to tile validation (code nrsV) to resolve compile time conflict between it and the validation tile field property.
  • The use specified document path property of the view class is deprecated. The document location property should be used instead. See document export options enumeration for legal values.
  • The display mode property for collection and relation windows now supports just two options: icon mode and list mode The new display order property controls sort order in list mode.
  • The document creation date time tile constant is changed to document creation date tile for consistency.
  • The document modification date time tile constant is changed to document modification date tile for consistency.
  • The followed/or tile constant is changed to followed or tile. AppleScript considers the / to be a division symbol and interpreted the old name as “(followed) / (or tile)” which is clearly nonsense.
  • The greater than or equal tile constant is changed to greater than or equals tile to be consistent with the rest of the ‘equals’ tiles.
  • The text extraction tile constant is changed to extract text tile for consistency.
  • The clear selections command constant is changed to clear selection command for consistency.
  • The export selected command constant is changed to export selected records command for consistency.
  • The delete selection command constant is changed to delete selected records command for consistency.
  • The post selections command constant is changed to post selected records command for consistency.
  • The clear selections command constant is changed to clear selection command for consistency.
  • The field delimiter property of the process ready record (legacy suite) changed to field delimiters to avoid terminology conflict with the view property that uses the same name.
  • The record delimiter property of the process ready record (legacy suite) changed to record delimiters to avoid terminology conflict with the view property that uses the same name.
  • The keyword starts with tile constant is changed to word starts with tile for consistency.
  • The keyword equals tile constant is changed to word equals tile for consistency.
Dictionary Improvements

The following improvements were made to the dictionary:

  • Improve description of the followed by tile constant.
  • Improve description of the followed or tile constant.
  • Improve description of the Undefined becomes tile constant.
  • Improve description of the use from tile constant.
  • Improve description of the direction enumeration.
  • Description of the not equals tile encoded so the symbol is displayed.
  • Description of the less than tile constant adjusted for conformity.
  • Description of the less than or equals tile constant encoded so the ≤ symbol is displayed. Description also adjusted for conformity.
  • Description of the greater than or equals tile constant encoded so the ≥ symbol is now displayed. Description also adjusted for conformity.
  • Description of the less than less than tile constant adjusted for conformity.
  • Description of the less than or equals less than tile constant encoded so the ≤ symbols are displayed. Description also adjusted for conformity.
  • Description of the less than or equals less than or equals tile encoded so the ≤ symbols are displayed. Description also adjusted for conformity.
  • Description of the less than less than or equals tile constant encoded so the ≤ symbols are displayed. Description also adjusted for conformity.
  • Improve description of the post selected record command.
  • Description of the close process (legacy enumerator) changed for clarity and grammatical consistency.
  • Description of the quick query expression record used by the quick query property of a view improved and expanded to support new operators.
  • Update descriptions of frame color and frame width properties of various rectangles to include information on where these are supported in macOS. (design suite)
  • Update description of the dividers property of the collection and relation classes to reflect that there are now up to eight columns available for collection and relation windows in list mode. (design suite)
  • Update description of the key property of the menu item class to reflect that Fkey range now extends to F19. (design suite)
  • Update description of the as parameter of the save options parameter to reflect that HFS- and POSIX paths are supported. (standard suite)
  • Correct description of the selection property to note that it works in more than collection and relation windows. (design suite)
  • Correct description of the background color property in various classes. (design suite)
  • Improve description of the object element of the tile class. (design suite)
  • Improve description of the allow click, allow tab, allow edit, and allow query properties of the data rectangle class.
  • Improve description of the after and at parameters of the add command. (design suite)
  • Improve description of the saving parameter of the close collection command. (design suite)
  • Improve description of the commit command. (design suite)
  • Improve description of the modifying allowed parameter of the login command. (design suite)
  • Improve description of the record id property of the retrieve data record class. (legacy suite)
  • Improve description of the check view state enumeration of the utilize command. (legacy suite)
  • Improve description of the get view summary enumeration of the utilize command. (legacy suite)
  • Change references to Mac OS X to the current version: macOS.
  • Correct miscellaneous typos, remove obsolete information.
Changes in Helix 7.0.2

These improvements appeared in Helix 7.0.2:

  • A view’s quick query can now be set or cleared.
  • AppleScript can now set the selection of a template editor window.
  • AppleScript can now set the selection of an abacus editor window, with two caveats:
    1. The selection property only resolves to icons or tiles. If the jog point or arrow of a tile is selected, it is the tile itself that is returned, and attempting to select a jog point or arrow results in the tile itself being selected.
    2. If an icon appears more than once in a window, set selection does not distinguish between instances, and only one of them is selected.
  • The legacy action check view state no longer returns an error when the optional sixth parameter is not included.
Changes in Helix 7.0.3

These improvements appeared in Helix 7.0.3:

  • View objects now include a control file existing property to support the new splitting of the If … Exists export functions.
  • Tile objects now include data type and potential data types properties:
    1. data type («property Lvty») returns the data type a specific tile outputs, based in its current inputs.
    2. potential data types («property Ipdt») returns a list of data types that a specific tile might return, when the result in undetermined.
  • The legacy action store records can now store data in a document field, by providing a full HFS path. (Storage type is determined by the field itself; a field set to ‘let me decide’ will store the document externally.) A sample script demonstrating this new feature is found on our sample scripts page.