AX1255

How action code processing executes

Action code processing can occur automatically when data is updated in a sheet, or "on demand" using special processing commands.

Automatic processing

Unnamed ActionCodes tags are processed automatically whenever one of the following events take place. This automatic processing occurs in all environments, including Axiom forms.

  • After refreshing Axiom queries on the sheet.
  • After a calc method is inserted or overwritten in the sheet.

NOTES:  

  • In the case of inserting or overwriting calc methods, only the affected rows are processed.

  • If an Axiom query is configured to refresh on open, only the action codes on the same sheet as the refreshed Axiom query will be processed.

  • Action codes are never automatically processed in file group templates. Once plan files are created from template, the action codes will be processed in the plan files.

Named ActionCodes tags (for example, [ActionCodes:MyName]) are always ignored during this automatic processing. Named tags can only be processed using manual processing.

Manual processing

Both named and unnamed ActionCodes tags can be processed manually using the following features:

  • Use the Process button on the Axiom Designer tab to manually process an individual ActionCodes tag, either named or unnamed. This feature is primarily intended for purposes of testing the action codes setup and not for regular processing. For more information, see Using the Axiom Designer tab. This feature is also available as a command (Process Single Action Code) that can be used in any custom ribbon tab.

    NOTE: This command can be used in file group templates to test action code setup.

  • Use the Process Action Codes command to trigger the processing of either all unnamed ActionCodes tags, or of a single specific named tag. This command can be used in Axiom forms or in custom task panes and ribbon tabs to provide on-demand action code processing. For more information, see Process Action Codes command.

Order of action code processing

Before any actions are performed, Axiom first identifies all ActionCodes tags that are currently eligible for processing in the sheet, and then identifies all actions associated with those tags. The tags eligible for processing depend on how processing is triggered, as discussed in the previous sections. It may be all unnamed ActionCodes tags, or a single named ActionCodes tag.

Once all actions for all eligible tags are identified, these actions are performed in the following order:

  • Copy actions
  • Lock actions
  • Unlock actions