---
title: "SAT splitting graphical editor"
canonical: "https://docs.vaultspeed.com/space/VPD/3081207861/SAT%20splitting%20graphical%20editor"
format: markdown
---
This article is a walk-through and explanation of the editor for the SAT Splitting. 


> Macro (toc)

# Screen elements

## Sidebar

At the left of the screen there is the sidebar.

![image](media://dee5e64c-2f38-4841-977a-17927289fc6d)

This sidebar contains:

- a selection for showing SATs on Hub or SATs on Link. Default is SATs on Hub.
- all available SATs which can be dragged onto the canvas for editing.
- a search bar.

## Toolbar

At the top of the screen there is the top Sat-splitting toolbar

![image](media://5f41aaa4-cc94-4917-a4c3-3f520da1fbf5)

This toolbar contains:

- Buttons to select how many attributes you want to have visible by default for every object that you drag onto the canvas (if your object contains more attributes then visible, you will get a scrollbar).
- A slider “Allow Multiple SATs on Canvas“ which by default is false, when set to true dropping SATs into the canvas will not clear previously loaded SATs.
- An ‘Actions’ menu (the three-dot-icon) with option for
  - Adding attribute based splits (explained later on this page)
  - Removing splits
  - Loading ALL splits onto the canvas
  - Getting an overview for all splits that are created
  - Reverting back all changes that you did in this release

## The Editor

The editor contains a right-click context menu that has, based on where you click, the following options:

- Right-click in the whitespace in **Object/Attributes View**
  - Clear everything: removes everything from the editor
  - Change view to icons: to display your objects as icons
  - Vertical /Horizontal layout: auto-layout buttons to see the objects in vertical or horizontal layout
- Right-click in the whitespace in **Icons View**
  - Clear everything: removes everything from the editor
  - disable/enable physics: disable (or enable) the auto-layout of the objects
  - Change view to Objects/Attributes: to change back to the default view of the objects with their attributes
- Right-click on a **base SAT**.
  - Clear everything: removes everything from the editor
  - Add Split Destination: create a new sat-split for this object
  - show only unused: show only the attributes that are not yet in one (or more) splits
  - Sort DESC/ASC: sort the attributes ascending or descending
  - Change view: same as in the Object/Attributes or Icons View
  - Vertical/Horizontal layout: same as in the Objects/Attributes view
- Right-click on a** split SAT**
  - Clear everything: removes everything from the editor
  - Edit selected: options to edit the name and/or split-reason of the split object
  - sort DESC/ASC: sort the attributes ascending or descending
  - change view: same as in the Object/Attributes or Icons View
  - Vertical/Horizontal layout: same as in the Objects/Attributes view
  - Remove selected split: remove the selected split object (only available when the split is empty)
- Right-click on an **attribute in a split SAT**
  - Remove selected column, which allows you to remove (multiple) selected columns from the SAT split.

### Icons view

Icons view contains an abstract view of available SATs in the editor. The main SAT contains a name and the splits contain a name_suffix.   As example SAT_SLS_WAREHOUSES is the main sat and LOCATIONS and GENERAL_INFO are the splits. The number indicates the attribute count. So for the main SAT, there are three attributes, LOCATIONS holds 1 of them, the 2 other go into GENERAL_INFO.

![image](media://42c2db29-f7b7-46da-86ef-513af73039b1)

### Objects / Attributes view

Objects / Attributes view contains a detailed view of available SATs in the editor. The main SAT contains a name and the splits contain a name_suffix.  As example SAT_SLS_WAREHOUSES is the main sat and LOCATIONS and GENERAL_INFO are the splits. Instead of a number as an indication for the attributes (as in the case of the icons view), it shows the attributes themselves.

![image](media://fb220ce2-bead-4a56-9f73-de0c90cd482e)

# Creating a SAT split

## Create the split object

First drag the SAT you want to split onto the canvas, using the 4-point arrow next to the sat name in the sidebar.

When the sat is on the canvas, right-click on it and select 'add split destination'.  In the window that pop-up you can fill in the name (suffix) of the split destination and the reason.

> ℹ️ the name that you give to a sat-split is a suffix to the original sat-name.  eg: the split ‘locations' from the sat_sls_warehouses will result in the data vault in the object name: sat_sls_warehouses_locations

## Add attributes to SAT Split

Adding attributes into a split is a simple matter of drag-and-drop with that attribute.

> ℹ️ Multiple attributes can be selected using keyboard shortcuts (e.g. CTRL-click or Command-Click).

![image](media://2262ef70-4151-4de8-92dc-8ba3851c60f2)

## Remove attributes from SAT Split

Removing attributes can be done by dragging them out of the split again.  Or with a right-click and the 'Remove selected columns' option.

## Attribute Search

The search icon under the SAT name opens a search menu, which allows filtering attributes by the provided expression. Main SATs have an option to use a global search, which will apply the same filter for all related splits.

![image](media://dda73e2b-5fea-496d-8b74-8e51968aa623)


## Warning

SATs list in the sidebar will display a warning message next to the SAT’s name when it has an empty split, not all attributes are used in the splits or SAT does not have enough attributes to create a split.

![image](media://cd4c682b-d463-43d8-be0d-51e919cadbbf)


# Attribute Based Splits

If you have repeatable logic for splits, i.e. the same attribute names in multiple objects that you all want to split into separate satellites, you can use the attribute based split functionality.  This can be found on the Action menu at the right of the toolbar

![image](media://9d30b3d2-f1f1-4c68-a2b0-272615c6cf41)


This will open up the attribute based split window.

![image](media://435cc181-5372-4ae4-a9e4-e7c20ae0849b)

Here you can fill in the:

- Name: name of the split you want to create
- Attributes: the attributes you want in this split
- Name for remaining attributes: the name of the split for the remaining
- Only split slider: with this slider set ON, you cill only make the split when ALL destination attributes are part of the original object.  with this slider OFF you will create the split for ANY of the destination attributes.

Example: if you have multiple satellites where you have GDPR (or PII) fields, you can create an Attribute based split with a name GDPR.  Select all your security/gdpr attributes that you want in those splits.  And choose the name GENERAL for the remaining attributes and set the ‘only split a satellite when it contains all attributes from the list’ to OFF.

![image](media://c68948d9-7749-495c-86ae-6b934b224295)


This will create for every source object that contains Birthdate (or any or the other 3 fields you selected) a separate split named <object_name>_gdpr.  And another split named <object_name>_general for all other attributes.

# Splits Overview

From the toolbar at the top, in the Action menu you have the possibility to go to the overview of all the splits you have created.  From here you also have the option to add these objects to your sat-split canvas if you want to make some more changes on your splits.

![image](media://66a4cc2d-24ab-4c60-bf00-00fc8cf5ad30)