Business Object API Workflow Step Input Structures

The following table provides technical details related to each workflow step.

Workflow Step NameRecord TypePathRequired?DescriptionMaximum Length (String)
handleAttachmentsForDerive2Boolean.DeriveAttachmentsFALSEBoolean flag. If enabled, attachments will be derived, if false, attachments won’t be derivedNA
handleManualInputsString[*].KPITRUEThe name of the KPI for which the value must be set.80
handleManualInputsString[*].ProductFALSEProduct ID(SFID or external ID) to set the KPI Value to. If not set, the KPI value is set as total for the promotion/tactic.260
handleManualInputsNumber[*].ValueTRUENumeric value. Value to set to the KPI.NA
handleManualInputs2String[*].KPITRUEThe name of the KPI for which the value must be set.80
handleManualInputs2Number[*].ValueTRUENumeric value. Value to set to the KPI.NA
handleManualInputs2String[*].ProductFALSEProduct ID(SFID or external ID) to set the KPI Value to. If not set, the KPI value is set as total for the promotion/tactic.260
loadCategoryShareLOString.IdTRUESFDC Id or External Id of the source promotion to be copied.40
loadPromotionAttachmentsForCopyString.IdTRUESFDC Id or External Id of the source promotion to be copied.40
loadPromotionAttachmentsForCopyBoolean.CopyAttachmentsFALSEBoolean flag. If enabled, attachments will be loaded, if false, attachments won’t be loadedNA
loadPromotionAttachmentsForCopy2String.IdTRUESFDC Id or External Id of the source promotion to be copied.40
loadPromotionAttachmentsForCopy2Boolean.CopyAttachmentsFALSEBoolean flag. If enabled, attachments will be loaded, if false, attachments won’t be loadedNA
loadPromotionBOForCopyString.IdTRUESFDC Id or External Id of the source promotion to be copied.40
loadPromotionBOForCopy2String.IdTRUESFDC Id or External Id of the source promotion to be copied.40
loadPromotionDefaultsString.IdFALSESFID or External Id of the promotion.40
loadPromotionDefaultsString.PromotionTemplateTRUEName or SFID of the Promotion Template.40
loadPromotionDefaults(update)String.PromotionTemplateFALSEName or SID of the Promotion Template40
loadPromotionDefaults(update)String.IdTRUESFID or External Id of the promotion to be updated.40
loadPromotionDefaults(update)2String.PromotionTemplateFALSEName or SID of the Promotion Template40
loadPromotionDefaults(update)2String.IdTRUESFID or External Id of the promotion to be updated.40
loadPromotionDefaults2String.PromotionTemplateTRUEName or SFID of the Promotion Template.40
loadPromotionDefaults2String.IdFALSESFID or External Id of the promotion.40
loadPromotionForDerive2String.IdTRUESFID or External Id of the promotion to be derived.40
loadPromotionForDerive2String.PromotionTemplateTRUEName or SID of the Promotion Template to use for derivation.40
loadTacticDefaultsString.TacticTemplateTRUEName or SFID of the tactic template.40
loadTacticDefaultsString.IdFALSESFID or External Id of the tactic.40
loadTacticDefaults(update)String.IdTRUESFID or ExternalId of the tactic40
loadTacticDefaults(update)String.TacticTemplateFALSEName or SFID of the tactic template.40
loadTacticDefaults(update)2String.IdTRUESFID or ExternalId of the tactic40
loadTacticDefaults(update)2String.TacticTemplateFALSEName or SFID of the tactic template.40
loadTacticDefaults2String.TacticTemplateTRUEName or SFID of the tactic template.50
loadTacticDefaults2String.IdFALSESFID or External Id of the tactic.40
loadTacticsLOForCopyString.IdTRUESFDC Id or External Id of the source promotion to be copied.40
loadTacticsLOForCopy2String.IdTRUESFDC Id or External Id of the source promotion to be copied.40
mapPromotionValuesString.CommentFALSEComment255
mapPromotionValuesString.SloganTRUESlogan80
mapPromotionValues(Update)String.SloganFALSESlogan80
mapPromotionValues(Update)String.CommentFALSEComment255
mapPromotionValues(Update)2String.SloganFALSESlogan80
mapPromotionValues(Update)2String.CommentFALSEComment255
mapPromotionValues2String.SloganTRUESlogan80
mapPromotionValues2String.CommentFALSEComment255
mapPromotionValuesForCopy2String.SloganFALSESlogan80
mapTacticValuesString.CompensationModelFALSECompensation Model255
mapTacticValuesNumber.AmountFALSETactic AmountNA
mapTacticValues2String.CompensationModelFALSECompensation Model255
mapTacticValues2Number.AmountFALSETactic AmountNA
movePromotionTimeframeNumber.AddYearsFALSEAmount of years to move the promotion timeframe. If not set, a default value of 1 will be used.NA
movePromotionTimeframe2String.InStoreDateFromFALSEPromotion’s new In Store Date From. If specified, all promotion dates will be shifted by the difference in days between the input Date and the Promotion current Date From date.10
movePromotionTimeframe2Number.AddYearsFALSEAmount of years to move the promotion timeframe. If not set, a default value of 1 will be used.NA
setProductFilterString.Criteria.Brand[*]FALSEThe External Ids of manual brands that must be included in the promotion.255
setProductFilterString.IncludedProducts[*]FALSEThe External Ids of manual products that must be included.255
setProductFilterString.Criteria.Subcategory[*]FALSEThe External Ids of manual sub categories that must be included in the promotion.255
setProductFilterString.Criteria.Category[*]FALSEThe External Ids of manual categories that must be included in the promotion.255
setProductFilterString.ExcludedProducts[*]FALSEThe External Ids of manual products to be excluded.255
setProductFilterString.Criteria.Flavor[*]FALSEThe External Ids of manual flavors that must be included in the promotion.255
setProductFilterString.Criteria.Package[*]FALSEThe External Ids of manual packages that must be included in the promotion.255
setProductFilter2String.Criteria.Flavor[*]FALSEThe External Ids of manual flavors that must be included in the promotion.255
setProductFilter2String.Criteria.Package[*]FALSEThe External Ids of manual packages that must be included in the promotion.255
setProductFilter2String.IncludedProducts[*]FALSEThe External Ids of manual products that must be included.255
setProductFilter2String.Criteria.Subcategory[*]FALSEThe External Ids of manual sub categories that must be included in the promotion.255
setProductFilter2String.Criteria.Brand[*]FALSEThe External Ids of manual brands that must be included in the promotion.255
setProductFilter2String.Criteria.Category[*]FALSEThe External Ids of manual categories that must be included in the promotion.255
setProductFilter2String.ExcludedProducts[*]FALSEThe External Ids of manual products to be excluded.255
setPromotionAnchorString.PromotionTemplateTRUEName or SFID of the Promotion Template.40
setPromotionAnchorString.AnchorAccountSetFALSEName or SFID of the customer set.40
setPromotionAnchorString.IdFALSESFDC Id or External Id of the source promotion to be copied.40
setPromotionAnchorString.AnchorAccountFALSESFID or External Id of the customer.40
setPromotionAnchor(Update)String.IdFALSESFDC Id or External Id of the source promotion to be copied.40
setPromotionAnchor(Update)String.AnchorAccountFALSESFID or External Id of the customer.40
setPromotionAnchor(Update)String.AnchorAccountSetFALSEName or SFID of the customer set.40
setPromotionAnchor(Update)String.PromotionTemplateFALSEName or SID of the Promotion Template40
setPromotionAnchor(Update)2String.IdFALSESFDC Id or External Id of the source promotion to be copied.40
setPromotionAnchor(Update)2String.AnchorAccountSetFALSEName or SFID of the customer set.40
setPromotionAnchor(Update)2String.PromotionTemplateFALSEName or SID of the Promotion Template40
setPromotionAnchor(Update)2String.AnchorAccountFALSESFID or External Id of the customer.40
setPromotionAnchor2String.AnchorAccountFALSESFID or External Id of the customer.40
setPromotionAnchor2String.PromotionTemplateTRUEName or SFID of the Promotion Template.40
setPromotionAnchor2String.AnchorAccountSetFALSEName or SFID of the customer set.40
setPromotionAnchor2String.IdFALSESFDC Id or External Id of the source promotion to be copied.40
setPromotionAnchorForCopy2String.AnchorAccountFALSESFID or External Id of the customer.40
setPromotionAnchorForCopy2String.AnchorAccountSetFALSEName or SFID of the customer set.40
setPromotionAnchorForDerive2String.AnchorAccountTRUESFID or External Id of the customer.40
setPromotionDatesString.OrderDateThruFALSEOrder Date Thru10
setPromotionDatesString.DateFromTRUEDate10
setPromotionDatesString.DeliveryDateFromFALSEShipment Date From10
setPromotionDatesString.OrderDateFromFALSEOrder Date From10
setPromotionDatesString.CommitDateFALSECommit Date10
setPromotionDatesString.PlacementDateFromFALSEIn-store Date From10
setPromotionDatesString.DeliveryDateThruFALSEShipment Date Thru10
setPromotionDatesString.PlacementDateThruFALSEIn-store Date Thru10
setPromotionDatesString.DateThruTRUEDate10
setPromotionDates(update)String.OrderDateThruFALSEPromotion Order Date Thru10
setPromotionDates(update)String.CommitDateFALSEPromotion Commit Date10
setPromotionDates(update)String.PlacementDateFromFALSEPromotion In-store Date From10
setPromotionDates(update)String.DeliveryDateThruFALSEPromotion Shipment Date Thru10
setPromotionDates(update)String.DeliveryDateFromFALSEPromotion Shipment Date From10
setPromotionDates(update)String.OrderDateFromFALSEPromotion Order Date From10
setPromotionDates(update)String.PlacementDateThruFALSEPromotion In-store Date Thru10
setPromotionDates(update)String.DateFromFALSEPromotion Date From10
setPromotionDates(update)String.DateThruFALSEPromotion Date Thru10
setPromotionDates(update)2String.OrderDateFromFALSEPromotion Order Date From10
setPromotionDates(update)2String.PlacementDateFromFALSEPromotion In-store Date From10
setPromotionDates(update)2String.DeliveryDateThruFALSEPromotion Shipment Date Thru10
setPromotionDates(update)2String.CommitDateFALSEPromotion Commit Date10
setPromotionDates(update)2String.OrderDateThruFALSEPromotion Order Date Thru10
setPromotionDates(update)2String.DeliveryDateFromFALSEPromotion Shipment Date From10
setPromotionDates(update)2String.PlacementDateThruFALSEPromotion In-store Date Thru10
setPromotionDates(update)2String.DateFromFALSEPromotion Date From10
setPromotionDates(update)2String.DateThruFALSEPromotion Date Thru10
setPromotionDates2String.OrderDateThruFALSEOrder Date Thru10
setPromotionDates2String.OrderDateFromFALSEOrder Date From10
setPromotionDates2String.PlacementDateThruFALSEIn-store Date Thru10
setPromotionDates2String.DeliveryDateThruFALSEShipment Date Thru10
setPromotionDates2String.DateThruTRUEDate10
setPromotionDates2String.DateFromTRUEDate10
setPromotionDates2String.PlacementDateFromFALSEIn-store Date From10
setPromotionDates2String.CommitDateFALSECommit Date10
setPromotionDates2String.DeliveryDateFromFALSEShipment Date From10
setPromotionTemplateForDerive2String.PromotionTemplateTRUEName or SID of the Promotion Template to use for derivation.40
setTacticConditionCreationDefinitionsString[*].AdditionalKPI2FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitionsString[*].AdditionalKPI3FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitionsString[*].AdditionalKPI1FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitionsBoolean[*].DuplicateCheckFALSEDetermines whether the system should check for duplicate internal conditions.NA
setTacticConditionCreationDefinitionsString[*].MaintenanceFALSEDefines the action on the conditions generated by the tactic.255
setTacticConditionCreationDefinitionsString[*].MeasureCodeFALSEDefines the override measure code used to generate the condition.4
setTacticConditionCreationDefinitionsString[*].ChangeRuleFALSEDetermines the rule to handle past conditions.255
setTacticConditionCreationDefinitionsString[*].ProductLevelFALSEDefines the product level at which condition is generated.255
setTacticConditionCreationDefinitionsString[*].SourceKPITRUEKPI Definition used for generating conditions.80
setTacticConditionCreationDefinitionsString[*].AllowedProductLevelsFALSEWhen product level is empty in the input, the system considers only the levels allowed by this field while automatically determining the product level at which conditions are generated. When empty, the system considers all product levels as valid product levels for condition generation.160
setTacticConditionCreationDefinitionsString[*].TargetsFALSEDefines the targets to which the conditions are written.40
setTacticConditionCreationDefinitions(update)String[*].SourceKPIFALSEKPI Definition used for generating conditions.80
setTacticConditionCreationDefinitions(update)String[*].AdditionalKPI1FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions(update)String[*].AdditionalKPI3FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions(update)String[*].TargetsFALSEDefines the targets to which the conditions are written.40
setTacticConditionCreationDefinitions(update)String[*].AdditionalKPI2FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions(update)String[*].AllowedProductLevelsFALSEWhen product level is empty in the input, the system considers only the levels allowed by this field while automatically determining the product level at which conditions are generated. When empty, the system considers all product levels as valid product levels for condition generation.160
setTacticConditionCreationDefinitions(update)String[*].ProductLevelFALSEDefines the product level at which condition is generated.255
setTacticConditionCreationDefinitions(update)String[*].ChangeRuleFALSEDetermines the rule to handle past conditions.255
setTacticConditionCreationDefinitions(update)String[*].MeasureCodeFALSEDefines the override measure code used to generate the condition.4
setTacticConditionCreationDefinitions(update)String[*].MaintenanceFALSEDefines the action on the conditions generated by the tactic.255
setTacticConditionCreationDefinitions(update)Boolean[*].DuplicateCheckFALSEDetermines whether the system should check for duplicate internal conditions.NA
setTacticConditionCreationDefinitions(update)String[*].UniqueMeasureCodeFALSEConcatenation of Tactic Id and Editable code of Source KPI Definition. Alternatively, this field may hold SFID of TCCD.22
setTacticConditionCreationDefinitions(update)2String[*].MaintenanceFALSEDefines the action on the conditions generated by the tactic.255
setTacticConditionCreationDefinitions(update)2Boolean[*].DuplicateCheckFALSEDetermines whether the system should check for duplicate internal conditions.NA
setTacticConditionCreationDefinitions(update)2String[*].UniqueMeasureCodeFALSEConcatenation of Tactic Id and Editable code of Source KPI Definition. Alternatively, this field may hold SFID of TCCD.22
setTacticConditionCreationDefinitions(update)2String[*].AdditionalKPI1FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions(update)2String[*].AdditionalKPI3FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions(update)2String[*].TargetsFALSEDefines the targets to which the conditions are written.40
setTacticConditionCreationDefinitions(update)2String[*].AdditionalKPI2FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions(update)2String[*].AllowedProductLevelsFALSEWhen product level is empty in the input, the system considers only the levels allowed by this field while automatically determining the product level at which conditions are generated. When empty, the system considers all product levels as valid product levels for condition generation.160
setTacticConditionCreationDefinitions(update)2String[*].SourceKPIFALSEKPI Definition used for generating conditions.80
setTacticConditionCreationDefinitions(update)2String[*].ProductLevelFALSEDefines the product level at which condition is generated.255
setTacticConditionCreationDefinitions(update)2String[*].ChangeRuleFALSEDetermines the rule to handle past conditions.255
setTacticConditionCreationDefinitions(update)2String[*].MeasureCodeFALSEDefines the override measure code used to generate the condition.4
setTacticConditionCreationDefinitions2Boolean[*].DuplicateCheckFALSEDetermines whether the system should check for duplicate internal conditions.NA
setTacticConditionCreationDefinitions2String[*].MaintenanceFALSEDefines the action on the conditions generated by the tactic.255
setTacticConditionCreationDefinitions2String[*].ChangeRuleFALSEDetermines the rule to handle past conditions.255
setTacticConditionCreationDefinitions2String[*].ProductLevelFALSEDefines the product level at which condition is generated.255
setTacticConditionCreationDefinitions2String[*].SourceKPITRUEKPI Definition used for generating conditions.80
setTacticConditionCreationDefinitions2String[*].AllowedProductLevelsFALSEWhen product level is empty in the input, the system considers only the levels allowed by this field while automatically determining the product level at which conditions are generated. When empty, the system considers all product levels as valid product levels for condition generation.160
setTacticConditionCreationDefinitions2String[*].AdditionalKPI2FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions2String[*].TargetsFALSEDefines the targets to which the conditions are written.40
setTacticConditionCreationDefinitions2String[*].AdditionalKPI3FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions2String[*].AdditionalKPI1FALSEKPI definition used to provide additional information for the condition.80
setTacticConditionCreationDefinitions2String[*].MeasureCodeFALSEDefines the override measure code used to generate the condition.4
setTacticDatesString.ShipmentDateThruFALSEShipment Date Thru10
setTacticDatesString.DateThruFALSEDate Thru10
setTacticDatesString.DateFromFALSEDate From10
setTacticDatesString.InStoreDateThruFALSEIn Store Date Thru10
setTacticDatesString.InStoreDateFromFALSEIn Store Date From10
setTacticDatesString.ShipmentDateFromFALSEShipment Date From10
setTacticDates2String.InStoreDateFromFALSEIn Store Date From10
setTacticDates2String.InStoreDateThruFALSEIn Store Date Thru10
setTacticDates2String.DateFromFALSEDate From10
setTacticDates2String.ShipmentDateThruFALSEShipment Date Thru10
setTacticDates2String.ShipmentDateFromFALSEShipment Date From10
setTacticDates2String.DateThruFALSEDate Thru10
movePromotionTimeframeDerive2String.InStoreDateFromFALSEPromotion’s new In Store Date From. If specified, all promotion dates will be shifted by the difference in days between the input Date and the Promotion current Date From date.10