This article covers use of the ss-exporter command line utility. This utility is used for locally storing content created in ScreenSteps. The example below will describe how to export an article from your account to a folder on your desktop.
Acquire the script
Find the precompiled script appropriate for your operating system
Windows: https://www.bluemangolearning.com/download/screensteps/cli_exporter/ss_exporter.exe.zip
OSX: https://www.bluemangolearning.com/download/screensteps/cli_exporter/ss_exporter.zip
Place the script in an easily accessible place in your folder structure like the desktop.
Open the command line
Windows
- Press Windows+R
- Type cmd
- Enter
OSX
- Press command+spacebar
- Type Terminal
- Enter
Navigate to the location of the script
Windows
cd C:\Users\<USER>\Desktop\<Folder_With_SS_Exporter_Executable>
OSX
cd ~/Desktop/<Folder_With_SS_Exporter_Executable
>
Execute
This is the template for usage of ss-exporter
ss_exporter -n <account_name> -u <user_id> -p <token_password>
optional, yet highly recommended parameters to include follow the template above.
[-t <template_folder>]
[-o <output_folder>]
[-s <site_id>]
[-m <manual_id>]
[-a <article_id>]
[-M <manual_file_name>]
[-i object_identifier]
Finding ids
You can find the ids for your sites, manuals, and articles by looking at the urls in the ScreenSteps admin area. Here is an example url:
https://YOUR-ACCOUNT.screenstepslive.com/admin/v2/sites/2957/manuals/11169/chapters/1225374/articles/788216
Each id is preceded by the name of the what the id represents:
Object | ID |
---|---|
Site | 2957 |
Manual | 11169 |
Article | 788216 |
Examples
Downloading a single article from your account into the current directory.
ss_exporter.exe -n MyAccountName -u MyLoginName -p MyPassword -a 111111 -t ./samples/manual_w_images_folder -o .
Downloading a single manual into the Downloads folder.
ss_exporter.exe -n MyAccountName -u MyLoginName -p MyPassword -m 111111 -t ./samples/manual_w_images_folder
-o C:\Users\$USER\Downloads
Find more examples, instructions, and the source at the Github page: https://github.com/screensteps/screensteps-cl-exporter
0 Comments
Add your comment