# 360Works Charts 2.3 User Guide

## Installation

### Requirements

FileMaker version 12 or higher.

When 360Plugins are intialized for the first time, they will automatically download all required support files

### Install Steps for FileMaker Pro

Drag the plugin from the MAC or WIN folder into your FileMaker extensions, and restart FileMaker.

If the plugin does not load correctly, please send an email to support@360works.com

### WebDirect Install (FMS 13+)

Install plug-ins for use with WebDirect by dragging the appropriate plugin to FileMaker Server/Web Publishing/publishing-engine/cwpc/Plugins

### Install steps for Instant Web Publishing

You do not need to do this step unless you plan on using the plugin with Instant Web Publishing with FileMaker Server Advanced. You will need an Enterprise license to use this feature.

For installing into the Web Publishing Engine with FileMaker Server or FileMaker Server Advanced, drag the plugin from the MAC or WIN(.fmx) folder into the FileMaker Server/Web Publishing/publishing-engine/wpc/Plugins folder. If there is no Plugins folder inside the wpc folder, then create it manually. Restart FileMaker Web Publishing, and now the plugins should be ready to go.

The easiest way to test whether the plugin is working is to call the version function of the plugin, and display that on an IWP layout. If it shows "?", then the plugin is not working. If it shows a number, then the plugin has been installed successfully.

### Install steps for Custom Web Publishing

If you are using FileMaker Server 12.0v1, you can follow the same procedure as detailed above for custom web publishing. However, in FileMaker Server 12.0v2 and later, custom web publishing now runs as a 64-bit application and requires the 64-bit version of the plugin You will need an Enterprise license to use this feature.

For Mac, the single plug-in file in the MAC directory contains both 32-bit and 64-bit versions. For Windows, look for the plug-in that has the extension .fmx64 and use it in exclusively in custom web publishing.

To install 64-bit plug-ins, install either the .fmx64 or the .fmplugin to the following directory:

FileMaker Server / Web Publishing / publishing-engine / cwpc / Plugins

If it does not exist, create the Plugin folder manually. Restart FileMaker Web Publishing, and then you can then test a script that contains a plug-in and see if it returns the correct values.

### Install steps for server scheduled scripts

You do not need to do this step unless you plan on using the plugin with scheduled script triggering. You will need an Enterprise license to use this feature.

1. Drag the plugin from the MAC (.fmplugin file) or WIN (.fmx64 file) folder into the FileMaker Server extensions folder. On Mac OS X, this is located at /Library/FileMaker Server/Database Server/Extensions folder. On Windows, this is at C:\Program Files\FileMaker\FileMaker Server\Database Server\Extensions.
2. Restart the FileMaker Script Engine by opening Terminal (Mac) or CMD (Windows) and type the command: fmsadmin restart fmse -y . Note: On Windows you may need to change directories to where the fmsadmin utility is located in order to run this command. By default this is located at "C:\Program Files\FileMaker\FileMaker Server\Database Server" This step is not necessary if using Powershell
3. Go to Configuration -> Database Server->Server Plug-ins and check the box that says 'Enable FileMaker Server to use plug-ins'(if it is not already checked), and then check the 'enabled' box for this plugin. Click the 'save' button and wait a few seconds to make sure that the 'enabled' check box stays checked. If it does not, then there was an error loading the plugin and you should contact us for help troubleshooting. You should now be able to write schedules that trigger scripts which use the plugin.

### Auto Update

360Works has created an AutoUpdate helper database which makes setting up AutoUpdate much easier. This file includes pre-configured plugin files which you can place on your server, and an AutoUpdate script for each of our plugins which you can paste into your own solution.

You can get the AutoUpdate360Works file here Follow the instructions included in the file to either host your own Auto Update server or pull the files from ours.

### Uninstalling the plugin

Uninstall the plugin by quitting FileMaker Pro or stopping FileMaker Server and removing the plugin file from your Extensions directory.

### Demo mode and Registering the plugin

Plugins will run in demo mode until they are registered. While running in Demo mode, the product will run for 2 hours every time you launch FileMaker / FileMaker Server / FileMaker Web Publishing Engine. The 2 hour time limit will reset every time you relaunch FileMaker. There is no expiration date when Demo mode stops working. There are no feature differences between the Demo version and the licensed version.

