---
title: "Perspective - Equipment Schedule"
description: "The Equipment Schedule component is a mix between the Status Chart, Gantt Chart, and Calendar components."
---

# Perspective - Equipment Schedule

> The Equipment Schedule component is a mix between the Status Chart, Gantt Chart, and Calendar components.

![](perspective-es-populated.png)

Component Palette Icon:

![](perspective-es-palette-icon.png)

## Description

 The Equipment Schedule component is a mix between the Status Chart, Gantt Chart, and Calendar components. It conveys equipment scheduling information in a concise and easily digestible format.

## Interface Elements

![](labeled.png)

| Icon | Element    | Description   |
| :--: | ------ | --- |
|  ![](marker.png)| Current Time Indicator | Marker that indicates the current time, according to the session's timestamp. Style can be configured via currentTimeIndicator.     |
|![](bands.png)   | State Bands | Bands indicating downtime and break events. Styles can be configured via downtimeEventStyle and breakEventStyle.    |
| ![](card.png)  | Standard Card |  A card on the equipment schedule corresponds to a scheduled event. During a Perspective Session, cards can be moved and resized by clicking and dragging.     |
| ![](card2.png) | Overlapping Card    | When more than one event is scheduled during the same time period for one item, an overlapping card will represent all events scheduled during that time period. Users can click the black drop down bar to select and edit individual events within the overlapping card.  |
| ![](level.png)     | Zoom level   | Sets the zoom level for the chart. Levels can be selected from the drop down menu or by clicking the magnifying glasses to zoom in or out. Valid values include month, day, 12-hr, 8-hr, 6-hr, 3-hr,15-min, hours, and minutes.    |
| ![](item.png)       | Add New Event   | Clicking within any empty square on the equipment schedule will allow the user to add a new event onto the chart. Note that [Component Events](perspective-equipment-schedule-scripting.md#component-events) must be configured and the addEnabled property must be true. |
|  | Primary Header  | Header that represents the full range of time displayed on the chart. Styles can be configured via headerStyles.primaryHeaderStyle.   |
|  | Secondary Header       | Header that represents subsets of time displayed in the Primary Header. Styles can be configured via headerStyles.secondaryHeaderStyle.    |
|  | Tertiary Header    | Header that represents subsets of time displayed in the Secondary Header. Styles can be configured via headerStyles.tertiaryHeaderStyle.  |

## Properties 

| **Name**             | Description         | Data Type          |  
| ------------- | ----------- | --------------- |
| addEnabled | If enabled, users can add events to an item's schedule. Note that Component Events must be configured to implement the desired functionality when the events are fired.       | boolean      |
| resizeEnabled | If enabled, users can resize events. Note that Component Events must be configured to implement the desired functionality when the events are fired.  | boolean    |
| moveEnabled | If enabled, users can move events. Note that Component Events must be configured to implement the desired functionality when the events are fired.      | boolean  |
| deleteEnabled   | If enabled, users can delete events. Note that Component Events must be configured to implement the desired functionality when the events are fired.   | boolean  |
| items   | The cells, or equipment items, with schedules displayed on the chart. Each row on the equipment schedule corresponds to one item.**id**: The ID for the item.**label**: The label for the item displayed on the equipment schedule. Value is a string.**iconConfig**: **path**: Image path to the icon. Value is string.**color**: The color of the icon. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector](appendix/reference-pages/color-selector-reference/color-selector-reference.mdx). Value is a string.**style**: Sets a style for the icon. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**headerStyle**: Sets a style for the header. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**rowStyle**: Sets a style for the row. Will override default styles set by the component's rowStyle property. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).|array|
| dateRange  | **startDate**: The beginning of the time range to display. Value is DateTime.**endDate**: The end of the time range to display. Value is DateTime. | object|
| defaultZoom   | Default zoom level for the chart. Valid values include month, day, 12-hr, 8-hr, 6-hr, 3-hr, 15-min, hours, and minutes. **Note:** The 15-min option is only available in version 8.1.17 and later. | value: string      |
| rowHeight     | Sets the height for all rows on the equipment schedule.   | value: numeric     |
| scheduledEvents | The scheduled events for all configured items.**itemId**: The item identifier where this event is scheduled.**eventId**: The event identifier of the scheduled event. The ID must be unique.**startDate**: The start date of the scheduled event. Value is DateTime.**endDate**: The end date of the scheduled event. Value is DateTime.**label**: The label for the event displayed on the equipment schedule. Value is string.**leadTime**: The amount of lead time to display on the equipment schedule before the scheduled event's startDate. Value is numeric (in seconds).**leadStyle**: Sets a style for the leadTime. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**percentDone**: If progressBar is enabled, this value will be displayed in the event's progress bar. Value is numeric.**style**: Sets a style for the event. Will override styles set by scheduledEventStyle. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object  |
| downtimeEvents  | Downtime events correlated to a specific item.| array    |
| breakEvents    | Scheduled breaks, which will appear as downtime for all items.   | array   |
| selectedEvent|**itemId**: The ID of the selected item.**eventId**: The ID of the selected event. |object  |
| progressBar  |**enabled**: If enabled, scheduled events will display a progress bar. Value is boolean.**bar**:**color**: The color of the progress bar. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector.](appendix/reference-pages/color-selector-reference/color-selector-reference.mdx). Value is string.**style**: Sets a style for the progress bar. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**track**:**color**: The color of the progress bar track. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector.](appendix/reference-pages/color-selector-reference/color-selector-reference.mdx). Value is string.**style**: Sets a style for the progress bar track. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**valueDisplay**:**enabled**: If enabled, the progress bar will display percentDone as a numeric value. Value is boolean.**format**: Sets a numeric format for the valueDisplay. Valid values include none, integer, percent, currency, and duration. Value is string.**justify**: Sets alignment for the valueDisplay on the progress bar. Valid values include left, center, and right. Value is string.**style**: Sets a style for the value display. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).| object |
| currentTimeIndicator |**color**: The color of the current time indicator. Can be chosen from color wheel, chosen from color palette, or entered as RGB or HSL value. See [Color Selector.](appendix/reference-pages/color-selector-reference/color-selector-reference.mdx). Value is string.**opacity**: The opacity level for the current time indicator. Value is numeric.**width**: The width of the current time indicator. Value is numeric. |object|
| headerStyles | **primaryHeaderStyle**: Sets a style for the primary header. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**secondaryHeaderStyle**: Sets a style for the secondary header. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).**tertiaryHeaderStyle**: Sets a style for the tertiary header. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).| object |
| rowStyle | Sets a style for all rows. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).| object |
| selectedEventStyle   | Sets a style for the selected event. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object             |
| scheduledEventStyle  | Sets a style for scheduled events. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object             |
| downtimeEventStyle   | Sets a style for downtime events. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object             |
| breakEventStyle      | Sets a style for break events. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md).| object             |
| bodyStyle            | Sets a style for the body. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object             |
| style                | Sets a style for the component. Full menu of  [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a  [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object             |

## Scripting
See the [Perspective - Equipment Schedule Scripting](perspective-equipment-schedule-scripting.md) page for the full list of scripting functions available for this component.