Options
All
  • Public
  • Public/Protected
  • All
Menu

This mixin provides the constraint-based as-late-as-possible scheduling. See the ConstrainedEarlyEventMixin for the description of the ASAP constraints-based scheduling. See GanttProjectMixin for more details about forward/backward, ASAP/ALAP scheduling.

It also provides the facilities for calculating the event's totalSlack and the critical flag.

The ALAP-specific constraints are accumulated in lateSchedule, latePreSchedule fields.

tier

core

Hierarchy

Index

Properties

Accessors

Methods

Properties

$project

The project instance, this entity belongs to.

calendar

The calendar of this entity.

Please use effectiveCalendar to get the calendar that is actually used by the entity. The calendar reflects only the value provided to this entity while effectiveCalendar returns the calendar that is really used (falls back to the project calendar in case the own calendar is not provided).

childEvents

childEvents: Set<HasChildrenMixin>

A set of references to child events

constraintDate

constraintDate: Date

The date of the constraint, applied to this event

constraintType

constraintType: ConstraintType

The type of constraint, applied to this event

critical

critical: boolean

A boolean field, indicating whether the event is critical or not. The event is critical if its total slack is zero (or less than zero). This means that if the event is delayed, its successor tasks and the project finish date are delayed as well.

direction

direction: Direction

The scheduling direction of the event. The Forward direction corresponds to the as-soon-as-possible scheduling (ASAP), Backward - to as-late-as-possible (ALAP).

If not specified (which is the default), direction is inherited from the parent task (and from project for the top-level tasks). By default, the project model has forward scheduling mode.

dispatcher

dispatcher: SEDDispatcher

The dispatcher instance for this event. Dispatcher accumulates the information about user input and decide which formula to use for calculation of every related field (startDate, endDate and duration at this level).

Every field can be calculated with 2 type of formulas. The 1st one is called "proposed" and it is used when there is a user input for this field ("proposed" input), or, when user intention is to keep the previous value of the field. The 2nd type is called "pure" and it is used, when a value of the field should be calculated "purely" based on the values of other fields.

See CycleResolverGuide for more information.

duration

duration: Duration

The duration of the event. See also durationUnit.

durationUnit

durationUnit: TimeUnit

The duration unit of the event's duration. See also duration.

earlyEndDate

earlyEndDate: Date

The earliest possible date the event can finish. This value is calculated based on the event restrictions.

earlyStartDate

earlyStartDate: Date

The earliest possible date the event can start. This value is calculated based on the event restrictions.

effectiveCalendar

effectiveCalendar: BaseCalendarMixin

The effective calendar used by this entity (either its own calendar if provided or the project calendar) for data calculation purposes.

effectiveVisualCalendar

effectiveVisualCalendar: BaseCalendarMixin

The effective calendar used by this entity (either its own calendar if provided or the project calendar) for data visualizing purposes.

endDate

endDate: Date

The end date of the event. Can also be provided as a string, parsable with DateHelper.parse()

endDateConstraintIntervals

endDateConstraintIntervals: DateInterval[]

Field to accumulate the "generic" constraints for end date (which are not related to ASAP scheduling). It is calculated with calculateEndDateConstraintIntervals.

getCalendar

getCalendar: () => BaseCalendarMixin

Gets the calendar.

Type declaration

getDirection

getDirection: () => Direction

Getter for direction field.

Type declaration

getEndDate

getEndDate: () => Date

Gets the event end date.

Type declaration

    • (): Date
    • Returns Date

getStartDate

getStartDate: () => Date

Gets the event start date

Type declaration

    • (): Date
    • Returns Date

graph

graph: Replica

A reference to the graph, this entity belongs to. Initially empty, and is populated when the entity instance is added to the replica (Replica.addEntity)

inactive

inactive: Boolean

Inactive events do not affect successors nor rollup their attributes to parent events.

incomingDeps

incomingDeps: Set<InstanceType<this["project"]["dependencyModelClass"]>>