Once you have purchased the plugin, you can register it with the license key. Once a valid license key is entered, the product will run for as long as FileMaker is running. After FileMaker starts up with the plugin installed, open FileMaker preferences, click on the Plug-ins tab, select the plugin from the list, and click the Configure button. Enter your license key and company name in this dialog. You will only need to do this once on a given machine. Alternately, you can use the registration function to register the plugin during a startup script.

Note: If you are running the plugin with FileMaker Server / FileMaker Web Publishing Engine, you must use the registration function to register the plugin, since there is no preferences dialog on FileMaker Server to enter the license key and company name. You will need to call the register function at the beginning of any script that is going to call plugin functions. This will ensure that you do not get demo mode errors.

### Product Wiki

This is the main documentation for the plugin. However, we also maintain a documentation Wiki that contains additional information for a lot of our products. You can find that page here

## Feedback

We love to hear your suggestions for improving our products! If you are experiencing problems with this plugin, or have a feature request, or are happy with it, we'd appreciate hearing about it. Send us a message on our website, or email us!

## Error Handling/Reporting

When something unexpected happens, a plugin function returns a result of `"ERROR"`. This makes it easy to check for errors. If a plugin function returns "ERROR", call the `chartSetErrorCapture` function to get a detailed description of what went wrong.

Here is an example of basic error reporting:

    Set Variable [ $result = MyPluginFunction("x" ; "y" ; "z") ]
    If [ $result = "ERROR" ]
        Show Custom Dialog [ "An error occurred: " & chartSetErrorCapture ]
    End If

### Chaining Multiple Functions Together

Since the string `"ERROR"` evaluates to false when evaluated by FileMaker, and most plugin functions return a `1` when successful, you can chain multiple dependent plugin operations together using the `"and"` operator. However, in this case the result will be a `1` or a `0`, not `"ERROR"`. For example:

    // chain multiple calls together
    // if any of the functions fail, the calculation will
    // short-circuit with a result of false,
    // and none of the subsequent function calls will be evaluated.
    Set Variable [ $success =
        FirstPluginFunction("x") and
        SecondPluginFunction("y") and
        ThirdPluginFunction("z")
    ]
    If [not $success]
        Show Custom Dialog [ "An error occurred: " & chartSetErrorCapture ]
    End If

Note: the above only works for plugin functions which return `1` on success! Check the documentation for each function used in this manner.

### Additional Error Checking - Plugin not installed

If a plugin is not installed correctly, calls to a plugin function will return "?". As part of your startup script, you should check for this occurrence and display a warning accordingly that the plugin needs to be installed. Note: when treated as a boolean true/false value, FileMaker will treat `?` as `true`.

## Examples

ChartPlugin is a Filemaker Plugin for generating various types of graphical charts. Currently supported are: pie charts, bar charts, line charts, and time series chart.

Before creating a chart, you must register the plugin using chartRegister

The charting API is split into sections corresponding to each type of chart. In general, you call a method to create a chart, then populate data points, set color options, and generate the graphic.

### Example Usage

