Options
All
  • Public
  • Public/Protected
  • All
Menu

This mixin provides the fixed duration scheduling mode facility. The scheduling mode is controlled with the HasSchedulingModeMixin.schedulingMode field.

See HasSchedulingModeMixin for more details.

In this mode, the duration of the task remains "fixed" as the name suggest. It is changed only if there's no other options, for example if both "effort" and "units" has changed. In other cases, some other variable is updated.

If the HasSchedulingModeMixin.effortDriven flag is enabled, effort variable becomes "fixed" as well, so normally the "units" variable will change. If that flag is disabled, then "effort" will be changed.

Hierarchy

Index

Properties

Accessors

Methods

Properties

$project

The project instance, this entity belongs to.

assigned

assigned: Set<InstanceType<this["project"]["assignmentModelClass"]>>

A set of resources assigned to this task

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

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.

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.

effort

effort: Duration

The effort of this event. See also effortUnit.

effortDriven

effortDriven: boolean

Whether the effort of the task is "fixed". The FixedEffortMixin operates as if this flag is always enabled.

effortUnit

effortUnit: TimeUnit

The time unit of the effort field.

endDate

endDate: Date

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

getCalendar

getCalendar: () => BaseCalendarMixin

Gets the calendar.

Type declaration

getDirection

getDirection: () => Direction

Getter for direction field.

Type declaration

getEffortDriven

getEffortDriven: () => boolean

Generated getter for the effortDriven field.

Type declaration

    • (): boolean
    • Returns boolean

getEffortUnit

getEffortUnit: () => TimeUnit

Generated getter for the effortUnit

Type declaration

getEndDate

getEndDate: () => Date

Gets the event end date.

Type declaration

    • (): Date
    • Returns Date

getSchedulingMode

getSchedulingMode: () => SchedulingMode

Generated getter for the schedulingMode field.

Type declaration

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)

ignoreResourceCalendar

ignoreResourceCalendar: boolean

Ignore assigned resource calendars when scheduling the event. If setting this to true the event dates/duration will be calculated based on the event calendar only.

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.

parentEvent

parentEvent: HasChildrenMixin

A reference to the parent event

project

The project instance, this entity belongs to.

schedulingMode

schedulingMode: SchedulingMode

The scheduling mode of the task.

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

setDirection

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

Setter for direction field.

Type declaration

setEffort

setEffort: (effort: Duration, unit?: TimeUnit) => Promise<CommitResult>

Generated setter for the effort

Type declaration

setEffortDriven

setEffortDriven: (effortDriven: boolean) => Promise<CommitResult>

Generated setter for the effortDriven field.

Type declaration

setSchedulingMode

setSchedulingMode: (schedulingMode: SchedulingMode) => Promise<CommitResult>

Generated setter for the schedulingMode field.

Type declaration

startDate

startDate: Date

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

Private zeroDurationMsThreshold

zeroDurationMsThreshold: number

The threshold used for handling floating-point precision issues when comparing duration values. When a duration value is float and has non-zero milliseconds the code uses the threshold to detect if a duration value is zero.

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

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

assign

  • assign(resource: InstanceType<this["project"]["resourceModelClass"]>, units?: number, rateTable?: any, cost?: number): Promise<CommitResult>
  • A method which assigns a resource to the current event

    Parameters

    • resource: InstanceType<this["project"]["resourceModelClass"]>
    • Default value units: number = undefined
    • Default value rateTable: any = undefined
    • Default value cost: number = undefined

    Returns Promise<CommitResult>

calculateDuration

calculateDurationProposed

calculateDurationPure

calculateEffectiveCalendar

calculateEffectiveVisualCalendar

calculateEndDate

calculateEndDateProposed

calculateEndDatePure

calculateMaxChildrenEndDate

calculateMinChildrenStartDate

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

calculateTotalChildrenEffort

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"]

getAssignmentFor

  • getAssignmentFor(resource: InstanceType<this["project"]["resourceModelClass"]>): InstanceType<this["project"]["assignmentModelClass"]> | null
  • If a given resource is assigned to this task, returns a BaseAssignmentMixin instance for it. Otherwise returns null

    Parameters

    • resource: InstanceType<this["project"]["resourceModelClass"]>

    Returns InstanceType<this["project"]["assignmentModelClass"]> | null

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"]

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

getEffort

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

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

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.

shouldRollupChildEffort

  • The method defines whether the provided child event should roll up its effort to this summary event or not. If the method returns true the child event effort is summed up when calculating this summary event effort. And if the method returns false the child effort is not taken into account. By default the method returns true to include all child event effort values.

    Parameters

    • childEvent: HasEffortMixin

      Child event to consider.

    Returns CalculationIterator<boolean>

    true if the provided event effort should be included, 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.

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.

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

  • Returns iterable object listing the event nested sub-events.

    ```typescript const subEventsIterator : Iterable = yield* event.subEventsIterable()

    for (let childEvent of subEventsIterator) { // ..do something.. }

    Returns CalculationIterator<Iterable<HasChildrenMixin>>

unassign

  • unassign(resource: InstanceType<this["project"]["resourceModelClass"]>): Promise<any>
  • A method which unassigns a resource from the current event

    Parameters

    • resource: InstanceType<this["project"]["resourceModelClass"]>

    Returns Promise<any>

userProvidedValue

Generated using TypeDoc