Versions Compared

Key

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

...

  • Started - you have started the tool

  • Connected to server - you have successfully logged in to your account on a specific server

  • Opened project - you have opened a project you have access to

  • Opened dump - you have created dump, or opened an existing one

_create

_

Started state

Anchor
myloginAnchor
myloginAnchor

...

Project

ID

of project

to

be

opened

Parameter name

Type

Optionality

Description

Constraints

project

string

Status
colourRed
titleREQUIRED

Code Block


Anchor
listProjectsAnchor
listProjectsAnchor

...

Parameter name

Type

Optionality

Description

Constraints

project

string

Status
colourRed
titleREQUIRED

Project ID of the project from which new project will be cloned


organization

string

Status
colourRed
titleREQUIRED

ID of the organization which will become the owner of the project


description

string

Status
colourGreen
titleOPTIONAL

description of the project. A description can be formatted by markdown syntax.


title

string

Status
colourGreen
titleOPTIONAL

title of the project, if none provided defaults to = "Clone of [projectName]"


...

Parameter name

Type

Optionality

Description

Constraints

project

string

Status
colourRed
titleREQUIRED

Project ID of the project from which files will be imported


dump

boolean

Status
colourYellow
titleVARIES

import project from local dump

(info) project must be specified


serverSide

boolean

Status
colourYellow
titleVARIES

performs import of specified project on server

(info) project must be specified


cascadeFrom

string

Status
colourGreen
titleOPTIONAL

cascade import object and all objects it references

see usage examples below


prefix

string

Status
colourGreen
titleOPTIONAL

specify a prefix for the metadata objects and data files


dashboards

boolean

Status
colourGreen
titleOPTIONAL

import dashboards only


dataPermissions

boolean

Status
colourGreen
titleOPTIONAL

import data permission only


datasets

boolean

Status
colourGreen
titleOPTIONAL

import datasets only


exports

boolean

Status
colourGreen
titleOPTIONAL

import exports only


indicators

boolean

Status
colourGreen
titleOPTIONAL

import indicators only

code


indicatorDrills

boolean

Status
colourGreen
titleOPTIONAL

import indicator drills only


markers

boolean

Status
colourGreen
titleOPTIONAL

import markers only


markerSelectors

boolean

Status
colourGreen
titleOPTIONAL

import marker selectors only


metrics

boolean

Status
colourGreen
titleOPTIONAL

import metrics only


projectSettings

boolean

Status
colourGreen
titleOPTIONAL

import project settings only


shares

boolean

Status
colourGreen
titleOPTIONAL

import shares only


views

boolean

Status
colourGreen
titleOPTIONAL

import views only


force

boolean

Status
colourGreen
titleOPTIONAL

ignore source project validate errors and proceed with import anyway

skip failed dataset dumps (for projects with incomplete data)

default = false


skipData

boolean

Status
colourGreen
titleOPTIONAL

skip data import

default = false


...

Parameter name

Type

Optionality

Description

Constraints

file

string

Status
colourYellow
titleVARIES

path to the CSV file

(info) one of file, s3Uri or url parameters must be specified


s3Uri

string

Status
colourYellow
titleVARIES

URI of an object on AWS S3 to upload (see examples below)

(info) one of file, s3Uri or url parameters must be specified


url

string

Status
colourYellow
titleVARIES

HTTPS URL which contains a CSV file to be loaded into the dataset

(info) one of file, s3Uri or url parameters must be specified


dataset

string

Status
colourRed
titleREQUIRED

name of dataset into which the data should be loaded


mode

enum

Status
colourRed
titlerequired

data load mode

incremental mode appends the data to the end of the table

full mode truncates the table and loads the table anew

[incremental, full]

csvHeader

boolean

Status
colourGreen
titleOPTIONAL

specifies if the CSV file to upload has a header

default = true


csvSeparator

char

Status
colourGreen
titleOPTIONAL