Here is an example for creating a pie chart containing five values. The `let()` function is used to do the setup for the chart, and then the `pieChartShowGraphic` is called at the end to set the actual value of the container to the chart image.

     Set Variable [ $result = Let(
     debug = pieChartCreate( "Quoted Hours Worked" ) and
         pieChartSetDataPoint( Name 1 ; Quoted 1 ) and
         pieChartSetDataPoint( Name 2 ; Quoted 2 ) and
         pieChartSetDataPoint( Name 3 ; Quoted 3 ) and
         pieChartSetDataPoint( Name 4 ; Quoted 4 ) and
         pieChartSetDataPoint( Name 5 ; Quoted 5 );
         pieChartShowGraphic( 360; 360 )
     )

#### Custom parameters

The core charting API deals with the most common tasks. For additional flexibility, you can pass multiple extra parameters to the *ChartShowGraphic functions. The following is a list of all parameters:

legend
  Set this to "false" to hide the legend at the bottom of the chart.
explodeSeries
  causes one "slice" of a pie chart to appear offset from the center of the chart. The value can be a name or numeric index.
strokeWidth
  The width of the stroke used to outline the parts of the chart.
backgroundColor
  The background color of the chart. Pass in three numeric values, e.g. `64,128,255`
plotBackgroundColor
  The background color of the plot area (excluding the headers and legends). Pass in three numeric values, e.g. `64,128,255`
noDataMessage
  The message to display when there is no data to display in the chart
label
  A template string which is used to generate chart labels. For pie charts, `{0}` is replace with the item name, `{1}` is the numeric amount, and `{2}` is the percent amount.
outline
  1 or 0 to show/hide a single border around the chart, but within the legend.
outlines
  1 or 0 to enable/disable outlines around individual chart elements (for pie charts only)
hideLabels
  Whether to hide labels on the chart (for pie charts only)
valueAxis.min
  The minimum range to use on the value axis (instead of auto-range)
valueAxis.max
  The maximum range to use on the value axis (instead of auto-range)
valueAxis.showTickLabels
  true/false to enable/disable the tick labels in the value axis
valueAxis.showTickMarks
  true/false to enable/disable the tick marks in the value axi

To use this, simply pass any number of parameters as key/vaue pairs, for example:

     Set Variable [$result = Let(
     debug = pieChartCreate( "Quoted Hours Worked" ) and
         pieChartSetDataPoint( Name 1 ; Quoted 1 ) and
         pieChartSetDataPoint( Name 2 ; Quoted 2 ) and
         pieChartSetDataPoint( Name 3 ; Quoted 3 ) and
         pieChartSetDataPoint( Name 4 ; Quoted 4 ) and
         pieChartSetDataPoint( Name 5 ; Quoted 5 )
     ;
     pieChartShowGraphic(
         360 ;
         360 ;
         "explodeSeries=" & Name 1 ; // explode the first series
         "backgroundColor=100,100,255") ; // light-blue background
         "outline=false" // don't show an outline
         "legend=false" // don't show the legend
     )
     )
     ]

## Function Detail

### barChartCreate ( name ; categoryAxisLabel ; valueAxisLabel { ; isVertical ; use3d } )

Create a bar chart. A bar chart looks like this:

Here is how you would create the above graph

     #create the bar chart
     Set VariableBarChartCreate("Total Hours Worked";"Employee";"Hours";"isVertical=1")]

     #Set the data points for each group for the Hourly category
     BarChartSetDataPoint[Group:"Hourly";Category:"Sam";Value:"11"]
     BarChartSetDataPoint[Group:"Hourly";Category:"Jesse";Value:"11.7"]
     BarChartSetDataPoint[Group:"Hourly";Category:"Dave";Value:"4.2"]
     BarChartSetDataPoint[Group:"Hourly";Category:"Max";Value:"6.8"]
     BarChartSetDataPoint[Group:"Hourly";Category:"Brian";Value:"5"]

     #Set the data points for each group for the Quoted category
     BarChartSetDataPoint[Group:"Quoted";Category:"Sam";Value:"12"]
     BarChartSetDataPoint[Group:"Quoted";Category:"Jesse";Value:"9.7"]
     BarChartSetDataPoint[Group:"Quoted";Category:"Dave";Value:"5"]
     BarChartSetDataPoint[Group:"Quoted";Category:"Max";Value:"12"]
     BarChartSetDataPoint[Group:"Quoted";Category:"Brian";Value:"11"]

     #Set the data points for each group for the Unbillable category
     BarChartSetDataPoint[Group:"Unbillable";Category:"Sam";Value:"7.2"]
     BarChartSetDataPoint[Group:"Unbillable";Category:"Jesse";Value:"2"]
     BarChartSetDataPoint[Group:"Unbillable";Category:"Dave";Value:"5"]
     BarChartSetDataPoint[Group:"Unbillable";Category:"Max";Value:"1"]
     BarChartSetDataPoint[Group:"Unbillable";Category:"Brian";Value:"4"]
     #Show the graph
     Set Field[myTable::myContainer;barChartShowGraphic(500,500)]

Parameters:

  `name` - the optional name of the chart
  `categoryAxisLabel` - the optional label for the category axis of the chart
  `valueAxisLabel` - the optional label for the value axis of the chart
  `isVertical` - Whether to orient the chart horizontally (0) or vertically (1)
  `use3d` - whether to apply a three-dimensional effect to the chart.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### barChartSetDataPoint ( group; category ; value )

