---
schema_version: "1"
id: 7419470f1ce0d732703ebddd33902837730ec9d7184ba04e1d49659004581b03
title: Orchestration Items
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/comms_t_orchestration_items_231391.md
canonical_url: https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_items_231391.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: d9f9daecedc6dae086b5b8e4197b13f21b2f77f1d5df3d4aa2f2568f09723987
description: Orchestration items represent the tasks and activities in an orchestration plan that are performed during the order process, and they are grouped by an orchestration plan definition.
products:
  - Industry Solutions
  - Cross Cloud
release: "264"
---
# Orchestration Items

Orchestration items represent the tasks and activities in an orchestration plan that are performed during the order process, and they are grouped by an orchestration plan definition.

At runtime, orchestration item definitions become orchestration items, and the orchestration execution engine monitors their state. The state process flow for orchestration items is shown in the diagram:

![orchestration items process state flow](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-order_management-264-0-0-production-enus/c2040b01-aade-4ba7-8a7d-d7cd745d5c8c/order_management/images/om_orch_item_states.png)

To see examples and descriptions of orchestration item states, see [Orchestration Item States](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_states_231740.htm&release=264.0.0&type=5 "Each orchestration item in an orchestration plan is given a color that indicates its state. You can glance at the orchestration plan to get an idea of the states of the items in that plan.")

The behavior of an orchestration item is defined by an item type (to learn more, see [Orchestration Item TypesOrchestration Item Types](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_types_231420.htm&release=264.0.0&type=5 "Orchestration plans use orchestration item types to define actions for orchestration items. Actions are triggered when an item reaches the Ready state.")). Items execute when all of their dependencies and conditions are met.

You can define dependencies and conditions in the **Orchestration Item Definition Detail** page.

![An Orchestration Item with Dependencies and Conditions selected](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-order_management-264-0-0-production-enus/c2040b01-aade-4ba7-8a7d-d7cd745d5c8c/order_management/images/om_orch_item_details.jpg)

As shown in the figure above, you can define:

- Orchestration item conditions that evaluate attributes or fields on the product or order entity.
- Orchestration item dependencies to sequence the task within its orchestration plan definition or among orchestration items from other orchestration plan definitions.

You cannot reuse orchestration items between plans. However, you can specify dependencies between items that belong to different plans.

As a best practice, Salesforce recommends creating all plans and orchestration items first, then specifying dependencies between them. To create a reusable orchestration item, for example, complete order, you can create a plan with only one orchestration item and reuse the plan as needed.

Orchestration items reach a Ready state and are executed when all of their conditions and dependencies have been met.

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-order_management-264-0-0-production-enus/c2040b01-aade-4ba7-8a7d-d7cd745d5c8c/images/icon_note.png)

Note

Orchestration item states are managed by Order Management. Other than marking a callout as failed, you should never personally change the state of an orchestration item. Doing so leads to failed orders.

- **[Orchestration Item Types](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_types_231420.htm&release=264.0.0&type=5)**  
    Orchestration plans use orchestration item types to define actions for orchestration items. Actions are triggered when an item reaches the Ready state.
- **[Orchestration Item States](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_states_231740.htm&release=264.0.0&type=5)**  
    Each orchestration item in an orchestration plan is given a color that indicates its state. You can glance at the orchestration plan to get an idea of the states of the items in that plan.
- **[Orchestration Item Conditions](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_conditions_231876.htm&release=264.0.0&type=5)**  
    As part of an orchestration item definition, you can specify conditions that control whether the item should execute if the condition is met, or skipped if the condition is not met.
- **[Orchestration Item Associations to Fulfillment Request Lines and Order Items](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_associations_to_fulfillment_request_lines_and_orderitems_231900.htm&release=264.0.0&type=5)**  
    If an orchestration plan definition is associated with a _technical product_, its orchestration items are associated with a fulfillment request line. If an orchestration plan definition is associated with a _commercial product_, its orchestration items are associated with an order line item.
- **[Orchestration Item Dependencies](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_item_dependencies_231926.htm&release=264.0.0&type=5)**  
    Orchestration dependency definitions specify the dependencies among orchestration items, either within a single plan or between orchestration items from different orchestration plans.