A set of incoming dependencies for this task (dependencies which ends at this task)

lateEndDate

lateEndDate: Date

The latest possible date the event can finish. This value is calculated based on the event restrictions.

lateStartDate

lateStartDate: Date

The latest possible date the event can start. This value is calculated based on the event restrictions.

manuallyScheduled

manuallyScheduled: boolean

A boolean field, indicating whether this event should be scheduled automatically or its startDate and endDate are supposed to be defined manually.

outgoingDeps

outgoingDeps: Set<InstanceType<this["project"]["dependencyModelClass"]>>

A set of outgoing dependencies from this task (dependencies which starts at this task)

parentEvent

parentEvent: HasChildrenMixin

A reference to the parent event

percentDone

percentDone: number

The percent done for this event.

postponedConflict

postponedConflict: ConflictEffect

A postponed scheduling conflict of the task (if any).

project

The project instance, this entity belongs to.

setCalendar

setCalendar: (calendar: BaseCalendarMixin | ModelId) => Promise<CommitResult>

Sets the calendar. The method triggers schedule change propagation and returns a Promise:

// set calendar
model.setCalendar(calendar1).then(() => {
    // some code to run after schedule got updated
    ...
})

It also adds the calendar to the project calendar manager.

Type declaration

setConstraintDate

setConstraintDate: (constrainDate: Date) => Promise<CommitResult>

Sets the constraint date of the event.

param

Constraint date.

returns

Promise

Type declaration

setConstraintType

setConstraintType: (constrainType: ConstraintType) => Promise<CommitResult>

Sets the constraint type of the event.

param

Constraint type.

returns

Promise

Type declaration

setDirection

setDirection: (value: Direction) => Promise<CommitResult>

Setter for direction field.

Type declaration

slackUnit

slackUnit: TimeUnit

A field storing unit for the totalSlack value.

startDate

startDate: Date

The start date of the event. Can also be provided as a string, parsable with DateHelper.parse()

startDateConstraintIntervals

startDateConstraintIntervals: DateInterval[]

Field to accumulate the "generic" constraints for start date (which are not related to ASAP scheduling). It is calculated with calculateStartDateConstraintIntervals.

totalSlack

totalSlack: Duration

A field storing the total slack (or total float) of the event. The total slack is the amount of time that this event can be delayed without causing a delay to the project end. The value is calculated in slackUnit units.

Static endDateNonWorkingTimeSkipDirection

endDateNonWorkingTimeSkipDirection: Direction = Direction.Backward

Specifies the direction of how the event skips non-working time when calculating its endDate. Default value Direction.Backward

Static startDateNonWorkingTimeSkipDirection

startDateNonWorkingTimeSkipDirection: Direction = Direction.Forward

Specifies the direction of how the event skips non-working time when calculating its startDate. Default value Direction.Forward

Accessors

$

  • get $(): {}
  • An object, which properties corresponds to the ChronoGraph Identifiers, created for every field.

    For example:

    class Author extends Entity.mix(Base) {
        @field()
        firstName       : string
        @field()
        lastName        : string
    }
    
    const author = Author.new()
    
    // identifier for the field `firstName`
    author.$.firstName
    
    const firstName = replica.read(author.$.firstName)

    Returns {}

$$

  • A graph identifier, that represents the whole entity.

    Returns EntityIdentifier

$entity

  • An EntityMeta instance, representing the "meta" information about the entity class. It is shared among all instances of the class.

    Returns EntityMeta

earlyPreSchedule

earlySchedule

latePreSchedule

lateSchedule

Static $entity

  • An EntityMeta instance, representing the "meta" information about the entity class. It is shared among all instances of the class.

    Returns EntityMeta

Methods

calculateDuration

calculateDurationProposed

calculateDurationPure

calculateEffectiveCalendar

calculateEffectiveVisualCalendar

calculateEndDate

calculateEndDateProposed

calculateEndDatePure

calculateMaxChildrenEndDate