Set a data point in a bar chart. Categories are a way to break an item into smaller pieces. A group can have multiple categories.

     BarChartSetDataPoint[Group:"Hourly";Category:"Sam";Value:"11"]

Parameters:

  `group` - unique group name identifier.
  `category` - category name identifier. Typically, the same categories are repeated for each group.
  `value` - the numeric value for the group/category combination

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### barChartSetSeriesColor ( category ; red ; green ; blue ; alpha )

Set the color that a particular category is displayed in. You should call chartSetColor AFTER adding values to the chart.

     BarChartSetSeriesColor[Category:"Hourly";Red:255;Green:0;Blue:0;Alpha:255]//set color to Red with no transparency

Parameters:

  `category` - a category which was set in a previous call to barChartSetDataPoint.
  `red` - a number between 0-255
  `green` - a number between 0-255
  `blue` - a number between 0-255
  `alpha` - a number between 0-255 indicating the transparency of the color. 0 is completely transparent.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### barChartShowGraphic ( width ; height { ; additionalParams... } )

Generates the bar chart containing all previously set data points.

See the Custom Parameters section for a list of parameters which this function accepts.

     Set field[myTable::myContainer; barChartShowGraphic(500;500)]//shows the bar chart at 500x500 in the specified container

Parameters:

  `width` - the width of the resulting image
  `height` - the height of the resulting image
  `additionalParams` - additional parameters
  `width` -

Returns: an image containing the chart of the supplied dimensions.

### chartLastError

Returns the last error which occurred, or "" if there was no error.

### chartLicenseInfo

Returns information about the license used.

### chartRegister ( key ; registeredTo )

Registers the Plugin.

Parameters:

  `licenseKey` - a valid license key string, or the literal string "DEMO" to run in demo mode.
  `registeredTo` - the company name for the license key used.

Returns: 1 on success, or "ERROR" on failure.

### chartReportProblem ( emailAddress ; problemDescription )

Send a problem report to 360Works.

Parameters:

  `emailAddress` - The user's email address to allow for support contact
  `problemDescription` - A description of the current issue

Returns: Always returns 1

### chartSetErrorCapture ( errorCapture )

Toggles error dialogs on or off. When something unexpected happens, the plug-in will pop up a dialog displaying the error message. This makes it easy to see what went wrong. However, in some cases, you may prefer to show your own message to the user, or possibly not show a message at all. In that case, you can call chartSetErrorCapture with a parameter of true. That will suppress the error dialog from appearing to the user. This is a boolean value so make sure you do not put the parameter in "". NOTE:This will only suppress error dialogs when plugin functions are called as part of a calculation. If you are calling plugin functions as script steps ( available in FM 16+) then you will need to use the native FileMaker function Set Error Capture On/Off

Parameters:

  `errorCapture` - set to true to suppress the default popups.

### chartVersion

Returns the version of the plugin.

Returns: a decimal version number.

### lineChartCreate ( name ; categoryAxisLabel ; valueAxisLabel { ; isVertical ; use3d } )

Create a line chart.

     #create the line chart
     Set Variable[$create;Value:lineChartCreate)("Hours Jan-May";"Month";"Hours";"isVertical=1")]

     #Set the data points for the Hourly series
     lineChartSetDataPoint[Series Name:"Hourly";Category:"January";Value:"60"]
     lineChartSetDataPoint[Series Name:"Hourly";Category:"February";Value:"77"]
     lineChartSetDataPoint[Series Name:"Hourly";Category:"March";Value:"60"]
     lineChartSetDataPoint[Series Name:"Hourly";Category:"April";Value:"40"]
     lineChartSetDataPoint[Series Name:"Hourly";Category:"May";Value:"73"]

     #Set the data points for Quoted series
     lineChartSetDataPoint[Series Name:"Quoted";Category:"January";Value:"10"]
     lineChartSetDataPoint[Series Name:"Quoted";Category:"February";Value:"12"]
     lineChartSetDataPoint[Series Name:"Quoted";Category:"March";Value:"10"]
     lineChartSetDataPoint[Series Name:"Quoted";Category:"January";Value:"15"]
     lineChartSetDataPoint[Series Name:"Quoted";Category:"January";Value:"7"]

     #Set the data points for the Unbillable series
     lineChartSetDataPoint[Series Name:"Unbillable";Category:"January";Value:"10"]
     lineChartSetDataPoint[Series Name:"Unbillable";Category:"February";Value:"15"]
     lineChartSetDataPoint[Series Name:"Unbillable";Category:"March";Value:"25"]
     lineChartSetDataPoint[Series Name:"Unbillable";Category:"April";Value:"17"]
     lineChartSetDataPoint[Series Name:"Unbillable";Category:"May";Value:"10"]

     #show the line graph
     Set Field[Chart::LineChart;lineChartShowGraphic(500;500)]

