Versions Compared

Key

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

This tutorial describes advanced project management techniques in CleverMaps Shell.

In the first tutorial, you've learned how to create a project, dump it, import a dimension and add some data & metadata. Now the project has been handed over and your clients are using it. So what about extensions? What about data updates? We sure don't want our clients to use an incomplete/broken project. We'll create a clone, perform our work there, and then elegantly put our changes back to the live project. Here's how.

Table of Contents

Creating a project clone

The process of creating a project clone is very similar to the process of importing a data dimension. Data dimension is a project like any other, so by importing it to your own project, you're actually creating a clone of it.

...

  • a working copy of the original project (where updates are made, and which later replaces the original project)
  • a base for a branched out, similar project (in order not to start from scratch)
  • a backup of older version of the project (to be archived)

Restoring a backup dump

Each dump is an image of a project in a specific time. So, a local dump can be used as a backup of a project. It is useful to periodically dump the project you're working on, to save your previous work. This way, in case you break the live project, you can always revert to a previous version of the project.

...

The final step to restore the backup dump is to upload the data and metadata to the project. As usually, use addMetadata and pushProject to do that.

Info
titleImport usage

The import command can import either a project from a server, or a local dump. What to import is decided based on provided parameters.

  • import --project {projectId} --server {serverName}
  • import --project {projectId} --dump {dumpId}
    • imports a local dump of another project (not the one currently opened)
  • import --dump {dumpId}
    • imports a dump of currently opened project

Updating a live project

Now that we've done some work on the project clone, we want to transfer the changes to the live project.

...

And as the finish message tells us, use the usual addMetadata and pushProject commands to upload the updated dump to the live project.

...