Business Object API Workflow Steps

The following table provides information about the BO API Workflow Steps.

Workflow Step NameClassnameMethodEntityDescription
setPromotionDates2Promotion2BoApiCoreWorkflowStepssetPromotionDatesPromotionSets the promotion dates (Date From, Date Thru, Commit Date, Shipment Date From, Shipment Date Thru, Order Date From, Order Date Thru, In-Store Date From and In-Store Date Thru of a promotion).
setTacticDates2Promotion2BoApiCoreWorkflowStepssetTacticDatesTacticSets/Updates the tactic dates (Date From, Date Thru, Shipment Date From, Shipment Date Thru, Instore Date From and Instore Date Thru of a tactic) from input.
applyPromotionDateHandling2Promotion2BoApiCoreWorkflowStepsapplyPromotionDateHandlingTPM_PromotionApplies automatic date handling rules to the promotions to be processed. Needs to be executed after “setPromotionDates” rule.
handleManualInputs2Promotion2BoApiCoreWorkflowStepshandleManualInputsManualInputsSets the manual inputs (totals) on product, promotion and tactic level.
setPromotionAnchor2Promotion2BoApiCoreWorkflowStepssetPromotionAnchorPromotionSets the Promotion Anchor (Customer, Customer Set or null) depending on the anchor type of the template.
setPromotionCategories2Promotion2BoApiCoreWorkflowStepssetPromotionCategoriesTPM_PromotionSets the promotion categories based on the categories the user has access to for the anchor customer or customer set.
mapPromotionValues2Promotion2BoApiCoreWorkflowStepsmapValuesPromotionMaps promotion values to the output object. Each field is mapped into the Output Object field specified in the ‘Maps To’ attribute of the Input Structure.
mapTacticValues2Promotion2BoApiCoreWorkflowStepsmapValuesTacticMaps tactic values to the output object. Each field is mapped into the Output Object field specified in the ‘Maps To’ attribute of the Input Structure.
setPromotionSubAccounts2Promotion2BoApiCoreWorkflowStepssetPromotionSubAccountsTPM_PromotionSets the promotion Sub Accounts, if sub account planning are enabled in promotion template.
setPromotionParticipatingCustomers2Promotion2BoApiCoreWorkflowStepssetPromotionParticipatingCustomersTPM_PromotionSets the promotion Participating Customers for pushable promotions.
managePromotionProductFilterCopy2Promotion2BoApiCopyCoreWorkflowStepsmanagePromotionProductFilterCopyTPM_PromotionFilters out invalid products from the promotion product filter. It removes products that are no longer valid for the promotion timeframe. Filter Criteria’s are not touched.
setPromotionDates(update)2Promotion2BoApiCoreWorkflowStepssetPromotionDatesPromotionUpdates the promotion dates (Date From, Date Thru, Commit Date, Shipment Date From, Shipment Date Thru, Order Date From, Order Date Thru, In-Store Date From and In-Store Date Thru of a promotion).
loadPromotionDefaults(update)2Promotion2BoApiCoreWorkflowStepsloadPromotionDefaultsPromotionLoad promotion values. Id or externalId of the promotion must be provided to load promotion record values. Step to be used by ‘update’ workflow.
loadTacticDefaults(update)2Promotion2BoApiCoreWorkflowStepsloadTacticDefaultsTacticLoad tactic values. TacticId or externalId must be provided to load tactic record values. Step to be used by ‘update’ workflow.
setPromotionAnchor(Update)2Promotion2BoApiCoreWorkflowStepssetPromotionAnchorPromotionSets the Promotion Anchor (Customer, Customer Set or null) depending on the anchor type of the template.
mapPromotionValues(Update)2Promotion2BoApiCoreWorkflowStepsmapValuesPromotionMaps promotion values to the output object. Each field is mapped into the Output Object field specified in the ‘Maps To’ attribute of the Input Structure.
loadPromotionBOForCopy2Promotion2BoApiCopyCoreWorkflowStepsloadPromotionBOForCopyPromotionLoads promotion values for copy. The input Id parameter must reference a valid Promotion by SFDC Id or External Id. If the Promotion template is not Copyable, it will report an error.
loadTacticsLOForCopy2Promotion2BoApiCopyCoreWorkflowStepsloadTacticsLOForCopyPromotionLoads Promotion Tactics.The input Id parameter must reference a valid Promotion by SFDC Id or External Id. If the Promotion Template does not have “Tactics” as the copied components, Promotion Tactics won’t be loaded.
loadPromotionAttachmentsForCopy2Promotion2BoApiCopyCoreWorkflowStepsloadPromotionAttachmentsForCopyPromotionLoads Promotion Attachments for the referenced Promotion. The input Id parameter must reference a valid Promotion by SFDC Id or External Id. If input “CopyAttachments” flag is set to false or not defined, attachments won’t be loaded.
resetPromotion2Promotion2BoApiCopyCoreWorkflowStepsresetPromotionTPM_PromotionResets the Promotion values to their initial values in order for the promotion to be inserted again. Workflow fields are set to their initial values and the Promotions SFDC Id is reset in order to be able to be inserted again.
manageParticipatingCustomersCopy2Promotion2BoApiCopyCoreWorkflowStepsmanageParticipatingCustomersCopyTPM_PromotionFilters out invalid Participating Customers. If the promotion is pushable, it removes Participating Customers that are no longer valid for the current promotion timeframe.
resetTactic2Promotion2BoApiCopyCoreWorkflowStepsresetTacticTPM_Promotion.TacticResets the Tactic values to their initial values in order for the tactic to be able to be inserted. Workflow fields are set to their initial values and the Tactic SFDC Id is reset in order to be able to be inserted again.
manageTacticProductFilterCopy2Promotion2BoApiCopyCoreWorkflowStepsmanageTacticProductFilterCopyTPM_Promotion.TacticFilters out invalid products from the tactic product filter. It removes products that are no longer valid for the promotion timeframe. Filter Criteria’s are not touched.
manageSubAccountsCopy2Promotion2BoApiCopyCoreWorkflowStepsmanageSubAccountsCopyTPM_PromotionFilters out invalid Sub Accounts. If the promotion has Sub Accounts Enabled, it removes Sub Accounts that are no longer valid for the current promotion timeframe.
manageManualInputCopy2Promotion2BoApiCopyCoreWorkflowStepsmanageManualInputCopyTPM_PromotionHandles the manual inputs copy. If the promotion template has “ManualInput” as part of the copied components, it adjusts the Promotion Manual Inputs for the new Promotion Timeframe. It also adjusts Tactic inputs to reference the correct new tactics.
movePromotionTimeframe2Promotion2BoApiCopyCoreWorkflowStepsmovePromotionTimeframePromotionMoves the Promotion timeframe by the amount of specified years in the input “AddYears” property or the difference in days between the input “DateFrom” and Promotion current Date From. If the neither of the input properties is specified, a default value of 1 will be used for “AddYears”. If both of them are provided, an error will be thrown. It also moves the tactic timeframes by the same offsets calculated for the parent promotion. It also checks the customer/customer set is still valid for the new Promotion Timeframe.
setTacticConditionCreationDefinitions(update)PromotionBoApiCoreWorkflowStepssetTacticConditionCreationDefinitionsTacticConditionCreationDefinitionsInput for updating Tactic Condition Creation Definitions.
setTacticConditionCreationDefinitionsPromotionBoApiCoreWorkflowStepssetTacticConditionCreationDefinitionsTacticConditionCreationDefinitionsInput for creating Tactic Condition Creation Definitions.
setTacticConditionCreationDefinitions2Promotion2BoApiCoreWorkflowStepssetTacticConditionCreationDefinitionsTacticConditionCreationDefinitionsInput for creating Tactic Condition Creation Definitions.
setTacticConditionCreationDefinitions(update)2Promotion2BoApiCoreWorkflowStepssetTacticConditionCreationDefinitionsTacticConditionCreationDefinitionsInput for updating Tactic Condition Creation Definitions.
manageTCCDsLOForCopyPromotionBoApiCopyCoreWorkflowStepsmanageTCCDsLOForCopyBOPromotionThis method copies the TCCD records from the source promotion tactics to the target promotion tactics. It reads the tactics from current output JSON and fetches the related TCCD records and updates the output JSON. The field ‘Create Default Conditions’ checkbox is set to false so that only the source promotion’s TCCDs are copied and the default TCCDs are not created.
manageTCCDsLOForCopy2Promotion2BoApiCopyCoreWorkflowStepsmanageTCCDsLOForCopyTPM_PromotionThis method copies the TCCD records from the source promotion tactics to the target promotion tactics. It reads the tactics from current output JSON and fetches the related TCCD records and updates the output JSON. The field ‘Create Default Conditions’ checkbox is set to false so that only the source promotion’s TCCDs are copied and the default TCCDs are not created.
loadPromotionForDerive2Promotion2BoApiDeriveCoreWorkflowStepsloadPromotionPromotionLoads promotion values for derive. The input Id parameter must reference a valid Promotion by SFDC Id or External Id. If the Promotion template for the promotion is not Derivable, it will report an error. Promotion Template parameter must reference a valid Promotion Template by Id or Name. This Promotion Template must be a child template from the promotion one where the Usage is set to derive.
handleAttachmentsForDerive2Promotion2BoApiDeriveCoreWorkflowStepshandleAttachmentsPromotionHandles Promotion Attachments for the context Promotion. If input “DeriveAttachments” flag is set to false or not defined, attachments won’t be derived.
setPromotionTemplateForDerive2Promotion2BoApiDeriveCoreWorkflowStepssetPromotionTemplatePromotionAssigns the target derive Promotion Template to the Promotion as it’s template.
setPromotionAnchorForDerive2Promotion2BoApiDeriveCoreWorkflowStepssetPromotionAnchorPromotionAssigns the target derive Anchor Account to the Promotion as it’s anchor.
resetPromotionForDerive2Promotion2BoApiDeriveCoreWorkflowStepsresetPromotionTPM_PromotionResets the Promotion values to their initial values in order for the promotion to be inserted again. Workflow fields are set to their initial values and the Promotions SFDC Id is reset in order to be able to be inserted again.
resetTacticForDerive2Promotion2BoApiDeriveCoreWorkflowStepsresetTacticTPM_Promotion.TacticResets the Tactic values to their initial values in order for the tactic to be able to be inserted. Workflow fields are set to their initial values and the Tactic SFDC Id is reset in order to be able to be inserted again.
managePromotionProductFilterForDerive2Promotion2BoApiDeriveCoreWorkflowStepsmanagePromotionProductFilterTPM_PromotionFilters out invalid products from the promotion product filter. It removes products that are no longer valid for the promotion timeframe. Filter Criteria’s are not touched.
manageTacticProductFilterForDerive2Promotion2BoApiDeriveCoreWorkflowStepsmanageTacticProductFilterTPM_Promotion.TacticFilters out invalid products from the tactic product filter. It removes products that are no longer valid for the promotion timeframe. Filter Criteria’s are not touched.
manageParticipatingCustomersForDerive2Promotion2BoApiDeriveCoreWorkflowStepsmanageParticipatingCustomersTPM_PromotionFilters out invalid Participating Customers. If the promotion is pushable, it removes Participating Customers that are no longer valid for the current promotion timeframe.
manageSubAccountsForDerive2Promotion2BoApiDeriveCoreWorkflowStepsmanageSubAccountsTPM_PromotionFilters out invalid Sub Accounts. If the promotion has Sub Accounts Enabled, it removes Sub Accounts that are no longer valid for the current promotion timeframe.
manageTCCDsForDerive2Promotion2BoApiDeriveCoreWorkflowStepsmanageTCCDsTPM_PromotionThis method copies the TCCD records from the source promotion tactics to the target promotion tactics. It reads the tactics from current output JSON and fetches the related TCCD records and updates the output JSON. The field ‘Create Default Conditions’ checkbox is set to false so that only the source promotion’s TCCDs are copied and the default TCCDs are not created.
setPromotionAnchorForCopy2Promotion2BoApiCopyCoreWorkflowStepssetPromotionAnchorForCopyPromotionSets the Promotion Anchor (Customer, Customer Set or null) depending on the anchor type of the Promotion template. No value is set, no chages to the anchor are performed.
mapPromotionValuesForCopy2Promotion2BoApiCoreWorkflowStepsmapValuesPromotionMaps promotion values to the output object. Each field is mapped into the Output Object field specified in the ‘Maps To’ attribute of the Input Structure.
movePromotionTimeframeDerive2Promotion2BoApiDeriveCoreWorkflowStepsmovePromotionTimeframePromotionMoves the Promotion timeframe by the difference in days between the input “DateFrom” and Promotion current Date From. If not provided, same dates as source promotion will be set. It also moves the tactic timeframes by the same offsets calculated for the parent promotion. It also checks the customer/customer set is still valid for the new Promotion Timeframe.