- **[View or Create an Orchestration Item Definition](https://help.salesforce.com/s/articleView?id=ind.comms_t_view_or_create_an_orchestration_item_definition_232030.htm&release=264.0.0&type=5)**  
    Edit, examine, or create an orchestration item definition from the relevant Orchestration Plan Definition, or open Orchestration Item Definitions from the App launcher.
- **[Orchestration Item Definition Attributes Encoding Style](https://help.salesforce.com/s/articleView?id=ind.iom_orchestration_item_definition_attributes_encoding_style.htm&release=264.0.0&type=5)**  
    In the Orchestration Item Definition screen, choose whether to produce flat or structured JSON for attributes.
- **[Orchestration Item Definition Request Items Encoding Style](https://help.salesforce.com/s/articleView?id=ind.iom_orchestration_item_definition_request_items_encoding_style.htm&release=264.0.0&type=5)**  
    In the Orchestration Item Definition screen, choose whether to produce flat or structured JSON for requests.
- **[Orchestration Scope](https://help.salesforce.com/s/articleView?id=ind.comms_t_orchestration_scope_232077.htm&release=264.0.0&type=5)**  
    The **Scope** field on an orchestration plan definition defines a default scope for orchestration items contained by a plan if the item does not have a scope defined.
- **[Pass Attribute Values to a Fulfillment Request Line](https://help.salesforce.com/s/articleView?id=ind.comms_t_pass_attribute_values_to_a_fulfillment_request_line_232126.htm&release=264.0.0&type=5)**  
    Use the XOMAutoTaskCopyAttributes auto task to extract values and pass them to a fulfillment request line.
- **[Set a Future Time for OM to Process an Orchestration Item](https://help.salesforce.com/s/articleView?id=ind.comms_t_set_a_future_time_for_om_to_process_an_orchestration_item_232269.htm&release=264.0.0&type=5)**  
    Edit the **Process After** field on any callout or auto task Orchestration Item definition to have OM process that item at a specified time, rather than as soon as any prerequisite items have completed. For example, you can delay billing or cancellation of a service until the end of the month.
- **[Configure a Callout to Send Empty Attribute Values](https://help.salesforce.com/s/articleView?id=ind.comms_t_configure_a_callout_to_send_empty_attribute_values_232334.htm&release=264.0.0&type=5)**  
    By default, if an attribute value is empty, then Order Management doesn't send the attribute at all in a callout. It's as if it didn't exist. You can configure a callout to send along attributes and their values, even if those values are empty.
- **[Manipulating Attributes with a Vlocity Calculation Matrix](https://help.salesforce.com/s/articleView?id=ind.comms_t_manipulating_attributes_with_a_vlocity_calculation_matrix_232368.htm&release=264.0.0&type=5)**  
    You can use callouts and auto tasks to manipulate attributes based on a calculation matrix. Use a Vlocity Calculation Matrix to reduce integration complexity and conditional programming logic.
- **[Propagation of Attribute Values Upstream During Order Management](https://help.salesforce.com/s/articleView?id=ind.comms_t_propagation_of_attribute_values_upstream_during_order_management_232440.htm&release=264.0.0&type=5)**  
    Order Management can pass attribute values (or **propagate** them) from downstream orchestration items back upstream to the associated order line item or orchestration item. You can also set up a pair of values, so that if you receive one value from the pair, you pass back a pre-configured value.
- **[OM Plus: Re-Propagating Attribute Values](https://help.salesforce.com/s/articleView?id=ind.comms_t_om_plusre_propagating_attribute_values_232602.htm&release=264.0.0&type=5)**  
    Order Management Plus allows re-propagation of mapped characteristics on technical (downstream) order items. This is because some attributes might be completed as a result of the information received once callbacks are finished or a task is completed.
- **[Information About Synchronizing Data across Order Items from Different Orders](https://help.salesforce.com/s/articleView?id=ind.comms_t_information_about_synchronizing_data_across_order_items_from_differentorders_232655.htm&release=264.0.0&type=5)**  
    In Order Management Plus, assets are not affected when you synchronize data across Order Items from different Orders.
- **[Synchronize Data across Order Items from Different Orders](https://help.salesforce.com/s/articleView?id=ind.comms_t_synchronize_data_across_order_items_from_different_orders_232670.htm&release=264.0.0&type=5)**  
    To synchronize data across Order Items from different orders, use an Auto Task to trigger a request to the Order Management Plus AutoTask service.