Set a Future Time for OM to Process an Orchestration Item

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.

Note

This functionality is available for callouts and auto tasks only.

If you're defining an orchestration item before the order has been submitted, then see the numbered steps that follow.

If you're changing an orchestration item after an order has already been submitted, then change go to that orchestration item itself (not the definition) and make the change there.

1. Open the Orchestration Item Definition window.
2. In the Process After field, set the time to process the item, using one of the following methods:

   • Order Management Standard only: Use Apex code: Enter the following string and save it (don't worry that it's not the right date. You need something there, but you'll override it with your Apex code): 2021-01-24T12:00Z

     After the string is saved in that field, you're finished with the Process After field. Next, write some Apex code as you normally would to act on an orchestration item. For example, you can put the following code in a custom autotask to process an item 7 days in the future:

     vlocity_cmt__OrchestrationItem__c orchestrationItem = <find the required orchestration item>;
     orchestrationItem.vlocity_cmt__ProcessAfter__c = datetime.now()+7;
     update orchestrationItem;

   • Enter a call to use a date from a different attribute on the associated order item or fulfillment request line. In the attribute being called, set the date with the ISO date format, but in the Process After field use the following syntax:

     • Order Management Standard: dateFromDotNotation:OrderItem.AttributeValue.<Attribute_Code>

     • Order Management Plus: dateFromDotNotation:'OrderItemId__c.CharacteristicValues.<Attribute_Code>'

       

       Note dateFromDotNotation does not support Attribute Codes that start with digits.

     Enter a time and date for the item to be processed, using the ISO date format. For example, 2019-10-31T12:00Z. For more information on ISO date formats, see ISO_ZONED_DATE_TIME.

   • Enter the following string to have the item be processed the moment that the next month begins: firstMomentOfNextMonth()

3. Click Save.