calculateMinChildrenStartDate

calculatePercentDone

calculateProjectedDuration

calculateProjectedXDateWithDuration

  • This method calculates the opposite date of the event.

    Parameters

    • baseDate: Date

      The base date of the event (start or end date)

    • isForward: boolean

      Boolean flag, indicating whether the given baseDate is start date (true) or end date (false)

    • duration: Duration

      Duration of the event, in its durationUnits

    • Optional durationUnit: TimeUnit

    Returns CalculationIterator<Date>

calculateStartDate

calculateStartDateProposed

calculateStartDatePure

canConvertDuration

  • Indicates whether the event can perform the provided duration conversion. The event might not be able to convert units on early stages of data loading when the project has not loaded its conversion rates yet. So the method by default checks that the project has loaded the rates needed for conversion.

    Parameters

    • duration: Duration

      Duration value

    • fromUnit: TimeUnit

      Duration value time unit

    • toUnit: TimeUnit

      Target time unit to convert the value to

    Returns boolean

commit

  • This is a convenience method, that just delegates to the ChronoGraph.commit method of this entity's graph.

    If there's no graph (entity has not been added to any replica) a CommitZero constant will be returned.

    Parameters

    Returns CommitResult

commitAsync

  • This is a convenience method, that just delegates to the ChronoGraph.commitAsync method of this entity's graph.

    If there's no graph (entity has not been added to any replica) a resolved promise with CommitZero constant will be returned.

    Parameters

    Returns Promise<CommitResult>

convertDurationGen

enterGraph

  • enterGraph(replica: Replica): void
  • This method is called when entity is added to some replica.

    Parameters

    Returns void

getAssignmentById

  • getAssignmentById(id: ModelId): this["project"]["assignmentStore"]["modelInstanceT"]
  • Convenience method to get the instance of assignment by its id.

    Parameters

    • id: ModelId

    Returns this["project"]["assignmentStore"]["modelInstanceT"]

getAssignmentStore

  • getAssignmentStore(): this["project"]["assignmentStore"]
  • Convenience method to get the instance of the assignment store in the project instance, this entity belongs to.

    Returns this["project"]["assignmentStore"]

getCalendarById

  • getCalendarById(id: ModelId): this["project"]["calendarManagerStore"]["modelInstanceT"]
  • Convenience method to get the instance of calendar by its id.

    Parameters

    • id: ModelId

    Returns this["project"]["calendarManagerStore"]["modelInstanceT"]

getCalendarManagerStore

  • getCalendarManagerStore(): this["project"]["calendarManagerStore"]
  • Convenience method to get the instance of the calendar manager store in the project instance, this entity belongs to.

    Returns this["project"]["calendarManagerStore"]

getConstraintTypeDefaultDate

  • getConstraintTypeDefaultDate(Y: any, constraintType: ConstraintType): Date
  • Returns default constraint date value for the constraint type provided (either start or end date of the event).

    Parameters

    Returns Date

getDependencyById

  • getDependencyById(id: ModelId): this["project"]["dependencyStore"]["modelInstanceT"]
  • Convenience method to get the instance of dependency by its id.

    Parameters

    • id: ModelId

    Returns this["project"]["dependencyStore"]["modelInstanceT"]

getDependencyStore

  • getDependencyStore(): this["project"]["dependencyStore"]
  • Convenience method to get the instance of the dependency store in the project instance, this entity belongs to.

    Returns this["project"]["dependencyStore"]

getDuration

  • Duration getter. Returns the duration of the event, in the given unit. If unit is not given, returns duration in durationUnit.

    Parameters

    Returns Duration

getDurationConverter

getEventById

  • getEventById(id: ModelId): this["project"]["eventStore"]["modelInstanceT"]
  • Convenience method to get the instance of event by its id.

    Parameters

    • id: ModelId

    Returns this["project"]["eventStore"]["modelInstanceT"]