Parameters:

  `name` - The title of the chart
  `categoryAxisLabel` - The label for the category axis
  `valueAxisLabel` - The label for the value axis
  `isVertical` - Whether to orient the line chart vertically or horizontally (pass a 1 for vertical)
  `use3d` - whether to apply a three-dimensional effect to the chart

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### lineChartSetDataPoint ( seriesName ; category ; value )

Set a data point or a return separated list of points in a line chart. Categories are a way to break an item into smaller pieces. A group can have multiple categories. The line will be drawn from left to right in the order items are added. See lineChartCreate for an example on how to use this function

Parameters:

  `seriesName` - the name of the series (or line) that this data point will apply to.
  `category` - category name identifier. This appears in the category axis of the line chart.
  `value` - the numeric value for the group/category combination

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### lineChartSetSeriesColor ( category ; red ; green ; blue ; alpha )

Set the color that a particular category is displayed in. You should call chartSetColor AFTER adding values to the chart.

     lineChartSetSeriesColor[Category:"Hourly";Red:255;Green:0;Blue:0;Alpha;255]//sets series color to red with no transparency

Parameters:

  `category` - a category which was set in a previous call to lineChartSetDataPoint.
  `red` - a number between 0-255
  `green` - a number between 0-255
  `blue` - a number between 0-255
  `alpha` - a number between 0-255 indicating the transparency of the color. 0 is completely transparent.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### lineChartShowGraphic ( width ; height { ; additionalParams... } )

Generates the line chart containing all previously set data points.

The `additionalParams` are optional parameters which can be used to customize the chart display.

