Skip to main content

Solutions

Products

Recommended products

Questions? We are here to help.
Contact us

Purchase

Questions? We are here to help.

Resources

Transactions

TransEditor components

TransEditor typically has 4 components:
  • Name
  • Hierarchy
  • Conditions
  • Actions

Name

Each TransEditor needs to have a name. The name you enter for a TransEditor should be unique and descriptive.

Hierarchy

During transaction processing, Determination evaluates transaction data against TransEditors according to this list. (The 1st TransEditors in the list's read and applied before the 2nd TransEditor in the list's read and applied).
tip
You can change the order of the TransEditor in the
EDITORS
 list in
Configuration
Advanced Setup
TransEditors
.
TransEditors can be connected to one another with AND and OR operators. Connecting a TransEditor with AND establishes a parent-child relationship. In this relationship, the parent TransEditor's at a greater level than the child TransEditor. During transaction processing, the parent TransEditor needs to evaluate to true before any child TransEditors get evaluated.
In the
EDITORS
 list, a parent TransEditor is identified with a plus or minus icon, and each child TransEditor's hierarchically listed beneath the parent TransEditor.
TransEditors connected with OR establish an alternative. For example, you may want to evaluate the ship-to address based on the city or the ZIP Code. With OR, either TransEditor needs to evaluate to true before further evaluation or action's taken. For child TransEditors that are connected with OR, the parent TransEditor needs to evaluate to true before the child TransEditors are evaluated.
You can nest connected TransEditors to create deeper levels (for example, you can create an AND+AND+AND scenario). You can also mix AND and OR connectors for TransEditors (for example, you can create an AND+(OR+OR) scenario).

Conditions

Conditions test whether transaction data meets certain criteria. Conditions are sometimes referred to as if clauses because, if the conditions specified in the TransEditor match the transaction data then the actions specified in the TransEditor are taken on the transaction. If the conditions don't match, no action's taken. Typically, TransEditors include conditions and actions. You can, however, have TransEditors that have:
  • No conditions but 1 or more actions. This indicates that the actions are always performed. For example, you may want a TransEditor to set the line level ship-from location to Warehouse 1. In this scenario, the TransEditor has no conditions and only 1 action.
  • 1 or more conditions but no actions. This is common in AND scenarios. For example, you may want a TransEditor to evaluate the customer number and the line level ship-to state before further address evaluation occurs. In this scenario, the TransEditor has 2 conditions: 1 to evaluate the customer number and 1 to evaluate the line level ship-to state.
You can also connect conditions to other conditions with AND and OR. Connecting conditions with AND establishes a parent-child relationship, and connecting conditions with OR establishes an alternative. On the TransEditors page, child conditions have a number depth of the parent condition. For example, Condition 1 is the parent. Condition 1-1 is the 1st child condition and Condition 1-2 is the 2nd child condition.
During processing, a parent condition needs to evaluate to true before the child condition's evaluated. Conditions connected by OR evaluate to true if either condition evaluates to true.
Like TransEditors, you can nest conditions to deeper levels, and you can mix AND and OR connectors for conditions.
The Manual Reorder feature lets users reorganize conditions within the TransEditor interface. This feature is accessible when multiple conditions are present.
To use the Manual Reorder feature:
  1. Select
    Reorder
     in the TransEditor interface.
    • A tooltip labeled "Reorder" appears when you hover over the
      Reorder
       button.
    • The button is active only when multiple conditions exist.
  2. Complete both required fields:
    1. New Location*
      : Select the new location for the condition. If no new location is selected, an error message states "Condition is required".
    2. Position Number*
      : Enter the specific position for the condition. Use a whole number between 1 and 999,999,999.
    note
    • Both fields are mandatory, as indicated by the asterisk (*).
    • The Reorder button remains inactive until both fields are filled.
    • An error message appears if the number is 0 or exceeds 9 digits.
  3. After you complete both fields, the Reorder button becomes available.
  4. Select the Reorder button again to process the request. When the message "Conditions rendered successfully" appears, the process is complete.

Actions

Actions (or results or outcomes) set the value for an XML element when the conditions of a TransEditor evaluate to true.
The value can be:
  • A constant. For example, an action can set the line level CUSTOMER_NUMBER to 123.
  • The value for another element. For example, an action can set the line level IS_EXEMPT.ALL to true.
  • The value of an element after it's modified by a math expression. For example, an action can set the line level GROSS_AMOUT to GROSS_AMOUNT+USER_ELEMENT.ATTRIBUTE1.

Reorder actions in the TransEditor

The
Reorder
 feature lets you reorganize actions within the TransEditor interface. You can access this feature when multiple actions are present.
  1. Go to the TransEditor interface.
  2. Select
    Reorder
     to open the
    New Location
     window.
  3. Select the new location for the action from the dropdown list.
    Reorder
     now becomes active. If no new location is selected, an error message states "Action is required."
  4. Select
    confirm
     and process the reorder request. A success message "Actions reordered successfully" appears when you are done.
    note
    • Reorder
       remains inactive until the new location is filled, and only becomes active when multiple actions exist.
    • Reorder
       is grayed out if only 1 action is present.
    • You can hover over
      Reorder
       to read the tooltip.

This article applies to:

  • PRODUCT: ONESOURCE Determination,ONESOURCE Indirect Tax