getEventStore

  • getEventStore(): this["project"]["eventStore"]
  • Convenience method to get the instance of the event store in the project instance, this entity belongs to.

    Returns this["project"]["eventStore"]

getGraph

getProject

  • getProject(): this["project"]

getResourceById

  • getResourceById(id: ModelId): this["project"]["resourceStore"]["modelInstanceT"]
  • Convenience method to get the instance of resource by its id.

    Parameters

    • id: ModelId

    Returns this["project"]["resourceStore"]["modelInstanceT"]

getResourceStore

  • getResourceStore(): this["project"]["resourceStore"]
  • Convenience method to get the instance of the resource store in the project instance, this entity belongs to.

    Returns this["project"]["resourceStore"]

hasSubEvents

isConstraintTypeApplicable

Private isTaskPinnableWithConstraint

  • isTaskPinnableWithConstraint(): boolean
  • Indicates if the task can be pinned with a constraint to enforce its start/end date changes.

    Returns boolean

joinProject

  • joinProject(): void

leaveGraph

  • This method is called when entity is removed from the replica it's been added to.

    Parameters

    Returns void

leaveProject

  • leaveProject(isReplacing?: boolean): void

setConstraint

  • Sets the constraint type (if applicable) and constraining date to the task.

    Parameters

    • constraintType: ConstraintType

      Constraint type.

    • Optional constraintDate: Date

    Returns Promise<CommitResult>

    Promise

setDuration

  • Duration setter.

    Parameters

    • duration: Duration

      The new duration to set.

    • Optional unit: TimeUnit

      The unit for new duration. Optional, if missing the durationUnit value will be used.

    • Optional keepStart: boolean

      A boolean flag, indicating, whether the intention is to keep the start date (true) or end date (false)

    Returns Promise<CommitResult>

    A Promise resolved when the schedule has been recalculated. Await it before reading the resulting dates back from the record.

setEndDate

  • setEndDate(date: Date, keepDuration?: boolean): Promise<CommitResult>
  • Sets the event end date.

    Parameters

    • date: Date

      The new end date to set

    • Default value keepDuration: boolean = false

      Whether the intention is to keep the duration field (keepDuration = true) or startDate (keepDuration = false)

    Returns Promise<CommitResult>

    A Promise resolved when the schedule has been recalculated. Await it before reading the resulting dates back from the record.

setProject

  • setProject(project: this["project"]): this["project"]
  • The method to set the project instance, this entity belongs to.

    Parameters

    • project: this["project"]

    Returns this["project"]

setStartDate

  • setStartDate(date: Date, keepDuration?: boolean): Promise<CommitResult>
  • Sets the event start date

    Parameters

    • date: Date

      The new start date to set

    • Default value keepDuration: boolean = true

      Whether the intention is to keep the duration field (keepDuration = true) or endDate (keepDuration = false)

    Returns Promise<CommitResult>

    A Promise resolved when the schedule has been recalculated. Await it before reading the resulting dates back from the record.

shouldPredecessorAffectScheduling

  • The method is used during forward (from start to end) scheduling. It defines whether the provided dependency should constrain the successor or not. If the method returns true the dependency constrains the successor and does not do that when false returned. By default the method returns true if the dependency is active and if this event is active (or both this event and the successor are inactive).

    Parameters

    Returns CalculationIterator<boolean>

    true if the dependency should constrain successor, false if not.

