Prerequisites for calling history replacement engine

These are the prerequisites to call the history replacement engine:

  • The user or one of the user roles, must have access to the macro as well as the forecast engine specified in the engine name parameter. Else, this error message is displayed:
    History Replacement engine {0} is not accessible to user {1} 
  • Data security rules for the current user executing the macro are applied to determine the item and location elements that must be passed to the Engine for calculations, based on the passed Item and Location Hierarchy levels and selection of the Item and the Location. For example, CallForecastEngine("History Replacement engine","","","Brand","Brand A","Region","US","Months"):
    • If the current user’s data security does not allow the user to view Brand A, or the base items under Brand A in the item hierarchy, the selected items are not passed to the engine.
    • If the user can access a subset of base elements under Brand A, the history replacement data is generated for these items only.
    • If the current user’s data security does not allow the user to view US or the base locations under US in the location hierarchy, the selected locations are not passed to the engine.
    • If the user can access a subset of base locations under US, the history replacement data is generated for these locations only.
    • If period restrictions prevent the users from accessing the entire horizon of the cycle period, the engine result is generated only for the subset of base periods to which the user has access. For example, if a user is restricted to the 'future base periods' rolling period, the engine result cannot be written back to historical periods, as the user do not have access to historical periods.