Contents x
    Asset Picker
      • Print
      • Dark
        Light
      Contents

      Asset Picker

        • Print
        • Dark
          Light
        Article summary

        The Asset Picker is a configurable component that allows users to select machines and/or lines from their factory assets. It supports both single and multi-select modes with various configuration options.

        Configuration Options

        The picker can be configured through the following options in the config object:

        Option

        Type

        Default

        Description

        defaultValue

        string

        "all"

        Determines initial selection behavior. Options:

        - "all": No default selection

        - "first": Selects the first available asset

        - "(machine_name)": Uses the specified machine name value as default

        selectSingle

        boolean

        false

        When true, enables single-select mode. When false, enables multi-select mode

        selectSameType

        boolean

        false

        Only applies in multi-select mode. When true, selecting an asset of a different type (e.g., AutoNoSew after LaserCut) clears previous selections

        selectMixedAssets

        boolean

        false

        When true, allows mixing machine and line assets in selections. When false, selecting a different asset type clears previous selections

        whiteList

        string[]

        undefined

        Optional array of machine names. When provided, only shows assets listed in the whitelist

        defaultMachine

        string

        undefined

        Optional machine name to select by default

        Example Configuration

            {
      "config": {
        "defaultValue": "first",
        "selectMixedAssets": false,
        "selectSameType": false,
        "selectSingle": false,
        "usesLines": false
      },
      "id": "asset",
      "title": "Asset",
      "type": "asset"
    },

        Default Query Params

        The asset picker generates the following params to the API Query:

        Parameter

        Type

        Description

        machine_names

        string[]

        Array of selected machine names

        machine_types

        string[]

        Array of machine types for the selected machines

        machines

        object[]

        Detailed information about each selected machine

        The machines array contains objects with the following properties for each selected machine:

        Property

        Type

        Description

        id

        string

        Unique identifier for the machine

        name

        string

        Internal machine name (unique)

        type

        string

        Machine type (e.g. "SMType")

        type_id

        string

        Unique identifier for the machine type

        display_name

        string

        Human-readable machine name

        title

        string

        Display title for the machine

        factory.id

        string

        Unique identifier for the factory containing the machine

        factory.name

        string

        Internal factory name (unique)

        factory.display_name

        string

        Human-readable factory name

        Example request body:

        "asset": {
  "pickerType": "asset",
  "value": {
    "machine_names": [
      "sm_machine_1",
      "sm_machine_2"
    ],
    "machine_types": [
      "SMType"
    ],
    "machines": [
      {
        "id": "3d52ccc428a2a961eea74b30",
        "name": "sm_machine_1",
        "type": "SMType",
        "type_id": "510bd9c3437d7a1c18e290de",
        "display_name": "Sight Machine 1",
        "title": "Sight Machine 1",
        "factory": {
          "id": "9b82d4248788f1331e1c1d40",
          "name": "ETL3_sanfrancisco",
          "display_name": "San Francisco"
        }
      },
      {
        "id": "b7f842f6dd4d6e9893556ded",
        "name": "sm_machine_2",
        "type": "SMType",
        "type_id": "510bd9c3437d7a1c18e290de",
        "display_name": "Sight Machine 2",
        "title": "Sight Machine 2",
        "factory": {
          "id": "9b82d4248788f1331e1c1d40",
          "name": "ETL3_sanfrancisco",
          "display_name": "San Francisco"
        }
      }
    ]
  }
},

        Page Link

        The following is the accepted mapping to populate the parameter for this picker:

        {
  "mapping": {
    'asset': '{"machine_source": ["machine_name1", "machine_name2"]}'
  }
}

        What's Next