specifies the CSV column separator character

default = ,


csvQuote

char

Status
colourGreen
titleOPTIONAL

specifies the CSV quote character

default = "


csvEscape

char

Status
colourGreen
titleOPTIONAL

specifies the CSV escape character

default = \


csvNull

string

Status
colourGreen
titleOPTIONAL

specifies the replacement of custom CSV null values


csvForceNull

enum

Status
colourGreen
titleOPTIONAL

specifies which CSV columns should enforce the null replacement


verbose

boolean

Status
colourGreen
titleOPTIONAL

enables more verbose output

default = false


multipart

boolean

Status
colourGreen
titleOPTIONAL

enables multipart file upload (recommended for files larger than 2 GB)

default = false


gzip

boolean

Status
colourGreen
titleOPTIONAL

enables gzip compression

default = true


...

Parameter name

Type

Optionality

Description

Constraints

dataset

string

Status
colourRed
titleREQUIRED

name of the dataset do dump


force

boolean

Status
colourGreen
titleOPTIONAL

overwrites dumped data


...

Parameter name

Type

Optionality

Description

Constraints

directory

string

Status
colourGreen
titleOPTIONAL

path to a directory to which the dump will be saved

stored in config file

skipMetadata

boolean

Status
colourGreen
titleOPTIONAL

skip metadata dump

default = false


skipData

boolean

Status
colourGreen
titleOPTIONAL

skip data dump

default = false


force

boolean

Status
colourGreen
titleOPTIONAL

overwrites current dump

default = false


nativeDatasetsOnly

boolean

Status
colourGreen
titleOPTIONAL

import only native datasets (without origin attribute)

default = false


ignoreFailedDatasets

boolean

Status
colourGreen
titleOPTIONAL

skip failed dataset dumps (for projects with incomplete data)

default = false


...

Parameter name

Type

Optionality

Description

Constraints

objectName

string

Status
colourGreen
titleOPTIONAL

name of the object (with or without .json extension)


Info

Updating existing metadata objects

When modifying already added (uploaded) metadata objects use pushProject command for uploading modified objects to the project.

Anchor
createMetadataAnchor
createMetadataAnchor

...

Parameter name

Type

Optionality

Description

Constraints

objectName

string

Status
colourYellow
titleVARIES

name of the object (with or without .json extension)

(info) one of objectName, objectId or orphanObjects parameters must be specified


objectId

string

Status
colourYellow
titleVARIES

ID of the object


orphanObjects

boolean

Status
colourYellow
titleVARIES

prints a sequence of removeMetadata commands to delete orphan metadata objects

orphan object is an object not referenced from any of the project's views, or visible anywhere else in the app


...

Parameter name

Type

Optionality

Description

Constraints

skipMetadata

boolean

Status
colourGreen
titleOPTIONAL

skip metadata push

default = false


skipData

boolean

Status
colourGreen
titleOPTIONAL

skip data push

default = false


skipValidate

boolean

Status
colourGreen
titleOPTIONAL

skip the run of validate after push

default = false


verbose


boolean

Status
colourGreen
titleOPTIONAL

enables more verbose output

default = false


multipart

boolean

Status
colourGreen
titleOPTIONAL

enables multipart file upload (recommended for files larger than 2 GB)

default = false


gzip

boolean

Status
colourGreen
titleOPTIONAL

enables gzip compression

default = true


...

Parameter name

Type

Optionality

Description

Constraints

objectName

string

Status
colourGreen
titleOPTIONAL

name of the object to fetch (with or without .json extension)


force

boolean

Status
colourGreen
titleOPTIONAL

overwrite local changes


...

Parameter name

Type

Optionality

Description

Constraints

sourceProject

string

Status
colourRed
titlerequired

Project ID of the source project


objectTypes

array

Status
colourGreen
titleOPTIONAL

list of object types to be compared

example = "views,indicators,metrics"


...