Update run step fields

To update a field on a run step, first query the run to find the field you want, then run a mutation to set its value.

Get the fields

Query the run to get the fields that exist on the run steps you want to update:

{
  run(id: 419) {
    id steps {
      id fields {
        id name value type _etag
      }
    }
  }
}

The response looks like this:

{
  "data": {
    "run": {
      "id": 419,
      "steps": [
        {
          "id": 1429,
          "fields": [
            {
              "id": 1461,
              "name": "required_field",
              "value": null,
              "type": "STRING",
              "_etag": "066b1eb08dab44d6925d7bbd899e92cf"
            },
            {
              "id": 1462,
              "name": "pass_fail",
              "value": null,
              "type": "BOOLEAN",
              "_etag": "066b1eb08dab44d6925d7bbd899e92cf"
            },
            {
              "id": 1463,
              "name": "quality",
              "value": null,
              "type": "SIGNOFF",
              "_etag": "066b1eb08dab44d6925d7bbd899e92cf"
            }
          ]
        }
      ]
    }
  }
}

The query returns a list of run steps within that run, and the fields within those run steps. Find the field that you want to update.

Update a field value

From the example response above, suppose you want to update field 1462 because your test equipment can determine pass or fail. Use this mutation:

mutation {
  updateRunStepFieldValue(input: {
    id: 1462,
    value: true,
    etag: "066b1eb08dab44d6925d7bbd899e92cf"
  }) {
    runStepField {
      id value
    }
  }
}

This mutation does the following:

Because it updates data, it’s a mutation.
The mutation is updateRunStepFieldValue.
The field id is 1462 and the value you’re setting is true.
It includes the etag of the original field. The etag prevents accidental data overwrites by enforcing concurrency control.

The response returns the id and the updated value of the field.

⌘I

Getting Started

Build Hardware

Manage Supply Chain

Track Quality

Automate with ION

Administration

API Reference

Update run step fields

Get the fields

Update a field value

​Get the fields

​Update a field value

Get the fields

Update a field value