Loading
Salesforce now sends email only from verified domains. Read More
Help Agent Performance DegradationRead More
Table of Contents
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

          Search all of Salesforce Help
          Learn About Therapy Orchestration

          Learn About Therapy Orchestration

          Advanced Therapy Management’s Therapy Orchestration helps you implement complex workflows for therapies using Salesforce Flows. In Therapy Orchestration, a parent orchestration flow references a series of subflows that execute all the components of a therapy. Each flow is highly flexible and can be customized according to the specific needs of your Salesforce org. You can automatically assign tasks at every step of the therapy to the relevant stakeholders involved, and easily monitor therapy progress from patient intake to infusion.

          Required Editions

          Available in: Lightning Experience

          Available in: Enterprise and Unlimited Editions with Health Cloud or Life Sciences Cloud

          In Advanced Therapy Management, a therapy workflow involves multiple stages that occur in sequence or in parallel, such as patient intake, apheresis, manufacturing, and infusion. Each stage has multiple substages that must be completed in sequential order. For example, the apheresis stage has substages like verification of patient identity, collection of the biosample, and delivery of the biosample. Each substage consists of tasks that are assigned to different users and can be performed in parallel.

          To orchestrate a therapy, first you must set up the relevant therapy records before the flow is executed (setup construct). Make sure you configure a care program, a corresponding work procedure, work procedure steps, work types, work type steps, and action plan templates with task flows or component tasks. At the time of execution of the flows (runtime construct), care program enrollee work order, care program enrollee work order step, and assessment task records are generated. You can set up teams, team members, and participant roles to assign the tasks to users.

          Keep in mind the terms used to refer to therapy stages, substages, and tasks throughout Advanced Therapy Management.

          LevelExampleSetup ConstructRuntime Construct
          TherapyCell and Gene TherapyCare Program, Work ProcedureNone
          StageApheresis Work Type, Work Procedure StepCare Program Enrollee Work Order
          Step or SubstageCreate Patient Identity Verification StepWork Type Step, Action Plan Template Care Program Enrollee Work Order Step
          TaskDocument ScanTask Definitions in Action Plan TemplateAssessment Tasks (such as Flow and Component Tasks)

          Therapy Orchestration offers two sample flows that are customizable templates that you can clone to add, modify, or remove substages, per your requirements. The sample flows generate care program enrollee work order steps for Patient Intake and Apheresis. You can clone and customize the sample flows to set up care program enrollee work order steps for other work procedure steps, like Manufacturing and Infusion.

          • Generate Work Order Steps for Patient Intake
          • Generate Work Order Steps for Apheresis
          Note
          Note Starting from Winter ‘24, you can’t view or add new data in the Associated Flow Name field on the Work Procedure Step object. You can continue executing the Generate Work Order Steps for Patient Intake and Generate Work Order Steps for Apheresis flows using data that was stored in the Associated Flow Name field before Winter ‘24. However, this approach isn’t recommended. Instead, create records for substages in a therapy stage using Work Type Step records, and associate an action plan template with the work type step to create therapy tasks.

          Apart from the sample flows, Therapy Orchestration provides a simplified framework for implementing all the different stages, substages, and tasks of a therapy using an orchestration flow that loops through other flows.

          Flow Name Flow Type Purpose
          Process Advanced Therapy Work Orders Flow Orchestration Loops through four autolaunched flows and one evaluation subflow to complete all the stages of an advanced therapy.
          Start Therapy Work Order Autolaunched flow Initiates therapy stages and generates runtime records called Care Program Enrollee Work Orders.
          Start Therapy Work Order Step Autolaunched flow Initiates therapy substages and generates runtime records called Care Program Enrollee Work Order Steps using the Create Care Program Enrollee Work Order Step invocable action. This invocable action also generates tasks based on the actionPlanTemplateId input parameter, and assigns the task to a care team member with a corresponding role.
          Evaluate Step and Task Completion Status Evaluation flow Checks whether all the tasks and custody records associated with a substage are complete. When all tasks are completed, the orchestrator transitions to the next substage in the sequence.
          Create Custody Chain Entries Autolaunched flow Creates custody chain entry records. Optionally, the flow also creates a custody item.
          Override Custody Verification Type When Work Order Is Changed Record triggered autolaunched flow Creates custody records when the status of a care program enrollee work order changes to In Progress.
          Override Custody Verification Type When Work Order Step Is Changed Record triggered autolaunched flow Creates custody records when the status of a care program enrollee work order step changes to In Progress.
          Complete Therapy Work Order Step Autolaunched flow Sets the Care Program Enrollee Work Order Step status to complete, and ends the substage.
          Complete Therapy Work Order Autolaunched flow Sets the Care Program Enrollee Work Order status to complete, and ends the stage.

          After you run the flows, you can follow the details of the orchestration, including the status and the date it was created, in the Orchestration Run records. In the Related tab, view the therapy stages and steps that are executed.

          • Assign Permission Sets Licenses and Permission Set to Therapy Orchestration Users
            Enable users to execute advanced therapy workflows and automate task assignment by assigning the required permission sets licenses and corresponding permission sets.
          • Configure Data Capture for Objects
            To make sure that the orchestrator is notified of any changes to the Care Program Enrollee Work Order and Care Program Enrollee Work Order Step records, configure data capture for these objects.
          • Configure Flow Events in Advanced Therapy Management
            To resume the Advanced Therapy Management flow orchestrator, turn off the flow events.
          • Add Lightning App Builder Components to Track Step Progress
            Help users track the progress of therapy steps or substages (work procedure steps) and tasks (care program enrollee work order steps) by adding the Work Procedure Step Progression and Work Order Step Progression components to the Care Program Enrollee record page. These components enable users to view completed, current, and upcoming tasks.
          • Quick Guide to a Successful Therapy Orchestration
            Find the list of Therapy Orchestration tasks you perform in a particular order to configure the right data, and run the default flows and your own customized flows in one place.
          • Considerations for Running the Default Therapy Orchestration Flows
            Perform prerequisite tasks before you run the default flows for therapy orchestration.
          • Prepare to Run the Therapy Orchestration Flows in Advanced Therapies
            Therapy Orchestration’s flows are highly flexible and you can customize them according to the needs of your Salesforce org. Add, remove, and modify therapy stages and steps, and create action plan templates for the different stakeholders in a therapy. Create work type steps to represent each therapy step and associate it with an action plan template. Add team members who can be assigned a task in a therapy step.
          • Manually Assign Therapy Tasks to Users
            Make sure stakeholders in a therapy step don’t miss their assigned tasks due to configuration errors. Create a custom field on the Assessment Task object and configure an Apex trigger to assign therapy tasks using criteria-based sharing.
          • Create a Lightning Aura Component for Tasks in Therapy Orchestration
            Help users perform component tasks that involve navigating to different screens. Set up a Lightning Aura Component to help users navigate to the Schedule Appointments tab to book slots as part of a component task.
          • Update Component Task Status with Lightning Message Channel
            To change the status of a component task, publish a message through a Lightning message channel and create a Lightning aura component.
          • Repeat Stages In a Therapy Orchestration
            Advanced Therapy Orchestration helps you perform two types of flows: linear flows and non-linear flows that repeat stages. While linear flows are the norm, non-linear flows are built to intervene in situations when things don’t go according to plan.
          • Use Advanced Scheduling and Decision Tables
            Provide flexibility for users to find appropriate appointment slots with Advanced Scheduling settings. Accommodate operational and regulatory variances in lead time based on country or service territory. Help users select their preferred locations for performing therapy processes based on priority-based override rules. Customize field lists that store therapy task data according to the country of enrollment.
          • Get to Know Custody Management
            Advanced Therapy Management’s Chain of Custody (CoC) and Chain of Identity (CoI) capabilities help you comply with pharmaceutical regulations and uphold safety standards across the lifecycle of an advanced therapy. CoC helps you maintain a digital trail of the patient’s collected biosample as it passes through the various stages, steps, and tasks of an advanced therapy. CoI ensures that the right patient receives the right treatment by assigning a unique identifier to the collected biosample.
          • Generate Customized Work Order Steps or Therapy Tasks for Users
            The Generate Work Order Steps for Patient Intake flow and the Generate Work Order Steps for Apheresis flow create runtime records of care program enrollee work order steps. Care program enrollee work order steps are then assigned to different stakeholders as tasks in a therapy. For example, Biosample Collection is a care program enrollee work order step or a task assigned to a lab technician. You can clone the flows to create work order steps for other therapy stages like Manufacturing and Infusion. Also, you can customize the default flows to add, remove, or modify work order steps for apheresis and patient intake, and delegate tasks to various stakeholders in your org.
           
          Loading
          Salesforce Help | Article