Scripting

You are able to pass scripts as an input to CleverMaps Shell.

The script may contain command sequences, equal to those you put in the through the standard input.

The script file must be located in the working directory of the Shell and it must be a text file. This name of this text file is passed to Shell as a command line argument  --cmdfile.

Example

We have a following directory structure:

./
../
cm_shell.sh
cm-shell-1.3.0-RELEASE-exec.jar
script.txt

The contents of script.txt are following:

login --server https://secure.clevermaps.io
openProject --project abcdefgh12345678
loadCsv --file /home/user/CAN/orders.csv --dataset orders --mode incremental
loadCsv --file /home/user/CAN/customers.csv --dataset customers --mode incremental
dumpCsv --dataset stores
exit

By default, the running script (in this case can_shell.sh) does not containt the --cmdfile argument. So unless you add it there, you will have to run the Shell like this:

java -jar cm-shell-1.3.0-RELEASE-exec.jar --cmdfile script.txt

If the script file exists and is valid, it is executed.

Exit code

Shell supports classic exit code behavior.

If the script passes, exit code of the process is 0. If a command fails, the execution is aborted and exit code is 1. 

This is usable in automated environments, combining with other scripts, etc.

_