All Collections
Flatfile Data Exchange Platform
How Do Record Update Artifacts Work?
How Do Record Update Artifacts Work?
Elisa Dinsmore avatar
Written by Elisa Dinsmore
Updated over a week ago

This article is for the latest version of the Flatfile Data Exchange Platform.

Every value has both an artifact layer (provided by a data hook), and a source layer, provided by input.

The source layer refers to stored values created from file extraction, manual input or edits, and direct API updates not made from a data hook. Essentially, changes where the intent is to create or mutate the stored value.

The artifact layer is only introduced when data hook transformations occur, or changes from a listener where the intent is to transform an original provided value.
If an artifact layer is present you'll see the "transformed from value X" message.

In essence, the process is:

  • Data is entered in a cell, either by API or file import or manual entry. This sets the source value.

  • Data hook (listener) transforms the value. This sets the artifact layer to be equal to the original source value.

  • The transformed value is then displayed, along with the artifact layer (which shows what the source value is).

The artifact layer is only reset if the source layer changes. So if you attempt to overwrite the transformed value with the original value, nothing will happen. Data hook transformations are considered to be idempotent.

Did this answer your question?