shouldRollupChildEarlyEndDate

  • shouldRollupChildEarlyEndDate(child: ConstrainedEarlyEventMixin): CalculationIterator<boolean>
  • The method defines whether the provided child event should be taken into account when calculating this summary event earlyEndDate. Child events roll up their earlyEndDate values to their summary tasks. So a summary task earlyEndDate gets equal to its maximal child earlyEndDate.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default, the method returns true to include all child events data.

    Parameters

    • child: ConstrainedEarlyEventMixin

      Child event to consider.

    Returns CalculationIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldRollupChildEarlyStartDate

  • shouldRollupChildEarlyStartDate(child: ConstrainedEarlyEventMixin): CalculationIterator<boolean>
  • The method defines whether the provided child event should be taken into account when calculating this summary event earlyStartDate. Child events roll up their earlyStartDate values to their summary tasks. So a summary task earlyStartDate date gets equal to its minimal child earlyStartDate.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default, the method returns true to include all child events data.

    Parameters

    • child: ConstrainedEarlyEventMixin

      Child event to consider.

    Returns CalculationIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldRollupChildEndDate

  • The method defines whether the provided child event should be taken into account when calculating this summary event endDate. Child events roll up their endDate values to their summary tasks. So a summary task end gets equal to its maximal child end.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default the method returns true to include all child events data.

    Parameters

    Returns CalculationIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldRollupChildLateEndDate

  • shouldRollupChildLateEndDate(childEvent: ConstrainedEarlyEventMixin): CalculationIterator<boolean>
  • The method defines whether the provided child event should be taken into account when calculating this summary event lateEndDate. Child events roll up their lateEndDate values to their summary tasks. So a summary task lateEndDate gets equal to its maximal child lateEndDate.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default the method returns true to include all child events data.

    Parameters

    • childEvent: ConstrainedEarlyEventMixin

      Child event to consider.

    Returns CalculationIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldRollupChildLateStartDate

  • shouldRollupChildLateStartDate(childEvent: ConstrainedEarlyEventMixin): CalculationIterator<boolean>
  • The method defines whether the provided child event should be taken into account when calculating this summary event lateStartDate. Child events roll up their lateStartDate values to their summary tasks. So a summary task lateStartDate date gets equal to its minimal child lateStartDate.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default the method returns true to include all child events data.

    Parameters

    • childEvent: ConstrainedEarlyEventMixin

      Child event to consider.

    Returns CalculationIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldRollupChildPercentDoneSummaryData

  • shouldRollupChildPercentDoneSummaryData(childEvent: HasPercentDoneMixin): ChronoIterator<boolean>
  • The method defines whether the provided child event should be taken into account when calculating this summary event percentDone.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default the method returns true to include all child events data.

    Parameters

    • childEvent: HasPercentDoneMixin

      Child event to consider.

    Returns ChronoIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldRollupChildStartDate

  • The method defines whether the provided child event should be taken into account when calculating this summary event startDate. Child events roll up their startDate values to their summary tasks. So a summary task start date gets equal to its minimal child start.

    If the method returns true the child event is taken into account and if the method returns false it's not. By default the method returns true to include all child events data.

    Parameters

    Returns CalculationIterator<boolean>

    true if the provided event should be taken into account, false if not.

shouldSuccessorAffectScheduling

  • The method is used during backward (from end to start) scheduling. It defines whether the provided dependency should constrain the predecessor or not. If the method returns true the dependency constrains the predecessor and does not do that when false returned. By default the method returns true if the dependency is active and if this event is active (or both this event and the predecessor are inactive).

    Parameters

    Returns CalculationIterator<boolean>

    true if the dependency should constrain successor, false if not.

skipNonWorkingTime

  • The method skips the event non working time starting from the provided date and going either forward or backward in time. It uses the event effective calendar to detect which time is not working.

    Parameters

    • date: Date

      Date to start skipping from

    • isForward: boolean

      Skip direction (true to go forward in time, false - backwards)

    Returns CalculationIterator<Date>

skipWorkingTime

  • The method skips the provided amount of the event working time starting from the date and going either forward or backward in time. It uses the event effective calendar to detect which time is not working.

    Parameters

    • date: Date

      Date to start skipping from

    • isForward: boolean

      Skip direction (true to go forward in time, false - backwards)

    • duration: Duration

      Amount of working time to skip

    • Optional unit: TimeUnit

      Units the duration value in (if not provided then duration is considered provided in durationUnit)

    Returns CalculationIterator<Date>

subEventsIterable

userProvidedValue

Generated using TypeDoc