Import dummy data via cli¶
Prerequisites¶
- obp cli is installed
- obp cli is initalised
- Permissions
You may not have the correct permissions to perform the imports you want. The API will return an error specifying the permissions you need if you try to import data you don’t have permissions for.
Concepts¶
To import data using the CLI you download the template spreadsheets provided, enter in as many rows as you want records, and then pass the populated spredsheet to the cli.
Using Import Templates¶
The CLI provides spreadsheet templates which you populate with the data you wish you import. The purpose of this is to allow less technical users create a dataset which may easily be imported into the API.
Note
You must save your templates in the “.ods” file format.
This is an open document standard, and the only format that the obp
cli currently
supports. Once you’ve populated your template with your own data, be sure to save it as
.ods
format.
Locating import templates¶
The Open Bank Project provides import templates. Use these examples and edit them by adding rows of data for your own desired dataset.
The templates may currently be downloaded from the OBP-CLI repo.
Locate all the files ending in .ods. For example, at the time of writing, the users import template is called
users-import-template-v1.ods
from the repo.
Warning
Be sure to check the latest master or release branch for the latest import templates.
Steps:
- Take a template spreadsheet, for example “users.ods” and populate it with a list of users.
- Identify the correct CLI import command, for example for users import the command is:
obp importusers users-import-template-v1.ods
press enter - If you have the correct permissions, and the data is valid, your import will succeed
If you don’t have the correct permissions to create the object, then you may
be able to use the cli to add roles for yourself, or request a higher
privileged user grants them to you. See obp addrole --help
.