Changing an entity
Review entity changes
You can update an entity as your business changes. When you save, Tauriam compares the new definition with the current one and identifies edits that could remove or reset saved values. The confirmation lists the affected entity, record count, and changes before it applies them.
What changes keep or clear
| Prop | Type | Description |
|---|---|---|
| Add a field | Keeps existing records | Adds the new field to existing records. Its default is filled in when configured; otherwise the value is empty. |
| Rename a field | Keeps its values | When Tauriam can match the old and new field by type, it moves the saved value to the renamed field. |
| Change a field label or default | Keeps existing values | Updates how the field is presented or the value used for new records. |
| Remove a field | Removes that field's values | The entity's other fields and records stay, but the removed column's values are deleted. |
| Change a field's data type | Clears that column's values | The current values in the changed field are reset to empty so they cannot be mistaken for the new type. Other columns and records remain. |
| Change a relation's target or shape | Clears that relation field | Changing which entity it links to, one-versus-many, or snapshot mode clears the old values in that field. Other fields and records remain. |
| Rename an entity | Can remove all its records | The old entity is treated as removed and a new entity is created. Existing records under the old entity name are deleted after confirmation. |
| Delete an entity | Deletes all its records | The entity definition and its records are removed after confirmation. |
A field type change clears the values in that field, not the other columns in its records. Removing an entity or changing its name is more serious: all records belonging to the old entity are removed. In a batch edit, Tauriam waits for confirmation before saving any part of the batch.
Confirm a change
Review the warning before confirming
For a field type or relation change, check the field named in the warning because its existing values will be cleared. If you rename or delete an entity, check the affected record count because all of that entity's records will be deleted. Cancel if the change is not what you intended.