SDX-Cloud: SDX-CAD Fields

SDX-CAD Fields add structured information, such as text, numbers, choices, or images, to the measurements in your project. You create them in the project settings, or import them from your organization or from a JSON file.

Before you start

• You can open Settings in the project in SDX-Cloud.
• You know which field types you need. Choose from Text, Number, Dropdown, and Image.

Open SDX-CAD Fields

Expected result: You see a table with the columns Name, Type, Mandatory, Created at, Last updated at, and Actions. A new project shows No data available.

1. Open the project in SDX-Cloud.
2. Select Settings.
3. Select SDX-CAD Fields in the list on the left.

Create a field

Expected result: The new field appears in the table with its type and mandatory setting. A Dropdown field is listed as Select.

1. Select Add field.
2. Enter the Name. It is required.
3. Choose the Type.
4. Fill in the settings for that type. See the table below.
5. Turn on Mandatory if every measurement needs a value.
6. Select Create.

Reuse fields from your organization

Expected result: The fields you picked are added to the project.

Organization admins create shared fields in Settings > SDX-CAD Fields of the organization. It works like the project screen, with Add field, Import fields from JSON, and Export fields as JSON.

1. In SDX-CAD Fields, select Import fields from organization.
2. Select the fields you want in the Import SDX-CAD fields window. It lists Name, Type, and Mandatory.
3. Select Confirm Import.

Move fields with JSON

• Select Export fields as JSON, tick the fields, and select Export to save them as a file.
• Select Import fields from JSON and choose a JSON file from the project files to add fields from it.

The file is a JSON array with one object per field. Export your own fields first and use that file as your template.

JSON structure

Each field object has these keys:

• name: the field name.
• type: string for Text, number for Number, select for Dropdown, image for Image.
• mandatory: true or false.

These keys depend on the type:

• Text: max_length and default_value.
• Number: min, max, and default_value.
• Dropdown: options, a list of objects with label and color (a hex value). The export adds an id to each option.

An export also contains _id, project_id, organization_id, created_at, and updated_at. SDX-Cloud sets these itself.

[
  {
    "name": "Manhole type",
    "type": "select",
    "mandatory": true,
    "options": [
      { "label": "Manhole 18 Inch", "color": "#5EEAD4" },
      { "label": "Manhole 24 Inch", "color": "#7E22CE" }
    ]
  },
  { "name": "Comment", "type": "string", "mandatory": false, "max_length": 50, "default_value": "" },
  { "name": "Station", "type": "number", "mandatory": false, "min": 0, "max": 100, "default_value": 5 },
  { "name": "Photo", "type": "image", "mandatory": false }
]

Fill in fields on site

Expected result: The measurement stores the field values together with its position.

When you record a measurement in Sodex Mobile, such as a point, and a field exists, the app offers to fill it in.

Edit values in SDX-Cloud

You can change every field value in SDX-Cloud after the measurement was recorded. In the measurement, the SDX-CAD fields section lists the fields. Use Add field to choose which ones to show, then select Apply.

Exports

Exports include the SDX-CAD fields.

Search fields in Infomap

Expected result: The search in the SDX-CAD panel also looks in your fields.

1. Open the project and select Infomap.
2. Select SDX-CAD in the toolbar.
3. Select Settings in the SDX-CAD panel.
4. Turn on Include CAD fields in search.
5. Use Search in the panel to find a measurement by its field values.

Related articles

• SDX-Cloud: SDX-CAD