Custom objects

To support an object type that Design does not recognize, you can create a custom object, which you describe using an image of the object.

Overview

Custom objects provide image-based identification for object types that Design does not recognize.

You can use custom objects in script steps, as you would use built-in objects. You can also add a position or relation to custom object steps, to identify the object uniquely.

You can export a custom object and import it into another workspace.

Note: Custom objects are not detected by Inspection and cannot be used as related objects.

Create a custom object

Create a custom object by uploading an image of the object and defining its class name:

  1. In the Design Assets pane, click the Add new button in the Custom Objects node.

    Tip: Collapsing the Scripts and Functions nodes may help bring the Custom Objects node into view.

  2. Provide an image of the object that can be used to identify it.

    • Use a .png or .jpg file no larger than 1 MB.

    • The image you use to describe the object must match the object exactly.

    • Make sure that the image dimensions are similar to those displayed in the application.

  3. Accept or edit the suggested class name, then click Save.

    Do not use the name of an existing object class.

The custom object is added in the Design Assets pane, and can be used for the object class in script steps.

View the list of custom objects

Find custom objects in the tree or in a script's Object class list.

  • In the Design Assets pane, expand the Custom Objects node.

  • In a script's step editing pane, open the Object class list.

Tip: In both lists, you can click an object's information button to view the object's image and details such as who modified it last, and when.

View custom object details

View an object's image, class name, and dimensions from the Design Home page.

  1. Open the Design Home page.

  2. In the Design Assets pane, select the Custom Objects node.

  3. View custom object details, such as an object's image, class name, and image dimensions.

Export a custom object

Export a custom object to transfer it to another workspace.

  1. In the Design Assets pane, click the More options button for the custom object.

  2. Select Export.

  3. Optionally, depending on your browser's configuration, specify the location for the export.

The custom object's image is downloaded and given the name of the custom object.

Import a custom object

Import a custom object that was exported from another workspace:

  1. On the Design Home page, click the Import file button and select Custom object.

  2. Browse for an image or drag it into the dialog. Use a .png or .jpg file no larger than 1 MB.

  3. Accept or edit the object's class name, then click Import.

The custom object is added in the Design Assets pane, and can be used for the object class in script steps.