org.optaplanner.core.api.domain.entity

Annotation Type PlanningPin

@Target(value={METHOD,FIELD})
 @Retention(value=RUNTIME)
public @interface PlanningPin

Specifies that a boolean property (or field) of a PlanningEntity determines if the planning entity is immovable. An immovable planning entity is never changed during planning. For example, it allows the user to pin a shift to a specific employee before solving and the solver will not undo that, regardless of the constraints.

The boolean is false if the planning entity is movable and true if the planning entity is immovable (AKA pinned).

It applies to all the planning variables of that planning entity. To make individual variables immovable, see https://issues.jboss.org/browse/PLANNER-124

This is syntactic sugar for PlanningEntity.movableEntitySelectionFilter(), which is a more flexible and verbose way to make a planning entity immovable.