Mashup Builder > Widgets > Standard Widgets > Schedule Chart Widget (Themable)
Schedule Chart Widget (Themable)
Introduction
The Schedule Chart widget displays a schedule chart in your mashup.
* 
The Schedule Chart widget is available as a standard widget in the platform and as a web component that can be imported from an SDK.
Data Format
The Schedule chart data should consist of an infotable with two field definitions:
Resources—Defines the resources to display on the resources axis.
Data—Defines the nested infotables with the data to display for each resource.
Resource
Data Infotable
Field Definition
Resource:{name:'Resource',baseType:'STRING'}
Data:{name:'Data',baseType:'INFOTABLE'}
Use
Defines the X-axis values for the chart bar or column. The data must be a string. Each row is displayed as a category on the X-axis. The defined name for this column is the option that you should select for the ResouceField widget property.
Defines the infotable with the data for the resource.
Base Type
STRING
INFOTABLE
Row Example
Resource:'Apple'—Where Apple is the resource name.
Data:'Infotable1'—The infotable entity with the resource data.
For each resource that you define in the first infotable, you must create an infotable with field definitions that represent the data structure for the resource on the chart. The following table lists the required data structure and the field definitions to use for the data infotable:
reason
info
start
end
color
Field Definition
reason:{name:'reason',baseType:'STRING'}
info:{name:'info',baseType:'STRING'}
start:{name:'start',baseType:'DATETIME'}
end:{name:'end',baseType:'DATETIME'}
color:{name:'color',baseType:'STRING'}
Use
A mandatory field that defines the task name or the reason for logging the resource event. Data from this column appears as chart legends.
An optional field that defines the description for the resource event.
A mandatory field that defines the start date for the resource event.
A mandatory field that defines the end date for the resource event.
An optional field that defines a specific color for the event representation on the chart.
Base Type
STRING
STRING
DATETIME
DATETIME
STRING
Row Example
reason:'Maintenance'—Where Maintenance is the event name that you want to display on the chart.
info:'Maintenance event description'—Where Maintenance event description is the event description to show on the chart.
start:'2020-01-07 03:57:43.322'—The start date for the maintenance event.
end:'2020-01-26 07:38:12.102'—The end date for the maintenance event.
color:'red'—The event is displayed using a red color.
* 
The infotable field definitions must match the names specified in the previous table.
Each row represents the time or duration for an event or a task within the resource. The following image shows the returned data format of a data service for the Schedule chart:
For the interval zoom control options, you must create an infotable which consists of two fields: label and duration. The base type of data in the two fields should be STRING. The following image shows the returned data format of a data service:
The values that you can use in the duration field and the range that these represent follow:
Y — year
M — month
W — week
d — day
h — hour
m — minute
s — second
ms — millisecond
* 
The characters are case sensitive. For example, “M” represents month and “m” represents minute.
Binding a Data Source
To display data on the chart:
1. On the Data panel, add a data service that returns an infotable with the correct data format for the widget.
2. Bind the All Data property of the data service to the Data property of the chart.
3. Select the chart, then on the Properties panel, set the following properties:
ResourceField—Select the infotable column to use for the resource axis.
DataField—Select the infotable column with the data for each resource. Each field is a contained infotable.
4. Click Save, and then View Mashup.
The infotable data is displayed on the chart.
Adding a Secondary Axis
You can add a secondary axis to the schedule chart. The secondary axis is used to display the date in a different format or locale. To add a secondary time axis to the chart, do the following:
1. Select the chart and then open the Properties panel.
2. Select the check box next to the SecondTimeAxis property. Additional properties are listed.
3. To specify a different date format for the secondary axis, type a date pattern for the SecondTimeAxisDateFormatToken property, or select a localization token.
4. Click Save and then View Mashup.
The secondary time axis is displayed according to the specified format date.
The following figure shows the Schedule Chart widget with a secondary axis:
The chart shows events for multiple resources. The secondary and primary time axes are used to display the date using two different formats. The primary axis shows the date and the month, and the secondary axis shows the week number. To display the date format using the week number, set the SecondTimeAxisDateFormatToken property to w. For more information about the available formats, see Formatting Date and Time for Widgets.
* 
The secondary time axis properties are available only in ThingWorx 9.1 and later.
The following table lists the properties that you can use to enable and configure the secondary Time axis:
Property
Description
Base Type
Default Value
Bindable? (Y/N)
Localization Support
SecondTimeAxis
Adds a secondary time axis to the chart.
BOOLEAN
False
Y
N
SecondTimeAxisLabel
Specifies the text label for the secondary time axis.
STRING
Second Time axis
Y
Y
SecondTimeAxisLabelAlignment
Aligns the label for the secondary Time axis. By default, the label is aligned to the left.
STRING
Left
N
N
SecondTimeAxisDateFormatToken
Enables you to localize the date format using for the secondary time axis using a "dd-mm-yy" pattern. By default, the date format of the operating system is used.
STRING
N/A
Y
Y
Widget Properties
The following table lists the chart properties that are available in ThingWorx 9.2 and later:
Property Name
Description
Base Type
Bindable
Localizable
NumberOfReferenceLines
Specifies the number of reference lines to display on the chart. You can add up to 24 reference lines. Additional properties are added for each reference line.
NUMBER
Y
N
ReferecneLineNLabel
Sets the text label of the reference line.
STRING
Y
Y
ReferecneLineNValue
Sets the value of the reference line. You can pick a date to set the reference line.
DATETIME
Y
N
The properties of the Schedule Chart widget are listed below.
Property Name
Description
Base Type
Default Value
Bindable? (Y/N)
Localizable? (Y/N)
AxisZoom
Allows you to zoom in on the Time Axis.
When you select this property, the DirectSelectionZoom, DragSelectionZoom, TimeAxisIntervalControl, and TimeAxisRangeZoom properties appear on the properties list.
BOOLEAN
False
Y
N
CustomClass
The user defined CSS class to apply to the top div of the widget.
Multiple classes can be entered, separated by space.
STRING
n/a
Y
N
DirectSelectionZoom
Allows you to zoom in by selecting two data items on the chart.
The available options are None, Resources Axis, Time Axis, and Both.
STRING
None
Y
N
DragSelectionZoom
Allows you to zoom in on a specific part of the chart by drawing a selection box around the data range that you want to view.
The options available to you are None, Resources Axis, Time Axis, and Both.
STRING
None
Y
N
Data
The infotable data source for the chart.
INFOTABLE
n/a
Y
N
DataField
Selects the infotable field that contains the time data for the chart resources.
INFOTABLE
n/a
Y
N
Disabled
Disables the widget in the mashup.
The widget is displayed in the mashup, but you cannot click or select it.
BOOLEAN
False
Y
N
EndTime
Sets the date and time for the end of the zoom range.
DATETIME
n/a
Y
N
ExternalPadding
Sets the padding from axes.
Padding is a percentage of the bar width.
NUMBER
25
Y
N
HideLegend
Hides the legend area.
When you select this property, the LegendAlignment, LegendFilter, LegendMarkerShapes, LegendMaxWidth, and LegendPosition properties do not appear on the properties list.
BOOLEAN
False
Y
N
HideNotes
Hides the notes area.
When you select this property, the Notes, NotesAlignment, and NotesPosition properties do not appear on the properties list.
BOOLEAN
False
Y
N
HideResourcesAxis
Hides the Resources axis.
BOOLEAN
False
Y
N
HideTimeAxis
Hides the Time axis.
BOOLEAN
False
Y
N
HorizontalAxisMaxHeight
Sets a maximum height for the horizontal axis.
NUMBER
85
Y
N
InternalPadding
Sets the padding between the series.
Padding is a percentage of the bar width.
NUMBER
25
Y
N
Label
Displays the text label for the schedule chart.
STRING
Schedule Chart
Y
Y
LabelType
Selects the label type for the schedule chart as Header, Sub-Header, Label, or Body.
STRING
Sub-Header
Y
N
LabelAlignment
Aligns the label of the schedule chart widget to the Left, Center, or Right.
The available options for this property depend on the setting of LabelPosition property.
STRING
Left
N
N
LabelPosition
Sets the position of the label at the Top or the Bottom.
STRING
Top
N
N
LabelReset
Sets the label that is displayed in the reset button for the zooming control.
STRING
Reset
Y
Y
LegendAlignment
Aligns the legend text to the Top, Middle, or Bottom.
The options that are available to you for this property depend on the setting of LegendPosition property.
STRING
Top
N
N
LegendFilter
Adds a legend filter that allows the user to filter the chart at runtime.
BOOLEAN
False
N
N
LegendMarkerShapes
Sets the marker shape of the data series legends as Square, Circle, or None.
STRING
Square
N
N
LegendMaxWidth
Sets the maximum width for the legend area.
NUMBER
736
Y
N
LegendPosition
Sets the position of the legend at the Top, Bottom, Left, or Right.
STRING
Right
N
N
MultipleDataSources
Allows you to visualize data from multiple sources on the chart.
When you select this property, NumberOfDataSources property appears on the properties list.
BOOLEAN
False
N
N
Notes
Specifies the text to display within the notes area on the chart. You can enter a string or select a localization token.
STRING
n/a
Y
Y
NotesAlignment
Aligns the note text to the Left, Right, or Center.
The available options for this property depend on the setting of NotesPosition property.
STRING
Left
N
N
NotesPosition
Sets the position of the notes area at the Top or Bottom.
STRING
Bottom
N
N
NumberOfDataSources
Sets the number of data sources that you can bind to the chart.
NUMBER
2
N
N
ResetToDefaultValue
Resets the input for this widget to their default values.
n/a
n/a
Y
N
ResourceField
The infotable field containing the resources that are shown on the chart.
INFOTABLE
n/a
n/a
n/a
ResourcesAxisLabel
Displays the text label for the Resources axis.
STRING
Resources axis
Y
Y
ResourcesAxisLabelAlignment
Aligns the Resources axis label to the Top, Middle, or Bottom.
STRING
Middle
N
N
ReverseResourcesAxis
Displays the Resources axis values in the reverse order.
BOOLEAN
False
N
N
ReverseTimeAxis
Displays the Time axis values in the reverse order.
BOOLEAN
False
N
N
RulersInFront
Shows the rulers in front of the data values. By default, rulers are displayed behind the data.
BOOLEAN
False
Y
N
SeriesClicked
Triggers an event when you click on a data point.
n/a
n/a
Y
N
ShowHideLegend
Adds a show/hide button that enables you to show or hide the chart legend at run time.
* 
This property is available for ThingWorx versions 9.3.0 and later.
BOOLEAN
False
N
N
ShowResourcesAxisRuler
Shows the Resources axis ruler.
BOOLEAN
False
Y
N
ShowTimeAxisRuler
Shows the Time axis ruler.
BOOLEAN
False
Y
N
SparkView
Shows a simplified view of the chart visualization. Enable this property to hide the labels, legends, and rulers.
BOOLEAN
False
Y
N
StartTime
Sets the date and time for the start of the zoom range.
DATETIME
n/a
Y
N
TabSequence
The sequence number of the schedule chart widget when you press the TAB.
NUMBER
n/a
N
N
TimeAxisIntervalControl
Adds controls that allow you to zoom in on the Time axis according to specific intervals.
The selection of this property is None by default. When you select Dropdown list, the TimeAxisIntervalControlLabel, TimeAxisIntervalData, TimeAxisIntervalAnchorPoint, and TimeAxisIntervalAnchorPointLabel properties appear on the properties list.
STRING
None
Y
N
TimeAxisIntervalControlLabel
Specifies the label for the interval zoom controls for the Time axis.
STRING
n/a
Y
Y
TimeAxisIntervalData
The data source for the interval zoom control options.
When you select an entry from the interval dropdown list, the chart is zoomed in according to the selected duration value and the start/end anchor point.
INFOTABLE
n/a
Y
N
TimeAxisIntervalAnchorPoint
Allows you to select the anchor position of the interval range within the data set.
Select Start to place the interval at the start of the data set, or End to place the interval at the end.
For example, if you specify a 3 — month interval in a 12 — month data set, you can select Start to show the first 3 months or End to show the last 3 months of the data set.
STRING
Start
Y
N
TimeAxisIntervalAnchorPointLabel
Specifies the label for the interval anchor point for the Time axis.
STRING
n/a
Y
Y
TimeAxisLabelAlignment
Aligns the Time axis label to the Left, Right, or Center.
STRING
Left
N
N
TimeAxisLabel
Displays the text label for the Time axis.
STRING
Time axis
Y
Y
TimeAxisDateFormatToken
Localizes the date format using DD-MM-YY pattern for the Time axis.
STRING
n/a
Y
Y
TimeAxisRangeZoom
Adds controls that allow you to specify a date and time range to zoom to on the Time axis. You can set the range using the StartTime and EndTime properties.
When you select this property, the TimeAxisStartZoomLabel and TimeAxisEndZoomLabel properties appear on the properties list.
BOOLEAN
False
Y
N
TimeAxisStartZoomLabel
Specifies the label for the start of the range selection.
STRING
n/a
Y
Y
TimeAxisEndZoomLabel
Specifies the label for the end of the range selection.
STRING
n/a
Y
Y
VerticalAxisMaxWidth
Sets the maximum width for the vertical axis.
NUMBER
85
Y
N
Was this helpful?