Exporting a Data File or Appending a Data String to a File on an SD Card

You can configure your In-Sight vision system to export a data file or append a data string to a file on the SD card. Use this feature to log data results that you view in a file.

Note: This feature is supported only on the In-Sight vision systems on which the SD card is installed.

To export data or append data string to a file on the SD card:

  1. From the Communications group box, select SD Card.
  2. Select the File tab.

  3. Press the Add button to add an entry and configure the parameters in the File tab.

    Note: You can add more than one file export operation to a job.
  4. Place the In-Sight vision system Online. The vision system must be Online to execute; otherwise, no data will be exported.

  5. Trigger the vision system. For each trigger, a data file is exported or a data string is appended to a file, and stored on the SD card installed to the vision system.

    Note: When Transfer Condition is set to None (default), a data file is exported or a data string is appended to a file every time a new image is acquired. When Transfer Condition is set to other than None, a data file is exported or a data string is appended to a file every time the specified event occurs. For example, when Transfer Condition is set to Job.Fail, a data file is exported or a data string is appended to a file, and stored on the SD card every time the job fails.

Controls

ClosedEnabled check box

Defines whether or not the export operation is operational (by default, it is checked), and whether or not it will be exposed as an EasyView item (for example, WriteLocal_1.Tool_Enabled), which can be displayed on the VisionView Operator Interface Panel and is editable by the operator.

Note: To enable, check the Enable checkbox in the table. This is the only parameter you can configure in the table.
ClosedName

Defines the name of your data export operation, which can be utilized in configuring the results Inputs/Outputs and Communication); the default name is "WriteLocal_1" (if it is the first image export operation added to the job, otherwise it will be incremented, e.g. “WriteLocal_2”, “WriteLocal_3”, etc.). Customize the operation by giving it a name that is associated with its Transfer Condition, for instance.

ClosedTransfer Condition

Defines when the data should be sent to the SD card, such as when a particular tool passes or fails, or an input is received. By default, None is selected, which ensures that the data will be exported every time an image is acquired, when the Enabled checkbox is checked. If the Enabled checkbox is disabled, or the tool referenced is disabled, the export operation will not execute.

ClosedFile Type

Defines the format of the exported file: Text, HTML (default), XML or CSV.

ClosedWrite Type (Overwrite or Append)

Defines the way that data is written to the file.

  • Overwrite: Overwrites the existing data in the file.
  • Append (default): Appends the data string to the end of the file.
ClosedFile Contents/Format String button

Defines the data written to the file using the FormatString dialog. For more information, see Format String Dialog.

ClosedFile Name Preview

Previews the name of the file that is exported; by default, File is displayed. You can customize the file name by configuring the following parameters: Default File Name, Add Link and Add Timestamp.

Note:
  • Define at least one parameter for the file. If the Default File Name field is blank and the Add Link and Add Timestamp checkboxes are unchecked, the file export operation will fail.
  • The order of the parameters cannot be changed.
ClosedDefault File Name

Defines the name of the file that is exported; the default name is "File". Long file names are supported.

ClosedAdd Link

Defines whether or not the selected tool will be linked and added to the name of the file that is exported. By default, this checkbox is disabled.

Note:
  • The export operation will fail if the selected tool is linked to a string that contains any of the following invalid characters: <, >, :, ", /, \, |, ? or *.
  • The Add Link checkbox is grayed out when EasyBuilder cannot find any tool that can be linked.
  • If the linked tool is removed from the job, the Add Link checkbox will be automatically disabled.
  • When the Add Link checkbox is enabled, do not select Undefined from the drop-down list; it may produce undefined results.
ClosedAdd Timestamp

Defines whether or not a timestamp will be added to the name of the image file that is exported. By default, this checkbox is disabled. When enabled, one of the following pre-configured timestamp formats can be selected from the drop-down list: MMDDYY, YYYYMMDD_HHMMSS, DDMMYY_HHMMSS, MM-DD-YYYY_HH.MM.SS, HHMMSS, YYMMDD_HHMMSS or YYDDMM_HHMMSS.

Note: You can configure the In-Sight vision system's date/time settings in the Date/Time Setting dialog. For more information, see Date/Time Settings Dialog.
ClosedAdd button

Adds a new export operation to the list.

ClosedRemove button

Removes an export operation from the list. Only one export operation may be removed at a time.

Copyright © 2008 - 2019  |  Cognex Corporation  |  All Rights Reserved.

EasyBuilder Help  |  2019 August 24  |  Revision: 5.7.4.3