# SideCarTool

Use SideCarTool to store a Spreadsheet job A job is a user-configured program in In-Sight Spreadsheet consisting of functions and designed for specific applications. You can create and edit jobs using the In-Sight Spreadsheet interface, and load them on a vision system for deployment in a live environment. result in a simple file extension, like .txt, .html, or .xml. A Sidecar file can act as input for various functions, such as WriteData and WriteImage.

Note: Before you can start using the tool, you have to create both a Sidecar directory on the vision system, and a Sidecar template file inside the folder.
Inputs

The SideCarTool function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. has the following syntax:

SideCarTool(String, Event)

See the table for a description of the available parameters.

Parameter | Description
--- | ---
String | A file path pointing to the Sidecar template file on the device.
Event | An external event that forces an update. Must reference the AcquireImage function or an Event structure.

Outputs

Returns | A Sidecar file that you can use as input for various other functions.

## Using the SideCarTool

1. Create a Sidecar template file. Reference cells as {$<cell location>}.

2. Create a Sidecar directory on the vision system and copy the Sidecar template file to this location. Make sure to spell the name of the directory as Sidecar. For more information on file and folder management, see View Files Stored on the In-Sight Vision System.

3. Add the SideCarTool function to the Spreadsheet, and reference the Sidecar template file.

4. Fill the referenced cells in the Spreadsheet with strings you want to include in the Sidecar file. You can use the expression Stringf("Text").

5. Add the WriteData tool to the Spreadsheet.

6. Reference the SideCarTool in the Data row, and fill out the other required parameters. For more information on the WriteData function, see WriteData.

7. Trigger the SideCar and WriteData tools.

8. The vision system creates the Sidecar file in the Sidecar folder.