Field Controls Overview

What Are Field Controls?

Field controls let you customize which fields appear in the entity inspector and how they're displayed. These controls only affect the inspector view - they don't modify your underlying data or the visualization itself.

Core Concepts

Choosing Your Approach

  • Inclusion (Whitelist): Explicitly specify which fields to show
    • Best when you want to show only a few specific fields
    • Everything else is automatically hidden
  • Exclusion (Blacklist): Specify which fields to hide
    • Best when you want to hide just a few fields
    • Everything else remains visible

Specificity Levels

  • Global Rules: Apply to all entities of a type (nodes or edges)
  • Type-Specific Rules: Apply only to specific entity subtypes (e.g., "server" nodes vs "client" nodes)
    • Type-specific rules override global rules
    • Different types can have different field visibility

Available Controls

Field Visibility

Field Enhancement

  • Computed Fields: Create new fields by combining or transforming existing data
    • Combine multiple fields into one display
    • Generate clickable links
    • Format data for better readability

Common Use Cases

Simplified Views


{
  "node_encodings": {
    "complex": {
      "default": {
        "pointFieldInclusionEncoding": {
          "graphType": "point",
          "encodingType": "fieldinclusion",
          "include": {
            "name": true,
            "status": true
          }
        }
      }
    }
  }
}

Shows only the most important fields, reducing clutter in the inspector.

Type-Specific Information


{
  "node_encodings": {
    "complex": {
      "default": {
        "pointFieldInclusionEncoding": {
          "graphType": "point",
          "encodingType": "fieldinclusion",
          "include": {
            "types": {
              "server": { "cpu": true, "ram": true },
              "client": { "name": true, "email": true }
            }
          }
        }
      }
    }
  }
}

Shows different fields for different entity types.

Important Notes

  • All controls only affect the entity inspector display
  • Essential fields (IDs, source/destination) cannot be hidden
  • Type-specific rules take precedence over global rules
  • Cannot mix inclusion and exclusion for the same fields
  • Field names must match your data's column names