ahtlon/deck
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Update export-import.md

Browse Source 
Added a more or less step for step guide on how to export import from deck to deck, and corrected a command.

Signed-off-by: paskalito <paskalito@users.noreply.github.com>
This commit is contained in:
paskalito
2024-10-16 11:31:55 +02:00
committed by GitHub
parent 90e0cab306
commit 12ae50d67b
1 changed files with 27 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
docs/export-import.md
View File

@@ -12,8 +12,9 @@ The export currently has some kown limitations in terms of specific data not inc
- Comments - Comments
- -
``` ```
occ deck:export > my-file.json occ deck:export userid > userid-deck-export.json
``` ```
(userid = username you see in admin useraccounts page)
## Import boards ## Import boards
@@ -23,22 +24,42 @@ It is possible to import from the following sources:
### Deck JSON ### Deck JSON
A json file that has been obtained from the above described `occ deck:export [userid]` command can be imported. A json file that has been obtained from the above described `occ deck:export [userid] > userid-deck-export.json` command can be imported.
``` ```
occ deck:import my-file.json occ deck:import userid-deck-export.json
``` ```
In case you are importing from a different instance you may use an additional config file to provide custom user id mapping in case users have different identifiers. You will be asked to provide a path to a config file.
To know what to put in there:
- Have a look at your userid-deck-export.json
- fairly at the top you will see "uid" with a username.
- search for some more "uid" till you find all the usernames involved and note them.
- search for "acl"
- in there there are "uid" of groups note them too
In case you are importing from a different instance you must provide custom user id mapping in case users have different identifiers.
create a config file e.g `deck-import-config-file-userid.json` and ajust the content of this example as descibed above.
Userids on new instance can be seen in the admin useraccounts page.
``` ```
{ {
"owner": "admin", "owner": "useridofnewownderofallboards",
"uidRelation": { "uidRelation": {
"johndoe": "test-user-1" "userid1onoldinstance": "userid1onnewinstance",
"userid2onoldinstance": "userid2onnewinstance",
"groupid1onoldinstance": "groupid1onnewinstance"
} }
} }
``` ```
after you hit enter everything will be imported.
Additional info:
- If you export a users boards, all boards that the user has access to will be exported. (also the onws shared to that user)
#### Trello JSON #### Trello JSON