Versions Compared

Key

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

...

Parameters with string type take string input as a value, if they are mentioned. Parameters with enum type have predefined enumeration of strings, which can be passed as a value. Parameters with no type (-) are passed no valuesboolean type can be passed either true, false or no value (=true).

Workflow states

  • 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 a new dump, or opened an existing one

...

Log in as a user with correct credentials.

Parameter nameTypeOptionalityDescriptionConstraints

email

string
Status
colourGreen
titleOPTIONAL
your email accountstored
in
in credentials file
passwordstring
Status
colourGreen
titleOPTIONAL
your passwordstored in credentials file
accessTokenstring
Status
colourGreen
titleOPTIONAL

generated CleverMaps access token

(see how to get one)

stored in config file
serverstring
Status
colourGreen
titleOPTIONAL

server to connect to

default = https://secure.clevermaps.io

stored in config file
proxyHoststring
Status
colourGreen
titleOPTIONAL

proxy server hostname

stored in config file
proxyPortinteger
Status
colourGreen
titleOPTIONAL
proxy server portstored in config file

setup

...

s3AccessKeyIdstring
Status
colourGreen
titleOPTIONAL

AWS S3 Access Key ID

required for S3 upload (loadCsv --s3Uri)

stored in config file
s3SecretAccessKeystring
Status
colourGreen
titleOPTIONAL

AWS S3 Secret Access Key

required for S3 upload (loadCsv --s3Uri)

stored in config file

setup

Store your config and credentials in a file so you don't have to specify them each time you log in.

emailpasswordyour passwordserver to connect to
Parameter nameTypeOptionalityDescriptionConstraintsConstraints

email

string
Status
colourGreen
titleOPTIONAL
your email accountstored in credentials file
passwordstring
Status
colourGreen
titleOPTIONAL
your passwordstored in credentials file
accessTokenstring
Status
colourGreen
titleOPTIONAL

generated CleverMaps access token

(see how to get one)

stored in config file
serverstring
Status
colourGreen
titleOPTIONAL
your email account

server to connect to

stored in credentials file config file
dumpDirectorystring
Status
colourGreen
titleOPTIONAL
directory where your dumps will be storedstored in credentials config file
proxyHoststring
Status
colourGreen
titleOPTIONAL

proxy server

hostname

stored in config file
dumpDirectoryproxyPortstringinteger
Status
colourGreen
titleOPTIONAL
directory where your dumps will be storedproxy server portstored in config file
proxyHosts3AccessKeyIdstring
Status
colourGreen
titleOPTIONAL
proxy server hostname

AWS S3 Access Key ID

required for S3 upload (loadCsv --s3Uri)

stored in config file
proxyPorts3SecretAccessKeyintegerstring
Status
colourGreen
titleOPTIONAL
proxy server port

AWS S3 Secret Access Key

required for S3 upload (loadCsv --s3Uri)

stored in config file

Connected to server

...

Parameter nameTypeOptionalityDescriptionConstraints
verbose-boolean
Status
colourGreen
titleOPTIONAL
specifies if the output should be more verbose
shareenum
Status
colourGreen
titleOPTIONAL
list projects by share[demo, dimension]
organizationstring
Status
colourGreen
titleOPTIONAL
list projects by organization (organization ID)

...

...

Parameter nameTypeOptionalityDescriptionConstraints
serverstring
Status
colourGreen
titleOPTIONAL

specifies if the output should be more verbose

default = https://secure.clevermaps.io


projectstring
Status
colourYellow
titleVARIES

id of the project to import

(info) either project or dump must be specified


dumpstring
Status
colourYellow
titleVARIES

id of the dump to import

(info) either project or dump must be specified


cascadeFromstring
Status
colourGreen
titleOPTIONAL

cascade import object and all objects it references

see usage examples below


prefixstring
Status
colourGreen
titleOPTIONAL
specify a prefix for the metadata objects and data files
force-boolean
Status
colourGreen
titleOPTIONAL
force the import even if there are model violations in the source project
dashboards-boolean
Status
colourGreen
titleOPTIONAL
import dashboards only
datasets-boolean
Status
colourGreen
titleOPTIONAL
import datasets only
indicators-boolean
Status
colourGreen
titleOPTIONAL
import indicators only
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)


skipDataboolean
Status
colourGreen
titleOPTIONAL
skip data import

...

Parameter nameTypeOptionalityDescriptionConstraints
directorystring
Status
colourGreen
titleOPTIONAL
directory to which the dump will be saved

stored in config file

skipMetadata-boolean
Status
colourGreen
titleOPTIONAL
skip metadata dump
skipData-boolean
Status
colourGreen
titleOPTIONAL
skip data dump
force-boolean
Status
colourGreen
titleOPTIONAL
skip failed dataset dumps (for projects with incomplete data)

...

Parameter nameTypeOptionalityDescriptionConstraints
skipMetadata-boolean
Status
colourGreen
titleOPTIONAL
skip metadata push
skipData-boolean
Status
colourGreen
titleOPTIONAL
skip data push
skipValidate-boolean
Status
colourGreen
titleOPTIONAL
skip the run of validate after push
forceboolean
Status
colourGreen
titleOPTIONAL
force metadata push when there's a share breaking change
verbose


boolean
Status
colourGreen
titleOPTIONAL

enables more verbose output

default = false

[true, false]
multipartboolean
Status
colourGreen
titleOPTIONAL

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

default = true

[true, false]
gzipboolean
Status
colourGreen
titleOPTIONAL

enables gzip compression

default = true

[true, false]

...