Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Dump directory structure is created either in:

  1. the default directory you specified in the config file (recommended)

  2. working directory, e.g. the directory you run Shell from

Let's assume that in this case, /var/local/projects is our default directory. The dump structure is following:

Code Block
themeMidnight
/var/local/projects/{projectId}/

So, in practice:

Midnight
Code Block
theme
/var/local/projects/q1zdp9d0ao78rdv5/

If we list the contents of this dump directory, we see data and metadata directories, and the dumpMetadata.json file (described below).

Midnight
Code Block
theme
./
../
data/
dumpMetadata.json
metadata/
metadata/dashboards/
metadata/dataPermissions/
metadata/datasets/
metadata/exports/
metadata/indicatorDrills/
metadata/indicators/
metadata/markers/
metadata/markerSelectors/
metadata/metrics/
metadata/projectSettings/
metadata/views/

...

Simple wrapper, which contains metadata about the dumped object.

Key

Type

Optionality

Description

url

string

Status
colourBlue
titlegenerated

URL link uniquely identifying the object

dumpTime

string

Status
colourBlue
titlegenerated

timestamp of when the object was dumped

version

string

Status
colourBlue
titlegenerated

version of the object

starts at 1, is incremented everytime the object is pushed to the project

content

object

Status
colourBlue
titlegenerated

the object itself

may contain valid content of one of metadata object types

Dump metadata file

The dumpMetadata.json file is located the dump directory, one level above the data and metadata directories. It contains metadata about the dump itself, and list of its contents.

Key

Type

Optionality

Description

server

string

Status
colourBlue
titlegenerated

server, from where the project was dumped

projectId

string

Status
colourBlue
titlegenerated

ID of the project

projectTitle

string

Status
colourBlue
titlegenerated

human-readable title of the project

dumpTime

string

Status
colourBlue
titlegenerated

timestamp of when the project was last dumped or fetched

user

string

Status
colourBlue
titlegenerated

email of the user who performed the dump

metadataContent

object

Status
colourGreen
titleoptional

list of metadata object files contained in the dump, with their respective md5 hashes (used for local file modification detection)

dataContent

object

Status
colourGreen
titleoptional

like metadataContent, but with .csv files