OS X Compatibility Issue

R6903 refers to a bug that was found in Helix 6.1.6 and fixed in Helix 6.1.7. This technote addresses the underlying issue behind this problem.

Sequence that contain commands that “play the interface*” can hang, requiring the user to cancel the sequence or possibly to Force Quit. These problems are often inconsistent and difficult to reproduce. This is most pronounced in Helix Client/Server, where delays introduced by network latency or processing backlog add complexity.

* By “play the interface,” we refer to commands that mimic the actions a user can do to manipulate data on the screen, particularly at the field level, but also at the record level.

In the OS X world, mimicking user actions via a sequence is, in general, a bad idea. Helix supports this via these (and other) commands:

Field Level Actions:

• Clear
• Copy
• Cut
• Home Field
• Paste
• Tab Field
• Time Stamp

Record Level Actions:

• Clear Form
• Clear Selection
• Close
• Delete
• Enter (including Static Enter, Enter Override, Static Enter Override)
• Find {First, Next, Previous, Last}
• Keypress Enter
• Open (a view)

Sequences that use these commands have the potential for error. In OS X, Helix runs multiple processes concurrently (multithreading), and there are times when a field is not yet ready for an action that depends upon it. In situation such as these, a sequence that relies on direct field or record manipulation may report an error, or it may silently fail.

Although there is no perfect solution at this time, the best approach is to insert a Draw Screen command after ‘interface’ steps in a sequence. Any step that can cause a screen redraw is a candidate. The Draw Screen command tells Helix to explicitly wait until the entire form has been drawn before going on to the next step. This forces a delay equivalent to the network latency before going on the next step.

Another set of issues relates to enhanced OS-level capabilities — such as Full Keyboard Access — that are completely outside the control of the Helix collection designer. With no way of preventing the user from (accidentally or intentionally) modifying the interface, sequences that rely on Home Field/Tab Field commands to step through fields (i.e: “playing the interface”) in a specific order may fail.

Deprecated functionality is also an issue. For example, running under the Classic Mac OS, Helix can cut, copy, paste, or clear a value in a control object (i.e: radio button, checkbox, popup menu). OS X provides no such support, directly limiting Helix in this area. Of course, it is possible that a future revision of OS X will restore the Classic capability, but the larger point remains: relying on interface behavior to remain constant is not the best course of action.

Although there are instances where manipulating the interface is the only viable solution, we strongly encourage collection designers to look for alternative methods that avoid “playing the interface” to accomplish the tasks at hand. Posting — particularly in conjunction with a user-based global relation — is a better method of moving data from one record to another.