SCHED: EditTask
Format
SCHED / EditTask {AttributeName} <Parameter>
Description
The SCHED EditTask Connect command edits the attributes of a task in STK Scheduler. This command can be used to edit a single task attribute or multiple attributes of a single task. When editing multiple task attributes, all attributes will be applied to the task in the order in which they appear in the command with four exceptions. The Locked, Deferred,Assignments, and OperationalStatus keywords get applied in the order listed here after all other keywords get applied.
All tasks are initially created with default attribute values.
Anytime a parent definition is edited, it will cause its children to be recreated. The newly created children will not have any assignments until the schedule is deconflicted.
The order of keywords should follow the order shown in the command description table below, as this follows the GUI field ordering and the order necessary for proper task creation.
| {AttributeName} | Description |
|---|---|
| General Parameters | |
| Description | Create a description for the given task |
| Priority | Set the priority of the given task based on the priority scale set by the user |
| Preference | Defines the scheduling preference for a task |
| TimeslotPreference | Defines the timeslot preference for a task |
| TimeslotDurationPreference | Defines the timeslot duration preference for a task |
| Groups | Defines which groups the given task is in |
| Defines whether the task's assignments can also be used to assign other task's assignments via bonusing (Bonusing plug-in) | |
| Changes a given task's TaskID to a new value specified by the user. | |
| STK Parameters | |
| ObjectLineColor | Sets the color of the object line for this task |
| SatelliteOrbitOptions | Defines various orbit options for all associated satellites of this task |
| Scheduling Parameters | |
| RecurringType | Sets the recurring type of the task |
| Scheduling - Non Recurring Parameters | |
| NonRecurringDiscreteWindows | Define discrete windows for non recurring tasks |
| NonRecurringPeriodicWindows | Define periodic windows for non recurring tasks |
| NonRecurringTimeImport | Defines windows for non recurring tasks via a file import |
| NonRecurringSTKReports | Defines windows for non recurring tasks via STK reports |
| Scheduling - Recurring Parameters | |
| RecurringDiscreteWindows | Define discrete windows for recurring tasks |
| RecurringPeriodicWindows | Define periodic windows for recurring tasks |
| RecurringTimeImport | Defines windows for recurring tasks via a file import |
| RecurringSTKReportsRepeats | Defines windows for non recurring tasks via STK reports |
| ApplyDurationExtension | Determines whether timeslots will be extended for child tasks |
| RecurringConstraints | Defines the interval constraints for recurring tasks |
| Duration Parameters | |
| DurationIsVariableAllowed | Defines whether the task's assignments are of a variable or fixed duration |
| DurationIsFullSlotRequired | Defines whether a task's assignment must be the same duration as its containing time slot |
| DurationIsMultipleSegmentsAllowed | Defines whether a task can only have a single assignment or multiple assignments |
| DurationIsResourceChangesAllowed | Defines whether the same resource possibility must be used amongst all of a task's assignments |
| DurationIsOverlapRequired | Defines whether the task is allowed to have time gaps between assignments or if the task's adjacent assignments must overlap |
| DurationFixed | Defines the task's fixed duration constraint |
| DurationMinSegment | Defines the task's minimum segment duration for tasks that allow multiple segments |
| DurationMinTotal | Defines the minimum combined duration of all of the task's assignments |
| DurationMaxTotal | Defines the maximum combined duration of all of the task's assignments |
| DurationOverlap | Defines the duration of overlap between adjacent assignments for the task |
| DurationMaxOverlap | Defines the maximum duration of overlap between adjacent assignments for the task |
| Resource Parameters | |
| RetainAssignments | Can be specified to allow a task or it's children to retain their assignments when editing |
| ResourceFormula | Defines the resources that this task uses |
| UseCommonSetupTime | Defines whether a task must use the same setup time for all resources in that task |
| RetainSettings | Defines whether previous resouce usage definition values will be retained when creating possibilities (true by default), if the ResourceFormula parameter is also specified |
| Resource - Per Possibility Parameters | |
| SetPossibilityPriority | Defines the priority for a task possibility |
| SetPossibilityTimeslotDurPref | Defines the timeslot duration preference for a task possibility |
| SetPossibilitySTKReports | Defines windows via STK reports for a task possibility |
| SetPossibilityTimeImports | Defines windows via file import for a task possibility |
| SetPossibilityTimesReport | Overrides and explicitly sets the possibility's list of report times for the given task |
| SetPossibilityTimesExact | Overrides and explicitly sets the possibility's list of final timeslots for the given task |
| SetPossibilityTimeslot | Defines the start and stop times of a timeslot for a task possibility |
| SetPossibilityResourceUsageType | Defines the resource usage type for a task possibility |
| SetPossibilityResourceRateType | Defines the resource usage rate type for a task possibility |
| SetPossibilityResourceAmount | Defines the resource usage amount for a task possibility |
| SetPossibilityResourceRatePeriod | Defines the resource usage rate period for a task possibility |
| SetPossibilityResourceAccommodation | Defines the resource accommodation for a task possibility |
| SetPossibilityResourceMinSetup | Defines the resource's minimum setup time for a task possibility |
| SetPossibilityResourceBreakdown | Defines the resource's breakdown time for a task possibility |
| SetPossibilityResourceDurationOverride | Defines the resource's duration override for a task possibility |
| SetPossibilityResourceCost | Defines the resource cost for a task possibility |
| SetPossibilityResourceSetupModes | Defines the usable resource state setup modes for a task possibility |
| SetPossibilityResourceBodyModes | Defines the usable resource state body modes for a task possibility |
| SetPossibilityResourceBreakdownModes | Defines the usable resource state breakdown modes for a task possibility |
| SetPossibilityResourceRange | Defines the resource range constraint for a task possibility |
| SetPossibilityResourceAnimation | Defines the resource animation type for a task possibility |
| Resource - Per Task Parameters | |
| SetTaskResourceUsageType | Defines the resource usage type for all of the task's possibilities that use a specified resource |
| SetTaskResourceRateType | Defines the resource usage rate type for all of the task's possibilities that use a specified resource |
| SetTaskResourceAmount | Defines the resource usage amount for all of the task's possibilities that use a specified resource |
| SetTaskResourceRatePeriod | Defines the resource usage rate period for all of the task's possibilities that use a specified resource |
| SetTaskResourceAccommodation | Defines the resource accommodation for all of the task's possibilities that use a specified resource |
| SetTaskResourceMinSetup | Defines the resource's minimum setup time for all of the task's possibilities that use a specified resource |
| SetTaskResourceBreakdown | Defines the resource's breakdown time for all of the task's possibilities that use a specified resource |
| SetTaskResourceDurationOverride | Defines the resource's duration override for all of the task's possibilities that use a specified resource |
| SetTaskResourceCost | Defines the resource cost for all of the task's possibilities that use a specified resource |
| SetTaskResourceSetupModes | Defines the usable resource state setup modes for all of the task's possibilities that use a specified resource |
| SetTaskResourceBodyModes | Defines the usable resource state body modes for all of the task's possibilities that use a specified resource |
| SetTaskResourceBreakdownModes | Defines the usable resource state breakdown modes for all of the task's possibilities that use a specified resource |
| SetTaskResourceRange | Defines the resource range constraint for all of the task's possibilities that use a specified resource |
| SetTaskResourceAnimation | Defines the resource animation type for all of the task's possibilities that use a specified resource |
| Dependency Parameters | |
| SetAnchor | Defines whether the task has to be the first or last task scheduled |
| Dependencies | Defines the dependencies for a task |
| Notes Parameters | |
| Notes | Define notes for the given task |
| Status Parameters | |
| Locked | Defines whether a task is locked |
| Deferred | Defines whether a task is deferred |
| Assignments | Defines the assignments for the task |
| OperationalStatus | Sets the Operational Status of a task |
| Hide | Defines whether a task is hidden from the gantt view |
Examples
Changes the values of the Description, Priority, and RecurringDiscreteWindows attributes of the SSRDump task in the active schedule to "This is a test", 7, and 2002/05/20 12:00:00.456 2002/05/20 12:52:00 "Demo comment", respectively
SCHED / EditTask 'SSRDump' Description 'This is a test' Priority 7 RecurringDiscreteWindows 1 2002/05/20_12:00:00.456 2002/05/20_12:52:00 'Demo comment'| Syntax | Example |
|---|---|
| <CommandName> | SCHED / EditTask |
| <TaskName> | 'SSRDump' |
| {AttributeName} | Description |
| <Parameters> | 'This is a test' |
| {AttributeName} | Priority |
| <Parameters> | 7 |
| {AttributeName} | RecurringDiscreteWindows |
| <Parameters> | 1 2002/05/20_12:00:00.456 2002/05/20_12:52:00 'Demo comment' |
Return Message
If activated, Connect returns an acknowledgment message.
Group Membership
This command belongs to the following group(s):
Version
4.3.1 and 5.0