See the Custom Parameters section for a list of parameters which this function accepts.

     Set field[Chart::LineChart;lineChartCreateGraphic(500;500)

Parameters:

  `width` -
  `width` - the width of the resulting image
  `height` - the height of the resulting image
  `additionalParams` - additional parameters

Returns: an image containing the chart of the supplied dimensions.

### pieChartCreate ( name { ; 3d } )

Creates a new pie chart with the given name. This function must be called before adding data to the chart, modifying colors or display options, or displaying the chart graphic. A pie chart looks like this:

     #create the pie chart
     pieChartCreate[Name:"Quoted Hours Worked"]

     #set the data points
     pieChartSetDataPoint[Category:"Sam";Value:11]
     pieChartSetDataPoint[Category:"Jesse";Value:11.7]
     pieChartSetDataPoint[Category:"Dave";Value:4.2]
     pieChartSetDataPoint[Category:"Max";Value:6.6]
     pieChartSetDataPoint[Category:"Brian";Value:5]

     #show the chart
     Set Field[Chart::PieChart; pieChartShowGraphic(500,500)

Parameters:

  `name` - The optional name of the chart.
  `use3d` - whether to use a three-dimensional effect on the chart.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### pieChartSetDataPoint ( category ; value )

Adds a value or a return separated list of values to a pie chart created with the `pieChartCreate` function. Calling this twice with the same category name will overwrite the previously set value. See pieChartCreate for example usage

Parameters:

  `category` - category name
  `value` - The numeric value for the category.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### pieChartSetSeriesColor ( category ; red ; green ; blue ; alpha )

Set the color that a particular category is displayed in. You should call chartSetColor AFTER adding values to the chart.

     pieChartSetSeriesColor[Category:Sam;Red:0;Green:255;Blue:0;Alpha:255] //sets the series color to green with no transparency

Parameters:

  `category` - a category which was set in a previous call to pieChartSetDataPoint.
  `red` - a number between 0-255
  `green` - a number between 0-255
  `blue` - a number between 0-255
  `alpha` - a number between 0-255 indicating the transparency of the color. 0 is completely transparent.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### pieChartShowGraphic ( width ; height { ; additionalParams... } )

Returns the container image for the currently configured chart. Note that this also releases any resources used by the chart, so it can only be called once.

The `additionalParams` are optional parameters which can be used to customize the chart display.

See the Custom Parameters section for a list of parameters which this function accepts.

Parameters:

  `width` -
  `height` -
  `additionalParams` - additional parameters which customize how the chart is generated

Returns: the chart image

### timeSeriesChartAddRegression ( seriesName { ; properties } )

Adds a regression to the time series. This should be called AFTER setting all time series data points.

The valid properties are:

- name: the name of the regression (this appears in the legend)
- color: the color of the regression line. This should be a color name (e.g. pink, red, blue, yellow, etc).

      Set Variable[$reg; Value: timeSeriesChartAddRegression("Sales";"color=red")] //Sets the "Sales" series line to red

Parameters:

  `seriesName` - the name of the series to add the regression to. If blank, the first series is used.
  `properties` - optional arguments

Returns:

### timeSeriesChartCreate ( name ; timeAxisLabel ; valueAxisLabel )

Creates a time series chart, for displaying a line chart which displays value information for dates.

     #create the time series chart
     timeSeriesChartCreate[Name:"Yearly Sales"; Time Axis Label: "Month"; Value Axis Label: "Sales in Thousands" ]

     #set the data points
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"01/01/2019"; Value: 100]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"02/28/2019"; Value: 350]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"03/30/2019"; Value: 260]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"04/30/2019"; Value: 650]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"05/31/2019"; Value: 700]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"06/30/2019"; Value: 800]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"07/31/2019"; Value: 733]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"08/30/2019"; Value: 400]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"09/30/2019"; Value: 368]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"10/31/2019"; Value: 350]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"11/20/2019"; Value: 500]
     timeSeriesChartSetDataPoint[Series Name:"Sales"; Date Or Time:"12/31/2019"; Value: 550]

     #show the time series chart
     Set Field[Charts::TimeSeriesChart;timeSeriesChartShowGraphic(1200;700)]

Parameters:

  `name` - The optional name of the chart (this will be displayed in the chart header)
  `timeAxisLabel` - the optional label for the time axis
  `valueAxisLabel` - the optional label for the value axis

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### timeSeriesChartSetDataPoint ( seriesName ; dateOrTime ; value )

Sets a value or a return separated list of values for a specific series and date or return separated list of dates. Note that if passing in a list of values make sure to passin a corresponding list of dates. See timeSeriesChartCreate for example usage

Parameters:

  `seriesName` - The series name (or line) whose value is being set.
  `date` - the date whose value is being set.
  `value` - the value of the series on the specified date

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### timeSeriesChartSetSeriesColor ( seriesName ; red ; green ; blue ; alpha )

Set the color that a particular time series is displayed in. You should call chartSetColor AFTER adding values to the chart.

     timeSeriesChartSetSeriesColor[Series Name:"Sales"; Red: 255; Green:0;Blue:0; Alpha: 255] //sets series color to Red with no transparency

Parameters:

  `seriesName` - a seriesName which was set in a previous call to timeSeriesChartSetDataPoint.
  `red` - a number between 0-255
  `green` - a number between 0-255
  `blue` - a number between 0-255
  `alpha` - a number between 0-255 indicating the transparency of the color. 0 is completely transparent.

Returns: 1 on success, or "`ERROR`" if there was a problem (use ChartLastError for more detailed information about the nature of the error).

### timeSeriesChartShowGraphic ( width ; height { ; additionalParams... } )

Generates the time series chart containing all previously set data points.

The `additionalParams` are optional parameters which can be used to customize the chart display.

See the Custom Parameters section for a list of parameters which this function accepts.

Parameters:

  `width` -
  `width` - the width of the resulting image
  `height` - the height of the resulting image
  `additionalParams` - additional parameters

Returns: an image containing the chart of the supplied dimensions.