WriteResult

Exports values from the spreadsheet of one In-sight sensor (the sender) to another device (the receiver).

Note:
  • Only one WriteResult function is allowed per job; if there are multiple WriteResult functions in one job, all but one will return #ERR.
  • The receiving device must have a ReadResult function in its spreadsheet in order to import the values. For more information, see ReadResult.
  • Both the sending and receiving devices must be Online.
  • Jobs containing this function that are saved in In-Sight Explorer 3.3.0 or higher are only compatible with In-Sight Explorer 3.3.0 and higher.
  • When using the WriteResult and ReadResult functions, it is strongly recommended that the In-Sight sensor using the ReadResult function be configured as a network trigger Master in the AcquireImage function, and that the sensor(s) using WriteResult be configured as network trigger Slaves. This allows the results to be synchronized so the Master will read the results generated by the Slave(s) in response to the current trigger. For more information, see AcquireImage.

WriteResult Inputs

Syntax: WriteResult(Event,Cell1,[Cell2,...])

Parameter Description

Event

Specifies the event that forces an update.This parameter must be a reference to one of the following:
  • The Image data structure in cell A0, containing the AcquireImage function. For more information, see AcquireImage.
  • A cell containing an Event function. For more information, see Event.
  • A cell containing a Button function. For more information, see Button.
Note: When the default Event reference is deleted, the value is replaced by a checkbox. If another cell is referenced as an event, the function will conditionally run based on the referenced cell. If the checkbox is enabled, the function will always run when any inputs to the function are updated.

Cell

References one or more spreadsheet cells containing the values to export from the sending In-Sight sensor to the receiving device. The order in which the cells are referenced determines the index position of each value in the Result data structure on the receiving device.

WriteResult Outputs

Returns

A Result data structure containing the values that will be written out to the receiving In-Sight sensor, or #ERR if any of the input parameters are invalid.

Note: If the Timeout period, specified in the referenced ReadResult function, is exceeded during a write operation to a TCP/IP buffer that is full, an #ERR is not returned.

WriteResult Example

For an illustration of these two functions working together, see the ReadResult Example.